SharePoint连接器

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
和其他配置选项。 AEM存储库中提供SharePoint内容。

安装要求

连接器需要:

  • Java Runtime环境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包共享用于分发产品功能、示例和热修复。 有关详细信息,请参阅包共享文档

要访问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. 搜索​Day JCR Connector for Microsoft Sharepoint​捆绑包。
  3. 编辑配置值。
  4. 将SharePoint Server URL设置为​Workspaces​的值。
  5. 点按/单击​保存

chlimage_1-81

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

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

连接器也可配置为多个工作区。 在这种情况下,每个工作区都与通过工作区公开的相应SharePoint服务器的URL相关联。 要添加工作区,请向“工作区”(Workspaces)参数添加工作区定义。 工作区定义具有以下格式:
<name>= <url> where
<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 Login Admin Whitelist”服务。

  3. 选择绕过白名单。

  4. 在白名单捆绑默认包中添加“com.day.cq.dam.cq-dam-jcr-connectors

  5. 单击保存。

chlimage_1-82

注意

如果配置多个工作区,请在“默认工作区名称”(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. 设置有权访问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

特别是,可以使用以下类型的身份验证:

  • Classic-Basic
  • 基于经典Forms的
  • Claims-Basic
  • 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. 单击​保存

配置基本身份验证(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. 单击​创建用户
  6. 提供用户ID(有权访问SharePoint的用户名)
  7. 提供相应的密码
  8. 单击绿色勾号以创建用户

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

  1. 转到组管理
  2. 单击“a”节点
  3. 单击“管理员”
  4. 在​浏览​按钮之前的文本框中键入以上创建的用户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. 重新启动QuickStart并使用凭据登录。

支持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. 重新启动连接器。

在此页面上