Lister les journaux d'un utilisateur

GET /v1/users/{user_id}/logs · autorisation logs:read

Liste les enregistrements de journal d'un utilisateur avec pagination par curseur, du plus récent au plus ancien. Ce sont les données qui alimentent la vue d'activité de l'utilisateur dans le tableau de bord. Cette requête suit les mêmes règles que Lister les journaux, mais n'accepte que les filtres from, to, type et org_id ; les autres filtres sont ignorés.

Périmètre de l'organisation

Transmettez org_id pour afficher un diagnostic des membres à l'intention d'un administrateur d'organisation. La clé doit alors aussi disposer de l'autorisation organizations:read. Si l'utilisateur n'est pas membre de cette organisation (aucune adhésion invited, active ou suspended), la requête échoue avec 404 not_found, la même réponse que pour un utilisateur inconnu. Si l'utilisateur en est membre, seuls les enregistrements survenus dans le contexte de cette organisation sont renvoyés, c'est-à-dire ceux dont org_id correspond à cette organisation. Les connexions de l'utilisateur en dehors de cette organisation, ou dans le contexte d'une autre organisation, ne sont jamais renvoyées. Sans org_id, la vue couvre tous les enregistrements de l'utilisateur dans l'environnement.

Requête

Paramètre Emplacement Obligatoire Description
user_id chemin oui Identifiant de l'utilisateur, préfixé usr_.
limit requête non Taille de page, de 1 à 100. Valeur par défaut : 20.
after requête non Curseur opaque issu de list_metadata.after (enregistrements plus anciens). Exclusif avec before.
before requête non Curseur opaque issu de list_metadata.before (enregistrements plus récents). Exclusif avec after.
from requête non Heure RFC 3339 ; enregistrements à cette heure ou après. Doit se situer dans la fenêtre de conservation.
to requête non Heure RFC 3339 ; enregistrements antérieurs à cette heure. Doit être postérieure à from.
type requête non Préfixe de type de journal, par exemple authentication. ou session.created. Répétez le paramètre pour un maximum de 20 valeurs ; un enregistrement correspondant à l'une d'elles est renvoyé.
org_id requête non Identifiant de l'organisation, préfixé org_. Limite la vue aux enregistrements de cette organisation ; voir Périmètre de l'organisation. Nécessite organizations:read.

Les enregistrements sont toujours triés par occurred_at, du plus récent au plus ancien ; il n'existe pas de paramètre order (order=desc est accepté, toute autre valeur échoue avec validation_failed). Un curseur n'est valide qu'avec les filtres pour lesquels il a été émis.

Réponse

200 OK. data contient les enregistrements de la page ; list_metadata.after pointe vers les enregistrements plus anciens et list_metadata.before vers les plus récents (null lorsqu'il n'y en a pas). Aucun nombre total n'est renvoyé. Les champs vides sont null.

ip, ip_asn, user_agent et user_agent_family ne sont présents que si la clé dispose de l'autorisation audit-events:read_ip, et identifier_hint uniquement si elle dispose de users:read_pii. Sans cette autorisation, le champ est entièrement omis (aucune valeur masquée). ip_country est toujours renvoyé.

{
  "data": [
    {
      "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"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": "<opaque cursor>"
  }
}

Erreurs

Chaque erreur est un corps application/problem+json accompagné d'un code stable.

HTTP code Quand
400 invalid_cursor Le curseur est mal formé ou n'a pas été émis pour cette requête.
400 invalid_filter Le service de journaux a rejeté un filtre ou le curseur.
400 range_outside_retention from est antérieur à la fenêtre de conservation de votre forfait.
422 validation_failed Un paramètre de requête est invalide (limit hors plage, horodatage incorrect, to non postérieure à from, plus de 20 valeurs type, org_id mal formé, paramètre répété).
401 unauthenticated La clé API est absente, invalide ou révoquée.
403 insufficient_permissions La clé ne dispose pas de l'autorisation logs:read, ou org_id est défini et la clé ne dispose pas de organizations:read. required_permissions liste ce dont la requête a besoin.
404 not_found L'identifiant de l'utilisateur est mal formé, ou org_id est défini et l'utilisateur n'est pas membre de cette organisation.
429 rate_limited La limite de débit a été dépassée ; respectez Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez plus tard.

Exemple

curl "https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/logs?limit=50" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Uniquement les enregistrements d'une organisation :

keenauth users logs list usr_0a1b2c3d4e5f6g7h8j9k0m1n2p --org-id org_01j9xk3m7q8r2s4t6v8w0y2z4d --type authentication.

Données personnelles

Ce point de terminaison contient des données personnelles : les journaux de l'environnement. Données personnelles dans les API KeenAuth décrit ce qui est stocké, pendant combien de temps et comment elles sont supprimées. N'envoyez de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.