Collecter des attributs utilisateur personnalisés pendant l’inscription

S’applique à : Les locataires de main-d’œuvre Locataires externes (en savoir plus)

Conseil

Cet article s’applique aux flux d’utilisateurs dans des locataires externes. Pour plus d’informations sur les locataires de main-d’œuvre, consultez Définir des attributs personnalisés pour les flux d’utilisateurs.

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 faisons référence à ces attributs en tant qu’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.

En savoir plus sur les attributs utilisateur personnalisés dans l’article attributs de profil utilisateur .

Créer des attributs utilisateur personnalisés

1. Connectez-vous au Centre d’administration Microsoft Entra.

2. Si vous avez accès à plusieurs locataires, utilisez l’icône Paramètres dans le menu supérieur pour basculer vers votre locataire externe à partir du menu Répertoires + abonnements.

3. Naviguez vers Entra ID>Identités externes>Vue d'ensemble.

4. Sélectionnez Attributs utilisateur personnalisés. La liste contient tous les attributs utilisateur disponibles dans le tenant ainsi que les attributs utilisateur personnalisés qui ont été créés. La colonne Type d’attribut indique si un attribut est intégré ou personnalisé.

5. Sélectionnez Ajouter. Dans le volet Ajouter un attribut , entrez un nom pour l’attribut personnalisé (par exemple, « Conditions d’utilisation »).

6. Dans Type de données, choisissez String, Boolean ou Int en fonction du type de données et du contrôle d’entrée utilisateur que vous souhaitez créer. Les attributs de type String ont par défaut un type d'entrée utilisateur de TextBox, mais vous pouvez le changer ultérieurement (par exemple, si vous souhaitez configurer des cases d'option ou des cases à cocher à sélection multiple).

7. (Facultatif) Dans Description, entrez une description de l’attribut personnalisé pour une utilisation interne. Cette description n’est pas visible par l’utilisateur.

   

8. Sélectionnez Créer. L’attribut personnalisé est désormais disponible dans la liste des attributs utilisateur et peut être ajouté à vos flux d’utilisateurs.

Inclure l’attribut utilisateur personnalisé dans un flux d’inscription

Suivez ces étapes pour ajouter des attributs utilisateur personnalisés à un flux d’utilisateurs que vous avez déjà créé. (Si vous devez créer un flux d’utilisateur, consultez Créer un flux d’utilisateur d’inscription et de connexion pour les clients.)

1. Connectez-vous au Centre d’administration Microsoft Entra.

2. Si vous avez accès à plusieurs locataires, utilisez l’icône Paramètres dans le menu supérieur pour basculer vers votre locataire externe à partir du menu Répertoires + abonnements.

3. Accédez à Entra ID>Identités externes>flux utilisateur.

4. Sélectionnez le flux d’utilisateur dans la liste.

5. Sélectionnez Attributs utilisateur. La liste comprend tous les attributs utilisateur personnalisés que vous avez définis, comme indiqué dans la section précédente. Par exemple, le nouvel attribut Conditions d’utilisation apparaît désormais dans la liste. Choisissez tous les attributs à collecter auprès de l’utilisateur durant l’inscription.

   

6. Sélectionnez Enregistrer.

Configurer les types d’entrées utilisateur et la mise en page

Sur la page mise en page , vous pouvez indiquer quels attributs sont requis et organiser l’ordre d’affichage. Vous pouvez également modifier des étiquettes d’attribut, créer des cases d’option ou des cases à cocher, et ajouter des liens hypertexte vers du contenu supplémentaire (par exemple des conditions d’utilisation ou une politique de confidentialité).

1. Connectez-vous au Centre d’administration Microsoft Entra.

2. Accédez à Entra ID>Identités externes>flux utilisateur.

3. Dans la liste, sélectionnez votre flux utilisateur.

4. Sous Personnaliser, sélectionnez Mises en page. Les attributs à collecter que vous avec choisis sont répertoriés.

5. Modifiez l’étiquette pour n’importe quel attribut en sélectionnant la valeur dans la colonne Label et en modifiant le texte.

