Guide de configuration de l'authentification unique SAML ASP.NET Framework avec Azure B2C comme fournisseur d'identité

Marché

Module d'authentification unique (SSO) ASP.NET SAML donne la possibilité d'activer Authentification unique SAML pour vos applications ASP.NET. En utilisant Authentification unique vous ne pouvez utiliser qu'un seul mot de passe pour accéder à votre Application ASP.NET et services. Notre module est compatible avec tous les Fournisseurs d'identité compatibles SAML. Ici, nous allons parcourir un guide étape par étape pour configurer Single Sign-On (SSO) entre ASP.NET et Azur B2C considérant Azur B2C en tant qu'IdP.

Télécharger Plans de tarification

Pré-requis : Téléchargement Et Installation

• Pour installer le Paquet NuGet miniOrange SAML SSO dans votre application .NET, installez simplement le package miniOrange NuGet sur votre application.

Package NuGet

CLI .NET

PM> NuGet\Install-Package miniOrange.SAML.SSO

> dotnet ajoute le package miniOrange.SAML.SSO

• Après l'installation, ouvrez votre navigateur et parcourez le tableau de bord du module avec l'URL ci-dessous :

 http(s)<your-dotnet-application-base-url>?ssoaction=config


• Si la page d'inscription ou la page de connexion s'affiche, vous avez ajouté avec succès le module miniOrange SAML SSO dans votre application.

• Inscrivez-vous ou connectez-vous avec votre compte en cliquant sur le S'enregistrer bouton pour configurer le module.

• Après une inscription réussie, vous recevrez une clé de licence d'essai sur votre adresse e-mail enregistrée.

• Pour activer le module, vous pouvez soit :
• Entrer le clé de licence reçu par e-mail dans le champ de saisie prévu.

OR

• Téléchargez le fichier de licence que vous avez téléchargé en cliquant sur le Cliquez ici .

• Ensuite, cochez la case « J'ai lu les conditions ci-dessus et je souhaite activer le module », et cliquez sur le bouton Activer la licence .

Étapes de configuration

1. Fournir les métadonnées de l'application .NET au fournisseur d'identité Azure B2C

Il existe deux méthodes détaillées ci-dessous avec lesquelles vous pouvez obtenir les métadonnées SAML SP à configurer sur votre fournisseur d'identité.

A] Utilisation de l'URL de métadonnées SAML ou du fichier de métadonnées

• Dans l' Menu Paramètres du plugin, chercher Paramètres du fournisseur de services. En dessous, vous pouvez trouver l'URL des métadonnées ainsi que la possibilité de télécharger les métadonnées SAML.

• Copiez l'URL des métadonnées ou téléchargez le fichier de métadonnées pour le configurer du côté de votre fournisseur d'identité.

• Vous pouvez vous référer à la capture d'écran ci-dessous :

B] Téléchargement manuel des métadonnées

• Extrait du Paramètres du fournisseur de services section, vous pouvez copier manuellement les métadonnées du fournisseur de services comme ID d'entité SP, URL ACS, URL de déconnexion unique et partagez-le avec votre fournisseur d'identité pour la configuration.

• Vous pouvez vous référer à la capture d'écran ci-dessous :

Enregistrez l’application Identity Experience Framework

• Connectez-vous à Portail Azure B2C.
• Dans le locataire Azure AD B2C, sélectionnez Inscriptions d'applications, Puis sélectionnez Nouvelle inscription.

• Pour Nom, entrez IdentityExperienceFramework.
• Sous Types de compte pris en charge, sélectionnez Comptes dans ce répertoire organisationnel uniquement.

• Sous URI de redirection, sélectionnez Web, puis entrez « https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com », où your-tenant-name est le nom de domaine de votre locataire Azure AD B2C.

• Sous Permissions, Sélectionnez l' Accorder le consentement de l'administrateur aux autorisations openid et offline_access Case à cocher.
• Cliquez sur S'enregistrer.

• Enregistrez le ID de l'application (client) pour une utilisation ultérieure.

Enregistrez l’application Identity Experience Framework

• Sous Gérer, sélectionnez Exposer une API.
• Sélectionner Ajouter une portée, puis sélectionnez Enregistrer et continuez à accepter l'URI de l'ID d'application par défaut.

