Collecter des attributs utilisateur personnalisés lors de l'inscription d'un client externe

S’applique à : Locataires externes (en savoir plus)

Conseil

Cet article s’applique aux flux d’utilisateurs dans des locataires externes. Pour plus d’informations sur les utilisateurs liés au personnel, consultez Collecter les attributs d'utilisateur personnalisés lors de l’inscription à la collaboration B2B.

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 locataire, afin qu’il puisse être utilisé dans n’importe quel flux d’utilisateurs du locataire. Affectez ensuite l’attribut à votre flux d’utilisateur 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 locataire 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

Procédez comme suit afin d’ajouter des attributs utilisateur personnalisés à un flux utilisateur 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 d’utilisateurs.

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 décrit 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 que vous souhaitez collecter auprès de l’utilisateur au cours de 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 d’utilisateurs.

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. Configurer les cases à cocher ou les 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.

Pour configurer une case à cocher à sélection 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).

   • Vous pouvez aussi 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 avec un type de données String 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 que vous voulez ajouter, commencez sur une nouvelle ligne, puis saisissez 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 avec un type de données String peut être configuré en tant que type d’entrée utilisateur RadioSingleSelect. Il consiste 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 case d’option ou série de cases d’option.

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 que vous voulez ajouter, commencez sur une nouvelle ligne, puis saisissez 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, saisissez 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.

Configurer la visibilité et la modification des attributs avec Microsoft Graph

Vous pouvez déterminer quels attributs sont affichés ou collectés auprès des utilisateurs lors de l’inscription en configurant les indicateurs masqués et modifiables pour chaque attribut. Ces paramètres ne sont actuellement pas disponibles dans l’interface utilisateur du centre d’administration, mais vous pouvez les configurer à l’aide de Microsoft Graph.

Chaque attribut prend en charge les indicateurs suivants :

• hidden : cet indicateur est false par défaut pour que l’attribut s’affiche sur la page d’inscription, mais vous pouvez le définir sur true pour masquer l’attribut.
• editable : cet indicateur est true par défaut pour permettre aux utilisateurs de modifier l’attribut, mais vous pouvez le définir sur false pour que l’attribut soit en lecture seule.

Exemples:

• Pour afficher l’attribut sur la page, mais empêcher les utilisateurs de le modifier, définir hidden sur false et editable sur false.
• Pour masquer l’attribut de la page tout en l’autorisant à être défini par programmation, définir hidden sur true et editable sur true. Par exemple, vous pouvez affecter une valeur à l’attribut en créant une extension d’authentification personnalisée pour un événement de soumission de collection d’attributs.

Pour définir les indicateurs masqués et modifiables à l’aide de Microsoft Graph, utilisez le type de ressource authenticationAttributeCollectionInputConfiguration. Pour référence, consultez l’exemple de mise à jour de la mise en page d’un flux d’utilisateur d’inscription en libre-service.

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, il est ajouté à l’objet utilisateur et peut être appelé via Microsoft API Graph à l’aide de la convention de 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 revendications 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.