Scollega un'identità
DELETE /fapi/v1/me/identities/{identity_id} · chiamato dall'host di accesso dell'ambiente
Scollega un'identità social o aziendale dall'account dell'utente autenticato. L'ultimo metodo di accesso dell'utente non può essere rimosso. Se l'organizzazione dell'utente impone il Single Sign-On su questo collegamento, l'identità può essere rimossa solo tramite l'API di gestione clienti. Dopo la rimozione riuscita, una notifica di sicurezza viene inviata a tutti gli indirizzi email verificati dell'utente. Richiede il cookie __Host-idp_session dell'utente autenticato; se il cookie manca, è scaduto o revocato, restituisce 401 unauthenticated. Un'app di prima parte su un'altra origine può invece inviare il proprio token di accesso alla Front API (Authorization: DPoP <token> con una prova DPoP; vedi Token di accesso alla Front API).
La sessione deve essere stata verificata negli ultimi 5 minuti. Se l'utente ha un secondo fattore, la sessione deve inoltre essere stata aperta con un secondo fattore (urn:idp:acr:mfa).
Richiesta
Intestazioni:
| Intestazione | Obbligatoria | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Origin |
sì | Deve essere esattamente https://<host di accesso>. |
identity_id: l'identificatore dell'identità collegata, nel formato idn_….
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 oppure è richiesto un secondo fattore; verifica di nuovo con max_age=300 (e, se applicabile, acr_values) nell'intestazione WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin manca o è errato. |
| 404 | not_found |
Nessuna identità di questo tipo per questo utente. |
| 409 | last_login_method |
Questa identità è l'ultimo metodo di accesso dell'utente. |
| 409 | sso_enforced_by_organization |
L'organizzazione dell'utente impone il Single Sign-On su questo collegamento. |
Esempio
curl -X DELETE https://example.keenauth.app/fapi/v1/me/identities/idn_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: identità collegate. Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.