Communities用户同步

简介

在AEM Communities中，从发布环境（取决于配置的权限）， 网站访客 可能会变成 成员，创建 用户组，并编辑其 成员配置文件 .

用户数据 是一个术语，用来指代 用户， 用户配置文件 和 用户组.

成员 是一个术语，用来指代 用户 在发布环境中注册的用户，与在创作环境中注册的用户不同。

有关用户数据的更多信息，请访问 管理用户和用户组.

在发布场中同步用户

根据设计，在发布环境中创建的用户数据不会显示在创作环境中。

在创作环境中创建的大多数用户数据旨在保留在创作环境中，不会同步或复制到发布实例。

当 拓扑 是 发布场，对一个发布实例所做的注册和修改需要与其他发布实例同步。 成员需要能够登录并在任何发布节点上查看其数据。

启用用户同步后，将在场中的发布实例之间自动同步用户数据。

用户同步设置说明

有关如何跨发布场启用同步的详细分步说明，请参阅：

后台用户同步

sling-dist-workflow

  • vlt包

    它是一个zip文件，其中包含对发布者所做的所有更改，这些更改需要跨发布者分发。 发布服务器的更改会生成由更改事件侦听器挑选的事件。 这将创建一个包含所有更改的vlt包。

  • 分发包

    它包含Sling的分发信息。 这是有关内容需要分发到何处以及最后分发时间的信息。

当……出现以下情况时会发生什么情况：

从社区站点控制台发布站点

对于作者，当从发布社区站点时 社区站点控制台，效果为 复制 关联的页面和Sling会分发动态创建的社区用户组，包括其成员资格。

发布时创建或编辑用户配置文件

根据设计，在发布环境中创建的用户和配置文件（例如通过自助注册、社交登录、LDAP身份验证）不会显示在创作环境中。

当拓扑为 发布场 和用户同步配置正确， 用户 和 用户配置文件 使用Sling分发跨发布场同步。

发布时创建新社区组

尽管社区组创建是从发布实例启动的，但实际上是在创作实例上发生的，这会产生新的站点页面和一个新的用户组。

作为该过程的一部分，新站点页面将被复制到所有发布实例。 动态创建的社区用户组及其成员资格将分发到所有发布实例。

用户或用户组是使用安全控制台创建的

根据设计，在发布环境中创建的用户数据不会显示在创作环境中，反之亦然。

当 用户管理和安全性 console用于在发布环境中添加新用户，如有必要，用户同步会将新用户及其组成员资格同步到其他发布实例。 用户同步还将同步通过安全控制台创建的用户组。

用户发布内容时发布

对于用户生成的内容(UGC)，可通过访问在发布实例上输入的数据 配置的SRP.

最佳实践

默认情况下，用户同步为 已禁用. 启用用户同步涉及修改 现有 osgi配置。 启用用户同步后，不应添加任何新配置。

用户同步依赖作者环境管理用户数据分发，即使用户数据不是基于作者创建的。

前提条件

  1. 如果已在一个发布服务器上创建了用户和用户组，则建议执行以下操作 手动同步 配置并启用用户同步之前，将用户数据发送到所有发布者。

    启用用户同步后，将仅同步新创建的用户和组。

  2. 确保安装了最新的代码：

需要以下配置才能在AEM Communities上启用用户同步。 确保这些配置正确，以防止sling内容分发失败。

Apache Sling分发代理 — 同步代理工厂

此配置会获取要在发布服务器之间同步的内容。 该配置位于创作实例上。 作者必须跟踪所有存在的发布者以及在何处同步所有信息。

配置中的默认值用于单个发布实例。 由于用户同步对于同步多个发布实例很有用（例如对于发布场），因此需要向配置中添加其他发布实例。

内容如何同步？

创作实例ping发布服务器的导出程序终结点。 每当在特定发布者(n)上创建用户或更新用户时，作者都会从其导出程序端点获取内容，并且 推送内容 其他发布者（n-1，不同于从中获取内容的发布者）。

要配置Apache Sling同步代理配置，请执行以下操作：

  1. 使用管理员权限登录到AEM创作实例。

  2. 访问 Web控制台. 例如， https://localhost:4502/system/console/configMgr.

  3. 查找 Apache Sling分发代理 — 同步代理工厂.

    • 选择要打开的现有配置以进行编辑（铅笔图标）。

      验证名称： socialpubsync。

    • 选中​启用​复选框。

    • 选择 使用多个队列。

    • 指定 导出程序端点 和 导入程序端点 （您可以添加更多导出程序和导入程序端点）。

      这些端点定义要从何处获取内容以及要将内容推送到何处。 作者从指定的导出程序终结点获取内容，并将内容推送到发布者（而不是从中获取内容的发布者）。
      sync-agent-fact

