Table des matières

Blazor SAML SSO avec Azure AD comme IDP

Authentification unique Blazor SAML (SSO) L'application donne la possibilité d'activer l'authentification unique SAML pour vos applications Blazor. Grâce à l'authentification unique, vous ne pouvez utiliser qu'un seul mot de passe pour accéder à votre application et à vos services Blazor. Notre application est compatible avec tous les fournisseurs d'identité conformes à SAML. Ici, nous allons passer en revue un guide étape par étape pour configurer l'authentification unique (SSO) entre Blazor et Microsoft Entra ID (anciennement Azure AD) en considérant Azure AD comme IdP. Pour en savoir plus sur les fonctionnalités que nous proposons pour Blazor SSO, cliquez sur ici.

Prise en charge de la plateforme: L'application Blazor SAML prend en charge ASP.NET Core 2.0 et supérieur. Il prend en charge toutes les plates-formes Blazor, notamment Windows, Linux et macOS.

Étapes pour configurer Blazor Single Sign-On (SSO) à l'aide d'Azure AD comme IDP

Étape 1 : Prérequis : téléchargement et installation

Installez le middleware Blazor SAML SSO dans votre package d'application à l'aide du package nuget

Package NuGet
CLI .NET

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

      
          
          
    
    using miniorange.saml
    public class Startup
    {
      public void ConfigureServices(IServiceCollection services)
      {
   
       services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme).AddCookie();
       services.AddControllersWithViews();
      }
      public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
      {
        app.UseHttpsRedirection();
        app.UseRouting();
        app.UseAuthorization();
        app.MapRazorPages();
    
        app.UseCookiePolicy();
        app.UseAuthentication();
        app.UseStaticFiles();
        app.UseminiOrangeSAMLSSOMiddleware();
        app.Run();
      }
    }

      
          
    
    using Microsoft.AspNetCore.Authentication.Cookies;
    using miniOrange.saml;
    
    var builder = WebApplication.CreateBuilder(args);
    
    builder.Services.AddRazorPages();
    // Add authentication services
     builder.Services.AddminiOrangeServices(Assembly.GetExecutingAssembly());
    
    var app = builder.Build();
    
    if (!app.Environment.IsDevelopment())
     {
        app.UseExceptionHandler("/Error");
    
        app.UseHsts();
     }
    
    app.UseHttpsRedirection();
    app.UseRouting();
    app.UseAuthorization();
    app.MapRazorPages();
    
    app.UseCookiePolicy();
    app.UseAuthentication();
    app.UseStaticFiles();
    app.UseminiOrangeSAMLSSOMiddleware();
    app.Run();
    app.useantiforgery();

Après l'intégration, ouvrez votre navigateur et parcourez le tableau de bord du connecteur avec l'URL ci-dessous :
https://<blazor-application-base-url>/?ssoaction=config
Si la page d'inscription ou la page de connexion apparaît, vous avez ajouté avec succès le connecteur miniOrange ASP.NET SAML SSO à votre application.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - registre saml dll

Inscrivez-vous ou connectez-vous avec votre compte en cliquant sur le S'enregistrer bouton pour configurer l’application.

2. Configurez Azure AD en tant que 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 Entra ID comme fournisseur d'identité dans la liste affichée.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Sélectionnez Azure AD comme fournisseur d'identité

Il existe deux manières détaillées ci-dessous de configurer les métadonnées SAML SP du côté de votre fournisseur d'identité.

A] Utilisation d'une URL de métadonnées SAML ou d'un 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 configurer la même chose du côté de votre fournisseur d'identité.
Vous pouvez vous référer à la capture d'écran ci-dessous :

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Copier les métadonnées téléchargées

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 :

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Métadonnées manuelles

Configuration d'Azure AD via les applications d'entreprise
Configuration d'Azure AD via les inscriptions d'applications

Se connecter à Portail Azure AD
Sélectionner Azure Active Directory.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Inscriptions d'entreprise

Sélectionner Enterprise Application.

Cliquez sur Nouvelle application.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Nouvelle application

Cliquez sur Créez votre propre application.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Ajouter une application hors galerie

Saisissez le nom de votre application, puis sélectionnez Application hors galerie section et cliquez sur Créer .

Cliquez sur Configuration de l'authentification unique .

Sélectionnez le SAML languette.

Après avoir cliqué sur Modifier, entrer le ID d'entité SP pour Identifiant et la URL ACS pour URL de réponse à partir de Métadonnées du fournisseur de services onglet du plugin.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Sélectionnez l'authentification SAML SSO

