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

Descripción general

Esta guía está dirigida a los administradores de TI que conectan Microsoft Entra ID a la autenticación global de Legora para el inicio de sesión único (SSO). A continuación, los miembros inician sesión en Legora con sus cuentas de Entra ID. Trabaja en dos sitios: el centro de administración de Microsoft Entra y Authentication en Legora. Entra ID usa OpenID Connect con la autenticación global de Legora.
Su organización debe usar la autenticación global de Legora y su rol debe incluir Manage authentication security. Consulte ¿Cómo administro la autenticación para mi organización?.Si su organización aún no ha pasado a la autenticación global, el soporte de Legora configura el inicio de sesión único (SSO). Póngase en contacto con support@legora.com. Para trasladar una organización existente, consulte Guía de administración de TI: la autenticación global de Legora.

Funcionamiento

Cada paso indica dónde hacerlo. Termine los pasos de Entra antes de probar la conexión en Legora.

Paso 1: Crear la aplicación empresarial (en Entra)

Cree en Entra la aplicación empresarial que Legora usa para conectar a los miembros. Entra también crea un registro de aplicación asociado, que usará en los pasos 2 y 3. Legora debe ser una aplicación empresarial que no sea de galería. Créela en Enterprise apps con los pasos siguientes para que Entra la configure como una aplicación que no es de galería. Las aplicaciones de galería informan que no son compatibles con SCIM, por lo que el aprovisionamiento de Directory Sync no está disponible. Si la suya es una aplicación de galería, o la creó en App registrations, cree una nueva aplicación empresarial y úsela para el inicio de sesión y el aprovisionamiento.
  1. Inicie sesión en el centro de administración de Microsoft Entra.
  2. Vaya a Entra ID > Enterprise apps y seleccione New application.
  3. Seleccione Create your own application.
  4. Rellene el formulario y seleccione Create:
    • What’s the name of your app?: Un nombre que describa la aplicación, por ejemplo «Legora SSO».
    • What are you looking to do with your application?: Seleccione Integrate any other application you don’t find in the gallery (Non-gallery).
  5. Vaya a Entra ID > App registrations, seleccione All applications y abra la aplicación con el nombre que introdujo.
  6. En la página Overview del registro de aplicación, copie estos valores para el paso 4:
    • Application (client) ID
    • Directory (tenant) ID

Paso 2: Añadir el URI de redirección (en Entra)

Registre la devolución de llamada de Legora para que Entra pueda devolver a los miembros después del inicio de sesión.
  1. En su registro de aplicación, vaya a Authentication.
  2. Seleccione Add a platform y, a continuación, elija Web.
  3. Pegue este URI de redirección y seleccione Configure:
https://sso.legora.com/api/oauth/oidc Use este URI para cada organización en la autenticación global de Legora. Después de crear la conexión en el paso 4, Redirect URL en la conexión muestra el mismo valor. Si Entra pregunta qué ámbitos de OpenID Connect permitir, active openid, profile y email. Legora necesita la dirección de correo electrónico después del inicio de sesión. El nombre y los apellidos son recomendables. Si este registro de aplicación ya tiene URI de redirección de una configuración de inicio de sesión de Legora anterior, déjelos y añada el URI anterior. Quite los URI antiguos solo después de que su organización haya terminado el paso a la autenticación global de Legora. La lista completa de tareas está en Guía de administración de TI: la autenticación global de Legora.

Paso 3: Crear un secreto de cliente (en Entra)

Cree el secreto que Legora usa para conectarse a su registro de aplicación.
  1. En su registro de aplicación, vaya a Certificates & secrets > Client secrets y seleccione New client secret.
  2. Añada una descripción, por ejemplo «Legora SSO secret», y elija la fecha de expiración.
  3. Seleccione Add, copie el Value y guárdelo en un lugar seguro. Entra muestra el Value una sola vez. El ID del secreto no se puede pegar en Legora.
Defina un recordatorio unos días antes de que expire el secreto. Cuando expire el secreto de cliente Cree un nuevo secreto de cliente en Entra y, a continuación, actualice Legora:
  1. Desde su nombre en el menú, seleccione Settings > People > Authentication.
  2. En SSO, seleccione la conexión.
  3. En Connection details, seleccione Edit.
  4. Introduzca el nuevo valor en Client secret. Deje el campo vacío solo si desea conservar el secreto actual.
  5. Guarde.
No necesita una conexión nueva para renovar un secreto.

Paso 4: Añadir los detalles de la conexión (en Legora)

Introduzca en Legora los valores de los pasos 1 a 3. Para el dominio, use un dominio que pertenezca a su organización. En el centro de administración de Entra, encuéntrelo en Entra ID > Domain names. Use un dominio verificado como legora.com. Ignore un dominio que termine en onmicrosoft.com.
  1. Desde su nombre en el menú, seleccione Settings > People > Authentication.
  2. En SSO, seleccione Add y, a continuación, elija Entra ID.
  3. Rellene el formulario:
    • Display Name: El nombre que los miembros ven en la pantalla de inicio de sesión.
    • Domain: El dominio de su organización.
    • Tenant ID: El Directory (tenant) ID del paso 1.
    • Client ID: El Application (client) ID del paso 1.
    • Client Secret: El valor del secreto del paso 3.
  4. Seleccione Create connection. Legora abre la nueva conexión.
