Microsoft SharePoint の構成

Gemini Enterprise を Microsoft SharePoint に正常に接続するには、次の構成手順を完了する必要があります。

認証と権限を設定する

Microsoft Entra 管理センターで認証と権限を設定する必要があります。この操作は、コネクタがデータにアクセスして同期できるようにするために不可欠です。

Microsoft SharePoint コネクタ用の Microsoft Entra アプリを登録する

Gemini Enterprise で Microsoft SharePoint コネクタを作成する前に、安全なアクセスを有効にするように Microsoft Entra アプリケーションを登録します。

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

  1. Microsoft Entra 管理センターに移動します。
  2. ナビゲーション メニューで [Entra ID] を展開し、[App registrations] を選択します。
  3. [App registrations] ページで、[New registration] を選択します。

  4. [Register an application] ページで、次の操作を行います。

    1. [Name] フィールドに、ネットワークの名前を入力します。
    2. [Supported account types] セクションで、[Accounts in this organizational directory only] を選択します。
    3. [Redirect URI] セクションで、次の操作を行います。
      1. プラットフォーム リストで、Web を選択します。
      2. [Redirect URI] フィールドに「https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html」と入力します。
    4. [Register] をクリックします。Microsoft Entra によってアプリが作成され、アプリの概要ページが表示されます。

  5. アプリのナビゲーション メニューで、[Authentication] をクリックします。

  6. [Add redirect URI] をクリックします。

  7. プラットフォーム選択ペインで、次の操作を行います。

    1. [Web] を選択します。
    2. [Redirect URI] フィールドに「https://vertexaisearch.cloud.google.com/oauth-redirect」と入力します。
    3. [Configure] をクリックします。

OAuth 2.0 構成を作成する

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

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

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

    1. アプリのページに移動します。
    2. アプリのナビゲーション メニューで、[Certificates & secrets] を選択します。
    3. [New client secret] をクリックします。
    4. クライアント シークレット ペインで、次の操作を行います。
      1. [Description] フィールドに、スナップショットの説明を入力します。
      2. [Expires] リストで、有効期限を選択します。
      3. [Add] をクリックします。
    5. [Value] 列（Client Secret）に表示されるシークレットと、[Secret ID] 列（Client ID）の ID をコピーし、後で使用するために両方を安全に保存します。

インスタンス URI を取得する

インスタンス URI の形式は次のいずれかです。

  • すべての第 1 レベルのサイト: https://DOMAIN_OR_SERVER.sharepoint.com （例: mydomain.sharepoint.com）。
  • 単一サイト: https://DOMAIN_OR_SERVER.sharepoint.com/sites/WEBSITE （例: mydomain.sharepoint.com/sites/sample-site）。

テナント ID を取得する

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

