DocumentationAEM 6.5Guide de Communities

Synchronisation des utilisateurs des communautés communities-user-synchronization

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration

Présentation introduction

Dans Adobe Experience Manager (AEM) Communities, dans l’environnement Publish (en fonction des autorisations configurées), les visiteurs du site peuvent devenir membres, créer des groupes d’utilisateurs et modifier leur profil de membre} .

Les données utilisateur font référence à users, user profiles et user groups.

Les membres font référence à utilisateurs enregistrés dans l’environnement Publish, par opposition aux utilisateurs enregistrés dans l’environnement de création.

Pour plus d’informations sur les données utilisateur, consultez la page Gestion des utilisateurs et des groupes d’utilisateurs.

Synchronisation des utilisateurs sur une ferme de serveurs Publish synchronizing-users-across-a-publish-farm

Par conception, les données utilisateur créées dans l’environnement Publish n’apparaissent pas dans l’environnement de création.

La plupart des données utilisateur créées dans l’environnement de création sont destinées à rester dans l’environnement de création et ne sont ni synchronisées ni répliquées vers les instances Publish.

Lorsque la topologie est une ferme de publication, l’enregistrement et les modifications effectués sur une instance Publish doivent être synchronisés avec d’autres instances Publish. Les membres doivent pouvoir se connecter et voir leurs données sur n’importe quel noeud Publish.

Lorsque la synchronisation des utilisateurs est activée, les données utilisateur sont automatiquement synchronisées entre les instances Publish dans la ferme de serveurs.

Instructions de configuration de la synchronisation des utilisateurs user-sync-setup-instructions

Pour obtenir des instructions détaillées et détaillées sur l’activation de la synchronisation sur une ferme de publication, voir Synchronisation des utilisateurs.

Synchronisation des utilisateurs en arrière-plan user-sync-in-the-background

sling-dist-workflow

  • module vlt

    Il s’agit d’un fichier zip de toutes les modifications apportées à un éditeur, qui doit être distribué entre les éditeurs. Les modifications sur un éditeur génèrent des événements qui sont sélectionnés par l’écouteur d’événement change. Cela crée un module vlt contenant toutes les modifications.

  • package de distribution

    Il contient des informations de distribution pour Sling. Il s’agit d’informations sur l’endroit où le contenu doit être distribué et la date de sa dernière distribution.

Que se passe-t-il lorsque… what-happens-when

Site Publish à partir de la console Sites des communautés publish-site-from-communities-sites-console

Sur l’auteur, lorsqu’un site de communauté est publié à partir de la console Sites de communautés, l’effet est de répliquer les pages associées, et Sling distribue les groupes d’utilisateurs de communauté créés dynamiquement, y compris leur appartenance.

L’utilisateur est créé ou modifie le profil sur Publish user-is-created-or-edits-profile-on-publish

Par conception, les utilisateurs et les profils créés dans l’environnement Publish (par exemple par auto-inscription, connexion sociale, authentification LDAP) n’apparaissent pas dans l’environnement de création.

Lorsque la topologie consiste en une batterie de publication et que la synchronisation des utilisateurs a été correctement configurée, l’utilisateur et le profil utilisateur sont synchronisés dans la batterie de publication à l’aide de la distribution Sling.

Un nouveau groupe de communauté est créé sur Publish new-community-group-is-created-on-publish

Bien qu’elle ait été lancée à partir d’une instance Publish, la création d’un groupe de communautés, qui entraîne la création de pages de site et d’un nouveau groupe d’utilisateurs, a lieu dans les faits sur l’instance d’auteur.

Dans le cadre du processus, les nouvelles pages du site sont répliquées vers toutes les instances Publish. Le groupe d’utilisateurs de la communauté créé dynamiquement et ses membres sont Sling distribués à toutes les instances Publish.

La création d’utilisateurs et d’utilisatrices ou de groupes d’utilisateurs et d’utilisatrices s’effectue dans la console de sécurité. users-or-user-groups-are-created-using-security-console

Par conception, les données utilisateur créées dans l’environnement de publication n’apparaissent pas dans l’environnement de création et inversement.

Lorsque la console Administration et sécurité des utilisateurs est utilisée pour ajouter de nouveaux utilisateurs dans l’environnement de publication, la synchronisation des utilisateurs synchronise les nouveaux utilisateurs et leur appartenance à un groupe avec d’autres instances de publication, si nécessaire. La synchronisation des utilisateurs et des utilisatrices synchronise également les groupes d’utilisateurs et d’utilisatrices créés via la console de sécurité.

