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 muestra cómo 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 conocer cómo funciona SSO en Lingo.dev, consulta Inicio de sesión único.

Mantén abierta la página Configuración → SSO en Lingo.dev. De ahí copiarás dos valores 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 encuentres 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 Agregar identificador y pega https://auth.lingo.dev/auth/v1/sso/saml/metadata (el ID de entidad en Lingo.dev).
  4. En URL de respuesta (URL del servicio de consumidor de aserciones), selecciona Agregar URL de respuesta y pega https://auth.lingo.dev/auth/v1/sso/saml/acs (la URL de ACS en Lingo.dev).
  5. Por ahora, deja vacíos URL de inicio de sesión, Estado de retransmisión y URL de cierre de sesión. Selecciona Guardar. Configurarás URL de inicio de sesión después de establecer la conexión, en Iniciar sesión desde Mis aplicaciones de Microsoft.

Conserva los Atributos & notificaciones predeterminados. 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 ID de nombre con formato de correo electrónico. Asegúrate de que cada usuario que inicie sesión tenga 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 una dirección de correo electrónico. En ese caso, el inicio de sesión falla con el mensaje "Tu proveedor de identidad no envió una dirección de correo electrónico." En Atributos & notificaciones, agrega 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 Agregar usuario o grupo.
  2. En Usuarios y grupos, selecciona Ninguno seleccionado, elige los usuarios o grupos y selecciona 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 a través de Entra. Si está en No, cualquier usuario de tu inquilino puede acceder a la aplicación, incluidas las cuentas de invitado. Lingo.dev solo permite que se unan las cuentas de tus dominios conectados; vuelve a cerrar la sesión de cualquier otra cuenta. Las aplicaciones creadas mediante la API de Microsoft Graph tienen No como valor inicial. Asignar grupos requiere Microsoft Entra ID P1 o P2. En el plan gratuito, asigna los usuarios uno por 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. Revisa el correo electrónico que aparece en la página de organizaciones: corresponde a la cuenta con la que Microsoft inició sesión, no necesariamente al correo que escribiste. Si el navegador ya tiene una sesión de Microsoft abierta, por ejemplo, con la cuenta del administrador 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, no desde el botón Probar de Entra. Hasta que configures la URL de inicio de sesión, el mosaico de Lingo.dev en Mis aplicaciones de Microsoft no iniciará tu sesión: te llevará a la página de inicio de Lingo.dev, todavía sin una sesión abierta.

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 tardó demasiado en completarse. Inténtalo de nuevo." Al volver a intentarlo, funciona.

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

Iniciar sesión desde Mis aplicaciones de Microsoft #

Configura la URL de inicio de sesión para que el mosaico 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. Tiene un formato similar a 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 mosaico de Lingo.dev en Mis aplicaciones abre el enlace. Lingo.dev dirige al usuario a Microsoft y luego lo lleva de vuelta con la sesión iniciada, sin pedirle un correo electrónico.

Aprovisionar miembros con SCIM #

Entra puede administrar los miembros de Lingo.dev mediante SCIM y asignarles roles a través de grupos. Primero configura SSO siguiendo esta guía. Para conocer 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 luego Guardar.
  6. Conserva las asignaciones de atributos predeterminadas. Lingo.dev toma userName de userPrincipalName y el correo electrónico de 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 cada usuario que asignes debe tener una dirección en un dominio conectado. No hay problema si userPrincipalName es diferente de mail.

Cada usuario que asignes recibe una invitación pendiente en Lingo.dev y se convierte en miembro la primera vez que inicia sesión con SSO.

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

Cuando quitas la asignación de un usuario, Entra envía una desactivación, no una eliminación, y Lingo.dev lo retira de la organización. 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, quienes reciben ese rol. Las personas que retires del grupo pierden el rol. Si el grupo era la única asignación de un usuario, retirarlo del grupo también lo retira de Lingo.dev.

Solución de problemas #

ProblemaSolución
Microsoft muestra AADSTS700016: "No se encontró 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.En Usuarios y grupos, asigna al usuario o a un grupo al que pertenezca.
Una persona sin asignación inició sesión, o Lingo.dev muestra un correo electrónico que no escribiste.¿Se requiere asignación? está en No, o el navegador ya tenía una sesión de Microsoft abierta 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 usa para el inicio de sesión único.Microsoft inició sesión con una cuenta que no pertenece a tus dominios conectados, a menudo una cuenta de invitado o la del administrador que creó el inquilino. Inicia sesión con una cuenta de trabajo o agrega su dominio en Configuración → SSO.
Lingo.dev muestra "Tu proveedor de identidad no envió una dirección de correo electrónico".La aplicación no envía una notificación de correo electrónico, o el usuario no tiene una dirección de correo electrónico en Entra. Agrega la notificación de correo electrónico (user.mail) en Atributos & notificaciones y configura el correo electrónico del usuario.
Lingo.dev muestra "El inicio de sesión único tardó demasiado en completarse. Inténtalo de nuevo."El inicio de sesión con Microsoft tardó 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 "Iniciaste sesión, pero no pudimos agregarte a tu organización."Vuelve a iniciar sesión con SSO. Si sigue fallando, pide a un Propietario que verifique que Configuración → SSO muestre Conectado desde.
Lingo.dev muestra "El inicio de sesión único no se completó".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 rotó o se revocó. 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. Verifica que el mail del usuario pertenezca a un dominio conectado.

Para otros mensajes, consulta Solución de problemas.