Collecter le profil utilisateur

Au-delà des identifiants d'authentification et des informations d'identification nécessaires à la connexion de l'utilisateur, votre application peut avoir besoin de collecter des informations supplémentaires sur le profil utilisateur stockées dans Logto pour une récupération facile via les revendications JWT ou les API, afin de fournir des expériences produits personnalisées. Vous pouvez collecter les données utilisateur par les méthodes suivantes :

• Lors de l'inscription d'un nouvel utilisateur : Utilisez la fonctionnalité Collecter le profil utilisateur pour ajouter une étape "Parlez-nous de vous" prête à l'emploi qui collecte des informations supplémentaires sur le profil utilisateur lors de l'inscription. Les nouveaux utilisateurs doivent remplir tous les champs obligatoires avant que l'inscription ne soit considérée comme terminée. Ce document se concentre sur cette approche.

• Après l'inscription de l'utilisateur : Utilisez l'Account API pour mettre en œuvre des expériences en libre-service lors des parcours d'intégration, des centres de compte ou tout au long de l'utilisation du produit afin de mettre à jour les informations du profil utilisateur.

Principaux avantages

La fonctionnalité Collecter le profil utilisateur vous permet de recueillir des informations supplémentaires sur l'utilisateur lors de l'expérience d'inscription de l'utilisateur final. Nous recommandons de ne collecter que les informations essentielles nécessaires à votre produit afin d'éviter des parcours d'inscription trop longs qui pourraient impacter les taux de conversion.

Cette fonctionnalité vous permet de :

• Capturer des données utilisateur complètes : Collectez toutes les données utilisateur à des fins commerciales ou de conformité, y compris les propriétés utilisateur standard OIDC et les données personnalisées.

• Personnalisation flexible des champs : Choisissez parmi différents types de champs tels que texte, nombre, date, case à cocher, liste déroulante (sélection), URL et validation par expression régulière pour répondre à vos besoins spécifiques.

• Expérience utilisateur optimisée : Personnalisez l'affichage avec des libellés, descriptions, exemples et règles de validation. Configurez les champs comme obligatoires ou facultatifs selon vos besoins métier.

• Configurations de champs intégrées : Utilisez des champs de données de base préconfigurés pour les propriétés utilisateur courantes avec une configuration prête à l'emploi. Profitez des champs composites (adresse, nom complet) pour recueillir efficacement des données structurées en une seule étape.

Démarrage rapide

1. Rendez-vous sur Console Logto > Connexion & compte > Collecter le profil utilisateur.
2. Cliquez sur "Ajouter des champs de profil" et choisissez un champ intégré ou définissez une donnée personnalisée (clé alphanumérique) à créer.
3. Ouvrez les détails du champ pour définir le type de champ, le libellé, la description, le caractère obligatoire et les paramètres spécifiques au type (longueur, plage, format, options, etc.). Cliquez sur "Enregistrer les modifications".
4. De retour dans Connexion & compte > Collecter le profil utilisateur, faites glisser et déposez les champs pour les réorganiser ; les modifications seront appliquées automatiquement.
5. Testez l'expérience utilisateur avec l’aperçu en direct Logto ou votre application de test. Que les utilisateurs créent un nouveau compte via identifiant (e-mail / numéro de téléphone / nom d'utilisateur), connexion sociale, ou SSO d’entreprise, ils verront tous la page "Parlez-nous de vous" lors de l'inscription.

Types de données utilisateur

Les données utilisateur peuvent être consultées dans chaque profil utilisateur. Pour un aperçu complet de toutes les catégories de données utilisateur, consultez la documentation sur la structure des données utilisateur. La fonctionnalité Collecter le profil utilisateur vous permet de recueillir à la fois des données utilisateur de base et des données personnalisées lors de l'inscription.

Champs de données utilisateur de base

Les champs de données utilisateur de base fournis par Logto sont stockés directement dans la propriété user ou user.profile. Ces champs disposent de valeurs de configuration par défaut et de traductions i18n, prêtes à l'emploi après création. Vous pouvez également personnaliser les types de champs et les paramètres selon vos besoins spécifiques.

Nom du champ	Clé de donnée utilisateur	Description
Nom	user.name	Le nom complet de l'utilisateur sous une forme affichable incluant tous les composants du nom (ex : "Jane Doe").
Nom complet	user.profile.givenName user.profile.middleName user.profile.familyName	Le nom légal complet de l'utilisateur. Combine de manière flexible familyName, givenName et middleName selon la configuration.
Surnom	user.profile.nickname	Nom familier ou usuel de l'utilisateur, qui peut différer de son nom légal.
Date de naissance	user.profile.birthdate	La date de naissance de l'utilisateur dans un format spécifié (ex : "MM-jj-aaaa").
Genre	user.profile.gender	Le genre auto-identifié de l'utilisateur (ex : "Femme", "Homme", "Préfère ne pas dire").
Profil	user.profile.profile	URL de la page de profil lisible de l'utilisateur (ex : profil de réseau social).
Site web	user.profile.website	URL du site personnel ou du blog de l'utilisateur.
Adresse	user.profile.address.formatted user.profile.address.streetAddress user.profile.address.region user.profile.address.zoneinfo user.profile.address.postalCode user.profile.address.country	L'adresse complète de l'utilisateur (ex : "123 rue Principale, Ville, France 12345"). Choisissez entre une seule ligne (address.formatted) ou plusieurs lignes avec composants configurables (rue, ville, région, code postal, pays).

Champs de données utilisateur personnalisées

