SharePoint連接器

Day JCR Connector for Microsoft SharePoint 2010和Microsoft SharePoint 2013,4.0版。

本文包含有關Adobe JCR Connector for Microsoft SharePoint 2010和Microsoft SharePoint 2013 4.0版的詳細資訊。

SharePoint連接器支援下列基本功能:

  • 從SharePoint讀取內容和中繼資料。
  • 通過應用本機SharePoint身份驗證和授權,確認訪問內容的SharePoint安全設定
  • 使用Content Finder進行內容整合
  • 使用AEM元件(例如外部資源)來顯示SharePoint影像和視訊
  • 將SharePoint與AEM資產同步化

所有功能都是使用原生SharePoint web services,做為SharePoint內容與服務的介面來實作。

注意

AEM 6.1 Service Pack 2也支援SharePoint Connector。 連接器不再支援虛擬儲存庫裝載,因此無法裝載它。 如果要使用Java API訪問Sharepoint儲存庫,請在項目中使用Sharepoint連接器的JCR儲存庫實施。

SharePoint伺服器和相關IT基礎架構的安裝、配置、管理和IT操作不在本文檔的範圍之內。 有關這些主題的資訊,請參見SharePoint上的供應商文檔。 連接器要求正確安裝、配置和操作基礎架構的這些部分。

開始使用

要開始使用連接器,請執行以下操作:

  • 請確定您至少已安裝Java 7。

  • 從Package Share下載連接器套件散發檔案。

  • 將有效的​license.properties​檔案複製到包含​cq-quickstart-6.4.0.jar​檔案的目錄。

  • 按兩下/點選。jar檔案以啟動AEM,或從命令列啟動它。

  • 從「包管理器」安裝連接器包。

  • 配置連接器選項。

安裝SharePoint連接器

連接器是便於安裝的內容封裝。 使用Package Manager安裝套件,然後設定SharePoint伺服器URL
和其他配置選項。 SharePoint內容可在AEM儲存庫中使用。

安裝要求

連接器需要:

  • Java Runtime Environment 1.7或更新版本
  • 透過網路提供SharePoint Web Services
  • SharePoint伺服器URL
  • CRX和SharePoint資料庫的使用者憑證和權限
  • 支援的平台

SharePoint連接器可從packageshare下載。

支援的平台

連接器支援以下功能:

  • AEM版本:

    • AEM 6.4、6.3
  • Microsoft SharePoint版本:

    • Microsoft Office SharePoint Server(MOSS)2010
    • Microsoft Office SharePoint Server(MOSS)2013
  • 如果您需要支援連接器的自訂部署(OEM、特殊要求、自訂驗證方法),請洽詢您所在地區的Adobe辦公室。

注意

此連接器僅支援Microsoft正式支援的配置。 請參閱MOSS 2010MOSS 2013系統需求。

標準安裝

AEM Package Share可用來散發產品功能、範例和Hotfix。 如需詳細資訊,請參閱封裝共用檔案

若要存取「AEM歡迎」頁面上的「封裝共用」,請點選/按一下「工具」,然後選取「封裝共用」​您需要有效的Adobe ID,其中包含您公司的電子郵件地址。 此外,登入您的帳戶後,請套用「封裝共用」存取權。

與AEM整合

安裝連接器內容包。

  1. 開啟Adobe支援票證以要求連接器功能。

  2. 當套件可供使用時,請下載它,然後開啟AEM例項的Package Manager。

  3. 從軟體包描述頁點選/按一下​Install

  4. 在​安裝軟體包​對話框中,按一下/按一下​安裝

    注意:請確定您是以管理員身分登入。

  5. 安裝軟體包後,點選/按一下​Close

配置SharePoint連接器

安裝SharePoint連接器後,請為連接器配置應用程式和SharePoint層。

設定SharePoint伺服器URL,讓您的SharePoint儲存庫JCR符合規範。 您可以設定額外參數來配置與SharePoint伺服器的連接。 此外,還可使用SharePoint連接器來設定驗證。

