Renommer une clé d'accès
PATCH /fapi/v1/me/passkeys/{authenticator_id} · appelé depuis l'hôte de connexion de l'environnement
Modifie le nom d'affichage donné par l'utilisateur à un enregistrement de clé d'accès. Nécessite le cookie __Host-idp_session de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie 401 unauthenticated. Une application de première partie sur une autre origine peut à la place envoyer son jeton d'accès à l'API frontale (Authorization: DPoP <token> avec une preuve DPoP ; voir Jeton d'accès à l'API frontale).
Requête
En-têtes :
| En-tête | Obligatoire | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Origin |
oui | Doit être exactement https://<hôte de connexion>. |
Corps :
{"label": "Work laptop"}
label est obligatoire ; il ne peut contenir ni caractères de contrôle ni marqueurs directionnels.
Réponse
204 No Content.
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 422 | validation_failed |
label est absent. |
| 422 | invalid_display_string |
label ne respecte pas les règles relatives au nom d'affichage. |
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 403 | origin_not_allowed |
Origin est absent ou incorrect. |
| 404 | not_found |
Aucune clé d'accès ou clé de sécurité de cet utilisateur ne correspond. |
Exemple
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
Données personnelles
Cet point de terminaison traite des données personnelles : des identifiants. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez de données personnelles sensibles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.