SharePoint Connector sharepoint-connector
適用於Microsoft SharePoint 2010和Microsoft SharePoint 2013的Day JCR Connector,4.0版。
本文包含有關適用於Microsoft SharePoint 2010和Microsoft SharePoint 2013 4.0版的AdobeJCR Connector的詳細資訊。
SharePoint連接器支援下列基本功能:
- 從SharePoint讀取內容和中繼資料。
- 套用原生SharePoint驗證和授權,確認所存取內容的SharePoint安全性設定
- 使用內容尋找器進行內容整合
- 使用AEM元件(例如外部資源)來顯示SharePoint影像和視訊
- 同步SharePoint與AEM Assets
所有功能都是使用原生SharePoint網站服務來實作,作為SharePoint內容與服務的介面。
快速入門 getting-started
若要開始使用連接器,請執行下列動作:
-
請確定您至少已安裝Java 7。
-
從「封裝共用」下載連接器封裝發佈檔案。
-
複製有效 license.properties 檔案至包含 cq-quickstart-6.4.0.jar 檔案。
-
按兩下/點選.jar檔案以啟動AEM,或從命令列啟動。
-
從「封裝管理器」安裝連接器封裝。
-
配置連接器選項。
安裝SharePoint連接器 installing-sharepoint-connector
該連接器是便於安裝的內容封裝。 使用套件管理器安裝套件,然後設定SharePoint伺服器URL
和其他設定選項。 AEM存放庫中提供SharePoint內容。
安裝需求 installation-requirements
連接器需要下列項目:
- Java Runtime Environment 1.7或更新版本
- SharePoint網站服務可透過網路取得
- SharePoint伺服器URL
- CRX和SharePoint存放庫的使用者認證和權限
- 支援平台
SharePoint連接器可從下載 packeshare.
支援平台 supported-platforms
連接器支援下列功能:
-
AEM版本:
- AEM 6.4、6.3
-
Microsoft SharePoint版本:
- Microsoft Office SharePoint伺服器(MOSS)2010
- Microsoft Office SharePoint伺服器(MOSS)2013
-
如果您需要支援連接器的自訂部署(OEM、特殊要求、自訂驗證方法),請與貴地區的Adobe辦公室聯繫。
標準安裝 standard-installation
AEM Package Share可用來分發產品功能、範例和Hotfix。 如需詳細資訊,請參閱 封裝共用檔案.
若要存取AEM歡迎頁面上的「封裝共用」,請點選/按一下 工具 然後選取 封裝共用. 您需要有效的Adobe ID,其中包含您公司的電子郵件地址。 此外,登入您的帳戶後,請套用「封裝共用」存取權。
與AEM整合 integrating-with-aem
安裝連接器內容封裝。
-
開啟「Adobe支援」票證以要求連接器功能。
-
若有套件可用,請下載該套件,然後開啟AEM執行個體的套件管理器。
-
點選/按一下 安裝 從包說明頁面。
-
從 安裝套件 對話方塊,點選/按一下 安裝.
附註:請確定您是以管理員身分登入。
-
安裝套件時,點選/按一下 關閉.
配置SharePoint連接器 configuring-sharepoint-connector
安裝SharePoint連接器後,請為連接器配置應用程式和SharePoint層。
設定SharePoint伺服器URL,使您的SharePoint存放庫JCR符合規範。 您可以設定額外的參數來設定與SharePoint伺服器的連線。 此外,請使用SharePoint連接器設定驗證。
設定與SharePoint伺服器的連線 configuring-the-connection-with-the-sharepoint-server
若要設定SharePoint伺服器的URL和進階選項,請執行下列步驟:
- 導覽至OSGi管理控制台: http://localhost:4502/system/console/configMgr.
- 搜尋 Day JCR Connector for Microsoft Sharepoint 捆綁。
- 編輯設定值。
- 將SharePoint伺服器URL設定為 工作區.
- 點選/按一下 儲存.
「工作區」和「預設工作區名稱」參數:
依預設,連接器會公開單一JCR工作區。 此工作區公開的SharePoint伺服器是通過「Sharepoint伺服器URL」配置參數設定的。
連接器也可針對多個工作區而設定。 在此情況下,每個工作區都會與透過工作區公開之個別SharePoint伺服器的URL相關聯。 若要新增工作區,請將工作區定義新增至工作區參數。 工作區定義的格式如下:<name>
= <url>
where<name>
是JCR工作區的名稱,且<url>
是該工作區的SharePoint伺服器URL。
在AEM中,除了上述設定步驟以外,再執行一個步驟。 允許列出「com.day.cq.dam.cq-dam-jcr-connectors'組合。
若要在AEM中允許清單套件組合,請執行下列步驟:
-
導覽至OSGi管理控制台:http://localhost:4502/system/console/configMgr。
-
搜尋「Apache Sling登入管理員白名單」服務。
-
選取略過白名單。
-
添加「com.day.cq.dam.cq-dam-jcr-connectors「白名單包」預設值
-
按一下「儲存」。
如需與驗證相關的參數的其他資訊,請參閱 驗證.
驗證Sharepoint設定 verifying-the-sharepoint-setup
配置連接器後,請驗證以下內容:
- SharePoint伺服器會執行,而連接器執行個體可存取web服務
- SharePoint使用者憑證有效,且使用者擁有必要的SharePoint權限
- 已正確安裝並配置連接器
設定與SharePoint伺服器的DAM同步 configuring-dam-sync-with-the-sharepoint-server
若要將SharePoint Assets與AEM同步,請執行下列步驟:
- 導覽至OSGi管理控制台: http://localhost:4502/system/console/configMgr.
- 搜索「Default DAMAssetSynchronization」服務。
- 編輯設定值。
- 設定在SharePoint網站上具有存取權之使用者的使用者名稱和對應密碼。
- 按一下「儲存」。
啟用DAM同步服務,預設會停用:
- 導覽至OSGi Web主控台元件: http://localhost:4502/system/console/components
- 搜尋「com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService」。
- 按一下「啟用」。
您可以根據需要配置不同同步週期之間的同步延遲:
- 導覽至OSGi管理控制台: http://localhost:4502/system/console/configMgr
- 搜尋「DAY CQ DAM JCR連接器資產同步服務」。
- 編輯設定值。
- 設定同步週期的值(以秒為單位)。
- 按一下「儲存」。
配置驗證 configuring-authentication
Sharepoint包括基於傳統和聲明的身份驗證方法,這兩種方法均支援以下身份驗證類型:
- 基本
- Forms
尤其是,下列驗證類型可供使用:
- Classic-Basic
- 傳統型Forms
- 基本索賠
- 基於索賠的Forms
適用於Microsoft SharePoint 2010和Microsoft SharePoint 2013的AEM JCR Connector 4.0版支援以聲明為基礎的驗證(由Microsoft建議),其運作方式如下:
- 基本/NTLM身份驗證:連接器會先嘗試使用基本驗證來連線。 如果不可用,則切換為基於NTLM的身份驗證。
- Forms型驗證:Sharepoint根據用戶在登錄表單中鍵入的憑據(通常為網頁)來驗證用戶。 系統為已驗證的請求發出令牌,該令牌包含用於為後續請求重新建立標識的密鑰。
設定Forms式驗證
前往: http://localhost:4502/system/console/bundles
- 按一下「OSGI ->設定」
- 搜尋「Day JCR Connector for Microsoft Sharepoint」
- 按一下「編輯配置值」
- 將「Sharepoint連接工廠」的值設定為「com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory」
- 按一下 儲存
配置基本身份驗證(Windows)
- 禁用令牌驗證.
- 前往 http://localhost:4502/system/console/bundles.
- 按一下「OSGI >設定」。
- 搜尋 Day JCR Connector for Microsoft Sharepoint.
- 按一下
Edit the configuration values
. - 將Sharepoint連接工廠的值設定為
com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory
. - 按一下「儲存」。
只有同時在AEM和SharePoint上驗證的使用者才能透過連接器存取SharePoint內容。
您也可以使用驗證的連接器擴充功能來建立自訂驗證模組,例如,將AEM使用者的存取權對應至特定SharePoint使用者。 建立與SharePoint使用者對應的AEM使用者(使用者名稱與密碼應相符),以便查看對應至連接器例項的SharePoint內容。
若要在AEM中建立使用者:
- 登入http://localhost:9502/with管理員使用者。
- 按一下「工具」。
- 按一下「安全性」。
- 按一下「使用者」。
- 按一下 建立使用者
- 提供使用者ID(在SharePoint上具有存取權的使用者名稱)
- 提供對應的密碼
- 按一下綠色勾號以建立使用者
若要在管理群組中新增使用者:
- 前往群組管理
- 按一下「a」節點
- 按一下「管理員」
- 在前面的文字方塊中,輸入上方建立的使用者ID 瀏覽 按鈕
- 按一下綠色勾號,將使用者新增至管理群組
禁用令牌驗證 disable-token-authentication
-
下載並安裝套件
basic auth
.zip
從包共用。 -
關閉快速入門。
-
開啟檔案 \crx-quickstart\repository\repository.xml.
-
尋找標籤
<LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
-
插入標籤
<param name="disableTokenAuth" value="true"/>
在步驟4中提及的標籤內。 -
保存並關閉xml檔案。
-
重新啟動QuickStart並使用您的憑據登錄。
支援SharePoint伺服器的不同驗證方法 supporting-different-authentication-methods-of-the-sharepoint-server
在其標準版本中,連接器支援標準IIS Windows 驗證(基本)和Forms式驗證(以權杖為基礎)。 此 其他驗證方法 可透過擴充性機制來支援。
下列步驟提供延伸標準驗證的相關准則,以支援SharePoint伺服器的各種驗證方法:
-
實作
com.day.crx.spi.sharepoint.security.SharepointConnectionFactory
來處理您特定驗證程式的用戶端。 -
安裝
SharepointConnectionFactory
片段主機的片段套件組合實作com.day.crx.spi.crx2sharepoint-bundle
.使用Maven時,請調整
maven-bundle-plugin
符合您專案的需求:code language-xml <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>
-
註冊
SharepointConnectionFactory
在連接器設定中實作。 在連接器的配置窗口中,按一下 進階選項. 在 Sharepoint連接工廠 欄位,指定實作的名稱com.day.crx.spi.sharepoint.auth.CustomConnectionFactory
. -
重新啟動連接器。