Structure du profil utilisateur

Répertorie les attributs disponibles dans le profil utilisateur Auth0

Le profil utilisateur normalisé d’Auth0 se compose de quelques éléments distincts :

• Détails : objet principal du profil utilisateur, qui contient des renseignements de base, comme le nom, l’adresse courriel et l’horodatage de la plus récente connexion de l’utilisateur, dans des attributs prédéfinis. Cet objet peut aussi contenir des renseignements provenant de la connexion source de l’utilisateur. La plupart des attributs utilisateur sont des attributs racine (attributs stockés au premier niveau, ou niveau racine, de l’objet user), et certains peuvent être modifiés.
• Métadonnées : deux sous-objets qui servent de stockage secondaire pour conserver des renseignements supplémentaires sur l’utilisateur dans des attributs personnalisables : user_metadata et app_metadata. Pour en savoir plus, notamment sur les cas d’utilisation de app_metadata et de user_metadata, consultez Comprendre le fonctionnement des métadonnées dans les profils utilisateur.

​

Attributs du profil utilisateur

Les attributs suivants sont disponibles dans le profil utilisateur. Plusieurs sont des attributs racine (des attributs stockés au premier niveau, ou niveau racine, de l’objet user), et certains peuvent être mis à jour, importés et exportés, comme indiqué ci-dessous.

S’il existe des champs utilisateur qui ne devraient pas être stockés par Auth0 pour des raisons de confidentialité, vous pouvez ajouter à la Deny List les attributs que vous ne voulez pas voir enregistrés dans les bases de données d’Auth0. Pour en savoir plus, consultez Ajouter des attributs utilisateur à la Deny List.

Par défaut, les attributs du profil utilisateur fournis par des fournisseurs d’identité autres qu’Auth0 (comme Google, Facebook ou X) ne peuvent pas être modifiés directement, car ils sont mis à jour à partir du fournisseur d’identité chaque fois que l’utilisateur se connecte. Pour en savoir plus sur les attributs provenant des fournisseurs d’identité, consultez Configurer la connexion du fournisseur d’identité pour les mises à jour du profil utilisateur.

Pour pouvoir modifier les attributs racine name, nickname, given_name, family_name ou picture dans le profil utilisateur normalisé, vous devez configurer la synchronisation de votre connexion avec Auth0 afin que les attributs utilisateur soient mis à jour à partir du fournisseur d’identité uniquement lors de la création du profil utilisateur. Ces attributs racine pourront ensuite être modifiés individuellement ou au moyen d’importations en bloc

