Guías de configuración de inicio de sesión único (SSO) de Blazor SAML

Paso 1: Requisitos previos: descarga e instalación

• Instale Blazor SAML SSO Middleware en su paquete de aplicación usando el paquete 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();
  
  
  

• Después de la integración, abra su navegador y explore el panel de middleware con la siguiente URL:
  https://<blazor-application-base-url>/?ssoaction=config
• Si aparece la página de registro o la página de inicio de sesión, ha agregado correctamente el middleware miniOrange Blazor SAML SSO a su aplicación.

• Regístrese o inicie sesión con su cuenta haciendo clic en Registrarse para configurar el middleware.

Paso 2: Configura tu proveedor de identidad

• Debe enviar los metadatos de su SP a su proveedor de identidad. Para los metadatos del SP, utilice la URL de metadatos del SP o descargue los metadatos del SP como un archivo .xml y cárguelo en su IdP. Puede encontrar ambas opciones en el Configuración del proveedor de servicios .

• Alternativamente, puede agregar manualmente el ID de entidad SP y la URL ACS desde Configuración del proveedor de servicios pestaña en el complemento de las configuraciones de su IdP.

Paso 3: Configurar Blazor como proveedor de servicios (Middleware SSO)

Nota: Después de la instalación del complemento, debemos configurar la confianza entre su aplicación Blazor y su proveedor de identidad. Los metadatos SAML se comparten con el proveedor de identidades para que puedan actualizar su configuración incorporada para admitir el inicio de sesión único.

3.1: Compartir metadatos SAML con el proveedor de identidad

• Haga clic en Agregar nuevo IDP para configurar Blazor Single Sign-On (SSO) utilizando su proveedor de identidad.

• En Configuración del proveedor de servicios pestaña, puede copiar y pegar el URL de metadatos en su lado de desplazado interno o descargar los metadatos del SP como un archivo XML. Además, tiene la opción de copiar y pegar manualmente URL base, Id. de entidad del proveedor de servicios, y URL de ACS.
• Comparta metadatos SAML con su proveedor de identidad.

3.2: Importar metadatos SAML del proveedor de identidad

• Seleccione su proveedor de identidad de la lista que se muestra.

Hay dos formas que se detallan a continuación con las que puede configurar los metadatos de su proveedor de identidad SAML en el middleware.

A] Cargue metadatos usando el botón Cargar metadatos IDP:

• Si su proveedor de identidad le ha proporcionado la URL de metadatos o el archivo de metadatos (solo formato .xml), simplemente puede configurar los metadatos del proveedor de identidad en el middleware utilizando el Cargar metadatos de IDP .
• Puede consultar la captura de pantalla a continuación:

• Puedes elegir cualquiera de las opciones según el formato de metadatos que tengas disponible.

B] Configure los metadatos del proveedor de identidad manualmente:

• Después de configurar su Proveedor de identidad, te proporcionará ID de entidad de IDP, URL de inicio de sesión único de IDP y Certificado SAML X509 campos respectivamente.
• Haga clic en Guardar para guardar los datos de su IDP.

Paso 4: Probar SAML SSO

• Antes de realizar la prueba, asegúrese de lo siguiente:
• Los metadatos SAML de Blazor (SP) se han exportado al proveedor de identidad (IDP).
• Los metadatos SAML del proveedor de identidad (IDP) se importan en el panel de SSO de Blazor (SP).
• Para comprobar si la configuración SAML que ha realizado es correcta, coloque el cursor sobre Seleccionar acciones y haga clic en Configuración de prueba.

• Nota: En la versión de prueba del complemento, solo puedes configurar y probar un proveedor de identidad (IDP).
• La siguiente captura de pantalla muestra un resultado exitoso. Haga clic en Terminado para continuar con la integración SSO.

• Si experimenta algún error en el extremo del middleware, se le mostrará una ventana similar a la siguiente.

• Para solucionar el error, puede seguir los pasos a continuación:
• En Localización de averías pestaña, habilite la opción para recibir los registros del complemento.


• Una vez habilitado, podrá recuperar los registros del complemento navegando a Configuración del proveedor de identidad pestaña y haciendo clic en Configuración de prueba.
• Descargue nuestra archivo de registro del menú Solucionar problemas pestaña para ver qué salió mal.
• Puedes compartir el archivo de registro con nosotros en aspnetsupport@xecurify.com y nuestro equipo se comunicará con usted para resolver su problema.

Paso 5: Código de integración

• Estos pasos le permiten recuperar la información del usuario SSO en su aplicación en forma de reclamos de usuario.
• También puedes mirar el recorrido de instalación para comprender cómo funcionaría la integración de SSO en su aplicación Blazor.
• Simplemente copie y pegue ese fragmento de código donde quiera acceder a los atributos del usuario.

• Nota: Este middleware de prueba solo admite información del usuario en reclamos; la recuperación de información del usuario en la sesión y los encabezados está disponible en el complemento premium
• También puede copiar el código de integración a continuación:

        

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

• Nota: Todos los atributos asignados se almacenarán en los reclamos a los que se accederá en su aplicación.
• Si desea ayuda con el código de integración, póngase en contacto con nosotros en aspnetsupport@xecurify.com

Paso 6: agregue el siguiente enlace a su solicitud de inicio de sesión único (SSO)

• Hover en Seleccionar acciones y haga clic en Copiar enlace SSO.

• Utilice el enlace copiado en la aplicación desde donde desea realizar SSO:
  https://base-url/?ssoaction=login&appid=[Your-Application-ID]
• Por ejemplo, puedes usarlo como:
  <a href=”https://base-url/?ssoaction=login”>Log in</a>