So exportieren Sie Okta-Systemprotokolle

So exportieren Sie Okta-Systemprotokolle

SOC Prime Team
SOC Prime Team linkedin icon Folgen

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

Jetzt kostenlos starten

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

eventTypeWarum es wichtig ist
user.session.start mit outcome.result: FAILUREFehlgeschlagene Anmeldungen; viele Benutzer aus einem IP-Bereich bedeutet Spraying
user.mfa.okta_verify.deny_pushBenutzer hat Push abgelehnt; ein Schwall davon ist laufende MFA-Müdigkeit
user.mfa.factor.deactivate, user.mfa.factor.reset_allFaktoren entfernt, oft direkt nach einem Social-Engineering-Anruf am Helpdesk
user.account.privilege.grantAdmin-Rolle gewährt
policy.rule.update, policy.lifecycle.updateAnmelde- oder MFA-Richtlinie geändert, möglicherweise geschwächt
system.api_token.createEin 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

  1. Hochladen. Öffnen logtotal.com und die .jsonl-Datei ablegen.
  2. Bereinigen.
  3. Überprüfen.

Wenn es schiefgeht

SymptomWahrscheinliche UrsacheFix
401Falsches oder widerrufenes Token oder fehlendes SSWS  PräfixÜberprüfen Sie das Header-Format; erstellen Sie ein neues Token
403Token-Ersteller hat keine Rechte zum Lesen von ProtokollenVerwenden Sie ein Token von einem Admin mit Protokollzugriff
429Ratenbeschränkungsgrenze erreichtWarten Sie auf die Zeit in X-Rate-Limit-Reset, dann fortfahren
Das Skript endet nieKein „bis“ in der AbfrageSetzen Sie ein „bis“
Nichts älter als 90 TageOkta-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.

Treten Sie der Detection as Code-Plattform von SOC Prime bei um die Sichtbarkeit der für Ihr Unternehmen relevantesten Bedrohungen zu verbessern. Um Ihnen den Einstieg zu erleichtern und unmittelbaren Mehrwert zu erzielen, buchen Sie jetzt ein Treffen mit den Experten von SOC Prime.