# 接続から IdP 署名証明書を削除

`DELETE /v1/connections/{connection_id}/certificates/{certificate_id}` · 権限 `connections:write`

エンタープライズ SAML 接続から、IdP の署名証明書を削除します。削除は即座に反映されます。それ以降、その証明書はいかなる署名も検証せず、一覧にも表示されず、再度追加することもできません。既に削除済みの証明書を削除しても `204` が返されます。

現在有効な最後の証明書は削除できません。削除すると接続がすべてのサインインを拒否してしまうためです。先に新しい証明書を [追加](add.md) してください。このリクエストは `If-Match` ヘッダーを受け付けません。削除は `connection.idp_certificate_retired` として監査されます。

## リクエスト

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `connection_id` | パス | はい | エンタープライズ SAML 接続 ID（`conn_…`）。 |
| `certificate_id` | パス | はい | [証明書の一覧](list.md) から得た証明書 ID（`conncert_…`）。 |

## レスポンス

`204 No Content`。

## エラー

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

## 例

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

```bash
keenauth connections certificates delete conn_01j9xp6q0r1s5t7v9w1x3y5z7b conncert_01j9xq2m4n6p8r0s2t4v6w8y0a
```