SharePoint Connector

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

本文包括有关AdobeJCR 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
和其他配置选项。 SharePoint内容在AEM存储库中可用。

安装要求

连接器需要:

  • Java运行时环境1.7或更高版本
  • SharePoint Web服务可通过网络提供
  • SharePoint服务器URL
  • CRX和SharePoint存储库的用户凭据和权限
  • 支持的平台

可以从packageshare下载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 2010MOSS 2013系统要求。

标准安装

AEM Package Share用于分发产品功能、示例和热修复程序。 有关详细信息,请参阅包共享文档

要在AEM欢迎页面上访问包共享,请点按/单击​工具,然后选择​包共享。 您需要包含您公司电子邮件地址的有效Adobe ID。 此外,登录到您的帐户后,还应用包共享访问权限。

与AEM集成

安装连接器内容包。

  1. 打开Adobe支持票证以请求连接器功能。

  2. 在包可用时下载该包,然后为您的AEM实例打开包管理器。

  3. 点按/单击包描述页面中的​Install

  4. 在​安装包​对话框中,点按/单击​安装

    注意:确保您以管理员身份登录。

  5. 安装包后,点按/单击​关闭

配置SharePoint连接器

安装SharePoint连接器后,请为该连接器配置应用程序和SharePoint层。

设置SharePoint服务器URL以使您的SharePoint存储库JCR兼容。 您可以设置其他参数来配置与SharePoint服务器的连接。 此外,还应使用SharePoint连接器配置身份验证。

配置与SharePoint服务器的连接

要设置SharePoint服务器的URL和高级选项,请执行以下步骤:

  1. 导航到OSGi管理控制台:http://localhost:4502/system/console/configMgr
  2. 搜索​Day JCR Connector for Microsoft Sharepoint​包。
  3. 编辑配置值。
  4. 将SharePoint服务器URL设置为​Workspaces​的值。
  5. 点按/单击​Save

chlimage_1-81

“工作区”和“默认工作区名称”参数:

默认情况下,连接器会公开单个JCR工作区。 此工作区公开的SharePoint服务器通过“Sharepoint Server URL”配置参数进行设置。

连接器还可以配置为多个工作区。 在这种情况下,每个工作区都与通过工作区公开的相应SharePoint服务器的URL相关联。 要添加工作区,请向Workspaces参数中添加工作区定义。 工作区定义具有以下格式:
<name>=其 <url>
<name> 是JCR工作区的名称,并且
<url> 是该工作区的SharePoint服务器的URL。

在AEM中,除上述配置步骤外,再执行一步。 允许列表“com.day.cq.dam.cq-dam-jcr-connectors”包。

要在AEM中允许列表包,请执行以下步骤:

  1. 导航到OSGi管理控制台:http://localhost:4502/system/console/configMgr。

  2. 搜索“Apache Sling登录管理员白名单”服务。

  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管理控制台:http://localhost:4502/system/console/configMgr
  2. 搜索“默认DAMAssetSynchronization”服务。
  3. 编辑配置值。
  4. 在SharePoint网站上设置有权访问的用户的用户名和相应的密码。
  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. 搜索“DAY CQ DAM JCR连接器资产同步服务”。
  3. 编辑配置值。
  4. 设置同步时段的值(以秒为单位)。
  5. 单击保存。

配置身份验证

Sharepoint包括经典身份验证和基于声明的身份验证方法,这两种方法都支持以下身份验证类型:

  • 基本
  • Forms

具体而言,可以使用以下类型的身份验证:

  • 经典 — 基本
  • 基于经典Forms
  • 索赔 — 基本
  • 基于索赔的Forms

AEM JCR Connector for Microsoft SharePoint 2010和Microsoft SharePoint 2013版本4.0支持基于声明的身份验证(Microsoft建议使用此功能),该身份验证以下模式运行:

  • 基本/NTLM身份验证:连接器首先尝试使用基本身份验证进行连接。如果不可用,则切换到基于NTLM的身份验证。
  • 基于Forms的身份验证:Sharepoint根据用户在登录表单(通常是网页)中键入的凭据来验证用户。系统为经过身份验证的请求发出令牌,该令牌包含用于为后续请求重新建立标识的密钥。

配置基于Forms的身份验证

转到:http://localhost:4502/system/console/bundles

  1. 单击OSGI ->配置
  2. 搜索“Day JCR Connector for Microsoft Sharepoint”
  3. 单击“编辑配置值”
  4. 将“Sharepoint连接工厂”的值设置为“com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory”
  5. 单击​Save

配置基本身份验证(Windows)

  1. 禁用令牌身份验证
  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. 单击​Create User
  6. 提供用户ID(在SharePoint上具有访问权限的用户名)
  7. 提供相应的密码
  8. 单击绿色勾号以创建用户

要在管理员组中添加用户,请执行以下操作:

  1. 转到“组管理”
  2. 单击“a”节点
  3. 单击“管理员”
  4. 在​Browse​按钮之前的文本框中键入上面创建的用户ID
  5. 单击绿色勾号以将用户添加到管理员组

禁用令牌身份验证

  1. 下载并安装包basic authzip 从包共享。

  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. 重新启动快速入门,然后使用您的凭据登录。

支持SharePoint服务器的不同身份验证方法

在其标准版本中,连接器支持标准IIS Windows​身份验证(基本)和基于Forms的身份验证(基于令牌)。 可通过扩展性机制支持其他身份验证方法

以下步骤提供了有关扩展标准身份验证以支持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. 重新启动连接器。

在此页面上