Configurar SSO con Microsoft Entra ID

Crea una aplicación empresarial para Lingo.dev en Microsoft Entra ID, asigna usuarios, conéctala a tu organización y aprovisiona miembros mediante SCIM.

Esta guía te ayuda a conectar Microsoft Entra ID con Lingo.dev mediante SAML 2.0. Necesitas, como mínimo, el rol de Administrador de aplicaciones en la nube en Entra y debes ser Propietario de una organización de Lingo.dev con el plan Enterprise. Para saber cómo funciona SSO en Lingo.dev, consulta Inicio de sesión único.

Deja abierta la sección Configuración → SSO en Lingo.dev. Tendrás que copiar dos valores de esa sección en Entra.

Crear la aplicación empresarial #

  1. Inicia sesión en el Centro de administración de Microsoft Entra.
  2. Ve a Entra ID → Aplicaciones empresariales → Todas las aplicaciones y selecciona Nueva aplicación.
  3. Selecciona Crear tu propia aplicación.
  4. Escribe Lingo.dev como nombre, elige Integrar cualquier otra aplicación que no se encuentre en la galería (fuera de la galería) y selecciona Crear.

Configurar SAML #

  1. En la nueva aplicación, abre Inicio de sesión único y elige SAML.
  2. En Configuración básica de SAML, selecciona Editar.
  3. En Identificador (id. de entidad), selecciona Añadir identificador y pega https://auth.lingo.dev/auth/v1/sso/saml/metadata (el ID de entidad de Lingo.dev).
  4. En URL de respuesta (URL del servicio de consumidor de aserciones), selecciona Añadir URL de respuesta y pega https://auth.lingo.dev/auth/v1/sso/saml/acs (la URL de ACS de Lingo.dev).
  5. Deja los campos URL de inicio de sesión, Estado de retransmisión y URL de cierre de sesión vacíos por ahora. Selecciona Guardar. Configurarás la URL de inicio de sesión una vez establecida la conexión, en Iniciar sesión desde Mis aplicaciones de Microsoft.

Mantén la configuración predeterminada de Atributos y notificaciones. Las aplicaciones creadas en el Centro de administración de Entra envían el correo electrónico del usuario en la notificación emailaddress, a partir de user.mail, y un identificador de nombre con formato de correo electrónico. Asegúrate de que todos los usuarios que inicien sesión tengan una dirección de correo electrónico en Entra.

Una aplicación creada sin las notificaciones predeterminadas, por ejemplo, mediante la API de Microsoft Graph, no envía ninguna dirección de correo electrónico. En ese caso, el inicio de sesión falla con el mensaje "Tu proveedor de identidad no ha enviado ninguna dirección de correo electrónico". En Atributos y notificaciones, añade la notificación de correo electrónico con el atributo de origen user.mail.

Copiar la URL de metadatos #

En Certificados SAML, copia la URL de metadatos de federación de la aplicación.

Asignar usuarios y grupos #

  1. En la aplicación, abre Usuarios y grupos y selecciona Añadir usuario o grupo.
  2. En Usuarios y grupos, selecciona Ninguno seleccionado, elige los usuarios o grupos y pulsa Seleccionar.
  3. Selecciona Asignar.
  4. Abre Propiedades, establece ¿Se requiere asignación? en Sí y selecciona Guardar.

Si ¿Se requiere asignación? está en Sí, solo los usuarios asignados pueden iniciar sesión en Lingo.dev mediante Entra. Si está en No, todos los usuarios de tu inquilino pueden acceder a la aplicación, incluidas las cuentas de invitado. Aun así, Lingo.dev solo permite unirse a las cuentas de tus dominios conectados y vuelve a cerrar la sesión de cualquier otra cuenta. Las aplicaciones creadas mediante la API de Microsoft Graph tienen No como valor inicial. Para asignar grupos se necesita Microsoft Entra ID P1 o P2. En el plan gratuito, asigna los usuarios de uno en uno.

Conectar en Lingo.dev #

  1. Abre Configuración → SSO.
  2. Pega la URL de metadatos de federación de la aplicación en URL de metadatos del proveedor de identidad.
  3. En Dominios de correo electrónico, escribe los dominios de correo electrónico de tu empresa separados por comas.
  4. Selecciona Conectar.

