Comment autoriser des comptes de développeurs avec Azure Active Directory B2C dans Gestion des API Azure

  • Article

S’APPLIQUE À : Développeur | Essentiel | Essentiel v2 | Standard | Standard v2 | Premium

Azure Active Directory B2C est une solution de gestion des identités de cloud pour applications web et mobiles grand public. Vous pouvez l’utiliser pour gérer l’accès au portail des développeurs API Management.

Dans ce tutoriel, vous allez découvrir comment configurer le service Gestion des API pour permettre son intégration à Azure Active Directory B2C.

Pour bénéficier d’une vue d’ensemble des options permettant de sécuriser le portail des développeurs, consultez Sécuriser l’accès au portail des développeurs Gestion des API.

Important

  • Cet article a été mis à jour avec les étapes de configuration d’une application Azure AD B2C à l’aide de la bibliothèque d’authentification Microsoft (MSAL).
  • Si vous avez précédemment configuré une application Azure AD B2C pour une connexion utilisateur à l’aide de la Bibliothèque d’authentification Azure AD (ADAL), nous vous recommandons d’opérer une migration vers MSAL.

Configuration requise

Configurer le flux d’utilisateur Inscription et connexion

Dans cette section, vous allez créer un flux d’utilisateurs au sein de votre locataire Azure Active Directory B2C, qui contient à la fois les stratégies d’inscription et de connexion. Pour obtenir des instructions détaillées, consultez Créer des flux d’utilisateurs et des stratégies personnalisées dans Azure Active Directory B2C.

  1. Dans le Portail Azure, accédez à votre abonné Azure Active Directory B2C.
  2. Sous Stratégies, sélectionnez Flux d’utilisateurs>+ Nouveau flux d’utilisateurs.
  3. Dans la page Créer un flux d’utilisateur, sélectionnez le flux utilisateur Inscription et connexion. Cliquez sur la version Recommandée puis cliquez sur Créer.
  4. Sur la page Créer, renseignez les informations suivantes :
    1. Entrez un nom unique pour le flux d’utilisateurs.
    2. Dans Fournisseurs d’identité, sélectionnez Inscription par e-mail.
    3. Dans Attributs utilisateur et revendications des jetons, sélectionnez les attributs et les revendications suivants nécessaires pour le portail des développeurs Gestion des APIM.

      • Collecter les attributs : prénom, nom de famille

      • Revendications : prénom, nom de famille, adresses email, ID objet de l’utilisateur

        Capture d’écran des attributs et revendications dans le portail

  5. Sélectionnez Créer.

Configurer le fournisseur d’identité pour le portail des développeurs

  1. Dans un onglet Portail Azure séparé, accédez à votre instance API Management.

  2. Sous Portail des développeurs, sélectionnez Identités>+ Ajouter.

  3. Dans la page Ajouter le fournisseur d’identité, sélectionnez Azure Active Directory B2C. Une fois cette option sélectionnée, vous pouvez entrer d’autres informations nécessaires.

    • Dans la liste déroulante Bibliothèque de client, sélectionnez MSAL.
    • Pour ajouter d’autres paramètres, consultez les étapes décrites plus loin dans l’article.

  4. Dans la fenêtre Ajouter le fournisseur d’identité, copiez l’URL de redirection.

    Capture d'écran de l'URL de redirection dans le portail.

  5. Revenez à l’onglet du navigateur pour votre abonné Azure Active Directory B2C dans le Portail Azure. Sélectionnez Inscriptions d'applications>+ Nouvelle inscription.

  6. Dans la page Inscrire une application, entrez les informations d’inscription de votre application.

    • Dans la section Nom, entrez un nom d’application de votre choix.
    • Dans la section Types de comptes pris en charge, sélectionnez Comptes dans un répertoire organisationnel (pour authentifier les utilisateurs avec des flux d’utilisateurs). Pour plus d’informations, consultez Inscrire une application.
    • Dans URI de redirection, sélectionnez Application monopage (SPA) et collez l’URL de redirection que vous avez enregistrée lors d’une étape précédente.
    • Dans Autorisations, sélectionnez Accorder le consentement administrateur aux autorisations openid et offline_access.
    • Sélectionnez Inscrire pour créer l’application.

    Capture d’écran de l’inscription d’une nouvelle application dans le portail.

  7. Dans la page de Présentation de l’application, recherchez la valeur ID d’application (client) et copiez la valeur dans le presse-papiers.

    Capture d’écran de la page Vue d’ensemble dans le portail.

  8. Revenez à la page Ajouter un fournisseur d’identité dans API Management et collez l’ID dans la zone de texte ID client.

  9. Revenez à l’inscription de l’application B2C. Sélectionnez Certificats et secrets>+ Nouveau secret client. Capture d’écran de la création d’un secret client dans le portail.

    • Dans la page Ajouter un secret client, entrez une Description et sélectionnez Ajouter.
    • Enregistrez la valeur dans un endroit sûr. Cette valeur secrète ne sera plus jamais affichée lorsque vous aurez quitté cette page.

  10. Revenez à la page Ajouter un fournisseur d’identité dans API Management et collez la clé dans la zone de texte Secret client.

  11. Continuez dans la page Ajouter un fournisseur d’identité :

    • Dans Abonné de connexion, spécifiez le nom de domaine de l’abonné Azure Active Directory B2C.

    • Le champ Autorité vous permet de contrôler l’URL de connexion Azure Active Directory B2C à utiliser. Définissez la valeur pour qu’elle corresponde à <votre_nom_de_locataire_b2c>.b2clogin.com.

    • Spécifiez la politique d’inscription et la politique de connexion en utilisant le nom du flux d’utilisateur que vous avez créé à l’étape précédente.

    • Si vous le souhaitez, fournissez la Stratégie de modification du profil et la Stratégie de réinitialisation du mot de passe.

      Capture d’écran de la configuration du fournisseur d’identité Azure Active Directory B2C dans le portail.

  12. Après avoir spécifié la configuration souhaitée, sélectionnez Ajouter.

  13. Republiez le portail des développeurs pour que la configuration Azure AD B2C prenne effet. Dans le menu de gauche, sous Portail des développeurs, sélectionnez Vue d’ensemble du portail>Publier.

