DocumentaçãoAEM 6.4Guia do Communities

Sincronização de usuários das comunidades communities-user-synchronization

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

Criado para:

  • Admin
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Introdução introduction

No AEM Communities, no ambiente de publicação (dependendo das permissões configuradas), visitantes do site pode tornar-se membros, criar grupos de usuários e edite seus perfil de membro.

Dados do usuário é um termo usado para se referir a usuários, perfis de usuário e grupos de usuários.

Membros é um termo usado para se referir a usuários registrado no ambiente de publicação, em vez de usuários registrados no ambiente de criação.

Para obter mais informações sobre os dados do usuário, visite Gerenciar usuários e grupos de usuários.

Sincronização de usuários em um farm de publicação synchronizing-users-across-a-publish-farm

Por design, os dados do usuário criados no ambiente de publicação não aparecem no ambiente de criação.

A maioria dos dados do usuário criados no ambiente de criação tem o objetivo de permanecer no ambiente de criação e não é sincronizada nem replicada para publicar instâncias.

Quando a variável topologia é um publicar farm, o registro e as modificações feitas em uma instância de publicação precisam ser sincronizadas com outras instâncias de publicação. Os membros precisam fazer logon e ver seus dados em qualquer nó de publicação.

Quando a sincronização do usuário é ativada, os dados do usuário são sincronizados automaticamente entre as instâncias de publicação no farm.

Instruções de configuração da sincronização de usuários user-sync-setup-instructions

Para obter instruções detalhadas, passo a passo, sobre como habilitar a sincronização em um farm de publicação, consulte

Sincronização do usuário em segundo plano user-sync-in-the-background

sling-dist-workflow

  • Pacote VLT: é um arquivo zip de todas as alterações feitas em um editor, que precisam ser distribuídas entre editores. As alterações em um editor geram eventos que são escolhidos pelo ouvinte de eventos de alteração. Isso cria um pacote vlt que contém todas as alterações.

  • Pacote de distribuição: contém informações de distribuição do Sling. Essas são informações sobre onde o conteúdo precisa ser distribuído e quando foi distribuído por último.

O que acontece quando … what-happens-when

Publicar site a partir do console Sites das Comunidades publish-site-from-communities-sites-console

Na criação, quando um site da comunidade é publicado na Console de sites das comunidades, o efeito é replicar as páginas associadas e o Sling distribuem os grupos de usuários da comunidade criados dinamicamente, incluindo sua associação.

O usuário é criado ou edita o perfil na publicação user-is-created-or-edits-profile-on-publish

Por design, os usuários e perfis criados no ambiente de publicação (como por autoregistro, logon social, autenticação LDAP) não aparecem no ambiente do autor.

Quando a topologia for uma publicar farm e a sincronização do usuário foi configurada corretamente, a variável usuário e perfil de usuário é sincronizado no farm de publicação usando a distribuição do Sling.

Novo grupo da comunidade é criado na publicação new-community-group-is-created-on-publish

Embora tenha sido iniciado a partir de uma instância de publicação, a criação do grupo da comunidade, que resulta em novas páginas do site e em um novo grupo de usuários, ocorre na instância do autor.

Como parte do processo, as novas páginas do site são replicadas para todas as instâncias de publicação. O grupo de usuários da comunidade criado dinamicamente e sua associação são Sling distribuídos para todas as instâncias de publicação.

Usuários ou grupos de usuários são criados usando o Console de segurança users-or-user-groups-are-created-using-security-console

Por design, os dados do usuário criados no ambiente de publicação não aparecem no ambiente de criação e vice-versa.

Quando a variável Administração e segurança do usuário O console é usado para adicionar novos usuários no ambiente de publicação, a sincronização do usuário sincronizará os novos usuários e a associação do grupo a outras instâncias de publicação, se necessário. A sincronização de usuários também sincronizará os grupos de usuários criados pelo console de segurança.

