Sincronización e integraciones

La sincronización replica automáticamente en Users a las personas de tus otros sistemas, para que el acceso a las puertas siga a los datos de la fuente externa sin ingresarlos manualmente. Esta página trata las tres fuentes de sincronización, la sincronización del personal de Performance Hub, los identificadores, las Access Time Windows propiedad de la fuente, la vigencia y la asignación de alcances, las eliminaciones, la resolución de duplicados, el panel de actividad de sincronización, las invitaciones y la eliminación masiva. Configura todo en Settings → Sync settings.

La sincronización de Performance Hub staff está activada de forma predeterminada. La sincronización de integraciones y de Computer Vision está desactivada de forma predeterminada para que las instalaciones existentes conserven su lista administrada manualmente; no se sincroniza nada desde ellas hasta que habilites la fuente.

Fuentes de sincronización

Figura 1: Configuración de sincronización

Cada bloque tiene su propio interruptor de habilitación y muestra la hora de su última ejecución y sus recuentos (o Never run).

Para la fuente Integrations, también puedes incluir o excluir integraciones individuales en Sync from these integrations: "Desactiva una integración para dejar de replicar a sus personas. Las personas ya sincronizadas permanecen hasta que las elimines." Show all integrations expande la lista completa.

Exigir identificador

Las personas inician sesión en la aplicación móvil con un código de un solo uso que se envía a su teléfono o correo electrónico, por lo que un registro sin ninguno de los dos no sirve para el acceso a las puertas. La lista desplegable Require identifier controla qué registros se sincronizan:

Los registros que no cumplen el requisito se omiten (y aparecen en el panel de actividad de sincronización como omitidos por falta de identificador).

Asignación de Access Time Windows y vigencia de la fuente

Cada integración que proporciona Access Time Windows tiene su propia configuración:

• Access Time Window mapping: "Asigna cada clave de alcance del socio a puertas de la instalación o a alcances de acceso. Las claves desconocidas y sin asignar se cierran por seguridad." Cada integración puede tener hasta 50 asignaciones, incluida la clave default. Agrega una clave en Add partner scope key.
• Source freshness policy: una configuración de seguridad: "Elige qué antigüedad puede tener una instantánea del socio antes de que todas sus ventanas se cierren por seguridad." Configúrala según la frecuencia con la que la integración se compromete a enviar actualizaciones, para que las ventanas de una integración que dejó de actualizarse no sigan concediendo acceso.

Consulta Instantáneas de Access Time Windows para ver cómo se actualizan las ventanas de las integraciones.

Personal de Performance Hub

Figura 2: La fuente Performance Hub staff

"Cualquier persona cuyos roles de Performance Hub abarquen esta instalación se agrega automáticamente a Users y se mantiene sincronizada con IAM de Performance Hub." Por ejemplo, el personal de las tiendas de una cadena minorista obtiene acceso a la puerta de la trastienda sin que nadie lo agregue manualmente.

• El personal (usuarios de Performance Hub) se sincroniza con las etiquetas Performance Hub staff, Role: … (una por rol) y, en el caso de los administradores de la organización, Organisation admin.
• Se crea una vez por instalación una Access Policy editable Performance Hub staff, que deja pasar esa etiqueta por todas las puertas en cualquier momento. La tarjeta muestra si la política está activa, con Edit policy. Edítala o desactívala como cualquier otra Access Policy.
• Roles muestra qué roles se incluyen. Los roles que se incluyen o excluyen los configura un administrador de la organización en Organisation Settings; los demás administradores ven "Pide a un administrador de la organización que cambie esto en Organisation Settings."
• Para desactivar la sincronización se pide una confirmación ("¿Desactivar la sincronización del personal de Performance Hub?").

Los datos del personal se administran en IAM de Performance Hub y son de solo lectura en Users. Para retirar el acceso a las puertas de un miembro del personal, consulta Users → Personal de Performance Hub.

Cuándo se ejecuta la sincronización

Qué actualiza la sincronización y qué nunca modifica

En cada pasada, las filas sincronizadas se actualizan desde la fuente:

Así que puedes desactivar con seguridad a un usuario sincronizado, darle concesiones o etiquetarlo: la sincronización no lo deshará.

Desacoplamiento: si desactivas Track source updates en el panel de un usuario, la sincronización omite esa fila por completo: las ediciones del nombre o de los datos de contacto se mantienen, y las eliminaciones en la fuente ya no le afectan. Consulta Users.

En el caso de una fuente que proporciona Access Time Windows, el desacoplamiento también borra las ventanas de esa fuente tras una confirmación explícita. Al volver a acoplar, se restauran en la siguiente instantánea completa correcta; no se restauran las ventanas almacenadas en caché de una obtención fallida.

Eliminaciones

