Copilot Studio でユーザー認証を構成する

認証により、ユーザーはサインインして、エージェントに制限付きリソースや情報へのアクセスを与えることができます。 ユーザーは、Microsoft Entra ID、または Google や Facebook などの任意の OAuth2 ID プロバイダーでサインインできます。

トピックを編集する際に、ユーザー認証をトピックに追加 できます。

認証オプションを選択する

Copilot Studio では、いくつかの認証オプションがサポートされています。 ニーズに合ったオプションを選択して構成します。

1. エージェントの設定に移動し、セキュリティを選択します。

2. [ 認証] を選択します。

3. 認証オプションを選択し、必要に応じて構成します。 次の認証オプションを使用できます:

   • 認証なし
   • Microsoft で認証する
   • 手動で認証する

4. 保存を選びます。

認証なし

認証なしを選択すると、エージェントは会話中にユーザーにサインインを要求しません。 認証なしの構成の場合、エージェントがアクセスできるのは、一般に公開されている情報やリソースにのみということになります。 従来型のチャットボットの設定は、既定で認証 なし になっています。

Microsoft で認証する

この構成では、手動で構成しなくても、Teams のMicrosoft Entra ID認証が自動的に設定されます。 Teams 認証でユーザーの識別が完結するため、エージェントのスコープを拡張する必要が生じない限り、Teams の使用中にユーザーがサインインを求められることはありません。

エージェントを Teams + Microsoft 365 以外のチャネルに発行する必要があるが>エージェントの認証が必要な場合は、Authenticate を手動でを選択します。

Microsoft と認証を選択した場合、トピック作成キャンバスで次の変数を使用できます。

• User.ID
• User.DisplayName

これらの変数とその使用方法の詳細については、トピックにユーザー認証を追加する を参照してください。

と の変数は、このオプションでは使用できません。 認証トークンが必要な場合は、手動認証 オプションを使用します。

手動で認証 から Microsoft と認証 に変更し、トピックに変数 または が含まれている場合、変更後に 不明な 変数として表示されます。 エージェントを公開する前に、エラーのあるトピックを必ず修正してください。

手動で認証する

Copilot Studio では、Authenticate の手動 オプションで次の認証サービス プロバイダーがサポートされます。

• Microsoft Entra ID V2 をフェデレーション資格情報で使用する
• 証明書を使用した Microsoft Entra ID V2
• Microsoft Entra ID V2のクライアント シークレットを使用する
• Microsoft Entra ID
• Generic OAuth 2 - OAuth2 標準 に準拠している ID プロバイダー

手動で認証するを選択した場合、トピック作成キャンバスで次の変数を使用できます。

• User.Id
• User.DisplayName
• User.AccessToken
• User.IsLoggedIn

これらの変数とその使用方法の詳細については、トピックにユーザー認証を追加する を参照してください。

構成が保存されたら、変更が有効になるように必ずエージェントを公開してください。

必要なユーザー サインインとエージェントの共有

ユーザーにサインインを要求する では、ユーザーがエージェントと対話する前にサインインする必要があるかどうかを判断します。 機密情報や制限された情報にアクセスする必要があるエージェントには、この設定をオンにすることを強くお勧めします。

このオプションは、認証なし および Microsoft で認証する オプションでは使用できません。

このオプションをオフにすると、サインインを必要とするトピックが検出されるまで、エージェントはユーザーにサインインを求めません。

このオプションをオンにすると、ユーザーにサインインを要求する というシステム トピックが作成されます。 このトピックは、手動で認証 設定にのみ関連します。 ユーザーは常に Teams で認証されます。

ユーザーにサインインを要求する トピックは、認証されていなくても、エージェントと対話するすべてのユーザーに対して自動的にトリガーされます。 ユーザーがサインインに失敗した場合、トピックは エスカレート システム トピックにリダイレクトされます。

トピックは読み取り専用で、カスタマイズすることはできません。 表示するには、[作成キャンバスに移動する] を選択してください。

組織内のエージェントとチャットできるユーザーを制御する

エージェントの認証タイプとユーザーにサインインを要求する設定の組み合わせにより、エージェントを共有して組織内の誰がエージェントとチャットできるかを制御できるかどうかが決まります。 認証設定は、コラボレーションのためのエージェントの共有には影響しません。

• 認証なし: エージェントへのリンクがある (または、たとえば、Web サイト などでリンクを見つけることができる) あらゆるユーザーがボットとのチャットを行えます。 組織内のどのユーザーがエージェントとチャットできるかを制御することはできません。

• Microsoft で認証する: エージェントは Teams チャネルでのみ機能します。 ユーザーは常にサインインしているため、ユーザーにサインインを要求する 設定がオンになっていて、オフにすることはできません。 エージェント共有を使用して、組織内の誰がエージェントとチャットできるかを制御できます。

• 手動で認証する:

  • サービス プロバイダーが Microsoft Entra ID の場合は、Require ユーザーのサインインを有効にして、エージェント共有を使用してエージェントとチャットできる組織内のユーザーを制御できます。

  • サービス プロバイダーが 汎用 OAuth2 の場合は、ユーザーにサインインを要求する をオンまたはオフにします。 オンにすると、サインインしたユーザーがエージェントとチャットできます。 エージェント共有を使用して組織内のどの特定のユーザーがエージェントとチャットできるかを制御することはできません。

エージェントの認証設定でエージェントとチャットできるユーザーを制御できない場合、エージェントの概要ページで共有を選択すると、誰でもエージェントとチャットできることを通知するメッセージが表示されます。

手動認証フィールド

次の表では、手動認証を構成するときに表示される可能性のあるフィールドについて説明します。 表示される特定のフィールドは、サービス プロバイダーの選択によって異なります。

1 ID プロバイダーが必要とする場合は、スコープ フィールドでスペースを使用できます。 その場合は、コンマ () を スコープ リストの区切り文字に入力し、スコープ フィールドにスペースを入力します。

認証をオフにする

1. エージェントを開いた状態で、上部のメニュー バーにある設定を選択します。

2. セキュリティ を選択し、認証 を選択します。

3. 認証なしを選択します。

   認証変数がトピックで使用されている場合は、不明な 変数になります。 トピック ページに移動して、エラーのあるトピックを確認し、公開する前に修正してください。

4. エージェントを公開する。