Show Menu
ARGOMENTI×

Sincronizzazione utenti community

Introduzione

In AEM Communities, dall’ambiente di pubblicazione (in base alle autorizzazioni configurate), i visitatori del sito possono diventare membri , creare gruppi di utenti e modificare il profilo del membro.
I dati utente sono termini utilizzati per fare riferimento a utenti , profili ** utente e gruppi di utenti.
Membri è un termine utilizzato per fare riferimento agli utenti registrati nell’ambiente di pubblicazione, anziché agli utenti registrati nell’ambiente di authoring.
Per ulteriori informazioni sui dati utente, visita Gestione di utenti e gruppi di utenti.

Sincronizzazione degli utenti in una farm di pubblicazione

Per impostazione predefinita, i dati utente creati nell’ambiente di pubblicazione non vengono visualizzati nell’ambiente di authoring.
La maggior parte dei dati utente creati nell’ambiente di authoring deve rimanere nell’ambiente di authoring e non deve essere sincronizzata né replicata nelle istanze di pubblicazione.
Quando la topologia è una farm di pubblicazione, la registrazione e le modifiche apportate a un’istanza di pubblicazione devono essere sincronizzate con altre istanze di pubblicazione. I membri devono poter effettuare l’accesso e visualizzare i propri dati su qualsiasi nodo di pubblicazione.
Quando la sincronizzazione utente è abilitata, i dati utente vengono automaticamente sincronizzati tra le istanze di pubblicazione nella farm.

Istruzioni per la configurazione della sincronizzazione degli utenti

Per istruzioni dettagliate e dettagliate su come abilitare la sincronizzazione in una farm di pubblicazione, consultate:

Sincronizzazione utente in background

  • pacchetto VLT
    Si tratta di un file zip contenente tutte le modifiche apportate a un editore, che devono essere distribuite tra gli editori. Le modifiche apportate a un editore generano eventi selezionati dal listener di eventi change. In questo modo viene creato un pacchetto di convalida contenente tutte le modifiche.
  • pacchetto di distribuzione
    Contiene informazioni di distribuzione per Sling. Si tratta di informazioni su dove il contenuto deve essere distribuito e quando è stato distribuito per ultimo.

Cosa Succede Quando ...

Pubblica sito dalla console Siti di Communities

Per autore, quando un sito community viene pubblicato dalla console Siti community, l'effetto consiste nel replicare le pagine associate e Sling distribuisce i gruppi di utenti della community creati dinamicamente, inclusa la loro appartenenza.

L'utente viene creato o modifica il profilo in Pubblica

Per impostazione predefinita, gli utenti e i profili creati nell’ambiente di pubblicazione (ad esempio mediante registrazione automatica, accesso mediante social network e autenticazione LDAP) non vengono visualizzati nell’ambiente di authoring.
Se la topologia è una farm di pubblicazione e la sincronizzazione utente è stata configurata correttamente, il profilo ** utente e utente viene sincronizzato nella farm di pubblicazione utilizzando la distribuzione Sling.

Nuovo gruppo community creato in Pubblica

Anche se avviata da un’istanza di pubblicazione, la creazione di gruppi di community, che genera nuove pagine di sito e un nuovo gruppo di utenti, viene in realtà creata nell’istanza di creazione.
Come parte del processo, le nuove pagine del sito vengono replicate in tutte le istanze di pubblicazione. Il gruppo di utenti della community creato dinamicamente e la relativa appartenenza sono Sling distribuiti a tutte le istanze di pubblicazione.

Utenti o gruppi di utenti creati tramite la console di sicurezza

Per impostazione predefinita, i dati utente creati nell’ambiente di pubblicazione non vengono visualizzati nell’ambiente di authoring e viceversa.
Quando la console Amministrazione utente e sicurezza viene utilizzata per aggiungere nuovi utenti nell’ambiente di pubblicazione, la sincronizzazione utente sincronizza i nuovi utenti e i relativi membri del gruppo con altre istanze di pubblicazione, se necessario. La sincronizzazione utente sincronizza anche i gruppi di utenti creati tramite la console di protezione.

