Configurar 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.
En esta guía aprenderás a conectar Okta con Lingo.dev mediante SAML 2.0. Necesitas una cuenta de administración de Okta que permita crear integraciones de aplicaciones y 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.
Deja abierta la sección Configuración → SSO en Lingo.dev. Tendrás que copiar dos de sus valores en Okta.
Crear 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.
Configurar SAML #
Rellena 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 de ID de nombre | Dirección de correo electrónico |
| Nombre de usuario de la aplicación | Correo electrónico |
En Declaraciones de atributos, añade un atributo:
| Nombre | Formato del nombre | Valor |
|---|---|---|
email | Sin especificar | user.email |
Al establecer Formato de ID de nombre en Dirección de correo electrónico y añadir este atributo email, Okta envía la dirección de correo electrónico que necesita Lingo.dev.
En las organizaciones de Okta más recientes, Declaraciones de atributos ya no aparece durante la creación de la aplicación. En ese caso, añade el atributo después de seleccionar Finalizar: en la pestaña Inicio de sesión de la aplicación, ve a la sección Declaraciones de atributos y selecciona Añadir expresión. Escribe email en Nombre y user.profile.email en Expresión y, después, selecciona Guardar.
Selecciona Siguiente. En el paso Comentarios, elige Soy cliente de Okta y estoy añadiendo una aplicación interna y selecciona Finalizar.
Copiar 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 los metadatos. Tendrá un formato similar a https://your-company.okta.com/app/exk.../sso/saml/metadata.
Asignar personas #
- Abre la pestaña Asignaciones de la aplicación.
- Selecciona Asignar y, después, Asignar a personas o Asignar a grupos.
- Selecciona Asignar junto a cada persona o grupo y, después, Listo.
Solo las personas asignadas pueden iniciar sesión en Lingo.dev a través de Okta.
Conectar 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.
Probar 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. Comprueba el correo electrónico que aparece en la página de organizaciones: corresponde a la cuenta con la que Okta ha iniciado sesión, que no tiene por qué coincidir con el correo que has escrito. Si ya hay una sesión de Okta abierta en el navegador, por ejemplo, la de la cuenta de administración con la que se configuró la aplicación, Okta continuará con esa cuenta. Si esa cuenta de administración no está asignada a la aplicación, aparecerá 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 acceso directo de la propia aplicación SAML en el panel de Okta no inicia sesión: te lleva a la página de inicio de Lingo.dev, pero la sesión sigue sin iniciarse. Para iniciar sesión desde el panel, añade el marcador que se describe en Iniciar sesión desde el panel de Okta.
Cuando la prueba funcione, podrás hacer obligatorio el uso de SSO. Primero, asigna a tu propia cuenta de SSO el rol de propietario, como se describe en Activarlo.
Iniciar sesión desde el panel de Okta #
Para que los miembros dispongan de un acceso directo a Lingo.dev que inicie su sesión, añade una aplicación de marcadores que abra el enlace de inicio de sesión del panel. Después, oculta el icono de la propia aplicación SAML para que solo vean el marcador.
- En Lingo.dev, abre Configuración → SSO y copia Enlace de inicio de sesión del panel. Tendrá un formato 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 el catálogo de aplicaciones.
- Busca y selecciona Aplicación de marcadores y, después, selecciona Añadir integración.
- En Configuración general, escribe
Lingo.devcomo nombre y pega el enlace como URL. Deja desmarcada la opción No mostrar el icono 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, marca No mostrar el icono de la aplicación a los usuarios y No mostrar el icono de la aplicación en la aplicación móvil de Okta. Selecciona Guardar.
Mantén a las personas asignadas a la aplicación SAML. La aplicación sigue iniciando sus sesiones; solo está oculta.
Ahora los miembros verán un único acceso directo a Lingo.dev. Al abrirlo, accederán a Lingo.dev, que les redirigirá a Okta y de vuelta con la sesión iniciada, sin pedirles el correo electrónico.
Aprovisionar miembros con SCIM #
Okta puede gestionar los miembros de Lingo.dev mediante SCIM y asignarles roles a través de grupos. Antes, 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 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.
- Establece Aprovisionamiento en SCIM y selecciona Guardar. Aparecerá la pestaña Aprovisionamiento en la aplicación.
- En la pestaña Aprovisionamiento, abre Integración y selecciona Editar.
Rellena 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 para usuarios | userName |
| Acciones de aprovisionamiento admitidas | Enviar nuevos usuarios, Enviar actualizaciones de perfiles y Enviar grupos. Deja desmarcadas las acciones de importación. Okta no importa usuarios ni grupos de Lingo.dev. |
| Modo de autenticación | Cabecera HTTP. Pega la clave SCIM como token Bearer. |
Selecciona Probar la 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 y, después, selecciona Guardar.
Okta no enví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 la primera vez que inicie sesión con SSO.
Cuando quitas la asignación de una persona o la desactivas en Okta, Okta también la desactiva en Lingo.dev, de modo que deja de pertenecer a la organización. Consulta Eliminar personas.
Asignar 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, después, 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. Como Okta solo envía miembros que estén asignados a la aplicación, asigna a todas las personas del grupo que envíes, ya sea directamente o a través de otro grupo.
Okta vincula el grupo al rol del mismo nombre. Sus miembros reciben ese rol y las personas que quites del grupo lo pierden. Si no hay ningún rol con el nombre del grupo, el envío mostrará un error con el texto "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 te pregunta si quieres eliminarlo de la aplicación, la opción Eliminar quita el rol a sus miembros. El rol se conserva en Lingo.dev.
Solución de problemas #
| Problema | Solución |
|---|---|
| Lingo.dev muestra "El inicio de sesión único no se ha completado" después de iniciar sesión en Okta. | Comprueba 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 barra al final. |
| Lingo.dev muestra "Tu proveedor de identidad no ha enviado una dirección de correo electrónico". | Establece Formato de ID de nombre en Dirección de correo electrónico y Nombre de usuario de la aplicación en Correo electrónico, y añade la declaración del 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 asignada la aplicación. | Asigna a la persona, o a un grupo al que pertenezca, en la pestaña Asignaciones. Si has escrito el correo electrónico de una persona asignada, pero Okta muestra tu cuenta de administración, el navegador ha conservado tu sesión de Okta. Cierra la sesión de Okta o usa una ventana privada. |
| Lingo.dev muestra "El inicio de sesión único ha tardado demasiado en completarse. Inténtalo de nuevo." | El inicio de sesión en Okta ha tardado más de unos 5 minutos, por ejemplo, durante la configuración inicial de la autenticación multifactor. Vuelve a intentarlo desde Lingo.dev. El siguiente intento funcionará. |
| 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 alguien con el rol de propietario que compruebe que en Configuración → SSO aparece Conectado desde. |
| Lingo.dev muestra "El inicio de sesión único no está configurado para" tu dominio. | Añade el dominio en Configuración → SSO o comprueba el correo electrónico que has escrito. |
La prueba Probar la configuración del conector o el aprovisionamiento falla con 401 Unauthorized. | La clave SCIM se ha renovado o revocado. Pega la clave actual en Integración o genera una nueva en Lingo.dev. |
| Una persona asignada en Okta no aparece en la pestaña Invitaciones de Configuración → Equipo. | Comprueba que Crear usuarios esté activado en A la aplicación. En el caso de las personas asignadas antes de guardar esa opción, abre la lista de tareas de aprovisionamiento de Okta y vuelve a intentar procesarlas. |
Para otros mensajes, consulta Solución de problemas.