• English

セキュアな Microsoft Teams コンテンツの認証メカニズムとしての Microsoft Graph API の設定

Microsoft Teams統合では、Azure Active Directoryに登録されたアプリケーションを使用して、エンタープライズメッセンジャー統合（EMI）サーバーを表します。

EMI Server は Microsoft Graph API サブスクリプションを使用して、チャットの作成、チャットの変更、新規チャットメッセージなど、Microsoft Teams からのイベントを受信します。さらに、写真やGPS位置情報など、Microsoft Teamsアプリケーションからの一部のコンテンツには認証が必要であり、これはEMIサーバー経由のMicrosoft Graph APIリクエストによって処理されます。EMI Server は Webhook をインターネットに公開し、Microsoft サーバーがイベント通知を送信するために Webhook を発信できるようにします。

Graph API は、特定のクライアント アプリケーションが各リソースで 1 つのサブスクリプションしか持たないように制限します。つまり、特定の Azure Active Directory テナントからの通知をサブスクライブできる EMI Server のインスタンスは 1 つだけで、Azure Active Directory テナントごとに使用できる EMI Server/Azure アプリケーションは 1 つだけです。同じ Azure Active Directory テナントのすべてのユーザーは、EMI サーバーの単一のインスタンスによってサービスを提供されることに注意してください。

この記事では、以下の方法を説明します：

• エンタープライズメッセンジャー統合（EMI）サーバーを表す新規アプリケーションを Azure Active Directory に登録します。
• Webhook (リダイレクト URI) を設定します。
• Microsoft Graph API を使用するアプリケーションのアクセス権を設定します。
• クライアントシークレット（トークン）を設定します。

前提条件

• コンタクトセンターのMicrosoft Teams管理者であること。
• Microsoft Azureポータルの管理者権限とアクセス権を持っている。

手順

1.Azure Active Directoryにアプリケーションを登録する

1. Azure ポータルにログインする。Azure ダッシュボードから、Azure Active Directory > App registrations に移動します。
   
   
2. 新規登録］をクリックして、新規アプリケーションを登録します。このアプリケーションは、EMI サーバーを代表し、EMI サーバーが Microsoft Graph API で認証できるように API 認証情報（トークン）を提供します。
   
   

   

   Azure Active Directory > アプリ登録 > + 新規登録

   
   
   
3. Register an applicationで、以下のプロパティを設定します：
   
   
4. # 名前- 登録するアプリケーションの名前を入力します。
   
   
   1. Supported account types- 「この組織ディレクトリのアカウントのみ(<your company’s Azure AD directory name> - シングルテナント)」を選択します.
      
      
   2. リダイレクトURI- "Web "を選択し, "https://<tenant_url>/agentdesktop/msteamscallback.html" (例: https://yourcompany.brightpattern.com>/agentdesktop/msteamscallback.html) を設定します.
      
      

      

      「アプリケーションの登録」プロパティ

      
      
      
5. Register をクリックします。登録後、新規アプリのダッシュボードが表示されます。
   
   

2.アプリケーションの新規クライアントシークレットを追加します。

1. アプリのダッシュボードから、「Manage（管理）」 > 「Certificates & secrets（証明書とシークレット）」に進みます。
   
   

   

   アプリのダッシュボードから、サイドメニューの「Certificates & secrets（証明書と秘密）」を選択します。

   
   
   
2. 証明書と秘密]で、[クライアントの秘密]セクションまでスクロールダウンし、[+新規クライアント秘密]をクリックします。(証明書の追加はオプションであることにメモ）。
   
   

   

   証明書と秘密]で、[クライアントの秘密]セクションに移動し、新規クライアント秘密を生成します。

   
   
   
3. クライアントシークレットの追加で、シークレットの説明を設定し、有効期限を可能な限り長いオプション、またはコンタクトセンター独自のセキュリティポリシーに必要な期限に設定し、追加をクリックします。カスタムオプションでは、現在10年以上の有効期限が設定されています。
   
   

   

   クライアントシークレットの追加」で、名前を付け、期限を設定します。

   
   
   
