このページでは、Microsoft 365 データストアを作成する前にサードパーティ アプリケーションを設定する方法について説明します。
認証と権限を設定する
Microsoft 365 コネクタは、Microsoft Identity Platform に対して OAuth 2.0 認可コードフローを使用してエンドユーザーとしてログインします。すべての Microsoft Graph 権限が委任されるため、コネクタはログインしているユーザーがすでにアクセスできるデータにのみアクセスできます。認証は次の 2 つの方法のいずれかで構成できます。
- Google管理の OAuth(OAuth 2.0(Google 管理)、デフォルト): コネクタは、Google が登録して管理するマルチテナント Microsoft Entra アプリケーションを使用します。アプリケーションを登録したり、テナント ID、クライアント ID、クライアント シークレットを入力したりする必要はありません。 Google管理の OAuth を使用するをご覧ください。
- 独自のアプリを使用する(OAuth 2.0(独自のアプリを使用する)): 独自の Microsoft Entra アプリケーションを登録し、有効にするアクションの Microsoft Graph 権限を付与して、そのテナント ID、クライアント ID、クライアント シークレットを Gemini Enterprise に入力します。組織でアプリケーションとその権限を直接制御する必要がある場合、静的 IP 下り(外向き)が必要な場合、またはテナントが米国政府のクラウドにある場合は、このオプションを選択します。Microsoft Entra アプリを登録するをご覧ください。
Googleが管理する OAuth を使用する
OAuth 2.0(Google 管理)を使用する場合、データストアを作成する前に Microsoft Entra で何も作成しません。ユーザーがコネクタを承認すると、Microsoft は、有効なアクションに必要な Microsoft Graph 権限に同意するようユーザーに求めます。完全なリストについては、Microsoft API 権限を構成するをご覧ください。
これらの権限の一部と、一部のテナント同意ポリシーでは、Microsoft Entra 管理者が組織に代わって同意する必要があります。ユーザーがコネクタを承認するときに「管理者の承認が必要」というメッセージが表示された場合は、管理者が Google管理アプリケーションにテナント全体の同意を付与する必要があります。詳細については、Microsoft のドキュメントのテナント全体の管理者の同意をアプリケーションに付与するをご覧ください。
Googleが管理する OAuth を使用する場合は、次の点に注意してください。
- Googleが管理するアプリケーションは商用の Microsoft クラウドに登録されているため、[Microsoft 365 Environment Type] は [Standard] のままにします。GCC High または DoD のテナントの場合は、OAuth 2.0(独自のアプリを使用)を使用します。
- 共有アプリケーションは顧客ごとの IP 許可リストを保持できないため、静的 IP 下り(外向き)は使用できません。
このセクションの残りの部分は、OAuth 2.0(独自のアプリを使用)にのみ適用されます。
Microsoft 365 コネクタ用の Microsoft Entra アプリを登録する
Microsoft Entra で Gemini Enterprise を OAuth 2.0 アプリケーションとして登録する手順は次のとおりです。
Microsoft Entra 管理センターに移動します。
ナビゲーション メニューで [Entra ID] を展開し、[App registrations] を選択します。
[App registrations] ページで、[New registration] を選択します。
[Register an application] ページで、次の操作を行います。
- [Name] フィールドに、ネットワークの名前を入力します。
- [Supported account types] セクションで、[Accounts in this organizational directory only] を選択します。
- [Redirect URI] セクションで、次の操作を行います。
- プラットフォーム リストで、[ウェブ] を選択します。
- [Redirect URI] フィールドに「
https://vertexaisearch.cloud.google.com/oauth-redirect」と入力します。
- [Register] をクリックします。Microsoft Entra によってアプリが作成され、アプリの概要ページが表示されます。
クライアント ID とクライアント シークレットを取得する
クライアント ID を取得するには、次の操作を行います。
- アプリのナビゲーション メニューで、[Overview] を選択します。
- アプリケーション(クライアント)ID をコピーします。
アプリのクライアント シークレットを取得するには、次の操作を行います。
- アプリのナビゲーション メニューで、[Certificates & secrets] を選択します。
- [新しいクライアント シークレット] をクリックします。
- クライアント シークレット ペインで、次の操作を行います。
- [Description] フィールドに、スナップショットの説明を入力します。
- [Expires] リストで、有効期限を選択します。
- [追加] をクリックします。
- [Value] 列からクライアント シークレットをコピーします。
テナント ID を取得する
テナント ID は、Microsoft Entra 管理センターの概要ページの [Tenant ID] ボックスにあります。
Microsoft API 権限を構成する
OAuth 2.0(Bring Your Own App)を使用する場合は、有効にするアクションに対して委任された Microsoft Graph 権限をアプリに付与します。OAuth 2.0(Google 管理)を使用する場合、これらの権限を自分で追加する必要はありません。ユーザーがコネクタを承認する際に、これらの権限に同意するよう求められます。
各アクションに必要な権限は、サポートされているアクションの表の [必要な権限] 列に記載されています。すべての接続には User.Read と offline_access も必要です。
独自のアプリに必要な API 権限を構成するには、次の操作を行います。
アプリページで、[API permissions] を選択します。
[Add a Permission] をクリックします。
[Request API permissions] ページで、[Microsoft Graph] を選択し、[Delegated permissions] を選択します。
User.Read、offline_access、および有効にする各アクションにリストされている権限を検索して選択します。[権限を追加] をクリックします。
ソブリン クラウドとガバメント クラウド
テナントが標準の Microsoft クラウドにない場合は、データストアの作成時に次の両方を設定します。米国政府経由でログインするには、OAuth 2.0(Bring Your Own App)が必要です。アプリはそのクラウドに登録されている必要があります。
[Microsoft 365 環境タイプ]([認証設定] セクション)で、ログイン エンドポイントを選択します。[標準] では
login.microsoftonline.comが使用され、[米国政府] ではlogin.microsoftonline.usが使用されます。Microsoft 365 クラウド環境: [詳細オプション] セクションで、Microsoft Graph エンドポイントを選択します。[標準 / GCC] では
https://graph.microsoft.com、[GCC High] ではhttps://graph.microsoft.us、[DoD] ではhttps://dod-graph.microsoft.usが使用されます。
トラブルシューティング
このセクションでは、Microsoft Entra アプリケーションの構成後に表示される可能性のあるエラーとその解決方法について説明します。
アクションが HTTP 403 で失敗する
HTTP 403 を返すアクションには、通常、権限がありません。アクションに必要な権限が同意されていること、必要な場合は管理者の同意が付与されていること、アクションが有効になった後に接続が再承認されていることを確認します。OAuth 2.0(Bring Your Own App)を使用している場合は、Microsoft Entra アプリの登録で権限が付与されていることも確認します。既存の更新トークンには、発行時に同意されたスコープのみが含まれます。
メール検索で MailboxNotEnabledForRESTAPI が返される
このエラーは、Microsoft Graph を介してメールボックスにアクセスできないことを意味します。このエラーは、ハイブリッド Exchange デプロイでメールボックスがオンプレミスでホストされている場合、メールボックスが非アクティブまたは削除済み(復元可能)の場合、テナントまたはディレクトリが一致しない場合に発生します。この問題を解決するには、メールボックスが Exchange Online でホストされていることを確認します。詳細については、Microsoft のドキュメントの MailboxNotEnabledForRESTAPI の修正方法をご覧ください。