配置與SharePoint伺服器的連接

要設定SharePoint伺服器的URL和高級選項,請執行以下步驟:

  1. 導覽至OSGi Management Console:http://localhost:4502/system/console/configMgr
  2. 搜索​Day JCR Connector for Microsoft Sharepoint​捆綁包。
  3. 編輯配置值。
  4. 將SharePoint伺服器URL設為​Workspaces​的值。
  5. 點選/按一下​儲存

chlimage_1-81

「工作區」和「預設工作區名稱」參數:

依預設,連接器會公開單一JCR工作區。 此工作區公開的SharePoint伺服器是透過「Sharepoint伺服器URL」設定參數來設定。

連接器也可以配置為多個工作區。 在這種情況下,每個工作區都與通過工作區公開的各個SharePoint伺服器的URL相關聯。 若要新增工作區,請新增工作區定義至「工作區」參數。 工作區定義具有以下格式:
<name>=其 <url>
<name> 是JCR工作區的名稱,
<url> 是該工作區的SharePoint伺服器URL。

在AEM中,請執行上述設定步驟以外的另一個步驟。 允許列出'com.day.cq.dam.cq-dam-jcr-connectors'組合。

若要允許AEM中的清單組合,請執行下列步驟:

  1. 導覽至OSGi Management Console:http://localhost:4502/system/console/configMgr。

  2. 搜尋「Apache Sling Login Admin Whitelist」服務。

  3. 選擇繞過白名單。

  4. 將'com.day.cq.dam.cq-dam-jcr-connectors'新增至白名單組預設值

  5. 按一下「儲存」。

chlimage_1-82

注意

如果您設定多個工作區,請在「預設工作區名稱」參數中指定預設工作區的名稱。

有關與身份驗證相關的參數的其他資訊,請參見Authentication

驗證Sharepoint設定

配置連接器後,請驗證以下內容:

  • SharePoint伺服器會執行,而Web服務可供連接器例項存取
  • SharePoint使用者憑證是有效的,而且使用者具有必要的SharePoint權限
  • 連接器已正確安裝和配置

配置與SharePoint伺服器的DAM同步

若要將SharePoint Assets與AEM同步,請執行下列步驟:

  1. 導覽至OSGi Management Console:http://localhost:4502/system/console/configMgr
  2. 搜索「預設DAMAssetSynchronization」服務。
  3. 編輯配置值。
  4. 設定有權在SharePoint網站上存取之使用者的使用者名稱和對應密碼。
  5. 按一下「儲存」。

啟用DAM同步服務,預設禁用該服務:

  1. 導覽至「OSGi Web Console元件」:http://localhost:4502/system/console/components
  2. 搜尋「com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService」。
  3. 按一下「啟用」。

或者,您可以配置不同同步週期之間的同步延遲:

  1. 導覽至OSGi Management Console:http://localhost:4502/system/console/configMgr
  2. 搜尋「DAY CQ DAM JCR Connector Asset Synchronization Service」。
  3. 編輯配置值。
  4. 設定同步時段的值(以秒為單位)。
  5. 按一下「儲存」。

配置驗證

Sharepoint包含「經典」和「基於索賠的」驗證方法,這兩種方法都支援以下驗證類型:

  • 基本
  • 表單型

尤其是,下列驗證類型可用:

  • Classic-Basic
  • 傳統型表單
  • 基本索賠
  • 基於索賠表單

AEM JCR Connector for Microsoft SharePoint 2010和Microsoft SharePoint 2013,4.0版。支援基於索賠的驗證(由Microsoft建議),該驗證在以下模式下運行:

  • 基本/NTLM身份驗證:連接器首先嘗試使用基本驗證進行連接。如果不可用,則切換到基於NTLM的身份驗證。
  • 表單式驗證:Sharepoint會根據使用者在登入表單(通常是網頁)中輸入的認證來驗證使用者。該系統為已驗證的請求發出令牌,該令牌包含用於為後續請求重新建立標識的密鑰。

