Propriétés de l’objet utilisateur dans les Rules

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

La date de fin de vie (EOL) des Rules et des Hooks est fixée au 18 novembre 2026, et ils ne sont plus offerts aux nouveaux locataires créés à compter du 16 octobre 2023. Les locataires existants ayant des Hooks actifs conserveront l’accès au produit Hooks jusqu’à sa fin de vie.

Nous vous recommandons fortement d’utiliser Actions pour étendre Auth0. Avec Actions, vous avez accès à des informations de type détaillées, à une documentation intégrée et à des packages npm publics, et vous pouvez connecter des intégrations externes qui améliorent votre expérience globale en matière d’extensibilité. Pour en savoir plus sur ce que propose Actions, consultez Comprendre le fonctionnement d’Auth0 Actions.

Pour vous aider dans votre migration, nous proposons des guides pour migrer des Rules vers Actions et migrer des Hooks vers Actions. Nous avons également une page dédiée, Passer à Actions, qui présente des comparaisons de fonctionnalités, une démo d’Actions et d’autres ressources pour vous accompagner dans votre migration.

Pour en savoir plus sur la dépréciation des Rules et des Hooks, consultez notre billet de blogue : Preparing for Rules and Hooks End of Life.

L’objet user stocke des informations sur l’utilisateur connecté, renvoyées par le fournisseur d’identité. Il est généré lorsqu’un utilisateur s’authentifie, avant l’exécution des Rules. 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 Rule ne seront disponibles dans l’objet utilisateur courant que si vous enregistrez également ces modifications dans l’objet utilisateur à partir de cette même Rule.

Pour en savoir plus sur le flux de transaction d’authentification, consultez la section « How Rules Work » dans Create Rules.

Utilisez des noms uniques pour les propriétés racines de l’objet utilisateur et les propriétés de app_metadata. Comme les propriétés de app_metadata sont fusionnées dans l’objet utilisateur, les propriétés racines qui portent le même nom que des propriétés de app_metadata peuvent voir leurs valeurs remplacées lors de l’exécution des Rules.

​

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 renseignements sur un utilisateur et influencent ce à quoi il peut accéder, comme le plan de soutien, les rôles de sécurité ou les groupes de contrôle d’accès. La valeur par défaut est undefined. Pour en savoir plus, consultez Metadata.
user.created_at	date et heure	Horodatage indiquant le moment où le profil de l’utilisateur a été créé pour la première fois.
user.email	texte	(unique) 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 renseignements récupérés auprès du fournisseur d’identité avec lequel l’utilisateur s’est authentifié à l’origine. Les utilisateurs peuvent aussi lier leur profil à plusieurs fournisseurs d’identité ; ces identités apparaîtront alors également dans ce tableau. Le contenu d’un objet de fournisseur d’identité varie selon le fournisseur, mais il comprend généralement les éléments suivants : connection (texte) : nom de la connexion Auth0 utilisée pour authentifier l’utilisateur. isSocial (booléen) : indique si la connexion est de type social. provider (texte) : nom de l’entité qui authentifie l’utilisateur, comme Facebook, Google, SAML ou votre propre fournisseur. user_id (texte) : identifiant unique de l’utilisateur pour cette connexion ou ce fournisseur. Le premier user_id lié devient l’identifiant unique principal de l’utilisateur. profileData (objet) : renseignements sur l’utilisateur associés à la connexion. Lorsque des profils sont liés, il est renseigné avec les renseignements utilisateur associés aux comptes secondaires. Dans certains cas, il comprend aussi un jeton d’accès d’API à utiliser avec le fournisseur.
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é ou modifié. Lors de la création de l’utilisateur, ce champ n’existe pas. Cette propriété est disponible uniquement pour les connexions de base de données.
user.multifactor	tableau (texte)	Liste des fournisseurs d’authentification multifacteur (MFA) auxquels l’utilisateur est inscrit. Ce tableau est mis à jour lorsque l’utilisateur s’inscrit à la MFA et lorsqu’un administrateur réinitialise les inscriptions MFA d’un utilisateur.
user.name	texte	Nom complet de l’utilisateur.
user.nickname	texte	Surnom de l’utilisateur.
user.permissions	texte	Autorisations attribuées au ID Token de l’utilisateur si vous utilisez Authorization Extension.
user.phone_number	texte	Numéro de téléphone de l’utilisateur. Valide uniquement pour les utilisateurs ayant des connexions SMS.
user.phone_verified	booléen	Indique si l’utilisateur a vérifié son numéro de téléphone. Valide uniquement pour les utilisateurs ayant des connexions SMS.
user.picture	texte	URL pointant vers la photo de profil de l’utilisateur.
user.updated_at	date et heure	Horodatage indiquant le moment où le profil de l’utilisateur a été mis à jour ou modifié pour la dernière fois. 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 unique principal de l’utilisateur.
user.user_metadata	objet	Champs personnalisés qui stockent des renseignements sur un utilisateur sans incidence sur ce à quoi il peut ou non accéder, comme son adresse professionnelle, son adresse personnelle ou ses préférences. Pour en savoir plus, consultez Metadata.
user.username	texte	(unique) Nom d’utilisateur.