Skip to main content
L’extension User Import/Export deviendra obsolète en septembre 2025. Vous pouvez dès maintenant accéder aux mêmes fonctionnalités directement dans l’Auth0 Management Dashboard.
L’extension User Import / Export vous permet de :
  • Importer en bloc les utilisateurs existants de votre base de données dans Auth0
  • Rechercher et exporter certains ou tous vos utilisateurs de base de données Auth0
Pour obtenir la liste des champs du profil utilisateur pouvant être importés et exportés, consultez Attributs du profil utilisateur. Vous devez être administrateur du Auth0 Dashboard pour utiliser cette extension.

​
Installer l’extension

Pour installer cette extension, accédez à Auth0 Dashboard > Extensions, puis sélectionnez User Import / Export. L’extension ne nécessite aucune configuration supplémentaire avant l’installation. Pour continuer, sélectionnez Install dans la fenêtre contextuelle d’information.

​
Utiliser l’extension

Après avoir installé l’extension, vous la verrez dans la liste de vos extensions installées. Cliquez sur Import / Export Extension pour la lancer. La première fois que vous lancerez l’extension, vous devrez l’autoriser à accéder à votre compte Auth0 pour les activités indiquées.
Auth0 Dashboard Extensions : autoriser l’extension d’importation/exportation des utilisateurs
Cliquez sur la coche pour continuer. Il existe deux façons d’utiliser cette extension :
  • Importer en bloc les utilisateurs existants de votre base de données dans Auth0
  • Rechercher et exporter certains ou tous les utilisateurs de votre base de données Auth0
Ces deux cas d’utilisation sont expliqués plus en détail ci-dessous.

​
Importer des utilisateurs

Par défaut, chaque fois que vous ouvrez l’extension, l’écran Importation d’utilisateurs s’affiche (si vous êtes sur l’écran d’exportation, vous pouvez revenir à cet écran en cliquant sur Importer dans la barre de navigation de gauche). Pour importer vos utilisateurs, glissez-déposez un fichier JSON valide (schéma et exemples ici) dans la zone indiquant Déposez votre fichier ici ou cliquez pour le sélectionner. Vous pouvez aussi cliquer sur cette zone pour parcourir vos fichiers et sélectionner le fichier JSON approprié. Le fichier JSON doit contenir la liste des utilisateurs que vous prévoyez importer.
Si vous utilisez un fichier d’exportation provenant d’un locataire Auth0, vous devez convertir le fichier exporté de ndjson en JSON. Pour conserver les mêmes ID d’utilisateur, vous devez supprimer le préfixe auth0| de tous les ID d’utilisateur importés.Le processus d’importation ajoute automatiquement le préfixe auth0| aux ID d’utilisateur importés. Si vous ne supprimez pas le préfixe auth0| avant l’importation, les ID d’utilisateur seront renvoyés sous la forme auth0|auth0|...
Sélectionnez la connexion de base de données dans laquelle vos utilisateurs seront importés. Assurez-vous que la connexion choisie a été activée pour au moins une application. Cliquez sur Commencer l’importation des utilisateurs pour lancer le processus d’importation. Une fois l’opération terminée, le message Terminé suivant s’affiche.
Auth0 Dashboard Extensions Users Import Export Importation terminée
Une fois vos utilisateurs importés, vous pouvez les gérer individuellement dans Auth0 Dashboard > Gestion des utilisateurs > Utilisateurs.

​
Exporter des utilisateurs

