部署 Microsoft SharePoint Online 連接器

重要事項

適用的 SharePoint 設定

Cloud Search SharePoint Online 連接器一律會遵循 SharePoint 的「Search Visibility」設定，無法覆寫。對於草稿文件，連接器用來存取 SharePoint Online 的使用者帳戶權限，會控制哪些草稿文件會建立索引並傳回。如果帳戶只有「完全讀取」權限，連接器會遵循 SharePoint 中的「草稿項目顯示設定」。

您也可以設定連接器，根據使用者帳戶存取權限制結果。如要針對 SharePoint 內容套用安全性調整，您需要將下列外部身分與 Google 目錄同步處理：

• Office 365 / Azure AD 使用者
• Office 365 / Azure AD 安全性群組
• SharePoint 群組 (成員為 Office 365 使用者和群組)

搜尋最佳化

您可以設定連接器，傳回更相關的搜尋結果，進而改善使用者體驗。

如要使用這個 API，請在 SharePoint Online 連接器設定檔中，設定 HTML 產生參數值。這些參數可讓您設定哪些欄位對比對結果的影響較大或較小。

系統需求

部署連接器

必要條件

步驟 2：建立 SharePoint Online 連接器設定檔

步驟 4：設定 SharePoint Online 身分識別連接器

您必須執行這個步驟，才能將 SharePoint Online 以身分為準的 ACL 套用至搜尋結果。如果您使用公開 ACL 設定連接器，可以略過這個步驟。

1. 在與 SharePoint Online 連接器安裝相同的目錄中建立新檔案，並命名為 sharepoint-online-identity-connector.config。

2. 將參數做為鍵/值組合新增至檔案內容，如以下範例所示：

   ### SharePoint Online identity connector configuration ###
   # Required parameters for data source access
   api.customerId=C05d3djk8
   api.serviceAccountPrivateKeyFile=service_account.json
   
   # Required parameters for SharePoint Online access
   sharepoint.server=https://mydomain.onmicrosoft.com
   sharepoint.siteCollectionOnly=true
   sharepoint.username=admin@mydomain.onmicrosoft.com
   sharepoint.password=pa$sw0rd
   sharepoint.formsAuthenticationMode=LIVE
   sharepoint.deploymentType=ONLINE
   
   # SharePoint identity mapping parameters
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   api.referenceIdentitySources=defaultIdentitySource
   api.referenceIdentitySource.defaultIdentitySource.id=08ef8becd116faa5d3783f8c5a80e5aa
   

   這些值幾乎與 SharePoint Online 連接器相同，但參數是 api.customerId，而非 api.sourceId。api.customerId 的值是您從 Google Workspace 管理員取得的客戶 ID。

步驟 5：安裝 Office 365 身分識別連接器

您必須執行這個步驟，才能將 SharePoint Online 以身分為準的 ACL 套用至搜尋結果。如果您使用公開 ACL 設定連接器，可以略過這個步驟。

1. 從 GitHub 複製連接器存放區。

   $ git clone https://github.com/google-cloudsearch/office-365-connector.git
   $ cd office-365-connector

2. 請查看所需連接器的版本：

   $ git checkout tags/v1-0.0.3

3. 建構連接器。

   $ mvn package

   如要在建構連接器時略過測試，請執行 mvn package -DskipTests 而非 mvn package。

4. 將連接器 ZIP 檔案複製到本機安裝目錄：

   $ cp target/google-cloudsearch-office-365-connector-v1-0.0.3.zip installation-dir
   $ cd installation-dir
   $ unzip google-cloudsearch-office-365-connector-v1-0.0.3.zip
   $ cd google-cloudsearch-office-365-connector-v1-0.0.3

步驟 6：設定 Office 365 身分連接器並設定記錄功能

步驟 7：啟動 SharePoint Online 連接器

在下列步驟中，您會將 Office 365 和 SharePoint 網站集合中的主體對應至 Cloud Identity 服務中的身分。這項同步作業會使用 Office 365 身分識別連接器和 SharePoint Online 身分識別連接器。

Office 365 連接器同步處理使用者和群組後，請執行 SharePoint Online 身分連接器，同步處理 SharePoint 網站集合群組。接著，請執行 SharePoint Online 連接器，為 Cloud Search 使用者提供索引及提供結果服務。

1. 執行 Office 365 身分識別連接器：

   $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-office-365-connector-v1-0.0.3.jar -Dconfig=o365-identity-connector.config

2. 執行 SharePoint Online 識別資訊連接器：

   $ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-v1-0.0.3.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-online-identity-connector.config

3. 執行 SharePoint Online 連接器：

   $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar -Dconfig=sharepoint-online-connector.config

設定參數參考資料

資料來源存取權

SharePoint Online 存取權

SharePoint 識別資訊對應

HTML 內容產生

Office 365 身分連接器設定