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. 重新啟動連接器。

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now