Show Menu
TEMAS×

Sincronización de usuarios

Introducción

Cuando la implementación es un conjunto de servidores de publicación, los miembros deben poder iniciar sesión y ver sus datos en cualquier nodo de publicación.
Los usuarios y los grupos de usuarios (datos de usuario) creados en el entorno de publicación no son necesarios en el entorno de creación.
La mayoría de los datos de usuario creados en el entorno de creación están pensados para permanecer en el entorno de creación y no para copiarlos en instancias de publicación.
El registro y las modificaciones realizadas en una instancia de publicación deben sincronizarse con otras instancias de publicación para que tengan acceso a los mismos datos de usuario.
A partir de AEM 6.1, cuando la sincronización de usuarios está habilitada, los datos de usuario se sincronizan automáticamente en las instancias de publicación del conjunto de servidores y no se crean en el autor.

Distribución de Sling

Los datos del usuario, junto con sus ACL , se almacenan en el Oak Core , la capa debajo de Oak JCR, y se accede a ellos mediante la API de Oak. Con actualizaciones poco frecuentes, es razonable que los datos de usuario se sincronicen con otras instancias de publicación mediante Sling Content Distribution (distribución de Sling).
Los beneficios de la sincronización de usuarios mediante la distribución Sling, en comparación con la replicación tradicional, son:
  • los usuarios , los perfiles de usuario y los grupos de usuarios creados al publicar no se crean en el autor
  • La distribución Sling establece propiedades en eventos jcr, lo que permite actuar dentro de los oyentes de eventos de publicación sin preocuparse por los bucles de replicación infinitos
  • La distribución de Sling sólo envía datos de usuario a instancias de publicación no originales, eliminando así el tráfico innecesario
  • Las ACL establecidas en el nodo de usuario se incluyen en la sincronización
Si se requieren sesiones, se recomienda utilizar una solución SSO o utilizar una sesión adhesiva y hacer que los clientes inicien sesión si pasan a otro editor.
No se admite la sincronización del grupo de administradores , aunque la sincronización de usuarios esté activada. En su lugar, se registrará un error al 'importar la diferencia' en el registro de errores.
Por lo tanto, cuando la implementación es un conjunto de servidores de publicación, si se agrega o elimina un usuario del grupo * administradores , la modificación debe realizarse manualmente en cada instancia de publicación.

Activar sincronización de usuario

De forma predeterminada, la sincronización de usuarios es disabled .
Habilitar la sincronización de usuarios implica modificar las configuraciones de OSGi existentes .
No se deben agregar nuevas configuraciones como resultado de habilitar la sincronización de usuarios.
La sincronización de usuarios depende del entorno de creación para administrar las distribuciones de datos de usuario, aunque los datos de usuario no se hayan creado en el autor. Gran parte de la configuración, pero no toda, se lleva a cabo en el entorno del autor y cada paso identifica claramente si se debe realizar durante la creación o la publicación.
A continuación se indican los pasos necesarios para habilitar la sincronización de usuarios, seguidos de una sección de resolución de problemas :

Requisitos previos

  1. Si ya se han creado usuarios y grupos de usuarios en un editor, se recomienda sincronizar Sincronización manual de usuarios y grupos de usuarios manualmente los datos de usuario con todos los editores antes de configurar y habilitar la sincronización de usuarios.
Una vez habilitada la sincronización de usuarios, solo se sincronizan los usuarios y grupos recién creados.
  1. Asegúrese de que se ha instalado el código más reciente:

1. Agente de distribución Apache Sling: fábrica de agentes de sincronización

Habilitar sincronización de usuario
  • en autor
    • iniciar sesión con privilegios de administrador
    • acceder a la consola web
    • localizar Apache Sling Distribution Agent - Sync Agents Factory
      • seleccione la configuración existente para abrirla y editarla (icono de lápiz)Verificar name : socialpubsync
      • seleccione la Enabled casilla de verificación
      • select Save

2. Crear usuario autorizado

Configurar permisos Este usuario autorizado se utilizará en el paso 3 para configurar la distribución de Sling en el autor.
Se debe crear un nuevo usuario.
  • El usuario predeterminado asignado es admin .
  • No use communities-user-admin user.

