En la Consola de Administración de Okta, Informes → Registro del Sistema le permite buscar eventos y descargar los resultados. Para JSON, use la API del Registro del Sistema: GET /api/v1/logs con since y until, siguiendo el siguiente enlace hasta que se agote. Un script corto está abajo. Okta conserva los eventos del Registro del Sistema durante 90 días.
Cuando la identidad es el perímetro, el Registro del Sistema de Okta es el registro de acceso. Registra cada inicio de sesión, cada impulso de MFA, cada restablecimiento de factor y cada cambio de rol de administrador. Prime Core tiene 58 reglas de detección para datos de Okta, mapeadas a 32 técnicas de MITRE ATT&CK. Entre ellas: rociado de contraseñas (T1110.003), fatiga MFA (T1621) y atacantes manipulando el registro de MFA (T1556.006).
Antes de comenzar
La retención es de 90 días. Cualquier cosa más antigua solo existe donde haya estado transmitiendo o reenviando registros de Okta, como un SIEM.
Necesita un token. Un token de API (Seguridad → API → Tokens) hereda los permisos del administrador que lo creó. Un administrador de solo lectura es suficiente para registros. Para cualquier cosa automatizada, una aplicación de servicio OAuth con el alcance okta.logs.read es la elección más limpia. De cualquier manera, el token es una credencial. Manténgalo fuera del historial de shell y révoquelo cuando haya terminado.
Se aplican límites de tasa. El punto final de los registros tiene su propio límite de tasa. Las ventanas grandes están bien, pero no instantáneas.
Exportar con la API del Registro del Sistema
Este script de Python recorre una ventana de tiempo y escribe un evento por línea. Necesita requests (pip install requests):
import json, os, requests
org = "https://yourorg.okta.com"
headers = {"Authorization": f"SSWS {os.environ['OKTA_TOKEN']}", "Accept": "application/json"}
url = f"{org}/api/v1/logs"
params = {"since": "2026-10-19T00:00:00Z", "until": "2026-10-20T00:00:00Z", "limit": 1000}
with open("okta_1019.jsonl", "w") as out:
while url:
r = requests.get(url, headers=headers, params=params, timeout=60)
r.raise_for_status()
events = r.json()
for e in events:
out.write(json.dumps(e) + "n")
if not events:
break
url = r.links.get("next", {}).get("url")
params = None # el siguiente enlace ya lleva la consulta
Siempre configure until. Sin él, Okta trata la solicitud como una encuesta en vivo y sigue devolviendo un siguiente enlace. Su bucle se ejecutaría para siempre, esperando nuevos eventos.
Para acotarlo, agregue un filtro a params, por ejemplo «filter»: ‘eventType eq «user.session.start»‘. O use «q»: «jane» para una búsqueda de palabras clave.
Qué buscar
| eventType | Por qué importa |
|---|---|
| user.session.start con outcome.result: FAILURE | Inicios de sesión fallidos; muchos usuarios desde un rango de IP significa rociado |
| user.mfa.okta_verify.deny_push | El usuario rechazó un empuje; una ráfaga de estos es fatiga de MFA en progreso |
| user.mfa.factor.deactivate, user.mfa.factor.reset_all | Factores eliminados, a menudo justo después de una llamada de ingeniería social al servicio de ayuda |
| user.account.privilege.grant | Rol de administrador concedido |
| policy.rule.update, policy.lifecycle.update | Política de inicio de sesión o MFA cambiada, posiblemente debilitada |
| system.api_token.create | Un nuevo token de API, una forma silenciosa de mantener el acceso |
Los campos que cuentan la historia: actor.alternateId (quién), client.ipAddress y client.geographicalContext (de dónde), outcome (qué sucedió) y debugContext.debugData (los detalles).
Subir, sanitizar y revisar en LogTotal
- Subir. Abrir logtotal.com y soltar el archivo .jsonl.
- Sanitizar.
- Revisar.
Cuando algo sale mal
| Síntoma | Causa probable | Fix |
|---|---|---|
| 401 | Token incorrecto o revocado, o falta el prefijo SSWS | Verifique el formato del encabezado; cree un nuevo token |
| 403 | El creador del token no tiene derechos para leer registros | Use un token de un administrador con acceso a registros |
| 429 | Se alcanzó el límite de tasa | Espere el tiempo en X-Rate-Limit-Reset, luego continúe |
| El script nunca termina | Sin until en la consulta | Configure until |
| Nada más antiguo que 90 días | Retención de Okta | Compruebe su SIEM o destino de transmisión de registros |
FAQ
¿No puedo simplemente usar la Consola de Administración?
Para una vista rápida de una ventana corta, sí. Para cualquier cosa que desee analizar o conservar, la API le brinda un JSON completo con cada campo.
¿Esto cubre Auth0?
No. Esta guía es sobre Okta Workforce Identity. Auth0 tiene su propio formato de registro y API.