Passkey umbenennen
PATCH /fapi/v1/me/passkeys/{authenticator_id} · wird vom Sign-in-Host der Umgebung aufgerufen
Ändert den Anzeigenamen, den der Benutzer einem Passkey-Datensatz gegeben hat. Erforderlich ist das Cookie __Host-idp_session des angemeldeten Benutzers. Fehlt das Cookie, ist es abgelaufen oder widerrufen, gibt der Endpunkt 401 unauthenticated zurück. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (Authorization: DPoP <token> mit einem DPoP-Proof; siehe Front-API-Zugriffstoken).
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung. |
Origin |
ja | Muss exakt https://<sign-in host> sein. |
Body:
{"label": "Work laptop"}
label ist erforderlich; er darf keine Steuerzeichen oder Richtungsmarkierungen enthalten.
Antwort
204 No Content.
Fehler
| Status | Code | Wann |
|---|---|---|
| 422 | validation_failed |
label fehlt. |
| 422 | invalid_display_string |
label entspricht nicht den Regeln für Anzeigenamen. |
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie. |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
| 404 | not_found |
Für diesen Benutzer gibt es keinen solchen Passkey oder Sicherheitsschlüssel. |
Beispiel
curl -X PATCH 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" \
-H "Content-Type: application/json" \
-d '{"label": "Work laptop"}' \
-b cookies.txt
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Anmeldedaten. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in einem Feld.