Show Menu
主題×

SharePoint Connector

本文包含有關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上的廠商檔案。 連接器要求正確安裝、配置和操作基礎架構的這些部分。

Getting started

要開始使用連接器,請執行以下操作:
  • 請確定您至少已安裝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 2010 MOSS 2013系統需求

標準安裝

AEM Package Share可用來散發產品功能、範例和Hotfix。 如需詳細資訊,請參閱「套 件共用」檔案
若要存取「AEM歡迎」頁面上的「套件共用」,請點選/按一下「工 」,然後選 取「套件共用」 。 您需要有效的Adobe ID,其中包含您公司的電子郵件地址。 此外,登入您的帳戶後,請套用「封裝共用」存取權。

與AEM整合

安裝連接器內容包。
  1. 開啟Adobe支援票證以要求連接器功能。
  2. 當套件可供使用時,請下載它,然後開啟AEM例項的Package Manager。
  3. 點選/按一 下套件 「說明」頁面中的「安裝」。
  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. 搜尋Microsoft Sharepoint 搭售版的Day JCR Connector
  3. 編輯配置值。
  4. 將SharePoint伺服器URL設為工作區的
  5. 點選/按一下「 儲存 」。
「工作區」和「預設工作區名稱」參數:
依預設,連接器會公開單一JCR工作區。 此工作區公開的SharePoint伺服器是透過「Sharepoint伺服器URL」設定參數來設定。
連接器也可以配置為多個工作區。 在這種情況下,每個工作區都與通過工作區公開的各個SharePoint伺服器的URL相關聯。 若要新增工作區,請新增工作區定義至「工作區」參數。 工作區定義具有以下格式: <name> = <url> where <name> is the name of the JCR workspace <url> and is the SharePoint server for that workspace.
在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. 按一下「儲存」。
如果您設定多個工作區,請在「預設工作區名稱」參數中指定預設工作區的名稱。
如需驗證相關參數的詳細資訊,請參閱驗

驗證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會根據使用者在登入表單(通常是網頁)中輸入的認證來驗證使用者。 該系統為已驗證的請求發出令牌,該令牌包含用於為後續請求重新建立標識的密鑰。
配置基於表單的驗證
  1. 按一下OSGI ->配置
  2. 搜尋「Day JCR Connector for Microsoft Sharepoint」
  3. 按一下「編輯設定值」
  4. 將「Sharepoint Connection Factory」的值設為「com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory」
  5. 按一下​ 「儲存」
配置基本身份驗證(Windows)
  1. 按一下「OSGI >設定」。
  2. 搜尋Microsoft Sharepoint適用的Day JCR Connector
  3. 按一下 Edit the configuration values .
  4. 將Sharepoint連接工廠的值設定為 com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory
  5. 按一下​ 「儲存」
只有在AEM和SharePoint上都經過驗證的使用者才能透過連接器存取SharePoint內容。
您也可以使用驗證的連接器擴充功能來建立自訂驗證模組,例如,將AEM使用者的存取權對應至特定SharePoint使用者。 建立與SharePoint使用者對應的AEM使用者(使用者名稱和密碼應相符),以便能夠查看對應至連接器例項的SharePoint內容。
若要在AEM中建立使用者:
  1. 登入http://localhost:9502/with管理員使用者。
  2. 按一下「工具」。
  3. 按一下「安全性」。
  4. 按一下「使用者」。
  5. 按一 下「建立使用者 」。
  6. 提供使用者ID(可存取SharePoint的使用者名稱)。
  7. 提供對應的密碼。
  8. 按一下「綠色勾號」(Green tick)符號以建立使用者。
若要在管理員群組中新增使用者:
  1. 前往「群組管理」。
  2. 按一下「a」節點。
  3. 按一下「管理員」。
  4. 在「瀏覽」按鈕之前的文字方塊中,輸入上述建立的使 用者 ID。
  5. 按一下「綠色勾選」符號,將使用者新增至管理群組。

停用Token驗證

  1. 下載並安裝套件 basic auth zip 從Package Share。
  2. 關閉快速入門。
  3. 開啟檔案 \crx-quickstart\repository\repository.xml
  4. 尋找標籤 <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
  5. 在步驟4中 <param name="disableTokenAuth" value="true"/> 提及的標籤內插入標籤。
  6. 儲存並關閉xml檔案。
  7. 重新啟動QuickStart並使用您的認證登入。

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

在其標準版本中,連接器支援標準IIS Windows 驗證(基本)和表單式驗證(以Token為基礎)。 其 他認證方法 ,可以通過擴展機制來支援。
以下步驟提供有關擴展標準身份驗證的指導,以支援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 配置中註冊實施。 在連接器的配置窗口中,按一下「高 級選項」 。 在for Sharepoint Connection Factory欄位中 ,指定實施的名稱 com.day.crx.spi.sharepoint.auth.CustomConnectionFactory
  4. 重新啟動連接器。