Skip to main content
Este artículo se ha traducido automáticamente.

Descripción general

Conecte su proveedor de identidad SAML 2.0 para que los miembros accedan a Legora con sus credenciales de trabajo. Estos pasos se aplican a SAML, ADFS y PingFederate, incluida una aplicación empresarial de Entra configurada con SAML. La opción Entra ID utiliza OpenID Connect.

Requisitos previos

Su organización debe utilizar la autenticación global de Legora. Necesita Manage authentication security en Legora y acceso de administrador al proveedor de identidad. Consulte Administrar la autenticación.

Cómo funciona

Legora reserva los datos del proveedor de servicios para cada nueva conexión SAML. Regístrelos en el proveedor de identidad e importe los metadatos de esa aplicación en Legora. Legora recibe la aserción en la URL de Assertion Consumer Service (ACS). El Entity ID (Identifier) del proveedor de servicios identifica la conexión de Legora. El Entity ID del proveedor de identidad identifica al emisor. Para las conexiones nuevas, envíe un atributo id con un valor estable y único para cada persona.

Configurar la conexión

Empiece en Legora. Mantenga las conexiones que funcionan y sus asignaciones de identificadores sin cambios mientras prepara la nueva conexión.

Iniciar la configuración en Legora

Reserve primero la conexión.
  1. Desde su nombre en el menú, seleccione Settings. En People, seleccione Authentication.
  2. En SSO, seleccione Add y después SAML, ADFS o PingFederate.
  3. Introduzca un Connection name y seleccione Continue.
  4. Copie Entity ID (Identifier) y ACS URL (Reply URL). Puede volver a esta configuración más tarde.

Configurar el proveedor de identidad

Cree una aplicación SAML. Copie Entity ID (Identifier) en Entity ID, Audience URI o Identifier, y ACS URL (Reply URL) en ACS URL, Single Sign-On URL o Reply URL. Copie los valores completos que se muestran para su conexión. No añada ni elimine una barra final. En Okta, el campo Identifier se llama Audience URI (SP Entity ID). Si el soporte de Legora proporciona un enlace de metadatos del proveedor de servicios, compruebe que su Entity ID y URL ACS coinciden con los valores mostrados. La URL de metadatos del proveedor de identidad describe la aplicación que importa en Legora.

Asignar identificadores y atributos de usuario

Asigne estos atributos SAML al registro de directorio de la persona:
Para una conexión SAML existente, contacte con el soporte de Legora antes de añadir id o cambiar el origen, el formato o la asignación de un identificador. Un identificador diferente puede afectar al acceso a las cuentas existentes, aunque las direcciones de correo no cambien. Mantenga la configuración actual hasta acordar un plan de migración.
Para cada nueva conexión SAML, añada un atributo llamado id y asígnelo al identificador de directorio estable y único de la persona que inicia sesión. Configúrelo explícitamente en lugar de depender de NameID, otro atributo de identificador o un valor alternativo derivado del correo electrónico. Para una aplicación nueva, siga las instrucciones de su proveedor para añadir estos atributos:
Añada claims SAML específicos de la aplicación. Use los nombres de atributos de la tabla con Namespace vacío y compruebe que user.mail tenga un valor.
Elija un identificador no vacío que se mantenga igual para una persona entre inicios de sesión y sea diferente para cada persona. Prefiera un identificador de directorio persistente que no se reasigne y sea compatible con el proveedor. Puede diferir del correo electrónico. NameID es el identificador del usuario en el Subject de una respuesta SAML. Es independiente de los atributos de la tabla anterior: un atributo explícito id o nameidentifier puede tener prioridad sobre NameID. Compruebe NameID y todos los atributos id o nameidentifier enviados. Deben identificar de forma coherente a la persona que inicia sesión. Evite texto fijo, identificadores de inquilino o aplicación, direcciones compartidas, nombres para mostrar y valores generados en cada inicio de sesión. Confirme que el proveedor y la conexión admiten el formato NameID. Un identificador basado en correo necesita un plan para cambios y reutilización de direcciones.
Las asignaciones existentes pueden usar estos alias estándar con el prefijo:http://schemas.xmlsoap.org/ws/2005/05/identity/claims/

Completar la configuración en Legora

