部署 Microsoft SharePoint On-Prem 连接器

Microsoft Outlook 消息处理

在编入内容索引时，如果连接器遇到 Microsoft Outlook .msg 文件，则会替换此类文件的媒体类型，并以 application/vnd.ms-outlook. 形式将此类文件编入索引

多租户配置

如果您的 SharePoint 是多租户部署，其中多个客户网站托管在同一 Web 应用上，则需要在配置文件中配置网站集模式。在多租户部署中，您只能获得对自己网站集的权限，无法获得 SharePoint On-Prem 连接器所需的完全读取权限。

如需启用网站集模式，请执行以下操作：

• 向连接器用户账号授予网站集管理员权限。
• 将连接器配置文件中的 sharepoint.server 设置为网站集网址，例如 http://sharepoint.example.com/sites/sitecollection。网址的大小写形式不必与 SharePoint 上完全相同。
• 将连接器配置文件中的 sharepoint.siteCollectionOnly 设置为 true。

如果要在多租户环境中将多个网站集编入索引，则需要为每个网站集配置一个连接器实例。

已知的连接器限制

• 连接器检测数据库中项更改所需的时间会随着连接器监控的数据库数量而增加。
• 内存消耗会随着您在每个网站集的 ACL 中使用的唯一身份用户和群组的数量而增加。
• 您只能使用来自一个 Active Directory 网域的身份配置连接器。
• 不支持某些常见的 Active Directory 和 Windows 正文，例如 Everyone、BUILTIN\Users 和 All Authenticated Users。
• 删除通知并非即时发送，连接器可能需要超过 4 小时才能识别出用户从源代码库中删除了内容。

系统要求

部署连接器

前提条件

第 2 步：创建 SharePoint On-Prem 连接器配置文件

第 3 步：对于 HTTPS，请将 SharePoint 添加为可信主机

如果 SharePoint 配置为使用 HTTPS，请获取 SharePoint 证书，将其添加为连接器的可信主机。

1. 在将运行连接器的计算机上，打开浏览器并前往 SharePoint。

2. 在随即打开的警告页面中，点击我了解此风险和添加例外。该页面会显示“此连接不受信任”等消息，因为该证书采用自签名，而非由受信任的证书授权机构签名。

3. 查看按钮可用后，点击该按钮。

4. 前往详细信息标签页，然后点击导出。

5. 将证书保存在连接器目录中，名称设为 sharepoint.crt。

6. 依次点击关闭和取消以关闭窗口。

7. 打开命令提示符，然后输入以下命令：

   $ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

   当看到“是否信任此证书？”的提示时，输入 yes。

第 4 步：设置日志记录

1. 在包含连接器二进制文件的目录中，创建一个名为 logs 的文件夹。

2. 在同一目录（非 logs）中，创建一个名为 logging.properties 的 Latin1 编码文件。

3. 将以下文本添加到 logging.properties 中：

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = INFO
   # uncomment line below to increase logging level for SharePoint APIsa
   #com.google.enterprise.cloudsearch.sharepoint.level=FINE
   
   # uncomment line below to increase logging level to enable API trace
   #com.google.api.client.http.level = FINE
   java.util.logging.ConsoleHandler.level = INFO
   java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log
   java.util.logging.FileHandler.limit=10485760
   java.util.logging.FileHandler.count=10
   java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
   

第 5 步：配置 SharePoint On-Prem 身份连接器

必须执行此步骤，才能将基于身份的 SharePoint On-Prem ACL 应用于搜索结果。如果您使用公共 ACL 设置了连接器，则可以跳过此步骤。

1. 在 SharePoint Online 连接器安装目录中，创建一个文件并将其命名为 sharepoint-onprem-identity-connector.config。

2. 将参数作为键值对添加到文件内容中，如以下示例所示：

   ### SharePoint On-prem identity connector configuration ###
   
   # Required parameters for data source access
   api.customerId=C05d3djk8
   api.serviceAccountPrivateKeyFile=service_account.json
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   
   # Required parameters for SharePoint access
   sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
   sharepoint.siteCollectionOnly=true
   sharepoint.username=contoso\\admin
   sharepoint.password=pa$sw0rd
   sharepoint.stripDomainInUserPrincipals=true
   
   # Required parameters for AD lookup
   adLookup.host=dc.contoso.com
   adLookup.username=contoso\\admin
   adLookup.password=pa$sw0rd
   api.referenceIdentitySources=CONTOSO,contoso
   api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
   api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
   

   这些值与 SharePoint On-Prem 连接器的值几乎相同，但参数为 api.customerId，而不是 api.sourceId。api.customerId 的值是您从 Google Workspace 管理员处获取的客户 ID。

第 6 步：启动 SharePoint On-Prem 连接器

在以下步骤中，您将本地 Active Directory 和 SharePoint 网站集中的主账号映射到 Cloud Identity 服务中的身份。此同步由 Google Cloud Directory Sync (GCDS) 和 SharePoint On-Prem 身份连接器完成。

在 GCDS 同步用户和群组后，如需同步 SharePoint 网站集群组，请运行 SharePoint On-Prem 身份连接器。最后，运行 SharePoing On-Prem 连接器以编制索引并向 Cloud Search 用户提供结果。

数据源访问权限

SharePoint 本地访问

网站集索引编制

SharePoint 身份映射

Active Directory 查询

HTML 内容生成