O usuário publica conteúdo na publicação user-posts-content-on-publish

Para conteúdo gerado pelo usuário (UGC), os dados inseridos em uma instância de publicação são acessados por meio do SRP configurado.

Práticas recomendadas bestpractices

Por padrão, a sincronização do usuário é desativado. A habilitação da sincronização de usuários envolve modificar existente Configurações OSGi. Nenhuma nova configuração deve ser adicionada como resultado da ativação da sincronização do usuário.

A sincronização de usuários depende do ambiente do autor para gerenciar as distribuições de dados do usuário, mesmo que os dados do usuário não sejam criados no autor .

Pré-requisitos

  1. Se usuários e grupos de usuários já tiverem sido criados em um editor, é recomendável sincronizar manualmente os dados do usuário para todos os editores antes de configurar e ativar a sincronização do usuário.

    Quando a sincronização do usuário estiver ativada, somente os usuários e grupos recém-criados serão sincronizados .

  2. Verifique se o código mais recente foi instalado:

As seguintes configurações são necessárias para habilitar a sincronização de usuários no AEM Communities. Certifique-se de que essas configurações estejam corretas para impedir que a distribuição de conteúdo do sling falhe.

Apache Sling Distribution Agent - Fábrica de agentes de sincronização apache-sling-distribution-agent-sync-agents-factory

Essa configuração busca o conteúdo a ser sincronizado entre os editores. A configuração é na instância do autor. O autor deve acompanhar todos os editores que estão lá e onde sincronizar todas as informações.

Os valores padrão na configuração são para uma única instância de publicação. Como a sincronização do usuário é útil para sincronizar várias instâncias de publicação, como para um farm de publicação, outras instâncias de publicação precisam ser adicionadas à configuração.

Como o conteúdo é sincronizado?

A instância de autor consulta o endpoint de exportador de editores. Sempre que um usuário é criado ou atualizado em editores específicos (n), o Autor obtém o conteúdo dos pontos de extremidade do exportador e puxa o conteúdo para outros editores (n-1, ou seja, diferente dos editores a partir dos quais o conteúdo é buscado).

Para configurar a configuração dos agentes de sincronização do Apache Sling

Na instância AEM autor:

  1. Faça logon com privilégios de administrador.

  2. Acesse o Console da Web.

    Por exemplo, http://localhost:4502/system/console/configMgr.

  3. Localizar Apache Sling Distribution Agent - Fábrica de agentes de sincronização.

    • Selecione a configuração existente a ser aberta para edição (ícone de lápis).

    • Verificar nome: socialpubsync.

    • Marque a caixa de seleção Ativado.

    • Selecionar Usar várias filas.

    • Especificar Endpoints do exportador e Endpoints do importador (é possível adicionar mais endpoints de exportador e importador).

      Esses endpoints definem de onde você deseja obter o conteúdo e de onde deseja enviar o conteúdo. O autor busca o conteúdo do endpoint do exportador especificado e o envia para os editores (diferente do editor do qual buscou o conteúdo).
      sync-agent-fact

Distribuição de Adobe Granite - Provedor secreto de transporte de senha criptografado adobe-granite-distribution-encrypted-password-transport-secret-provider

Ela permite que o autor identifique o usuário autorizado, como tendo permissão para sincronizar dados do usuário do autor para publicar.

O usuário autorizado criado em todas as instâncias de publicação ajuda os editores a se conectarem ao autor e a configurar a distribuição do Sling no autor. Esse usuário autorizado tem todos os requisitos ACLs.

Sempre que os dados devem ser instalados ou obtidos de editores, o autor se conecta com os editores usando as credenciais (nome de usuário e senha) definidas nessa configuração.

Para conectar o autor com editores usando usuário autorizado