Contenu des publications d’utilisateurs sur Publish user-posts-content-on-publish

Pour le contenu généré par l’utilisateur, les données saisies sur une instance de publication sont accessibles via la SRP configurée.

Bonnes pratiques bestpractices

Par défaut, la synchronisation des utilisateurs est disabled. L’activation de la synchronisation des utilisateurs implique de modifier les configurations OSGi existantes. Aucune nouvelle configuration ne doit être ajoutée suite à l’activation de la synchronisation des utilisateurs et utilisatrices.

La synchronisation des utilisateurs s’appuie sur l’environnement de création pour gérer les distributions de données utilisateur, même si les données utilisateur ne sont pas créées sur l’instance de création.

Conditions préalables

  1. Si les utilisateurs et les groupes d’utilisateurs ont déjà été créés sur un éditeur, il est recommandé de synchroniser manuellement les données utilisateur sur tous les éditeurs avant de configurer et d’activer la synchronisation des utilisateurs.

    Une fois la synchronisation des utilisateurs activée, seuls les utilisateurs et groupes nouvellement créés sont synchronisés .

  2. Assurez-vous que la dernière version du code a été installée :

Les paramétrages suivants sont nécessaires pour permettre la synchronisation des utilisateurs sur AEM Communities. Assurez-vous que ces configurations sont correctes pour empêcher l’échec de la distribution de contenu sling.

Agent de distribution Apache Sling - Fabrique d’agents de synchronisation apache-sling-distribution-agent-sync-agents-factory

Cette configuration récupère le contenu à synchroniser dans les éditeurs. La configuration se trouve sur l’instance d’auteur . L’auteur doit effectuer le suivi de tous les éditeurs qui sont là et où synchroniser toutes les informations.

Les valeurs par défaut de la configuration concernent une seule instance de publication. La synchronisation des utilisateurs s’avère utile pour synchroniser plusieurs instances de publication, comme pour une ferme de publication, d’autres instances de publication doivent être ajoutées à la configuration.

Comment le contenu est-il synchronisé ?

L’instance d’auteur envoie un ping au point de terminaison de l’exportateur des éditeurs. Chaque fois qu’un utilisateur est créé ou mis à jour sur des éditeurs spécifiques (n), l’auteur obtient le contenu de ses points de terminaison d’exportateur et envoie le contenu à d’autres éditeurs (n-1, à l’exception des éditeurs à partir desquels le contenu est récupéré).

Pour configurer la configuration des agents de synchronisation Apache Sling :

  1. Connectez-vous avec les privilèges d’administrateur sur votre instance d’auteur AEM.

  2. Accédez à la console web. Par exemple, https://localhost:4502/system/console/configMgr.

  3. Localisez Agent de distribution Apache Sling - Fabrique d’agents de synchronisation.

    • Sélectionnez la configuration existante à ouvrir pour modification (icône représentant un crayon).

      Vérifiez le nom : socialpubsync.

    • Cochez la case Activé.

    • Sélectionnez Utiliser plusieurs files d’attente.

    • Spécifiez les points de terminaison de l’exportateur et points de terminaison de l’importateur (vous pouvez ajouter d’autres points de terminaison de l’exportateur et de l’importateur).

      Ces points de terminaison définissent l’emplacement d’où vous souhaitez obtenir le contenu et l’emplacement où vous souhaitez pousser le contenu. L’auteur récupère le contenu à partir du point de terminaison de l’exportateur spécifié et envoie le contenu aux éditeurs (autres que l’éditeur à partir duquel il a récupéré le contenu).

    sync-agent-fact

Distribution Granite des Adobes - Fournisseur secret de transport de mot de passe chiffré adobe-granite-distribution-encrypted-password-transport-secret-provider

Il permet à l’auteur d’identifier l’utilisateur autorisé, comme ayant l’autorisation de synchroniser les données utilisateur de l’auteur à la publication.

L’ utilisateur autorisé créésur toutes les instances de publication aide les éditeurs à se connecter à l’auteur et à configurer la distribution Sling sur l’auteur. Cet utilisateur autorisé possède toutes les listes de contrôle d’accès requises.

Chaque fois que des données doivent être installées ou récupérées auprès des éditeurs, l’auteur se connecte aux éditeurs à l’aide des informations d’identification (nom d’utilisateur et mot de passe) définies dans cette configuration.