6. Configuration de cases à cocher ou de cases d’option :

   • Case à cocher unique : Un type d’attribut booléen s’affiche sous la forme d’une case à cocher unique sur la page d’inscription. Pour configurer le texte qui s’affiche en regard de la case à cocher, sélectionnez et modifiez la valeur dans la colonne Étiquette . Utilisez le langage Markdown pour ajouter des liens hypertexte. Pour plus d’informations, consultez Pour configurer une seule case à cocher (CheckboxSingleSelect)
   • Cases à cocher multiples : recherchez l’attribut de type de données String que vous souhaitez configurer, puis sélectionnez la valeur dans la colonne Type d’entrée utilisateur pour ouvrir la fenêtre de l'éditeur. Choisissez le type d’entrée utilisateur CheckboxMultiSelect et entrez les valeurs. Pour plus d’informations, consultez Pour configurer des cases à cocher à sélection multiple (CheckboxMultiSelect).
   • Cases d’option : Trouvez l’attribut de type de données String que vous souhaitez configurer, puis sélectionnez la valeur dans la colonne Type d’entrée utilisateur pour ouvrir la fenêtre de l’éditeur. Choisissez le type d’entrée utilisateur RadioSingleSelect et entrez les valeurs. Pour des détails, consultez Pour configurer des boutons radio (RadioSingleSelect)

7. Modifiez l’ordre d’affichage en sélectionnant un attribut et en choisissant Déplacer vers le haut, Descendre, Passer en haut ou Déplacer vers le bas.

8. Définissez un attribut requis en cochant la case dans la colonne Obligatoire . Tous les attributs peuvent être définis comme étant obligatoires. Pour les cases à cocher à sélection multiple, « Obligatoire » signifie que l’utilisateur doit cocher au moins une case.

9. Une fois toutes vos modifications terminées, sélectionnez Enregistrer.

Configurer une case à cocher à sélection unique (CheckboxSingleSelect)

Un attribut avec un type de données booléen a le type d’entrée utilisateur CheckboxSingleSelect. Vous pouvez modifier le texte qui s’affiche en regard de la case à cocher et inclure des liens hypertexte.

Conseil

Pour essayer cette fonctionnalité, accédez à la démonstration Woodgrove Groceries et démarrez le cas d’usage « Ajouter des liens aux conditions d’utilisation et aux stratégies de confidentialité ».

Pour configurer une case à cocher unique, procédez comme suit :

1. Sur la page Mises en page, recherchez l’attribut avec le type de données Boolean que vous souhaitez configurer.

