部署 Microsoft SharePoint On-Prem 連接器

Microsoft Outlook 郵件處理

連接器在建立索引內容時遇到 Microsoft Outlook .msg 檔案時，會覆寫檔案媒體類型，並將其索引為 application/vnd.ms-outlook.。

多用戶群設定

如果您的 SharePoint 採用多用戶部署模式，可讓多個客戶網站透過同一個網頁應用程式代管，您就必須在設定檔中設定網站收集模式。在多用戶群部署中，您只會取得網站集合的權限，無法取得 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 憑證，以便將 SharePoint 憑證新增為連接器的信任主機。

1. 在要執行連接器的電腦上，開啟瀏覽器並前往 SharePoint。

2. 在隨即開啟的警告頁面中，依序點選「IUnderstanding the Risks」和「Add Exception」。這個頁面會顯示類似「This Connection is 不信任」的訊息，因為憑證是自行簽署，而非由信任的憑證授權單位簽署。

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.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 內容