• Entrez les valeurs suivantes pour créer une étendue qui permet l’exécution de stratégies personnalisées dans votre locataire Azure AD B2C :
• Nom de la portée: usurpation d'identité d'utilisateur
• Nom à afficher du consentement de l'administrateur: Accès à IdentityExperienceFramework
• Description du consentement de l'administrateur: Autoriser l'application à accéder à IdentityExperienceFramework au nom de l'utilisateur connecté.

• Sélectionner Ajouter une portée.

Enregistrez l'application ProxyIdentityExperienceFramework

• Sélectionner Inscriptions d'applications, Puis sélectionnez Nouvelle inscription.
• Pour Nom, saisissez ProxyIdentityExperienceFramework.
• Sous Types de compte pris en charge, sélectionnez Comptes dans ce répertoire organisationnel uniquement.

• Sous URI de redirection, utilisez le menu déroulant pour sélectionner Client public/natif (mobile et ordinateur).
• Pour URI de redirection, saisissez myapp://auth.
• Sous Permissions, cochez la case Accorder le consentement de l'administrateur aux autorisations openid et offline_access.
• Sélectionner S'enregistrer.

• Enregistrez le ID de l'application (client) pour une utilisation ultérieure.

Précisez ensuite que l'application doit être traitée comme un client public

• Sous Gérer, sélectionnez Authentification.
• Sous paramètres avancés, activer Autoriser les flux de clients publics (sélectionnez Oui).
• Sélectionner Enregistrer.

Maintenant, accordez des autorisations à la portée de l'API que vous avez exposée précédemment lors de l'enregistrement IdentityExperienceFramework.

• Sous Gérer, sélectionnez Autorisations API.
• Sous Autorisations configurées, sélectionnez Ajouter une autorisation.

• Sélectionnez le Mes API onglet, puis sélectionnez Cadre d'expérience d'identité .

• Sous Autorisation, Sélectionnez l' user_usurpation d'identité portée que vous avez définie précédemment.
• Sélectionner Ajouter des autorisations. Comme indiqué, attendez quelques minutes avant de passer à l'étape suivante.

• Sélectionner Accordez le consentement de l'administrateur pour (nom de votre locataire).

• Sélectionnez votre compte d'administrateur actuellement connecté ou connectez-vous avec un compte dans votre locataire Azure AD B2C auquel a été attribué au moins le rôle d'administrateur d'application Cloud.
• Sélectionner Oui.
• Sélectionner Refresh, puis vérifiez que « Accordé pour... » apparaît sous Statut pour les étendues - offline_access, openid et user_impersonation. La propagation des autorisations peut prendre quelques minutes.

Enregistrez l'application ASP.NET

• Sélectionnez Enregistrements d’applications, puis sélectionnez Nouvelle inscription.
• Saisissez un nom pour l'application tel que : WP-app.
• Sous Types de compte pris en charge, sélectionnez Comptes dans n’importe quel annuaire d’organisation ou n’importe quel fournisseur d’identité. Pour authentifier les utilisateurs avec Azure AD B2C.

• Sous URI de redirection, sélectionnez Web, puis entrez l'URL ACS à partir du Paramètres du fournisseur de services onglet du plugin miniOrange ASP.NET SAML.
• Sélectionner S'enregistrer.

• Sous Gérer, cliquer sur Exposer une API.
• Cliquez sur complet » pour l'URI de l'ID d'application, puis cliquez sur Enregistrer, en acceptant la valeur par défaut.

• Une fois enregistré, copiez l'URI de l'ID d'application et accédez au Métadonnées du fournisseur de services onglet du plugin.
• Collez la valeur copiée sous le ID d'entité SP/émetteur champ prévu dans cet onglet.
• Cliquez sur Enregistrer.

Générer des politiques SSO

• Depuis notre portail Azure B2C, accédez à la section Présentation de votre locataire B2C et enregistrez le nom de votre locataire.
  REMARQUE:Si votre domaine B2C est b2ctest.onmicrosoft.com, alors le nom de votre locataire est b2ctest.

• Saisissez votre Nom du locataire Azure B2C ci-dessous, ainsi que l'ID d'application pour les applications IdentityExperienceFramework et ProxyIdentityExperienceFramework telles qu'enregistrées dans les étapes ci-dessus.