Cómo Añadir ACL

  • acceso a CRXDE Lite
  • seleccionar /home nodo
  • en el panel derecho, seleccione la Access Control ficha
  • seleccione el + botón para agregar una entrada ACL
    • Principal : buscar usuarios creados para la sincronización de usuarios
    • Tipo : Allow
    • Privilegios : jcr:all
    • Restricciones rep:glob: */activities/*
    • seleccionar Aceptar
  • seleccione Guardar todo
Consulte también

3. Credenciales de transporte de distribución de Apache Sling - Credenciales de usuario basadas en DistributionTransportSecretProvider

Configurar permisos
Una vez que se ha creado un usuario autorizado, un miembro del grupo de usuarios administrators *, en todas las instancias de publicación, ese usuario autorizado debe ser identificado por el autor como que tiene permiso para sincronizar datos de usuario del autor para publicar.
  • en autor
    • iniciar sesión con privilegios de administrador
    • acceder a la consola web
    • localizar Apache Sling Distribution Transport Credentials - User Credentials based DistributionTransportSecretProvider
    • seleccione la configuración existente para abrirla y editarla (icono de lápiz)Verificar property name : socialpubsync-publishUser
    • establezca el nombre de usuario y la contraseña para el usuario 2. Crear usuario autorizado autorizado creado al publicar en el paso 2
      • for example, usersync-admin

4. Agente de distribución Apache Sling: fábrica de agentes de cola

Habilitar sincronización de usuario
  • al publicar :
    • iniciar sesión con privilegios de administrador
    • acceder a la consola web
    • localizar Apache Sling Distribution Agent - Queue Agents Factory
      • seleccione la configuración existente para abrirla y editarla (icono de lápiz)Verificar Name : socialpubsync-reverse
      • seleccione la Enabled casilla de verificación
      • select Save
    • repetir para cada instancia de publicación

5. Adobe Social Sync - Fábrica de observación de diferencias

Habilitar sincronización de grupos
  • en cada instancia de publicación:
    • iniciar sesión con privilegios de administrador
    • acceder a la consola web
    • localizar Adobe Social Sync - Diff Observer Factory
      • seleccione la configuración existente para abrirla y editarla (icono de lápiz)
        Verificar agent name : socialpubsync-reverse
      • seleccione la Enabled casilla de verificación
      • select Save

6. Activador de distribución de Apache Sling: fábrica de activadores programados

(Opcional) modificar el intervalo de sondeo
De forma predeterminada, el autor sondeará los cambios cada 30 segundos. Para modificar este intervalo:
  • en autor
    • iniciar sesión con privilegios de administrador
    • acceder a la consola web
    • localizar Apache Sling Distribution Trigger - Scheduled Triggers Factory
      • seleccione la configuración existente para abrirla y editarla (icono de lápiz)
        • Verificar Name : socialpubsync-scheduled-trigger
      • establezca el intervalo Interval in Seconds en el intervalo deseado
      • select Save

Configurar para varias instancias de publicación

La configuración predeterminada es para una sola instancia de publicación. Dado que el motivo para habilitar la sincronización de usuarios es sincronizar varias instancias de publicación, como en un conjunto de publicaciones, las instancias de publicación adicionales deberán agregarse a la fábrica de agentes de sincronización.

7. Agente de distribución Apache Sling: fábrica de agentes de sincronización

Añadir instancias de publicación:
  • en autor
    • iniciar sesión con privilegios de administrador
    • acceder a la consola web
    • localizar Apache Sling Distribution Agent - Sync Agents Factory
      • seleccione la configuración existente para abrirla y editarla (icono de lápiz)Verificar Name : socialpubsync
  • Extremos del exportador Debe haber un extremo del exportador para cada publicador. Por ejemplo, si hay dos editores, localhost:4503 y 4504, debe haber dos entradas:
    • https://localhost:4503/libs/sling/distribution/services/exporters/socialpubsync-reverse
    • https://localhost:4504/libs/sling/distribution/services/exporters/socialpubsync-reverse
  • Extremos del importador Debe haber un extremo del importador para cada publicador. Por ejemplo, si hay dos editores, localhost:4503 y 4504, debe haber dos entradas:
    • https://localhost:4503/libs/sling/distribution/services/importers/socialpubsync
    • https://localhost:4504/libs/sling/distribution/services/importers/socialpubsync
  • select Save

8. Escucha de sincronización de usuarios de AEM Communities

(Opcional) Sincronizar nodos JCR adicionales
Si hay datos personalizados que desea sincronizar en varias instancias de publicación, entonces:
  • en cada instancia de publicación:
    • iniciar sesión con privilegios de administrador
    • acceder a la consola web
      • for example, https://localhost:4503/system/console/configMgr
    • localizar AEM Communities User Sync Listener
    • seleccione la configuración existente para abrirla y editarla (icono de lápiz)Verificar Name : socialpubsync-scheduled-trigger
  • Tipos ​de nodosEsta es la lista de tipos de nodos que se sincronizarán. Cualquier tipo de nodo que no sea sling:Folder debe aparecer aquí (sling:folder se gestiona por separado). lista predeterminada de los tipos de nodo que sincronizar:
    • rep:Usuario
    • nt:unstructured
    • nt:resource
  • Propiedades ​ignorablesEs la lista de propiedades que se omitirán si se detecta algún cambio. Los cambios realizados en estas propiedades pueden sincronizarse como un efecto secundario de otros cambios (ya que la sincronización siempre se encuentra en el nivel de nodo), pero los cambios realizados en estas propiedades no activarán la sincronización por sí mismos. Propiedad predeterminada que se debe ignorar:
    • cq:lastModified
  • Subrutas de nodos ​ignorables que se omitirán por completo durante la sincronización. No se sincronizará nada debajo de estas subrutas en cualquier momento. Nodos predeterminados que se deben ignorar:
    • .tokens
    • sistema
  • Carpetas ​distribuidas La mayoría de sling:Folders se ignoran porque no es necesaria la sincronización. Las pocas excepciones se enumeran aquí. Carpetas predeterminadas para sincronizar
    • segmentos/puntuación
    • social/relaciones
    • actividades

9. ID de Sling único

Si el ID de Sling coincide entre dos o más instancias de publicación, la sincronización de grupos de usuarios fallará.
Si el ID de Sling es el mismo para varias instancias de publicación en un conjunto de servidores de publicación, los grupos de usuarios no se sincronizarán.
Para validar que todos los valores de ID de Sling difieran, en cada instancia de publicación:
  1. buscar http://<host>:<port>/system/console/status-slingsettings
  2. comprobar el valor de Sling ID
Si el ID de Sling de una instancia de publicación coincide con el ID de Sling de cualquier otra instancia de publicación, entonces:
  1. detenga una de las instancias de publicación que tenga un ID de Sling coincidente
  2. en el directorio crx-quickstart/launchpad/felix
    • buscar y eliminar el archivo denominado sling.id.file
      • por ejemplo, en un sistema Linux:
        rm -i $(find . -type f -name sling.id.file)
      • por ejemplo, en un sistema Windows:
        use windows explorer and search for *sling.id.file*
  3. inicio de la instancia de publicación
    • al iniciar, se le asignará un nuevo ID de Sling
  4. validar que el ID de Sling ahora sea único
Repita estos pasos hasta que todas las instancias de publicación tengan un ID de Sling único.

Fábrica del generador de paquetes de almacén

Para que las actualizaciones se sincronizen correctamente, es necesario modificar el creador de paquetes vault para la sincronización del usuario:
  • en cada instancia de publicación de AEM
  • acceder a la consola web
  • ubique la variable Apache Sling Distribution Packaging - Vault Package Builder Factory
    • Builder name: socialpubsync-vlt
  • seleccione el icono de edición
  • agregar dos Package Node Filters :
    • /home/users|-.*/.tokens
    • /home/users|-.*/rep:cache
  • administración de políticas:
    • para sobrescribir nodos rep:policy existentes con otros nuevos, agregue un tercer filtro de paquete:
      • /home/users|+.*/rep:policy
    • para evitar que las políticas se distribuyan, establezca
      • Acl Handling: IGNORE

