Sincronización de identidades
Mantén los usuarios y grupos de la consola de administración alineados con tu directorio. Esta página resume los métodos de sincronización disponibles, explica cómo sincronizar con SCIM o con un archivo CSV desde la consola y reúne las preguntas frecuentes.
| Origen | Mecanismo | Guía |
|---|---|---|
| Active Directory local | Agente Ironchip AD Connect, que lee el AD y lo envía por SCIM | AD Connect |
| Microsoft Entra ID | Aplicación empresarial con aprovisionamiento SCIM | Entra ID |
| Directorio LDAP | Comando sync-users del proxy LDAP de Ironchip |
Proxy LDAP |
| Otro directorio | Credencial SCIM creada en la consola | SCIM en la consola |
| Archivo CSV | Plantilla que se carga desde la consola | Sincronizar usuarios con un archivo CSV |
En la consola, el menú Directory > Synchronization tiene dos opciones: CSV, para sincronizar con un archivo, y SCIM, para la sincronización automática.
SCIM en la consola
Sección titulada «SCIM en la consola»SCIM (System for Cross-domain Identity Management) sincroniza de forma automática los usuarios y grupos de tu directorio con Ironchip. Cualquier alta, cambio o baja en el directorio llega a la consola sin gestionar los usuarios a mano. Para usarlo, crea una credencial SCIM en la consola y configúrala en el origen: AD Connect, Entra ID u otro sistema compatible con SCIM 2.0.
-
Ve a Directory > Synchronization > SCIM. La página Synchronization with SCIM tiene dos pestañas: Get Started y Credentials.
-
En Get Started, copia la Base URL: con el botón de copiar:
https://api.ironchip.com/scim/v2. La pestaña resume también los pasos de la integración, las acciones admitidas (User Provisioning y Group Management) y el método de autenticación (Bearer).
-
Abre la pestaña Credentials y haz clic en Add credential. Confirma con Add en la ventana Add a new credential.
-
La ventana SCIM credentials muestra la API KEY. Cópiala con el icono de copiar o descárgala con Download credentials (
credentials.json). Por seguridad, la consola no vuelve a mostrarla.
-
Configura el origen con la Base URL y la API KEY, que el origen envía como token Bearer. Los pasos de la pestaña Get Started llaman a la API KEY Authentication Token, y cada origen usa sus propios nombres:
En Ironchip En Entra ID Base URL URL de inquilino (Tenant URL) API KEY Token secreto (Secret Token) En AD Connect, la API KEY se llama SCIM synchronization key.
La pestaña Credentials lista las credenciales con su pista (Hint) y su fecha (Date), y puedes buscar por pista. Para retirar una, haz clic en Delete en su fila y confirma. El origen que la use deja de poder sincronizar.
Qué sincroniza SCIM
Sección titulada «Qué sincroniza SCIM»Ironchip expone los recursos /scim/v2/Users, /scim/v2/Groups y /scim/v2/Schemas. Con los usuarios hace esto:
name.givenNamepasa al nombre yname.familyName, a los apellidos.emailspasa al correo; si hay varios, se usa primero el principal. Si no llega ningún correo, se usauserNamecuando es una dirección válida.activeactiva o desactiva la protección de Ironchip del usuario. No borra al usuario.titlepasa al puesto.- Los atributos de la extensión empresarial, los de la extensión de Ironchip y el resto se guardan como atributos personalizados del usuario.
Para saber si un usuario ya existe, Ironchip lo busca por emails, userName, externalId e immutableId.
Active Directory y LDAP
Sección titulada «Active Directory y LDAP»En la consola no hay una opción de sincronización con LDAP. Un Active Directory o un directorio LDAP se sincronizan con uno de estos plugins, que se descargan desde Plugins (consulta Plugins):
- AD Connect: agente que se instala en tu red, lee los usuarios y grupos del AD por LDAP o LDAPS y los envía a Ironchip por SCIM, con la API KEY de una credencial SCIM de la consola. Consulta AD Connect.
- LDAP: el proxy LDAP se sitúa delante del controlador de dominio para proteger la autenticación LDAP. Incluye el comando
sync-users, que importa los usuarios del directorio en Ironchip cuando lo ejecutas.
Sincronización con Entra ID mediante SCIM
Sección titulada «Sincronización con Entra ID mediante SCIM»Esta integración sincroniza de forma automática los usuarios de tu organización desde Microsoft Entra ID (antes Azure AD) hacia la consola de Ironchip. Con el protocolo SCIM, cualquier usuario o grupo que asignes a tu aplicación empresarial se aprovisiona en Ironchip sin gestión manual. También puedes mapear atributos de los usuarios de Entra ID con los campos de Ironchip.
El proceso se resume así:
- Configuración en Ironchip. Crea en la consola de administración una credencial SCIM y copia la Base URL y la API KEY. Consulta SCIM en la consola.
- Aprovisionamiento en Entra ID. En el portal de Microsoft Entra ID, añade la aplicación de Ironchip y escribe esos valores en URL de inquilino y Token secreto, en Aprovisionamiento.
- Mapeo de atributos. Define qué campos (nombre, correo, grupos) se sincronizan. Ironchip usa estos datos para crear y actualizar usuarios, y para activar o desactivar su protección.
- Sincronización continua. Los cambios en el directorio, como dar de baja a un empleado o cambiarlo de departamento, llegan a Ironchip en los ciclos de aprovisionamiento de Entra ID, cuya frecuencia gestiona Microsoft.
La guía completa está en Sincronizar usuarios con Entra ID.
Sincronizar usuarios con un archivo CSV
Sección titulada «Sincronizar usuarios con un archivo CSV»La sincronización con CSV permite dar de alta el número de usuarios que quieras con un único archivo, en un grupo de la compañía.
-
Ve a Directory > Synchronization > CSV y haz clic en Synchronize. Se abre la ventana CSV synchronization, con cuatro pasos: Template download, Template upload, Sync options y Summary.

