Letztes Testergebnis einer Verbindung abrufen

GET /v1/connections/{connection_id}/test-results/latest · Berechtigung connections:write

Gibt das Ergebnis der jüngsten Testanmeldung einer Enterprise-Verbindung aus den letzten 24 Stunden zurück: Status, Fehlergrund, die Namen der Attribute oder Claims, die der Identity Provider gesendet hat, die Anzahl der Gruppen und die Benutzerfelder, die über die Attributzuordnung einen Wert erhalten haben. Attributwerte, die rohe SAML-Assertion und das ID-Token werden nie gespeichert oder zurückgegeben. Testergebnisse werden 24 Stunden aufbewahrt. Lesezugriffe werden nicht auditiert.

Anfrage

Feld Typ Pflicht Beschreibung
connection_id Pfad ja ID der Enterprise-Verbindung (conn_…).

Antwort

200 OK:

{
  "test_id": "conntest_01j9xr4a6b8c0d2e4f6g8h0j2k",
  "status": "passed",
  "failure_reason": null,
  "attribute_names": ["email", "given_name", "groups"],
  "group_count": 2,
  "mapped_fields": ["email", "given_name"],
  "started_at": "2026-10-20T10:00:00Z",
  "completed_at": "2026-10-20T10:01:12Z"
}
Feld Beschreibung
status pending (die URL wurde noch nicht geöffnet oder der Identity Provider hat noch nicht geantwortet), passed oder failed.
failure_reason Maschinenlesbarer Grund eines fehlgeschlagenen Tests (z. B. configuration_changed, wenn die Verbindung während des Tests geändert wurde); sonst null.
attribute_names Namen der Attribute oder Claims, die der Identity Provider gesendet hat (nicht deren Werte).
group_count Anzahl der erhaltenen Gruppen.
mapped_fields Benutzerfelder, die über die Attributzuordnung einen Wert erhalten haben (nicht die Werte).
started_at, completed_at Wann der Test gestartet wurde und wann die Antwort des Identity Providers verarbeitet wurde; completed_at ist solange null, wie der Status pending ist.

Fehler

HTTP code Wann
404 not_found Die Verbindung existiert in dieser Umgebung nicht, ist keine Enterprise-Verbindung oder hat kein Testergebnis aus den letzten 24 Stunden.
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder widerrufen.
403 insufficient_permissions Den Anmeldedaten fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie nach der Frist aus Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie nach der Frist aus Retry-After.

Beispiel

curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/test-results/latest" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth connections test-results latest conn_01j9xp6q0r1s5t7v9w1x3y5z7b