Pour connecter l’auteur aux éditeurs à l’aide d’un utilisateur autorisé :

  1. Connectez-vous avec les privilèges d’administrateur sur votre instance d’auteur AEM.

  2. Accédez à la console web.

    Par exemple, https://localhost:4502/system/console/configMgr.

  3. Localisez Distribution Granite Adobe - Fournisseur secret de transport de mot de passe chiffré.

  4. Sélectionnez la configuration existante à ouvrir pour modification (icône représentant un crayon).

    Vérifiez la propriété socialpubsync - publishUser.

  5. Définissez le nom d’utilisateur et le mot de passe sur l’ utilisateur autorisé.

    Par exemple, usersync - admin

granite-pasword-trans

Agent de distribution Apache Sling - Fabrique d’agents de file d’attente apache-sling-distribution-agent-queue-agents-factory

Cette configuration est utilisée pour configurer les données que vous souhaitez synchroniser entre les éditeurs. Lorsque les données sont créées/mises à jour dans les chemins spécifiés dans Allowed Roots, "var/community/distribution/diff" est activé et le réplicateur créé récupère les données d’un éditeur et les installe sur d’autres éditeurs.

Pour configurer les données (chemins d’accès aux noeuds) à synchroniser :

  1. Connectez-vous avec les privilèges d’administrateur sur votre instance de publication.

  2. Accédez à la console web.

    Par exemple, https://localhost:4503/system/console/configMgr.

  3. Localisez Agent de distribution Apache Sling - Fabrique d’agents de file d’attente.

  4. Sélectionnez la configuration existante à ouvrir pour modification (icône représentant un crayon).

    Vérifiez le nom : socialpubsync -reverse

  5. Cochez la case Enabled et enregistrez.

  6. Spécifiez les chemins d’accès aux noeuds à répliquer dans Racines autorisées.

  7. Répétez cette opération pour chaque instance publish.

    queue-agents-fact

Distribution Granite des Adobes - Fabrique observateur diff adobe-granite-distribution-diff-observer-factory

Cette configuration synchronise l’appartenance des groupes entre les éditeurs.
Si la modification de l’appartenance d’un groupe dans un éditeur ne met pas à jour son appartenance sur d’autres éditeurs, assurez-vous que ref:members est ajouté à look properties names.

Pour garantir la synchronisation des membres :

  1. Connectez-vous avec les privilèges d’administrateur sur votre instance de publication.

  2. Accédez à la console web.

    Par exemple, https://localhost:4503/system/console/configMgr.

  3. Recherchez Adobe Granite Distribution - Diff Observer Factory.

  4. Sélectionnez la configuration existante à ouvrir pour modification (icône représentant un crayon).

    Vérifiez nom de l’agent : socialpubsync -reverse.

  5. Cochez la case Activé.

  6. Spécifiez rep:members comme description pour propertyName dans noms de propriétés et Enregistrer.

    diff-obs

Déclencheur de distribution Apache Sling - Fabrique de déclencheurs planifiés apache-sling-distribution-trigger-scheduled-triggers-factory

Cette configuration vous permet de configurer l’intervalle d’interrogation (au-delà duquel les éditeurs sont ingérés et les modifications sont extraites par l’auteur) pour synchroniser les modifications entre les éditeurs.

L’auteur interroge les éditeurs toutes les 30 secondes (par défaut). Si des packages sont présents dans le dossier /var/sling/distribution/packages/ socialpubsync - vlt /shared, ils sont récupérés et installés sur d’autres éditeurs.

Pour modifier l’intervalle d’interrogation :

  1. Connectez-vous avec les privilèges d’administrateur sur votre instance d’auteur AEM.

  2. Accédez à la console web, par exemple https://localhost:4502/system/console/configMgr

  3. Localisez Déclencheur de distribution Apache Sling - Fabrique de déclencheurs planifiés

    • Sélectionnez la configuration existante à ouvrir pour modification (icône représentant un crayon).

      Vérifiez socialpubsync -scheduled-trigger

    • Définissez l’intervalle en secondes sur l’intervalle souhaité, puis enregistrez.

    scheduled-trigger

Écouteur de synchronisation des utilisateurs AEM Communities aem-communities-user-sync-listener

