Guides de configuration de l'authentification unique (SSO) Blazor SAML

É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

    

        
        
  
  using miniorange.saml
  public class Startup
  {
    public void ConfigureServices(IServiceCollection services)
    {
 
      services.AddSession();
     services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme).AddCookie();
     services.AddControllersWithViews();
    }
    public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
    {
      app.UseHttpsRedirection();
      app.UseStaticFiles();
      app.UseRouting();
      app.UseAuthorization();
      app.MapRazorPages();
  
      app.UseCookiePolicy();
      app.UseAuthentication();
  
      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 middleware 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 middleware miniOrange Blazor SAML SSO à votre application.

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

Étape 2 : Configurez votre fournisseur d'identité

• Vous devez envoyer vos métadonnées SP à votre fournisseur d'identité. Pour les métadonnées SP, utilisez l’URL des métadonnées SP ou téléchargez les métadonnées SP sous forme de fichier .xml et téléchargez-les du côté de votre IdP. Vous pouvez trouver ces deux options sous la rubrique Paramètres du fournisseur de services languette.

• Vous pouvez également ajouter manuellement l'ID d'entité SP et l'URL ACS à partir de Paramètres du fournisseur de services dans le plugin pour vos configurations IdP.

Étape 3 : configurer Blazor en tant que fournisseur de services (middleware SSO)

À noter: Après l'installation du plugin, nous devons configurer la confiance entre votre application Blazor et votre fournisseur d'identité. Les métadonnées SAML sont partagées avec le fournisseur d'identité afin qu'il puisse mettre à jour sa configuration intégrée pour prendre en charge l'authentification unique.

3.1 : Partager les métadonnées SAML avec le fournisseur d'identité

• Cliquez sur Ajouter un nouveau fournisseur d'identité pour configurer Blazor Single Sign-On (SSO) à l’aide de votre fournisseur d’identité.

• Sous Paramètres du fournisseur de services onglet, vous pouvez soit copier-coller le URL des métadonnées de votre côté IDP ou télécharger les métadonnées SP sous forme de fichier XML. De plus, vous avez la possibilité de copier et coller manuellement URL de base, ID d'entité SP et URL ACS.
• Partagez les métadonnées SAML avec votre fournisseur d'identité.

3.2 : Importer les métadonnées SAML du fournisseur d'identité

• Sélectionnez votre fournisseur d'identité dans la liste affichée.

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 :

• 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.

Étape 4 : tester l'authentification unique SAML

• Avant de tester, veuillez vous assurer de ce qui suit :
• Les métadonnées SAML Blazor (SP) ont été exportées vers le fournisseur d'identité (IDP).
• Les métadonnées SAML du fournisseur d'identité (IDP) sont importées dans le tableau de bord SSO Blazor (SP).
• Pour tester si la configuration SAML que vous avez effectuée est correcte, passez la souris sur Sélectionner des actions et cliquez sur Configuration du test.

• À noter: Dans la version d'essai du plugin, vous ne pouvez configurer et tester qu'un seul fournisseur d'identité (IDP).
• La capture d'écran ci-dessous montre un résultat réussi. Cliquer sur OK pour poursuivre l'intégration SSO.

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

• Pour résoudre l'erreur, vous pouvez suivre les étapes ci-dessous :
• Sous Dépannage , 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 du fournisseur d'identité 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.

Étape 5 : 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.

• À 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

Étape 6 : Ajoutez le lien suivant dans votre demande d'authentification unique (SSO)

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

• Utilisez le lien copié dans l'application à partir de laquelle vous souhaitez effectuer le SSO :
  https://base-url/?ssoaction=login&appid=[Your-Application-ID]
• Par exemple, vous pouvez l'utiliser comme :
  <a href=”https://base-url/?ssoaction=login”>Log in</a>