In der Okta Admin-Konsole, Berichte → Systemprotokoll ermöglicht es Ihnen, Ereignisse zu durchsuchen und die Ergebnisse herunterzuladen. Für JSON nutzen Sie die System Log API: GET /api/v1/logs mit since und until, dem nächsten Link folgend, bis dieser endet. Ein kurzes Script ist unten aufgeführt. Okta speichert System Log-Ereignisse 90 Tage lang.
Wenn Identität der Perimeter ist, ist Okta’s Systemprotokoll das Zugangstor-Protokoll. Es zeichnet jedes Anmelden, jeden MFA-Push, jeden Faktor-Reset und jede Admin-Rollenänderung auf. Prime Core hat 58 Erkennungsregeln für Okta-Daten, die 32 MITRE ATT&CK-Techniken zugeordnet sind. Darunter: Passwort-Spraying (T1110.003), MFA-Müdigkeit (T1621) und Angreifer, die MFA-Einschreibungen manipulieren (T1556.006).
Bevor Sie beginnen
Die Aufbewahrung beträgt 90 Tage. Alles, was älter ist, existiert nur da, wo Sie Okta-Protokolle gestreamt oder weitergeleitet haben, z. B. an ein SIEM.
Sie benötigen ein Token. Ein API-Token (Sicherheit → API → Tokens) erbt die Berechtigungen des Admins, der es erstellt hat. Ein schreibgeschützter Admin genügt für Protokolle. Für alles Automatisierte ist eine OAuth-Dienst-App mit dem okta.logs.read-Scope die sauberere Wahl. In jedem Fall ist das Token eine Anmeldeinformation. Halten Sie es aus der Shell-Historie fern und widerrufen Sie es, wenn Sie fertig sind.
Ratenbeschränkungen gelten. Der Protokoll-Endpunkt hat seine eigene Ratenbegrenzung. Große Fenster sind in Ordnung, nur nicht sofort.
Exportieren mit der System Log API
Dieses Python-Skript durchläuft ein Zeitfenster und schreibt ein Ereignis pro Zeile. Es benötigt 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 # der nächste Link enthält bereits die Abfrage
Immer setzen bis. Ohne das behandelt Okta die Anfrage als Live-Abfrage und gibt immer wieder einen nächsten Link zurück. Ihre Schleife würde endlos laufen und auf neue Ereignisse warten.
Um es einzugrenzen, fügen Sie einen Filter zu params hinzu, zum Beispiel „filter“: ‚eventType eq „user.session.start“‚. Oder verwenden Sie „q“: „jane“ für eine Stichwortsuche.
Worauf zu achten ist
| eventType | Warum es wichtig ist |
|---|---|
| user.session.start mit outcome.result: FAILURE | Fehlgeschlagene Anmeldungen; viele Benutzer aus einem IP-Bereich bedeutet Spraying |
| user.mfa.okta_verify.deny_push | Benutzer hat Push abgelehnt; ein Schwall davon ist laufende MFA-Müdigkeit |
| user.mfa.factor.deactivate, user.mfa.factor.reset_all | Faktoren entfernt, oft direkt nach einem Social-Engineering-Anruf am Helpdesk |
| user.account.privilege.grant | Admin-Rolle gewährt |
| policy.rule.update, policy.lifecycle.update | Anmelde- oder MFA-Richtlinie geändert, möglicherweise geschwächt |
| system.api_token.create | Ein neues API-Token, eine leise Methode, um Zugang zu behalten |
Die Felder, die die Geschichte erzählen: actor.alternateId (wer), client.ipAddress und client.geographicalContext (von woher), outcome (was passiert ist) und debugContext.debugData (die Details).
Hochladen, bereinigen und überprüfen in LogTotal
- Hochladen. Öffnen logtotal.com und die .jsonl-Datei ablegen.
- Bereinigen.
- Überprüfen.
Wenn es schiefgeht
| Symptom | Wahrscheinliche Ursache | Fix |
|---|---|---|
| 401 | Falsches oder widerrufenes Token oder fehlendes SSWS Präfix | Überprüfen Sie das Header-Format; erstellen Sie ein neues Token |
| 403 | Token-Ersteller hat keine Rechte zum Lesen von Protokollen | Verwenden Sie ein Token von einem Admin mit Protokollzugriff |
| 429 | Ratenbeschränkungsgrenze erreicht | Warten Sie auf die Zeit in X-Rate-Limit-Reset, dann fortfahren |
| Das Skript endet nie | Kein „bis“ in der Abfrage | Setzen Sie ein „bis“ |
| Nichts älter als 90 Tage | Okta-Aufbewahrung | Überprüfen Sie Ihr SIEM oder das Log-Streaming-Ziel |
FAQ
Kann ich nicht einfach die Admin-Konsole nutzen?
Für einen schnellen Blick auf ein kurzes Fenster, ja. Für alles, das Sie analysieren oder behalten möchten, gibt Ihnen die API vollständiges JSON mit jedem Feld.
Deckt dies Auth0 ab?
Nein. Diese Anleitung bezieht sich auf Okta Workforce Identity. Auth0 hat sein eigenes Protokollformat und API.