部署 Microsoft SharePoint On-Prem 连接器

Microsoft Outlook 邮件处理

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

多租户配置

如果您的 SharePoint 是多租户部署（多个客户网站托管在同一 Web 应用中），则您需要在配置文件中配置网站集模式。在多租户部署中，您仅获得网站集的权限，无法按照 SharePoint On-Prem 连接器的要求获得完全读取权限。

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

• 向连接器用户帐号授予 Site collection Administrator 权限。
• 将连接器配置文件中的 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 步：创建 Share On-Prem 连接器配置文件

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

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

1. 在运行连接器的计算机上，打开浏览器并转到 Share。

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. 在安装 Share 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.sourceId，而是 api.customerId。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 内容生成