4. クライアントシークレットの値をコピーし、安全な場所に保存してください。必ず値をコピーしてください（IDではありません）。
   
   

   

   クライアントの秘密値をコピーする。

   
   
   

3.必須APIアクセス権の設定

1. Microsoft Teamsとの統合には、Graph APIの特定のアクセス権とアプリケーションのアクセス権が必要です。アクセス権を設定するには、アプリのAPIアクセス権セクションに移動し、[+ アクセス権を追加]をクリックします。
   
   

   

   APIアクセス権で、"+ アクセス権を追加 "をクリックします。

   
   
   
2. Request API permissionsから、"Microsoft APIs "タブをクリックし、Microsoft Graphを選択します。
   
   

   

   Microsoft Graphを選択します。

   
   
   
3. 権限の委譲]を選択します。
   
   

   

   Microsoft Graphの場合は、"権限の委譲 "を選択します。

   
   
   
4. 以下の各権限名をコピーして検索フィールドに貼り付け、権限のオプションを展開し、そのチェックボックスを選択し、[権限を追加]をクリックします。これらのアクセス権のほとんどは管理者の同意が必要なので、それぞれ個別に追加する必要があることにメモしてください。
   
   以下の委任されたアクセス権を追加します：
   
   
   1. チャット.ReadWrite
      
      
   2. ChatMessage.Send
      
      
   3. ChannelMessage.Send
      
      
   4. ディレクトリ.既読.全て
      
      
   5. グループ.既読.全て
      
      
   6. プレゼンス.既読.全て
      
      
   7. 購読.既読.全て
      
      
   8. ユーザー.既読.全て
      
      
5. Request API permissions > Microsoft Graph APIに戻り、今度はApplication permissionsを選択する。
   
   

   

   Microsoft Graphの場合は、"Application permissions "を選択する。

   
   
   
6. 以下の各アクセス権名をコピーして検索フィールドに貼り付け、パーミッションのオプションを展開し、そのチェックボックスを選択し、パーミッションの追加をクリックする。これらのアクセス権のほとんどは管理者の同意が必要なので、それぞれ個別に追加する必要があることにメモしてください。
   
   以下のアプリケーションのアクセス権を追加します：
   
   
   1. チャット.ReadWrite.All
      
      
   2. ChannelMessage.Read.All
      
      
   3. ユーザー.既読.全て
      
      
7. すべてのアクセス権が追加されたら、Grant admin consent for<your organization>ボタンをクリックし、Graph API の使用を許可する。
   
   

   

   Grant admin consent for<your organization>" をクリックするのを忘れないこと。

   
   
   成功すると、各アクセス権のステータスが "Granted" になるはずです。
   
   

   

   付与されたMicrosoft Graphアクセス権のリスト例

   
   
   

4.認証情報をコピーする

Bright Pattern Contact CenterでMicrosoft Teams統合アカウントを設定するには、以下のセクションを参照してください。 Microsoft Teams 統合アカウントを参照）、Azure Active Directory アカウントと登録アプリから以下の項目をコピーする必要があります：

• Azure Active Directory> Dashboard > Your registered app > OverviewにあるテナントID。
  
  

  

  Azure Active Directory > ダッシュボード > 登録アプリ > 概要ページ

  
  
  

• アプリケーション（クライアント）ID。Azure Active Directory> ダッシュボード > 登録アプリ > 概要にあります。
  
  

  

  Azure Active Directory > Dashboard > Your registered app > Overview ページ。

  
  
  

• クライアントシークレット、この手順のステップ 2 で登録アプリに追加したものです。クライアントシークレットをコピーし忘れた場合は、新規クライアントシークレットを追加してコピーする必要があります。
  
  

  

  アプリの証明書と秘密のセクション

  
  
  

これで Azure アプリの設定は完了です。

---

次へステップ

Bright Pattern Contact Centerのコンタクトセンター管理者アプリケーションで Microsoft Teams Integrationアカウントを追加します。.

< 前へ | 次へ >