Inicio de sesión único (SSO) de Umbraco SAML con Keycloak como IDP

Inicio de sesión único (SSO) de Umbraco SAML El complemento brinda la posibilidad de habilitar el inicio de sesión único SAML para sus aplicaciones Umbraco. Al utilizar el inicio de sesión único, puede utilizar solo una contraseña para acceder a su aplicación y servicios de Umbraco. Nuestro complemento es compatible con todos los proveedores de identidad compatibles con SAML. Aquí repasaremos una guía paso a paso para configurar el inicio de sesión único (SSO) entre Umbraco y Keycloak considerando a Keycloak como IdP. Para saber más sobre las funciones que ofrecemos para Umbraco SSO, haga clic en esta página.

Requisitos previos: descarga e instalación

• Descargar Módulo de inicio de sesión único (SSO) SAML de Umbraco.
• Para configurar el módulo, extraiga el umbraco-saml-sso-conector.zip, encontrará un archivo DLL miniorange-saml-sso.dll, un archivo de configuración saml.config y un integración.md archivo que contiene los pasos para agregar el módulo a su aplicación.

1. Agregar módulo en la aplicación Umbraco

• Añada miniorange-saml-sso.dll en la carpeta bin (donde existen sus otros archivos DLL) de su sitio Umbraco.
• Registro mininaranjasamlsso módulo para su umbraco SSO de acuerdo con los pasos proporcionados en el integración.md archivo.
• Agregue el archivo de configuración proporcionado saml.config en el directorio raíz de su sitio umbraco.
• Después de la integración, abra el navegador y explore el panel del módulo con la siguiente URL:
  https://<umbraco-base-url>/?ssoaction=config
• Si aparece la página de registro o la página de inicio de sesión, ha agregado con éxito el módulo miniOrange saml sso para su aplicación.

• Registro or Acceder para configurar el módulo.

2. Configurar Keycloak como IDP

A continuación se detallan dos formas de configurar los metadatos de SAML SP en el extremo de su proveedor de identidad.

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

• En la sección Configuración del proveedor de servicios, 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 siguiente captura de pantalla:
  
  

B] Cargar metadatos manualmente:

• Desde la sección Configuración del proveedor de servicios, puede copiar los metadatos del proveedor de servicios manualmente, como ID de entidad SP, URL ACS, URL de cierre de sesión única, y proporcionárselos a su proveedor de identidad para su configuración.
• Puede consultar la siguiente captura de pantalla:
  
  

• Versión 18 y anteriores
• Versión 19 y superior

En tu capa de llaves Administración consola, seleccione el reino que desea utilizar.
Haga clic en Clientes en el menú de la izquierda y luego haga clic en Crear para crear un nuevo cliente/aplicación.

Participar SP-EntityID / Emisor como el ID de cliente desde la pestaña "Configuración del proveedor de servicios" y seleccione SAML como el Protocolo de cliente.

Ahora haga clic en Guardar.
Configure Keycloak proporcionando los detalles requeridos:
ID de cliente	El SP-EntityID / Emisor desde la pestaña Metadatos del proveedor de servicios del complemento
Nombre	Proporcione un nombre para este cliente
Descripción	Proporcionar una descripción
Se requiere firma del cliente	OFF
Forzar enlace POST	OFF
Forzar formato de ID de nombre	OFF
Formato de identificación de nombre	Correo electrónico
URL raíz	Déjelo vacío o proporcione la URL base desde la pestaña Configuración del proveedor de servicios
URI de redireccionamiento válidos	El URL de ACS (servicio al consumidor de afirmaciones) desde la pestaña Configuración del proveedor de servicios del complemento

under Configuración de punto final SAML de grano fino, Ingrese los siguientes detalles:
URL de enlace POST del servicio al consumidor de aserciones	El URL de ACS (servicio al consumidor de afirmaciones) desde la pestaña Configuración del proveedor de servicios del complemento
URL de enlace de redireccionamiento del servicio de cierre de sesión (Opcional)	El URL de cierre de sesión único desde la pestaña Metadatos del proveedor de servicios del complemento

Haga clic en Guardar.
En tu capa de llaves Administración consola, seleccione el reino que desea utilizar.
Haga clic en Clientes en el menú de la izquierda y luego haga clic en Crear cliente para crear un nuevo cliente/aplicación.

