Miro Enterprise との統合

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：12分

    • ソフトウェア資産管理 アプリケーションを Miro Enterprise アプリケーションと統合すると、ソフトウェアサブスクリプションを追跡し、未使用のライセンスを再利用することができます。

    重要:
    必要なユーザーまたは API 権限のみにアクセス権を付与することで、セキュリティリスクを最小限に抑え、情報を保護します。
    表 : 1. 最小限のユーザー権限
    責任を担います。 Miro Enterprise アプリケーションで必要なユーザーロール 認証スコープ
    サブスクリプションをダウンロード 会社アドミン organizations:read
    ユーザーアクティビティのプル 会社アドミン organizations:read
    サブスクリプションを再利用 会社アドミン なし

    Miro EnterpriseOAuth 2.0 アプリケーションを作成

    Miro EnterpriseOAuth 2.0 アプリケーションを作成して、MiroAPI へのアクセスを有効にします。

    始める前に

    Miro 必要なロール: 「最小限のユーザー権限 」表を参照してください。

    手順

    1. Web ブラウザーから Miro プラットフォームを開きます。
    2. 組織内にチームを作成していない場合、または偽のデータを使用して OAuth 2.0 アプリケーションをビルドしてテストする場合は、開発者チームを取得します。
    3. Miroプラットフォームのページヘッダーで、[アプリ] を選択します。
      サインアップページが開きます。
    4. 会社アドミンの認証情報を使用してサインインします。
      デフォルトの組織プロファイルが開きます。
    5. 左側のナビゲーションペインの上部にある組織プロファイルアイコンを選択して、OAuth 2.0 アプリケーションをビルドする組織を選択します。
      選択された組織のプロファイルが開きます。
    6. 左側のナビゲーション ウィンドウで、 [プロファイル設定] を選択します。
    7. プロファイル設定の [API、SDK、および埋め込み (API, SDK & Embed) ] タブを選択します。
    8. [アプリ] セクションで、[ 使用条件に同意します ] チェック ボックスをオンにし、[ 新しいアプリの作成] を選択します。
    9. ダイアログボックスで、フィールドに入力します。
      表 : 2. [新規アプリを作成 (Create new app) ] ダイアログボックス
      フィールド 説明
      アプリ名 OAuth 2.0 アプリケーションの名前
      説明 OAuth 2.0 アプリケーションの簡単な説明
    10. OAuth 2.0 アプリケーションをビルドするチームを選択します。
    11. [アプリを作成] を選択します。
      新しく作成したアプリの設定が開きます。
    12. アプリの <app-name> セクションで、[クライアント ID] と [クライアントシークレット] フィールドの値をコピーします。
      後で使用できるように安全な場所に保存してください。
    13. リダイレクト URL セクションで、認証後にユーザーがリダイレクトされる OAuth プロバイダーの URL を入力し、 追加 を選択します。
      https://instance.service-now.com/oauth_redirect.do と入力します。<instance> はServiceNowインスタンスの名前です。
    14. OAuth スコープセクションで、organizations:read OAuth スコープを有効にします。
      OAuth スコープは、アプリケーションが保護されたリソースに対して持つアクセスのレベルを指定します。organizations:read OAuth スコープを使用すると、アプリケーションで組織および組織メンバーに関する情報を読み取ることができます。

    次のタスク

    組織プロファイルを開いたままにして、Miro Enterpriseアカウントで SCIM (クロスドメイン ID 管理システム) を有効にできるようにします。詳細については、「Miro Enterpriseアカウントで SCIM を有効化」を参照してください。

    Miro Enterpriseアカウントで SCIM を有効化

    Miro Enterpriseアカウントで SCIM (クロスドメイン ID 管理システム) を有効にして、MiroAPI 要求を認証するための API アクセストークンを生成できるようにします。

    始める前に

    Miro 必要なロール: 「最小限のユーザー権限 」表を参照してください。

    手順

    1. Miro組織プロファイルの左側のナビゲーション ウィンドウで、 [セキュリティ] を選択します。
    2. セキュリティのページで、SSO/SAML を有効にするオプションを選択します。
    3. SSO/SAML を有効にした後、SCIM プロビジョニングを有効にするオプションを選択します。
      Miroは、API アクセストークンを自動的に生成し [API トークン] フィールドに表示します。
    4. オプション: [ SCIM でプロビジョニングされたユーザーにメール通知を送信する ] チェックボックスをオンにすると、SCIM を使用してプロビジョニングされたすべてのユーザーにメール通知を送信 Miro 。
    5. [API トークン] フィールドに API アクセストークンをコピーします。
      後で使用できるように安全な場所に保存してください。

    Miro Enterprise接続を作成

    Miro EnterpriseアプリケーションとServiceNowインスタンスの間に接続を作成します。

    始める前に

    ServiceNow 必要なロール：admin

    手順

    1. ServiceNowインスタンスから、 プロセス自動化 > Flow Designer (フローデザイナー).
      フローデザイナーが新しいタブで起動します。
    2. [ 統合 ] タブを選択し、「 Miro」を検索します。
    3. Miro Enterprise 接続の [詳細を表示] を選択します。
    4. Miro Enterprise接続の詳細から、[構成] を選択します。
    5. [接続を作成] ダイアログボックスで、フィールドに入力します。
      表 : 3. [接続を作成] ダイアログボックス
      フィールド 説明
      接続情報
      接続名 Miro Enterprise接続の名前です。このフィールドは、自動的に入力されます。
      認証情報
      OAuth クライアント ID Miro EnterpriseOAuth 2.0 アプリケーションに割り当てられているクライアント ID
      OAuth クライアントシークレット Miro EnterpriseOAuth 2.0 アプリケーションに割り当てられているクライアントシークレット
      OAuth リダイレクト URL 認証後にユーザーがリダイレクトされる OAuth プロバイダーの URL。

      このフィールドは、Miro EnterpriseOAuth 2.0 アプリケーションを作成で指定したリダイレクト URL に基づいて自動的に入力されます。
    6. [OAuth トークンを作成して取得] を選択します。
      重要:

      このステップは、Miro の会社アドミニストレーターロールを持つServiceNowアドミンが実行する必要があります。

    7. [ Miro OAuth 認証] ダイアログ ボックスで、 Miro Enterprise OAuth 2.0 アプリケーションをビルドしたチームを見つけて、[ インストール] を選択します。
      注:
      別の ServiceNow インスタンスが同じ認証情報を使用している場合は、再インストールを求められます。
      OAuth アクセストークンは、Miro Enterprise接続を許可するために使用できるようになります。

    Miro EnterpriseSCIM 接続を作成

    Miro EnterpriseSCIM とServiceNowインスタンスの間に接続を作成します。

    始める前に

    ServiceNow 必要なロール：admin

    手順

    1. ServiceNowインスタンスから、 プロセス自動化 > Flow Designer (フローデザイナー).
      フローデザイナーが新しいタブで起動します。
    2. [ 統合 ] タブを選択し、「 Miro」を検索します。
    3. Miro Enterprise SCIM 接続の [詳細を表示] を選択します。
    4. Miro Enterprise SCIM 接続の詳細から、[構成] を選択します。
    5. [接続を作成] ダイアログボックスで、フィールドに入力します。
      表 : 4. [接続を作成] ダイアログボックス
      フィールド 説明
      接続情報
      接続名 Miro EnterpriseSCIM 接続の名前このフィールドは、自動的に入力されます。
      認証情報
      API トークン MiroAPI 要求を認証するための API アクセストークン

      生成してコピーした同じ API アクセストークンをMiro Enterpriseアカウントで SCIM を有効化に入力します。
    6. [接続を作成] を選択します。

    Miro Enterprise 統合プロファイルの作成

    Miro Enterprise 統合プロファイルを作成して、ソフトウェアサブスクリプションを追跡し、Miro Enterprise アプリケーションのライセンスを最適化します。

    始める前に

    Miro Enterprise統合プロファイルを作成するには、ServiceNow Store から ソフトウェア資産管理 - SaaS ライセンス管理 プラグイン (sn_sam_saas_int) を要求します。

    ServiceNow 必要なロール:sam_integrator または admin

    重要:
    [Application Manager] ページでオプション機能をインストールする際には、この統合の [Miro スポーク] チェックボックスをオンにする必要があります。必要な SaaS アプリケーションの選択の詳細については、「 SaaS ライセンス管理の要求」を参照してください。

    このタスクについて

    ソフトウェア資産ワークスペースを使用している場合、コア UI でMiro Enterprise統合プロファイルを作成するオプションは非アクティブです。

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      Core UI (コア UI)
      1. 次のように移動する。 All (すべて) > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. [Miro Enterprise 統合プロファイル] を選択します。
      ソフトウェア資産ワークスペース
      1. 次のように移動する。 ライセンス操作 > ユーザー登録 > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. ドロップダウンリストから [Miro Enterprise ] を選択します。
      4. [Continue (続行)] を選択します。
    2. フォームで次のフィールドに入力します。
      表 : 5. 統合プロファイルフォーム
      フィールド 説明
      表示名 データ連携プロファイルの名前例: Miro Enterprise 統合。
      ステータス 統合プロファイルのステータス。
      • 統合プロファイルを公開していない場合、このフィールドは自動的に [ドラフト] に設定されます。
      • 統合プロファイルを既に公開している場合、このフィールドは自動的に [公開済み] に設定されます。
      プロファイルタイプ 統合プロファイルのタイプ。

      このフィールドは自動的に Miro Enterprise サブスクリプションに設定されます。
    3. 各プロセスの [ ベンダー構成 ] フィールドで指定された必要なユーザーロールまたは API 権限を確認して、セキュリティリスクを最小限に抑え、 SaaS ライセンスを最適化します。
      注:
      必要なロールとスコープの詳細については、「 最小限のユーザー権限 」テーブルを参照してください。
      1. [サブスクリプションサブフローをダウンロード] セクションで、[ サブフロー ] フィールドが [Miro サブスクリプションをダウンロード] に設定されていることを確認します。
        注:
        [ サブスクリプションをダウンロード ] チェックボックスはデフォルトでオンになっており、オフにすることはできません。
      2. [サブスクリプションサブフローの再利用] セクションで、[ サブフロー ] フィールドが [Miro サブスクリプションの再利用] に設定されていることを確認します。
        注:
        [ サブスクリプションを再利用 ] チェックボックスはデフォルトでオンになっています。サブスクリプションを再利用しない場合は、このチェックボックスをオフにします。これをクリアすると、削除候補は作成されますが、サブスクリプションの再利用サブフローがトリガーされないか、再利用プロセスが開始されません。
    4. すべての必須フィールドに入力したら、[ 保存 ] を選択します。
      ServiceNowインスタンスでドラフトの統合プロファイルが作成されます。
    5. 統合プロファイルフォームで、[ 接続を検証 ] を選択して、この統合の接続と資格情報の詳細を確認します。

      接続を検証すると、Download Subscriptions API は検証されますが、Reclaim Subscriptions API は検証されません。

    6. 接続が検証されたら、[ 公開] を選択します。
    7. 公開の確認 ダイアログ ボックスで、 OK を選択します。

    次のタスク

    統合が接続されると、 ServiceNow インスタンスでソフトウェアモデル、再利用ルール、ソフトウェアサブスクリプションが自動的に作成され、毎日更新されます。

    一意の接続を持つ複数の統合プロファイルを設定する場合は、子エイリアスを作成して、統合プロファイルごとに異なる構成と設定を管理します。詳細については、「子エイリアスを作成して複数の統合プロファイルを設定する」を参照してください。

    ユーザーサブスクリプションを再利用するために、自動的に生成されたすべての再利用ルールを確認します。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。

    自動生成されたソフトウェアモデルのソフトウェアエンタイトルメントを作成して、使用済みソフトウェアを所有ソフトウェアに対して追跡します。
    調整は、サブスクリプションでもスケジュール済みジョブとして、またはオンデマンドで実行されます。調整結果は、 ライセンスワークベンチ (クラシックアプリケーションソフトウェア資産管理 ) または ライセンス使用状況ビュー (ソフトウェア資産ワークスペース) で表示できます。これらの結果を使用して、ライセンスコンプライアンスの状況を判断し、コンプライアンス違反を修正します。