次の方法で共有

Microsoft Teams のエージェント向けに Microsoft Entra ID によるシングル サインオンを構成する

Copilot Studio では、Microsoft Teams 1:1 チャットに発行されたエージェントのシングル サインオン (SSO) がサポートされます。 このサポートにより、エージェントは Microsoft Teams 資格情報を使用してユーザーを自動的にサインインさせることができます。 SSO は、Microsoft Entra ID を使用する場合にのみサポートされます。 Azure AD v1 などの他のサービス プロバイダーは、Microsoft Teams の SSO をサポートしていません。

重要

手動認証を必要とせずに、Microsoft Teams チャットで SSO を使用できます。 以前に公開されたエージェントにこの方法を使用するには、Microsoft で認証を使用するようにエージェントを再構成し、Microsoft Teams に再度公開します。 この変更が有効になるまでに数時間かかる場合があります。 ユーザーが会話の途中で変更がまだ行われていない場合は、チャットで「最初からやり直す」と入力すると、最新バージョンのエージェントで会話を強制的に再開できます。 これらの変更は、ユーザーと エージェント 間の Teams の 1 対 1 のチャットで利用できるようになりました。 グループ チャットやチャネル メッセージではまだ利用できません。

Dynamics 365 Customer Service と統合されたエージェントでは SSO はサポートされません。

必要でない限り、次のドキュメントに進まないでください。 エージェントに手動認証を使用する場合は、Microsoft Entra ID を使用してユーザー認証を構成するを参照してください。

注意

手動認証オプションで Teams SSO 認証を使用し、同時にカスタム Web サイトでエージェントも使用している場合は、アプリ マニフェストを使用して Teams アプリを展開する必要があります。

詳細については、エージェントの Teams アプリ マニフェストをダウンロードするを参照してください。

手動以外の認証オプションや、Copilot Studio ワンクリックを使用した Teams 展開による認証など、その他の構成は機能しません。

前提条件

アプリの登録を構成する

Teams の SSO を構成する前に、Microsoft Entra ID を使用してユーザー認証を設定します。 このプロセスにより、SSO を設定するために必要なアプリ登録が作成されます。

  1. アプリ登録を作成する。 「Microsoft Entra ID を使用してユーザー認証を構成する」の手順を参照してください。

  2. リダイレクト URL を追加します。

  3. クライアント シークレットを生成します。

  4. 手動認証を構成します。

Teams チャネル アプリ ID を見つける

  1. Copilot Studio で、SSO を構成するエージェントを開きます。

  2. エージェントのチャネル ページに移動し、Teams と Microsoft 365 Copilot タイルを選択します。

  3. Teams および Microsoft 365 Copilot 構成パネルで、詳細の編集を選択し、その他を展開して、アプリ ID フィールドの横にあるコピーを選択します。

Teams チャネル アプリ ID をアプリ登録に追加する

  1. Azure portal に移動します。 エージェントのユーザー認証を構成したときに作成したアプリ登録のアプリ登録インスタンスを開きます。

  2. サイド ペインでAPI を公開するを選択します。 アプリケーション ID URI には 設定 を選択します。

    アプリケーション ID URIの [設定] ボタンの場所のスクリーンショット。

  3. api://botid-{teamsbotid} を入力して {teamsbotid} を自分の Teams チャネル アプリ ID に置き替えます。

    [アプリケーション ID URI] ボックスに入力された正しい形式の URI のスクリーンショット。

  4. 保存 を選択します。

アプリケーションは、同意プロセス中にユーザーまたは管理者がアクセス許可を付与するときに API を呼び出すことが許可されます。 同意の詳細については、Microsoft ID プラットフォームでのアクセス許可と同意を参照してください。

管理者の同意オプションが使用可能な場合は、同意を付与します。

  1. アプリ登録の Azure ポータルで、API アクセス許可に移動します。

  2. <テナント名>に管理者の承認を付与するを選択してから、はいを選択します。

重要

ユーザーが各アプリケーションに対して同意する必要をなくすために、少なくともアプリケーション管理者またはクラウド アプリケーション管理者の役割を割り当てられた担当者は、アプリケーション登録に対してテナント全体にわたる同意を与えることができます。