Si se rechaza un dominio, consulta Reglas de dominio.

Probar el inicio de sesión #

  1. Abre una ventana privada del navegador y ve a la página de inicio de sesión de Lingo.dev.
  2. Selecciona Continuar con SSO, escribe el correo electrónico de un usuario asignado y selecciona Iniciar sesión.
  3. Inicia sesión con Microsoft.

Volverás a Lingo.dev como miembro de la organización. Comprueba el correo electrónico que aparece en la página de organizaciones: corresponde a la cuenta con la que Microsoft ha iniciado sesión, que no tiene por qué coincidir con el correo electrónico que has escrito. Si el navegador ya tiene una sesión iniciada en Microsoft, por ejemplo, con la cuenta de administración que configuró la aplicación, Microsoft continúa con esa cuenta sin pedir una contraseña. Por eso debes hacer la prueba en una ventana privada.

Inicia la prueba desde Lingo.dev en lugar de usar el botón Probar de Entra. Hasta que configures la URL de inicio de sesión, el icono de Lingo.dev en Mis aplicaciones de Microsoft no iniciará tu sesión: te llevará a la página de inicio de Lingo.dev sin haber iniciado sesión.

Si tu inquilino usa los valores predeterminados de seguridad, Microsoft pide a cada usuario que registre una aplicación de autenticación la primera vez que inicia sesión. Esto puede superar el tiempo de espera de Lingo.dev (unos 5 minutos), y el primer intento falla con el mensaje "El inicio de sesión único ha tardado demasiado en completarse. Inténtalo de nuevo." Al volver a intentarlo, funciona.

Cuando la prueba funcione, puedes exigir SSO. Primero, asigna a tu propia cuenta SSO el rol de Propietario, como se describe en Activarlo.

Iniciar sesión desde Mis aplicaciones de Microsoft #

Configura la URL de inicio de sesión para que el icono de Lingo.dev en Mis aplicaciones permita iniciar sesión.

  1. En Lingo.dev, abre Configuración → SSO y copia el Enlace de inicio de sesión del panel. Tendrá un formato como este: https://lingo.dev/auth/sso?domain=example.com.
  2. En Entra, abre la aplicación de Lingo.dev y selecciona Inicio de sesión único.
  3. En Configuración básica de SAML, selecciona Editar.
  4. Pega el enlace en URL de inicio de sesión. Selecciona Guardar.

Ahora el icono de Lingo.dev en Mis aplicaciones abre el enlace. Lingo.dev redirige al usuario a Microsoft y después de vuelta a Lingo.dev, con la sesión iniciada y sin pedirle su correo electrónico.

Aprovisionar miembros con SCIM #

Entra puede gestionar los miembros de Lingo.dev mediante SCIM y asignarles roles a través de grupos. Configura primero SSO siguiendo esta guía. Para saber cómo funciona SCIM en Lingo.dev, consulta Aprovisionar miembros con SCIM.

  1. En Lingo.dev, genera una clave SCIM.
  2. En Entra, abre la aplicación empresarial de Lingo.dev y selecciona Aprovisionamiento.
  3. Establece Modo de aprovisionamiento en Automático.
  4. En Credenciales de administrador, pega la URL base de SCIM de Lingo.dev, https://api.lingo.dev/v2/scim, en URL de inquilino. Pega la clave SCIM en Token secreto.
  5. Selecciona Probar conexión y, después, Guardar.
  6. Mantén las asignaciones de atributos predeterminadas. Lingo.dev obtiene userName de userPrincipalName y el correo electrónico del trabajo de mail.
  7. En Configuración, establece Ámbito en Sincronizar solo los usuarios y grupos asignados.
  8. Selecciona Iniciar aprovisionamiento.

La invitación se envía a la dirección mail del usuario, así que todos los usuarios que asignes deben tener esa dirección en un dominio conectado. No hay problema si userPrincipalName es diferente de mail.

