接続から IdP 署名証明書を削除
DELETE /v1/connections/{connection_id}/certificates/{certificate_id} · 権限 connections:write
エンタープライズ SAML 接続から、IdP の署名証明書を削除します。削除は即座に反映されます。それ以降、その証明書はいかなる署名も検証せず、一覧にも表示されず、再度追加することもできません。既に削除済みの証明書を削除しても 204 が返されます。
現在有効な最後の証明書は削除できません。削除すると接続がすべてのサインインを拒否してしまうためです。先に新しい証明書を 追加 してください。このリクエストは If-Match ヘッダーを受け付けません。削除は connection.idp_certificate_retired として監査されます。
リクエスト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
connection_id |
パス | はい | エンタープライズ SAML 接続 ID（conn_…）。 |
certificate_id |
パス | はい | 証明書の一覧 から得た証明書 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 の期間を待ってから再試行してください。 |
例
curl -X DELETE "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/certificates/conncert_01j9xq2m4n6p8r0s2t4v6w8y0a" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
keenauth connections certificates delete conn_01j9xp6q0r1s5t7v9w1x3y5z7b conncert_01j9xq2m4n6p8r0s2t4v6w8y0a