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).
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
| eventType | Perché è importante |
|---|---|
| user.session.start con outcome.result: FAILURE | Accessi falliti; molti utenti da un intervallo di IP significa spraying |
| user.mfa.okta_verify.deny_push | Utente ha rifiutato un push; un’esplosione di questi è l’affaticamento MFA in corso |
| user.mfa.factor.deactivate, user.mfa.factor.reset_all | Fattori rimossi, spesso subito dopo una chiamata di ingegneria sociale all’helpdesk |
| user.account.privilege.grant | Ruolo amministratore concesso |
| policy.rule.update, policy.lifecycle.update | Politica di accesso o MFA modificata, possibilmente indebolita |
| system.api_token.create | Un 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
- Carica. Apri logtotal.com e inserisci il file .jsonl.
- Sanitizza.
- Rivedi.
Quando va storto
| Sintomo | Causa probabile | Fix |
|---|---|---|
| 401 | Token errato o revocato, o un prefisso SSWS mancante | Controlla il formato dell’header; crea un nuovo token |
| 403 | Il creatore del token non ha i diritti per leggere i log | Usa un token da un amministratore con accesso ai log |
| 429 | Limite di velocità raggiunto | Attendi il tempo in X-Rate-Limit-Reset, poi continua |
| Lo script non finisce mai | Nessun until nella query | Imposta until |
| Nulla di più vecchio di 90 giorni | Conservazione di Okta | Controlla 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.