Verzeichnis-Provisionierungsprotokolle auflisten

GET /v1/directories/{directory_id}/provisioning-logs · Berechtigung directories:read

Listet das Provisionierungsprotokoll eines SCIM-Verzeichnisses auf, die neuesten zuerst. Jede authentifizierte SCIM-Anfrage, die der Identitätsanbieter gesendet hat, ist ein Datensatz: Methode, Pfadvorlage (die echte ID steht nie im Pfad), Ressourcentyp und ID, eine Zusammenfassung der Operation ohne Werte, ignorierte Attributnamen, HTTP-Status, scim_type, Dauer, das Präfix der Client-Adresse (IPv4 /24, IPv6 /48), die Client-Klasse und ob die Massen-Deprovisionierungssperre die Anfrage gestoppt hat. Anfrage- und Antwortkörper, Attributwerte, die vollständige IP-Adresse, der User-Agent und der Token-Wert werden nie gespeichert und nie zurückgegeben.

Datensätze werden für den Protokollaufbewahrungszeitraum Ihres Tarifs aufbewahrt (Free 7 Tage, Startup 14, Business 30, Enterprise 90). Die Reihenfolge ist immer die neueste zuerst; es gibt keinen Parameter order. Datensätze eines gelöschten Verzeichnisses bleiben mit GET /v1/logs?type=scim.request lesbar.

Anfrage

Feld Typ Pflicht Beschreibung
directory_id Pfad ja SCIM-Verzeichnis-ID (dir_…).
limit Abfrage nein 1–100, Standard 20.
after Abfrage nein Der Cursor aus list_metadata.after (ältere Datensätze).
before Abfrage nein Der Cursor aus list_metadata.before (neuere Datensätze).
from Abfrage nein Untere Grenze, einschließlich (RFC 3339).
to Abfrage nein Obere Grenze, ausschließlich (RFC 3339).

Es gibt keinen Anfragetext.

Antwort

200 OK mit einer Seite von Datensätzen.

{
  "data": [
    {
      "id": "evt_01j9xp4q6r8s0t2v4w6x8y0z2b",
      "occurred_at": "2026-10-20T12:00:00Z",
      "outcome": "success",
      "organization_id": "org_01j9xk1m3n5p7q9r1s3t5v7w9x",
      "token_id": "dst_01j9xn2p4q6r8s0t2v4w6x8y0z",
      "method": "PATCH",
      "path_template": "PATCH /Users/{id}",
      "resource_type": "User",
      "resource_id": "dsu_01j9xq5r7s9t1v3w5x7y9z1a3c",
      "operation_summary": ["replace:active"],
      "ignored_attributes": [],
      "status": 200,
      "scim_type": null,
      "duration_ms": 12,
      "client_ip_prefix": "203.0.113.0/24",
      "client_class": "okta",
      "held": false,
      "request_id": "0192f5e0-0000-7000-8000-000000000001",
      "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Fehler

HTTP Code Wann
400 invalid_cursor Der Cursor ist fehlerhaft oder gehört zu einer anderen Anfrage.
400 range_outside_retention from liegt vor dem Aufbewahrungszeitraum Ihres Tarifs.
404 not_found Das Verzeichnis existiert in dieser Umgebung nicht.
422 validation_failed limit liegt außerhalb des gültigen Bereichs, from oder to ist kein RFC 3339, to liegt nicht nach from, oder order wurde angegeben (unsupported).
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403 insufficient_permissions Den Anmeldedaten fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeit aus Retry-After.
503 service_unavailable Die Verzeichnissynchronisierung oder Protokollsuche ist vorübergehend nicht verfügbar oder in dieser Bereitstellung nicht konfiguriert; wiederholen Sie die Anfrage nach der Zeit aus Retry-After.

Beispiel

curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/provisioning-logs?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth directories provisioning-logs list dir_01j9xm2n4p6q8r0s2t4v6w8y0z --from 2026-10-01T00:00:00Z

Personenbezogene Daten

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