SAML

SAML 2.0 es un protocolo estándar abierto que permite a los usuarios acceder a múltiples aplicaciones basadas en la 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 habilitado, los usuarios de Document360 pueden iniciar sesión en la plataforma con sus credenciales existentes de un proveedor de identidad (IdP). Document360 admite la configuración de varios puntos finales de inicio de sesión único (SSO), lo que permite que tanto las cuentas de equipo como los lectores inicien sesión con su proveedor de identidad preferido.

Proveedores de identidades admitidos

Document360 admite los siguientes proveedores de identidades (IdP):

• Okta

• Entra ID

• Google

• Auth0

• ADFS

• Un inicio de sesión

• Otros

Configuración de SSO mediante SAML

1. Inicie sesión en su cuenta de Document360 y navegue hasta el proyecto deseado.

2. Vaya a Configuración () >Usuarios y seguridad > SAML/OpenID.

3. Haz clic en Crear SSO.

4. Seleccione un proveedor de identidad en la página Elija su proveedor de identidad (IdP ).

   

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

   

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

7. Con los detalles proporcionados por el proveedor de identidad, configure la configuración de SSO en Document360 en la página Configurar el proveedor de identidad (IdP ).

   

Habilitación de la redirección directa de sitios de Knowledge Base (SSO iniciado por IdP)

Si desea que los usuarios que inician sesión a través de un flujo de SSO iniciado por IdP se redirijan directamente al sitio de la base de conocimientos (en lugar del panel de control del proyecto), debe configurar el parámetro RelayState en el proveedor de identidades (IdP).

Para configurar esto:

1. Inicie sesión en la consola de administración de su proveedor de identidades (IdP) (por ejemplo, Okta, Entra ID, Auth0 o ADFS).

2. Abra la aplicación SAML que creó para Document360.

3. Busque el campo RelayState (o equivalente).

4. Introduzca la URL del sitio de la base de conocimientos.

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

5. Guarde la configuración.

6. Pruebe el inicio de sesión iniciado por el IdP para verificar que los usuarios sean redirigidos directamente al sitio de la base de conocimientos.

NOTA

Si el campo RelayState se deja en blanco, los usuarios serán redirigidos al panel de Document360 Project de forma predeterminada.

Una vez que haya completado correctamente la configuración de SSO basada en el protocolo SAML, puede invitar a miembros de su proyecto a la aplicación de SSO configurada.

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

Solución de problemas

Si tiene problemas durante la configuración del inicio de sesión único de SAML o el inicio de sesión, consulte los siguientes errores comunes y sus soluciones:

Solicitud SAML no válida (clave que no es de confianza)

Error: Se ha encontrado un error al gestionar el inicio de sesión remoto: solicitud SAML no válida La firma SAML es válida pero utiliza una clave que no es de confianza. Este error se produce cuando el certificado SAML cargado en Document360 está inactivo.

Pasos para resolver:

Para resolver este problema,

Descargar el certificado SAML activo

1. Acceda a su IdP.

2. Descargue el certificado SAML activo actualmente.

Vuelva a cargar el certificado en Document360

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

2. Haga clic en Editar para la configuración de SSO correspondiente.

3. En la sección Configurar el proveedor de identidades (IdP), busque el campo Certificado SAML .

4. Haga clic en Examinar para cargar el nuevo certificado activo.

La carga del certificado activo debería resolver el problema.

La firma del mensaje SAML no es válida

Error:

• SignatureInvalid: la firma del mensaje SAML no es válida.

• AssertionSignatureInvalid: la firma de la aserción SAML no es válida.

• Solicitud SAML no válida: la firma SAML es válida, pero utiliza una clave que no es de confianza.

Este error se produce cuando se carga un certificado SAML incorrecto o caducado en Document360.

Pasos para resolver:

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

1. Compruebe si el certificado cargado está activo y no ha caducado.

2. Si es necesario, genere un nuevo certificado en el proveedor de identidades (IdP).

Vuelva a cargar el certificado correcto en Document360:

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

2. Haga clic en Editar para la configuración de SSO correspondiente.

3. En la sección Configurar el proveedor de identidades (IdP), busque el campo Certificado SAML .

4. Haga clic en Examinar para cargar el nuevo certificado activo.

Capturar registros para un análisis más detallado (si el problema persiste)

1. Agregue la extensión SAML Tracer a su navegador.

2. Abra SAML Tracer antes de iniciar el flujo de inicio de sesión único.

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

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

5. Haga clic con el botón derecho en el panel Rastreador de SAML .

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

Para obtener más ayuda, comuníquese con el Document360 support team con:

• Capturas de pantalla de la configuración del IdP.

• Los detalles del certificado SAML cargado.

• Registros de seguimiento de SAML.