Configura SSO con Okta
Crea una aplicación SAML para Lingo.dev en Okta, asigna personas, conéctala a tu organización y aprovisiona miembros mediante SCIM.
Esta guía te muestra cómo conectar Okta con Lingo.dev mediante SAML 2.0. Necesitas una cuenta de administrador de Okta que permita crear integraciones de aplicaciones y debes tener el rol de Propietario en 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.
Mantén abierta la página Configuración → SSO en Lingo.dev. Desde ahí copiarás dos valores en Okta.
Crea la integración de la aplicación #
- Inicia sesión en la consola de administración de Okta.
- Ve a Aplicaciones → Aplicaciones (Aplicaciones y recursos → Aplicaciones en las consolas de administración más recientes) y selecciona Crear integración de aplicación.
- Elige SAML 2.0 y selecciona Siguiente.
- En Nombre de la aplicación, escribe
Lingo.dev. Selecciona Siguiente.
Configura SAML #
Completa estos campos y deja los demás con sus valores predeterminados:
| Campo de Okta | Valor |
|---|---|
| URL de inicio de sesión único | https://auth.lingo.dev/auth/v1/sso/saml/acs (la URL de ACS en Lingo.dev) |
| Usar esta URL como URL del destinatario y URL de destino | Seleccionado |
| URI de audiencia (ID de entidad del SP) | https://auth.lingo.dev/auth/v1/sso/saml/metadata (el ID de entidad en Lingo.dev) |
| RelayState predeterminado | Vacío |
| Formato del ID de nombre | Dirección de correo electrónico |
| Nombre de usuario de la aplicación | Correo electrónico |
En Declaraciones de atributos, agrega un atributo:
| Nombre | Formato del nombre | Valor |
|---|---|---|
email | Sin especificar | user.email |
Al configurar Formato del ID de nombre como Dirección de correo electrónico y agregar este atributo email, Okta envía la dirección de correo electrónico que necesita Lingo.dev.
Las organizaciones de Okta más recientes ya no muestran Declaraciones de atributos durante la creación de la aplicación. En ese caso, agrega el atributo después de seleccionar Finalizar: en la pestaña Inicio de sesión de la aplicación, busca la sección Declaraciones de atributos y selecciona Agregar expresión. Escribe email en Nombre y user.profile.email en Expresión. Luego selecciona Guardar.
Selecciona Siguiente. En el paso Comentarios, selecciona Soy cliente de Okta y voy a agregar una aplicación interna y luego Finalizar.
Copia la URL de metadatos #
En la pestaña Inicio de sesión de la aplicación, copia la URL de metadatos de la sección Detalles de metadatos. Su formato es similar a https://your-company.okta.com/app/exk.../sso/saml/metadata.
Asigna personas #
- Abre la pestaña Asignaciones de la aplicación.
- Selecciona Asignar y luego Asignar a personas o Asignar a grupos.
- Selecciona Asignar junto a cada persona o grupo y luego Listo.
Solo las personas asignadas pueden iniciar sesión en Lingo.dev a través de Okta.
Establece la conexión en Lingo.dev #
- Abre Configuración → SSO.
- Pega la URL de metadatos de Okta en URL de metadatos del proveedor de identidad.
- En Dominios de correo electrónico, escribe los dominios de correo electrónico de tu empresa, separados por comas.
- Selecciona Conectar.
Si se rechaza un dominio, consulta Reglas de dominio.
Prueba el inicio de sesión #
- Abre una ventana privada del navegador y ve a la página de inicio de sesión de Lingo.dev.
- Selecciona Continuar con SSO, escribe el correo electrónico de una persona asignada y selecciona Iniciar sesión.
- Inicia sesión en Okta.
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 Okta inició sesión, no necesariamente al correo electrónico que escribiste. Si el navegador ya tiene una sesión de Okta abierta, por ejemplo, la de quien configuró la aplicación, Okta continúa con esa cuenta. Si una persona con cuenta de administrador no está asignada a la aplicación, recibe el mensaje "El usuario no está asignado a esta aplicación". Por eso debes hacer la prueba en una ventana privada.
Inicia la prueba desde Lingo.dev. El mosaico de la aplicación SAML en el panel de Okta no inicia tu sesión: te lleva a la página de inicio de Lingo.dev, pero la sesión sigue cerrada. Para iniciar sesión desde el panel, agrega el marcador que se describe en Iniciar sesión desde el panel de Okta.
Cuando la prueba funcione, puedes exigir SSO. Primero, asigna el rol de Propietario a tu propia cuenta de SSO, como se describe en Activarlo.
Inicia sesión desde el panel de Okta #
Para que los miembros tengan un mosaico de Lingo.dev que les permita iniciar sesión, agrega una aplicación de marcador que abra el enlace de inicio de sesión desde el panel. Luego oculta el ícono de la aplicación SAML para que solo vean el marcador.
- En Lingo.dev, abre Configuración → SSO y copia el Enlace de inicio de sesión desde el panel. Su formato es similar a
https://lingo.dev/auth/sso?domain=example.com. - En la consola de administración de Okta, ve a Aplicaciones → Aplicaciones (Aplicaciones y recursos → Aplicaciones en las consolas de administración más recientes) y selecciona Explorar catálogo de aplicaciones.
- Busca y selecciona Aplicación de marcador. Luego selecciona Agregar integración.
- En Configuración general, escribe
Lingo.devcomo nombre y pega el enlace como URL. Deja desmarcada la opción No mostrar el ícono de la aplicación a los usuarios. Selecciona Listo. - En la pestaña Asignaciones del marcador, asigna las mismas personas o grupos que en la aplicación SAML.
- Abre la aplicación SAML de Lingo.dev. En la pestaña General, selecciona Editar en Configuración de la aplicación.
- En Visibilidad de la aplicación, selecciona No mostrar el ícono de la aplicación a los usuarios y No mostrar el ícono de la aplicación en la aplicación Okta Mobile. Selecciona Guardar.
Mantén a las personas asignadas a la aplicación SAML. La aplicación sigue permitiéndoles iniciar sesión; solo está oculta.
Ahora los miembros ven un solo mosaico de Lingo.dev. Al abrirlo, Lingo.dev los dirige a Okta y luego los recibe de vuelta con la sesión iniciada, sin pedirles un correo electrónico.
Aprovisiona miembros con SCIM #
Okta 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 saber cómo funciona SCIM en Lingo.dev, consulta Aprovisionar miembros con SCIM.
- En Lingo.dev, genera una clave de SCIM.
- En la consola de administración de Okta, abre la aplicación SAML de Lingo.dev. En la pestaña General, selecciona Editar en Configuración de la aplicación.
- Configura Aprovisionamiento como SCIM y selecciona Guardar. Aparecerá la pestaña Aprovisionamiento en la aplicación.
- En la pestaña Aprovisionamiento, abre Integración y selecciona Editar.
Completa estos campos:
| Campo de Okta | Valor |
|---|---|
| URL base del conector SCIM | https://api.lingo.dev/v2/scim (la URL base de SCIM en Lingo.dev) |
| Campo de identificador único de usuarios | userName |
| Acciones de aprovisionamiento compatibles | Enviar nuevos usuarios, Enviar actualizaciones de perfil y Enviar grupos. Deja desmarcadas las acciones de importación. Okta no importa usuarios ni grupos de Lingo.dev. |
| Modo de autenticación | Encabezado HTTP. Pega la clave de SCIM como token Bearer. |
Selecciona Probar configuración del conector. Cuando la prueba se complete correctamente, ciérrala y selecciona Guardar.
En la pestaña Aprovisionamiento, abre A la aplicación y selecciona Editar. Activa Crear usuarios, Actualizar atributos de usuario y Desactivar usuarios. Luego selecciona Guardar.
Okta no envía a ninguna persona a Lingo.dev hasta que guardes la opción Crear usuarios. A partir de ese momento, cada persona que asignes tendrá una invitación pendiente en Lingo.dev y se convertirá en miembro cuando inicie sesión con SSO por primera vez.
Cuando quitas la asignación de una persona o la desactivas en Okta, Okta también la desactiva en Lingo.dev, por lo que deja de ser miembro de la organización. Consulta Eliminar personas.
Asigna roles con grupos de Okta #
- Asegúrate de que el grupo de Okta tenga el mismo nombre que un rol de Lingo.dev, como
Translator. - En la pestaña Enviar grupos de la aplicación, selecciona Enviar grupos y luego Buscar grupos por nombre.
- Busca el grupo y selecciona Guardar.
Envía un grupo distinto del que usas para asignar la aplicación. Okta no permite usar el mismo grupo para ambas funciones. Okta solo envía a los miembros que están asignados a la aplicación, así que asigna a todas las personas del grupo que envíes, ya sea directamente o mediante otro grupo.
Okta vincula el grupo con el rol del mismo nombre. Sus miembros reciben ese rol y las personas que quitas del grupo lo pierden. Si no existe un rol con el nombre del grupo, el envío muestra un error con el mensaje "No hay ningún rol llamado". Crea el rol en Lingo.dev y vuelve a enviar el grupo.
Si dejas de enviar un grupo y Okta pregunta si quieres eliminarlo de la aplicación, la opción Eliminar les quita el rol a sus miembros. El rol permanece en Lingo.dev.
Solución de problemas #
| Problema | Solución |
|---|---|
| Lingo.dev muestra "El inicio de sesión único no se completó" después de iniciar sesión en Okta. | Revisa URI de audiencia (ID de entidad del SP) y URL de inicio de sesión único. Deben coincidir exactamente con el ID de entidad y la URL de ACS de Lingo.dev, sin una barra al final. |
| Lingo.dev muestra "Tu proveedor de identidad no envió una dirección de correo electrónico". | Configura Formato del ID de nombre como Dirección de correo electrónico y Nombre de usuario de la aplicación como Correo electrónico. Agrega también la declaración de atributo email: user.email en el asistente de configuración o user.profile.email en la pestaña Inicio de sesión. |
| Okta indica que no tienes la aplicación asignada. | Asigna a la persona o a un grupo al que pertenezca en la pestaña Asignaciones. Si escribiste el correo electrónico de una persona asignada, pero Okta muestra tu cuenta de administrador, el navegador conservó tu sesión de Okta. Cierra sesión en Okta o usa una ventana privada. |
| Lingo.dev muestra "El inicio de sesión único tardó demasiado en completarse. Inténtalo de nuevo." | El inicio de sesión en Okta tardó más de unos 5 minutos, por ejemplo, durante la configuración inicial de la autenticación multifactor. Inténtalo de nuevo desde Lingo.dev. El siguiente intento funcionará. |
| Lingo.dev muestra "Iniciaste sesión, pero no pudimos agregarte a tu organización." | Vuelve a iniciar sesión con SSO. Si el problema persiste, pídele a alguien con el rol de Propietario que compruebe que Configuración → SSO muestre Conectado desde. |
| Lingo.dev muestra "El inicio de sesión único no está configurado para" tu dominio. | Agrega el dominio en Configuración → SSO o revisa el correo electrónico que escribiste. |
La prueba Probar configuración del conector o el aprovisionamiento falla con 401 Unauthorized. | La clave de SCIM se rotó o se revocó. Pega la clave actual en Integración o genera una nueva en Lingo.dev. |
| Una persona asignada en Okta no aparece en Configuración → Equipo, en la pestaña Invitaciones. | Comprueba que Crear usuarios esté activado en A la aplicación. Para las personas asignadas antes de guardar esta opción, abre la lista de tareas de aprovisionamiento de Okta y vuelve a ejecutar las tareas correspondientes. |
Para otros mensajes, consulta Solución de problemas.