Skip to main content

Acerca de Okta

El conector de Okta lee los datos del directorio, la pertenencia a grupos, las asignaciones de aplicaciones, las políticas, la postura de MFA y las señales relacionadas con auditoría de tu organización de Okta, y los muestra como artefactos en Iru Compliance. La autenticación usa un token de API de Okta sobre la Okta Management API. La integración está pensada para la recopilación de evidencia de solo lectura. Iru no aprovisiona usuarios ni cambia políticas en Okta más allá de lo que permiten los permisos de administrador de tu token durante las lecturas de la API.

Cómo funciona

Okta acepta tokens de API mediante el esquema SSWS:
Los tokens heredan los permisos del administrador que los creó. Los tokens que no se usan caducan después de 30 días; las llamadas a la API correctas renuevan ese período. El conector de Iru recorre las URL de servidor de tu tenant (producción, EMEA, Gov, vista previa o dominio personalizado) y, a continuación, solicita tu token de API en el último paso. Los pasos anteriores del asistente alinean las URL relacionadas con OAuth donde el producto las espera; la autenticación con token SSWS es lo que autoriza las llamadas a la Management API para esta fuente. Documentación: Crear un token de API, Administración de tokens de API, Límites de velocidad.

Requisitos previos

  • Un rol de administrador de Okta que pueda crear tokens de API (Super Admin, Administrador de la organización o Read-only Admin, según lo que tu organización permita para las cuentas de automatización).
  • El subdominio o el dominio de Okta completo de tu organización (por ejemplo, acme si los usuarios inician sesión en https://acme.okta.com).

Conectar Okta a Iru

Completa esta pestaña antes de conectar la fuente en Compliance.
1

Inicia sesión en la Okta Admin Console

Abre la URL de administración de tu organización (por ejemplo, https://YOUR_SUBDOMAIN.okta.com/admin) e inicia sesión con un rol que pueda crear tokens de API (Super Admin, Administrador de la organización o Read-only Admin, según lo que tu organización permita para las cuentas de automatización).
2

Abre Security

En la navegación izquierda, expande Seguridad (o busca API en la barra de búsqueda de administración).
3

Abre la administración de tokens de API

Elige API → Tokens para abrir la lista de tokens existentes y Crear token.
4

Crea un token nuevo

Selecciona Crear token, introduce un nombre que reconozcas (por ejemplo, Iru Compliance) y confirma la creación para que Okta pueda mostrar el secreto una vez.
5

Copia el token de inmediato

Copia el valor del token antes de cerrar el cuadro de diálogo. No podrás volver a verlo después de salir de la página. Guárdalo en un almacén de secretos hasta que lo pegues en Iru.Ten en cuenta la caducidad por inactividad: si ninguna llamada a la API correcta usa el token durante 30 días, Okta lo invalida y debes crear un token nuevo.
6

Restricciones de red opcionales

Si tu entorno usa IP de salida fijas, puedes asociar opcionalmente una política de network zone al token según la documentación de Okta.
Continúa en la pestaña Iru Compliance.

Solución de problemas

Revisa la configuración del bloqueador de ventanas emergentes para el sitio de Iru e inténtalo de nuevo.
Verifica la cadena del token, que la cuenta de administrador siga activa y que el token no se haya revocado.
Vuelve a crear el token en Seguridad → API → Tokens si ha estado inactivo durante 30 días.
Es posible que el perfil de administrador vinculado al token no tenga acceso de lectura a algunos endpoints. Confirma que tenga al menos Read-only Admin (o equivalente) para la evidencia que necesitas.
Desconecta y vuelve a conectar, comprobando bien el subdominio y la región (EE. UU., EMEA, Gov o vista previa).

Consideraciones

Trata los tokens de API como credenciales

Trata los tokens de API como credenciales. Es preferible una cuenta de servicio con el rol de administrador mínimo que siga cumpliendo los requisitos de evidencia.

Okta aplica límites de velocidad al tráfico de la Management API;…

Okta aplica límites de velocidad al tráfico de la Management API; en las organizaciones grandes, la sincronización puede tardar más durante la primera recopilación.

Iru lee los datos expuestos por las API a las que tu token puede…

Iru lee los datos expuestos por las API a las que tu token puede acceder; no puede anular los permisos de Okta que no concedas.

Artículos relacionados

Gestión de fuentes

Explora y gestiona todas las fuentes de Compliance.

Introducción a Compliance

Marcos, acciones y Artefactos.

Descripción general de Iru

Cómo encajan Endpoint, Compliance e Identity.

Gestión de artefactos

Sube, revisa y organiza la evidencia de fuentes y acciones.