部署 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 On-Prem 連接器

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

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

資料來源存取權

SharePoint 內部部署存取

網站集合索引

SharePoint 識別資訊對應

Active Directory 查詢

HTML 內容產生