# 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](add.md) 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](list.md). |

## 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

```bash
curl -X DELETE "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/certificates/conncert_01j9xq2m4n6p8r0s2t4v6w8y0a" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

```bash
keenauth connections certificates delete conn_01j9xp6q0r1s5t7v9w1x3y5z7b conncert_01j9xq2m4n6p8r0s2t4v6w8y0a
```