Eliminar un certificado de firma del IdP de una conexión
DELETE /v1/connections/{connection_id}/certificates/{certificate_id} · permiso connections:write
Elimina de una conexión SAML empresarial un certificado de firma del proveedor de identidad. La eliminación surte efecto de inmediato: a partir de ese momento el certificado no verifica ninguna firma, deja de listarse y no se puede volver a añadir. Eliminar un certificado que ya está eliminado también devuelve 204.
El último certificado que está actualmente válido no se puede eliminar, porque la conexión rechazaría todos los inicios de sesión; añade primero el certificado nuevo. La solicitud no admite la cabecera If-Match. Las eliminaciones se auditan como connection.idp_certificate_retired.
Solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
connection_id |
ruta | sí | ID de la conexión SAML empresarial (conn_…). |
certificate_id |
ruta | sí | ID del certificado (conncert_…) de Listar certificados. |
Respuesta
204 No Content.
Errores
| HTTP | code | Cuándo |
|---|---|---|
| 404 | not_found |
La conexión o el certificado no existen en este entorno, el ID está mal formado o la conexión no es una conexión empresarial. |
| 409 | conflict |
La conexión no es una conexión SAML, o el certificado es el último que está actualmente válido. |
| 401 | unauthenticated |
La credencial falta, no es válida o está revocada. |
| 403 | insufficient_permissions |
La credencial no tiene el permiso necesario. |
| 429 | rate_limited |
Se superó el límite de solicitudes; reintenta tras el periodo indicado en Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; reintenta tras el periodo indicado en Retry-After. |
Ejemplo
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