Après avoir enregistré les modifications, les développeurs pourront créer de nouveaux comptes et se connecter au portail des développeurs à l’aide d’Azure Active Directory B2C.

Migration vers MSAL

Si vous avez précédemment configuré une application Azure AD B2C pour une connexion utilisateur à l’aide de la bibliothèque ADAL, vous pouvez utiliser le portail pour migrer l’application vers MSAL et mettre à jour le fournisseur d’identité dans Gestion des API.

Mettre à jour l’application Azure AD B2C pour la compatibilité MSAL

Pour connaître les étapes de mise à jour de l’application Azure AD B2C, consultez Basculer les URL de redirection vers le type d’application mono-page.

Mettre à jour la configuration du fournisseur d’identité

  1. Dans le menu de gauche de votre instance de Gestion des API, sous Portail des développeurs, sélectionnez Identités.
  2. Dans la liste, sélectionnez Azure Active Directory B2C.
  3. Dans la liste déroulante Bibliothèque de client, sélectionnez MSAL.
  4. Sélectionnez Mettre à jour.
  5. Republiez votre portail des développeurs.

Portail des développeurs - Ajouter l’authentification de compte Azure Active Directory B2C

Important

Vous devez republier le portail des développeurs lorsque vous créez ou mettez à jour des paramètres de configuration Azure Active Directory B2C pour que les modifications prennent effet.

Dans le portail des développeurs, il est possible de se connecter via Azure Active Directory B2C à l’aide du widget Bouton de connexion : OAuth. Le widget est déjà inclus dans la page de connexion du contenu du portail des développeurs par défaut.

  1. Pour s’inscrire en utilisant Azure Active Directory B2C, ouvrez une nouvelle fenêtre de navigateur et accédez au portail des développeurs. Sélectionnez Connexion.

  2. Dans la page Se connecter, sélectionnez Azure Active Directory B2C.

    Capture d’écran de la connexion au portail des développeurs.

  3. Vous êtes redirigé vers la stratégie d’inscription que vous avez configurée dans la section précédente. Choisissez de vous inscrire à l’aide de votre adresse de messagerie dans l’abonné Active Directory B2C.

Une fois l’inscription terminée, vous êtes redirigé vers le portail des développeurs. Vous êtes maintenant inscrit sur le portail des développeurs pour votre instance de service Gestion des API.

Se connecter au portail des développeurs complet

Bien qu’un compte soit automatiquement créé chaque fois qu’un nouvel utilisateur se connecte avec Azure Active Directory B2C, vous pouvez ajouter le même widget à la page d’inscription.

Le widget Formulaire d’inscription : OAuth représente un formulaire utilisé pour s’inscrire à l’aide d’OAuth.

Étapes suivantes