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，然后选择应用注册。
  3. 在应用注册页面上，点击 新注册。

  4. 在注册应用页面上，执行以下操作：

    1. 在名称字段中，输入应用的名称。
    2. 在支持的账号类型部分，选择仅此组织目录中的账号。
    3. 在重定向 URI 部分中，执行以下操作：
      1. 在平台列表中，选择 Web。
      2. 在重定向 URI 字段中，输入 https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html。
    4. 点击注册。 Microsoft Entra 会创建您的应用，并显示应用的概览页面。

  5. 在应用导航菜单中，点击身份验证。

  6. 点击 添加重定向 URI。

  7. 在平台选择窗格中，执行以下操作：

    1. 选择网页。
    2. 在重定向 URI 字段中，输入 https://vertexaisearch.cloud.google.com/oauth-redirect。
    3. 点击配置。

创建 OAuth 2.0 配置

如需使用 OAuth 2.0 身份验证方法创建连接，您需要从 Microsoft Entra 应用注册页面获取客户端 ID、客户端密钥和租户 ID。

获取客户端 ID 和客户端密钥

  1. 如需获取应用的客户端 ID 和密钥，请执行以下操作：

    1. 前往应用页面。
    2. 在应用导航菜单中，选择证书和密钥。
    3. 点击 New client secret（新建客户端密钥）。
    4. 在客户端密钥窗格中，执行以下操作：
      1. 在说明字段中，输入相应密钥的说明。
      2. 在过期列表中，选择过期时长。
      3. 点击 Add（添加）。
    5. 复制值列 (Client Secret) 中显示的密钥和密钥 ID 列 (Client ID) 中的标识符，并安全地存储这两项信息以备后用。

获取实例 URI

实例 URI 采用以下格式之一：

  • 对于所有第一级网站：https://DOMAIN_OR_SERVER.sharepoint.com，例如 mydomain.sharepoint.com。
  • 对于单个网站：https://DOMAIN_OR_SERVER.sharepoint.com/sites/WEBSITE，例如 mydomain.sharepoint.com/sites/sample-site。

获取租户 ID

您可以在 Microsoft Entra 管理中心的概览页面上的租户 ID 框中找到您的租户 ID。

配置 Microsoft API 权限

如需为应用配置所需的 API 权限，请执行以下操作：

  1. 前往应用页面。

  2. 在应用导航菜单中，选择 API 权限。

  3. 点击 添加权限。

  4. 在请求 API 权限窗格中，选择 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. 点击添加权限。

  7. 在请求 API 权限窗格中，选择 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. 点击添加权限。