Propriétés de l’objet utilisateur dans les règles

Décrit les propriétés de l’objet utilisateur qui stocke des informations sur l’utilisateur connecté, retournées par le fournisseur d’identité.

La date de fin de vie (EOL) des Règles et des Appels sera le 18 novembre 2026. Ils ne sont plus disponibles pour les nouveaux locataires créés à partir du 16 octobre 2023. Les locataires actuels ayant des hooks actifs conserveront l’accès aux produit Hooks jusqu’à la fin de leur durée de vie.

Nous vous conseillons vivement d’utiliser les Actions pour étendre Auth0. Avec les Actions, vous avez accès à des informations de type enrichies, à une documentation intégrée et à des packages npm publics, et vous pouvez connecter des intégrations externes qui optimisent votre expérience d’extensibilité globale. Pour en savoir plus sur ce que les Actions proposent, consultez Comprendre comment fonctionnent Auth0 Actions.

Pour vous aider dans votre migration, nous proposons des guides qui vous aideront à migrer des Règles vers les Actions et à migrer des Hooks vers les Actions. Nous avons également une page dédiée à la Migration vers les Actions qui met en évidence les comparaisons de fonctionnalités, une démo des Actions et d’autres ressources pour vous aider dans votre parcours de migration.

Pour en savoir plus sur l’obsolescence des Règles et des Appels, consultez notre article de blog : Preparing for Rules and Hooks End of Life (Préparation à la fin de vie des règles et des crochets).

L’objet user (utilisateur) stocke des informations sur l’utilisateur connecté, renvoyées par le fournisseur d’identité. Il est généré lorsqu’un utilisateur s’authentifie et avant l’exécution des règles. En raison de l’ordre des événements lors de l’authentification d’un utilisateur, les modifications apportées au profil d’un utilisateur à partir d’une règle ne seront disponibles dans l’objet utilisateur actuel que si vous enregistrez également les modifications apportées à l’objet utilisateur à partir de la même règle.

Pour en savoir plus sur le flux de transactions d’authentification, veuillez consulter la section Fonctionnement des règles dans Créer des règles.

Utilisez des noms uniques pour les propriétés de base dans l’objet utilisateur et les propriétés dans app_metadata. Parce que les propriétés de app_metadata sont fusionnées dans l’objet utilisateur, les propriétés de base qui partagent des noms avec celles de app_metadata peuvent voir leurs valeurs écrasées lors de l’exécution des règles.

​

Propriétés

Les propriétés suivantes sont disponibles pour l’objet user.

Propriété	Type de données	Description
user.app_metadata	objet	Champs personnalisés qui stockent des informations sur un utilisateur qui influencent l’accès de l’utilisateur, comme le plan d’assistance, les rôles de sécurité ou les groupes de contrôle d’accès. Est undefined par défaut. Pour plus d’informations, voir la section Métadonnées.
user.created_at	date et heure	Horodatage indiquant quand le profil de l’utilisateur a été créé pour la première fois.
user.email	texte	Adresse de courriel de l’utilisateur.
user.email_verified	booléen	Indique si l’utilisateur a vérifié son adresse de courriel.
user.family_name	texte	Nom de famille de l’utilisateur.
user.given_name	texte	Prénom de l’utilisateur.
user.identities	tableau (objet)	Contient des informations récupérées auprès du fournisseur d’identité auprès duquel l’utilisateur s’est initialement authentifié. Les utilisateurs peuvent également associer leur profil à plusieurs fournisseurs d’identité; ces identités apparaîtront alors dans ce tableau. Le contenu de l’objet d’un fournisseur d’identité varie selon le fournisseur, mais il comprend généralement les éléments suivants :
user.last_password_reset	date et heure	Horodatage indiquant la dernière fois que le mot de passe de l’utilisateur a été réinitialisé/modifié. Lors de la création de l’utilisateur, ce champ n’existe pas. Cette propriété n’est disponible que pour les connexions aux bases de données.
user.multifactor	tableau (texte)	Liste des fournisseurs d’authentification multifacteur (MFA) auprès desquels l’utilisateur est inscrit. Ce tableau est mis à jour lorsque l’utilisateur s’inscrit à la MFA et lorsqu’un administrateur réinitialise les inscriptions à la MFA d’un utilisateur.
user.name	texte	Prénom de l’utilisateur.
user.nickname	texte	Pseudonyme de l’utilisateur.
user.permissions	texte	Autorisations attribuées au jeton d’ID de l’utilisateur si l’extension d’autorisation est utilisée.
user.phone_number	texte	Numéro de téléphone de l’utilisateur. Valable uniquement pour les utilisateurs disposant de connexions SMS.
user.phone_verified	booléen	Indique si l’utilisateur a vérifié son numéro de téléphone. Valable uniquement pour les utilisateurs disposant de connexions SMS.
user.picture	texte	URL pointant vers la photo de profil de l’utilisateur.
user.updated_at	date 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 correspond à last_login.
user.user_id	texte	(unique) Identifiant primaire unique de l’utilisateur.
user.user_metadata	objet	Champs personnalisés qui stockent des informations sur un utilisateur qui n’ont pas d’incidence sur les éléments auxquels il peut ou ne peut pas accéder, comme l’adresse professionnelle, l’adresse personnelle ou les préférences de l’utilisateur. Pour plus d’informations, voir la section Métadonnées.
user.username	texte	(unique) Nom d’utilisateur