Importación y Exportación de Usuarios

Auris proporciona herramientas de importación y exportación masiva de datos de usuarios. Importa usuarios desde archivos CSV o JSON al migrar desde otro proveedor de identidad, al incorporar un nuevo departamento o al inicializar un entorno de staging. Exporta tu base de datos de usuarios para copia de seguridad, auditorías de cumplimiento o migración a otro sistema.

Accede en Consola → Configuración → Importar / Exportar.

Importar Usuarios

El flujo de importación te guía a través de la carga del archivo, la vista previa de datos y el procesamiento. Las importaciones se ejecutan de forma asíncrona — puedes navegar a otra página y comprobar el progreso más tarde.

Tutorial de Importación

Requisitos de Formato de Archivo

Formato CSV

La primera fila debe ser una fila de encabezado con nombres de columna. Los valores que contengan comas deben estar entre comillas. Los campos de múltiples valores (como roles) deben estar entre comillas y separados por comas dentro de las comillas.

email,firstName,lastName,password,roles
[email protected],Alice,Smith,SecureP@ss123,editor
[email protected],Bob,Jones,AnotherP@ss456,"editor,viewer"
[email protected],Carol,Williams,,viewer

En el ejemplo anterior, Carol no tiene contraseña — necesitará usar Olvidé Contraseña o Magic Link para establecer una.

Formato JSON

El archivo debe contener un array JSON de objetos de usuario. Cada objeto sigue la misma estructura de campos que las columnas CSV.

[
  {
    "email": "[email protected]",
    "firstName": "Alice",
    "lastName": "Smith",
    "password": "SecureP@ss123",
    "roles": ["editor"]
  },
  {
    "email": "[email protected]",
    "firstName": "Bob",
    "lastName": "Jones",
    "password": "AnotherP@ss456",
    "roles": ["editor", "viewer"]
  },
  {
    "email": "[email protected]",
    "firstName": "Carol",
    "lastName": "Williams",
    "roles": ["viewer"]
  }
]

Procesamiento de la Importación

Tras hacer clic en Iniciar Importación, la importación se ejecuta de forma asíncrona. Cada fila se procesa secuencialmente:

1. El email se valida en cuanto a formato y unicidad
2. Si se proporciona una contraseña, se hashea con bcrypt
3. El usuario se crea en Prisma (base de datos de Auris)
4. El usuario se crea en Keycloak (backend de autenticación)
5. Si se especifican roles, el usuario se asigna a esos roles
6. El contador de progreso de la importación se incrementa

Historial de Importaciones

La sección Importar muestra una tabla con el historial de todos los trabajos de importación:

Estados de Importación

Ver Detalles de Errores

Haz clic en cualquier importación con estado Parcial o Fallida para ver los detalles de error por fila:

Errores comunes por fila:

Exportar Usuarios

Exporta tu base de datos de usuarios a un archivo CSV o JSON para copia de seguridad, migración o propósitos de cumplimiento.

Tutorial de Exportación

Campos Exportados

La exportación incluye los siguientes campos para cada usuario:

Historial de Exportaciones

La sección Exportar muestra una tabla con el historial de todos los trabajos de exportación:

Los archivos de exportación se eliminan automáticamente 24 horas después de su generación. Si necesitas el archivo después de que expire, ejecuta una nueva exportación.

Referencia de la API

Las operaciones de importación y exportación también están disponibles mediante la API REST para automatización y pipelines CI/CD.

Buenas Prácticas

1. Prueba primero con un archivo pequeño. Antes de importar 10.000 usuarios, prueba con un archivo de 5-10 usuarios para verificar que el mapeo de columnas y los nombres de roles son correctos.

2. Crea los roles previamente. La importación no crea roles sobre la marcha. Los nombres de roles referenciados en el archivo de importación deben existir ya en Consola → Roles.

3. Usa un formato de email consistente. Auris trata las direcciones de email como insensibles a mayúsculas/minúsculas, pero la capitalización original se preserva. Evita mezclar [email protected] y [email protected] en el mismo archivo.

4. Programa importaciones grandes durante horas de poco tráfico. Cada usuario importado genera una llamada a la API de Keycloak. Para importaciones con miles de usuarios, esto genera una carga significativa en Keycloak.

5. Mantén los archivos de exportación seguros. Aunque las exportaciones no contienen contraseñas, sí contienen direcciones de email, nombres y asignaciones de roles. Trata los archivos de exportación como datos sensibles.

Permisos

Guías Relacionadas

• Gestión de Usuarios — Crear y gestionar usuarios individuales en la Consola
• Guía de Importación y Exportación de Usuarios — Guía detallada para desarrolladores con ejemplos de scripting
• Usuarios y Roles — Gestión de usuarios y roles en la Consola
• Aprovisionamiento SCIM — Aprovisionamiento automatizado desde IdPs empresariales como alternativa a la importación manual