DocumentationAEM 6.4Guide de Communities

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

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

Créé pour :

  • Admin
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Présentation introduction

Dans AEM Communities, depuis l’environnement de publication (en fonction des autorisations configurées), visiteurs du site peut devenir members, créez groupes d’utilisateurs, puis modifiez leurs profil du membre.

Données utilisateur est un terme utilisé pour faire référence à utilisateurs, profils utilisateur et groupes d’utilisateurs.

Membres est un terme utilisé pour faire référence à utilisateurs enregistrés dans l’environnement de publication, par opposition aux utilisateurs enregistrés dans l’environnement de création.

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

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

Par conception, les données utilisateur créées dans l’environnement de publication 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 de publication.

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

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

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

Pour obtenir des instructions détaillées, détaillées sur la manière d’activer la synchronisation sur une ferme de publication, voir

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

sling-dist-workflow

  • Package VLT: est 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: contient les informations de distribution pour Sling. Il s’agit d’informations sur l’endroit où le contenu doit être distribué et le moment où il a été distribué en dernier.

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

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

Lorsqu’un site communautaire est publié à partir de la variable Console Sites Communities, l’effet est répliquer Les pages associées et Sling distribuent les groupes d’utilisateurs de la communauté créés dynamiquement, y compris leur adhésion.

L’utilisateur est créé ou modifie le profil lors de la publication. user-is-created-or-edits-profile-on-publish

