# 接続の 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 接続では空の一覧が返されます。

```json
{
  "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_…`）。[証明書を削除](delete.md) する際に使用します。 |
| `sha256_fingerprint` | DER エンコーディングの小文字 16 進数 SHA-256。IdP が表示するフィンガープリントと照合してください。 |
| `not_before`, `not_after` | 有効期間。期間外の証明書は署名を検証しません。 |
| `source` | `metadata`: メタデータ URL の更新で追加された。`manual`: 手動でアップロードされた、または [インポートしたメタデータ文書](../connections/import-metadata.md) から取り込まれた。 |

## エラー

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

## 例

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

```bash
keenauth connections certificates list conn_01j9xp6q0r1s5t7v9w1x3y5z7b
```