×

Pour les applications basées sur .NET Framework, cliquez sur ici pour obtenir des instructions détaillées étape par étape.

Choisissez votre fournisseur d'identité SAML pour configurer l'authentification unique (SSO)

Vous ne parvenez pas à trouver votre IdP ? Contactez-nous à aspnetsupport@xecurify.com et nous vous aiderons à configurer ASP.NET Core SSO avec votre IdP en un rien de temps.

Vous n'avez pas trouvé votre IdP ?

Contactez-nous à aspnetsupport@xecurify.com et nous vous aiderons à configurer ASP.NET Core SSO avec votre fournisseur d'identité (IdP) en un rien de temps.

Azure

Guide d'installation

Guide de la vidéo

ADFS

Guide d'installation

Auth0

Guide d'installation

Guide de la vidéo

Ping fédéré

Guide d'installation

Guide de la vidéo

Okta

Guide d'installation

Guide de la vidéo

Google Apps

Guide d'installation

miniOrange

Guide d'installation

Office365

Guide d'installation

Salesforce

Guide d'installation

WordPress

Guide d'installation

OneLogin

Guide d'installation

Lien de classe

Guide d'installation

Schibboleth

Guide d'installation

Azur B2C

Guide d'installation

Shopify

Guide d'installation

Étapes de configuration du middleware ASP.NET SAML 2.0 Core

Pré-requis : téléchargement et installation

.NET5 et supérieur
NETCore2.1 et .NETCore3.1
. NET Framework

Package NuGet
CLI .NET

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

À noter: Pour intégrer le middleware miniOrange ASP.NET SAML SSO dans votre application, vous devrez ajouter les espaces de noms, services et middleware ci-dessous dans votre projet (marqués en vert). Ci-dessous, voici un exemple.

    
        
        
  
     using miniOrange.saml;
     using System.Reflection;

     public class Startup
     {
       public Startup(IConfiguration configuration)
       {
         Configuration = configuration;
       }
       public IConfiguration Configuration {get;}
       // This method gets called by the runtime. Use this method to add services to the container.
       public void ConfigureServices(IServiceCollection services)
       {
         services.AddRazorPages();
         services.AddminiOrangeServices(Assembly.GetExecutingAssembly());
      }

     // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
       public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
       {
        if (env.IsDevelopment())
        {
         app.UseDeveloperExceptionPage();
        }
        else
        {
         app.UseExceptionHandler("/Error");
      // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
         app.UseHsts();
        }

      app.UseHttpsRedirection();

      app.UseCookiePolicy();
      app.UseAuthentication();
    
      #if NET9_0_OR_GREATER
      app.MapStaticAssets();
      #else
      app.UseStaticFiles();
      #endif

      app.UseminiOrangeSAMLSSOMiddleware();

      app.UseRouting();
      app.UseAuthorization();
      app.UseEndpoints(endpoints =>
      {
        endpoints.MapRazorPages();
      });
     }
   }

    
        
  
    using miniOrange.saml;
    using System.Reflection;

    var builder=WebApplication.CreateBuilder(args);
    

    // Add services to the container.
    builder.Services.AddRazorPages();
    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();

    #if NET9_0_OR_GREATER
    app.MapStaticAssets();
    #else
    app.UseStaticFiles();
    #endif

    app.UseminiOrangeSAMLSSOMiddleware();

    app.Run();

1. Ajouter un middleware sur l'application ASP.NET Core

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

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - registre saml dll

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

2. Configurez votre 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 votre fournisseur d'identité dans la liste affichée.

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - Sélectionner le 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 :

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - 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 :

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO – Métadonnées manuelles

3. Configurer le middleware SAML ASP.NET Core 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 le middleware.

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 middleware à 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 :

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - 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.

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - Configuration de la 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.

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - Configuration des tests dll SAML

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

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - 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).
À noter: Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - 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

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

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - 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.

Authentification unique (SSO) SAML ASP.NET Core | Authentification ASP.NET Core | ASP.NET Core SAML SSO - 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 le Authentification unique (SSO) ASP.NET Core SAML middleware avec n’importe quel fournisseur d’identité tel que ADFS, 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.

Guides de configuration de l’authentification unique ASP.NET Core SAML

Choisissez votre fournisseur d'identité SAML pour configurer l'authentification unique (SSO)

Vous n'avez pas trouvé votre IdP ?

Étapes de configuration du middleware ASP.NET SAML 2.0 Core

Pré-requis : téléchargement et installation

1. Ajouter un middleware sur l'application ASP.NET Core

2. Configurez votre fournisseur d'identité

A] Utilisation d'une URL de métadonnées SAML ou d'un fichier de métadonnées :

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

3. Configurer le middleware SAML ASP.NET Core en tant que fournisseur de services

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

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

4. Test de l'authentification unique SAML

5. Cartographie des attributs

6. Code d'intégration

7. Paramètres de connexion

8. Paramètres de déconnexion

Cartographie d'attributs

Code d'intégration

Ressources supplémentaires

Besoin d'aide?