接続の OIDC 設定を取得する

GET /v1/connections/{connection_id}/oidc · 権限 connections:read

企業向け OIDC 接続のリライングパーティ設定を返します。内容は、IdP に登録する redirect_uri、issuer、client_id、クライアント認証方式、プロバイダープロファイルです。クライアントシークレットは決して返されません。レスポンスでは、保存されているかどうか（client_secret_configured）と、日付を指定していた場合の有効期限のみを示します。ETag ヘッダーには設定のバージョンが含まれます。設定を更新するときは If-Match として送信してください。読み取りは監査されません。

リクエスト

フィールド 型 必須 説明
connection_id path はい 企業向け接続の ID（conn_…）。

レスポンス

設定と ETag を含む 200 OK。

{
  "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"
}
フィールド 説明
redirect_uri IdP に登録するコールバック。設定が最初に書き込まれたときに固定されます。
issuer IdP の issuer URL。
client_id IdP に登録されたクライアント ID。
client_auth_method private_key_jwt、client_secret_basic、client_secret_post のいずれか。
provider_profile entra、okta、google、keycloak、ping、onelogin、jumpcloud、generic のいずれか。
client_secret_configured クライアントシークレットが保存されているかどうか。その値は返されません。
client_secret_expires_at IdP がシークレットを失効させる日時。指定されていない場合は null。

エラー

HTTP code 発生条件
404 not_found 接続がこの環境に存在しない、企業向け OIDC 接続ではない、または OIDC 設定がまだない。
401 unauthenticated 認証情報がない、無効である、または失効している。
403 insufficient_permissions 認証情報に必要な権限がない。
429 rate_limited レート制限を超えた。Retry-After の期間を待ってから再試行してください。
503 service_unavailable 依存先が一時的に利用できない。Retry-After の期間を待ってから再試行してください。

例

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

keenauth connections oidc get conn_01j9xp6q0r1s5t7v9w1x3y5z7b