Importation/exportation en masse d’utilisateurs

Instructions sur la façon d’importer et d’exporter en masse des données utilisateur dans Auth0 à l’aide de l’Auth0 Dashboard.

Avant de commencer

Pour utiliser cette fonctionnalité, vous devez disposer des autorisations Editor - Users ou Admin. Pour en savoir plus sur les rôles de l’Auth0 Dashboard, consultez Accès au Dashboard selon le rôle.

Vous pouvez importer et exporter en masse des données utilisateur dans Auth0 à l’aide de l’Auth0 Dashboard. Les importations et exportations en masse sont utiles pour migrer des utilisateurs d’une base de données existante vers Auth0, ou d’Auth0 vers un autre service. Toutes les tâches lancées depuis l’Auth0 Dashboard sont consignées et suivies à l’aide d’ID de tâche.

Pour obtenir la liste des champs de profil utilisateur qui peuvent être importés et exportés, consultez Profils utilisateur.

​

Importer des utilisateurs

Pour importer des utilisateurs dans votre locataire :

1. Dans l’Auth0 Dashboard, accédez à Gestion des utilisateurs > Utilisateurs. S’il n’y a aucun utilisateur dans votre locataire, choisissez Importer des utilisateurs. S’il y a déjà des utilisateurs, choisissez Importer/Exporter des utilisateurs > Importer des utilisateurs.

2. Téléversez un fichier JSON (taille maximale de 500 ko) mis en forme selon les spécifications indiquées ici.

3. Sélectionnez la connexion de base de données dans laquelle importer les utilisateurs. Notez que seules les connexions de base de données sont prises en charge et que la connexion de base de données personnalisée choisie doit avoir le mode d’importation activé pour au moins une application.

   1. (Facultatif) Sélectionnez Mettre à jour les utilisateurs existants dans la connexion pour mettre à jour les utilisateurs existants ayant des identifiants correspondants
   2. (Facultatif) Sélectionnez Envoyer un courriel de fin de traitement à tous les propriétaires du locataire.

4. Choisissez Importer des utilisateurs pour soumettre la tâche. Soumettez une seule tâche par importation.

Pour suivre les tâches que vous avez soumises, accédez à Afficher les tâches dans l’écran Importer/Exporter des utilisateurs, puis choisissez Plus d’informations pour n’importe quelle tâche. Les statuts de tâche comprennent Échec de la création de la tâche, Tâche créée, échec de l’importation des utilisateurs et Tâche créée, importation des utilisateurs réussie.

​

Exporter des utilisateurs

Pour exporter des utilisateurs à partir de votre locataire :

1. Dans Auth0 Dashboard, accédez à Gestion des utilisateurs > Utilisateurs, puis sélectionnez Importer/Exporter des utilisateurs > Exporter des utilisateurs.

2. Sélectionnez la connexion de base de données à partir de laquelle vous souhaitez exporter des utilisateurs, puis choisissez JSON ou CSV comme format d’exportation.

3. Indiquez les champs à exporter :

   1. Sélectionnez Ajouter les champs par défaut pour inclure les attributs utilisateur standard.
   2. Mettez à jour les noms des champs dans votre fichier de sortie.
   3. Ajoutez des attributs utilisateur personnalisés au besoin.

4. (Facultatif) Sélectionnez Exporter comme échantillon pour prévisualiser la structure avec un maximum de 10 utilisateurs.

5. Sélectionnez Exporter des utilisateurs pour lancer la tâche.

Pour suivre et télécharger les tâches d’exportation, accédez à Afficher les tâches dans l’écran Importer/Exporter des utilisateurs. Sélectionnez Vérifier le statut pour suivre la progression de la tâche, Télécharger l’exportation pour récupérer le résultat, ou Plus d’informations pour consulter les erreurs ou les métadonnées de la tâche.

​

Mettre à jour les profils utilisateur

L’Auth0 Management API permet de mettre à jour en lot les profils utilisateur dans user_metadata et app_metadata.

Ce processus peut entraîner une perte de données ; créez toujours une sauvegarde de votre base de données d’utilisateurs en cas de corruption des données. De plus, ce processus ne permet pas de bloquer plusieurs utilisateurs, et chaque utilisateur doit être bloqué individuellement dans l’Auth0 Dashboard ou à l’aide de l’Auth0 Management API.

Pour mettre à jour en lot les profils utilisateur :

1. À l’aide du processus d’exportation ci-dessus, créez un fichier d’exportation complet comprenant tous les attributs de vos utilisateurs.
2. Choisissez le format JSON pour votre exportation.
3. Une fois l’exportation terminée, téléchargez le fichier contenant vos utilisateurs.

​

​

Mettez à jour votre configuration

Ne modifiez pas l’adresse de courriel de l’utilisateur, car elle sert de clé de recherche des utilisateurs dans la base de données.

Faites une copie du fichier JSON que vous avez téléchargé à l’étape précédente, puis ouvrez-la dans un éditeur de texte. Le schéma utilisateur devrait ressembler à celui ci-dessous :

[
   {
      "Id":"auth0|626737a9813c000069daf462",
      "Nickname":"testuser1",
      "Name":"[e-mail]",
      "email":"[e-mail]",
      "Connection":"Username-Password-Authentication",
      "Created At":"2022-04-26T00:07:05.098Z",
      "Updated At":"2022-07-06T14:54:19.214Z"
   },
   {
      "Id":"auth0|62d1a1853bdcf11ff5dca672",
      "Nickname":"testuser2",
      "Name":"[e-mail]",
      "email":"[e-mail]",
      "Connection":"Username-Password-Authentication",
      "Created At":"2022-07-15T17:19:01.531Z",
      "Updated At":"2022-07-15T17:19:01.532Z"
   },
   {
      "Id":"auth0|62d1a1a524f32a4185c9ce23",
      "Nickname":"testuser3",
      "Name":"[e-mail]",
      "email":"[e-mail]",
      "Connection":"Username-Password-Authentication",
      "Created At":"2022-07-15T17:19:33.484Z",
      "Updated At":"2022-07-15T17:19:33.484Z"
   }
]

L’ID doit avoir un connection|id unique. Si le même ID d’utilisateur existe dans plusieurs connexions, la mise à jour échouera.

Pour ajouter un attribut, créez un nouveau champ dans le schéma de chaque utilisateur et attribuez-lui une valeur. Dans l’exemple ci-dessous, l’attribut Nom de famille a pour valeur Smith, avec une virgule après la valeur du nouvel attribut.

Vous pouvez également ajouter l’attribut email_verified à plusieurs utilisateurs et définir sa valeur sur true.

{
   "Id":"auth0|626737a9813c000069daf462",
   "Nickname":"testuser1",
   "Family Name":"Smith",
   "Name":"[e-mail]",
   "email":"[e-mail]",
   "email_verified":true,
   "Connection":"Username-Password-Authentication",
   "Created At":"2022-04-26T00:07:05.098Z",
   "Updated At":"2022-07-06T14:54:19.214Z"
}

Enregistrez les modifications dans votre fichier d’utilisateurs.

Ce processus ne permet pas de bloquer plusieurs utilisateurs. Vous devez bloquer les utilisateurs individuellement dans l’Auth0 Dashboard ou avec l’Auth0 Management API.

Pour importer des données de profil utilisateur mises à jour, téléversez votre fichier de profil utilisateur mis à jour afin de mettre à jour plusieurs utilisateurs en une seule tâche. Upsert pre-existing users in connection doit être activé/sélectionné pour que les utilisateurs existants soient mis à jour.