Passer au contenu principal
Auth0 normalise les propriétés de profil commun dans le profil utilisateur : name, picture, etc. Le champ relatif à l’image est alimenté soit par l’image de profil du fournisseur social, soit par l’image Gravatar associée à l’adresse courriel de l’utilisateur. Par défaut, tous les utilisateurs de la base de données auront une image de remplacement avec leurs initiales. Lorsque vous authentifiez un utilisateur, ce champ d’image est appelé user.picture.

​
Utiliser Management API

L’attribut user.picture n’est pas directement modifiable lorsqu’il est fourni par des fournisseurs d’identité autres qu’Auth0, tels que Google, Facebook ou encore X. Pour modifier cet attribut, vous devez configurer votre synchronisation de connexion avec Auth0 de manière à ce que les attributs de l’utilisateur soient mis à jour à partir du fournisseur d’identité uniquement lors de la création du profil utilisateur. Pour en savoir plus, consultez Configurer la connexion du fournisseur d’identité pour les mises à jour du profil utilisateur. Ces attributs racine seront alors disponibles pour modification individuelle ou pour une importation en bloc à l’aide de Management API. Pour en savoir plus, consultez Importations en bloc d’utilisateurs. Alternativement, vous pouvez utiliser des métadonnées pour stocker l’attribut d’image pour les utilisateurs. Par exemple, si votre application permet de télécharger des photos de profil, une fois la photo téléchargée, vous pouvez définir l’URL de l’image dans user.user_metadata.picture : 
curl --request PATCH \
  --url 'https://{yourDomain}/api/v2/users/USER_ID' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"user_metadata": {"picture": "https://example.com/some-image.png"}}'

​
Utiliser les Actions

Pour s’assurer que l’image des user_metadata est renvoyée dans le jeton d’ID, nous allons devoir créer une nouvelle action pour vérifier si l’attribut event.user.user_metadata.picture est présent et, si c’est le cas, remplacer l’attribut user.picture par cette valeur. Vous serez ainsi certain que l’image des user_metadata sera renvoyée dans la demande picture du jeton d’ID.
  1. Allez à Auth0 Dashboard > Actions > Library (Bibliothèque) et sélectionnez Build Custom (Créer personnalisé).
  2. Saisissez un Name (Nom) descriptif pour votre Action (par exemple, changer l’image des utilisateurs, sélectionnez le déclencheur Login/Post Login (connexion/post-connexion), car vous allez ajouter l’Action au flux de connexion, puis sélectionnez Create (Créer).
  3. Repérez l’éditeur de code des actions, copiez le code JavaScript suivant dans celui-ci, puis sélectionnez Save Draft (Enregistrer le brouillon)  pour enregistrer vos modifications : 
    exports.onExecutePostLogin = async (event, api) => {
  const { picture } = event.user.user_metadata;
  if (picture) {
    // Return the persisted user_metadata.picture in the ID token
    api.idToken.setCustomClaim("picture", picture)
  }
};
  4. Dans la barre latérale de l’éditeur de code des actions, sélectionnez Test (icône de lecture), puis sélectionnez Run (Exécuter) pour tester votre code.
  5. Lorsque vous êtes prêt à lancer l’action, sélectionnez Deploy (Déployer).
Enfin, ajoutez l’Action que vous avez créée dans le flux de connexion. Pour savoir comment attacher des actions à des flux, lisez la section « Attacher l’action à un flux » dans Écriture de votre première action.

​
Modifier l’image par défaut pour tous les utilisateurs

Pour changer l’image par défaut de tous les utilisateurs qui n’ont pas défini d’image de profil, vous pouvez utiliser une action. Par exemple : 
exports.onExecutePostLogin = async (event, api) => {
  const DEFAULT_PROFILE_IMAGE = '{yourDefaultImageUrl}';
  api.idToken.setCustomClaim("picture", {defaultProfileImage});
};
Dans cette Action, l’image personnalisée est renvoyée dans le jeton d’ID et remplace toute propriété d’ image pouvant provenir d’une connexion à un fournisseur d’identité externe, tel que Google.

​
Limites

Le magasin de données Auth0 a une capacité limitée et pour éviter que les données de votre application ne dépassent les limites, nous vous recommandons d’utiliser une base de données externe pour stocker les images des utilisateurs. Cela vous permet de conserver un magasin de données Auth0 restreint et d’utiliser une base de données externe plus efficace pour contenir les données supplémentaires. Pour en savoir plus, consultez Stockage des données utilisateur.

​
En savoir plus

⌘I