Contenido

Inicio de sesión único (SSO) SAML de Umbraco con Onelogin 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 Onelogin considerando Onelogin como IdP. Para saber más sobre las funciones que ofrecemos para Umbraco SSO, haga clic en esta página.

Seleccione su versión de umbraco para configurar SSO con:

Requisitos previos: descarga e instalación

Instalar desde la tienda NuGet
Instalación manual

Paquete NuGet
CLI de .NET

PM> NuGet\Install-Package miniOrange.Umbraco8.SAML.SSO -Versión 5.4.2

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 integración.md archivo que contiene los pasos para agregar el módulo a su aplicación.

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.

Agrega la referencia miniorange-saml-sso.dll archivo en su aplicación Umbraco:

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: agregue el archivo DLL miniOrange

Agregue la configuración-miniOrange-sso archivo en su aplicación Umbraco.
En Inicio.cs archivo:

Agregar el espacio de nombres miniOrange.samlusing miniOrange.saml;
Actualice las líneas de fragmentos del middleware Umbraco en el método Startup.Configure como se muestra a continuación:

app.UseUmbraco()

                .WithMiddleware(u => { 

                    u.UseBackOffice();
            

                    u.UseWebsite();
            

                    u.AppBuilder.UseminiOrangeSAMLSSOMiddleware();
            

                }) 

                .WithEndpoints(u => { 

                    u.UseInstallerEndpoints();
            

                    u.UseBackOfficeEndpoints();
            

                    u.UseWebsiteEndpoints();
            

                });

Ejecute la aplicación cuando finalice la configuración.
Después de la integración, abra su navegador y explore el panel del complemento con la siguiente URL: https://<umbraco-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 middleware SAML miniOrange Umbraco en su aplicación Umbraco.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP - Página de inicio de sesión de Umbraco

Regístrese o inicie sesión con su cuenta haciendo clic en Registro botón para configurar el complemento

Después de la integración, abra su navegador y explore el panel del conector con la siguiente URL:
https://<your-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 Umbraco SAML a su aplicación.

Inicio de sesión único (SSO) de Umbraco SAML utilizando OneLogin como IDP - Registro de Umbraco SAML

Regístrese o inicie sesión con su cuenta haciendo clic en Registro Botón para configurar el módulo.

Configure el inicio de sesión único (SSO) de Umbraco usando OneLogin como IDP

1. Configurar Onelogin como IDP

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

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

Bajo la Configuración del proveedor de servicios sección, puede encontrar la URL de 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 su extremo OneLogin.
Puede consultar la siguiente captura de pantalla.

Inicio de sesión único (SSO) de Umbraco SAML que utiliza OneLogin como IDP: metadatos del proveedor de servicios

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 único, y proporcionárselos a su proveedor de identidad para su configuración.
Puede consultar la siguiente captura de pantalla.

Bajo la Ajustes Plugin seleccione OneLogin como su proveedor de identidad de la lista que se muestra a continuación:

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: seleccione su IDP

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 el menú Configuración del complemento, busque Proveedor de servicios ajustes. 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) SAML de Umbraco utilizando OneLogin como IDP: descargar metadatos de SP

B] Cargar metadatos manualmente:

Desde el Proveedor de servicios sección de configuración, puede copiar manualmente los metadatos del proveedor de servicios como Id. de entidad del proveedor de servicios, 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) SAML de Umbraco utilizando OneLogin como IDP: copiar metadatos de SP

Vaya a onelogin.com, ingrese su dominio y Inicie sesión en OneLogin.
Inicie sesión en OneLogin como administrador y vaya a Apps Aplicaciones de la empresa Agregar aplicaciones desde la barra de navegación.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: agregar aplicación

En el cuadro de búsqueda, escriba Conector de prueba SAML (SP) y haga clic en la aplicación para agregarla.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP - Aplicación de búsqueda

Introduzca el nombre para mostrar y haga clic en Guardar.
In Configuración general, ingrese el nombre de la aplicación y haga clic en Siguiente.
Después de guardar, vaya a Pestaña de configuración e ingrese lo siguiente:

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP - Configuración de la aplicación

Público	Para ofrecer URL de audiencia desde la pestaña Metadatos del proveedor de servicios del complemento
Para:	Para ofrecer URL del destinatario desde la pestaña Metadatos del proveedor de servicios del complemento
Validador de URL ACS (Consumidor)	Para ofrecer URL de ACS (servicio al consumidor de afirmaciones) desde la pestaña Metadatos del proveedor de servicios del complemento
URL de ACS (consumidor)	Para ofrecer URL de ACS (servicio al consumidor de afirmaciones)desde la pestaña Metadatos del proveedor de servicios del complemento
URL de cierre de sesión único	Para ofrecer URL de cierre de sesión único desde la pestaña Metadatos del proveedor de servicios del complemento