Pour les problèmes de distribution Sling où il y a une incohérence dans les abonnements et les suivants, vérifiez si les propriétés suivantes dans les configurations Écouteur de synchronisation des utilisateurs AEM Communities sont définies :

  • NodeTypes
  • IgnorableProperties
  • IgnorableNodes
  • DistributedFolders

Pour synchroniser les abonnements, les informations suivantes et les notifications

Sur chaque instance de publication AEM :

  1. Connectez-vous avec les privilèges d’administrateur.

  2. Accédez à la console web. Par exemple, https://localhost:4503/system/console/configMgr.

  3. Recherchez Écouteur de synchronisation des utilisateurs AEM Communities.

  4. Sélectionnez la configuration existante à ouvrir pour modification (icône représentant un crayon).

    Vérifiez le nom : socialpubsync -scheduled-trigger

  5. Définissez les NodeTypes suivants :

    rep:User

    nt:unstructured

    nt:resource

    rep:ACL

    sling:Folder

    sling:OrderedFolder

    Les types de noeuds spécifiés dans cette propriété se synchronisent et les informations de notification (blogs et configurations suivis) sont synchronisées entre les différents éditeurs.

  6. Ajoutez tous les dossiers à synchroniser dans DistributedFolders. Par exemple :

    segments/scoring

    social/relationships

    activities

  7. Définissez ignorablenodes sur :

    .tokens

    system

    rep:cache (comme les sessions persistantes sont utilisées, vous n’avez pas besoin de synchroniser ce noeud avec différents éditeurs).

    user-sync-listner

Identifiant Sling unique unique-sling-id

AEM instance d’auteur utilise l’identifiant Sling pour identifier à partir de quel endroit les données arrivent et vers quels éditeurs elle doit (ou ne doit pas) renvoyer le module.

Assurez-vous que tous les éditeurs d’une ferme de publication possèdent un identifiant Sling unique. Si l’identifiant Sling est le même pour plusieurs instances de publication dans une ferme de publication, la synchronisation des utilisateurs échoue. Comme l’auteur ne sait pas où récupérer le module et où l’installer.

Pour garantir un identifiant Sling unique des éditeurs dans la ferme de publication, sur chaque instance Publish :

  1. Accédez à https://host:port/system/console/status-slingsettings.

  2. Vérifiez la valeur de Sling ID.

    slingid

    Si l’identifiant Sling d’une instance de publication correspond à l’identifiant Sling d’une autre instance de publication, alors :

  3. Arrêtez l’une des instances Publish ayant un identifiant Sling correspondant.

  4. Dans le répertoire crx-quickstart/launchpad/felix, recherchez et supprimez le fichier nommé sling.id.file.

    Par exemple, sur un système Linux :

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

    Par exemple, sur un système Windows :

    Utilisation de l’explorateur Windows et recherche pour sling.id.file

  5. Démarrez l’instance Publish. Au démarrage, un nouvel identifiant Sling lui est attribué.

  6. Vérifiez que l’ identifiant Sling est désormais unique.

Répétez ces étapes jusqu’à ce que toutes les instances de publication aient un identifiant Sling unique.

Fabrique de générateur de package vault vault-package-builder-factory

Pour que les mises à jour soient correctement synchronisées, il est nécessaire de modifier le créateur de modules Vault pour la synchronisation des utilisateurs.
Dans /home/users, un noeud */rep:cache est créé. Il s’agit d’un cache qui permet de trouver que si nous effectuons une requête sur le nom principal d’un noeud, ce cache peut être utilisé directement.

La synchronisation des utilisateurs peut s’arrêter si rep :cache noeuds sont synchronisés entre les éditeurs.

Pour vous assurer que les mises à jour sont correctement synchronisées entre les éditeurs, sur chaque instance Publish AEM :

  1. Accédez à la console web

    Par exemple, https://localhost:4503/system/console/configMgr.

  2. Localisez le Module de distribution Apache Sling - Fabrique Vault Package Builder

    Nom du créateur : socialpubsync-vlt.

  3. Sélectionnez l’icône de modification.

  4. Ajoutez deux filtres de noeuds de module :

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

  5. Gestion des stratégies

    • Pour remplacer les noeuds rep:policy existants par de nouveaux noeuds, ajoutez un troisième filtre de package : /home/users|+.*/rep:policy
    • Pour empêcher la distribution des stratégies, définissez : Acl Handling: IGNORE

    Fabrique du générateur de package Vault

Résolution des problèmes de distribution Sling dans AEM Communities troubleshoot-sling-distribution-in-aem-communities