Auth0 utilise le format ndjson en raison de la taille importante des fichiers d’exportation. Avant de pouvoir importer des utilisateurs, vous devrez convertir le format ndjson en json à l’aide de la bibliothèque de votre choix (comme jq). Lorsque vous exportez des utilisateurs qui seront importés plus tard, les noms des champs utilisateur doivent être laissés par défaut et ne pas être mappés à un nom de colonne.
Pour exporter vos utilisateurs Auth0 existants associés à des connexions de base de données, sélectionnez Export.
Page Export Users de Dashboard Extensions Users Import Export
Sous User Fields, vous pouvez choisir quels attributs ou expressions utilisateur doivent être inclus dans l’exportation. L’attribut utilisateur peut être une valeur statique comme user.user_metadata.name, ou une expression JavaScript comme user.user_metadata.name || user.name. Les expressions seront évaluées au moment de l’exportation. La valeur column name détermine comment la valeur sera représentée dans l’exportation. Vous pouvez cliquer sur le bouton Add Default Fields pour sélectionner automatiquement les champs par défaut et renseigner leurs noms de colonne (c’est aussi un bon moyen de visualiser comment les paramètres/expressions s’afficheront). Vous pouvez supprimer les attributs/expressions inutiles en cliquant sur l’icône de corbeille associée. Sous Settings, vous pouvez :
  • Configurer l’affichage de vos utilisateurs exportés en fournissant un User Attribute selon lequel les utilisateurs doivent être triés (ainsi qu’en indiquant si le tri doit être en ordre croissant ou décroissant)
  • Choisir votre Export Format ; vous pouvez choisir entre les fichiers JSON et CSV
    Dashboard Extensions Users Import Export Settings Export Format
Lorsque vous êtes prêt, cliquez sur Export X Users (où X correspond au nombre d’utilisateurs que vous exportez). Vous pouvez télécharger le fichier contenant vos utilisateurs une fois l’exportation terminée; vous devrez peut-être utiliser un outil d’extraction tiers si vous utilisez Windows 10 ou une version antérieure.

​
Mettre à jour les utilisateurs

Le d’Auth0 permet de mettre à jour en lot les profils d’utilisateur dans user_metadata et app_metadata à l’aide de l’extension User Import/Export.
Auth0 ne prend actuellement pas en charge l’importation en lot pour Passwordless. Utilisez Auth0 Management API pour mettre à jour les utilisateurs individuellement.

​
Exporter les utilisateurs

À l’aide du processus d’exportation ci-dessus, créez un fichier d’exportation complet contenant tous les attributs de vos utilisateurs. Choisissez le format JSON pour l’exportation. Téléchargez le fichier contenant vos utilisateurs une fois l’exportation terminée.

​
Mettez à jour votre configuration

Faites une copie du fichier JSON que vous avez téléchargé à l’étape précédente.
Ce processus peut entraîner une perte de données. Créez une sauvegarde de votre base de données des utilisateurs en cas de corruption des données.
Ouvrez la copie du fichier JSON dans un éditeur de texte. Votre schéma d’utilisateur devrait ressembler à celui ci-dessous :
Ne modifiez pas l’adresse courriel de l’utilisateur, car elle sert de clé de recherche pour les utilisateurs dans la base de données.
L’Id doit avoir un connection|id unique. Si le même Id d’utilisateur existe dans plusieurs connexions, votre mise à jour échouera.
Pour ajouter un attribut, créez un nouveau champ dans chaque schéma utilisateur et attribuez-lui une valeur. Dans l’exemple ci-dessous, l’attribut “Nom de famille” a la valeur “Smith”, avec une virgule après la valeur du nouvel attribut. Vous pouvez aussi ajouter l’attribut email_verified à plusieurs utilisateurs et définir sa valeur sur true.
Enregistrez les modifications apportées à votre fichier d’utilisateur.
Ce processus ne permet pas de bloquer plusieurs utilisateurs. Vous devez bloquer les utilisateurs individuellement dans l’Auth0 Dashboard ou au moyen de l’Auth0 Management API.

​
Importer des données de profil utilisateur mises à jour

Le point de terminaison users-import vous permet de téléverser votre fichier de profils utilisateur mis à jour et de mettre à jour plusieurs utilisateurs en une seule tâche. Accédez au point de terminaison de création d’une tâche d’importation d’utilisateurs. Ajoutez votre fichier d’utilisateurs au paramètre users, puis ajoutez l’ID de la connexion à la base de données que vous souhaitez mettre à jour. La valeur upsert doit être true pour mettre à jour les renseignements des utilisateurs existants. Pour appliquer vos mises à jour, sélectionnez Try ou utilisez Postman pour importer les utilisateurs. Utilisez le job_id pour vérifier l’état à l’aide du point de terminaison jobs endpoint.