部署 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. 在打开的警告页面中，点击我了解此风险和添加例外。该页面显示了一条消息，如“This Connection is untrusted”（此连接不受信任）因为证书是自签名证书，而不是由受信任的证书授权机构签名。

3. 看到 View 按钮后，点击该按钮。

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 同步用户和群组后，要同步 Share for the Share 网站集群组，请运行 Share for On-Prem 身份连接器。最后，运行 SharePoing On-Prem 连接器，为您的 Cloud Search 用户编制索引并提供结果。

数据源访问权限

Share for On Premises Access

网站集索引编制

SharePoint 身份映射

Active Directory 查询

HTML 内容生成