Show Menu
主题×

SharePoint Connector

本文包括有关Adobe JCR Connector for Microsoft SharePoint 2010和Microsoft SharePoint 2013版本4.0的详细信息。
SharePoint连接器支持以下基本功能:
  • 从SharePoint读取内容和元数据。
  • 通过应用本机SharePoint身份验证和授权,确认已访问内容的SharePoint安全设置
  • 使用内容查找器进行内容集成
  • 使用AEM组件(如外部资源)显示SharePoint图像和视频
  • 将SharePoint与AEM资产同步
所有功能都使用本机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 Runtime Environment 1.7或更高版本
  • 通过网络提供SharePoint web服务
  • SharePoint服务器URL
  • CRX和SharePoint存储库的用户凭据和权限
SharePoint连接器可从包共享下载

支持的平台

该连接器支持以下各项:
  • AEM版本:
    • AEM 6.5、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服务器URL”配置参数进行设置。
连接器还可以配置为多个工作区。 在这种情况下,每个工作区都与通过工作区公开的相应SharePoint服务器的URL相关联。 要添加工作区,请向“工作区”(Workspaces)参数添加工作区定义。 工作区定义具有以下格式: <name> = <url> where是JCR工作区的名称 <name>``<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. 单击保存。
如果配置多个工作区,请在“默认工作区名称”(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 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 Connection Factory”的值设置为“com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory”
  5. 单击​ 保存
配置基本身份验证(Windows)
  1. 单击OSGI >配置。
  2. 搜索 Day JCR Connector for Microsoft Sharepoint
  3. 单击 Edit the configuration values .
  4. 将“Sharepoint连接工厂”的值设置为 com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory
  5. 单击​ 保存
只有在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 auth zip 从包共享。
  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 authentication(Basic)和基于表单的身份验证(基于令牌)。 通过 可扩展性机制 ,可以支持其他认证方法。
以下步骤提供了扩展标准身份验证以支持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 器配置中注册实现。 在连接器的配置窗口中,单击“高 级选项” 。 在for Sharepoint连接工厂字段中 ,指定实现的名称 com.day.crx.spi.sharepoint.auth.CustomConnectionFactory
  4. 重新启动连接器。