Microsoft API 権限を構成する

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

  1. アプリのページに移動します。

  2. アプリのナビゲーション メニューで、[API permissions] を選択します。

  3. [Add permissions] をクリックします。

  4. [Request API permissions] ダイアログで、[Microsoft Graph] を選択します。

  5. 接続モードに基づいて、次の権限を検索して選択します。

    連携検索接続モードでは、Graph API の権限は必要ありません。

    フェデレーション認証情報を使用するデータ取り込み接続モードの場合:

    権限 タイプ 説明
    GroupMember.Read.All アプリケーション ログインしているユーザーがいないすべてのグループのメンバーシップと基本的なグループ プロパティをコネクタが読み取れるようにします。
    User.Read 委任 ログインしているユーザーのプロファイルをコネクタが読み取れるようにします。また、コネクタがログイン ユーザーの基本的な会社情報を読み取れるようにします。
    サイト制御オプション
    オプション 1: Sites.FullControl.All アプリケーション コネクタがすべてのサイト コレクションを完全に制御できるようにします。
    オプション 2: Sites.Selected アプリケーション コネクタがサイト コレクションのサブセットにアクセスできるようにします。特定のサイト コレクションと付与された権限は、SharePoint Online で構成できます。
    プロファイルの読み取りオプション
    オプション 1: User.Read.All アプリケーション コネクタがユーザー プロファイルを読み取れるようにします。
    オプション 2: User.ReadBasic.All アプリケーション コネクタが組織内の他のユーザーの基本的なプロファイル プロパティを読み取れるようにします。

    OAuth 2.0 更新トークンを使用するデータ取り込み接続モードの場合:

    権限 タイプ 説明
    GroupMember.Read.All アプリケーション ログインしているユーザーがいないすべてのグループのメンバーシップと基本的なグループ プロパティをコネクタが読み取れるようにします。
    User.Read 委任 ログインしているユーザーのプロファイルをコネクタが読み取れるようにします。また、コネクタがログイン ユーザーの基本的な会社情報を読み取れるようにします。
    User.Read.All アプリケーション コネクタがユーザー プロファイルを読み取れるようにします。
    サイト制御オプション
    オプション 1: Sites.FullControl.All アプリケーション コネクタがすべてのサイト コレクションを完全に制御できるようにします。
    オプション 2: Sites.Selected アプリケーション コネクタがサイト コレクションのサブセットにアクセスできるようにします。特定のサイト コレクションと付与された権限は、SharePoint Online で構成できます。

    連携検索またはデータの取り込みのいずれかの接続モードで [アクション] を有効にする場合は、次の権限も選択します。

    権限 タイプ 説明
    Sites.ReadWrite.All 委任 ログインしているユーザーに代わって、コネクタがすべてのサイト コレクションのドキュメントとリストアイテムを編集または削除できるようにします。
    Files.ReadWrite 委任 コネクタがログイン ユーザーのファイルの読み取り、作成、更新、削除を行えるようにします。
    Files.ReadWrite.All 委任 ログインしているユーザーがアクセスできるすべてのファイルをコネクタが読み取り、作成、更新、削除できるようにします。
    Sites.Manage.All 委任 ユーザーに代わって、コネクタがすべてのサイト コレクションでドキュメント ライブラリとリストを作成または削除できるようにします。

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

  7. [Request API permissions] ペインで、[Microsoft SharePoint] を選択します。

  8. 接続モードに基づいて、次の権限を検索して選択します。

    連携検索接続モードの場合:

    権限 タイプ 説明
    Sites.Search.All 委任 現在ログインしているユーザーに代わって、コネクタが検索クエリを実行し、サイトの基本情報を読み取れるようにします。検索結果は、アプリの権限ではなくユーザーの権限に基づいています。
    サイト制御オプション
    オプション 1: AllSites.Read 委任 ログインしているユーザーに代わって、コネクタがすべてのサイト コレクションのドキュメントとリストアイテムを読み取れるようにします。
    オプション 2: Sites.Selected 委任 コネクタが、ログインしているユーザーを使用してサイト コレクションのサブセットにアクセスできるようにします。特定のサイト コレクションと付与された権限は、SharePoint Online で構成できます。

    フェデレーション認証情報を使用するデータ取り込み接続モードの場合:

    権限 タイプ 説明
    サイト制御オプション
    オプション 1: Sites.FullControl.All アプリケーション コネクタがすべてのサイト コレクションを完全に制御できるようにします。
    オプション 2: Sites.Selected アプリケーション コネクタが、ログインしているユーザーを使用してサイト コレクションのサブセットにアクセスできるようにします。特定のサイト コレクションと付与された権限は、SharePoint Online で構成できます。

    OAuth 2.0 更新トークンを使用するデータ取り込み接続モードの場合:

    権限 タイプ 説明
    サイト制御オプション
    オプション 1: AllSites.FullControl 委任 ログインしているユーザーに代わって、コネクタがすべてのサイト コレクションを完全に制御できるようにします。
    オプション 2: Sites.Selected 委任 コネクタが、ログインしているユーザーを使用してサイト コレクションのサブセットにアクセスできるようにします。特定のサイト コレクションと付与された権限は、SharePoint Online で構成できます。

    連携検索またはデータの取り込みのいずれかの接続モードで [アクション] を有効にする場合は、次の権限も選択します。

    権限 タイプ 説明
    AllSites.Write 委任 ログインしているユーザーに代わって、コネクタがすべてのサイト コレクションのドキュメントとリストアイテムの作成、読み取り、更新、削除を行えるようにします。

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