Protokolleintrag abrufen

GET /v1/logs/{log_id} · Berechtigung logs:read

Gibt einen Protokolleintrag einschließlich details zurück.

Anfrage

Parameter In Erforderlich Beschreibung
log_id path ja ID des Protokolleintrags mit dem Präfix evt_.

Antwort

200 OK mit dem Eintrag. Leere Felder sind null.

ip, ip_asn, user_agent und user_agent_family sind nur vorhanden, wenn der Schlüssel die Berechtigung audit-events:read_ip besitzt, und identifier_hint nur, wenn er users:read_pii besitzt. Ohne die Berechtigung wird das Feld vollständig weggelassen (kein maskierter Wert). ip_country wird immer zurückgegeben.

{
  "id": "evt_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "occurred_at": "2026-10-01T08:15:42.120Z",
  "type": "authentication.password.failed",
  "outcome": "failure",
  "reason_code": "invalid_credentials",
  "user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "org_id": null,
  "application_id": "app_01j9xk3m7q8r2s4t6v8w0y2z4b",
  "connection_id": "conn_01j9xk3m7q8r2s4t6v8w0y2z4c",
  "directory_id": null,
  "session_id": null,
  "identifier_hint": "a***@e***.com",
  "ip": "203.0.113.7",
  "ip_country": "DE",
  "ip_asn": 64500,
  "user_agent": "Mozilla/5.0 (X11; Linux x86_64)",
  "user_agent_family": "Firefox",
  "risk": null,
  "auth_context": null,
  "act_chain": null,
  "details": {"attempt": 3},
  "request_id": "0192a6c1-7d3e-7a10-9b2c-3d4e5f607182",
  "correlation_id": null,
  "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}

Fehler

Jeder Fehler ist ein application/problem+json-Body mit einem stabilen code.

HTTP code Wann
401 unauthenticated Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.
403 insufficient_permissions Der Schlüssel besitzt die Berechtigung logs:read nicht.
404 not_found Der Eintrag existiert nicht, gehört zu einer anderen Umgebung oder liegt außerhalb des Aufbewahrungszeitraums.
429 rate_limited Das Ratenlimit wurde überschritten; berücksichtigen Sie Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es später erneut.

Beispiel

curl https://api.eu.keenauth.com/v1/logs/log_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Personenbezogene Daten

Dieser Endpunkt enthält personenbezogene Daten: Umgebungsprotokolle. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt und wie es gelöscht wird. Übermitteln Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).