Elenca i log di provisioning della directory

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

Elenca il log di provisioning di una directory SCIM, dal più recente. Ogni richiesta SCIM autenticata inviata dal provider di identità è un record: metodo, template del percorso (l'ID reale non compare mai nel percorso), tipo e ID della risorsa, un riepilogo delle operazioni senza valori, nomi degli attributi ignorati, stato HTTP, scim_type, durata, prefisso dell'indirizzo del client (IPv4 /24, IPv6 /48), classe del client e se il blocco di deprovisioning in blocco ha fermato la richiesta. I corpi delle richieste e delle risposte, i valori degli attributi, l'indirizzo IP completo, lo User-Agent e il valore del token non vengono mai memorizzati né restituiti.

I record vengono conservati per il periodo di conservazione dei log del tuo piano (Free 7 giorni, Startup 14, Business 30, Enterprise 90). L'ordine è sempre dal più recente; non esiste un parametro order. I record di una directory eliminata restano leggibili con GET /v1/logs?type=scim.request.

Richiesta

Campo Tipo Obbligatorio Descrizione
directory_id path sì ID della directory SCIM (dir_…).
limit query no 1–100, predefinito 20.
after query no Il cursore da list_metadata.after (record più vecchi).
before query no Il cursore da list_metadata.before (record più recenti).
from query no Limite inferiore incluso (RFC 3339).
to query no Limite superiore escluso (RFC 3339).

Non c'è un corpo della richiesta.

Risposta

200 OK con una pagina di record.

{
  "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
  }
}

Errori

HTTP code Quando
400 invalid_cursor Il cursore è malformato oppure appartiene a un'altra richiesta.
400 range_outside_retention from è precedente al periodo di conservazione del tuo piano.
404 not_found La directory non esiste in questo ambiente.
422 validation_failed limit è fuori intervallo, from o to non è in formato RFC 3339, to non è successivo a from, oppure è stato passato order (unsupported).
401 unauthenticated La credenziale manca, non è valida o è stata revocata.
403 insufficient_permissions La credenziale non ha l'autorizzazione richiesta.
429 rate_limited È stato superato il limite di richieste; riprova dopo il periodo indicato in Retry-After.
503 service_unavailable La sincronizzazione della directory o la ricerca nei log è temporaneamente non disponibile o non configurata in questo deployment; riprova dopo il periodo indicato in Retry-After.

Esempio

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

Dati personali

Questo endpoint contiene dati personali: utenti della directory (SCIM). Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.