Microsoft OneDrive の構成

このページでは、OneDrive データストアを作成する前にサードパーティの構成を設定する方法について説明します。

認証と権限を設定する

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

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

Gemini Enterprise でコネクタを作成する前に、Microsoft OneDrive への安全なアクセスを有効にするように 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/default_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. [構成] をクリックします。

データの取り込み用の連携認証情報を追加する

接続モードとして [データの取り込み] を使用し、認証方法として [連携認証情報] を使用する場合は、次の操作を行います。

  1. アプリのナビゲーション メニューで、[Certificates & secrets] をクリックします。
  2. [連携認証情報] タブを選択します。
  3. [認証情報を追加] をクリックします。
  4. [連携認証情報のシナリオ] リストから [その他の発行元] を選択します。
  5. [Issuer] フィールドに「https://accounts.google.com」と入力します。
  6. [サブジェクト ID] フィールドに、 Google Cloud コンソールから取得した値を入力します。この値は、データ セクションの Microsoft OneDrive データストアの作成時に生成されます。
  7. [名前] フィールドに、連携認証情報の一意のラベルを入力します。
  8. [追加] をクリックしてアクセス権を付与します。

OAuth 2.0 構成を作成する

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

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

  1. クライアント ID を取得するには、次の操作を行います。

    1. アプリのナビゲーション メニューで、[Overview] を選択します。
    2. アプリケーション(クライアント)ID をコピーします。
  2. アプリのクライアント シークレットを取得するには、次の操作を行います。

    1. アプリのナビゲーション メニューで、[Certificates & secrets] を選択します。
    2. [New client secret] をクリックします。
    3. クライアント シークレット ペインで、次の操作を行います。
      1. [Description] フィールドに、スナップショットの説明を入力します。
      2. [Expires] リストで、有効期限を選択します。
      3. [追加] をクリックします。
    4. [Value] 列からクライアント シークレットをコピーします。

テナント ID を取得する

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

Microsoft API 権限を構成する

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

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

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

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

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

接続モード 型 スコープ 目的
連携検索 委任 Files.Read.All ユーザーがアクセスできるすべてのファイルをデータストアが読み取れるようにします。
委任 Sites.Read.All ユーザーがアクセスできるすべてのサイト コレクション内のドキュメントとリストアイテムをデータストアが読み取れるようにします。
委任 User.Read.All データストアがコンテンツ検出のためにユーザーのドライブの場所を解決できるようにします。
データの取り込み アプリケーション Files.Read.All ログインしているユーザーがいない組織全体のファイルをデータストアが読み取り、同期できるようにします。
アプリケーション Group.Read.All データストアがすべてのグループのプロパティとメンバーシップを読み取れるようにします。
アプリケーション GroupMember.Read.All データストアがすべてのグループのメンバーシップを読み取り、アクセス制御(ACL)の同期を管理できるようにします。
委任 User.Read データストアがログイン ユーザーのプロファイルと基本的な会社情報を読み取れるようにします。
アプリケーション Sites.FullControl.All すべてのサイト コレクションを完全に制御できるようにします。
アプリケーション Sites.Selected サイト コレクションの特定のサブセットへのアクセスを許可します。
連携認証情報のみ User.Read.All データストアがユーザー プロファイルを読み取れるようにします。
委任 User.ReadBasic.All 組織内のユーザーの基本的なプロファイル プロパティを読み取れるようにします。
アクション 委任 Files.ReadWrite.AppFolder Microsoft OneDrive フォルダ内のファイルをデータストアが読み取り、作成、更新、削除できるようにします。
委任 Files.ReadWrite ユーザーがアクセスできるファイルの読み取り、ダウンロード、作成、アップロード、更新、削除をデータストアに許可します。
委任 Files.ReadWrite.All ユーザーがアクセスできるすべてのドライブのファイルをデータストアが読み取り、更新できるようにします。ユーザー自身の Microsoft OneDrive 以外のドライブに保存されているファイルに対して、ファイルとフォルダの変更アクション(コピー、移動、名前変更、共有、プロパティの更新)を実行するために必要です。
  1. [Add Permissions] をクリックします。
  2. 管理者の同意を付与します。同意を付与する方法については、Microsoft Entra ID のドキュメントのアプリケーションに対してテナント全体の管理者の同意を付与するをご覧ください。

トラブルシューティング

このセクションでは、Microsoft OneDrive コネクタに関する一般的な問題の解決方法について説明します。

接続時に「管理者の承認が必要」と表示される

ユーザーが Gemini Enterprise ウェブアプリから Microsoft OneDrive に初めて接続するときに、Microsoft に [管理者の承認が必要] 画面が表示されることがあります。これは、Gemini Enterprise が管理者レベルの権限をリクエストした場合、または Microsoft Entra テナントで、テナント全体の管理者の同意なしにユーザーがサードパーティ製アプリを承認することを禁止している場合に発生します。

この問題を解決するには、管理者が最初の承認を完了する必要があります。その後、テナント内の他のユーザーは、承認画面なしで接続できます。

  1. テナント全体の同意を付与できる Microsoft Entra ID 管理者に、Gemini Enterprise ウェブアプリにログインして Microsoft OneDrive に接続するよう依頼します。

  2. 権限画面で、管理者が [Consent on behalf of your organization] を選択し、[Accept] をクリックします。

  3. もう一度接続するようお客様に伝えます。

詳細については、Microsoft Entra のドキュメントのテナント全体の管理者の同意を付与するをご覧ください。