연결에서 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