Cada usuario que asignes tendrá una invitación pendiente en Lingo.dev y se convertirá en miembro la primera vez que inicie sesión con SSO.

Entra realiza el aprovisionamiento en ciclos, aproximadamente cada 40 minutos, por lo que los cambios y las bajas llegan a Lingo.dev en el siguiente ciclo. Para enviar un usuario de inmediato, usa Aprovisionar a petición.

Cuando retiras la asignación de un usuario, Entra envía una desactivación, no una eliminación, y Lingo.dev le da de baja como miembro. Consulta Eliminar personas.

Asignar roles con grupos de Entra #

  1. Asegúrate de que el grupo de Entra tenga el mismo nombre que un rol de Lingo.dev, como Translator.
  2. Asigna el grupo a la aplicación en Usuarios y grupos.

Entra vincula el grupo con el rol del mismo nombre y aprovisiona a sus miembros, que reciben ese rol. Las personas que elimines del grupo pierden el rol. Si el grupo era la única asignación de un usuario, quitarlo del grupo también lo da de baja en Lingo.dev.

Solución de problemas #

ProblemaSolución
Microsoft muestra AADSTS700016: "No se ha encontrado la aplicación con el identificador '…' en el directorio".Identificador (id. de entidad) no coincide exactamente con https://auth.lingo.dev/auth/v1/sso/saml/metadata. Corrígelo en Configuración básica de SAML.
Microsoft muestra AADSTS50011: "La URL de respuesta no coincide con las URL de respuesta configuradas para la aplicación".Establece URL de respuesta (URL del servicio de consumidor de aserciones) en https://auth.lingo.dev/auth/v1/sso/saml/acs, sin modificar el valor.
Microsoft muestra AADSTS50105: el usuario no está asignado a la aplicación.Asigna al usuario, o a un grupo al que pertenezca, en Usuarios y grupos.
Alguien que no está asignado ha iniciado sesión, o Lingo.dev muestra un correo electrónico que no has escrito.¿Se requiere asignación? está en No, o el navegador ya tenía una sesión iniciada en Microsoft con otra cuenta. Establece ¿Se requiere asignación? en Sí en Propiedades y haz la prueba en una ventana privada.
Lingo.dev indica que tu correo electrónico no pertenece a un dominio que tu organización utilice para el inicio de sesión único.Microsoft ha iniciado sesión con una cuenta que no pertenece a tus dominios conectados, a menudo una cuenta de invitado o la cuenta de administración que creó el inquilino. Inicia sesión con una cuenta de trabajo o añade su dominio en Configuración → SSO.
Lingo.dev muestra "Tu proveedor de identidad no ha enviado ninguna dirección de correo electrónico".La aplicación no envía ninguna notificación de correo electrónico, o el usuario no tiene una dirección de correo electrónico en Entra. Añade la notificación de correo electrónico (user.mail) en Atributos y notificaciones y configura el correo electrónico del usuario.
Lingo.dev muestra "El inicio de sesión único ha tardado demasiado en completarse. Inténtalo de nuevo."El inicio de sesión en Microsoft ha tardado más de unos 5 minutos, a menudo durante el registro de una aplicación de autenticación. Inténtalo de nuevo desde Lingo.dev. El siguiente intento funciona.
Lingo.dev muestra "Has iniciado sesión, pero no hemos podido añadirte a tu organización."Vuelve a iniciar sesión con SSO. Si sigue fallando, pide a un Propietario que compruebe que Configuración → SSO muestra Conectado desde.
Lingo.dev muestra "El inicio de sesión único no se ha completado".Compara Identificador (id. de entidad) y URL de respuesta con los valores de Lingo.dev y vuelve a intentarlo.
Probar conexión o el aprovisionamiento falla con 401 Unauthorized.La clave SCIM se ha rotado o revocado. Pega la clave actual en Token secreto o genera una nueva en Lingo.dev.
Un usuario asignado no aparece en Configuración → Equipo, en la pestaña Invitaciones.Espera al siguiente ciclo de aprovisionamiento o usa Aprovisionar a petición. Comprueba que la dirección mail del usuario pertenezca a un dominio conectado.

Para otros mensajes, consulta Solución de problemas.