Nom	Type	Description	Peut être recherché ?	Peut être mis à jour ?	Importation ?	Création ou mise à jour à l’importation ?	Exportable ?
app_metadata	objet	Champs personnalisés qui contiennent des renseignements sur un utilisateur et qui influent sur son accès, comme le plan de soutien, les rôles de sécurité (si vous n’utilisez pas l’ensemble de fonctionnalités Authorization Core) ou les groupes de contrôle d’accès. Pour en savoir plus, consultez Aperçu des métadonnées.	O	O	O	O	O
blocked	booléen	Indique si l’utilisateur a été bloqué. L’importation permet de garantir que les utilisateurs restent bloqués lors de la migration vers Auth0.	O	O	O	N	O
blocked_for	tableau (objet)	Adresses IP bloquées parce qu’elles sont soupçonnées de participer à une attaque par force brute.	N	N	N	N	N
created_at	date et heure	Horodatage indiquant à quel moment le profil d’utilisateur a été créé initialement.	O	N	N	N	O
email	texte	(unique) L’adresse courriel de l’utilisateur.	O	O	O	N	O
email_verified	booléen	Indique si l’utilisateur a vérifié son adresse courriel.	O	O	O	O	O
family_name	texte	Le nom de famille de l’utilisateur.	O	O	O	O	O
given_name	texte	Le prénom de l’utilisateur.	O	O	O	O	O
guardian_authenticators	tableau (objet)	Renseignements détaillés sur les méthodes d’autorisation de secours Guardian configurées par l’utilisateur, y compris les SMS et les codes de récupération.	N	N	N	N	N
identities	tableau (objet)	Contient des renseignements récupérés auprès du fournisseur d’identité par lequel l’utilisateur s’est authentifié initialement. Les utilisateurs peuvent aussi lier leur profil à plusieurs fournisseurs d’identité; ces identités apparaîtront alors également dans ce tableau. Le contenu de chaque objet de fournisseur d’identité varie selon le fournisseur, mais il comprend généralement ce qui suit : connection (text): Nom de la connexion Auth0 utilisée pour authentifier l’utilisateur. isSocial (boolean): Indique si la connexion est de type Social. provider (text): Nom de l’entité qui authentifie l’utilisateur, comme Facebook, Google, SAML ou votre propre fournisseur. user_id (text): Identifiant unique de l’utilisateur pour cette connexion ou ce fournisseur. profileData (object): Renseignements sur l’utilisateur associés à la connexion. Lorsque des profils sont liés, il contient les renseignements sur l’utilisateur associés aux comptes secondaires. Dans certains cas, il comprend également un jeton d’accès à l’API à utiliser avec le fournisseur.	O	N	N	N	O
last_ip	texte	Adresse IP associée à la dernière ouverture de session de l’utilisateur.	O	N	N	N	O
last_login	date et heure	Horodatage indiquant la dernière connexion de l’utilisateur. Si un utilisateur est bloqué et se connecte, la session bloquée met à jour last_login. Si vous utilisez cette propriété dans une Rule au moyen de l’objet user<, sa valeur sera associée à la connexion qui a déclenché la Rule ; cela s’explique par le fait que les Rules s’exécutent après la connexion.	O	N	N	N	O
last_password_reset	date et heure	Horodatage indiquant la dernière date à laquelle le mot de passe de l’utilisateur a été réinitialisé ou modifié. Lors de la création de l’utilisateur, ce champ n’existe pas. Cette propriété est offerte uniquement pour les connexions de base de données.	N	N	N	N	O
logins_count	entier	Nombre de fois où l’utilisateur s’est connecté. Si un utilisateur bloqué se connecte, cette session bloquée est comptabilisée dans logins_count.	O	N	N	N	O
multifactor	tableau (chaîne de caractères)	Liste des fournisseurs d’authentification multifacteur auxquels l’utilisateur est inscrit.	N	N	N	N	O
multifactor_last_modified	date et heure	Date et heure de la dernière mise à jour de l’authentification multifacteur d’un utilisateur.	N	N	N	N	O
name	texte	Nom complet de l’utilisateur.	O	O	O	O	O
nickname	texte	Le pseudo de l’utilisateur.	O	O	O	O	O
phone_number	texte	Le numéro de téléphone de l’utilisateur. Valide uniquement pour les utilisateurs ayant des connexions SMS.	O	O	N	N	O
phone_verified	booléen	Indique si le numéro de téléphone de l’utilisateur a été vérifié. S’applique uniquement aux utilisateurs ayant des connexions SMS.	O	O	N	N	O
picture	texte	URL menant à la photo de profil de l’utilisateur.	N	O	O	O	O
tenant	texte	Nom du tenant utilisé.	N	N	N	N	N
updated_at	date et heure	Horodatage indiquant la date de la dernière mise à jour/modification du profil de l’utilisateur. Les modifications apportées à last_login sont considérées comme des mises à jour; ainsi, la plupart du temps, updated_at correspondra à last_login.	O	N	N	N	O
user_id	texte	(unique) L’identifiant de l’utilisateur. L’importation permet de synchroniser les enregistrements d’utilisateurs entre plusieurs systèmes sans utiliser de tables de correspondance.	O	N	O	N	O
user_metadata	objet	Des champs personnalisés qui stockent des renseignements sur un utilisateur sans incidence sur ce à quoi il peut accéder, comme son adresse professionnelle, son adresse personnelle ou ses préférences. Pour en savoir plus, consultez Aperçu des métadonnées.	O	O	O	O	O
username	texte	(unique) Le nom d’utilisateur.	O	O	O	N	O

