Show Menu
主题×

SharePoint Connector

本文包括有关Adobe JCR Connector for Microsoft SharePoint 2010和Microsoft SharePoint 2013版本4.0的详细信息。
SharePoint连接器支持以下基本功能:
  • 从SharePoint读取内容和元数据。
  • 通过应用本机SharePoint身份验证和授权确认已访问内容的SharePoint安全设置
  • 使用内容查找器进行内容集成
  • 使用AEM组件(如外部资源)显示SharePoint图像和视频
  • 将SharePoint与AEM Assets同步
所有功能都使用本机SharePoint Web服务作为SharePoint内容和服务的接口来实现。
AEM 6.1 service pack 2也支持SharePoint Connector。 连接器不再支持虚拟存储库装载,因此无法装载它。 如果要使用Java API访问Sharepoint存储库,请在项目中使用Sharepoint连接器的JCR存储库实现。
SharePoint服务器和相关IT基础架构的安装、配置、管理和IT操作不在此文档的范围之内。 有关这些主题的 信息 ,请参阅SharePoint的供应商文档。 连接器要求正确安装、配置和操作基础结构的这些部分。

入门

要开始使用连接器,请执行以下操作:
  • 请确保至少已安装Java 7。
  • 从包共享下载连接器包分发文件。
  • 将有效 的license.properties 文件复制到包含 cq-quickstart-6.4.0.jar文件的目录
  • 多次-单击/点按。jar文件以开始AEM,或从命令行开始它。
  • 从包管理器安装连接器包。
  • 配置连接器选项。

安装SharePoint连接器

该连接器是易于安装的内容包。 使用包管理器安装包,然后设置SharePoint服务器URL和其他配置选项。 AEM存储库中提供SharePoint内容。

安装要求

连接器需要:
  • Java Runtime环境1.7或更高版本
  • 通过网络提供SharePoint Web服务
  • SharePoint服务器URL
  • CRX和SharePoint存储库的用户凭据和权限
SharePoint连接器可从包共享下

支持的平台

该连接器支持以下各项:
  • 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包共享用于分发产品功能、示例和热修复。 有关详细信息,请参阅 包共享文档
要在AEM欢迎页面上访问包共享,请点按/单击 工具 ,然后选择 包共享 。 您需要有效的Adobe ID,其中包含您的公司电子邮件地址。 此外,登录到您的帐户后,申请“包共享”访问权限。

与AEM集成

安装连接器内容包。
  1. 打开Adobe支持票证以请求连接器功能。
  2. 在包可用时下载它,然后打开AEM实例的包管理器。
  3. 点按/单 击包 描述页面中的安装。
  4. 在“安 装包 ”对话框中,点按/单 击安装
    注意 : 确保您以管理员身份登录。
  5. 安装包后,点按/单击关

配置SharePoint连接器

安装SharePoint连接器后,请为连接器配置应用程序和SharePoint层。
设置SharePoint服务器URL,使您的SharePoint存储库符合JCR。 可以设置其他参数以配置与SharePoint服务器的连接。 此外,使用SharePoint连接器配置身份验证。

配置与SharePoint服务器的连接

要设置SharePoint服务器的URL和高级选项,请执行以下步骤:
  1. 导航到OSGi管理控制台: http://localhost:4502/system/console/configMgr
  2. 搜索Microsoft Sharepoint捆绑的Day JCR Connector
  3. 编辑配置值。
  4. 将SharePoint Server URL设置为Workspaces的
  5. Tap/click Save .
“工作区”和“默认工作区名称”参数:
默认情况下,连接器显示单个JCR工作区。 此工作区公开的SharePoint服务器通过“Sharepoint Server URL”配置参数进行设置。
连接器也可配置为多个工作区。 在这种情况下,每个工作区都与通过工作区公开的相应SharePoint服务器的URL相关联。 要添加工作区,请向“工作区”(Workspaces)参数添加工作区定义。 工作区定义具有以下格式: <name> = <url> where <name> is the JCR workspace name and <url> is the SharePoint server for that workspace.
在AEM中,执行与上述配置步骤不同的另一步。 允许列表​ “com.day.cq.dam.cq-dam-jcr-connectors ”捆绑。
要在AEM中允许列表包,请执行以下步骤:
  1. 导航到OSGi管理控制台: http://localhost:4502/system/console/configMgr。
  2. 搜索“Apache Sling Login Admin Whitelist”服务。
  3. 选择 绕过白名单
  4. 添加 com.day.cq.dam.cq-dam-jcr-connectors 到白名单包默认
  5. 单击保存。
