Okta se conecta mediante OpenID Connect. Estos son los pasos en el orden que funcionó, con los nombres de Okta al lado de los de Tamaat. Los nombres de la consola de Okta se dan en inglés; su consola puede mostrarlos en otro idioma. Okta cambia su consola de vez en cuando; si una etiqueta difiere, busque la más parecida.
Antes de empezar
- Usted es administrador de la organización de Tamaat, en el plan Professional o en uno superior.
- Usted es administrador de la organización de Okta.
- Al menos un usuario de Okta está asignado a la aplicación que crea más abajo. Su dirección de correo coincide con la dirección con la que se lo invita a Tamaat.
- Para que su gente empiece desde su correo de trabajo, usted puede agregar un registro DNS al dominio de su correo. Es opcional; la "Dirección de inicio de sesión" funciona sin él.
- Para exigir más adelante el inicio de sesión único, el administrador que será la persona de recuperación tiene una contraseña de Tamaat y la autenticación en dos pasos.
1. Crear la aplicación en Okta
En la consola de administración de Okta, elija Applications → Applications → Create App Integration. Elija la Classic experience si Okta la ofrece junto al Okta Integration Wizard, después OIDC - OpenID Connect y Web Application, y luego Next.
| Opción de Okta | Valor |
|---|---|
| App integration name | Un nombre que reconozca, por ejemplo Tamaat |
| Client definition | Usar el ID de cliente que genera Okta |
| Require Demonstrating Proof of Possession (DPoP) | Desactivado |
| Authorization Code | Activado |
| Client Credentials | Desactivado |
| Refresh Token | Desactivado |
| Sign-in redirect URIs | Deje por ahora la dirección que sugiere Okta. La reemplaza en el paso 4. |
Allow wildcard * in sign-in redirect URI | Desactivado |
| Sign-out redirect URIs | Vacío |
| Trusted Origins / Base URIs | Vacío |
| Controlled access | Omita por ahora la asignación de grupos |
Guarde la aplicación. En su pestaña General, copie el Client ID y el Client secret. Tamaat se autentica con el secreto de cliente.
2. Asignar personas en Okta
Okta solo deja entrar a la aplicación a las personas asignadas.
- 1
Abra la pestaña Assignments de la aplicación y elija Assign → Assign to People.
- 2
Busque a la persona, elija Assign, luego Save and Go Back, y termine el cuadro de diálogo.
El cuadro de búsqueda de la página principal de Assignments busca entre las personas ya asignadas. Un resultado vacío no significa que la persona falte en Okta; use Assign to People para agregarla.
3. Agregar la conexión en Tamaat
- 1
Abra Configuración y elija Organización → Inicio de sesión único. En Conexión, elija "Agregar conexión".
- 2
En "Proveedor de identidad", elija Okta.
- 3
En "Desde Okta", complete:
- "Nombre de la conexión": lo que su gente verá cuando inicie sesión, por ejemplo el nombre de su empresa.
- "Emisor": la dirección de su organización de Okta, con la forma
https://<your-okta-organization>.okta.com. Use la dirección con la que su gente entra a Okta, sin la parte-adminde la dirección de administración y sin una ruta de activación o inscripción. El emisor que nos funcionó es esta dirección de la organización, no un servidor de autorización que termine en/oauth2/default; use ese solo si tiene un motivo y la prueba pasa. - "ID de cliente": copiado de la aplicación de Okta.
- "Secreto de cliente": copiado directamente de Okta. No lo vuelva a escribir.
- "Fecha de vencimiento del secreto (opcional)": déjela vacía, o escriba el día en que vence el secreto.
- 4
Deje vacíos los campos de grupos y de descubrimiento avanzado.
- 5
Elija "Guardar". El formulario dice "Guardado." y muestra un paso nuevo, "Copiar en Okta".
4. Poner la dirección de redirección en Okta
"Copiar en Okta" muestra dos direcciones, cada una con un botón "Copiar". Use los botones; no arme las direcciones a mano.
| Dirección | Para qué sirve |
|---|---|
| "URI de redirección" | Adonde Okta devuelve el navegador a Tamaat. Tiene la forma https://<tamaat-app-host>/api/auth/federation/<connection-id>/oidc/callback. Va en Okta. |
| "Dirección de inicio de sesión" | Inicia una sesión a través de esta conexión. Tiene la forma https://<tamaat-app-host>/api/auth/federation/<connection-id>/start. Es un enlace o marcador para su gente. No va en Okta. |
- 1
En Okta, abra la pestaña General de la aplicación y elija Edit en General Settings.
- 2
Reemplace la entrada de Sign-in redirect URIs por la "URI de redirección" de Tamaat. Deje Login initiated by en App Only. Guarde.
Hágalo antes de probar o iniciar sesión. La dirección que Okta sugirió al principio solo sirve para crear la aplicación; no es la de Tamaat, y no debe quedar ninguna al terminar.
5. Probar la conexión
- 1
En Tamaat, elija "Guardar y probar". Lo envían a Okta. Inicie sesión como una persona asignada.
- 2
Vuelve al resultado, que dice "La prueba no inició la sesión de nadie." Una prueba aprobada demuestra que Okta acepta la conexión y muestra lo que Okta envió. No inicia sesión a nadie en Tamaat ni vincula ninguna cuenta.
- 3
En "Aprobada", revise las líneas: "ID permanente recibido", "Correo electrónico recibido" y "Hora de inicio de sesión recibida" deberían estar todas. Con Okta, la prueba también informó la autenticación en dos pasos y un aviso de que las personas confirman su correo con un código la primera vez.
- 4
Elija "Activar la conexión". La conexión dice "Activa".
- 5
En Política de inicio de sesión, elija "Opcional": "Contraseña o inicio de sesión único".
6. Iniciar sesión una vez, en una ventana privada
Abra la "Dirección de inicio de sesión" en una ventana de navegación privada, para que ninguna sesión anterior estorbe, e inicie sesión a través de Okta.
Si la persona ya tiene una cuenta de Tamaat con la misma dirección de correo, Tamaat pregunta "¿Vincular tus cuentas?". Compruebe que las dos cuentas son de la persona y elija "Vincular cuentas". Las contraseñas siguen funcionando.
Cerrar la sesión de Tamaat no cierra la de Okta. Okta guarda su propia sesión, así que la próxima vez que Tamaat lo envíe allí puede volver enseguida sin ver una solicitud de contraseña. Cuánto dura eso, y cuándo vuelve a preguntar Okta, lo fijan sus políticas de Okta. Pruebe en una ventana privada, o cierre también la sesión de Okta, para ver el inicio de sesión completo.
7. Empezar desde un correo de trabajo (opcional)
Sin un dominio verificado, su gente usa la "Dirección de inicio de sesión". Si alguien escribe su correo de trabajo en Iniciar sesión con tu organización y ve "Usa la dirección de inicio de sesión que te dio tu organización.", el dominio todavía no está verificado. El inicio de sesión único opcional no está roto.
- 1
En Dominios, elija "Agregar dominio" y escriba solo el dominio, por ejemplo
example.com. - 2
Elija "Mostrar registro". Tamaat muestra un registro TXT:
Campo Valor Tipo TXTNombre _tamaat-sso.<your-domain>Valor tamaat-sso-verification=<generated-token>Publíquelo donde realmente se administra el DNS de su dominio. Es el proveedor de los servidores de nombres de su dominio, que no es necesariamente el de su sitio web o su correo. Algunas herramientas de DNS piden solo el nombre relativo,
_tamaat-sso; otras piden el nombre completo. Use el que pida la suya. - 3
Elija "Comprobar ahora" hasta que el dominio diga "Verificado". El DNS puede tardar, y algunos resolvedores conservan un tiempo una respuesta anterior de «no encontrado». Si no se verifica enseguida, espere y vuelva a comprobar.
Un dominio verificado envía a la gente a su inicio de sesión. No agrega miembros; se sigue entrando por invitación.
Las tres políticas
| Política | Qué pasó en nuestras pruebas |
|---|---|
| Opcional | Funcionaron las dos: una contraseña de Tamaat con su segundo paso, y Okta, incluso desde el correo de trabajo una vez verificado el dominio. |
| Obligatorio | La lista de preparación se completó tras un inicio de sesión real con Okta. Vea más abajo. |
| Desactivado | El inicio de sesión desde el correo de trabajo dejó de ofrecer la conexión. |
Cambiar un ajuste sensible
Cambiar la política, y los demás ajustes sensibles de esta sección, exige una prueba que solo Tamaat puede dar. Desde una sesión que abrió Okta, una contraseña sola no basta. Tamaat se lo dice: "El inicio de sesión de su organización abrió esta sesión, por lo que su contraseña por sí sola no puede confirmar este cambio. Cierre la sesión y vuelva a iniciarla con su contraseña y su segundo paso." Hágalo, vuelva a la configuración e inténtelo de nuevo. Mientras el cambio no aparezca como guardado, no se ha guardado. Active la autenticación en dos pasos en Cuenta → Seguridad e inicio de sesión antes de necesitarla.
Exigir Okta
Siga Exigir el inicio de sesión único. El orden que funcionó:
- Active la autenticación en dos pasos en la cuenta de Tamaat del administrador e inicie sesión con la contraseña y el segundo paso.
- Abra la lista de preparación y elija "Designarme persona de recuperación".
- Complete desde la lista un inicio de sesión real con Okta.
- Cuando todas las líneas digan "Listo", elija "Exigir inicio de sesión único", escriba el nombre de la organización y dé la confirmación que pide Tamaat.
La lista incluye una comprobación de que exigir el inicio de sesión único está disponible para su despliegue de Tamaat. Si dice "Pendiente", nada en Okta puede arreglarlo; contacte a quien opera su despliegue de Tamaat. Una vez exigido, una persona que inicia sesión con contraseña sigue sin poder abrir el trabajo de la organización hasta que continúe hacia Okta.
Si algo no funciona
| Lo que ve | Qué revisar |
|---|---|
| "El proveedor de identidad rechazó nuestra solicitud. Revisa el ID de cliente, el secreto de cliente y la URI de redirección." | La "URI de redirección" de Tamaat, exactamente, es el Sign-in redirect URI en Okta, y el ID de cliente y el secreto son de esta aplicación. |
| "El documento de descubrimiento del proveedor nombra otro emisor. Revisa la dirección del emisor." | El "Emisor" es https://<your-okta-organization>.okta.com, tal como la gente lo ve, no la dirección -admin. |
| Okta dice que la persona no está asignada | Asígnela en el paso 2. |
| "Usa la dirección de inicio de sesión que te dio tu organización." | El dominio no está verificado. Vea el paso 7, o use la "Dirección de inicio de sesión". |
Solucionar problemas del inicio de sesión único enumera todas las frases.