Na instância AEM autor:

  1. Faça logon com privilégios de administrador.

  2. Acesse o Console da Web.

    Por exemplo, http://localhost:4502/system/console/configMgr.

  3. Localizar Distribuição de Adobe Granite - Provedor secreto de transporte de senha criptografado.

  4. Selecione a configuração existente a ser aberta para edição (ícone de lápis).

    Verificar propriedade name: socialpubsync- publishUser .

  5. Defina o nome de usuário e a senha como usuário autorizado.

    Por exemplo, usersync-admin

    granite-pasword-trans

Apache Sling Distribution Agent - Fábrica de agentes da fila apache-sling-distribution-agent-queue-agents-factory

Essa configuração é usada para configurar os dados que você deseja sincronizar entre editores. Quando os dados são criados/atualizados nos caminhos especificados em Raízes permitidas, o "var/community/distribution/diff" é ativado e o replicador criado obtém os dados de um editor e os instala em outros editores.

Para configurar os dados (caminhos de nó) para sincronizar

Em AEM instância de publicação:

  1. Faça logon com privilégios de administrador.

  2. Acesse o Console da Web.

    Por exemplo, http://localhost:4503/system/console/configMgr.

  3. Localizar Apache Sling Distribution Agent - Fábrica de agentes da fila.

  4. Selecione a configuração existente a ser aberta para edição (ícone de lápis).

    Verificar nome: socialpubsync -inverso.

  5. Selecione o Ativado e salve.

  6. Especifique os caminhos do nó que devem ser replicados em Raízes permitidas.

  7. Repetir para cada publish instância.

    queue-agents-fact

Distribuição de Adobe Granite - Fábrica de Observadores Diff adobe-granite-distribution-diff-observer-factory

Essa configuração sincroniza a associação de grupo entre editores.
Se alterar a associação de um grupo em um editor não atualizar sua associação em outros editores, verifique se ref:membros é adicionado a nomes de propriedades pesquisadas.

Para garantir a sincronização de membros

Em cada instância de publicação de AEM:

  1. Faça logon com privilégios de administrador.

  2. Acesse o Console da Web.

    Por exemplo, http://localhost:4503/system/console/configMgr.

  3. Localizar Distribuição de Adobe Granite - Fábrica de Observadores Diff.

  4. Selecione a configuração existente a ser aberta para edição (ícone de lápis).

    Verificar nome do agente: socialpubsync -verso**.

  5. Marque a caixa de seleção Ativado.

  6. Especificar rep:members as description para propertyName em nomes de propriedades pesquisadas e Salvar.

    diff-obs

Acionador de distribuição do Apache Sling - Fábrica de acionadores agendados apache-sling-distribution-trigger-scheduled-triggers-factory

Essa configuração permite que você configure o intervalo de pesquisa (após o qual os editores são colocados em ping e as alterações são obtidas pelo autor) para sincronizar as alterações nos editores.

O autor pesquisa os editores a cada 30 segundos (padrão). Se algum pacote estiver presente na pasta /var/sling/distribution/packages/ socialpubsync - vlt /shared, eles buscarão esses pacotes e os instalarão em outros editores.

Para alterar o intervalo de sondagem

Na instância AEM autor:

  1. Faça logon com privilégios de administrador.

  2. Acesse o Console da Web, por exemplo, http://localhost:4502/system/console/configMgr

  3. Localizar Acionador de distribuição do Apache Sling - Fábrica de acionadores agendados

    • Selecione a configuração existente a ser aberta para edição (ícone de lápis)
    • Verificar Name: socialpubsync-agendado-acionador
    • Defina o Intervalo em Segundos para o intervalo desejado e salve.

    acionador agendado

Ouvinte de sincronização de usuários do AEM Communities aem-communities-user-sync-listener

Para problemas na distribuição do Sling em que há uma discrepância nas assinaturas e seguintes, verifique se as seguintes propriedades em Ouvinte de sincronização de usuários do AEM Communities configurações definidas:

  • NodeTypes
  • IgnorableProperties
  • IgnorableNodes
  • Pastas Distribuídas