Les champs de données utilisateur personnalisées sont des champs définis par l'utilisateur qui capturent des informations supplémentaires non couvertes par les champs de base, telles que les préférences, les centres d'intérêt, la taille de l'entreprise ou d'autres attributs spécifiques à l'entreprise.

Lors de la création de champs personnalisés, utilisez uniquement des caractères alphanumériques pour la clé de donnée utilisateur (ex : customData.companySize). Vous pouvez ensuite configurer le type de champ et personnaliser les propriétés supplémentaires selon vos besoins.

Pour plus d'informations sur la récupération et la mise à jour des données utilisateur personnalisées après la création de l'utilisateur, consultez structure des données utilisateur.

Types de champs

Nous pouvons simplement catégoriser les champs par simplicité :

• Primitif : Texte, Nombre, Date, Case à cocher (Booléen), Liste déroulante (Sélection unique), URL, Expression régulière.
• Composite : Nom complet, Adresse.

Propriétés communes

Propriété	S'applique à	Remarques
Libellé	Tous	Nom affiché aux utilisateurs. Flotte en haut lorsque le champ a une valeur ou est sélectionné. Obligatoire.
Exemple	Tous (sauf Case à cocher)	Indice affiché en ligne lorsque le libellé flotte (texte d'exemple / guide de formatage).
Description	Tous (sauf Case à cocher)	Texte d'accompagnement sous le champ pour des instructions ou un contexte supplémentaire.
Obligatoire	Tous (sauf Case à cocher)	Si activé, la soumission est bloquée si vide. Sinon, une mention "(Facultatif)" est ajoutée au libellé.

Configurations spécifiques au type

Type	Aspects configurables	Remarques
Texte	longueur min/max	Limite la longueur minimale et maximale du texte saisi par l'utilisateur.
Nombre	valeur min/max	Limite la plage numérique minimale et maximale de la valeur saisie.
Date	Format de date (prédéfini/personnalisé)	Choisissez des formats prédéfinis (MM/jj/aaaa, jj/MM/aaaa, aaaa-MM-jj). Changer l'exemple remplace les interactions par défaut. Ou utilisez des modèles entièrement personnalisables date-fns.
Case à cocher	Valeur par défaut	Coché (Vrai) / Non coché (Faux).
Liste déroulante (Sélection)	Liste d'options (≥1)	Utilisez valeur:libellé par ligne. Si le libellé est omis, la valeur est affichée.
URL	N/A	N/A
Regex	Expression régulière	Modèle de validation (sans les barres de début / fin). Ex : ^\d3-\d2-\d4$ pour un numéro de sécurité sociale.
Adresse	Composants	Une ou plusieurs lignes ; sous-composants : rue, ville, région, code postal, pays.
Nom complet	Composants	Sous-composants : prénom, deuxième prénom, nom de famille.

Validation

La validation des champs est effectuée lors de la soumission utilisateur à l'étape finale de l'inscription. Les vérifications suivantes sont appliquées :

• Présence obligatoire (sauf Case à cocher).
• Limites de longueur (Texte).
• Plage numérique (Nombre).
• Correspondance de modèle (Regex, Date avec format, appartenance à une option de sélection, URL).
• Structure URL (validation syntaxique de base, pas d'accessibilité).

S'applique également aux sous-composants des deux champs composites : address et fullname. Les composants individuels doivent également respecter les mêmes critères de validation.

Localisation

Logto fournit des traductions système pour les champs de données utilisateur de base, tels que firstName, lastName, gender et birthdate. Le libellé de ces champs est configurable dans la Console Logto. Vous pouvez remplacer ces libellés en fournissant vos propres traductions dans Logto > Connexion & compte > Contenu

Les champs personnalisés reposent entièrement sur les libellés, exemples et descriptions que vous fournissez. Pour la localisation des champs personnalisés, vous pouvez gérer les traductions en utilisant Apportez votre UI ou nous contacter pour vos retours.

Management API (points clés)

Méthode	Endpoint	Objectif
GET	/api/custom-profile-fields	Lister tous les champs.
GET	/api/custom-profile-fields/:name	Récupérer la définition d'un champ par nom.
POST	/api/custom-profile-fields	Créer un champ.
POST	/api/custom-profile-fields/batch	Création en masse (≤20 éléments par requête).
PUT	/api/custom-profile-fields/:name	Mettre à jour un champ par nom et ensemble complet.
DELETE	/api/custom-profile-fields/:name	Supprimer un champ.
POST	/api/custom-profile-fields/properties/sie-order	Mettre à jour l'ordre des champs dans l'expérience de connexion.

Bonnes pratiques

• Collectez uniquement les données essentielles à l'inscription ; reportez les informations facultatives à une complétion ultérieure du profil.
• Utilisez les champs composites pour les données structurées (adresse, nom complet) pour la cohérence et la localisation.
• Fournissez des exemples / indices clairs pour les champs sensibles au format (regex, date, plages numériques).

FAQ

Les champs de profil collectent-ils les données des utilisateurs existants ?

Non, ils ne collectent que les informations lors de la dernière étape de l'inscription d'un nouvel utilisateur.

Que se passe-t-il si je supprime un champ ? Les données utilisateur sont-elles supprimées ?

Non, cela ne supprimera pas les données utilisateur existantes. Seul le champ sera retiré du formulaire d'inscription dans l'expérience utilisateur finale.

Puis-je collecter le pays avec une liste contrôlée au lieu d'un champ texte classique ?

Oui, vous pouvez remplacer le composant "Pays" par un champ "Liste déroulante (Sélection unique)" avec des options standardisées.