Guías de configuración de inicio de sesión único de ASP.NET SAML

Paso 1: Requisitos previos: descarga e instalación

• 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 SAML a su aplicación.

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

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 ASP.NET como proveedor de servicios (módulo SSO)

Nota: Después de la instalación del complemento, necesitamos configurar la confianza entre su aplicación ASP.NET 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 el inicio de sesión único (SSO) de ASP.NET utilizando su proveedor de identidad.

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

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 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 puede configurar los metadatos del proveedor de identidad en el módulo usando 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 ASP.NET (SP) se han exportado al proveedor de identidad (IDP).
• Importación de metadatos SAML del proveedor de identidad (IDP) en ASP.NET (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 al final del módulo, se le mostrará una ventana similar a la siguiente.

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


• 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 aspnetsupport@xecurify.com y nuestro equipo se comunicará con usted para resolver su problema.

Paso 5: Código de integración

• Este paso le permite especificar el prefijo sso de la sesión o el parámetro de reclamos que se usará para acceder a los atributos de usuario en su aplicación.
• Si todavía estás confundido acerca de cómo funcionan los pasos de integración, echa un vistazo a la Tour de instalación.

• Seleccione el modo para almacenar atributos de SSO y ahora verá el código de integración según el método de autenticación que seleccionó y el idioma que utiliza su aplicación.
• Simplemente copie y pegue ese fragmento de código donde quiera acceder a los atributos del usuario.

• Nota: Este módulo de prueba solo admite autenticación basada en sesiones y Reclamaciones de usuarios está disponible en el complemento premium.
• Nota: Todos los atributos asignados se almacenarán en la sesión para que pueda acceder a ellos 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
• Por ejemplo, puedes usarlo como:
  <a href=”https://base-url/?ssoaction=login”>Log in</a>

Paso 7: agregue el siguiente enlace a su solicitud de SLO

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