認証
Microsoft Copilot Studio の認証設定は、ボット コパイロットへのアクセスの管理方法に影響を及ぼします。 認証により、会話中にユーザーの ID を確認できるようになり、次のことが可能になります。
会話をさらにパーソナライズする
ユーザーの代わりにコパイロットがアクションを実行する
ユーザーのデータを事前に入力して本論に入ることにより、会話のダイアログをスキップする
ユーザーの ID や表示名などの変数をトピック内で使用できる
柔軟なエクスペリエンスになります。 ユーザーのサインインが必要ば会話の一部にマーキングでき、その他の部分ではユーザーのサインインは必要ありません。
認証設定は、Microsoft Copilot Studio でサイド ナビゲーション ウィンドウの設定を選択し、セキュリティ>認証に移動すると表示されます。
認証のオプションは次のとおりです。
認証なし
Teams 専用
手動 (Teams を含む任意のチャネル用)
認証設定の変更を適用するには、コパイロットを公開する必要があります。
認証なし
認証なしを選択した場合、コパイロットにアクセスできるユーザー全員がサインインしなくてもボットとチャットできます。 これには、コパイロットのリンクを知っているすべてのユーザーや、Web サイトなどにあるボットを見つけたすべてのユーザーが含まれます。 トピックでは、認証なし変数を使用できます。
Teams 専用
このオプションでは、Microsoft Teams に対してのみ認証を設定します。これにより、他のチャネルがすべてオフになり、コパイロットはチャネルから切り離されます。 コパイロットを共有しているユーザーのみが使用できます。
手動 (Teams を含む任意のチャネル用)
Microsoft Copilot Studio は、OAuth2 標準 に準拠している ID プロバイダーをサポートしています。 つまり、ユーザーが OAuth2 ID プロバイダーを使用してサインインできるように設定できます。 OAuth2 ID プロバイダーは次のとおりです。
Microsoft Entra ID
Microsoft アカウント
Google
Facebook
会社用に作成したカスタム認証サービス。
会話中に認証アクションを呼び出し、サインイン カードを使用してユーザーにプロンプトを表示できます。 または、ユーザーにサインインを要求するオプションをオンにして、ユーザーにサインインを要求するシステム トピックを作成することもできます。 この場合、ユーザーがコパイロットとの会話を始めるとすぐにサインインが求められます。 このスクリーンショットは、ユーザーにサインインを要求するシステム トピックと、格納されている変数を示しています。 取得される変数は、IsLoggedIn、AuthToken、UserDisplayName、UserID です。
手動認証の構成
Microsoft Copilot Studio で手動認証を構成するには、新しいアプリを ID プロバイダーに登録し、クライアント ID とクライアント シークレットを取得します。 以下では、Microsoft Entra ID の Azure portal からこれを行う方法について詳しく説明します。
アプリケーションを登録するには、Azure portal でアプリの登録に移動し、新しい登録を作成します。 登録の名前 (コパイロット名など) を指定した後、コパイロットにアクセスできるアカウントを指定する必要があります。 たとえば、このようにオプションを選択すると、どの Microsoft Entra ID ディレクトリのユーザーまたは個人用 Microsoft アカウントのユーザーでもサインインしてコパイロットと会話できます。 リダイレクト URI は https://token.botframework.com/.auth/web/redirect
にし、プラットフォームとして Web を選択してください。
次に、新しいクライアント シークレットを追加する必要があります。 アプリの登録の証明書とシークレット領域に移動し、+ 新しいクライアント シークレットを選択できます。 ここでは、説明を入力し、有効期限を選択できます。
クライアント シークレット値は、構成に使用するため書き留めておいてください。
さらに、アプリケーション (クライアント) ID も必要になります。これは、アプリの登録の概要領域で確認できます。
Azure が構成されたので、Microsoft Copilot Studio の認証設定を入力できるようになりました。 Microsoft Copilot Studio でコパイロットを開いて、設定>セキュリティ>認証に移動できます。
認証オプションは手動にしてください。 ユーザーにサインインを要求するをオンにした場合、システム トピックが作成され、会話の開始時にユーザーにサインインを求めるプロンプトが表示されます。 オフにした場合、会話の任意の時点で認証アクションを呼び出すことができます。
サービス プロバイダーは Azure Active Directory v2 にしてください。 クライアント ID とクライアント シークレットの各フィールドには、前の手順で取得したアプリケーション ID とクライアント シークレット値を入力できます。 トークンの交換 URL はオプションのフィールドであり、シングル サインオンを構成 する際に使用します。 スコープとは、サインインした認証済みユーザーに付与するアクセス権を指します。 詳細については、スコープを参照してください。
認証設定が保存されてコパイロットが公開されると、トピックでアクションを呼び出す>認証を使用できます。 複数のトピックで認証が必要な場合、ユーザーはセッション全体で一度だけサインインを求められます。
これにより、認証に関連するメッセージと変数を含む条件分岐が自動的に設定されます。 ユーザーがログインするときに認証トークンを格納する変数が用意されています。 ユーザーがログインしているかどうかを格納するブール変数と、ユーザーの ID と表示名の変数です。