AdobeGranite分发 — 加密的密码传输密钥提供程序

它使作者能够识别具有将用户数据从作者同步到发布的权限的授权用户。

此 已创建授权用户 在所有发布实例上帮助发布者与作者连接并在作者上配置Sling分发。 此授权用户拥有所有必需的 ACL.

无论何时要在发布服务器上安装数据或从发布服务器上获取数据，作者都将使用此配置中设置的凭据（用户名和密码）与发布服务器连接。

要使用授权用户将作者与发布者连接，请执行以下操作：

  1. 使用管理员权限登录到AEM创作实例。

  2. 访问 Web控制台.

    例如， https://localhost:4502/system/console/configMgr.

  3. 查找 AdobeGranite分发 — 加密的密码传输密钥提供程序。

  4. 选择要打开的现有配置以进行编辑（铅笔图标）。

    验证属性 socialpubsync - publishUser。

  5. 将用户名和密码设置为 授权用户.

    例如， usersync — 管理员

granite-paswrd-trans

Apache Sling分发代理 — 队列代理工厂

此配置用于配置要在发布者之间同步的数据。 在指定的路径中创建/更新数据时 允许的根，将会激活“var/community/distribution/diff”，并且创建的复制程序会从发布服务器获取数据，并将其安装到其他发布服务器。

要配置要同步的数据（节点路径），请执行以下操作：

  1. 使用发布实例上的管理员权限登录。

  2. 访问 Web控制台.

    例如， https://localhost:4503/system/console/configMgr.

  3. 查找 Apache Sling分发代理 — 队列代理工厂.

  4. 选择要打开的现有配置以进行编辑（铅笔图标）。

    验证名称： socialpubsync -reverse

  5. 选择 已启用 复选框，然后保存。

  6. 指定要复制到的节点路径 允许的根.

  7. 重复执行每个 发布 实例。

    queue-agents-fact

AdobeGranite分发 — 观察者工厂差异

此配置可同步发布者之间的组成员资格。
如果更改一个发布者中组的成员资格时没有更新其他发布者的成员资格，请确保 ref ：members 已添加至 查找的属性名称.

要确保成员同步，请执行以下操作：

  1. 使用发布实例上的管理员权限登录。

  2. 访问 Web控制台.

    例如， https://localhost:4503/system/console/configMgr.

  3. 查找 AdobeGranite分发 — 观察者工厂差异.

  4. 选择要打开的现有配置以进行编辑（铅笔图标）。

    验证 代理名称： socialpubsync -reverse.

  5. 选中​启用​复选框。

  6. 指定 rep：members 作为中的propertyName的说明 查找的属性名称，并保存。

    diff-obs

Apache Sling Distribution Trigger — 计划触发器工厂

通过此配置，您可以配置轮询间隔（在此间隔后，发布者将执行pinging操作，而作者将执行拉取更改操作），以便在发布者之间同步更改。

作者每30秒轮询发布者（默认）。 如果文件夹中存在任何包 /var/sling/distribution/packages/ socialpubsync - vlt /shared，然后它会获取这些包并将其安装在其他发布服务器上。

更改轮询间隔：

  1. 使用管理员权限登录到AEM创作实例。

  2. 访问 Web控制台例如， https://localhost:4502/system/console/configMgr

  3. 查找 Apache Sling Distribution Trigger — 计划触发器工厂

    • 选择要打开的现有配置以进行编辑（铅笔图标）。

      验证 socialpubsync -scheduled-trigger

    • 将“Interval in Seconds（间隔）”设置为所需的间隔，然后保存。

    scheduled-trigger

AEM Communities用户同步侦听器

对于在Sling分发中订阅和所关注内容不一致的问题，请检查以下属性是否位于 AEM Communities用户同步侦听器 已设置配置：

  • 节点类型
  • 可忽略的属性
  • 可忽略节点
  • 分布式文件夹

同步订阅、关注和通知

