Définir des attributs personnalisés pour les flux d’utilisateurs

Pour chaque application, vous pouvez avoir des exigences différentes concernant les informations que vous souhaitez collecter lors de l’inscription. Azure AD est fourni avec un ensemble intégré d’informations stockées dans des attributs, comme le prénom, le nom, la localité et le code postal. Avec Azure AD, vous pouvez étendre l’ensemble des attributs stockés sur un compte invité lorsque l’utilisateur externe s’inscrit via un flux utilisateur.

Vous pouvez créer des attributs personnalisés dans le portail Azure et les utiliser dans vos flux utilisateur d’inscription en libre-service. Vous pouvez également lire et écrire ces attributs à l’aide de l’API Microsoft Graph. L’API Microsoft Graph prend en charge la création et la mise à jour d’un utilisateur avec des attributs d’extension. Dans l’API Graph, les attributs d’extension sont nommés à l’aide de la convention extension_<extensions-app-id>_attributename. Par exemple :

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

Cette valeur <extensions-app-id> est spécifique à votre locataire. Pour trouver cet identificateur, accédez à Azure Active Directory > Inscriptions d’applications > Toutes les applications. Recherchez l’application qui commence par « aad-extensions-app », puis sélectionnez-la. Sur la page Vue d’ensemble, notez l’ID d’application (client).

Création d’un attribut personnalisé

  1. Connectez-vous au Portail Azure en tant qu’administrateur Azure AD.

  2. Sous Services Azure, sélectionnez Azure Active Directory.

  3. Dans le menu de gauche, sélectionnez Identités externes.

  4. Sélectionnez Attributs personnalisés de l’utilisateur. Les attributs utilisateur disponibles sont répertoriés.

    Select user attributes for sign-up

  5. Pour ajouter un attribut, sélectionnez Ajouter.

  6. Dans le volet Ajouter un attribut, entrez les valeurs suivantes :

    • Nom : fournissez un nom pour l’attribut personnalisé (par exemple, « ShoeSize »).
    • Type de données : choisissez un type de données (chaîne, booléenou entier).
    • Description : vous pouvez entrez une description de l’attribut personnalisé à usage interne. Cette description n’est pas visible par l’utilisateur.

    Add an attribute

  7. Sélectionnez Create (Créer).

L’attribut personnalisé est maintenant disponible dans la liste des attributs utilisateur, et pour une utilisation dans vos flux utilisateur. Un attribut personnalisé est créé lors de sa première utilisation dans un flux utilisateur, non quand vous l’ajoutez à la liste des attributs utilisateur.

Une fois que vous avez créé un utilisateur à l’aide d’un flux utilisateur qui utilise l’attribut personnalisé nouvellement créé, l’objet peut être interrogé dans l’Explorateur Microsoft Graph. Vous devez maintenant voir ShoeSize dans la liste d’attributs collectés lors de l’inscription sur l’objet utilisateur. Vous pouvez appeler l’API Graph à partir de votre application pour récupérer les données de cet attribut après qu’il a été ajouté à l’objet utilisateur.

Étapes suivantes

Ajouter un flux utilisateur d’inscription en libre-service à une application