Par conception, les utilisateurs et les profils créés dans l’environnement de publication (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és est créé lors de la publication. new-community-group-is-created-on-publish

Bien qu’elle soit lancée à partir d’une instance de publication, la création de 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 de publication. Le groupe d’utilisateurs de la communauté créé dynamiquement et ses membres sont Sling distribués à toutes les instances de publication.

La création d’utilisateurs ou de groupes d’utilisateurs 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 vice versa.

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 sur d’autres instances de publication, si nécessaire. La synchronisation des utilisateurs synchronise également les groupes d’utilisateurs créés via la console de sécurité.

L’utilisateur publie du contenu lors de la publication 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 le SRP configuré.

Bonnes pratiques bestpractices

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

La synchronisation des utilisateurs repose 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 en mode 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 les 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 présents et où synchroniser toutes les informations.

Les valeurs par défaut de la configuration concernent une seule instance de publication. Comme la synchronisation des utilisateurs est utile pour synchroniser plusieurs instances de publication, comme pour une ferme de publication, des instances de publication supplémentaires 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 à partir de ses points de terminaison d’exportateur et Diffuse le contenu aux 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

Sur l’instance d’auteur AEM :

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

  2. Accédez au Console web.

    Par exemple : http://localhost:4502/system/console/configMgr.

  3. Localiser 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électionner Utilisation de files d’attente multiples.

    • Spécifier Points de fin de l’exportateur et Points de terminaison de l’importateur (vous pouvez ajouter d’autres points de fin d’exportateur et d’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.

Le 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é dispose de toutes les conditions requises. ACL.

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 à des éditeurs à l’aide d’un utilisateur autorisé

Sur l’instance d’auteur AEM :

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

  2. Accédez au Console web.

    Par exemple : http://localhost:4502/system/console/configMgr.

  3. Localiser Distribution Granite des Adobes - 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érifier la propriété name: socialpubsync- publishUser .

  5. Définissez le nom d’utilisateur et le mot de passe sur la variable 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 des données sont créées/mises à jour dans les chemins spécifiés dans Racines autorisées, "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

Sur AEM instance de publication :

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

  2. Accédez au Console web.

    Par exemple : http://localhost:4503/system/console/configMgr.

  3. Localiser 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. Sélectionnez la Activé et enregistrez.

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

  7. Répétez pour chaque publish instance.

    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é à noms des propriétés look.

Pour garantir la synchronisation des membres

Sur chaque instance de publication AEM :

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

  2. Accédez au Console web.

    Par exemple : http://localhost:4503/system/console/configMgr.

  3. Localiser Distribution Granite des Adobes - Fabrique observateur diff.

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

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

  5. Cochez la case Activé.

  6. Spécifier rep:members as description pour propertyName dans noms des propriétés look et enregistrez.

    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 modules sont présents dans le dossier /var/sling/distribution/packages/socialpubsync - vlt /shared, il récupérera ces modules et les installera sur d’autres éditeurs.

Pour modifier l’intervalle d’interrogation

Sur l’instance d’auteur AEM :

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

  2. Accédez au Console web, par exemple : http://localhost:4502/system/console/configMgr

  3. Localiser 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érifier Name: 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 Écouteur de synchronisation des utilisateurs AEM Communities les configurations 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 au Console web. Par exemple : http://localhost:4503/system/console/configMgr.

  3. Localiser É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 :

    rep:User

    nt : non structuré

    nt :ressource

    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/notation

    social/relations

    activities

  7. Définissez le niveau du journal ignorablenodes sur:

    .jetons

    system

    rep :cache (puisque nous utilisons des sessions persistantes, nous n’avons 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 de publication :

  1. Accédez à https://hôte: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 de publication ayant un identifiant Sling correspondant.

  4. Dans le 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 :

    use windows explorer and search for _sling.id.file_

  5. Démarrez l’instance de publication. Au démarrage, un nouvel identifiant Sling lui sera attribué.

  6. Validez que la variable Sling ID 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 module 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 /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 Les noeuds sont synchronisés entre les éditeurs.

Pour s’assurer que les mises à jour sont correctement synchronisées entre les éditeurs

Sur chaque instance de publication AEM :

  1. Accédez au Console web, par exemple : http://localhost:4503/system/console/configMgr.

  2. Recherchez la variable Module de distribution Apache Sling - Nom du Créateur d’usine Vault Package Builder: socialpubsync-vlt.

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

  4. Ajoutez deux filtres de module :

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

  5. Gestion des stratégies

    • Pour remplacer une réplication existante :policy Ajoutez un troisième filtre de module avec les nouveaux noeuds :

      /home/users|**+**.\*/rep:policy

    • Pour empêcher la distribution des stratégies, définissez

      Gestion De L’Acl : IGNORER

vault-package-builder-factory

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. Rechercher des configurations mal ajoutées. 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érifier les configurations. Assurez-vous que tous les configurations sont correctement définis dans votre instance d’auteur AEM, comme indiqué dans la section Bonnes pratiques.

  3. Vérifier les autorisations d’utilisateur autorisées. Si les packages ne sont pas installés correctement, vérifiez que la variable utilisateur autorisé créé dans la première instance de publication comporte les listes ACL correctes.

    Pour valider cette opération, au lieu de la variable utilisateur autorisé créé modifier la variable Distribution Granite des Adobes - Fournisseur secret de transport de mot de passe chiffré configuration sur l’instance d’auteur pour utiliser les informations d’identification de l’utilisateur administrateur. Maintenant, essayez de ré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 variable Distribution Granite des Adobes - Fabrique observateur diff la configuration est activée et rep:members sont définis dans noms des propriétés look.

  5. Vérifiez la configuration du récepteur 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 du récepteur de synchronisation des utilisateurs d’AEM Communities dispose des éléments suivants :

    • Types de noeud 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 de publication. 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 au Console web. Par exemple : http://localhost:4502/system/console/configMgr.

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

      3. Désélectionnez l’option Activé .

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

      Désormais, si un utilisateur est créé sur l’instance de publication, la variable vlt Le module est créé dans /var/sling/distribution/packages/socialpubsync - vlt /data noeud . 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 les ordre des logs, créé lors de la création de l’utilisateur.

    5. Vérifiez si la variable vlt le module est créé lors de la /var/sling/distribution/packages/socialpubsync-vlt/data.

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

    7. Sur l’éditeur, modifiez les points de fin de l’exportateur ou de l’importateur dans Agent de distribution Apache Sling - Fabrique d’agents de synchronisation.

      Nous pouvons télécharger et extraire des données de package pour vérifier toutes les propriétés qui sont transmises à d’autres éditeurs et quelles données sont perdues.

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6