-
En el paso Template download, haz clic en Download template y después en Next. Si ya tienes una plantilla, puedes saltar este paso.

-
Rellena la plantilla
synchronization_template.csvcon los datos de los usuarios. Tiene las columnasID,Name,Surname,Email,Lang,ImmutableID,ExternalEmail,MaxDevicesySelfInvite, másPhoneNumbersi tu compañía tiene activada la autenticación por SMS y una columna por cada atributo personalizado de usuario. No cambies la extensión.csvni los nombres de las columnas. -
En el paso Template upload, arrastra la plantilla rellena a la zona indicada, o haz clic en la zona para seleccionarla desde el explorador de archivos. Solo se admiten ficheros
.csv.
-
Cuando la plantilla se haya cargado correctamente, haz clic en Next. Con Back vuelves al paso anterior.
-
En el paso Sync options, elige el grupo en la tabla Select group. Puedes buscarlo con Search by group name; solo aparecen los grupos de la compañía, no los grupos personales de cada usuario. El grupo elegido aparece en GROUP SELECTION, con el aviso de que se actualizará con los miembros del archivo; para cambiarlo, haz clic en la X roja.
-
En SYNCHRONIZATION OPTIONS, elige qué pasa con los usuarios que ya están en el grupo pero no en el archivo, y si se invita a los nuevos:
- Delete them from the selected group. Se quitan del grupo y pierden los accesos que les daba.
- Also delete them from the platform. Además, se eliminan de la plataforma con todos sus datos, claves y accesos.
- Enable invitation to Ironchip for the synchronized users. Los usuarios sincronizados reciben la invitación para usar la app de Ironchip y quedan protegidos por Ironchip. Si no la marcas, no quedan protegidos.

-
Haz clic en Next.
-
En el paso Summary, revisa el resumen final de la sincronización:
- La plantilla importada (Import template:).
- El grupo al que se añaden los usuarios sincronizados.
- Si los usuarios sincronizados quedan o no protegidos por Ironchip.
- Qué pasa con un usuario del grupo que no está en los nuevos datos: se queda en él, sale del grupo o, además, se elimina de la plataforma, según lo que elegiste.