Seleccione SAML as Tipo de cliente, Ingresar SP-EntityID / Emisor como el ID de cliente En la pestaña "Metadatos del proveedor de servicios", ingrese el nombre de su aplicación e ingrese la Descripción.

Ahora haga clic en Guardar.
Configure Keycloak proporcionando los detalles requeridos:
ID de cliente	El SP-EntityID / Emisor desde la pestaña Metadatos del proveedor de servicios del complemento
Nombre	Proporcione un nombre para este cliente
Descripción	Proporcionar una descripción
Se requiere firma del cliente	OFF
Forzar enlace POST	OFF
Forzar formato de ID de nombre	OFF
Formato de identificación de nombre	Correo electrónico
URL raíz	Déjelo vacío o proporcione la URL base desde la pestaña Configuración del proveedor de servicios
URI de redireccionamiento válidos	El URL de ACS (servicio al consumidor de afirmaciones)desde la pestaña Configuración del proveedor de servicios del complemento

Ahora haga clic en Guardar.
In Avanzado pestaña, debajo Configuración de punto final SAML de grano fino, Ingrese los siguientes detalles:
URL de enlace POST del servicio al consumidor de aserciones	El URL de ACS (servicio al consumidor de afirmaciones) desde la pestaña Configuración del proveedor de servicios del complemento
URL de enlace de redireccionamiento del servicio de cierre de sesión (Opcional)	El URL de cierre de sesión único desde la pestaña Metadatos del proveedor de servicios del complemento

Haga clic en Guardar.

Ha configurado Keycloak exitosamente como SAML IdP (proveedor de identidad) para lograr el inicio de sesión de Keycloak / Keycloak SSO / Keycloak Single Sign-On (SSO), garantizando un inicio de sesión seguro en la aplicación Umbraco.

3. Configurar Umbraco como SP

A continuación se detallan dos formas de configurar los metadatos de su proveedor de identidad SAML en el módulo.

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 configure los metadatos del proveedor de identidad en el módulo utilizando el Cargar metadatos de IdP .
• Puede consultar la siguiente captura de pantalla.
  
  
• Puede elegir cualquiera de las opciones según el formato de metadatos con el que esté 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 x.509. Configure estos valores en ID de entidad de IDP, URL de inicio de sesión único y Certificado SAML X509 campos respectivamente.
• Haga Clic en Guardar para guardar los datos de su IDP.

4. Configuración de prueba

• Haga clic en Configuración de prueba para probar si la configuración SAML que ha realizado es correcta o no.
• La siguiente captura de pantalla muestra un resultado exitoso.

5. Mapeo de atributos

• Asigne sus atributos de umbraco con los atributos del proveedor de identidad (IdP).

• Haga clic en Guardar asignación de atributos para guardar la configuración

6. Tipo de inicio de sesión

La plataforma Umbraco admite dos formas diferentes de iniciar sesión:

7. Configuración de inicio de sesión

• Utilice la siguiente URL como enlace en su sitio de Umbraco desde donde desea iniciar SSO:
  https://umbraco-base-url/?ssoaction=login
• Por ejemplo puedes usarlo como:
  <a href="https://umbraco-base-url/?ssoaction=login”>Login</a>"

8. Configuración de cierre de sesión

• Utilice la siguiente URL como enlace en su Umbraco desde donde desea realizar SLO:
  https://umbraco-base-url/?ssoaction=logout
• Por ejemplo puedes usarlo como:
  <a href="https://umbraco-base-url/?ssoaction=logout”>Logout</a>"

Puede configurar el módulo de inicio de sesión único (SSO) de Umbraco SAML 2.0 con cualquier proveedor de identidad, como ADFS, Azure AD, Bitium, Centrify, G Suite, WordPress, Okta, OneLogin, Salesforce, AWS Cognito, OpenAM, Oracle, PingFederate, PingOne, RSA SecureID, Shibboleth-2, Shibboleth-3, SimpleSAML, WSO2 o incluso con su propio proveedor de identidad personalizado. Consulte la lista de proveedores de identidad esta página.

9. Recursos adicionales

• DNN SAML Inicio de sesión único (SSO)
• Inicio de sesión único (SSO) de Umbraco SAML
• Inicio de sesión único (SSO) de ASP.NET SAML
• Inicio de sesión único (SSO) SAML de nopCommerce
• Autenticación de API REST de DNN