Supprimer un certificat de signature IdP d'une connexion
DELETE /v1/connections/{connection_id}/certificates/{certificate_id} · autorisation connections:write
Supprime un certificat de signature du fournisseur d'identité d'une connexion SAML d'entreprise. La suppression prend effet immédiatement : à partir de ce moment, le certificat ne vérifie plus aucune signature, n'est plus listé et ne peut pas être ajouté à nouveau. Supprimer un certificat déjà supprimé renvoie aussi 204.
Le dernier certificat actuellement valide ne peut pas être supprimé, car la connexion rejetterait alors toutes les ouvertures de session ; ajoutez d'abord le nouveau certificat. La requête n'accepte pas d'en-tête If-Match. Les suppressions sont auditées sous connection.idp_certificate_retired.
Requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
connection_id |
chemin | oui | ID de connexion SAML d'entreprise (conn_…). |
certificate_id |
chemin | oui | ID de certificat (conncert_…) issu de Lister les certificats. |
Réponse
204 No Content.
Erreurs
| HTTP | code | Quand |
|---|---|---|
| 404 | not_found |
La connexion ou le certificat n'existe pas dans cet environnement, l'ID est mal formé, ou la connexion n'est pas une connexion d'entreprise. |
| 409 | conflict |
La connexion n'est pas une connexion SAML, ou le certificat est le dernier actuellement valide. |
| 401 | unauthenticated |
L'identifiant est absent, invalide ou révoqué. |
| 403 | insufficient_permissions |
L'identifiant ne dispose pas de l'autorisation requise. |
| 429 | rate_limited |
La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par Retry-After. |
Exemple
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