Post utente Contenuto su Pubblica

Per il contenuto generato dall’utente (UGC), i dati immessi in un’istanza di pubblicazione sono accessibili tramite l’SRP Configurazione dell’archiviazione configurato.

Best practices

Per impostazione predefinita, la sincronizzazione utente è disattivata . L'abilitazione della sincronizzazione utente comporta la modifica delle configurazioni OSGi esistenti . Non è necessario aggiungere nuove configurazioni per abilitare la sincronizzazione degli utenti.
La sincronizzazione utente si basa sull’ambiente di authoring per gestire le distribuzioni dei dati utente, anche se i dati utente non vengono creati in fase di creazione.
Prerequisiti
  1. Se utenti e gruppi di utenti sono già stati creati su un editore, si consiglia di sincronizzare Sincronizzazione manuale di utenti e gruppi di utenti manualmente i dati utente a tutti gli editori prima di configurare e abilitare la sincronizzazione utente.
    Una volta attivata la sincronizzazione degli utenti, vengono sincronizzati solo gli utenti e i gruppi appena creati.
  2. Verifica che sia stato installato il codice più recente:
Per abilitare la sincronizzazione degli utenti in AEM Communities, sono necessarie le seguenti configurazioni. Verificate che queste configurazioni siano corrette per evitare il malfunzionamento della distribuzione del contenuto.

Apache Sling Distribution Agent - Sync Agent Factory