Par défaut, les éléments suivants Attributs sera envoyé dans la réponse SAML. Vous pouvez afficher ou modifier les revendications envoyées dans la réponse SAML à l'application sous l'onglet Attributs languette.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Configurer SAML 2.0

Copiez le URL des métadonnées de la fédération d’applications pour obtenir le Endpoints requis pour configurer votre Prestataire de services.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Configuration de SAML 2.0

Attribuez des utilisateurs et des groupes à votre application SAML

Accédez à Utilisateurs et groupes onglet et cliquez sur Ajouter un utilisateur/groupe.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - attribuer des groupes et des utilisateurs

Cliquez sur Utilisateurs pour attribuer l'utilisateur souhaité, puis cliquez sur Sélectionner.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - ajouter des utilisateurs

Vous pouvez également attribuer un rôle à votre candidature sous Sélectionnez un rôle .

Vous avez configuré avec succès Microsoft Entra ID (anciennement Azure AD) en tant que SAML IDP (Identity Provider) pour réaliser l'authentification unique Blazor (SSO).

Se connecter à Portail Azure AD en tant qu'administrateur
Sélectionner Azure Active Directory.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Nouvelles inscriptions

Sélectionner Inscriptions d'applications.

Cliquez sur Nouvelle inscription.

Attribuer un Nom et choisissez le « Pixel Type de compte.
Dans le champ URL de redirection, indiquez l'URL ACS fournie dans Métadonnées du fournisseur de services onglet du plugin et cliquez sur S'enregistrer .

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Enregistrement de l'application

Accédez à Exposer une API à partir du panneau de menu de gauche.
Cliquez sur complet » bouton et remplacez le URL de l'identifiant de la demande avec l'ID d'entité SP du plugin.

NOTE: Veuillez vous assurer que la valeur de l'ID d'entité SP de l'onglet Métadonnées du fournisseur de services ne comporte pas de barre oblique finale ('/'). Si l'ID d'entité SP a une barre oblique finale, mettez-le à jour en supprimant la barre oblique finale du champ SP EntityID / Issuer sous l'onglet Métadonnées du fournisseur de services du plugin, entrez la valeur mise à jour dans Azure et cliquez sur le bouton Enregistrer.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Exposer une API)

Retour à Azure Active Directory ⇒ Inscriptions d'applications fenêtre et cliquez sur Endpoints.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - points de terminaison

Cela mènera à une fenêtre avec plusieurs URL.
Copiez le Document de métadonnées de la fédération URL pour obtenir le Endpoints requis pour configurer votre Prestataire de services.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - métadonnées de fédération

Vous avez configuré avec succès Microsoft Entra ID (anciennement Azure AD) en tant qu'IdP SAML (fournisseur d'identité) pour réaliser une connexion Azure AD SSO dans votre application Blazor.

3. Configurez l'application Blazor SAML en tant que fournisseur de services

Il existe deux manières détaillées ci-dessous de configurer les métadonnées de votre fournisseur d'identité SAML dans l'application.

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 l'application à l'aide de l'option Télécharger les métadonnées IDP option.
Vous pouvez vous référer à la capture d'écran ci-dessous :

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Télécharger des métadonnées

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.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Configuration dll SAML

4. Test de l'authentification unique SAML

Cliquez sur le Configuration du test pour tester si la configuration SAML que vous avez effectuée est correcte.
La capture d'écran ci-dessous montre un résultat réussi. Cliquer sur Intégration SSO pour poursuivre l'intégration SSO.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Configuration de test SAML dll

Si vous rencontrez une erreur du côté de l'application, une fenêtre similaire à celle ci-dessous s'affichera.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Activer les journaux de débogage

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.

5. 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 plugin gratuit, vous pouvez configurer uniquement NameID
Remarque : Tous les attributs mappés seront stockés dans les revendications afin que vous puissiez y accéder dans votre application..

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - mappage d'attributs

6. Code d'intégration

Ces étapes vous permettent de récupérer les informations utilisateur SSO dans votre application sous la forme de revendications utilisateur.
Vous pouvez également regarder le visite d'installation pour comprendre comment l'intégration SSO fonctionnerait dans votre application Blazor.
Copiez-collez simplement cet extrait de code là où vous souhaitez accéder aux attributs utilisateur.

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - code d'intégration

