Propriétés de l’objet `user` dans Rules

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

La date de fin de vie (EOL) de Rules et Hooks sera le 18 novembre 2026, et ils ne sont plus offerts aux nouveaux tenants créés à compter du 16 octobre 2023. Les tenants existants ayant des Hooks actifs conserveront l’accès au produit Hooks jusqu’à la 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, à de la 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 qu’offrent Actions, consultez Comprendre le fonctionnement des Auth0 Actions.

Pour vous aider dans votre migration, nous proposons des guides pour vous aider à passer de Rules à Actions et à passer de Hooks à Actions. Nous avons aussi une page dédiée, Move to 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 de Rules et Hooks, consultez notre billet de blogue : Preparing for Rules and Hooks End of Life.

L’objet user stocke les 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 dans une Rule ne seront disponibles dans l’objet user courant que si vous enregistrez également ces modifications dans l’objet user à partir de cette même Rule.

Pour en savoir plus sur le flux de transaction d’authentification, consultez la section « Comment fonctionnent les Rules » dans Créer des Rules.

Utilisez des noms uniques pour les propriétés root de l’objet user et les propriétés dans app_metadata. Comme les propriétés de app_metadata sont fusionnées dans l’objet user, les propriétés root qui portent le même nom que des propriétés dans app_metadata risquent de voir leurs valeurs écrasé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 qui influencent son accès, 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 time	Horodatage indiquant quand le profil utilisateur a été créé pour la première fois.
user.email	text	(unique) Adresse courriel de l’utilisateur.
user.email_verified	boolean	Indique si l’utilisateur a vérifié son adresse courriel.
user.family_name	text	Nom de famille de l’utilisateur.
user.given_name	text	Prénom de l’utilisateur.
user.identities	array (object)	Contient des renseignements récupérés auprès du fournisseur d’identité avec 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 d’un 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. Le premier user_id lié devient l’identifiant unique principal de l’utilisateur. profileData (object): Renseignements utilisateur associés à la connexion. Lorsque des profils sont liés, il contient les renseignements utilisateur associés aux comptes secondaires. Dans certains cas, il comprend aussi un jeton d’accès API à utiliser avec le fournisseur.
user.last_password_reset	date time	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 offerte uniquement pour les connexions de base de données.
user.multifactor	array (text)	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	text	Nom complet de l’utilisateur.
user.nickname	text	Surnom de l’utilisateur.
user.permissions	text	Permissions attribuées à l’ID token de l’utilisateur si vous utilisez l’Authorization Extension.
user.phone_number	text	Numéro de téléphone de l’utilisateur. Valide uniquement pour les utilisateurs ayant des connexions SMS.
user.phone_verified	boolean	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	text	URL pointant vers la photo de profil de l’utilisateur.
user.updated_at	date time	Horodatage indiquant quand 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; la plupart du temps, updated_at correspondra donc à last_login.
user.user_id	text	(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 ne peut pas accéder, comme l’adresse professionnelle, l’adresse résidentielle ou les préférences de l’utilisateur. Pour en savoir plus, consultez Metadata.
user.username	text	(unique) Nom d’utilisateur.