Inställningsguider för Blazor SAML Single Sign-On (SSO).

Steg 1: Förutsättningar: Ladda ner och installation

• Installera Blazor SAML SSO Middleware i ditt applikationspaket med hjälp av nuget-paketet

    

        
        
  
  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();
  
  
  

• Efter integrationen öppnar du din webbläsare och bläddrar i instrumentpanelen för mellanprogram med webbadressen nedan:
  https://<blazor-application-base-url>/?ssoaction=config
• Om registreringssidan eller inloggningssidan dyker upp har du framgångsrikt lagt till miniOrange Blazor SAML SSO-mellanvaran till din applikation.

• Registrera dig eller logga in med ditt konto genom att klicka på Registrera för att konfigurera mellanvaran.

Steg 2: Konfigurera din identitetsleverantör

• Du måste skicka din SP-metadata till din identitetsleverantör. För SP-metadata, använd SP-metadata-URL eller ladda ner SP-metadata som en .xml-fil och ladda upp den på din IdP-sida. Du hittar båda dessa alternativ under Inställningar för tjänsteleverantör fliken.

• Alternativt kan du manuellt lägga till SP Entity ID och ACS URL från Inställningar för tjänsteleverantör fliken i plugin-programmet till dina IdP-konfigurationer.

Steg 3: Konfigurera Blazor som tjänsteleverantör (SSO Middleware)

Obs: Efter installationen av plugin-programmet måste vi ställa in förtroendet mellan din Blazor-applikation och din identitetsleverantör. SAML-metadata delas med identitetsleverantören så att de kan uppdatera sin inbyggda konfiguration för att stödja enkel inloggning.

3.1: Dela SAML-metadata med identitetsleverantör

• Klicka på Lägg till ny IDP för att konfigurera Blazor Single Sign-On (SSO) med din identitetsleverantör.

• Enligt Inställningar för tjänsteleverantör fliken kan du antingen kopiera och klistra in metadata-URL på din IDP-sida eller ladda ner SP-metadata som en XML-fil. Dessutom kan du välja att manuellt kopiera och klistra in Grundadress, SP Entity IDoch ACS URL.
• Dela SAML-metadata med din identitetsleverantör.

3.2: Importera SAML-metadata från identitetsleverantören

• Välj din identitetsleverantör från listan som visas.

Det finns två sätt som beskrivs nedan med vilka du kan konfigurera din SAML-identitetsleverantörs metadata i mellanvaran.

A] Ladda upp metadata med knappen Ladda upp IDP-metadata:

• Om din identitetsleverantör har försett dig med metadata-URL eller metadatafil (endast .xml-format) kan du helt enkelt konfigurera identitetsleverantörens metadata i mellanvaran med hjälp av Ladda upp IDP-metadata alternativ.
• Du kan hänvisa till skärmdumpen nedan:

• Du kan välja vilket som helst av alternativen enligt det metadataformat du har tillgängligt.

B] Konfigurera identitetsleverantörens metadata manuellt:

• Efter att ha konfigurerat din Identitetsleverantör, kommer det att ge dig IDP Entity ID, IDP Single Sign On URL och SAML X509-certifikat fält respektive.
• Klicka Spara för att spara dina IDP-uppgifter.

Steg 4: Testa SAML SSO

• Innan du testar, kontrollera följande:
• Blazor (SP) SAML-metadata har exporterats till identitetsleverantören (IDP).
• Identity Provider (IDP) SAML-metadata importeras till Blazor (SP) SSO-instrumentpanelen.
• För att testa om SAML-konfigurationen du har gjort är korrekt, håll muspekaren på Välj Åtgärder och klicka på Testkonfiguration.

• Obs: I testversionen av pluginet kan du bara konfigurera och testa en identitetsleverantör (IDP).
• Skärmdumpen nedan visar ett lyckat resultat. Klicka på Färdig för att fortsätta med SSO-integrationen.

• Om du upplever något fel i middleware-änden kommer du att visas med fönstret som liknar nedan.

• För att felsöka felet kan du följa stegen nedan:
• Enligt Felsökning fliken, aktivera växeln för att ta emot pluginloggarna.


• När det är aktiverat kommer du att kunna hämta pluginloggar genom att navigera till Inställningar för identitetsleverantör fliken och klicka på Testkonfiguration.
• ladda ner loggfil från felsöka fliken för att se vad som gick fel.
• Du kan dela loggfil med oss ​​kl aspnetsupport@xecurify.com och vårt team kommer att kontakta dig för att lösa ditt problem.

Steg 5: Integrationskod

• Dessa steg låter dig hämta SSO-användarinformationen i din ansökan i form av användaranspråk.
• Du kan också titta på installationstur för att förstå hur SSO-integrationen skulle fungera i din Blazor-applikation.
• Bara kopiera och klistra in det kodavsnittet där du vill komma åt användarattributen.

• Obs:Denna provmellanvara stöder endast användarinformation i anspråk, hämtning av användarinformation i session och rubriker är tillgänglig i premiumplugin
• Du kan också kopiera integrationskoden nedan:

        

            
      
    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;
    }
    
    
    

• Obs: Alla mappade attribut kommer att lagras i anspråken som ska nås i din applikation.
• Om du vill ha hjälp med integrationskoden, kontakta oss på aspnetsupport@xecurify.com

Steg 6: Lägg till följande länk i din ansökan om enkel inloggning (SSO)

• Hök på Välj Åtgärder och klicka på Kopiera SSO-länk.

• Använd den kopierade länken i applikationen där du vill utföra SSO:
  https://base-url/?ssoaction=login&appid=[Your-Application-ID]
• Du kan till exempel använda det som:
  <a href=”https://base-url/?ssoaction=login”>Log in</a>