在每个AEM发布实例上：

  1. 使用管理员权限登录。

  2. 访问 Web控制台. 例如， https://localhost:4503/system/console/configMgr.

  3. 查找 AEM Communities用户同步侦听器.

  4. 选择要打开的现有配置以进行编辑（铅笔图标）

    验证名称： socialpubsync -scheduled-trigger

  5. 设置以下内容 节点类型：

    rep:User

    nt:unstructured

    nt:resource

    rep:ACL

    sling:Folder

    sling:OrderedFolder

    此属性中指定的节点类型将同步，并且通知信息（遵循的博客和配置）在不同发布者之间同步。

  6. 添加要同步的所有文件夹 分布式文件夹. 例如，

    segments/scoring

    social/relationships

    activities

  7. 设置 ignorablenodes 到：

    .tokens

    system

    rep:cache （由于我们使用粘性会话，因此不需要将此节点同步到不同的发布者）。

    user-sync-listner

唯一Sling ID

AEM创作实例使用Sling ID来识别数据的来源以及需要（或不需要）将包发送回的发布者。

确保发布场中的所有发布者都具有唯一的Sling ID。 如果发布场中的多个发布实例的Sling ID相同，则用户同步将失败。 由于作者不知道从何处获取软件包，也不知道在何处安装软件包。

要确保发布场中发布者的唯一Sling ID，请在每个发布实例上：

  1. 浏览到 https://host：port/system/console/status-slingsettings.

  2. 检查值 Sling ID.

    slingid

    如果发布实例的Sling ID与任何其他发布实例的Sling ID匹配，则：

  3. 停止具有匹配Sling ID的其中一个发布实例。

  4. 在 crx-quickstart/launchpad/felix 目录，搜索并删除名为的文件 sling.id.file.

    例如，在Linux系统上：

    rm -i $(find . -type f -name sling.id.file)

    例如，在Windows系统上：

    使用Windows资源管理器并搜索 sling.id.file

  5. 启动发布实例。 启动时，将为它分配一个新的Sling ID。

  6. 验证 Sling ID 现在是唯一的。

重复这些步骤，直到所有发布实例都具有唯一的Sling ID。

保险库包生成器工厂

要使更新正确同步，需要修改用于用户同步的Vault包生成器。
In /home/users， a */rep:cache 节点已创建。 它是一种缓存，用来发现如果我们查询节点的主体名称，则可以直接使用此缓存。

在以下情况下，可以停止用户同步： rep :cache 节点在发布者之间同步。

要确保更新在发布者之间正确同步，请在每个AEM发布实例上：

  1. 访问 Web控制台

    例如， https://localhost:4503/system/console/configMgr.

  2. 找到 Apache Sling分发打包 — Vault Package Builder Factory

    生成器名称：socialpubsync-vlt。

  3. 选择编辑图标。

  4. 添加两个包节点筛选器：

    • /home/users|-.*/.tokens
    • /home/users|-.*/rep:cache

  5. 策略处理

    • 要使用新节点覆盖现有rep ：policy节点，请添加第三个包过滤器： /home/users|+.*/rep:policy
    • 要防止策略被分发，请设置： Acl Handling: IGNORE

    Vault包生成器工厂

AEM Communities中的Sling分发疑难解答

如果Sling分发失败，请尝试以下调试步骤：

  1. 检查 未正确添加配置

    确保未添加或编辑多个配置，而是应编辑现有的默认配置。

  2. 检查配置

    确保所有 配置 已在AEM创作实例中正确设置，如中所述 最佳实践.

  3. 检查授权用户权限

    如果软件包安装不正确，请检查 授权用户 在第一个发布实例中创建的，具有正确的ACL。

    要验证此内容，而不是 已创建授权用户 更改 AdobeGranite分发 — 加密的密码传输密钥提供程序 使用管理员用户凭据的创作实例配置。 现在，请尝试再次安装包。 如果用户同步与管理员凭据配合使用，则意味着创建的发布用户没有适当的ACL。

  4. 检查Diff Observer Factory配置

    如果仅特定节点未跨发布场同步（例如，组成员未同步），则应确保 AdobeGranite分发 — 观察者工厂差异 配置已启用，并且 rep：成员 在中设置 查找的属性名称.

  5. 检查AEM Communities用户同步侦听器配置。 如果创建的用户已同步，但订阅和以下订阅不起作用，请确保AEM Communities用户同步侦听器配置具有：

    • 节点类型 — 设置为 rep：User， nt：unstructured， nt ：resource， rep：ACL， sling：Folder、和 sling：OrderedFolder.
    • 可忽略的节点 — 设置为 .tokens， 系统、和 rep ：cache.
    • 分布式文件夹 — 设置为要分发的文件夹。

  6. 检查在发布实例上创建用户时生成的日志

    如果上述配置已正确设置，但用户同步不起作用，请检查创建用户时生成的日志。

    检查日志的顺序是否相同，如下所示：

    15.05.2016 18:33:01.523 *INFO* [sling-oak-observation-7422] com.adobe.cq.social.sync.impl.PublisherSyncServiceImpl Handing these paths to the distribution subsystem: [/home/users/C, /home/users/C/Cw-5avWqilmqsNn5hCvK]
