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

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now