Importe la configuración de la aplicación que acaba de crear.
  1. Introduzca su Metadata URL, o el Entity ID, Sign-In Endpoint URL y Signing Certificate (PEM) del proveedor de identidad.
  2. Seleccione Complete setup.
  3. Para la nueva conexión, deje Status y Auto-provision desactivados hasta los accesos completos y controlados que se indican a continuación.

Verificar con dos usuarios de prueba

Inicie sesión dos veces como la misma persona para comprobar que el identificador permanece igual. Después, acceda como otra persona y compruebe que los identificadores son distintos. Un inicio de sesión correcto puede seguir utilizando un identificador compartido por error. Test connection no muestra atributos SAML ni compara usuarios. Pida al administrador del proveedor de identidad que revise la respuesta SAML enviada en cada inicio de sesión de prueba, con el visor de respuestas del proveedor o una herramienta de seguimiento SAML aprobada por su organización. Si no puede consultar estos valores, contacte con el soporte de Legora antes de activar la conexión. Para una conexión nueva, compruebe el valor explícito de id en cada prueba siguiente. Si falta o está vacío, corrija la asignación antes de activar la conexión, aunque Test connection tenga éxito. Para una conexión existente, verifique la asignación de identificadores establecida sin cambiarla.
  1. Asigne dos personas distintas a la aplicación del proveedor de identidad. Ambas deben ser ya miembros de su organización en Legora y tener registros de directorio y correos de trabajo propios. Si la aplicación es nueva, limite el acceso a estas personas hasta completar la verificación.
  2. Seleccione Test connection e inicie sesión como la primera persona.
  3. Abra la respuesta de ese inicio de sesión en el visor de respuestas de su proveedor de identidad o en una herramienta de seguimiento SAML aprobada por su organización. Compruebe id y los demás campos de identificador, incluidos NameID dentro de Subject y el atributo estándar nameidentifier.
  4. Inicie una nueva sesión como la misma persona. El identificador debe permanecer igual.
  5. Utilice otro perfil de navegador o una sesión privada para la segunda persona. Su identificador debe ser diferente. Compruebe el correo y los nombres de ambas personas.
  6. Para la nueva conexión, active Status para los accesos controlados que se indican a continuación. Mantenga Auto-provision desactivado.
  7. Antes del despliegue general o el aprovisionamiento automático, organice accesos completos y controlados a Legora para ambas personas. Cada una debe llegar a su propia cuenta y a la organización esperada. Repita el acceso de la primera persona. La ventana de prueba no verifica estas cuentas.
  8. Cuando ambas personas superen estas comprobaciones, amplíe el acceso a la aplicación del proveedor de identidad según lo previsto. Active Auto-provision solo después de confirmar las asignaciones y los dominios de correo previstos.
Si cambia un identificador, ambas personas comparten uno o aparece una cuenta inesperada, detenga el despliegue y contacte con support@legora.com. No incluya tokens, claves privadas ni aserciones sin procesar en correos o solicitudes de soporte.

Migrar una conexión existente

Compare los identificadores actuales y propuestos con el soporte de Legora y determine si es necesario migrar las cuentas. Antes de cambiar la configuración, acuerde una implementación controlada, comprobaciones de que los usuarios que vuelven a iniciar sesión acceden a sus cuentas existentes y un plan de reversión. Migración a la autenticación global Prepare una aplicación separada con los valores de la nueva conexión. Mantenga la aplicación que funciona y su devolución de llamada compartida o específica hasta verificar una transición coordinada. Consulte la guía de migración a la autenticación global.

Solución de problemas

Compare los valores mostrados para la conexión con la configuración del proveedor de identidad y las asignaciones de atributos.

URL de respuesta o audiencia rechazada

Copie exactamente el Identifier y la URL ACS de esta conexión. Descargar los metadatos correctamente no confirma que ambos coincidan.

Perfil incompleto o incorrecto

Revise los nombres de los atributos SAML y los valores de cada usuario indicados arriba. Compruebe que la persona tiene un correo de trabajo y que se envía en el atributo de correo configurado. Importar los metadatos no valida los atributos de una persona.

Cuenta inesperada o identificador cambiante

Detenga el despliegue y revise los orígenes del identificador con el soporte antes de cambiar asignaciones existentes. Si el problema persiste, contacte con support@legora.com.