如果配置多个工作区,请在“默认工作区名称”(Default Workspace Name)参数中指定默认工作区的名称。
有关与身份验证相关的参数的其他信息,请参 阅身份验证

验证Sharepoint设置

配置连接器后,请验证以下内容:
  • SharePoint服务器运行,连接器实例可以访问Web服务
  • SharePoint用户凭据有效,且用户具有必要的SharePoint权限
  • 连接器已正确安装和配置

配置DAM与SharePoint服务器同步

要将SharePoint资产与AEM同步,请执行以下步骤:
  1. 导航到OSGi管理控制台: http://localhost:4502/system/console/configMgr
  2. 搜索“Default DAMAssetSynchronization”服务。
  3. 编辑配置值。
  4. Set the user name and the corresponding Password of the user having access on the SharePoint site.
  5. 单击保存。
启用DAM同步服务,默认情况下禁用该服务:
  1. 导航到OSGi Web控制台组件: http://localhost:4502/system/console/components
  2. 搜索“com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService”。
  3. 单击“启用”。
或者,您也可以配置不同同步周期之间的同步延迟:
  1. 导航到OSGi管理控制台: http://localhost:4502/system/console/configMgr
  2. Search for "DAY CQ DAM JCR Connector Asset Synchronization Service."
  3. 编辑配置值。
  4. 设置同步周期的值(以秒为单位)。
  5. 单击保存。

配置身份验证

Sharepoint包括经典和基于声明的身份验证方法,这两种方法都支持以下身份验证类型:
  • 基本
  • 基于表单
特别是,可以使用以下类型的身份验证:
  • Classic-Basic
  • 基于经典表单
  • Claims-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连接工厂”的值设置为“com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory”
  5. 单击​ 保存
配置基本身份验证(Windows)
  1. 单击OSGI >配置。
  2. 搜索Day JCR Connector for Microsoft Sharepoint
  3. 单击 Edit the configuration values .
  4. Set the value of Sharepoint Connection Factory to com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory .
  5. 单击​ 保存
只有在AEM和SharePoint上通过身份验证的用户才能通过连接器访问SharePoint内容。
您还可以使用连接器扩展进行身份验证以创建自定义身份验证模块,例如,将AEM用户的访问权限映射到特定SharePoint用户。 创建与SharePoint用户(用户名和密码应匹配)对应的AEM用户,以便能够查看映射到连接器实例的SharePoint内容。
要在AEM中创建用户,请执行以下操作:
  1. Login to http://localhost:9502/with the admin user.
  2. 单击“工具”。
  3. 单击“安全”。
  4. 单击“用户”。
  5. 单击“ 创建用户 ”。
  6. 提供用户ID(在SharePoint上具有访问权限的用户名)。
  7. 提供相应的密码。
  8. 单击绿色勾号以创建用户。
要在管理员组中添加用户,请执行以下操作:
  1. 转到“组管理”。
  2. Click the ‘a’ node.
  3. Click ‘administrators’.
  4. 在“浏览”按钮前的文本框中键入以上创建的 用户 ID。
  5. Click the Green tick symbol to add the user to admin group.

Disable Token Authentication

  1. Download and install the package basic auth . zip from Package Share.
  2. Close Quickstart.
  3. Open the file \crx-quickstart\repository\repository.xml .
  4. Find the tag <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
  5. Insert the tag <param name="disableTokenAuth" value="true"/> inside the tag mentioned in step 4.
  6. Save and close the xml file.
  7. Restart QuickStart and log in with your credentials.

Supporting different authentication methods of the SharePoint server

In its standard version, the connector supports the standard IIS Windows authentication (Basic) and Forms-based authentication (token based). The other authentication methods can be supported through the extensibility mechanism.
以下步骤提供了扩展标准身份验证以支持SharePoint服务器的各种身份验证方法的相关指南:
  1. Implement com.day.crx.spi.sharepoint.security.SharepointConnectionFactory to handle the client side of your specific authentication process.
  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. Register the SharepointConnectionFactory implementation in the connector configuration. In the configuration window of the connector, click Advanced options . In the for Sharepoint Connection Factory field, specify the name of the implementation com.day.crx.spi.sharepoint.auth.CustomConnectionFactory .
  4. Restart the connector.