ファイル選択ツールの認証を構成する

Gemini Enterprise アシスタントとチャットする際に、ユーザーはファイル選択ツールを使用してファイルを添付できます。このアシスタントは、ローカル ファイル、Google ドライブのファイル、Microsoft OneDrive のファイルの 3 つのファイルソースをサポートしています。このページでは、管理者がこの動作を構成する方法について説明します。

エンドユーザーが Google ドライブと OneDrive からファイルを選択できるようにするには、Google ドライブ データストアと OneDrive データストアの構成時に設定したデータストア構成を再利用して、エンドユーザーのログイン方法を制御します。これにより、次の項目を管理できます。

  • 選択ツールが使用するログインアプリ。ピッカーは、デフォルトの Google 管理アプリケーションではなく、コネクタで構成した Microsoft Entra(旧 Azure AD)または Google アプリケーションを再利用できます。
  • OneDrive の選択ツールで使用する Microsoft Entra テナント。OneDrive ピッカーは、特定の Microsoft Entra テナントに対してユーザーをログインさせることができます。

ファイルを添付してチャットするエンドユーザー エクスペリエンスについては、ファイルをアップロードしてチャットするをご覧ください。

ファイル選択ツールの仕組み

Google ドライブと OneDrive のデータストアでファイル選択ツールに同じ認証構成を使用するように構成した場合、ファイル選択ツールは同じ設定を使用してユーザーを認証します。次の表に、2 つのコントロールと、それらが影響する選択ツールの概要を示します。

管理 機能 対象
カスタム ログインアプリ ユーザーがファイル選択ツールを使用してアシスタントにファイルを添付する際にユーザーを認証するために、Gemini Enterprise は、デフォルトの Google 管理アプリケーションではなく、データストアの既存の Microsoft Entra ID または Google Identity 構成を使用できます。 Google ドライブと OneDrive
テナントの適用 OneDrive の選択ツールでは、ユーザーは共有ログイン エンドポイント(/common/)ではなく、特定の Microsoft Entra テナント(https://login.microsoftonline.com/{your-tenant}/...)に対してログインする必要があります。これにより、他のテナントのユーザーは認証できなくなります。テナントは、接続された OneDrive コネクタから読み取られます。 OneDrive のみ

管理者は、コネクタをアプリに接続してこの動作を構成します。

構成プロバイダを指定すると、次のルールが適用されます。

  • コネクタタイプごとに 1 つのプロバイダ。アプリに接続できる OneDrive 構成プロバイダと Google ドライブ構成プロバイダは、一度に 1 つだけです。同じタイプの 2 番目のコネクタをプロバイダとしてマークすると、invalid-argument エラーで拒否されます。
  • プロバイダは、アクション対応のコネクタである必要があります。構成プロバイダは、アクションまたはフェデレーション アクセスをサポートする OneDrive または Google ドライブ コネクタである必要があります。取り込み専用コネクタは構成プロバイダにできません。詳細については、アクションを管理するをご覧ください。

始める前に

ファイル選択ツールを構成する前に、次のことを確認してください。

  • 管理者権限。ディスカバリー エンジン編集者ロール(roles/discoveryengine.editor)を付与します。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。
    1. Google Cloud コンソールで、[IAM] ページに移動します。

      [IAM] に移動

    2. ユーザー アカウントを見つけて、edit 編集をクリックします。
    3. ユーザーに Discovery Engine Editor ロールを付与します。詳細については、IAM のロールと権限をご覧ください。
  • カスタム OneDrive ログインアプリ。クライアント ID、クライアント シークレット、テナント ID など、管理する Microsoft Entra ID アプリケーションと、テスト用にそのテナント内の OneDrive アカウントがあることを確認します。詳細については、Microsoft Identity Platform にアプリケーションを登録するをご覧ください。
  • 構成済みのデータストア。OneDrive データストアまたは Google ドライブ データストアを構成します。データストアを構成するときに、クライアント ID、クライアント シークレット、OneDrive データストアのテナント ID などの認証設定を構成します。詳細については、次をご覧ください。
  • 接続されたデータストア。OneDrive データストアまたは Google ドライブ データストアを Gemini Enterprise app に接続します。詳細については、データストアをアプリに接続するをご覧ください。

独自のログインアプリを使用する

デフォルトでは、選択ツールは Google が管理するアプリケーションを使用してログインします。1 つのコネクタをピッカーの構成プロバイダとして指定することで、ピッカーで独自の Microsoft Entra ID または Google Identity を使用するように設定できます。

OneDrive または Google ドライブのデータストアがすでに構成されている場合は、次の手順に沿って操作します。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. Google Cloud プロジェクトを選択するか作成します。

  3. ナビゲーション メニューで [データストア] をクリックします。

  4. データストアを検索し、データストアの名前をクリックします。

  5. [パラメータを表示 / 編集] をクリックします。

  6. [Picker Config Provider] オプションを選択します。

  7. [保存] をクリックします。

変更を元に戻して Google 管理のアプリケーションを使用する

ファイル選択ツールの認証にデフォルトの Google 管理アプリケーションを使用するように戻す手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. Google Cloud プロジェクトを選択します。

  3. ナビゲーション メニューで [データストア] をクリックします。

  4. データストアの名前をクリックします。

  5. [パラメータを表示 / 編集] をクリックします。

  6. [Picker Config Provider] フィールドをクリアします。

  7. [保存] をクリックします。

エンドユーザー エクスペリエンス

選択ツールを構成すると、エンドユーザーは次の操作を行うことができます。

  • OneDrive の場合、ユーザーは組織の Microsoft テナントにログインするよう求められます。他のテナントのアカウントは拒否されます。
  • ログインには、構成したアプリケーション(デフォルトでは Google が管理するアプリケーション、構成プロバイダを設定した場合は独自のアプリケーション)が使用されます。
  • 最初のログインに成功すると、その後のファイル選択のために接続が記憶されます。

エンドユーザー エクスペリエンスの詳細については、ファイルをアップロードしてチャットするをご覧ください。

トラブルシューティング

症状 考えられる原因 解決策
コネクタを **Picker Config Provider** としてマークすると、Cannot enable picker_config_provider on data connector '...' because another connector in the same engine is already the picker config provider: '...'. An engine can have at most one picker_config_provider connector; disable it on the other connector first. で失敗する 同じエンジン内の別のコネクタがすでに選択ツールの構成プロバイダになっています。エンジンに設定できるのは 1 つだけです。 もう一方のコネクタの [**Picker Config Provider**] パラメータをクリアしてから、もう一度お試しください。
OneDrive へのログインが AADSTS50020: User account 'user@domain.com' from identity provider '...' does not exist in tenant '...' で失敗する ユーザーのアカウントが、コネクタで構成されているテナントとは異なる Microsoft Entra テナントにある。テナント固有のログイン エンドポイントがアカウントを拒否します。 テナントの適用は想定どおりに機能します。構成済みのテナントのアカウントでユーザーにログインしてもらうか、コネクタのテナント ID を更新します。
OneDrive は引き続き共有ログイン エンドポイントをプロンプトします。 テナントがまだ構成されていないか、変更が反映されていません。 コネクタのテナント ID を確認します。構成の変更が有効になるまでには、最長で 3 分ほどかかることがあります。しばらく待ってから再試行してください。

次のステップ