Rimuovi una passkey

DELETE /fapi/v1/me/passkeys/{authenticator_id} · chiamato dall'host di accesso dell'ambiente

Rimuove il record di una passkey. La rimozione viene rifiutata se impedirebbe all'utente di accedere a un'applicazione qualsiasi dell'ambiente. Dopo la rimozione riuscita, una notifica di sicurezza viene inviata agli indirizzi email verificati dell'utente (secondo l'impostazione delle notifiche di sicurezza dell'ambiente). Richiede il cookie __Host-idp_session dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce 401 unauthenticated. Un'app first-party su un altro origin può invece inviare il proprio access token dell'API front (Authorization: DPoP <token> con una prova DPoP; vedi Access token dell'API front).

Richiesta

Header:

Header	Obbligatorio	Descrizione
`Idp-Client`	sì	Identificatore dell'SDK.
`Origin`	sì	Deve essere esattamente `https://<sign-in host>`.

Nessun corpo.

Risposta

204 No Content.

Errori

Stato	Codice	Quando
401	`unauthenticated`	Nessun cookie di sessione valido.
401	`step_up_required`	La sessione non è stata verificata negli ultimi 5 minuti; verifica di nuovo con `max_age=300` nell'header `WWW-Authenticate`.
403	`origin_not_allowed`	`Origin` manca o è errato.
404	`not_found`	Nessuna passkey o chiave di sicurezza di questo utente con questo identificatore.
409	`last_factor`	Rimuovere questo fattore impedirebbe all'utente di accedere ad almeno un'applicazione.

Esempio

curl -X DELETE https://example.keenauth.app/fapi/v1/me/passkeys/cred_01j9zzzzzzzzzzzzzzzzzzzzzz \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -b cookies.txt

Dati personali

Questo endpoint tratta dati personali: credenziali. Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare in nessun campo categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale).