Contenido

Blazor SAML SSO con ADFS como IDP

La aplicación Blazor SAML Single Sign-On (SSO) permite habilitar el inicio de sesión único SAML para sus aplicaciones Blazor. Con el inicio de sesión único, puede usar una sola contraseña para acceder a su aplicación y servicios Blazor. Nuestra aplicación es compatible con todos los proveedores de identidad compatibles con SAML. A continuación, le mostramos una guía paso a paso para configurar el inicio de sesión único (SSO) entre Blazor y Microsoft Entra ID (anteriormente Azure AD), considerando Azure AD como proveedor de identidad. Para obtener más información sobre las funciones que ofrecemos para Blazor SSO, haga clic aquí.

Soporte de plataforma: La aplicación Blazor SAML es compatible con ASP.NET Core 2.0 y superior. Es compatible con todas las plataformas Blazor, incluidas Windows, Linux y macOS.

Pasos para configurar el inicio de sesión único (SSO) de Blazor usando ADFS como IDP

Paso 1: Requisitos previos: descarga e instalación

Instale Blazor SAML SSO Middleware en su paquete de aplicación usando el paquete nuget

Paquete NuGet
CLI de .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()

Después de la integración, abra su navegador y explore el panel del conector 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 exitosamente el conector SSO miniOrange ASP.NET SAML a su aplicación.

Inicio de sesión único (SSO) de Blazor SAML utilizando Azure AD (Microsoft Entra ID) como IDP - registro saml dll

Regístrese o inicie sesión con su cuenta haciendo clic en Registrarse Botón para configurar la aplicación.

2. Configurar ADFS como proveedor de identidad

En la sección Ajustes Plugin seleccione el módulo ADFS como su proveedor de identidad de la lista que se muestra.

Inicio de sesión único (SSO) de ASP.NET Core SAML utilizando ADFS como IDP: seleccione ADFS como proveedor de identidad

Hay dos formas que se detallan a continuación con las que puede obtener los metadatos de SAML SP para configurarlos en el extremo de su proveedor de identidad.

A] Usando la URL de metadatos SAML o el archivo de metadatos:

En la sección Menú de configuración del complemento, buscar Configuración del proveedor de servicios. Debajo, puede encontrar la URL de los metadatos, así como la opción para descargar los metadatos SAML.
Copie la URL de metadatos o descargue el archivo de metadatos para configurarlo en el extremo de su proveedor de identidad.
Puede consultar la captura de pantalla a continuación:

Inicio de sesión único (SSO) de ASP.NET Core SAML utilizando ADFS como IDP: copiar metadatos descargados

B] Cargar metadatos manualmente:

En el campo Configuración del proveedor de servicios sección, puede copiar manualmente los metadatos del proveedor de servicios como ID de entidad de SP, URL de ACS, URL de cierre de sesión único y compártalo con su proveedor de identidad para su configuración.
Puede consultar la captura de pantalla a continuación:

Inicio de sesión único (SSO) de ASP.NET Core SAML utilizando ADFS como IDP: metadatos manuales

Primero, busca Administración de ADFS aplicación en su servidor ADFS.

ASP.NET Core SAML Inicio de sesión único (SSO) utilizando ADFS como IDP - servidor adfs

En Administración de AD FS, seleccione Confianza del partido que confía y haga clic en Agregar confianza de parte dependiente.

Inicio de sesión único (SSO) de ASP.NET Core SAML utilizando ADFS como IDP: agregar confianza de parte confiada

Seleccionar Reclamos conscientes desde el Asistente de confianza para la parte que confía y haga clic en Comenzar .

Inicio de sesión único (SSO) de ASP.NET Core SAML usando ADFS como IDP - Claims Aware

Seleccionar fuente de datos

En Seleccionar fuente de datos, seleccione la fuente de datos para agregar una confianza de parte de confianza.

URL de metadatos
Archivo XML de metadatos
Configuración manual

Navegue a Metadatos del proveedor de servicios sección del middleware ASP.NET Core SAML y copie el archivo URL de metadatos.
Seleccionar Importar datos sobre la parte de confianza publicados en línea o en la red local opción y agregue la URL de metadatos en la dirección de metadatos de la Federación.
Haga clic en Siguiente.

Inicio de sesión único (SSO) SAML de ASP.NET Core utilizando ADFS como IDP: compatibilidad con los metadatos del asistente SAML 2.0

Nota: En el siguiente paso, introduzca el nombre para mostrar deseado y haga clic en Siguiente.

Elija la política de control de acceso

Seleccionar Permitir a todos como Política de Control de Acceso y haga clic en Siguiente.

ASP.NET Core SAML Inicio de sesión único (SSO) usando ADFS como IDP - para SAML 2.0 Wizard Multi-Factor

Listo para agregar confianza

In Listo para agregar confianza hacer clic en Siguiente y luego en Cerrar.

Inicio de sesión único (SSO) SAML de ASP.NET Core usando ADFS como IDP - Asistente de SAML 2.0 Editar reclamo

Editar política de emisión de reclamos

En la lista de Confianza del partido que confía, seleccione la aplicación que creó y haga clic en Editar política de emisión de reclamos.

En la pestaña Regla de transformación de emisión, haga clic en Agregar regla .

ASP.NET Core SAML Inicio de sesión único (SSO) usando ADFS como IDP - para la regla de reclamo del asistente SAML 2.0

Elija el tipo de regla

Seleccionar Enviar atributos LDAP como reclamos y haga clic en Siguiente.

ASP.NET Core SAML Inicio de sesión único (SSO) usando ADFS como IDP - para atributos SAML 2.0 Configure_LDAP

Configurar regla de reclamo

Agregue un Nombre de la regla de reclamo y seleccione el Tienda de atributos según sea necesario en el menú desplegable.
En Asignación de atributos LDAP a tipos de reclamos salientes, Seleccione el atributo LDAP como Correos electrónicos y tipo de reclamación saliente como ID de nombre.

Inicio de sesión único (SSO) SAML de ASP.NET Core utilizando ADFS como IDP, para la regla de notificación de transformación adicional de SAML 2.0

Una vez que haya configurado los atributos, haga clic en Termine.
Después de configurar ADFS como IDP, necesitará el Metadatos de federación para configurar su proveedor de servicios.
Para obtener los metadatos de la federación de ADFS, puede utilizar esta URL
https://< ADFS_Server_Name >/federationmetadata/2007-06/federationmetadata.xml
Ha configurado ADFS correctamente como IdP (proveedor de identidad) de SAML para lograr el inicio de sesión de inicio de sesión único (SSO) de ADFS.

SSO de Windows (opcional)

Siga los pasos a continuación para configurar Windows SSO

Pasos para configurar ADFS para la autenticación de Windows

Abra el símbolo del sistema elevado en el servidor ADFS y ejecute el siguiente comando en él:

mini naranja img setspn -a HTTP/##FQDN del servidor ADFS## ##Cuenta de servicio de dominio##

mini naranja img FQDN es un nombre de dominio completo (Ejemplo: adfs4.example.com)

mini naranja img La cuenta de servicio de dominio es el nombre de usuario de la cuenta en AD.

mini naranja img Ejemplo: setspn -a HTTP/adfs.example.com nombre de usuario/dominio

Abra la Consola de administración de AD FS, haga clic en Servicios y ve al Métodos de autenticación sección. A la derecha, haga clic en Editar métodos de autenticación principales. Verifique la autenticación de Windows en la zona de Intranet.

Inicio de sesión único (SSO) de ASP.NET Core SAML utilizando ADFS como IDP: autenticación principal

ASP.NET Core SAML Inicio de sesión único (SSO) usando ADFS como IDP - Aplicación de administración

Abra Internet Explorer. Navegue a la pestaña Seguridad en Opciones de Internet.
Agregue el FQDN de AD FS a la lista de sitios en la intranet local y reinicie el navegador.
Seleccione Nivel personalizado para la zona de seguridad. En la lista de opciones, seleccione Inicio de sesión automático solo en la Zona de Intranet.

ASP.NET Core SAML Inicio de sesión único (SSO) usando ADFS como IDP - para SAML 2.0 Wizard_Enable SAML

Abra PowerShell y ejecute los siguientes dos comandos para habilitar la autenticación de Windows en el navegador Chrome.


                      Set-AdfsProperties -WIASupportedUserAgents ((Get-ADFSProperties | Select -ExpandProperty WIASupportedUserAgents) + "Chrome")


                      Get-AdfsProperties | Select -ExpandProperty WIASupportedUserAgents;

Ha configurado ADFS correctamente para la autenticación de Windows.

3. Configure la aplicación Blazor SAML como proveedor de servicios

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

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 en formato .xml), simplemente puede configurar los metadatos del proveedor de identidad en la aplicación utilizando el Cargar metadatos de IDP .
Puede consultar la captura de pantalla a continuación:

Inicio de sesión único (SSO) de Blazor SAML utilizando Azure AD (Microsoft Entra ID) como IDP: carga de metadatos

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.

Inicio de sesión único (SSO) de Blazor SAML utilizando Azure AD (Microsoft Entra ID) como IDP: configuración de SAML dll

4. Prueba de SSO de SAML

Haga clic en el elemento Configuración de prueba para probar si la configuración SAML que ha realizado es correcta.
La siguiente captura de pantalla muestra un resultado exitoso. Haga clic en Integración SSO para continuar con la integración SSO.

Inicio de sesión único (SSO) de Blazor SAML utilizando Azure AD (Microsoft Entra ID) como IDP: configuración de prueba de SAML dll

Si experimenta algún error al final de la aplicación, se le mostrará una ventana similar a la siguiente.

Inicio de sesión único (SSO) de Blazor SAML usando Azure AD (Microsoft Entra ID) como IDP: habilitar registros de depuración

Para solucionar el error, puede seguir los pasos a continuación:

En Solucionar problemas pestaña, habilite la opción para recibir los registros del complemento.

Una vez habilitado, podrá recuperar los registros del complemento navegando a Ajustes Plugin 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.

5. Mapeo de atributos

Después de probar la configuración, asigne los atributos de su aplicación a los atributos del proveedor de identidad (IdP).
En el complemento gratuito puedes configurar solo NameID
Nota: Todos los atributos asignados se almacenarán en los reclamos para que pueda acceder a ellos en su aplicación..

Inicio de sesión único (SSO) de Blazor SAML utilizando Azure AD (Microsoft Entra ID) como IDP: asignación de atributos

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

Inicio de sesión único (SSO) de ASP.NET Core SAML | Autenticación central ASP.NET | ASP.NET Core SAML SSO: código de integración

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

7. Configuración de inicio de sesión

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

Inicio de sesión único (SSO) de ASP.NET SAML utilizando Auth0 como IDP: códigos de integración de ASP.NET basados en el idioma

Utilice la siguiente URL como enlace en la aplicación desde donde desea realizar SSO:
https://blazor-application-base-url/?ssoaction=login
Por ejemplo, puedes usarlo como:
<a href=”https://blazor-application-base-url/?ssoaction=login”>Log in</a>

8. Configuración de cierre de sesión

Utilice la siguiente URL como enlace a su aplicación desde donde desea realizar SLO:
https://blazor-application-base-url/?ssoaction=logout
Por ejemplo, puedes usarlo como:
<a href=”https://blazor-application-base-url/?ssoaction=logout”>Log out</a>

Para configurar su IDP, puede encontrar los metadatos del proveedor de servicios en el archivo appsetting.json. Para los metadatos de SP, puede consultar la siguiente captura de pantalla:

Inicio de sesión único (SSO) de Blazor SAML usando Azure AD (Microsoft Entra ID) como IDP - Metadatos de SP

Desde la sección miniOrange , copie spentityid y acsurl y proporciónelos al equipo de su proveedor de identidad.

Una vez que los metadatos del proveedor de servicios estén configurados en el extremo del IdP, se le proporcionará el archivo de metadatos del IdP o la URL de metadatos o URL de metadatos como el ID de entidad del IdP, la URL de SSO del IdP, etc.
Para configurar los metadatos de su IDP, navegue hasta configuración de aplicaciones.json archivo. Encontrarás las siguientes configuraciones en la sección JSON del mininaranja.
Para configurar su IDP directamente, navegue hasta configuración de aplicaciones.json .

Inicio de sesión único (SSO) de Blazor SAML usando Azure AD (Microsoft Entra ID) como IDP - Metadatos de IDP

Configure los metadatos proporcionados apropiados y guarde la configuración.

idp_cert	Ingrese el certificado de IDP en este campo
agrio	Ingrese la URL de SSO en este campo
idp_emisor	Ingrese el emisor de IDP en este campo

Asignación de atributos

Asigne los atributos de su aplicación a los atributos del proveedor de identidad (IDP).
Nota: Todos los atributos asignados se almacenarán en la sesión para que pueda acceder a ellos en su aplicación.

Código de integración

Simplemente copie y pegue el fragmento de código donde desee acceder a los atributos del usuario.
Nota: Todos los atributos asignados se almacenarán en la sesión para que pueda acceder a ellos en su aplicación.

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

Puede configurar la aplicación Blazor SAML 2.0 Single Sign-On (SSO) con cualquier proveedor de identidades, como ADFS, Microsoft Entra ID (anteriormente 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 o incluso con su propio proveedor de identidades personalizado . Consulte la lista de proveedores de identidades aquí.

Más Recursos

¿Necesitas ayuda?

¿No encuentras a tu proveedor de identidad? Escríbenos a aspnetsupport@xecurify.com y te ayudaremos a configurar el inicio de sesión único (SSO) con tu proveedor de identidad. Además, te brindaremos orientación rápida (por correo electrónico o reunión) sobre tus necesidades y nuestro equipo te ayudará a seleccionar la solución o el plan más adecuado.

Contenido