Eine Sitzung abrufen

GET /v1/sessions/{session_id} · Berechtigung sessions:read

Gibt eine Sitzung in jedem Status zurück (active, expired, revoked). Die vollständige IP-Adresse wird angezeigt, und der Zugriff wird im Verwaltungs-Audit-Log protokolliert. Cookies, Tokens und Geräte-Fingerprints werden nie zurückgegeben.

Anfrage

Parameter In Pflicht Beschreibung
session_id path ja Sitzungs-ID, mit ses_ beginnend.

Antwort

200 OK. Leere Felder sind null.

{
  "id": "ses_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "status": "revoked",
  "login_host": "login.example.com",
  "auth_time": "2026-02-01T08:00:00Z",
  "acr": "1fa",
  "amr": ["pwd"],
  "created_at": "2026-02-01T08:00:00Z",
  "last_seen_at": "2026-02-01T09:15:00Z",
  "idle_expires_at": "2026-02-08T09:15:00Z",
  "absolute_expires_at": "2026-03-03T08:00:00Z",
  "org_id": "org_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "ip_address": "203.0.113.10",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0)",
  "revoked_at": "2026-02-01T10:00:00Z",
  "revoke_reason": "admin"
}

revoke_reason ist nur für revoked-Sitzungen gesetzt, zum Beispiel admin, user_logout, idp_logout oder refresh_reuse.

Fehler

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

HTTP code Wann
404 not_found Die Sitzung existiert in dieser Umgebung nicht (oder die ID ist fehlerhaft).
401 unauthenticated Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.
403 insufficient_permissions Dem Schlüssel fehlt die Berechtigung sessions:read.
429 rate_limited Das Ratenlimit wurde überschritten; beachten Sie Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage später.

Beispiel

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

CLI: keenauth sessions get ses_0a1b2c3d4e5f6g7h8j9k0m1n2p

Personenbezogene Daten

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