API アクセス許可を追加する

  1. アプリ登録の Azure ポータルで、API アクセス許可に移動します。

  2. アクセス許可の追加を選択して、Microsoft Graphを選択します。

  3. 委任されたアクセス許可を選択します。 アクセス許可のリストが表示されます。

  4. OpenID アクセス許可を展開します。

  5. openid と プロファイルを選択します。

  6. アクセス許可の追加を選択します。

    openid と profile のアクセス許可がオンになっているスクリーンショット。

エージェントのカスタム スコープを定義する

  1. アプリ登録インスタンスの Azure ポータルで、API の公開に移動します。

  2. スコープの追加 を選択します。

    [スコープの追加] ボタンが強調表示されたスクリーンショット。

  3. 次のようにプロパティを設定します。

    プロパティ 価値
    スコープ名 Test.Read を入力します
    同意できるユーザー 管理者とユーザー を選択します
    管理者の同意の表示名 Test.Read を入力します
    管理者の同意の説明 Allows the app to sign the user in. を入力します
    状態 有効を選択します

    注意

    スコープ名 Test.Read はプレースホルダー値です。 使用している環境においてわかりやすい名前で上書きします。

  4. スコープの追加を選択します。

Microsoft Teams クライアント ID の追加

重要

次の手順では、Microsoft Teams クライアント ID に指定された値は、すべてのテナントで同じであるため、文字通り使用する必要があります。

  1. アプリ登録インスタンスの Azure ポータルで、API の公開に移動し、クライアント アプリケーションの追加を選択します。

    [クライアント アプリケーションの追加] ボタンが強調表示されたスクリーンショット。

  2. クライアント ID フィールドで、Microsoft Teams モバイル/デスクトップのクライアント ID を入力します。これは 1fec8e78-bce4-4aaf-ab1b-5451cc387264 です。 以前作成したスコープのチェックボックスを選択します。

    [クライアント アプリケーションの追加] ウィンドウに入力されたクライアント ID のスクリーンショット。

  3. アプリケーションの追加を選択します。

  4. 前の手順を繰り返しますが、クライアント ID に、Web 上の Microsoft Teams のクライアント ID (5e3ce6c0-2b1f-4285-8d4b-75ee78787346) を入力します。

  5. API を公開するページに Microsoft Teams クライアント アプリ ID がリストされることを確認します。

要約すると、API の公開ページに追加された 2 つの Microsoft Teams クライアント ID は次のとおりです。

  • 1fec8e78-bce4-4aaf-ab1b-5451cc387264
  • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346

トークン交換 URL をエージェントの認証設定に追加する

Copilot Studio で Microsoft Entra ID 認証設定を更新するには、Microsoft Teams と Copilot Studio が情報を共有できるようにトークン交換 URL を追加する必要があります。

  1. アプリ登録インスタンスの Azure ポータルで、API の公開に移動します。

  2. スコープの下で、クリップボードにコピー アイコンを選択します。

  3. Copilot Studio のエージェントの設定で、セキュリティを選択し、認証タイルを選択します。

  4. トークンの交換 URL (SSO に必要)に、先ほどコピーしたスコープを貼り付けます。

  5. 保存を選択します。

    トークン交換 URL を Copilot Studio に貼り付ける場所のスクリーンショット。

エージェントの Teams チャネルに SSO を追加する

  1. Copilot Studio で、エージェントの設定でチャネルを選択します。

  2. Teams と Microsoft 365 Copilot タイルを選択します。

  3. 詳細の編集を選択して詳細表示を展開します。

  4. AAD アプリケーションのクライアント IDに、アプリの登録からアプリケーション (クライアント) ID を入力します。

    この値を取得するには、Azure portal を開きます。 次に、アプリ登録で概要に移動します。 アプリケーション (クライアント) ID ボックスで値をコピーします。

  5. リソース URI に、アプリの登録からアプリケーション ID URIを入力します。

    この値を取得するには、Azure portal を開きます。 次に、アプリ登録で API を公開するに移動します。 アプリケーション ID URI ボックスで値をコピーします。

    Copilot Studio の Teams チャネルでアプリケーション ID URI を貼り付ける場所のスクリーンショット。

  6. [保存]、[閉じる] の順に選択します。

  7. エージェントをもう一度公開し、顧客が最新の変更を利用できるようにします。

  8. Teams で エージェントを表示する を選択して、Teams でエージェントと新しい会話を開始し、自動的にログインされるかどうかを確認します。

既知の問題

Teams SSO なしで手動認証を使用してエージェントを最初に公開した場合、Teams のエージェントはユーザーにサインインを継続的に求めます。

  • Last updated on