Questa configurazione recupera il contenuto da sincronizzare tra gli editori. La configurazione si trova nell’istanza Author. L'autore deve tenere traccia di tutti gli editori presenti e di dove sincronizzare tutte le informazioni.
I valori predefiniti nella configurazione si riferiscono a una singola istanza di pubblicazione. Poiché la sincronizzazione degli utenti è utile per sincronizzare più istanze di pubblicazione, ad esempio per una farm di pubblicazione, è necessario aggiungere ulteriori istanze di pubblicazione alla configurazione.
Come viene sincronizzato il contenuto?
L’istanza Author esegue il ping dell’endpoint di esportazione degli editori. Ogni volta che un utente viene creato o aggiornato su editori specifici (n), l’autore riceve il contenuto dai punti finali dell’esportatore e invia il contenuto ad altri editori (n-1, a parte gli editori da cui viene recuperato il contenuto).
Per configurare la configurazione degli agenti di sincronizzazione Apache Sling:
  1. Accedete con privilegi di amministratore all’istanza di creazione di AEM.
  2. Individuare Apache Sling Distribution Agent - Sync Agent Factory .
    • Selezionate la configurazione esistente da aprire per la modifica (icona matita).
      Nome verifica: socialpubsync.
    • Selezionare la casella di controllo Abilitato .
    • Selezionate Usa più code.
    • Specificate endpoint ​di esportazione e endpoint di importazione (potete aggiungere altri endpoint di esportazione e importazione).
      Questi endpoint definiscono dove si desidera ottenere il contenuto e dove si desidera inviare il contenuto push. L'autore recupera il contenuto dall'endpoint di esportazione specificato e invia il contenuto agli editori (diversi dall'editore da cui ha recuperato il contenuto).

Distribuzione di Adobe Granite - Provider Segreto di trasporto password crittografato

Consente all’autore di identificare l’utente autorizzato, in quanto dispone dell’autorizzazione per sincronizzare i dati utente dall’autore alla pubblicazione.
L’utente autorizzato creato su tutte le istanze di pubblicazione consente agli editori di connettersi con l’autore e configurare la distribuzione Sling per l’autore. Questo utente autorizzato dispone di tutti gli ACL richiesti.
Ogni volta che i dati devono essere installati o recuperati dagli editori, l'autore si connette con gli editori utilizzando le credenziali (nome utente e password) impostate in questa configurazione.
Per collegare l'autore con gli editori utilizzando un utente autorizzato:
  1. Accedete con privilegi di amministratore all’istanza di creazione di AEM.
  2. Accedere alla console Configurazione di OSGi Web.
  3. Individua distribuzione Adobe Granite - Provider Segreto Di Trasporto Password Crittografato.
  4. Selezionate la configurazione esistente da aprire per la modifica (icona matita).
    Verificare la proprietà socialpubsync - publishUser.
  5. Impostate il nome utente e la password per l’utente sync.translate.html#createauthorizeduser autorizzato.
    Ad esempio, usersync - admin

Apache Sling Distribution Agent - Coda Agenti Factory

Questa configurazione viene utilizzata per configurare i dati da sincronizzare tra gli editori. Quando i dati vengono creati/aggiornati nei percorsi specificati in Consentite Roots , "var/community/distribution/diff" viene attivato e il replicatore creato recupera i dati da un editore e li installa su altri editori.
Per configurare i dati (percorsi nodo) da sincronizzare:
  1. Effettuate l’accesso con i privilegi di amministratore per l’istanza di creazione.
  2. Accedere alla console configuring-osgi.html Web.
  3. Individua agente di distribuzione Apache Sling - Coda Agenti Factory .
  4. Selezionate la configurazione esistente da aprire per la modifica (icona matita).
    Nome verifica: socialpubsync -reverse
  5. Selezionate la casella di controllo Abilitato e salvate.
  6. Specificare i percorsi dei nodi da replicare nelle radici ​consentite.
  7. Ripetete questa procedura per ogni istanza di pubblicazione .

Distribuzione Adobe Granite - Diff Observer Factory

Questa configurazione sincronizza l'appartenenza al gruppo tra gli editori. Se la modifica dell'appartenenza di un gruppo in un editore non ne aggiorna l'appartenenza ad altri editori, accertatevi che ref:members sia aggiunto ai nomi delle proprietà analizzate.
Per garantire la sincronizzazione dei membri:
  1. Accedete con privilegi di amministratore all’istanza di creazione di AEM.
  2. Accedere alla console configuring-osgi.html Web.
  3. Individuare Adobe Granite Distribution - Diff Observer Factory .
  4. Selezionate la configurazione esistente da aprire per la modifica (icona matita).
    Verifica nome agente: socialpubsync -reverse .
  5. Selezionare la casella di controllo Abilitato .
  6. Specificate rep:members come descrizione per propertyName nei nomi delle proprietà cercate e Save.

Trigger di distribuzione Apache Sling - Factory Triggers programmati

Questa configurazione consente di configurare l’intervallo di polling (al termine del quale gli editori vengono sottoposti a ping e le modifiche vengono eseguite dall’autore) per sincronizzare le modifiche tra gli editori.
L’autore controlla gli editori ogni 30 secondi (impostazione predefinita). Se nella cartella sono presenti pacchetti /var/sling/distribution/packages/ socialpubsync - vlt /shared , questi verranno recuperati e installati su altri editori.
Per modificare l’intervallo di polling:
  1. Accedete con privilegi di amministratore all’istanza di creazione di AEM.
  2. Individua trigger di distribuzione Apache Sling - Scheduled Triggers Factory
    • Selezionate la configurazione esistente da aprire per la modifica (icona matita).
      Verifica socialpubsync -Scheduled-trigger
    • Impostate l'intervallo in secondi sull'intervallo desiderato e salvate.

Listener di sincronizzazione utenti di AEM Communities

Per problemi nella distribuzione Sling in cui vi è una discrepanza nelle iscrizioni e seguenti, controlla se le seguenti proprietà nelle configurazioni di AEM Communities User Sync Listener sono impostate:
  • NodeTypes
  • IgnorableProperties
  • IgnorableNodes
  • DistributedFolders
Per sincronizzare iscrizioni, seguiti e notifiche
In ogni istanza di pubblicazione AEM:
  1. Effettuate l'accesso con privilegi di amministratore.
  2. Individua listener di sincronizzazione utenti di AEM Communities.
  3. Seleziona la configurazione esistente da aprire per la modifica (icona matita)
    Nome verifica: socialpubsync - Scheduled-trigger
  4. Impostate i seguenti NodeTypes :
    rep:User
    nt:unstructured
    nt:resource
    rep:ACL
    sling:Folder
    sling:OrderedFolder
    I tipi di nodo specificati in questa proprietà verranno sincronizzati e le informazioni sulle notifiche (blog e configurazioni seguite) vengono sincronizzate tra editori diversi.
  5. Aggiungere tutte le cartelle da sincronizzare in DistributedFolders . Ad esempio,
    segments/scoring
    social/relationships
    activities
  6. Impostate i nodi ignorablenodes su:
    .tokens
    system
    rep:cache (poiché utilizziamo sessioni di tipo "fisso", non è necessario sincronizzare questo nodo con editori diversi).

ID Sling univoco

L’istanza di creazione di AEM utilizza l’ID Sling per identificare da dove arrivano i dati e a quali editori deve (o non deve) inviare nuovamente il pacchetto.
Accertatevi che tutti gli editori di una farm di pubblicazione abbiano un ID Sling univoco. Se l’ID Sling è lo stesso per più istanze di pubblicazione in una farm di pubblicazione, la sincronizzazione degli utenti non riesce. Poiché l'autore non sa da dove recuperare il pacchetto e dove installarlo.
Per garantire un ID Sling univoco degli editori nella farm di pubblicazione, in ogni istanza di pubblicazione:
  1. Accedete a https:// .
  2. Controllare il valore di Sling ID .
    Se l’ID Sling di un’istanza di pubblicazione corrisponde all’ID Sling di qualsiasi altra istanza di pubblicazione, effettuate le seguenti operazioni:
  3. Interrompi una delle istanze di pubblicazione con un ID Sling corrispondente.
  4. Nella crx-quickstart/launchpad/felix directory, cercare ed eliminare il file denominato sling.id.file.
    Ad esempio, su un sistema Linux:
    rm -i $(find . -type f -name sling.id.file)
    Ad esempio, in un sistema Windows:
    Utilizzare windows explorer e cercare sling.id.file
  5. Avviate l’istanza di pubblicazione. All'avvio, gli verrà assegnato un nuovo Sling ID.
  6. Verifica che l’ID ​Sling sia ora univoco.
Ripetete questi passaggi finché tutte le istanze di pubblicazione non dispongono di un ID Sling univoco.

Vault Package Builder Factory

Affinché gli aggiornamenti possano essere sincronizzati correttamente, è necessario modificare il generatore di pacchetti vault per la sincronizzazione degli utenti. In /home/users , viene creato un */rep:cache nodo. È una cache che viene utilizzata per scoprire che se eseguiamo query sul nome principale di un nodo, allora questa cache può essere utilizzata direttamente.
La sincronizzazione degli utenti può interrompersi se rep :cache i nodi sono sincronizzati tra gli editori.
Per garantire la corretta sincronizzazione degli aggiornamenti tra gli editori, in ogni istanza di pubblicazione AEM:
  1. Accesso alla console Web
  2. Individua il pacchetto di distribuzione Apache Sling - Vault Package Builder Factory
    Nome del generatore: socialpubsync-vlt.
  3. Selezionate l’icona di modifica.
  4. Aggiungete due filtri nodo pacchetto:
    • /home/users|-.*/.tokens
    • /home/users|-.*/rep:cache
  5. Gestione dei criteri
    • Per sovrascrivere i nodi rep:policy con i nuovi, aggiungete un terzo Filtro pacchetto: /home/users|+.*/rep:policy
    • Per evitare la distribuzione dei criteri, impostare: Acl Handling: IGNORE

Risoluzione dei problemi di distribuzione Sling in AEM Communities

Se la distribuzione Sling non riesce, provate i seguenti passaggi di debug:
  1. Verifica configurazioni aggiunte in modo errato
    Assicuratevi che non vengano aggiunte o modificate più configurazioni, ma che le configurazioni predefinite esistenti vengano modificate.
  2. Controllare le configurazioni
    Assicurati che tutte le configurazioni siano impostate correttamente nell'istanza di AEM Author, come indicato nelle Best Practices .
  3. Verifica autorizzazioni utente autorizzate
    Se i pacchetti non sono installati correttamente, verificate che l'utente 2. Crea utente autorizzato autorizzato creato nella prima istanza di pubblicazione abbia gli ACL corretti.
    Per convalidarlo, invece di creare l'utente autorizzato, modificate la configurazione Adobe Granite Distribution - Encrypted Password Transport Secret Provider (Fornitore segreto di trasporto password crittografato) nell'istanza Author per utilizzare le credenziali utente Admin. Tentate nuovamente di installare i pacchetti. Se la sincronizzazione utente funziona correttamente con le credenziali dell'amministratore, significa che l'utente di pubblicazione creato non aveva ACL appropriati.
  4. Controllare la configurazione di Diff Observer Factory
    Se solo nodi specifici non vengono sincronizzati nella farm di pubblicazione, ad esempio, i membri del gruppo non sono sincronizzati, accertatevi che la configurazione Adobe Granite Distribution - Diff Observer Factory sia abilitata e rep: i membri vengono impostati nei nomi delle proprietà analizzate .
  5. Verificate la configurazione del listener di sincronizzazione utenti di AEM Communities. Se gli utenti creati sono sincronizzati ma le iscrizioni e i seguenti elementi non funzionano, assicurati che la configurazione del listener di sincronizzazione utenti di AEM Communities disponga di:
    • Tipi di nodo: impostati su rep:User, nt:unstructure , nt:resource , rep:ACL , sling:Folder e sling:OrderedFolder .
    • Nodi ignorabili: impostati su .tokens , system e rep:cache .
    • Cartelle distribuite: impostate le cartelle che desiderate distribuire.
  6. Controllate i registri generati durante la creazione dell’utente nell’istanza Pubblica
    Se le configurazioni di cui sopra sono impostate correttamente ma la sincronizzazione utente non funziona, controllate i registri generati al momento della creazione dell'utente.
    Verificare se l’ordine dei file di registro è lo stesso, come segue:
    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
    
    
Per eseguire il debug:
  1. Disattiva la sincronizzazione utente:
  2. Nell’istanza di creazione di AEM, effettuate l’accesso con privilegi di amministratore.
    1. Individuare la configurazione Apache Sling Distribution Agent - Sync Agent Factory .
    2. Deselezionare la casella di controllo Abilitato .
      Quando si disabilita la sincronizzazione utente nell’istanza di creazione, gli endpoint (esportatore e importatore) vengono disattivati e l’istanza di creazione è statica. I pacchetti vlt non vengono cerchiati o inseriti dall'autore.
      Ora, se un utente viene creato nell’istanza di pubblicazione, il pacchetto vlt viene creato nel nodo /var/sling/distribution/packages/ socialpubsync - vlt /data . E se questi pacchetti vengono inviati dall'autore a un altro servizio. Puoi scaricare ed estrarre questi dati per verificare quali proprietà vengono inviate ad altri servizi.
  3. Passate a un editore e create un utente sull'editore. Di conseguenza, gli eventi vengono creati.
  4. Controllate l’ ordine dei registri creati al momento della creazione dell’utente.
  5. Verificate se un pacchetto vlt viene creato su /var/sling/distribution/packages/socialpubsync-vlt/data .
  6. Ora abilitate la sincronizzazione degli utenti nell’istanza di creazione di AEM.
  7. Nell'editore, modificate gli endpoint di esportazione o importazione in Apache Sling Distribution Agent - Sync Agent Factory . Possiamo scaricare ed estrarre i dati del pacchetto per verificare quali proprietà vengono inviate ad altri editori e quali dati vengono persi.