-
Marca I have read the synchronization summary and understand the implications. y haz clic en Add. Si tienes dudas, vuelve a las pantallas anteriores con Back.
Solo puede haber una importación en curso por compañía, y el nombre del archivo no puede repetir el de una sincronización anterior.
Consultar el resultado
Sección titulada «Consultar el resultado»La página Synchronization with CSV lista las sincronizaciones con las columnas Updated group, File name, Date, Status, Users y Manage. La columna Users muestra los usuarios sincronizados sobre el total del archivo, y Status indica si la sincronización se completó, quedó incompleta o sigue en curso. Puedes buscar con Find report.
- Al seleccionar una fila, el panel Synchronization details muestra la fecha, el grupo, el archivo y el resultado.
- Options > View report abre la ventana Synchronization report, con la fecha (Synchronization date:), el grupo (Synchronized group:), el archivo (Synchronized file:), los usuarios sincronizados (Synchronized users:) y los errores de cada línea del archivo con el formato
[line N]: correo: mensaje.
Preguntas frecuentes
Sección titulada «Preguntas frecuentes»¿Qué métodos hay para integrar Ironchip con Active Directory?
Sección titulada «¿Qué métodos hay para integrar Ironchip con Active Directory?»Hay cuatro:
- Agente AD Connect: el método más común para AD local. Lee el AD y sincroniza usuarios y grupos de forma automática por SCIM.
- Proxy LDAP: protege la autenticación LDAP de un grupo del directorio, y su comando
sync-usersimporta los usuarios cuando lo ejecutas. - Entra ID mediante SCIM: para entornos en la nube o híbridos.
- AD con Windows Logon: el agente añade Ironchip como proveedor de credenciales adicional sobre AD. Consulta Inicio de sesión en Windows.
¿Qué diferencia hay entre el proxy LDAP y AD Connect?
Sección titulada «¿Qué diferencia hay entre el proxy LDAP y AD Connect?»- AD Connect: instala un agente en la red que mantiene sincronizados los usuarios y grupos de forma automática. Es lo ideal para AD local y admite grupos y atributos.
- Proxy LDAP: se pone delante del controlador de dominio para proteger con Ironchip la autenticación LDAP de los usuarios de un grupo. La sincronización no es automática: la lanzas tú con el comando
sync-users.
La consola muestra menos usuarios que el Active Directory
Sección titulada «La consola muestra menos usuarios que el Active Directory»Las causas más habituales son:
- Grupos hijo sin sincronizar: el agente puede no sincronizar todos los miembros de los subgrupos anidados.
- Configuración incorrecta del grupo con invitación automática (
Autoinvite) en Ironchip. Consulta Invitación automática.
Para resolverlo, escribe a soporte indicando el nombre del grupo afectado, para que verifiquen la versión del agente y la configuración.
¿Cómo se gestionan los grupos anidados (grupos hijo) de Active Directory?
Sección titulada «¿Cómo se gestionan los grupos anidados (grupos hijo) de Active Directory?»Al configurar la sincronización, indica de forma explícita si se sincronizan los miembros de los grupos hijo. El grupo hijo debe estar asociado al grupo de Ironchip correspondiente. Los grupos hijo que añadas después de la configuración inicial pueden requerir un ajuste manual.
¿Cómo se actualiza el agente de AD Connect?
Sección titulada «¿Cómo se actualiza el agente de AD Connect?»La actualización requiere una sesión técnica conjunta entre Ironchip y tu equipo de IT. Ironchip valida la actualización antes de la sesión. Escribe a support@ironchip.com para coordinarla.
¿Se puede migrar la configuración de Ironchip entre entornos de AD?
Sección titulada «¿Se puede migrar la configuración de Ironchip entre entornos de AD?»Sí, pero requiere coordinación previa con el equipo técnico de Ironchip. El proceso incluye:
- Exportar la configuración de origen.
- Validar la compatibilidad del nuevo AD.
- Configurar el conector.
- Verificar la sincronización.
- Mantener un periodo de coexistencia si la migración es gradual.
¿Te ha resultado útil esta página?
Gracias. Lo tendremos en cuenta para mejorar la documentación. Si quieres contarnos qué falta o qué no está claro, escríbenos a support@ironchip.com.