• Cliquez sur le Générer des stratégies Azure B2C bouton pour télécharger les politiques SSO.
• Extrayez le fichier zip téléchargé. Il contient les fichiers de stratégie et le certificat (.pfx), dont vous aurez besoin dans les étapes suivantes.

Configurer et télécharger des certificats

• Connectez-vous à la Portail Azure et accédez à votre locataire Azure AD B2C.

• Sous Politiques, sélectionnez Cadre d'expérience d'identité et alors Clés de politique.

• Sélectionner Ajouter, Puis sélectionnez Options > Télécharger.
• Entrez le nom comme SamlIdpCert. Le préfixe B2C_1A_ est automatiquement ajouté au nom de votre clé.

• À l'aide du contrôle de téléchargement de fichiers, téléchargez votre certificat généré au cours des étapes ci-dessus avec les politiques SSO (tenantname-cert.pfx).
• Saisissez le mot de passe du certificat comme nom de locataire et cliquez sur « Créer ». Par exemple, si votre nom de locataire est xyzb2c.onmicrosoft.com, saisissez le mot de passe xyzb2c.
• Vous devriez pouvoir voir une nouvelle clé de stratégie portant le nom B2C_1A_SamlIdpCert.

Créer la clé de signature

• Sur la page de présentation de votre locataire Azure AD B2C, sous Politiques, sélectionnez Cadre d'expérience d'identité.
• Sélectionner Clés de politique puis sélectionnez Ajouter.
• Pour Options, choisissez Générer.
• In Nom, saisissez TokenSigningKeyContainer.
• Pour Type de clé, sélectionnez RSA.
• Pour Utilisation des clés, sélectionnez Signature.

• Sélectionner Créer.

Créer la clé de chiffrement

• Sur la page de présentation de votre locataire Azure AD B2C, sous Politiques, sélectionnez Cadre d'expérience d'identité.
• Sélectionner Clés de politique puis sélectionnez Ajouter.
• Pour Options, choisissez Générer.
• In Nom, saisissez TokenEncryptionKeyContainer.
• Pour Type de clé, sélectionnez RSA.
• Pour Utilisation des clés, sélectionnez Chiffrement.

• Sélectionner Créer.

Téléchargez les politiques

• Sélectionnez le Cadre d'expérience d'identité élément de menu dans votre locataire B2C dans le portail Azure.

• Sélectionner Télécharger une stratégie personnalisée.

• Conformément à l'ordre suivant, téléchargez les fichiers de stratégie téléchargés lors des étapes ci-dessus :
• TrustFrameworkBase.xml
• TrustFrameworkExtensions.xml
• InscriptionOuSignin.xml
• ProfilEdit.xml
• Mot de passeRéinitialiser.xml
• InscriptionOuConnexionSAML.xml

• Au fur et à mesure que vous téléchargez les fichiers, Azure ajoute le préfixe B2C_1A_ à chacun.

Vous avez configuré avec succès Azure B2C en tant que fournisseur d’identité SAML (IDP) pour réaliser l’authentification unique (SSO) ASP.NET.

2. Configurer les métadonnées du fournisseur d'identité AzureB2C dans l'application .NET

• Cliquez sur le Sélectionnez votre IDP bouton pour configurer un nouveau fournisseur d'identité.

• En vertu des Normes sur l’information et les communications, les organismes doivent rendre leurs sites et applications Web accessibles. Ils y parviennent en conformant leurs sites Web au niveau AA des Web Content Accessibility Guidelines (WCAG). Paramètres Plugin , sélectionnez AzureB2C en tant que fournisseur d'identité dans la liste affichée.

Il existe deux manières détaillées ci-dessous avec lesquelles vous pouvez configurer les métadonnées de votre fournisseur d'identité SAML dans le module.

A] Téléchargez les métadonnées à l'aide du bouton Télécharger les métadonnées IDP :

• Si votre fournisseur d'identité vous a fourni l'URL ou le fichier de métadonnées (format .xml uniquement), vous pouvez simplement configurer les métadonnées du fournisseur d'identité dans le module à l'aide du Télécharger les métadonnées IDP option.

