IdP-Signaturzertifikat aus einer Verbindung löschen
DELETE /v1/connections/{connection_id}/certificates/{certificate_id} · Berechtigung connections:write
Löscht ein Signaturzertifikat des Identity Providers aus einer Enterprise-SAML-Verbindung. Die Löschung wirkt sofort: Ab dann verifiziert das Zertifikat keine Signatur mehr, es wird nicht mehr aufgelistet und kann nicht erneut hinzugefügt werden. Das Löschen eines bereits gelöschten Zertifikats liefert ebenfalls 204.
Das letzte derzeit gültige Zertifikat kann nicht gelöscht werden, da die Verbindung sonst jede Anmeldung ablehnen würde; fügen Sie zuerst das neue Zertifikat hinzu. Die Anfrage nimmt keinen If-Match-Header an. Löschungen werden als connection.idp_certificate_retired auditiert.
Anfrage
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
connection_id |
Pfad | ja | ID der Enterprise-SAML-Verbindung (conn_…). |
certificate_id |
Pfad | ja | Zertifikats-ID (conncert_…) aus Zertifikate auflisten. |
Antwort
204 No Content.
Fehler
| HTTP | code | Wann |
|---|---|---|
| 404 | not_found |
Die Verbindung oder das Zertifikat existiert in dieser Umgebung nicht, die ID ist fehlerhaft, oder die Verbindung ist keine Enterprise-Verbindung. |
| 409 | conflict |
Die Verbindung ist keine SAML-Verbindung, oder das Zertifikat ist das letzte derzeit gültige. |
| 401 | unauthenticated |
Die Anmeldedaten fehlen, sind ungültig oder widerrufen. |
| 403 | insufficient_permissions |
Den Anmeldedaten fehlt die erforderliche Berechtigung. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; wiederholen Sie nach der Frist aus Retry-After. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie nach der Frist aus Retry-After. |
Beispiel
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