Passer au contenu principal
Configurez votre connexion à la base de données pour migrer automatiquement vos utilisateurs d’un magasin d’utilisateurs externe vers Auth0 à l’aide de scripts d’action de base de données personnalisés.
Si vous essayez d’utiliser plusieurs méthodes de migration (par ex., la migration automatique puis l’importation en bloc d’utilisateurs), vous risquez de rencontrer une erreur DUPLICATED_USER. Cette erreur indique que l’utilisateur existe dans le magasin d’utilisateurs interne d’Auth0 mais pas dans votre locataire. Pour corriger cette erreur, supprimez l’utilisateur avec le point de terminaison Supprimer un utilisateur de connexion de l’Auth0 Management API, puis réessayez l’importation.

​
Configurez la connexion à la base de données en tant que personnalisée.

Créez une connexion à la base de données, puis définissez-la comme personnalisée.
  1. Allez dans Auth0 Dashboard > Authentification > Base de données et sélectionnez la base de données à afficher.
  2. Sélectionnez l’aperçu Base de données personnalisée , puis activez Utiliser ma propre base de données.
    Auth0 Dashboard - Authentication (Authentification) Database Connection (Connexion à la base de données) Custom Database Settings (Paramètres de base de données personnalisée) Use Own Database (Utiliser sa propre base de données) Enabled (Activé)
  3. Sélectionnez l’aperçu Paramètres, puis activez Importer les utilisateurs vers Auth0, ensuite cliquez sur Enregistrer.

​
Configurez les scripts d’action de base de données.

Sélectionnez l’aperçu Base de données personnalisée, puis localisez Scripts d’action de base de données.
Dashboard Authentication Database Connection Custom Database tab Database Action Scripts

​
Connexion

Le script Connexion s’exécute chaque fois qu’un utilisateur non trouvé dans Auth0 tente de se connecter. Il vérifie que l’utilisateur existe dans le magasin d’utilisateurs externe sans redemander le mot de passe à ce dernier.

​
Obtenir un utilisateur

Le script Obtenir l’utilisateur s’exécute après l’un des scénarios suivants :
  • Un utilisateur initie une tentative d’inscription.
  • Un utilisateur initie un processus de changement de mot de passe.
  • Un utilisateur saisit son identifiant de connexion lorsqu’il utilise Identifier First + Données biométriques.
  • Il est fait appel au point de terminaison de mettre à jour le courriel ou le nom d’utilisateur ou créer un utilisateur .
Si un utilisateur qui n’a pas été migré confirme un changement de mot de passe et se connecte avec succès, son profil utilisateur sera créé dans Auth0 avec le nouveau mot de passe. Ce profil utilisateur contient toutes les données renvoyées dans le script Obtenir l’utilisateur. Toutes les connexions ultérieures pour cet utilisateur seront effectuées directement dans Auth0.

​
Vérifiez que la migration des utilisateurs est complète.

Vérifiez que tous les utilisateurs ont été migrés vers le magasin d’utilisateurs Auth0 en utilisant le tableau de bord Auth0 ou Management API Auth0.
  1. Allez à Auth0 Dashboard > Gestion des utilisateurs > Utilisateurs, et examinez la liste des utilisateurs.
  2. Utilisez le point de terminaison List or Search Users (Lister ou Rechercher des utilisateurs) de Management API.

​
Déconnectez le magasin d’utilisateurs externe.

Reconfigurer les scripts d’action de base de données car aucune opération ne fonctionne. Cela empêchera Auth0 d’accéder à votre magasin d’utilisateurs externe pour authentifier les utilisateurs.
Veillez à laisser l’option Importer les utilisateurs vers Auth0 activée. Si vous désactivez cette option, Auth0 utilisera uniquement les scripts pour l’authentification et d’autres actions utilisateur au lieu d’utiliser les utilisateurs qui ont été importés localement.
  1. Allez à Auth0 Dashboard > Authentification > Base de données, ensuite sélectionnez votre connexion à la base de données.
  2. Passez à l’aperçu Base de données personnalisée, puis localisez Scripts d’action de base de données.
  3. Mettre à jour le script de Connexion . 
    function login (email, password, callback) {
  return callback(null, null);
}
  4. Mettre à jour le script Obtenir l’utilisateur . 
    function getByEmail (email, callback) {
  return callback(null, null);
}

​
Résoudre les problèmes de migration des utilisateurs.

Si vous rencontrez des problèmes avec la migration automatique, lisez premièrement Les meilleures pratiques pour la connexion à la base de données personnalisée et les scripts d’action..

​
L’utilisateur existe déjà.

Les scénarios les plus courants relatifs à quand vous pourriez rencontrer ce problème :
  • Vous supprimez un utilisateur de votre connexion à la base de données, puis vous essayez de le recréer.
  • Vous essayez de créer un nouvel utilisateur sur votre connexion à la base de données alors que ledit utilisateur existe déjà dans votre magasin d’utilisateurs externe.
  • Un processus de migration d’un utilisateur a été interrompu.
Au cours du processus de migration de l’utilisateur, Auth0 crée premièrement un profil utilisateur partiel dans un magasin d’utilisateurs interne, puis crée un profil utilisateur complet dans votre connexion à la base de données. Si un problème survient qui empêche la création de ce profil utilisateur complet, vous pourriez faire face à l’erreur The user already exists . Vous pouvez généralement résoudre ce problème en supprimant l’utilisateur de la connexion à la base de données, en supprimant l’utilisateur du magasin d’utilisateurs interne, puis en réessayant le processus de migration.
  1. Vérifiez les instructions console.log() avec l’extension Journaux Webtask en temps réel.
  2. Supprimez l’utilisateur avec le point de terminaison Delete a User (Supprimer un utilisateur) de Management API.
  3. Supprimez l’utilisateur avec le point de terminaison Delete a Connection User (Supprimer un utilisateur de connexion) de Management API.
  4. Demandez à l’utilisateur de se connecter ou de changer son mot de passe pour réessayer la migration.

​
Métadonnées manquantes.

Si un utilisateur est interrompu pendant le processus de connexion ou de changement de mot de passe qui initie la migration, Auth0 peut ne pas être en mesure de transférer ses métadonnées (user_metadata ou app_metadata) avec ses autres données de profil. Vous pouvez atténuer ce scénario en créant une Action qui vérifie si le profil de l’utilisateur manque de métadonnées, les récupère depuis le magasin d’utilisateurs externe, puis les stocke dans Auth0.

​
En savoir plus