• Copiez l'URL des métadonnées ou téléchargez le fichier de métadonnées pour le configurer du côté de votre fournisseur d'identité.

• Vous pouvez vous référer à la capture d'écran ci-dessous :

• Vous pouvez choisir l’une des options en fonction du format de métadonnées dont vous disposez.

B] Configurez manuellement les métadonnées du fournisseur d'identité :

• Après avoir configuré votre Fournisseur d'identité, il vous fournira ID d'entité IDP, URL d'authentification unique IDP et Certificat SAML X509 champs respectivement.

• Cliquez à nouveau Enregistrer pour enregistrer vos informations IDP.

3. Test de l'authentification unique SAML

• Après avoir téléchargé les détails des métadonnées, accédez à la Paramètres du fournisseur d'identité section. Survolez la section Sélectionner des actions liste déroulante et cliquez sur Configuration du test.

• La capture d'écran ci-dessous montre un résultat réussi. Cliquer sur Intégration SSO pour poursuivre l'intégration SSO.

• Si vous rencontrez une erreur au niveau du module, une fenêtre similaire à celle ci-dessous s'affichera.

• Pour résoudre l'erreur, vous pouvez suivre les étapes ci-dessous :

• Sous Résolution des problèmes , activez la bascule pour recevoir les journaux du plugin.

• Une fois activé, vous pourrez récupérer les journaux du plugin en accédant à Paramètres Plugin onglet et en cliquant sur Configuration du test.

• Téléchargez le fichier journal du Résolution des problèmes onglet pour voir ce qui n'a pas fonctionné.

• Vous pouvez partager le fichier journal avec nous à aspnetsupport@xecurify.com et notre équipe vous contactera pour résoudre votre problème.

4. Cartographie des attributs

• Après avoir testé la configuration, mappez les attributs de votre application avec les attributs du fournisseur d'identité (IdP).

• Dans le menu de gauche du module miniOrange ASP.NET SAML SSO, cliquez sur Cartographie des attributs/rôles onglet comme indiqué dans l'image.

• Si vous souhaitez transmettre des attributs supplémentaires de votre IdP, saisissez le nom de l'attribut et la valeur de l'attribut correspondant sous Mappage d'attributs personnalisés.

• À noter: Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.

• Une fois les attributs mappés, cliquez sur Enregistrer le mappage d'attributs appliquer des modifications.

5. Code d'intégration

• Cette étape vous permet de récupérer les informations de l'utilisateur SSO dans votre application sous forme de session.

• Vous pouvez également regarder le visite d'installation pour comprendre comment l'intégration SSO fonctionnerait dans votre application de module asp.net.

• Copiez-collez simplement cet extrait de code où vous souhaitez accéder aux attributs utilisateur.

• À noter: Avec le module d'essai, les informations des utilisateurs authentifiés sont stockées dans des variables de session. Notre extension premium permet de configurer des revendications utilisateur via l'authentification par en-tête, par formulaire, par cookie et par JWT.

6. Paramètres de connexion

• Survolez Sélectionner des actions et cliquez sur Copier le lien SSO.

• Utilisez l’URL suivante comme lien dans l’application à partir de laquelle vous souhaitez effectuer l’authentification unique :

  https://<asp.net-module-base-url>/?ssoaction=login


• Par exemple, vous pouvez l'utiliser comme :

  <a href="https://<asp.net-module-base-url>/?ssoaction=login">Log in</a>


7. Paramètres de déconnexion

• Utilisez l'URL suivante comme lien vers votre application à partir de laquelle vous souhaitez effectuer le SLO :

  https://<asp.net-module-base-url>/?ssoaction=logout


• Par exemple, vous pouvez l'utiliser comme :

  <a href="https://<asp.net-module-base-url>/?ssoaction=logout">Log out</a>


Articles Relatifs

• SSO ASP.NET SAML
• ASP.NET OAuth SSO
• Authentification à deux facteurs ASP.NET (2FA)

Contactez-nous

Veuillez nous contacter à aspnetsupport@xecurify.comNotre équipe vous accompagnera dans la mise en place de l'authentification unique SAML ASP.NET Framework. Elle vous aidera à choisir la solution/l'offre la mieux adaptée à vos besoins.