文档AEM 6.4Administering 指南

SharePoint Connector sharepoint-connector

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

适用于Microsoft SharePoint 2010和Microsoft SharePoint 2013的Day JCR Connector，版本4.0。

本文包含有关适用于Microsoft SharePoint 2010和Microsoft SharePoint 2013版的AdobeJCR Connector 4.0的详细信息。

SharePoint连接器支持以下基本功能：

  • 从SharePoint中读取内容和元数据。
  • 通过应用本机SharePoint身份验证和授权，确认已访问内容的SharePoint安全设置
  • 使用内容查找器进行内容集成
  • 使用AEM组件（如外部资源）显示SharePoint图像和视频
  • 将SharePoint与AEM Assets同步

所有功能都使用本机SharePoint Web服务作为SharePoint内容和服务的界面来实施。

NOTE
SharePoint 6.1 Service Pack 2也支持AEM Connector。 连接器不再支持虚拟存储库装载，因此无法装载。 如果要使用Java API访问Sharepoint存储库，请在您的项目中使用Sharepoint连接器的JCR存储库实施。
SharePoint服务器及相关IT基础架构的安装、配置、管理和IT操作不在本文档的范围之内。 请参阅供应商文档(位于 SharePoint 以了解有关这些主题的信息。 连接器要求正确安装、配置和操作基础架构的这些部分。

入门指南 getting-started

要开始使用连接器，请执行以下操作：

  • 确保至少安装了Java 7。

  • 从包共享下载连接器包分发文件。

  • 复制有效 license.properties 文件到包含 cq-quickstart-6.4.0.jar 文件。

  • 双击/点按.jar文件以启动AEM，或从命令行启动它。

  • 从包管理器安装连接器包。

  • 配置连接器选项。

安装SharePoint连接器 installing-sharepoint-connector

连接器是便于安装的内容包。 使用包管理器安装包，然后设置SharePoint服务器URL
和其他配置选项。 SharePoint内容在AEM存储库中可用。

安装要求 installation-requirements

连接器需要：

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

可从下载SharePoint连接器 packageshare.

支持的平台 supported-platforms

该连接器支持以下功能：

  • AEM版本：

    • AEM 6.4、6.3

  • Microsoft SharePoint版本：

    • Microsoft Office SharePoint Server(MOSS)2010
    • Microsoft Office SharePoint Server(MOSS)2013

  • 如果您需要支持连接器的自定义部署（OEM、特殊要求、自定义身份验证方法），请联系您所在地区的Adobe办公室。

NOTE
连接器仅支持Microsoft正式支持的配置。 请参阅 MOSS 2010 和 MOSS 2013 系统要求。

标准安装 standard-installation

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

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

与AEM集成 integrating-with-aem

安装连接器内容包。

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

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

  3. 点按/单击 安装 从包描述页面。

  4. 从 安装包 对话框，点按/单击 安装.

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

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

配置SharePoint连接器 configuring-sharepoint-connector

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

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

配置与SharePoint服务器的连接 configuring-the-connection-with-the-sharepoint-server

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

  1. 导航到OSGi管理控制台： http://localhost:4502/system/console/configMgr.
  2. 搜索 适用于Microsoft Sharepoint的Day JCR Connector 捆绑。
  3. 编辑配置值。
  4. 将SharePoint服务器URL设置为 工作区.
  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登录管理员白名单”服务。

  3. 选择绕过白名单。

  4. 添加“com.day.cq.dam.cq-dam-jcr-connectors ​默认位于白名单包中的“

  5. 单击“保存”。

chlimage_1-82

NOTE
如果配置多个工作区，请在默认工作区名称参数中指定默认工作区的名称。

有关与身份验证相关的参数的其他信息，请参阅 身份验证.

验证Sharepoint设置 verifying-the-sharepoint-setup

配置连接器后，验证以下内容：

  • SharePoint服务器运行，并且Web服务可供连接器实例访问
  • SharePoint用户凭据有效，并且用户具有必要的SharePoint权限
  • 连接器已正确安装和配置

配置与SharePoint服务器的DAM同步 configuring-dam-sync-with-the-sharepoint-server

要将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. 单击“保存”。

配置身份验证 configuring-authentication

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

  • 基本
  • Forms

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

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

适用于Microsoft SharePoint 2010和Microsoft SharePoint 2013的AEM JCR Connector 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. 搜索 适用于Microsoft Sharepoint的Day JCR Connector.
  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. 单击绿色勾号将用户添加到管理员组

禁用令牌身份验证 disable-token-authentication

  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"/> 标记内部。

  6. 保存并关闭xml文件。

  7. 重新启动快速入门，然后使用您的凭据登录。

支持SharePoint服务器的不同身份验证方法 supporting-different-authentication-methods-of-the-sharepoint-server

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

以下步骤提供了有关扩展标准身份验证的准则，以支持SharePoint服务器的各种身份验证方法：

  1. 实施 com.day.crx.spi.sharepoint.security.SharepointConnectionFactory 来处理特定身份验证过程的客户端。

  2. 安装 SharepointConnectionFactory 作为片段主机的片段包实施 com.day.crx.spi.crx2sharepoint-bundle.

    使用Maven时，请调整 maven-bundle-plugin 符合项目要求：

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

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8