Microsoft Teams の構成

公開プレビュー版: 連携検索は公開プレビュー版です。この機能は、サービス固有規約の「一般サービス規約」セクションの「一般提供前サービス規約」の対象となります。pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。詳細については、リリース ステージの説明をご覧ください。

このページでは、Microsoft Teams データストアを作成する前に認証と権限を設定する方法について説明します。

認証と権限を設定する

Microsoft 365 で認証と権限を設定する必要があります。この操作は、コネクタがデータにアクセスできるようにするために不可欠です。MS Teams コネクタは、OAuth クライアント認証情報や API トークンなど、さまざまな認証方法をサポートしています。

Microsoft Teams コネクタ用の Entra アプリの登録

Gemini Enterprise コネクタを作成する前に、Microsoft Teams への安全なアクセスを有効にするように Microsoft Entra アプリケーション登録を設定する必要があります。

Microsoft Entra で Gemini Enterprise を OAuth 2.0 アプリケーションとして登録する手順は次のとおりです。

1. Microsoft Entra 管理センターに移動します。
2. メニューで [Entra ID] セクションを開き、[App registrations] を選択します。
3. [App registrations] ページで、[add New registration] を選択します。
4. [Register an application] ページで、次の操作を行ってアプリ登録を作成します。
   1. [Name] セクションに、アプリケーションの表示名を入力します。

      

      アプリケーションの登録ページ

   2. [Supported account types] セクションで、[Accounts in the organizational directory only] を選択します。このオプションでは、組織の Microsoft Entra テナント内のユーザーにアクセスが制限されます。これは、エンタープライズ アプリケーションに適しています。
   3. [Redirect URI] セクションで [Web] を選択し、次の URL をウェブ コールバック URL（またはリダイレクト URL）として入力します。
      • https://vertexaisearch.cloud.google.com/oauth-redirect
   4. [Register] をクリックします。Microsoft Entra によってアプリが作成され、[All applications] ページに表示されます。

OAuth 2.0 構成を作成する

OAuth 2.0 認証方法を使用して接続を作成するには、Microsoft Entra アプリケーション登録ページからクライアント ID、クライアント シークレット、テナント ID を取得する必要があります。

クライアント ID とクライアント シークレットを取得する

アプリのクライアント ID とシークレットを取得するには、次の操作を行います。

1. Microsoft Entra 管理センターに移動します。
2. メニューで [Entra ID] セクションを開き、[App registrations] を選択します。
3. [App registrations] ページで、[All applications] を選択します。
4. 作成したアプリケーションを開きます。
5. アプリのページで、[Certificates & secrets] を選択します。
6. [add New client secret] をクリックします。
7. [Add a client secret] ダイアログで次の操作を行います。
   1. シークレットの説明を入力します。

      

      [Add a client secret] ダイアログ

   2. 有効期限を選択します。デフォルト値を選択することをおすすめします。
   3. [Add] をクリックします。
8. [Value] 列（Client Secret）のシークレットと、[Secret ID] 列（Client ID）の ID をコピーし、後で使用するために安全に保存します。

テナント ID を取得する

テナント ID は、Microsoft Entra 管理センターの概要ページの [Tenant ID] ボックスにあります。

テナント ID を取得する

Microsoft Graph の最小権限

アプリに必要な API 権限を構成するには、次の操作を行います。

1. Microsoft Entra 管理センターに移動します。
2. メニューで [Entra ID] セクションを開き、[App registrations] を選択します。
3. [App registrations] ページで、[All applications] を選択します。
4. 作成したアプリケーションを開きます。
5. アプリページで、[API permissions] を選択します。
6. [Add a Permission] をクリックします。

7. [Request API permissions] ページで、[Microsoft Graph] を選択し、[Delegated permissions] を選択します。

8. 連携検索の次の権限を検索して選択します。

   接続モード	権限	目的
   連携検索	Group.Read.All	データストアがグループのプロパティとメンバーシップを読み取り、すべてのグループの会話を読み取れるようにします。
   	Sites.Read.All	組織全体の Teams チャネル内で共有されているすべてのファイルとドキュメントをデータストアが読み取れるようにします。
   	ChatMessage.Read.All	1 対 1 のチャットとグループ チャットのすべてのメッセージの読み取りをアプリに許可します。
   	User.Read.All	データストアがユーザー プロファイルを読み取れるようにします。

9. [Add Permissions] をクリックします。