Attributs de profil utilisateur
S’applique à :
Locataires de main-d’œuvre 
Locataires externes (en savoir plus)
Les attributs utilisateur que vous collectez pendant l’inscription sont stockés avec le profil de l’utilisateur dans votre annuaire. Vous pouvez choisir parmi les attributs utilisateur intégrés ou vous pouvez créer des attributs utilisateur personnalisés.
Attributs utilisateur intégrés, tels que la ville, le pays/la région, l’adresse e-mail, etc. sont disponibles dans ID externe Microsoft Entra. Vous pouvez choisir les attributs utilisateur intégrés que vous souhaitez collecter lors de l’inscription.
Pour toutes les informations supplémentaires que vous souhaitez collecter, vous pouvez créer des attributs utilisateur personnalisés. Plusieurs contrôles d’entrée personnalisés peuvent être ajoutés à la page d’inscription pour collecter les attributs, notamment les zones de texte, les cases d’option et les cases à cocher. L’exemple suivant montre comment les contrôles d’entrée personnalisés peuvent être utilisés pour collecter des attributs pour le numéro de fidélité, le consentement aux conditions d’utilisation pour les conditions d’utilisation et le consentement à la politique de confidentialité.
Attributs utilisateur intégrés
L’ID externe Microsoft Entra a des attributs utilisateur intégrés que vous pouvez collecter lors de l’inscription. Vous configurez ces attributs lorsque vous créer des flux utilisateur dans le centre d’administration Microsoft Entra.
Ce tableau récapitule les attributs utilisateur intégrés que vous pouvez collecter pendant le flux d’inscription :
- Étiquette dans le centre d’administration Microsoft Entra est le nom de l’attribut utilisateur tel qu’il apparaît dans le centre d’administration Microsoft Entra.
- Nom programmable est le nom de l’attribut utilisateur tel qu’utilisé dans la ressource utilisateur de l’API Microsoft Graph. Vous utilisez ce nom lorsque vous souhaitez utiliser cet attribut utilisateur de manière programmatique, par exemple dans l’authentification native.
- Type de données est le type de données de l’attribut utilisateur.
| Étiquette dans le centre d’administration Microsoft Entra | Nom programmable | Type de données | Notes |
|---|---|---|---|
| Ville | city | Chaîne | La longueur maximale est de 128 caractères. |
| Pays/région | country | Chaîne | La longueur maximale est de 128 caractères. |
| Nom d’affichage | displayName | Chaîne | La longueur maximale est de 256 caractères. |
| Adresse e-mail | Chaîne | Cette propriété ne peut pas contenir de caractères d’accentuation. Dans l’API d’authentification native, cet attribut est référencé comme nom d’utilisateur. | |
| Prénom | givenName | Chaîne | La longueur maximale est de 64 caractères. |
| Poste | jobTitle | Chaîne | La longueur maximale est de 128 caractères. |
| Code postal | postalCode | Chaîne | La longueur maximale est de 40 caractères. |
| Département/Province | état | Chaîne | La longueur maximale est de 128 caractères. |
| Adresse postale | streetAddress | Chaîne | La longueur maximale est de 1 024 caractères. |
| Nom de famille | surname | Chaîne | La longueur maximale est de 64 caractères. |
Attributs personnalisés de l’utilisateur
Si votre application nécessite plus d’informations que celles fournies par les attributs utilisateur intégrés, vous pouvez ajouter vos propres attributs. Nous les dénommons ici attributs utilisateur personnalisés.
Pour définir un attribut utilisateur personnalisé, vous devez d’abord créer l’attribut au niveau du tenant afin qu’il puisse être utilisé dans n’importe quel flux d’utilisateurs du tenant. Affectez ensuite l’attribut à votre flux d’utilisateurs d’inscription, puis configurez la façon dont vous souhaitez qu’il apparaisse dans la page d’inscription.
Découvrez comment créer des attributs utilisateur personnalisés dans l’article Créer des attributs utilisateur personnalisés.
Types d’entrée des attributs utilisateur personnalisés
Avant d’utiliser des attributs utilisateur personnalisés, déterminez la meilleure façon de collecter les entrées utilisateur pour chaque attribut personnalisé que vous souhaitez collecter. Vous pouvez collecter des informations auprès de vos utilisateurs lors de l’inscription à l’aide des contrôles de type d’entrée suivants :
- Zone de texte de chaîne
- Cases d'option
- Cases à cocher à sélection multiple
- Zone de texte numérique
- Case à cocher à sélection unique
Consultez ce tableau pour rechercher les types de données et les types d’entrée utilisateur appropriés :
| Type de données | Type d’entrée utilisateur | Description |
|---|---|---|
| Chaîne | TextBox | Champ d’entrée de texte libre. |
| Chaîne | RadioSingleSelect | Série de cases d’option avec une seule sélection autorisée. Le texte des cases d’option individuelles peut inclure des liens hypertexte mis en forme à l’aide du langage Markdown. |
| Chaîne | CheckboxMultiSelect | Série d’une ou de plusieurs cases à cocher autorisant les sélections multiples. Le texte des cases à cocher individuelles peut inclure des liens hypertexte mis en forme à l’aide du langage Markdown. |
| Boolean | CheckboxSingleSelect | Case à cocher booléenne unique avec étiquette. L’étiquette d’une case à cocher peut inclure des liens hypertexte mis en forme à l’aide du langage Markdown. |
| Int | NumericTextBox | Entrée d’entier libre. |
Les cases à cocher et les cases d’option peuvent inclure des liens hypertexte vers d’autres contenus, tels que des conditions d’utilisation et des politiques de confidentialité. L’exemple au début de cet article montre une page d’inscription qui combine des attributs intégrés et des attributs personnalisés. Dans l’exemple :
- Le champ Nom d’affichage est un attribut intégré.
- Le numéro de fidélité est un attribut personnalisé avec un champ d’entrée libre qui accepte un entier numérique. Vous pouvez configurer ce format à l’aide du type de données Entier et du type d’entrée utilisateur NumericTextBox.
- Les attributs personnalisés pour les conditions d’utilisation et les politiques de confidentialité sont des cases à cocher distinctes à sélection unique avec des étiquettes contenant des liens hypertexte. Vous pouvez configurer une case à cocher unique à l’aide du type de données Booléen, qui a pour valeur par défaut le type d’entrée utilisateur CheckboxSingleSelect. Utilisez le langage Markdown pour ajouter des liens hypertexte à l’étiquette de la case à cocher.
Découvrez comment configurer leurs types d’entrée d’attributs utilisateur dans l’article Configurer les types d’entrée utilisateur.
Où sont stockés les attributs utilisateur personnalisés
Les attributs utilisateur personnalisés sont également appelés attributs d’extension d’annuaire, car ils étendent les informations de profil utilisateur stockées dans votre annuaire. Tous les attributs d’extension de votre locataire externe sont stockés dans une application nommée b2c-extensions-app. Une fois qu’un utilisateur a entré une valeur pour l’attribut personnalisé lors de l’inscription, celui-ci peut être ajouté à l’objet utilisateur et appelé via l’API Microsoft Graph en utilisant la convention d’affectation de noms extension_{appId-without-hyphens}_{custom-attribute-name} où :
{appId-without-hyphens}est la version dépouillée de l’ID client pour b2c-extensions-app.{custom-attribute-name}est le nom que vous avez attribué à l’attribut personnalisé.
Par exemple, si l’ID client de b2c-extensions-app est 2588a-bcdwh-tfeehj-jeeqw-ertc et que le nom de l’attribut est :
- loyaltyNumber, alors l’attribut personnalisé est nommé
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. - Loyalty Number, alors l’attribut personnalisé est nommé
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Vous supprimez l’espace et utilisez la casse mixte pour séparer les mots.
Servez-vous de l’article Rechercher l’ID d’application pour l’application d’extension pour savoir comment trouver l’ID d’application de b2c-extensions-app, inscrite dans votre locataire externe.
API Microsoft Graph
Les attributs utilisateur sont appelés attributs de flux utilisateur dans Microsoft Graph. Utilisez le type de ressource identityUserFlowAttribute et ses méthodes associées pour gérer les attributs de flux utilisateur intégrés et personnalisés.