À noter:Ce middleware d'essai prend uniquement en charge les informations utilisateur dans les réclamations. La récupération des informations utilisateur en session et en-têtes est disponible dans le plugin premium.
Vous pouvez également copier le code d'intégration ci-dessous :

          
      

  string name="";
  string claimtype="";
  string claimvalue="";

   if(User.Identity.IsAuthenticated)
   {
     foreach( var claim  in User.Claims) 
     {
       claimtype = claim.Type;
       claimvalue = claim.Value;
     }
     retrive custom attributes(for eg. Retrieve Mapped 'mobileNumber' attribute of your IDP)
     var identity = (ClaimsIdentity)User.Identity;
     IEnumerable claims = identity.Claims;
     string mobileNumber = identity.FindFirst("mobileNumber")?.Value;
   }

À noter: Tous les attributs mappés seront stockés dans les revendications accessibles dans votre application.
Si vous souhaitez de l'aide concernant le code d'intégration, contactez-nous à aspnetsupport@xecurify.com

7. Paramètres de connexion

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

ASP.NET SAML Single Sign-On (SSO) utilisant Auth0 comme IDP - Codes d'intégration ASP.NET basés sur la langue

Utilisez l'URL suivante comme lien dans l'application à partir de laquelle vous souhaitez effectuer le SSO :
https://blazor-application-base-url/?ssoaction=login
Par exemple, vous pouvez l'utiliser comme :
<a href=”https://blazor-application-base-url/?ssoaction=login”>Log in</a>

8. Paramètres de déconnexion

Utilisez l'URL suivante comme lien vers votre application à partir de laquelle vous souhaitez effectuer un SLO :
https://blazor-application-base-url/?ssoaction=logout
Par exemple, vous pouvez l'utiliser comme :
<a href=”https://blazor-application-base-url/?ssoaction=logout”>Log out</a>

Pour configurer votre IDP, vous pouvez trouver les métadonnées du fournisseur de services dans le fichier appsetting.json. Pour les métadonnées SP, vous pouvez vous référer à la capture d'écran ci-dessous :

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Métadonnées SP

Dès miniOrange section, copiez dépenséityid, acsurl et fournissez-le à l'équipe de votre fournisseur d'identité.

Une fois les métadonnées du fournisseur de services configurées du côté de l'IdP, vous recevrez le fichier de métadonnées de l'IdP ou l'URL de métadonnées ou des URL de métadonnées telles que l'ID d'entité IdP, l'URL SSO de l'IdP, etc.
Pour configurer vos métadonnées IDP, accédez à appsettings.json déposer. Vous trouverez les paramètres suivants dans la section JSON du miniorange
Pour configurer directement votre IDP, accédez à appsettings.json fichier.

Blazor SAML Single Sign-On (SSO) utilisant Azure AD (Microsoft Entra ID) comme IDP - Métadonnées IDP

Configurez les métadonnées fournies appropriées et enregistrez les paramètres.

idp_cert	Entrez le certificat IDP dans ce champ
sourl	Saisissez l'URL SSO dans ce champ
idp_issuer	Entrez l'émetteur IDP dans ce champ

Cartographie d'attributs

Mappez les attributs de votre application avec les attributs du fournisseur d'identité (IDP).
À noter: Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.

Code d'intégration

Copiez-collez simplement l'extrait de code là où vous souhaitez accéder aux attributs utilisateur.
À noter: Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.

string name="";

        string claimtype="";

        string claimvalue="";

        if(User.Identity.IsAuthenticated) { 

          name= User.Identity.Name;

          foreach( var claim in User.Claims) {
        
    claimtype = claim.Type;
        
    claimValue = claim.Value;
        
  }
}

Vous pouvez configurer l'application Blazor SAML 2.0 Single Sign-On (SSO) avec n'importe quel fournisseur d'identité tel que ADFS, Microsoft Entra ID (anciennement Azure AD), Bitium, Centrify, G Suite, JBoss Keycloak, Okta, OneLogin, Salesforce, AWS Cognito, OpenAM, Oracle, PingFederate, PingOne, RSA SecureID, Shibboleth-2, Shibboleth-3, SimpleSAML , WSO2 ou même avec votre propre fournisseur d'identité personnalisé. Consultez la liste des fournisseurs d'identité ici.

Ressources supplémentaires

Besoin d'aide?

Vous ne parvenez pas à trouver votre fournisseur d'identité ? Envoyez-nous un mail à aspnetsupport@xecurify.com et nous vous aiderons à configurer le SSO avec votre IDP et pour des conseils rapides (par e-mail/réunion) sur vos besoins et notre équipe vous aidera à sélectionner la solution/le plan le mieux adapté à vos besoins.