接続の IdP 署名証明書を一覧表示

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

エンタープライズ SAML 接続の IdP の有効な署名証明書を返します。ID、SHA-256 フィンガープリント、有効期間、ソースを含みます。証明書そのものとそのサブジェクト（人の氏名やメールアドレスを含みうる）は返されません。接続が持つ有効な証明書は最大 3 件のため、一覧はページ分割されません。limit、after、before、order パラメーターはなく、list_metadata にカーソルは含まれません。削除済みの証明書は一覧に含まれません。読み取りは監査されません。

リクエスト

フィールド	型	必須	説明
`connection_id`	パス	はい	エンタープライズ SAML 接続 ID（`conn_…`）。

レスポンス

200 OK。SAML 設定がない SAML 接続では空の一覧が返されます。

{
  "data": [
    {"id": "conncert_01j9xq2m4n6p8r0s2t4v6w8y0a", "sha256_fingerprint": "3b0c…", "not_before": "2026-01-01T00:00:00Z", "not_after": "2028-01-01T00:00:00Z", "source": "metadata"}
  ],
  "list_metadata": {"before": null, "after": null}
}

フィールド	説明
`id`	証明書 ID（`conncert_…`）。証明書を削除する際に使用します。
`sha256_fingerprint`	DER エンコーディングの小文字 16 進数 SHA-256。IdP が表示するフィンガープリントと照合してください。
`not_before`, `not_after`	有効期間。期間外の証明書は署名を検証しません。
`source`	`metadata`: メタデータ URL の更新で追加された。`manual`: 手動でアップロードされた、またはインポートしたメタデータ文書から取り込まれた。

エラー

HTTP	code	発生条件
404	`not_found`	この環境に接続が存在しない、またはエンタープライズ接続ではありません。
409	`conflict`	接続が SAML 接続ではありません。
401	`unauthenticated`	認証情報がない、無効、または取り消されています。
403	`insufficient_permissions`	認証情報に必要な権限がありません。
429	`rate_limited`	レート制限を超えました。`Retry-After` の期間を待ってから再試行してください。
503	`service_unavailable`	依存先が一時的に利用できません。`Retry-After` の期間を待ってから再試行してください。

例

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

keenauth connections certificates list conn_01j9xp6q0r1s5t7v9w1x3y5z7b