# Elimina un certificato di firma IdP da una connessione

`DELETE /v1/connections/{connection_id}/certificates/{certificate_id}` · permesso `connections:write`

Elimina da una connessione SAML enterprise un certificato di firma del provider di identità. L'eliminazione ha effetto immediato: da quel momento il certificato non verifica alcuna firma, non viene più elencato e non può essere aggiunto di nuovo. Eliminare un certificato già eliminato restituisce comunque `204`.

L'ultimo certificato attualmente valido non può essere eliminato, perché la connessione rifiuterebbe ogni accesso; [aggiungi](add.md) prima il nuovo certificato. La richiesta non accetta l'header `If-Match`. Le eliminazioni vengono registrate come `connection.idp_certificate_retired`.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `connection_id` | percorso | sì | ID della connessione SAML enterprise (`conn_…`). |
| `certificate_id` | percorso | sì | ID del certificato (`conncert_…`) da [Elenca i certificati](list.md). |

## Risposta

`204 No Content`.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | La connessione o il certificato non esistono in questo ambiente, l'ID è malformato, oppure la connessione non è una connessione enterprise. |
| 409 | `conflict` | La connessione non è una connessione SAML, oppure il certificato è l'ultimo attualmente valido. |
| 401 | `unauthenticated` | La credenziale è mancante, non valida o revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha il permesso richiesto. |
| 429 | `rate_limited` | È stato superato il limite di frequenza; riprova dopo il periodo indicato da `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo indicato da `Retry-After`. |

## Esempio

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