Para sincronizar assinaturas, seguidores e notificações

Em cada instância de publicação de AEM:

  1. Faça logon com privilégios de administrador.

  2. Acesse o Console da Web. Por exemplo, http://localhost:4503/system/console/configMgr.

  3. Localizar Ouvinte de sincronização de usuários do AEM Communities.

  4. Selecione a configuração existente a ser aberta para edição (ícone de lápis).

    Verificar nome: socialpubsync-agendado-acionador

  5. Defina o seguinte NodeTypes :

    rep:User

    nt : não estruturado

    nt :resource

    rep:ACL

    sling:Folder

    sling:OrderedFolder

    Os tipos de nó especificados nessa propriedade serão sincronizados, e as informações de notificações (blogs e configurações seguidas) serão sincronizadas entre diferentes editores.

  6. Adicionar todas as pastas para sincronizar no Pastas Distribuídas. Por exemplo,

    segmentos/pontuação

    relações sociais

    atividades

  7. Defina o ignorablenodes como:

    .tokens

    system

    rep :cache (como usamos sessões aderentes, não é necessário sincronizar esse nó com diferentes editores)

    listner de sincronização de usuário

ID exclusiva do Sling unique-sling-id

AEM instância do autor usa o Sling ID para identificar de onde os dados estão vindo e para quais editores precisa (ou não) enviar o pacote de volta.

Certifique-se de que todos os editores em um farm de publicação tenham uma ID do Sling exclusiva. Se a ID do Sling for a mesma para várias instâncias de publicação em um farm de publicação, ocorrerá falha na sincronização do usuário. Como o autor não saberá de onde buscar o pacote e de onde instalar o pacote.

Para garantir a ID de sling exclusiva dos editores no farm de publicação

Em cada instância de publicação:

  1. Navegue até https://host:port/system/console/status-slingsettings.

  2. Verifique o valor de Sling ID.

    slingid

    Se a ID do Sling de uma instância de publicação corresponder à ID do Sling de qualquer outra instância de publicação, então:

  3. Pare uma das instâncias de publicação que tenha uma ID do Sling correspondente.

  4. No crx-quickstart/launchpad/felix , procure e exclua o arquivo chamado _sling.id.file.

    por exemplo, em um sistema Linux:

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

    por exemplo, em um sistema Windows:

    use windows explorer and search for _sling.id.file_

  5. Inicie a instância de publicação. Na inicialização, será atribuído um novo Sling ID.

  6. Valide se a variável Sling ID agora é exclusiva.

Repita essas etapas até que todas as instâncias de publicação tenham uma ID do Sling exclusiva.

Compilador de pacote de cofre de fábrica vault-package-builder-factory

Para que as atualizações sejam sincronizadas corretamente, é necessário modificar o construtor de pacotes de cofre para sincronização do usuário.
Em /home/users, a /rep:cache é criado. É um cache usado para descobrir que, se consultarmos o nome principal de um nó, esse cache poderá ser usado diretamente.

A sincronização do usuário pode parar se rep:cache os nós são sincronizados entre editores.

Para garantir que as atualizações sejam sincronizadas corretamente entre os editores

Em cada instância de publicação de AEM:

  1. Acesse o Console da Web, por exemplo, http://localhost:4503/system/console/configMgr.

  2. Localize a variável Apache Sling Distribution Packaging - Nome do Criador de fábrica do Construtor de pacotes de cofre: socialpubsync-vlt.

  3. Selecione o ícone de edição.

  4. Adicione dois filtros de pacote:

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

  5. Tratamento de políticas

    • Para substituir o representante existente :policy nós com novos, adicione um terceiro Filtro de Pacote:

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

    • Para evitar que as políticas sejam distribuídas, defina

      Manuseio De Acl: IGNORAR

vault-package-builder-fatory