​

Validation du profil utilisateur

Auth0 accepte un schéma de validation précis pour certains champs du profil utilisateur. Consultez le tableau ci-dessous pour connaître les exigences applicables lors de la définition des valeurs des attributs du profil.

Tous les caractères sont convertis en minuscules lorsqu’ils sont enregistrés dans le profil utilisateur.

Cela s’applique à toutes les connexions de base de données Auth0. Lorsque la base de données Auth0 n’est pas la source de vérité (par exemple, une base de données personnalisée avec le mode d’importation désactivé), ainsi que pour d’autres types de connexions sociales ou d’entreprise où Auth0 n’est pas la source de vérité, l’adresse courriel est conservée telle quelle et n’est pas convertie en minuscules.

Champ	Type	Limite de caractères	Validation
email	courriel	La longueur maximale est de 64 caractères pour la partie locale de l’utilisateur et de 256 caractères pour la partie domaine.	Schéma de validation JSON.
username	chaîne	La longueur autorisée par défaut pour les noms d’utilisateur est de 1 à 15 caractères, jusqu’à un maximum de 128 caractères.	Le champ username accepte les caractères suivants : Caractères alphanumériques (sans accents, automatiquement convertis en minuscules) ; Le caractère arobase (@) (mais les adresses courriel ne sont pas autorisées) ; Le caractère accent circonflexe (^) ; Le caractère dollar ($) ; Le caractère point (.) ; Le caractère point d’exclamation (!) ; Le caractère accent grave (`) ; Le caractère trait d’union (-) ; Le caractère dièse (#) ; Le caractère plus (+) ; Le caractère apostrophe (’) ; Le caractère tilde (~) ; Le caractère trait de soulignement (_) ; Aucun autre caractère ni symbole n’est autorisé, et Auth0 ne valide ni n’assainit les entrées des bases de données personnalisées.
phone_number	phone	Format normalisé Les numéros de téléphone doivent être au format E.164
password	chaîne	La longueur minimale du mot de passe que vous pouvez définir est de 1 octet, tandis que la longueur maximale est de 72 octets.	Caractères standard : les caractères ASCII dans la plage 33 à 126 sont valides, notamment : Les lettres majuscules de A à Z, les lettres minuscules de a à z, les chiffres de 0 à 9, les caractères spéciaux autorisés.
name	chaîne	1-150 caractères	Tous les caractères UTF-8 sont pris en charge
nickname	chaîne	1-350 caractères	Tous les caractères UTF-8 sont pris en charge
family_name	chaîne	1-150 caractères	Tous les caractères UTF-8 sont pris en charge
given_name	chaîne	1-150 caractères	Tous les caractères UTF-8 sont pris en charge

Trois autres champs ne font pas techniquement partie du profil utilisateur, mais peuvent être utiles lors de l’importation d’utilisateurs :

• password_hash (texte) : Mot de passe haché pour la connexion de l’utilisateur. Lors de la création des utilisateurs, Auth0 utilise bcrypt pour sécuriser le mot de passe. L’importation de mots de passe hachés compatibles permet aux utilisateurs de conserver leur mot de passe, offrant ainsi une expérience plus fluide. Les mots de passe compatibles doivent être hachés avec bcrypt ou et utiliser 10 saltRounds. Notez que vous ne pouvez fournir ce champ que lors de la première importation de l’utilisateur; vous ne pourrez pas le mettre à jour par la suite.
• custom_password_hash (objet) : Mot de passe haché pour la connexion de l’utilisateur lorsqu’il est créé à l’aide d’un algorithme différent. Utilisé à la place du champ password_hash. Pendant le processus d’importation en bloc, vous pouvez mettre à jour custom_password_hash si l’utilisateur ne s’est pas connecté au moyen du custom_password_hash importé initialement.

​

En savoir plus

• Importation en bloc d’utilisateurs
• Schéma de base de données et exemples pour l’importation en bloc d’utilisateurs