SAML

SAML 2.0 es un protocolo estándar abierto que permite a los usuarios acceder a múltiples aplicaciones web con un único conjunto de credenciales. Esto proporciona una forma más segura y cómoda para que los usuarios accedan a Document360. Con SAML 2.0 activado, los usuarios de Document360 pueden iniciar sesión en la plataforma usando sus credenciales existentes de un proveedor de identidad (IdP). Document360 soporta la configuración de múltiples puntos finales de inicio de sesión único (SSO), permitiendo que tanto usuarios como lectores inicien sesión usando su proveedor de identidad preferido.

Proveedores de identidad soportados

Document360 admite los siguientes proveedores de identidad (IdP):

• Okta

• Entra ID

• Google

• Auth0

• ADFS

• OneLogin

• Otros

Configuración de SSO usando SAML

1. Inicia sesión en tu cuenta de Document360 y navega hasta el proyecto que deseas.

2. Navega a Configuración () > Usuarios y permisos > Configuración SSO.

3. Haz clic en Crear SSO.

4. Selecciona un proveedor de identidad desde la página Elige tu proveedor de identidad (IdP ).

   

5. Selecciona SAML en la página Configurar el proveedor de servicios (SP ).

   

6. Usando los detalles proporcionados en la página Configurar el proveedor de servicios (SP ), configura la aplicación Document360 con el proveedor de identidad seleccionado previamente.

7. Utilizando los datos proporcionados por el proveedor de identidad, configura la configuración SSO en Document360 en la página Configurar el Proveedor de Identidad (IdP ).

   

Habilitar la redirección directa del sitio de la base de conocimiento (SSO iniciada por IdP)

Si quieres que los usuarios que inicien sesión a través de un flujo SSO iniciado por IdP sean redirigidos directamente a tu sitio de la base de conocimientos (en lugar del panel de control del Proyecto), debes configurar el parámetro RelayState en tu Proveedor de Identidad (IdP).

Para configurar esto:

1. Inicia sesión en la consola de administración de tu Proveedor de Identidad (IdP) (por ejemplo, Okta, Entra ID, Auth0 o ADFS).

2. Abre la aplicación SAML que creaste para Document360.

3. Localiza el campo RelayState (o equivalente).

4. Introduce la URL de tu sitio de la base de conocimiento.

   Por ejemplo: https://docs.yourdomain.com

5. Guarda tu configuración.

6. Prueba el inicio de sesión iniciado por IdP para verificar que los usuarios son redirigidos directamente al sitio de la Base de Conocimiento.

NOTA

Si el campo RelayState queda en blanco, los usuarios serán redirigidos por defecto al panel de control del Proyecto Document360.

Una vez que hayas completado con éxito la configuración SSO basada en el protocolo SAML, puedes invitar a los miembros de tu proyecto a la aplicación SSO configurada.

Ahora, los usuarios pueden iniciar sesión en Document360 ya sea usando su correo electrónico y contraseña o usando SSO.

Solución de problemas

Si encuentras problemas durante la configuración o inicio de sesión del SSO SAML, consulta los siguientes errores comunes y sus soluciones:

Solicitud SAML inválida (clave no confiable)

Error: Se encontró un error al manejar el inicio de sesión remoto: la firma SAML de solicitud SAML inválida es válida pero utiliza una clave no confiable. Este error ocurre cuando el certificado SAML subido a Document360 está inactivo.

Pasos para resolver:

Para resolver este problema,

Descargar el certificado SAML activo

1. Accede a tu IDP.

2. Descarga el certificado SAML actualmente activo.

Vuelve a subir el certificado en Document360

1. En Document360, navega a Configuración () > Usuarios y permisos > SAML/OpenID.

2. Haz clic en Editar para ver la configuración SSO correspondiente.

3. En la sección Configurar el Proveedor de Identidad (IdP ), localiza el campo de Certificado SAML .

4. Haz clic en Explorar para subir el nuevo certificado activo.

Subir el certificado activo debería resolver el problema.

La firma del mensaje SAML es inválida

Error:

• SignatureInvalid: La firma del mensaje SAML es inválida.

• AssertionSignatureInvalid: La firma de aserción SAML es inválida.

• Solicitud SAML inválida: La firma SAML es válida pero utiliza una clave no confiable.

Este error ocurre cuando se sube un certificado SAML incorrecto o caducado a Document360.

Pasos para resolver:

Asegúrate de que el certificado sea válido:

1. Comprueba si el certificado subido está activo y no ha caducado.

2. Si es necesario, genera un nuevo certificado en el Proveedor de Identidad (IdP).

Vuelve a subir el certificado correcto en Document360:

1. En Document360, navega a Configuración () > Usuarios y permisos > SAML/OpenID.

2. Haz clic en Editar para ver la configuración SSO correspondiente.

3. En la sección Configurar el Proveedor de Identidad (IdP ), localiza el campo de Certificado SAML .

4. Haz clic en Explorar para subir el nuevo certificado activo.

Registrar registros de captura para análisis posteriores (si el problema persiste)

1. Añade la extensión SAML Tracer a tu navegador.

2. Abre SAML Tracer antes de iniciar el flujo de inicio de sesión SSO.

3. Realiza la acción que active el proceso SSO (por ejemplo, hacer clic en Continuar con SSO).

4. SAML Tracer registrará todas las solicitudes de red.

5. Haz clic derecho en el panel de trazadores SAML .

6. Seleccione Exportar o guarde los registros en un formato adecuado.

Para más asistencia, contacte con el equipo de soporte de Document360 con:

• Capturas de pantalla de tu configuración de IdP.

• Los detalles del certificado SAML subido.

• Registros rastreadores SAML.