Activer et configurer les attributs pour les identifiants flexibles

Décrit comment des identifiants comme le courriel et le numéro de téléphone doivent être configurés pour une connexion de base de données.

L’activation des identifiants flexibles sur votre tenant peut entraîner des changements non rétrocompatibles dans votre environnement de production. Pour en savoir plus sur les problèmes potentiels et les limites, consultez Flexible Identifiers and Attributes.

Pour les connexions de base de données, un attribut comme le courriel, le numéro de téléphone ou le nom d’utilisateur fait partie des identifiants flexibles. Les utilisateurs finaux s’inscrivent, s’authentifient et réinitialisent leur mot de passe à l’aide d’un attribut. Chaque attribut a sa propre configuration.

​

Activer les attributs

Nouvelle connexion

1. Accédez à Auth0 Dashboard > Authentication > Database.
2. Sélectionnez +Create DB Connection.
3. Entrez un nom pour la connexion et choisissez les attributs.
4. Choisissez la méthode d’authentification pour la connexion.

Connexion existante

1. Accédez à Auth0 Dashboard > Authentication > Database.
2. Sélectionnez dans la liste la Database Connection que vous souhaitez mettre à jour.
3. Sélectionnez l’onglet Attribut et choisissez Activate.
4. Lorsqu’on vous demande de confirmer que vous avez testé votre configuration dans un environnement de développement, sélectionnez Proceed.
5. À l’écran Attribut, sélectionnez Add Attribute ou Configurer un attribut existant.

Des valeurs par défaut sont attribuées à une nouvelle connexion et peuvent être modifiées une fois la connexion créée.

Paramètre	Valeur
Utiliser \{attribute} comme identifiant	True
Autoriser l’inscription avec \{attribute}	Obligatoire
Exiger \{attribute} dans le profil utilisateur	True
Longueur du nom d’utilisateur	Min : 1 Max : 15
Autoriser les noms d’utilisateur au format courriel	False
Autoriser les noms d’utilisateur au format numéro de téléphone	False

​

Configurer les attributs

Sélectionnez l’onglet Attributs dans la connexion. Choisissez l’un des attributs disponibles, puis sélectionnez Configurer. Une fois la configuration des attributs mise à jour, sélectionnez Enregistrer.

Options de configuration de l’attribut de courriel

Option
Utiliser le courriel comme identifiant	En activant cette option, le courriel deviendra un identifiant pour cette connexion. Les utilisateurs pourront utiliser leur courriel pour se connecter et réinitialiser leur mot de passe.
Méthode de vérification	Choisissez le lien de vérification du courriel ou le mot de passe à usage unique (OTP).
Autoriser l’inscription avec le courriel	Choisissez comment le courriel sera recueilli à l’inscription Désactivé : l’attribut sera bloqué dans les flows d’inscription. Facultatif : l’attribut sera facultatif dans les flows d’inscription. Obligatoire : les flows d’inscription échoueront si l’attribut n’est pas présent. Les flows d’inscription comprennent : Universal Login L’endpoint dbconnections/signup de l’Authentication API
Vérifier le courriel à l’inscription	Les utilisateurs devront vérifier leur adresse courriel au moyen d’un Magic Link au moment de l’inscription.
Exiger le courriel dans le profil utilisateur	Exige la présence du courriel dans toutes les opérations qui créent ou mettent à jour un profil utilisateur sur cette connexion. Le courriel sera obligatoire dans les cas suivants : Flows d’inscription Création ou mise à jour d’un utilisateur au moyen de la Management API Importation en bloc d’utilisateurs

Attributs de nom d’utilisateur et options de configuration

Option
Utiliser le nom d’utilisateur comme identifiant	En activant cette option, le nom d’utilisateur deviendra un identifiant pour cette connexion. Les utilisateurs pourront utiliser leur nom d’utilisateur pour se connecter et réinitialiser leur mot de passe.
Autoriser l’inscription avec le nom d’utilisateur	Choisissez comment le nom d’utilisateur sera recueilli à l’inscription Désactivé : l’attribut sera bloqué dans les flows d’inscription. Facultatif : l’attribut sera facultatif dans les flows d’inscription. Obligatoire : les flows d’inscription échoueront si l’attribut n’est pas présent. Les flows d’inscription comprennent : Universal Login L’endpoint dbconnections/signup de l’Authentication API
Exiger le nom d’utilisateur dans le profil utilisateur	Exige la présence du nom d’utilisateur dans toutes les opérations qui créent ou mettent à jour un profil utilisateur sur cette connexion. Le nom d’utilisateur sera obligatoire dans les cas suivants : Flows d’inscription Création ou mise à jour d’un utilisateur au moyen de la Management API Importation en bloc d’utilisateurs
Longueur du nom d’utilisateur	Définissez les valeurs minimale et maximale autorisées pour le nom d’utilisateur.

Attributs de numéro de téléphone et options de configuration

Option
Utiliser le numéro de téléphone comme identifiant	En activant cette option, phone_number deviendra un identifiant pour cette connexion. Les utilisateurs pourront utiliser phone_number pour se connecter et réinitialiser leur mot de passe.
Autoriser l’inscription avec le numéro de téléphone	Choisissez comment le numéro de téléphone sera recueilli à l’inscription Désactivé : l’attribut sera bloqué dans les flows d’inscription. Facultatif : l’attribut sera facultatif dans les flows d’inscription. Obligatoire : les flows d’inscription échoueront si l’attribut n’est pas présent. Les flows d’inscription comprennent : Universal Login L’endpoint dbconnections/signup de l’Authentication API
Vérifier le téléphone à l’inscription	Les utilisateurs devront vérifier leur numéro de téléphone au moyen d’un OTP au moment de l’inscription. Assurez-vous d’avoir configuré un fournisseur de téléphonie, sinon vos utilisateurs ne pourront pas poursuivre l’inscription.
Exiger le téléphone dans le profil utilisateur	Exige la présence du téléphone dans toutes les opérations qui créent ou mettent à jour un profil utilisateur sur cette connexion. Le téléphone sera obligatoire dans les cas suivants : Flows d’inscription Création ou mise à jour d’un utilisateur au moyen de la Management API Importation en bloc d’utilisateurs

​

Configurer ou supprimer des attributs existants sur une connexion

Tous les attributs peuvent être modifiés ou supprimés depuis votre Auth0 Dashboard. Les utilisateurs ne peuvent ni se connecter, ni s’inscrire, ni réinitialiser leur mot de passe à l’aide de l’attribut supprimé, et au moins un attribut doit rester actif dans chaque connexion.

Pour modifier ou supprimer un attribut, accédez à l’onglet Attributs, puis choisissez Supprimer.

​

Rétablir une connexion

Pour rétablir une connexion dans son état initial, utilisez le point de terminaison Update a connection de la Management API avec un objet options qui n’inclut pas le paramètre attributes, comme indiqué ci-dessous.

• Si vous utilisez le paramètre options, l’objet options est remplacé dans son ensemble. Pour éviter les données partielles ou d’autres problèmes, assurez-vous que tous les paramètres actuels sont présents en copiant le contenu de l’objet options de la connexion et en l’incluant dans la requête PATCH. Le seul paramètre à supprimer est attributes.
• Si username est activé comme attribut dans votre tenant, vous devrez modifier vos paramètres username pour effectuer l’action suivante. Vous devrez reconfigurer vos paramètres de nom d’utilisateur si vous choisissez cette option.

{
"options": {
       }
}