Si la distribution Sling échoue, essayez les étapes de débogage suivantes :

  1. Vérifiez les configurations ajoutées de manière incorrecte

    Assurez-vous que plusieurs configurations ne sont pas ajoutées ni modifiées. Les configurations par défaut existantes doivent être modifiées.

  2. Vérifiez les configurations

    Assurez-vous que toutes les configurations sont correctement définies dans votre instance d’auteur AEM, comme indiqué dans la section Bonnes pratiques.

  3. Vérifier les autorisations d’utilisateurs autorisés

    Si les packages ne sont pas installés correctement, vérifiez que l’ utilisateur autorisé créé dans la première instance Publish dispose des listes de contrôle d’accès correctes.

    Pour le valider, au lieu de la configuration created authorized user, modifiez la configuration Adobe Granite Distribution - Encrypted Password Transport Secret Provider sur l’instance d’auteur afin d’utiliser les informations d’identification d’utilisateur administrateur. Maintenant, essayez à nouveau d’installer les packages. Si la synchronisation de l’utilisateur fonctionne correctement avec les informations d’identification de l’administrateur, cela signifie que l’utilisateur de publication créé ne disposait pas des listes de contrôle d’accès appropriées.

  4. Vérification de la configuration de l’usine Diff Observer

    Si seuls des noeuds spécifiques ne sont pas synchronisés dans la ferme de publication (par exemple, les membres du groupe ne sont pas synchronisés), assurez-vous que la configuration Distribution Granite par Adobe - Fabrique d’observateurs diff est activée et que rep: members est défini dans noms de propriétés regardées.

  5. Vérifiez la configuration de l’écouteur de synchronisation des utilisateurs AEM Communities. Si les utilisateurs créés sont synchronisés mais que les abonnements et les suivants ne fonctionnent pas, assurez-vous que la configuration de l’écouteur de synchronisation des utilisateurs AEM Communities dispose des éléments suivants :

    • Types de noeuds : définis sur rep:User, nt:unstructured, nt:resource, rep:ACL, sling:Folder et sling:OrderedFolder.
    • Noeuds ignorables : définis sur .tokens, system et rep:cache.
    • Dossiers distribués : définis sur les dossiers à répartir.

  6. Vérifier les journaux générés lors de la création de l’utilisateur sur l’instance Publish

    Si les configurations ci-dessus sont correctement définies et que la synchronisation des utilisateurs ne fonctionne pas, vérifiez les journaux générés lors de la création de l’utilisateur.

    Vérifiez si l’ordre des logs est le même, comme suit :

    code language-shell 
    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

Pour déboguer :

  1. Désactivez la synchronisation des utilisateurs :

  2. Sur AEM instance d’auteur, connectez-vous avec les privilèges d’administrateur.

    1. Accédez à la console web. Par exemple, https://localhost:4502/system/console/configMgr.

    2. Recherchez la configuration Agent de distribution Apache Sling - Fabrique d’agents de synchronisation.

    3. Décochez la case Enabled .

      Lors de la désactivation de la synchronisation des utilisateurs sur l’instance d’auteur (exportateur et importateur), les points de terminaison sont désactivés et l’instance d’auteur est statique. Les packages vlt ne sont ni ingérés ni récupérés par l’auteur.

      Désormais, si un utilisateur est créé sur l’instance de publication, le package vlt est créé dans le noeud /var/sling/distribution/packages/ socialpubsync - vlt /data . Et si ces modules sont transmis par l’auteur à un autre service. Vous pouvez télécharger et extraire ces données pour vérifier toutes les propriétés qui sont transmises à d’autres services.

  3. Accédez à un éditeur et créez un utilisateur sur l’éditeur. Par conséquent, des événements sont créés.

  4. Vérifiez l’ ordre des journaux créés lors de la création de l’utilisateur.

  5. Vérifiez si un package vlt est créé sur /var/sling/distribution/packages/socialpubsync-vlt/data.

  6. Maintenant, activez la synchronisation des utilisateurs sur l’instance d’auteur AEM.

  7. Sur l’éditeur, modifiez les points de terminaison de l’exportateur ou de l’importateur dans Apache Sling Distribution Agent - Sync Agents Factory.
    Nous pouvons télécharger et extraire des données de module pour vérifier toutes les propriétés transmises à d’autres éditeurs et les données qui sont perdues.

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791