Compruebe el dominio, el ID de inquilino y el ID de cliente antes de crear la conexión. Para usar otros valores más adelante, cree una conexión nueva. Edit puede cambiar el nombre para mostrar, la URL de detección y el secreto de cliente.

Paso 5: Asignar usuarios y grupos (en Entra)

Elija quién puede iniciar sesión en Legora a través de Entra.
  1. Vaya a Entra ID > Enterprise apps y seleccione la aplicación que creó en el paso 1.
  2. En Properties, elija si todos los usuarios de su directorio pueden iniciar sesión o solo los usuarios que asigne. Assignment required? es No de forma predeterminada. Ajústelo a Yes para permitir solo a los usuarios y grupos asignados.
  3. Si la asignación es obligatoria, vaya a Users and groups y seleccione Add user/group.
  4. Seleccione los usuarios o grupos que deben tener acceso a Legora y, a continuación, seleccione Assign.

Paso 6: Probar la conexión (en Legora)

Confirme que la conexión funciona antes de que los miembros la usen.
  1. Desde su nombre en el menú, seleccione Settings > People > Authentication.
  2. En SSO, seleccione la conexión.
  3. Seleccione Test connection. Se abre una ventana de inicio de sesión.
Si Microsoft pide aprobar permisos, un administrador de Entra puede tener que conceder el consentimiento antes de que termine la prueba. Si la prueba falla, compruebe el URI de redirección, el ID de cliente y el secreto de cliente, y vuelva a ejecutar la prueba. Si sigue fallando, póngase en contacto con support@legora.com.

Paso 7: Activar la conexión (en Legora)

Haga que la conexión esté disponible para los miembros. En la conexión, active Status. Los miembros podrán entonces iniciar sesión con Entra ID. Hasta que lo haga, la conexión permanece configurada, pero no aparece como método de inicio de sesión.

Quién puede unirse

Entra controla quién puede autenticarse. Legora controla quién se convierte en miembro. Define la pertenencia en la conexión, en Auto-provision y Email domains.

Auto-provision activado

Cuando Auto-provision está activado, Legora añade a una persona la primera vez que inicia sesión con una dirección de correo electrónico de un dominio incluido en la lista. Aun así debe tener permiso para autenticarse en Entra. La asignación de la aplicación, el acceso condicional y la autenticación multifactor permanecen en Entra. Añada al menos un dominio en Email domains antes de activar Auto-provision. La conexión debe estar activa. Si Directory Sync está activado para la conexión, use Directory Sync para gestionar la pertenencia. Consulte Directory Sync.

Auto-provision desactivado

Cuando Auto-provision está desactivado, una persona puede autenticarse igualmente en Entra. Legora la añade solo después de que un Admin la invite y ella acepte. Sin una pertenencia activa, el inicio de sesión se detiene. Legora muestra: «User has no active membership in any of the connection organisations.» Para conceder acceso, autorice a la persona en Entra e invítela en Legora. Para quitar el acceso, quítela de la aplicación de Entra o quítela de la organización en Legora.

Preguntas frecuentes

Estas respuestas cubren los problemas de inicio de sesión que los administradores comunican con más frecuencia una vez activada la conexión.

¿Qué ocurre cuando se quita a un usuario de la aplicación empresarial en Entra?

Ya no puede iniciar sesión a través de esa aplicación. Su perfil de Legora permanece. Si lo vuelve a asignar a la aplicación, puede iniciar sesión, siempre que siga siendo miembro o Auto-provision pueda añadirlo. Si la organización también usa Directory Sync, desactivar o quitar al usuario en Entra revoca su acceso a la organización. No elimina su perfil de Legora.

¿Por qué un usuario inicia sesión en una cuenta de Legora vacía?

Cuando Auto-provision está activado, Legora crea la cuenta a partir de la dirección de correo electrónico que envía Entra. Si esa dirección difiere de la de la invitación, por ejemplo jdoe@example.com en lugar de jane.doe@example.com, Legora crea una cuenta distinta para la dirección de Entra. Haga que el correo electrónico de Entra coincida con la dirección usada en Legora, o póngase en contacto con support@legora.com.

¿Por qué una persona no consigue terminar el inicio de sesión?

Suele significar que Auto-provision está desactivado y que la persona no ha sido invitada, o que se le ha quitado la pertenencia. Legora muestra: «User has no active membership in any of the connection organisations.» Invítela en Legora o active Auto-provision para su dominio de correo electrónico. También necesita acceso a la aplicación de Legora en Entra.

Tenemos varios dominios, pero el SSO no se inicia para todos

Añada cada dominio en Email domains de la conexión. Incluya también esos dominios en los dominios permitidos de la organización. Desde su nombre en el menú, seleccione Settings > People > Authentication. En Restrictions, seleccione Approved email domains y, a continuación, edite Allowed domains. Con una sola conexión SSO, Legora puede enrutar el inicio de sesión con los dominios permitidos de la organización. Con más de una conexión, solo los dominios de una conexión con Auto-provision activado sirven para elegir esa conexión.

Recursos adicionales

Estas páginas cubren el resto de la configuración de inicio de sesión.