Obtén información sobre la extensión User Import/Export, que te permite importar y exportar usuarios desde o hacia cualquier base de datos que hayas configurado en tu cuenta.
La extensión User Import/Export quedará obsoleta en septiembre de 2025. Ahora puedes acceder a las mismas funciones directamente en el Auth0 Dashboard.
La extensión User Import / Export te permite:
Importar en bloque tus usuarios de base de datos existentes a Auth0
Buscar y exportar algunos o todos tus usuarios de base de datos de Auth0
Para ver una lista de los campos del perfil de usuario que se pueden importar y exportar, consulta Atributos del perfil de usuario.Debes ser administrador del Dashboard para usar esta extensión.
Para instalar esta extensión, ve a Auth0 Dashboard > Extensiones y selecciona User Import / Export.La extensión no requiere ninguna configuración adicional antes de instalarse, así que selecciona Instalar en la ventana emergente informativa para continuar.
Después de instalar la extensión, la verá en la lista de extensiones instaladas. Haga clic en Import / Export Extension para iniciarla.La primera vez que inicie la extensión, se le pedirá que conceda permiso para que acceda a su cuenta de Auth0 y pueda realizar las actividades indicadas.
Haga clic en la marca de verificación para continuar.Hay dos formas de usar esta extensión:
Importar en bloque los usuarios existentes de su base de datos a Auth0
Buscar y exportar algunos o todos los usuarios de la base de datos de Auth0
Ambos casos de uso se explican con más detalle a continuación.
De forma predeterminada, cada vez que abras la extensión, verás la pantalla Importación de usuarios (si estás en la pantalla de exportación, puedes volver a esta pantalla haciendo clic en Importar en la barra de navegación izquierda).Para importar tus usuarios, arrastra y suelta un archivo JSON válido (esquema y ejemplos aquí) en el área que dice Suelta tu archivo aquí o haz clic para seleccionarlo. Como alternativa, puedes hacer clic en esta área para buscar en tus archivos y seleccionar el archivo JSON correspondiente. El archivo JSON debe contener la lista de usuarios que planeas importar.
Si usas un archivo exportado desde un inquilino de Auth0, debes convertirlo de ndjson a JSON. Para conservar los mismos ID de usuario, debes quitar el prefijo auth0| de todos los ID de usuario importados.El proceso de importación agrega automáticamente el prefijo auth0| a los ID de usuario importados. Si no quitas el prefijo auth0| antes de importar, los ID de usuario quedarán como auth0|auth0|...
Selecciona la conexión de base de datos en la que se importarán tus usuarios. Asegúrate de que la conexión que elijas esté habilitada para al menos una aplicación.Haz clic en Comenzar a importar usuarios para iniciar el proceso de importación.Cuando termine, verás el siguiente mensaje de Completado.
Auth0 usa el formato ndjson debido al gran tamaño de los archivos de exportación. Antes de poder importar usuarios, tendrás que convertir de ndjson a json con la librería que prefieras (como jq). Al exportar usuarios con la intención de importarlos más adelante, los nombres de los campos de usuario deben dejarse con sus valores predeterminados y no asignarse a un Nombre de columna.
Para exportar tus usuarios existentes de Auth0 asociados a conexiones de base de datos, selecciona Exportar.
En Campos de usuario, puedes decidir qué atributos o expresiones de usuario deben incluirse en la exportación. El atributo de usuario puede ser un valor estático como user.user_metadata.name, o puede ser una expresión de JavaScript como user.user_metadata.name || user.name. Las expresiones se evaluarán durante la ejecución de la exportación. El valor de nombre de columna es cómo se representará el valor en la exportación.Puedes hacer clic en el botón Agregar campos predeterminados para seleccionar automáticamente los campos predeterminados y completar sus nombres de columna (esta también es una buena forma de visualizar cómo aparecerán los parámetros o las expresiones).Puedes eliminar atributos o expresiones superfluos haciendo clic en el icono de papelera correspondiente.En Configuración, puedes:
Configurar cómo se listan tus usuarios exportados proporcionando un Atributo de usuario por el que se deben ordenar los usuarios (así como si deben ordenarse en orden ascendente o descendente)
Elegir tu Formato de exportación; puedes elegir entre archivos JSON y CSV
Cuando estés listo, haz clic en Exportar X usuarios (donde X es el número de usuarios que estás exportando).Puedes descargar el archivo que contiene tus usuarios cuando se complete la exportación; es posible que debas usar una herramienta de extracción de terceros si usas Windows 10 o una versión anterior.
Mediante el proceso de exportación anterior, cree un archivo de exportación completo que incluya todos los atributos de sus usuarios.Elija el formato JSON para la exportación.Cuando la exportación se haya completado, descargue el archivo que contiene sus usuarios.
Haz una copia del archivo JSON que descargaste en el paso anterior.
Este proceso puede provocar la pérdida de datos. Crea una copia de seguridad de tu base de datos de usuarios por si se produce algún tipo de corrupción de datos.
Abre la copia del archivo JSON en un editor de texto. El esquema de usuario debería ser similar al siguiente:
No cambie la dirección de correo electrónico del usuario, ya que es la clave de búsqueda de los usuarios en la base de datos.
El id debe tener un connection|id único. Si el mismo id de usuario existe en varias conexiones, la actualización fallará.
Para agregar un atributo, cree un campo nuevo en cada esquema de usuario y asígnele un valor. En el ejemplo siguiente, el atributo “Apellido” tiene el valor “Smith”, seguido de una coma.También puede agregar el atributo email_verified a varios usuarios y establecer su valor en true.
Importar datos actualizados del perfil del usuario
El endpoint users-import le permite cargar un archivo actualizado con perfiles de usuario y actualizar varios usuarios en un solo trabajo. Vaya al endpoint Create import users job.Agregue el archivo de usuarios al parámetro users y el ID de la conexión de base de datos que desea actualizar.El valor de upsert debe ser true para actualizar la información de usuarios ya existentes.
Para aplicar las actualizaciones, seleccione Try o use Postman para importar los usuarios.Use job_id para verificar el estado con el endpoint jobsendpoint.
Autenticar
Administrar usuarios
Personalizar
Auth0 AI
Plataforma