Cuando se elimina a un miembro en la integración, se elimina su acceso a las puertas (Removed by integration). Su fila en Users no se elimina, por lo que se conserva su historial.

Si una sincronización fuera a eliminar a un número inusualmente grande de personas a la vez, esas eliminaciones se retienen para su revisión (N removals held back for review). Las eliminaciones originadas por una integración que superan un límite de seguridad esperan a que un administrador las revise antes de aplicarse, de modo que una obtención defectuosa desde una integración no pueda retirar el acceso a todos a la vez.

Instantáneas de Access Time Windows

Cada integración actualiza solo su propia partición de fuente. Su actualización de miembros es una instantánea completa de ventanas con revisiones monótonamente crecientes:

• Si se omiten los datos de las ventanas, la instantánea actual de la fuente no cambia.
• Una instantánea más reciente reemplaza la lista completa de esa fuente.
• La misma revisión con la misma carga útil normalizada es una repetición idempotente.
• La misma revisión con datos diferentes es un conflicto; una revisión más antigua se omite por obsoleta.
• Una instantánea vacía más reciente revoca explícitamente las ventanas de esa fuente.
• Una obtención fallida o incompleta en el sistema de origen no debe enviar ninguna instantánea, nunca una vacía o parcial.

Cada scope_key estable de la fuente (incluido default) se asigna a destinos de toda la instalación, de puertas o de alcances de acceso en Asignación de Access Time Windows. Las asignaciones desconocidas o deshabilitadas se cierran por seguridad. La configuración también muestra la antigüedad de la fuente y la política de vigencia de la fuente de la integración.

Resolución de duplicados

Figura 3: Resolución de duplicados

"Cuando dos personas comparten un correo electrónico o un número de teléfono, solo una puede sincronizarse en Users. Elige quién conserva el lugar; la otra se marca como conflicto y no se sincroniza."

• Prefer the active person: "Una persona con estado activo siempre prevalece sobre una vencida. Desactívalo para aplicar el criterio de desempate independientemente del estado."
• Tiebreaker: se usa cuando el estado no determina quién prevalece, por ejemplo, Oldest By Date Of Birth, Then Earliest Start Date.

El otro registro muestra Not synced – duplicate en Users y se cuenta en el mosaico Not synced. Por ejemplo, una clínica puede conservar un solo registro cuando un profesional clínico es a la vez miembro del personal y paciente.

Invitaciones automáticas a la aplicación

En App invitations, Auto-send app invitations envía un correo electrónico a los usuarios sincronizados aptos que aún no han recibido una invitación, y Advanced recipient rules puede limitar quién las recibe. Send invitations… envía invitaciones de forma masiva a los usuarios existentes después de que revises la lista de destinatarios. Encontrarás todos los detalles en Invitaciones.

Actividad de sincronización y solución de problemas

Expande Sync activity & troubleshooting para "ver por qué los registros recientes se sincronizaron o no." Puedes buscar por nombre, ID o motivo, y actualizar la lista con Refresh. Cada entrada tiene una insignia de resultado:

Motivos de omisión que puedes ver:

Al hacer clic en una entrada se abre Sync activity detail con el registro completo: nombre, ID externo, fuente, integración, motivo e ID para escalar el caso al soporte.

Eliminación masiva de usuarios sincronizados

Para quitar los usuarios que provienen de una integración (por ejemplo, después de desconectarla), usa Bulk delete synced users. Revisas la lista exacta antes de que se elimine nada.

1. En Bulk delete synced users, haz clic en Bulk delete…
2. Elige el alcance: All integration-synced users o una sola integración. Haz clic en Preview.
3. Revisa: el cuadro de diálogo muestra exactamente cuántos usuarios se eliminarán (con una lista de muestra). Ten en cuenta la advertencia: This cannot be undone, y se pierden las personalizaciones del administrador en esas filas (concesiones, etiquetas personalizadas, notas). Se conserva el historial del registro de acceso de los usuarios.
4. Also turn off syncing from this integration (recommended) está marcada de forma predeterminada; déjala activada; de lo contrario, los mismos usuarios se vuelven a crear en la siguiente pasada de sincronización (sin sus personalizaciones anteriores).
5. Marca I understand this is permanent and customisations will be lost y luego haz clic en Delete N.

Si el conjunto de usuarios subyacente cambió entre la vista previa y la confirmación, se te pedirá que vuelvas a ejecutar la vista previa; así se garantiza que elimines exactamente lo que revisaste.

Páginas relacionadas

• Users: fuentes, desacoplamiento, el panel del usuario
• Programaciones de Access Policies: programaciones y la configuración de Access Time Windows
• Invitaciones
• Solución de problemas: guías paso a paso para "usuario que falta o desactualizado"