本页面介绍了如何在创建 Microsoft 365 数据存储区之前设置第三方应用。
设置身份验证和权限
Microsoft 365 连接器使用 OAuth 2.0 授权代码流程,以最终用户身份登录 Microsoft Identity Platform。所有 Microsoft Graph 权限均已委派,因此连接器只能访问已登录用户可以访问的数据。您可以通过以下两种方式之一配置身份验证:
- Google管理的 OAuth(OAuth 2.0 [Google 管理],默认):连接器使用Google 注册和管理的多租户 Microsoft Entra 应用。您无需注册应用,也无需输入租户 ID、客户端 ID 或客户端密钥。请参阅使用 Google管理的 OAuth。
- 自带应用 (OAuth 2.0 (Bring Your Own App)):您注册自己的 Microsoft Entra 应用,向其授予您计划启用的操作所需的 Microsoft Graph 权限,并在 Gemini Enterprise 中输入其租户 ID、客户端 ID 和客户端密钥。如果贵组织需要直接控制应用及其权限、需要静态 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 环境类型设置为标准。对于 GCC High 或 DoD 中的租户,请使用 OAuth 2.0(自带应用)。
- 静态 IP 出站流量不可用,因为共享应用无法携带每个客户的 IP 许可清单。
本部分的其余内容仅适用于 OAuth 2.0(自带应用)。
为 Microsoft 365 连接器注册 Microsoft Entra 应用
如需在 Microsoft Entra 中将 Gemini Enterprise 注册为 OAuth 2.0 应用,请执行以下操作:
在导航菜单中,展开 Entra ID,然后选择应用注册。
在应用注册页面上,选择新注册。
在注册应用页面上,执行以下操作:
- 在名称字段中,为应用输入名称。
- 在支持的账号类型部分,选择仅此组织目录中的账号。
- 在重定向 URI 部分,执行以下操作:
- 在平台列表中,选择 Web。
- 在重定向 URI 字段中,输入
https://vertexaisearch.cloud.google.com/oauth-redirect。
- 点击注册。 Microsoft Entra 会创建您的应用并显示应用的概览页面。
获取客户端 ID 和客户端密钥
如需获取客户端 ID,请执行以下操作:
- 在应用导航菜单中,选择概览。
- 复制 Application (client) ID(应用 [客户端] ID)。
如需获取应用的客户端密钥,请执行以下操作:
- 在应用导航菜单中,选择证书和密钥。
- 点击 新建客户端密钥。
- 在客户端密钥窗格中,执行以下操作:
- 在说明字段中,输入密钥的说明。
- 在失效列表中,选择失效时长。
- 点击 Add(添加)。
- 从值列中复制客户端密钥。
获取租户 ID
您可以在 Microsoft Entra 管理中心的概览页面上的租户 ID 框中找到您的租户 ID。
配置 Microsoft API 权限
如果您使用 OAuth 2.0(自带应用),请为您的应用授予委托的 Microsoft Graph 权限,以便执行您计划启用的操作。如果您使用 OAuth 2.0(Google 管理),则无需自行添加这些权限;用户在授权连接器时,系统会要求他们同意这些权限。
每项操作所需的权限列在支持的操作表的所需权限列中。每个连接还需要 User.Read 和 offline_access。
如需在您自己的应用中配置所需的 API 权限,请执行以下操作:
在应用页面上,选择 API 权限。
点击添加权限。
在请求 API 权限页面上,选择 Microsoft Graph,然后选择委托权限。
搜索并选择
User.Read、offline_access以及您计划启用的每项操作所列出的权限。点击添加权限。
主权云和政府云
如果您的租户不在标准 Microsoft 云中,请在创建数据存储区时设置以下两项。通过美国政府登录需要 OAuth 2.0(自带应用),并且应用已在该云中注册。
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(自带应用),还需检查您的 Microsoft Entra 应用注册是否授予了该权限。现有刷新令牌仅包含在颁发时已获同意的范围。
邮件搜索返回 MailboxNotEnabledForRESTAPI
此错误表示无法通过 Microsoft Graph 访问邮箱。 当邮箱在混合 Exchange 部署中托管在本地、邮箱处于非活跃状态或被软删除,或者租户或目录不匹配时,就会发生这种情况。如需解决此问题,请确保邮箱托管在 Exchange Online 中。如需了解详情,请参阅 Microsoft 文档中的如何修复 MailboxNotEnabledForRESTAPI。