Rufe die OIDC-Konfiguration einer Verbindung ab

GET /v1/connections/{connection_id}/oidc · Berechtigung connections:read

Gibt die Relying-Party-Konfiguration einer Unternehmens-OIDC-Verbindung zurück: den redirect_uri, der beim Identity Provider zu registrieren ist, den issuer, die client_id, die Client-Authentifizierungsmethode und das Provider-Profil. Das Client-Secret wird nie zurückgegeben: Die Antwort sagt nur, ob eines gespeichert ist (client_secret_configured), und wann es abläuft, falls du ein Datum angegeben hast. Der ETag-Header trägt die Version der Konfiguration; sende ihn als If-Match, wenn du sie aktualisierst. Lesezugriffe werden nicht auditiert.

Anfrage

Feld Typ Erforderlich Beschreibung
connection_id path ja Kennung der Unternehmensverbindung (conn_…).

Antwort

200 OK mit der Konfiguration und einem ETag.

{
  "redirect_uri": "https://acme.eu1.keenauth.app/sso/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/callback",
  "issuer": "https://idp.example.com",
  "client_id": "keenauth-acme",
  "client_auth_method": "client_secret_basic",
  "provider_profile": "generic",
  "client_secret_configured": true,
  "client_secret_expires_at": "2027-04-01T00:00:00Z"
}
Feld Beschreibung
redirect_uri Der Callback, der beim Identity Provider zu registrieren ist. Er wird beim ersten Schreiben der Konfiguration festgelegt.
issuer Die Issuer-URL des Identity Providers.
client_id Die beim Identity Provider registrierte Client-Kennung.
client_auth_method private_key_jwt, client_secret_basic oder client_secret_post.
provider_profile entra, okta, google, keycloak, ping, onelogin, jumpcloud oder generic.
client_secret_configured Ob ein Client-Secret gespeichert ist. Sein Wert wird nie zurückgegeben.
client_secret_expires_at Wann der Identity Provider das Secret ablaufen lässt; null, wenn keines angegeben wurde.

Fehler

HTTP Code Wann
404 not_found Die Verbindung existiert in dieser Umgebung nicht, ist keine Unternehmens-OIDC-Verbindung oder hat noch keine OIDC-Konfiguration.
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403 insufficient_permissions Die Anmeldedaten haben nicht die erforderliche Berechtigung.
429 rate_limited Die Rate-Grenze wurde überschritten; wiederhole nach dem Retry-After-Zeitraum.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederhole nach dem Retry-After-Zeitraum.

Beispiel

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

keenauth connections oidc get conn_01j9xp6q0r1s5t7v9w1x3y5z7b