2. Sélectionnez la valeur dans la colonne Étiquette et entrez le texte à afficher en regard de la case à cocher. Utilisez le langage Markdown pour ajouter des liens hypertexte. Par exemple :

   • Pour configurer l’étiquette d’un attribut Conditions d’utilisation , vous pouvez entrer :

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use).

   • Autrement, vous pouvez combiner vos conditions d’utilisation et votre politique de confidentialité dans une seule case à cocher obligatoire :

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use) and the [privacy policy](https://woodgrove.com/privacy).

3. Sélectionnez Ok.

   

4. Sur la page des Mises en page, sélectionnez Enregistrer.

Configurer des cases à cocher à sélection multiple (CheckboxMultiSelect)

Un attribut ayant un type de données Chaîne peut être configuré en tant que type d’entrée utilisateur CheckboxMultiSelect. Il consiste alors en une série d’une ou de plusieurs cases à cocher apparaissant sous l’étiquette d’attribut. L’utilisateur peut sélectionner une ou plusieurs cases à cocher. Vous pouvez définir le texte des cases à cocher individuelles et inclure des liens hypertexte vers d’autres contenus. Si l’attribut est « Obligatoire », l’utilisateur doit cocher au moins l’une des cases.

1. Dans la page Mises en page, recherchez l’attribut avec le type de données String que vous souhaitez configurer en tant que série de cases à cocher.

2. Sélectionnez la valeur dans la colonne Étiquette et entrez l’en-tête que vous souhaitez afficher au-dessus de la série de cases à cocher, par exemple How did you hear about us?.

3. Sélectionnez la valeur dans la colonne Type d’entrée utilisateur pour ouvrir le volet de l’éditeur.

4. Dans le volet de l’éditeur, sous Type d'entrée utilisateur, sélectionnez CheckboxMultiSelect.

5. Pour chaque case à cocher à ajouter, commencez sur une nouvelle ligne, puis entrez les informations suivantes :

   • Sous Texte, entrez le texte à afficher en regard de la case à cocher. Utilisez le langage Markdown pour ajouter des liens hypertexte.

   • Sous Valeurs, entrez une valeur à écrire sur l’objet utilisateur et retournée comme revendication si l’utilisateur sélectionne la case à cocher.

6. Sélectionnez Ok.

   

7. Sur la page des Mises en page, sélectionnez Enregistrer.

Configurer des cases d’option (RadioSingleSelect)

Un attribut ayant un type de données Chaîne peut être configuré en tant que type d’entrée utilisateur RadioSingleSelect. Il consiste alors en une série de cases d’option apparaissant sous l’étiquette d’attribut. L’utilisateur ne peut sélectionner qu’une seule case d’option. Vous pouvez définir le texte des cases d’option individuelles et inclure des liens hypertexte vers d’autres contenus.

1. Dans la page Mises en page, recherchez l’attribut avec le type de données String que vous souhaitez configurer en tant que bouton radio ou série de boutons radio.

2. Sélectionnez la valeur dans la colonne Étiquette et entrez l'intitulé que vous souhaitez afficher au-dessus de la série de boutons radio, par exemple Sweatshirt size.

3. Sélectionnez la valeur dans la colonne Type d’entrée utilisateur pour ouvrir le volet de l’éditeur.

4. Dans le volet de l’éditeur, sous Type d’entrée utilisateur, sélectionnez RadioSingleSelect.

5. Pour chaque case d’option à ajouter, commencez sur une nouvelle ligne, puis entrez les informations suivantes :

   • Sous Texte, entrez le texte à afficher en regard du bouton radio. Utilisez le langage Markdown pour ajouter des liens hypertexte.

   • Sous Valeurs, entrez une valeur à écrire sur l’objet utilisateur et retournée comme revendication si l’utilisateur sélectionne la case d’option.

6. Sélectionnez Ok.

   

7. Sur la page des Mises en page, sélectionnez Enregistrer.

Rechercher l’ID d’application pour l’application extensions

Les attributs utilisateur personnalisés 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 supprimée de l’ID client pour l’application b2c-extensions-app.
• {custom-attribute-name} est le nom que vous avez attribué à l’attribut personnalisé.

Suivez ces étapes pour rechercher l’ID d’application pour l’application extensions :

1. Connectez-vous au Centre d’administration Microsoft Entra.
2. Accédez à Entra ID>Inscriptions d'applications>Toutes les applications.
3. Sélectionnez l’application b2c-extensions-app. Ne modifiez pas. Utilisé par AADB2C pour stocker les données utilisateur.
4. Dans la page Vue d’ensemble , utilisez la valeur d’ID d’application (client), par exemple : 12345678-abcd-1234-1234-ab123456789, mais supprimez les traits d’union.

Par exemple, si vous créez un attribut personnalisé nommé loyaltyNumber, faites-le référence en tant que extension_12345678abcd12341234ab123456789_loyaltyNumber

Ajouter des attributs utilisateur personnalisés au jeton d’ID

Lorsqu’un utilisateur se connecte à votre application, celle-ci reçoit un jeton d’ID, qui comprend les détails de l’utilisateur. Ces détails sont appelés revendications de jeton. Si nécessaire, vous pouvez inclure un attribut utilisateur personnalisé qui pourra faire office de revendication dans le jeton d’ID retourné à votre application. Pour ce faire, suivez les étapes décrites dans Ajouter des attributs au jeton d’ID retourné à l’article de votre application .

Étapes suivantes

Ajoutez des attributs au jeton d’ID retourné à votre application.

Créez un flux d’utilisateur d’inscription et de connexion pour les clients.