部署 Microsoft SharePoint On-Prem 連接器

Microsoft Outlook 訊息處理

當連接器在編入內容時遇到 Microsoft Outlook .msg 檔案，就會覆寫檔案的媒體類型，並將檔案編入索引為 application/vnd.ms-outlook.

多租戶設定

如果 SharePoint 是多租戶部署，也就是在同一個網頁應用程式中代管多個客戶網站，則需要在設定檔中設定網站集合模式。在多租戶部署中，您只能取得網站集合的權限，無法取得 SharePoint 地端部署連接器所需的完全讀取權限。

如要啟用網站收集模式，請按照下列步驟操作：

• 將網站集合管理員權限授予連接器使用者帳戶。
• 將連接器設定檔中的 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 地端部署連接器設定檔

步驟 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

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

步驟 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 地端部署識別資訊連接器

您必須執行這個步驟，才能將 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 內部連接器的值相同，但參數是 api.customerId，而非 api.sourceId。api.customerId 的值是您從 Google Workspace 管理員取得的客戶 ID。

步驟 6：啟動 SharePoint 地端部署連接器

在下列步驟中，您會將內部部署 Active Directory 和 SharePoint 網站集合中的使用者主體，對應至 Cloud Identity 服務中的身分識別資訊。這項同步作業會透過 Google Cloud Directory Sync (GCDS) 和 SharePoint 地端識別資訊連接器完成。

GCDS 同步處理使用者和群組後，請執行 SharePoint On-Prem 身分連接器，以便同步處理 SharePoint 網站集合群組。最後，請執行 SharePoing 內部部署連接器，為 Cloud Search 使用者建立索引並提供結果。

資料來源存取權

SharePoint 內部部署存取

網站集合索引

SharePoint 識別資訊對應

Active Directory 查詢

HTML 內容產生