Qué sucede cuando...

El usuario se registra automáticamente o edita el Perfil al publicar

Por diseño, los usuarios y perfiles creados en el entorno de publicación (autorregistro) no aparecen en el entorno de creación.
Cuando la topología es un conjunto de servidores de publicación y la sincronización de usuarios se ha configurado correctamente, el *usuario *y el perfil del usuario se sincronizan en el conjunto de servidores de publicación mediante la distribución Sling.

Los usuarios o grupos de usuarios se crean con la consola de seguridad

Por diseño, los datos de usuario creados en el entorno de publicación no aparecen en el entorno de creación y viceversa.
Cuando se utiliza la consola Administración de usuarios y seguridad para agregar usuarios nuevos en el entorno de publicación, la sincronización de usuarios sincronizará los usuarios nuevos y su pertenencia a grupos con otras instancias de publicación, si es necesario. La sincronización de usuarios también sincronizará los grupos de usuarios creados mediante la consola de seguridad.

Solución de problemas

Cómo desconectar la sincronización de usuarios

Para desactivar la sincronización de usuarios, para eliminar un publicador o sincronizar datos Sincronización manual de usuarios y grupos de usuarios manualmente, la cola de distribución debe estar vacía y silenciosa.
Para comprobar el estado de la cola de distribución:
  • sobre el autor:
    • uso de CRXDE Lite
      • buscar entradas en /var/sling/distribution/packages
        • nodos de carpeta con el patrón distrpackage_*
    • uso del Administrador de paquetes
      • buscar paquetes pendientes (aún no instalados)
        • con el nombre del patrón socialpubsync-vlt*
        • created by communities-user-admin
Cuando la cola de distribución esté vacía, deshabilite la sincronización de usuarios:
Una vez completadas las tareas, para volver a habilitar la sincronización de usuarios:

Diagnóstico de sincronización de usuario

Diagnósticos de sincronización de usuarios es una herramienta que comprueba la configuración e intenta identificar cualquier problema.
En el autor, simplemente desplácese desde la consola principal a través de Herramientas, Operaciones, Diagnóstico de sincronización de usuarios.
Al entrar en la consola Diagnósticos de sincronización de usuarios se mostrarán los resultados.
Esto es lo que se muestra cuando la sincronización de usuarios no se ha activado:

Cómo ejecutar diagnósticos para editores

Cuando el diagnóstico se ejecuta desde el entorno del autor, los resultados de la aprobación o el error incluirán una sección # que muestra la lista de las instancias de publicación configuradas para su confirmación.
En la lista se incluye una dirección URL para cada instancia de publicación que ejecutará los diagnósticos para esa instancia. El parámetro url syncUser se anexa a la dirección URL de diagnóstico con su valor establecido en el usuario de sincronización autorizado creado en el paso 2 .
Nota : antes de iniciar la URL, el usuario de sincronización autorizado ya debe haber iniciado sesión en esa instancia de publicación.

Configuración Añadida incorrectamente

Cuando la sincronización de usuarios no funciona, el problema más común es que se agregaron configuraciones adicionales. En su lugar, la *configuración predeterminada existente debería haberse editado .
A continuación se presentan vistas de cómo deben aparecer las configuraciones predeterminadas y editadas en la consola web. Si aparece más de una instancia, se debe eliminar la configuración agregada.

(autor) Un agente de distribución Apache Sling: fábrica de agentes de sincronización

(autor) Un Apache Sling Distribution Transport Credentials - User Credentials based DistributionTransportSecretProvider

(publicar) Un agente de distribución Apache Sling: fábrica de agentes de cola

(publicar) Una sincronización de Adobe Social: Fábrica de observadores de diferencias

(autor) Un activador de distribución Apache Sling: fábrica de activadores programados

Modificar excepción de operación durante el procesamiento de respuesta

Si en el registro está visible lo siguiente:
org.apache.sling.servlets.post.impl.operations.ModifyOperation Exception during response processing.
java.lang.IllegalStateException: This tree does not exist
A continuación, compruebe que la sección 2. Crear usuario autorizado se siguió correctamente.
En esta sección se describe la creación de un usuario autorizado, que existe en todas las instancias de publicación, y su identificación en la configuración OSGi de 'Proveedor secreto' del autor. By default, the user is admin .
El usuario autorizado debe ser miembro del grupo de usuarios y no se deben modificar los permisos para ese grupo administrators .
El usuario autorizado debe tener explícitamente los siguientes privilegios y restricciones en todas las instancias de publicación:
path
jcr:all
rep:glob
/home
X
/actividades/
/home/users
X
/actividades/
/home/groups
X
/actividades/
Como miembro del administrators grupo, el usuario autorizado debe tener los siguientes privilegios en todas las instancias de publicación:
path
jcr:all
jcr:read
rep:write
/etc/packages/sling/distribution
X
/libs/sling/distribution
X
/var
X
/var/eventing
X
X
/var/sling/distribution
X
X

Error al sincronizar el grupo de usuarios

Si el ID de Sling coincide entre dos o más instancias de publicación, la sincronización de grupos de usuarios fallará.
Véase la sección 9. ID de Sling único

Sincronización manual de usuarios y grupos de usuarios

Para configurar o habilitar la sincronización de usuarios, vaya al paso 1: Agente de distribución Apache Sling: fábrica de agentes de sincronización

Cuando un publicador deja de estar disponible

Cuando una instancia de publicación deja de estar disponible, no debe eliminarse si volverá a estar en línea en el futuro. Los cambios se pondrán en cola para el editor y, una vez que vuelvan a estar en línea, se procesarán.
Si la instancia de publicación nunca volverá a estar en línea, si está sin conexión de forma permanente, debe eliminarse porque la compilación de cola dará como resultado un uso notorio de espacio en disco en el entorno de creación.
Cuando un editor está inactivo, el registro de autor tendrá excepciones similares a:
28.01.2016 15:57:48.475 ERROR
 [pool-12-thread-34-org_apache_sling_distribution_queue_socialpubsync_endpoint1
 (org/apache/sling/distribution/queue/socialpubsync/endpoint1)]
 org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync] could not deliver package distrpackage_1454014575838_a2b45ec8-0400-42f3-bed8-ae09b66381cb
 org.apache.sling.distribution.packaging.DistributionPackageImportException: failed in importing package ...

Cómo eliminar un publicador

Para eliminar un publicador de Apache Sling Distribution Agent - Sync Agent Factory , la cola de distribución debe estar vacía y en silencio.