Récupérer la configuration OIDC d'une connexion

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

Retourne la configuration de partie utilisatrice (relying party) d'une connexion OIDC d'entreprise : le redirect_uri à enregistrer chez le fournisseur d'identité, l'issuer, le client_id, la méthode d'authentification du client et le profil du fournisseur. Le secret client n'est jamais retourné : la réponse indique seulement s'il est enregistré (client_secret_configured) et, si vous avez donné une date, quand il expire. L'en-tête ETag porte la version de la configuration ; envoyez-le comme If-Match lorsque vous la mettez à jour. Les lectures ne sont pas auditées.

Requête

Champ Type Obligatoire Description
connection_id path oui Identifiant de la connexion d'entreprise (conn_…).

Réponse

200 OK avec la configuration et un 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"
}
Champ Description
redirect_uri Le callback à enregistrer chez le fournisseur d'identité. Il est fixé lors de la première écriture de la configuration.
issuer L'URL d'émetteur du fournisseur d'identité.
client_id L'identifiant client enregistré chez le fournisseur d'identité.
client_auth_method private_key_jwt, client_secret_basic ou client_secret_post.
provider_profile entra, okta, google, keycloak, ping, onelogin, jumpcloud ou generic.
client_secret_configured Indique si un secret client est enregistré. Sa valeur n'est jamais retournée.
client_secret_expires_at Date à laquelle le fournisseur d'identité fait expirer le secret ; null si aucune date n'a été donnée.

Erreurs

HTTP code Quand
404 not_found La connexion n'existe pas dans cet environnement, n'est pas une connexion OIDC d'entreprise, ou n'a pas encore de configuration OIDC.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant n'a pas la permission requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période Retry-After.

Exemple

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

keenauth connections oidc get conn_01j9xp6q0r1s5t7v9w1x3y5z7b