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

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

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