Come Esportare i Log di Sistema di Okta

Come Esportare i Log di Sistema di Okta

SOC Prime Team
SOC Prime Team linkedin icon Segui

Nella Console di Amministrazione di Okta, Report → Registro di Sistema ti permette di cercare eventi e scaricare i risultati. Per JSON, usa l’API del Registro di Sistema: GET /api/v1/logs con since e until, seguendo il link successivo finché non si esaurisce. Qui sotto c’è un breve script. Okta conserva gli eventi del Registro di Sistema per 90 giorni.

Quando l’identità è il perimetro, il Registro di Sistema di Okta è il registro di accesso. Registra ogni accesso, ogni push MFA, ogni reset di fattore e ogni cambiamento di ruolo amministrativo. Prime Core ha 58 regole di rilevamento per i dati di Okta, mappate a 32 tecniche MITRE ATT&CK. Tra queste: password spraying (T1110.003), affaticamento MFA (T1621) e intrusori che manomettono l’iscrizione MFA (T1556.006).

Inizia Gratis

Prima di iniziare

La conservazione è di 90 giorni. Qualsiasi cosa più vecchia esiste solo dove hai trasmesso o inoltrato i log di Okta, come un SIEM.

Hai bisogno di un token. Un token API (Sicurezza → API → Token) eredita i permessi dell’amministratore che lo ha creato. Un admin in sola lettura è sufficiente per i log. Per qualsiasi cosa automatizzata, un’app di servizio OAuth con l’ambito okta.logs.read è la scelta più pulita. In ogni caso, il token è una credenziale. Mantienilo fuori dalla cronologia della shell e revocalo quando hai finito.

Si applicano i limiti di velocità. L’endpoint dei log ha il suo limite di velocità. Finestre grandi vanno bene, solo non istantanee.

Esporta con l’API del Registro di Sistema

Questo script Python attraversa una finestra temporale e scrive un evento per riga. Necessita di requests (pip install requests):

importa 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  # il link successivo contiene già la query

Imposta sempre until. Senza di esso, Okta tratta la richiesta come una ricerca in diretta e continua a restituire un link successivo. Il tuo ciclo continuerebbe all’infinito, aspettando nuovi eventi.

Per restringerlo, aggiungi un filtro a params, ad esempio “filter”: ‘eventType eq “user.session.start”‘. Oppure usa “q”: “jane” per una ricerca per parola chiave.

Cosa cercare

eventTypePerché è importante
user.session.start con outcome.result: FAILUREAccessi falliti; molti utenti da un intervallo di IP significa spraying
user.mfa.okta_verify.deny_pushUtente ha rifiutato un push; un’esplosione di questi è l’affaticamento MFA in corso
user.mfa.factor.deactivate, user.mfa.factor.reset_allFattori rimossi, spesso subito dopo una chiamata di ingegneria sociale all’helpdesk
user.account.privilege.grantRuolo amministratore concesso
policy.rule.update, policy.lifecycle.updatePolitica di accesso o MFA modificata, possibilmente indebolita
system.api_token.createUn nuovo token API, un modo silenzioso per mantenere l’accesso

I campi che raccontano la storia: actor.alternateId (chi), client.ipAddress e client.geographicalContext (da dove), outcome (cosa è successo), e debugContext.debugData (i dettagli).

Carica, sanitizza e rivedi in LogTotal

  1. Carica. Apri logtotal.com e inserisci il file .jsonl.
  2. Sanitizza.
  3. Rivedi.

Quando va storto

SintomoCausa probabileFix
401Token errato o revocato, o un prefisso SSWS mancanteControlla il formato dell’header; crea un nuovo token
403Il creatore del token non ha i diritti per leggere i logUsa un token da un amministratore con accesso ai log
429Limite di velocità raggiuntoAttendi il tempo in X-Rate-Limit-Reset, poi continua
Lo script non finisce maiNessun until nella queryImposta until
Nulla di più vecchio di 90 giorniConservazione di OktaControlla il tuo SIEM o destinazione di streaming log

FAQ

Non posso semplicemente usare la Console di Amministrazione?

Per una rapida occhiata a una finestra breve, sì. Per qualsiasi cosa tu voglia analizzare o conservare, l’API ti offre un JSON completo con ogni campo.

Questo copre Auth0?

No. Questa guida riguarda Okta Workforce Identity. Auth0 ha il suo formato di log e API.

Unisciti alla piattaforma Detection as Code di SOC Prime per migliorare la visibilità sulle minacce più rilevanti per il tuo business. Per aiutarti a iniziare e aumentare immediatamente il valore, prenota ora un incontro con gli esperti di SOC Prime.