配置基於表單的驗證

前往:http://localhost:4502/system/console/bundles

  1. 按一下OSGI ->配置
  2. 搜尋「Day JCR Connector for Microsoft Sharepoint」
  3. 按一下「編輯設定值」
  4. 將「Sharepoint Connection Factory」的值設為「com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory」
  5. 按一下​保存

配置基本身份驗證(Windows)

  1. 停用Token驗證
  2. 前往http://localhost:4502/system/console/bundles
  3. 按一下「OSGI >設定」。
  4. 搜索​Day JCR Connector for Microsoft Sharepoint
  5. 按一下 Edit the configuration values.
  6. 將「Sharepoint連接工廠」的值設定為com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory
  7. 按一下​「儲存」

只有在AEM和SharePoint上都經過驗證的使用者才能透過連接器存取SharePoint內容。

您也可以使用驗證的連接器擴充功能來建立自訂驗證模組,例如,將AEM使用者的存取權對應至特定SharePoint使用者。 建立與SharePoint使用者對應的AEM使用者(使用者名稱和密碼應相符),以便能夠查看對應至連接器例項的SharePoint內容。

若要在AEM中建立使用者:

  1. 登入http://localhost:9502/with管理員使用者。
  2. 按一下「工具」。
  3. 按一下「安全性」。
  4. 按一下「使用者」。
  5. 按一下​建立用戶
  6. 提供使用者ID(可存取SharePoint的使用者名稱)
  7. 提供對應的密碼
  8. 按一下「綠色勾選」符號以建立使用者

若要在管理員群組中新增使用者:

  1. 前往群組管理
  2. 按一下「a」節點
  3. 按一下「管理員」
  4. 在​Browse​按鈕之前的文字方塊中,輸入上述建立的使用者ID
  5. 按一下「綠色勾選」符號,將使用者新增至管理群組

停用Token驗證

  1. 下載並安裝軟體包basic authzip 從Package Share。

  2. 關閉快速入門。

  3. 開啟檔案​\crx-quickstart\repository\repository.xml

  4. 尋找標籤<LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.

  5. 將標籤<param name="disableTokenAuth" value="true"/>插入步驟4中提及的標籤內。

  6. 儲存並關閉xml檔案。

  7. 重新啟動QuickStart並使用您的認證登入。

支援SharePoint伺服器的不同驗證方法

在其標準版本中,連接器支援標準IIS Windows​驗證(基本)和基於表單的驗證(基於令牌)。 可通過擴展性機制支援其它驗證方法

以下步驟提供有關擴展標準身份驗證的指導,以支援SharePoint伺服器的各種身份驗證方法:

  1. 實作com.day.crx.spi.sharepoint.security.SharepointConnectionFactory以處理您特定驗證程式的用戶端。

  2. SharepointConnectionFactory實作安裝為帶有片段主機com.day.crx.spi.crx2sharepoint-bundle的片段包。

    使用Maven時,請根據項目要求調整maven-bundle-plugin的以下配置:

               <plugin>
                   <groupId>org.apache.felix</groupId>
                   <artifactId>maven-bundle-plugin</artifactId>
                   <extensions>true</extensions>
                   <configuration>
                       <instructions>
                           <Export-Package />
                           <Private-Package>
                               <!-- your private package here -->
                           </Private-Package>
                           <Fragment-Host>
                               com.day.crx.spi.crx2sharepoint-bundle
                           </Fragment-Host>
                        </instructions>
                   </configuration>
               </plugin>
    
  3. 在連接器配置中註冊SharepointConnectionFactory實施。 在連接器的配置窗口中,按一下​高級選項。 在​Sharepoint連接工廠​欄位中,指定實施com.day.crx.spi.sharepoint.auth.CustomConnectionFactory的名稱。

  4. 重新啟動連接器。

本頁內容