Rinomina un autenticatore
PATCH /fapi/v1/me/authenticators/{authenticator_id} · chiamato dall'host di accesso dell'ambiente
Modifica il nome visualizzato che l'utente ha assegnato a un record di autenticatore. 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'altra origine può invece inviare il proprio token di accesso per la front API (Authorization: DPoP <token> con una proof DPoP; vedi Token di accesso per la front API).
Richiesta
Header:
| Header | Obbligatorio | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Origin |
sì | Deve essere esattamente https://<sign-in host>. |
Body:
{"label": "Work laptop"}
label è obbligatorio; non può contenere caratteri di controllo o marcatori di direzionalità.
Risposta
204 No Content.
Errori
| Stato | Codice | Quando |
|---|---|---|
| 422 | validation_failed |
label mancante. |
| 422 | invalid_display_string |
label non rispetta le regole per il nome visualizzato. |
| 401 | unauthenticated |
Nessun cookie di sessione valido. |
| 403 | origin_not_allowed |
Origin manca oppure è errato. |
| 404 | not_found |
Nessun autenticatore di questo tipo per questo utente. |
Esempio
curl -X PATCH https://example.keenauth.app/fapi/v1/me/authenticators/cred_01j9zzzzzzzzzzzzzzzzzzzzzz \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{"label": "Work laptop"}' \
-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 eliminato. Non inviare in nessun campo categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale).