Configurer l’inscription et la connexion avec un compte OpenID Connect - Azure AD B2C

Article
03/21/2023

Avant de commencer, utilisez le sélecteur Choisir un type de stratégie pour choisir le type de stratégie que vous configurez. Azure Active Directory B2C offre deux possibilités pour définir la façon dont les utilisateurs interagissent avec vos applications : via des flux utilisateurs prédéfinis ou via des stratégies personnalisées entièrement configurables. La procédure donnée dans cet article est différente pour chaque méthode.

OpenID Connect est un protocole d’authentification basé sur OAuth 2.0, qu’il est possible d’utiliser pour la connexion sécurisée des utilisateurs. La plupart des fournisseurs d’identité qui utilisent ce protocole sont pris en charge dans Azure AD B2C.

Cet article explique comment ajouter un fournisseur d’identité OpenID Connect personnalisé dans vos flux d’utilisateur.

Important

Vos points de terminaison doivent respecter les exigences d’Azure AD B2C en matière de sécurité. Les versions et les chiffrements TLS antérieurs sont déconseillés. Pour plus d’informations, consultez Configuration requise pour TLS et les suites de chiffrement Azure AD B2C.

Prérequis

Créez un flux d’utilisateurs pour permettre aux utilisateurs de s’inscrire et de se connecter à votre application.
Inscrire une application web.

Suivez les étapes dans Bien démarrer avec les stratégies personnalisées dans Active Directory B2C
Inscrire une application web.

Ajouter le fournisseur d’identité

Connectez-vous au portail Azure en tant qu’administrateur général de votre locataire Azure AD B2C.
Si vous avez accès à plusieurs locataires, sélectionnez l’icône Paramètres dans le menu supérieur pour basculer vers votre locataire Azure AD B2C à partir du menu Annuaires + abonnements.
Choisissez Tous les services dans le coin supérieur gauche du Portail Azure, recherchez et sélectionnez Azure Active Directory B2C.
Sélectionnez Fournisseurs d’identité, puis Nouveau fournisseur OpenID Connect.
Saisissez un Nom. Par exemple, entrez Contoso.

Définissez le fournisseur d’identité OpenId Connect en l’ajoutant à l’élément ClaimsProviders dans le fichier d’extension de votre stratégie.

Ouvrez le fichier TrustFrameworkExtensions.xml.
Recherchez l’élément ClaimsProviders. S’il n’existe pas, ajoutez-le sous l’élément racine.

Ajoutez un nouveau ClaimsProvider comme suit :

<ClaimsProvider>
  <Domain>contoso.com</Domain>
  <DisplayName>Login with Contoso</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Contoso-OpenIdConnect">
      <DisplayName>Contoso</DisplayName>
      <Description>Login with your Contoso account</Description>
      <Protocol Name="OpenIdConnect"/>
      <Metadata>
        <Item Key="METADATA">https://your-identity-provider.com/.well-known/openid-configuration</Item>
        <Item Key="client_id">00000000-0000-0000-0000-000000000000</Item>
        <Item Key="response_types">code</Item>
        <Item Key="scope">openid profile</Item>
        <Item Key="response_mode">form_post</Item>
        <Item Key="HttpBinding">POST</Item>
        <Item Key="UsePolicyInRedirectUri">false</Item>
      </Metadata>
      <!-- <CryptographicKeys>
        <Key Id="client_secret" StorageReferenceId="B2C_1A_ContosoSecret"/>
      </CryptographicKeys> -->
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="oid"/>
        <OutputClaim ClaimTypeReferenceId="tenantId" PartnerClaimType="tid"/>
        <OutputClaim ClaimTypeReferenceId="givenName" PartnerClaimType="given_name" />
        <OutputClaim ClaimTypeReferenceId="surName" PartnerClaimType="family_name" />
        <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="name" />
        <OutputClaim ClaimTypeReferenceId="email" PartnerClaimType="email" />
        <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" AlwaysUseDefaultValue="true" />
        <OutputClaim ClaimTypeReferenceId="identityProvider" PartnerClaimType="iss" />
        <OutputClaim ClaimTypeReferenceId="objectId" PartnerClaimType="oid"/>
      </OutputClaims>
      <OutputClaimsTransformations>
        <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName"/>
        <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName"/>
        <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId"/>
        <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId"/>
      </OutputClaimsTransformations>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin"/>
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

Configurer le fournisseur d’identité

Chaque fournisseur d’identité OpenID Connect décrit un document de métadonnées qui contient la plupart des informations nécessaires pour effectuer la connexion. Le document des métadonnées inclut des informations telles que les URL à utiliser et l’emplacement des clés de signature publiques du service. Le document de métadonnées OpenID Connect est toujours situé dans un point de terminaison qui se termine par .well-known/openid-configuration. Pour le fournisseur d’identité OpenID Connect que vous cherchez à ajouter, entrez l’URL de métadonnées.

Dans l’URL de métadonnées, entrez l’URL du document de configuration métadonnées OpenID Connect.

Dans les métadonnées du profil technique <Item Key="METADATA">, entrez l’URL du document de métadonnées OpenID Connect.

ID et secret client

Pour permettre aux utilisateurs de se connecter, le fournisseur d’identité exige des développeurs qu’ils inscrivent une application dans leur service. Cette application a un ID (appelé ID client) et une clé secrète client.

Le secret client est facultatif. Toutefois, vous devez fournir une clé secrète client si le Type de réponsecode utilise le secret pour échanger le code pour le jeton.

Pour ajouter l’ID client et la clé secrète client, copiez ces valeurs à partir du fournisseur d’identité et entrez-les dans les champs correspondants.

Dans les métadonnées du profil technique <Item Key="client_id">, entrez l’ID client.

Création d’une clé de stratégie

Si la clé secrète client est requise, stockez celle que vous avez enregistrée dans votre locataire Azure AD B2C.

Connectez-vous au portail Azure.
Veillez à bien utiliser l’annuaire qui contient votre locataire Azure AD B2C. Sélectionnez le filtre Répertoire + abonnement dans la barre d’outils du portail.
Sur la page Paramètres du portail | Répertoires + abonnements, recherchez votre répertoire AD B2C Azure dans la liste Nom de répertoire, puis sélectionnez Basculer.
Choisissez Tous les services dans le coin supérieur gauche du portail Azure, puis recherchez et sélectionnez Azure AD B2C.
Dans la page de vue d’ensemble, sélectionnez Infrastructure d’expérience d’identité.
Sélectionnez Clés de stratégie, puis Ajouter.
Pour Options, choisissez Manual.
Entrez un nom pour la clé de stratégie. Par exemple : ContosoSecret. Le préfixe B2C_1A_ est ajouté automatiquement au nom de votre clé.
Dans Secret, entrez la clé secrète client que vous avez enregistrée.
Pour Utilisation de la clé, sélectionnez Signature.
Cliquez sur Créer.

Dans l’élément XML CryptographicKeys, ajoutez l’élément suivant :

<CryptographicKeys>
  <Key Id="client_secret" StorageReferenceId="B2C_1A_ContosoSecret"/>
</CryptographicKeys>

Étendue

L’étendue définit les informations et les autorisations que vous souhaitez collecter à partir de votre fournisseur d’identité, par exemple openid profile. Pour recevoir le jeton d’ID du fournisseur d’identité, l’étendue openid doit être spécifiée.

Sans jeton d’ID, les utilisateurs ne peuvent pas se connecter à Azure AD B2C à l’aide du fournisseur d’identité personnalisé. D’autres étendues peuvent être ajoutées, séparées par un espace. Reportez-vous à la documentation du fournisseur d’identité personnalisé pour afficher les autres étendues pouvant être disponibles.

Dans Scope (Étendue), entrez les étendues du fournisseur d’identité. Par exemple : openid profile.

Dans les métadonnées du profil technique <Item Key="scope">, entrez les étendues du fournisseur d’identité. Par exemple : openid profile.

Type de réponse

Le type de réponse décrit le type d’informations renvoyé dans l’appel initial au authorization_endpoint du fournisseur d’identité personnalisé. Les types de réponse suivants peuvent être utilisés :

code : conformément au flux de code d’autorisation, un code est renvoyé vers Azure AD B2C. Azure AD B2C appelle ensuite le token_endpoint pour échanger le code pour le jeton.
id_token : un jeton d’ID est renvoyé à Azure AD B2C par le fournisseur d’identité personnalisé.

Dans Type de réponse, sélectionnez code ou id_token, en fonction de vos paramètres de fournisseur d’identité.

Dans les métadonnées du profil technique <Item Key="response_types">, sélectionnez code ou id_token, en fonction de vos paramètres de fournisseur d’identité.

Mode de réponse

Le mode de réponse définit la méthode qui doit être utilisée pour renvoyer les données du fournisseur d’identité personnalisé vers Azure Active Directory B2C. Les modes de réponse suivants peuvent être utilisés :

Le mode de réponse form_post est recommandé pour une sécurité optimale. La réponse est transmise via la méthode HTTP POST, avec le code ou le jeton encodé dans le corps au format application/x-www-form-urlencoded.
query : le code ou le jeton est retourné en tant que paramètre de requête.

Dans Mode de réponse, sélectionnez form_post ou query, en fonction de vos paramètres de fournisseur d’identité.

Dans les métadonnées du profil technique <Item Key="response_mode">, sélectionnez form_post ou query, en fonction de vos paramètres de fournisseur d’identité.

Indication du domaine

L’indication du domaine peut être utilisée pour passer directement à la page de connexion du fournisseur d’identité spécifié. Cela évite à l’utilisateur de sélectionner une option dans la liste des fournisseurs d’identité disponibles.

Pour autoriser ce type de comportement, entrez une valeur pour l’indication du domaine. Pour passer au fournisseur d’identité personnalisé, ajoutez le paramètre domain_hint=<domain hint value> à la fin de votre demande lors de l’appel d’Azure AD B2C pour la connexion.

Dans Conseil de domaine, entrez un nom de domaine utilisé dans le conseil de domaine.

Dans l’élément XML du profil technique <Domain>contoso.com</Domain>, entrez un nom de domaine utilisé dans le conseil de domaine. Par exemple : contoso.com.

Mappage des revendications

Une fois que le fournisseur d’identité personnalisé a renvoyé un jeton d’ID à Azure AD B2C, Azure AD B2C doit être en mesure de mapper les revendications du jeton reçu aux revendications qu’Azure AD B2C reconnaît et utilise. Pour chacun des mappages suivants, reportez-vous à la documentation du fournisseur d’identité personnalisé pour comprendre les revendications qui sont renvoyées dans les jetons du fournisseur d’identité :

ID utilisateur : entrez la revendication qui fournit l'identificateur unique de l'utilisateur connecté.
Nom d'affichage : entrez la revendication qui fournit le nom d'affichage ou le nom complet de l'utilisateur.
Prénom : entrez la revendication qui fournit le prénom de l'utilisateur.
Patronyme : entrez la revendication qui fournit le nom de l'utilisateur.
Adresse e-mail : entrez la revendication qui fournit l'adresse e-mail de l'utilisateur.

L’élément OutputClaims contient une liste de revendications que votre fournisseur d’identité retourne. Mappez le nom de la revendication définie dans votre stratégie au nom défini dans le fournisseur d’identité. Sous l’élément <OutputClaims>, configurez l’attribut PartnerClaimType avec le nom de revendication correspondant défini par votre fournisseur d’identité.

ClaimTypeReferenceId	PartnerClaimType
`issuerUserId`	Entrez la revendication qui fournit l’identificateur unique pour l’utilisateur connecté.
`displayName`	Entrez la revendication qui fournit le nom d’affichage ou le nom complet de l’utilisateur.
`givenName`	Entrez la revendication qui fournit le prénom de l’utilisateur.
`surName`	Entrez la revendication qui fournit le nom de l’utilisateur.
`email`	Entrez la revendication qui fournit l’adresse e-mail de l’utilisateur.
`identityProvider`	Entrez la revendication qui fournit le nom de l’émetteur de jeton. Par exemple : `iss`. Si le fournisseur d’identité n’inclut pas la revendication de l’émetteur dans le jeton, définissez l'attribut `DefaultValue` avec un identificateur unique de votre fournisseur d’identité. Par exemple : `DefaultValue="contoso.com"`.

Ajouter le fournisseur d'identité à un flux d'utilisateur

Dans votre locataire Azure AD B2C, sélectionnez Flux d’utilisateur.
Cliquez sur le flux d'utilisateur auquel vous souhaitez ajouter le fournisseur d'identité.
Sous Fournisseurs d'identité sociale, sélectionnez le fournisseur d'identité que vous avez ajouté. Par exemple, Contoso.
Sélectionnez Enregistrer.

Tester votre flux d’utilisateur

Pour tester votre stratégie, sélectionnez Exécuter le flux d’utilisateur.
Pour Application, sélectionnez l’application web testapp1 que vous avez précédemment inscrite. L’URL de réponse doit être https://jwt.ms.
Sélectionnez le bouton Exécuter le flux d'utilisateur.
Sur la page d'inscription ou de connexion, sélectionnez le fournisseur d'identité auquel vous souhaitez vous connecter. Par exemple, Contoso.

Si le processus de connexion réussit, votre navigateur est redirigé vers https://jwt.ms, qui affiche le contenu du jeton retourné par Azure AD B2C.

Ajouter un parcours utilisateur

À ce stade, le fournisseur d’identité a été configuré, mais il n’est encore disponible dans aucune des pages de connexion. Si vous n’avez pas votre propre parcours utilisateur personnalisé, créez un doublon d’un modèle de parcours utilisateur existant ; sinon, passez à l’étape suivante.

Ouvrez le fichier TrustFrameworkBase.xml à partir du pack de démarrage.
Recherchez et copiez l’intégralité du contenu de l’élément UserJourney comprenant Id="SignUpOrSignIn".
Ouvrez le fichier TrustFrameworkExtensions.xml, puis recherchez l’élément UserJourneys. Si l’élément n’existe pas, ajoutez-en un.
Collez l’intégralité du contenu de l’élément UserJourney que vous avez copié en tant qu’enfant de l’élément UserJourneys.
Renommez l’ID du parcours utilisateur. Par exemple : Id="CustomSignUpSignIn".

Ajoutez le fournisseur d’identité à un parcours utilisateur

Maintenant que vous disposez d’un parcours utilisateur, ajoutez-y le nouveau fournisseur d’identité. Vous ajoutez d’abord un bouton de connexion, puis vous liez le bouton à une action. L’action représente le profil technique que vous avez créé plus haut.

Recherchez l’élément d’étape d’orchestration comprenant Type="CombinedSignInAndSignUp" ou Type="ClaimsProviderSelection" dans le parcours utilisateur. Il s’agit généralement de la première étape d’orchestration. L’élément ClaimsProviderSelections contient une liste de fournisseurs d’identité auxquels un utilisateur peut se connecter. L’ordre des éléments détermine l’ordre des boutons de connexion présentés à l’utilisateur. Ajoutez un élément XML ClaimsProviderSelection. Définissez la valeur TargetClaimsExchangeId sur un nom convivial.
À la prochaine étape d’orchestration, ajoutez un élément ClaimsExchange. Définissez ID sur la valeur de l’ID d’échange des revendications cible. Mettez à jour la valeur de TechnicalProfileReferenceId sur l’ID du profil technique que vous avez créé précédemment.

Le code XML suivant montre les deux premières étapes d’orchestration d’un parcours utilisateur avec le fournisseur d’identité :

<OrchestrationStep Order="1" Type="CombinedSignInAndSignUp" ContentDefinitionReferenceId="api.signuporsignin">
  <ClaimsProviderSelections>
    ...
    <ClaimsProviderSelection TargetClaimsExchangeId="ContosoExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="ContosoExchange" TechnicalProfileReferenceId="Contoso-OpenIdConnect" />
  </ClaimsExchanges>
</OrchestrationStep>

Configurer la stratégie de partie de confiance

La stratégie de partie de confiance, par exemple SignUpSignIn.xml, spécifie le parcours utilisateur à partir duquel Azure AD B2C s’exécutera. Recherchez l’élément DefaultUserJourney dans la partie de confiance. Mettez à jour la valeur ReferenceId afin qu’elle corresponde à l’ID du parcours utilisateur auquel vous avez ajouté le fournisseur d'identité.

Dans l’exemple suivant, pour le parcours utilisateur CustomSignUpSignIn, la valeur ReferenceId est définie sur CustomSignUpSignIn :

<RelyingParty>
  <DefaultUserJourney ReferenceId="CustomSignUpSignIn" />
  ...
</RelyingParty>

Téléchargez la stratégie personnalisée

Connectez-vous au portail Azure.
Sélectionnez l’icône Annuaire et abonnement dans la barre d’outils du portail, puis sélectionnez l’annuaire qui contient votre locataire Azure AD B2C.
Dans la Portail Azure, recherchez et sélectionnez Azure AD B2C.
Sous Stratégies, sélectionnez Identity Experience Framework.
Sélectionnez Charger une stratégie personnalisée, puis chargez les deux fichiers de stratégie que vous avez modifiés, dans l’ordre suivant : la stratégie d’extension, par exemple TrustFrameworkExtensions.xml, puis la stratégie de la partie de confiance, par exemple SignUpSignIn.xml.

Sélectionnez votre stratégie de partie de confiance, par exemple B2C_1A_signup_signin.
Pour Application, sélectionnez une application web que vous avez précédemment inscrite. L’URL de réponse doit être https://jwt.ms.
Sélectionnez le bouton Exécuter maintenant.
Dans la page d’inscription ou de connexion, sélectionnez Contoso pour vous connecter avec un compte Google.

Si le processus de connexion réussit, votre navigateur est redirigé vers https://jwt.ms, qui affiche le contenu du jeton retourné par Azure AD B2C.

Problèmes connus

Azure AD B2C ne prend pas en charge JWE (JSON Web Encryption) pour l’échange de jetons chiffrés avec des fournisseurs d’identité openID connect.

Étapes suivantes

Pour plus d’informations, consultez le guide de référence Profil technique OpenId Connect.

Prérequis

Ajouter le fournisseur d’identité

Configurer le fournisseur d’identité

ID et secret client

Création d’une clé de stratégie

Étendue

Type de réponse

Mode de réponse

Indication du domaine

Mappage des revendications

Ajouter le fournisseur d'identité à un flux d'utilisateur

Tester votre flux d’utilisateur

Ajouter un parcours utilisateur

Ajoutez le fournisseur d’identité à un parcours utilisateur

Configurer la stratégie de partie de confiance

Téléchargez la stratégie personnalisée

Problèmes connus

Étapes suivantes

Ressources supplémentaires

Ressources supplémentaires

Configurer l’inscription et la connexion avec OpenID Connect générique à l’aide d’Azure Active Directory B2C

Prérequis

Ajouter le fournisseur d’identité

Configurer le fournisseur d’identité

ID et secret client

Création d’une clé de stratégie

Étendue

Type de réponse

Mode de réponse

Indication du domaine

Mappage des revendications

Ajouter le fournisseur d'identité à un flux d'utilisateur

Tester votre flux d’utilisateur

Ajouter un parcours utilisateur

Ajoutez le fournisseur d’identité à un parcours utilisateur

Configurer la stratégie de partie de confiance

Téléchargez la stratégie personnalisée

Problèmes connus

Étapes suivantes

Ressources supplémentaires

Ressources supplémentaires