Haga clic en Guardar.

mini naranja img Asignar grupos/personas

Ve a Pestaña SSO. Anote la URL/puntos finales. Estos serán necesarios al configurar el complemento.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: habilite SAML SSO

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP - Agregar certificado_X.509

Ha configurado correctamente OneLogin como IdP (proveedor de identidad) SAML para lograr el inicio de sesión único (SSO) de Umbraco.

2. Configurar Umbraco como SP

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

2.1: Compartir metadatos SAML con OneLogin

Haga clic en Agregar nuevo IDP para configurar Umbraco Single Sign-On (SSO) con OneLogin.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: agregar nuevo IDP

under 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 serviciosy URL de ACS.
Comparta metadatos SAML con su proveedor de identidad.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP - Metadatos de configuración de SP

2.2: Importar metadatos SAML de OneLogin

Seleccione OneLogin de la lista de proveedores de identidad que se muestra a continuación.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: seleccione el proveedor de identidad

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.

Inicio de sesión único (SSO) de Umbraco SAML utilizando OneLogin como IDP: carga de metadatos

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

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: ingrese metadatos de IDP

Ha configurado correctamente su aplicación Umbraco 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 el complemento.

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 el complemento utilizando el Cargar metadatos de IDP opción. Puede consultar la captura de pantalla a continuación:

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: cargar metadatos de IDP

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, le proporcionará ID de entidad de IDP, URL de inicio de sesión único de IDP y Certificado SAML X509 campos respectivamente.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: ingrese los metadatos de IDP manualmente

Haga Clic en Guardar para guardar sus datos de IDP

3. Prueba de SSO de SAML

Antes de realizar la prueba, asegúrese de lo siguiente:

Los metadatos SAML de Umbraco (SP) se han exportado a OneLogin (IDP).
Importación de metadatos SAML de OneLogin (IDP) en Umbraco (SP).

Para comprobar si la configuración SAML que ha realizado es correcta, vaya a Seleccionar acciones Luego haga clic Configuración de prueba.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: pruebe SAML SSO

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.

Inicio de sesión único (SSO) de Umbraco SAML utilizando OneLogin como IDP - Prueba de SSO de SAML

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

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP - Ventana de error

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

under Solucionando Problemas pestaña, habilite la opción para recibir los registros del complemento.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP: habilitar registros de depuración

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 desplegable Solucionar problemas pestaña para ver qué salió mal.
Puedes compartir el archivo de registro con nosotros en umbracosupport@xecurify.com y nuestro equipo se comunicará con usted para resolver su problema.

Haga clic en el 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) SAML de Umbraco utilizando OneLogin como IDP: configuración de prueba exitosa

Si experimenta algún error al final del complemento, se le mostrará una ventana similar a la siguiente.
Para solucionar el error, puede seguir los pasos a continuación:
- Bajo la 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 la página Ajustes Plugin pestaña y haciendo clic en Configuración de prueba.
- Descargue el archivo de registro de la pestaña Solucionar problemas para ver qué salió mal.
- Puede compartir el archivo de registro con nosotros en umbracosupport@xecurify.com y nuestro equipo se comunicará con usted para resolver su problema.

4. Configuración de inicio de sesión

Ve a Seleccionar acciones y haga clic en Copiar enlace SSO.

Inicio de sesión único (SSO) SAML de Umbraco utilizando OneLogin como IDP - Copiar enlace SSO

Utilice el enlace copiado en la aplicación desde donde desea realizar SSO
Por ejemplo puedes usarlo como:
<a href="copied-sso-link”>Login</a>"

Utilice la siguiente URL como enlace en la aplicación desde donde desea realizar SSO: https://<umbraco-application-base-url>/?ssoaction=login

5. 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>"

Incluso puedes configurar el Inicio de sesión único (SSO) SAML de nopCommerce módulo con cualquier proveedor de identidad como ADFS, 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 identidad personalizado. Consulte la lista de proveedores de identidad esta página.

Recursos adicionales

¿Necesitas ayuda?

¿No puedes encontrar tu proveedor de identidad? Envíenos un correo electrónico a umbracosupport@xecurify.com y lo ayudaremos a configurar SSO con su IDP y para obtener orientación rápida (por correo electrónico/reunión) sobre sus requisitos y nuestro equipo lo ayudará a seleccionar la mejor solución/plan adecuado según sus requisitos.

Contenido

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

Requisitos previos: descarga e instalación