部署 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

   系統提示「信任這個憑證嗎？」時，請回答「是」。

步驟 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 On-Prem 身分識別連接器，同步處理 SharePoint 網站集合群組。最後，執行 SharePoing On-Prem 連接器，為 Cloud Search 使用者建立索引並提供結果。

資料來源存取權

SharePoint 內部部署存取權

網站集合索引

SharePoint 識別資訊對應

Active Directory 查詢

生成 HTML 內容