Cómo Exportar Registros del Sistema de Okta

Cómo Exportar Registros del Sistema de Okta

SOC Prime Team
SOC Prime Team linkedin icon Seguir

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).

Comience gratis

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

eventTypePor qué importa
user.session.start con outcome.result: FAILUREInicios de sesión fallidos; muchos usuarios desde un rango de IP significa rociado
user.mfa.okta_verify.deny_pushEl usuario rechazó un empuje; una ráfaga de estos es fatiga de MFA en progreso
user.mfa.factor.deactivate, user.mfa.factor.reset_allFactores eliminados, a menudo justo después de una llamada de ingeniería social al servicio de ayuda
user.account.privilege.grantRol de administrador concedido
policy.rule.update, policy.lifecycle.updatePolítica de inicio de sesión o MFA cambiada, posiblemente debilitada
system.api_token.createUn 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

  1. Subir. Abrir logtotal.com y soltar el archivo .jsonl.
  2. Sanitizar.
  3. Revisar.

Cuando algo sale mal

SíntomaCausa probableFix
401Token incorrecto o revocado, o falta el prefijo SSWS  Verifique el formato del encabezado; cree un nuevo token
403El creador del token no tiene derechos para leer registrosUse un token de un administrador con acceso a registros
429Se alcanzó el límite de tasaEspere el tiempo en X-Rate-Limit-Reset, luego continúe
El script nunca terminaSin until en la consultaConfigure until
Nada más antiguo que 90 díasRetención de OktaCompruebe 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.

Únete a la plataforma Detection as Code de SOC Prime para mejorar la visibilidad de las amenazas más relevantes para tu negocio. Para ayudarte a comenzar y obtener valor inmediato, programa una reunión ahora con los expertos de SOC Prime.