Solução de problemas de distribuição do Sling no AEM Communities troubleshoot-sling-distribution-in-aem-communities

Se a distribuição do Sling falhar, tente as seguintes etapas de depuração:

  1. Verificar configurações adicionadas incorretamente. Certifique-se de que várias configurações não sejam adicionadas ou editadas, em vez disso, as configurações padrão existentes devem ser editadas.

  2. Verificar configurações. Certifique-se de que todas as configurações são definidos adequadamente na instância do AEM Author, como mencionado no Práticas recomendadas.

  3. Verificar permissões de usuário autorizado. Se os pacotes não estiverem instalados corretamente, verifique se a variável usuário autorizado criado na primeira instância de publicação tem as ACLs corretas.

    Para validar isso, em vez de usuário autorizado criado altere a Distribuição de Adobe Granite - Provedor secreto de transporte de senha criptografado configuração na instância do autor para usar credenciais de usuário administrador. Agora tente instalar os pacotes novamente. Se a sincronização do usuário funcionar bem com credenciais de administrador, significa que o usuário de publicação criado não tinha ACLs apropriadas.

  4. Verificar a configuração da Fábrica do Observador Diff. Se apenas nós específicos não forem sincronizados no farm de publicação - por exemplo, os membros do grupo não serão sincronizados - em seguida, verifique se a variável Distribuição de Adobe Granite - Fábrica de Observadores Diff a configuração está ativada e rep:membros são definidos em nomes de propriedades pesquisadas.

  5. Verifique a configuração do Ouvinte de sincronização de usuário do AEM Communities. Se os usuários criados forem sincronizados, mas as assinaturas e seguintes não estiverem funcionando, verifique se a configuração do Ouvinte de sincronização de usuários do AEM Communities tem:

    • Tipos de nó - definido como rep:User, nt:unstructured, nt:resource, rep:ACL, sling:Folder e sling:OrderedFolder
    • Nós ignoráveis - definido como .tokens, sistema e rep:cache
    • Pastas distribuídas - defina para as pastas que deseja distribuir

  6. Verificar logs gerados na criação do usuário na instância de publicação. Se as configurações acima estiverem adequadamente definidas, mas a sincronização do usuário não estiver funcionando, verifique os logs gerados na criação do usuário.

    Verifique se a ordem dos logs é a mesma, da seguinte maneira:

    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

    Para depurar:

    1. Desativar a sincronização de usuários:

    2. Na instância AEM autor, faça logon com privilégios de administrador.

      1. Acesse o Console da Web. Por exemplo, http://localhost:4502/system/console/configMgr.

      2. Localize a configuração Apache Sling Distribution Agent - Fábrica de agentes de sincronização.

      3. Desmarque a opção Ativado caixa de seleção.

      Ao desabilitar a sincronização do usuário na instância do autor, os endpoints (exportador e importador) são desabilitados e a instância do autor é estática. O vlt os pacotes não são pingados ou buscados pelo autor.

      Agora, se um usuário for criado na instância de publicação, a variável vlt pacote é criado em /var/sling/distribution/packages/ socialpubsync - vlt /data nó . E se esses pacotes forem encaminhados pelo autor para outro serviço. Você pode baixar e extrair esses dados para verificar quais propriedades são enviadas para outros serviços.

    3. Vá para um editor e crie um usuário no editor. Como resultado, os eventos são criados.

    4. Verifique a ordem de logs, criado na criação do usuário.

    5. Verifique se uma vlt pacote é criado em /var/sling/distribution/packages/socialpubsync-vlt/data.

    6. Agora, ative a sincronização do usuário AEM instância do autor.

    7. No editor, altere os endpoints do exportador ou importador em Apache Sling Distribution Agent - Fábrica de agentes de sincronização.

      Podemos baixar e extrair dados do pacote para verificar quais propriedades são enviadas para outros editores e quais dados são perdidos.

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