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, espaces réservés et règles de validation. Configurez les champs comme obligatoires ou optionnels 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
- Rendez-vous sur Console Logto > Expérience de connexion > Collecter le profil utilisateur.
- 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.
- 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".
- Retournez dans Expérience de connexion > Collecter le profil utilisateur, faites glisser et déposez les champs pour les réorganiser ; les modifications seront automatiquement appliquées.
- 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 une vue d'ensemble complète 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 | Date de naissance de l'utilisateur dans un format spécifié (ex : "MM-jj-aaaa"). |
Genre | user.profile.gender | 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 | 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, état, 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, centres d'intérêt, taille de l'entreprise ou autres attributs spécifiques à l'activité.
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é à l'utilisateur. Flotte en haut lorsque le champ a une valeur ou est sélectionné. Champ obligatoire. |
Espace réservé | Tous (sauf case à cocher) | Indice en ligne visible lorsque le libellé flotte (exemple de texte / guide de formatage). |
Description | Tous (sauf case à cocher) | Texte d'accompagnement sous le champ pour des instructions plus longues ou un contexte supplémentaire. |
Obligatoire | Tous (sauf case à cocher) | Si activé, la soumission est bloquée si vide. Si désactivé, une étiquette (Optionnel) 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/perso) | Choisissez des formats prédéfinis (MM/jj/aaaa, jj/MM/aaaa, aaaa-MM-jj). Changer l'espace réservé remplace les interactions par défaut. Ou utilisez des motifs date-fns entièrement personnalisables. |
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 | Motif de validation (sans les barres obliques 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, état, 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 requise (sauf case à cocher).
- Limites de longueur (Texte).
- Plage numérique (Nombre).
- Correspondance de motif (Regex, Date avec format, URL, appartenance à une option de sélection).
- Structure de l'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 > Expérience de connexion > Contenu
Les champs personnalisés dépendent entièrement des libellés, espaces réservés 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 avec vos retours.
Management API (points de terminaison clés)
Méthode | Point de terminaison | 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 clairs / espaces réservés 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 l'étape finale de l'inscription d'un nouvel utilisateur.
Que se passe-t-il si je supprime un champ ? Est-ce que cela supprime la donnée utilisateur ?
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 basculer le composant "Pays" en un champ "Liste déroulante (Sélection unique)" avec des options standardisées.