15.05.2016 18:33:01.523 *INFO* [sling-oak-observation-7422] org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync-reverse] REQUEST-START DSTRQ2: ADD paths=[/home/users/C, /home/users/C/Cw-5avWqilmqsNn5hCvK], user=communities-user-admin
15.05.2016 18:33:01.523 *INFO* [sling-oak-observation-7431] com.adobe.cq.social.sync.impl.PublisherSyncServiceImpl Handing these paths to the distribution subsystem: [/home/users/C/Cw-5avWqilmqsNn5hCvK, /home/users/C/Cw-5avWqilmqsNn5hCvK/profile, /home/users/C/Cw-5avWqilmqsNn5hCvK/rep:policy]
15.05.2016 18:33:01.523 *INFO* [sling-oak-observation-7431] org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync-reverse] REQUEST-START DSTRQ3: ADD paths=[/home/users/C/Cw-5avWqilmqsNn5hCvK, /home/users/C/Cw-5avWqilmqsNn5hCvK/profile, /home/users/C/Cw-5avWqilmqsNn5hCvK/rep:policy], user=communities-user-admin
15.05.2016 18:33:01.757 *INFO* [sling-oak-observation-7431] org.apache.jackrabbit.vault.packaging.impl.JcrPackageDefinitionImpl unwrapping package sling/distribution:socialpubsync-vlt_1463337181554_ebb27ad9-a861-4405-9342-d64c916654e2:0.0.1
15.05.2016 18:33:01.820 *INFO* [sling-oak-observation-7422] org.apache.jackrabbit.vault.packaging.impl.JcrPackageDefinitionImpl unwrapping package sling/distribution:socialpubsync-vlt_1463337181554_58811273-5861-48fe-95d2-4aff367b99c3:0.0.1
15.05.2016 18:33:02.023 *INFO* [sling-oak-observation-7430] com.adobe.cq.social.sync.impl.PublisherSyncServiceImpl Handing these paths to the distribution subsystem: [/home/users/C/Cw-5avWqilmqsNn5hCvK/profile]
15.05.2016 18:33:02.023 *INFO* [sling-oak-observation-7430] org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync-reverse] REQUEST-START DSTRQ4: ADD paths=[/home/users/C/Cw-5avWqilmqsNn5hCvK/profile], user=communities-user-admin
15.05.2016 18:33:02.273 *INFO* [sling-oak-observation-7430] org.apache.jackrabbit.vault.packaging.impl.JcrPackageDefinitionImpl unwrapping package sling/distribution:socialpubsync-vlt_1463337182039_f34f4fa6-10b9-42eb-8740-4da9d4d38f99:0.0.1

要调试，请执行以下操作：

  1. 禁用用户同步：

  2. 在AEM创作实例上，使用管理员权限登录。

    1. 访问 Web控制台. 例如， https://localhost:4502/system/console/configMgr.

    2. 找到配置 Apache Sling分发代理 — 同步代理工厂.

    3. 取消选择 已启用 复选框。

      在创作实例上禁用用户同步时，（导出器和导入器）端点被禁用，并且创作实例是静态的。 此 vlt 作者不会ping或获取包。

      现在，如果在发布实例上创建用户，则 vlt 包创建于 /var/sling/distribution/packages/ socialpubsync - vlt /data 节点。 以及作者是否将这些包推送到其他服务。 您可以下载并提取此数据，以检查哪些所有属性都推送到其他服务。

  3. 转到发布者，并在发布者上创建用户。 因此，会创建事件。

  4. 查看 日志的顺序，创建用户时创建。

  5. 检查是否 vlt 包创建于 /var/sling/distribution/packages/socialpubsync-vlt/data.

  6. 现在，在AEM创作实例上启用用户同步。

  7. 在发布服务器上，更改中的导出程序或导入程序端点 Apache Sling分发代理 — 同步代理工厂.
    我们可以下载并提取包数据，以检查哪些所有属性都推送到其他发布者，以及哪些数据丢失。

在此页面上