Pour empêcher la création d'une nouvelle clé d'accès si elle existe déjà dans la même clé d'accès
utilisez la propriété facultative excludeCredentials
de l'API WebAuthn
PublicKeyCredentialCreationOptions
dictionnaire.
La propriété excludeCredentials
est un tableau de descripteurs de clés publiques.
qui existent déjà pour un utilisateur donné. Ces informations sont fournies par le
serveur de la partie de confiance
lorsqu'il veut empêcher la création de nouveaux identifiants pour un utilisateur existant sur
un seul authentificateur.
Le tableau excludeCredentials
comporte les attributs suivants:
- type: chaîne décrivant le type d'identifiant de clé publique à utiliser
générées. La valeur par défaut est "
public-key
". - id: un
ArrayBuffer
qui correspond à des identifiants de clé publique existants identifiant (PublicKeyCredential.rawId
). Cet identifiant est généré pendant la création de l'instancePublicKeyCredential
.
Le client renvoie une erreur si l'utilisateur tente de créer un
un nouvel identifiant sur un authentificateur de plate-forme contenant déjà l'un des
les identifiants répertoriés dans ce paramètre. Si l'authentificateur contient déjà un
identifiant de clé publique de ce type, l'authentificateur recueille le consentement de l'utilisateur
d'habitude, et affiche à l'utilisateur un indicateur de réussite sans qu'aucun nouvel identifiant ne soit créé. Une
L'exception InvalidStateError
est levée, ce qui indique que l'utilisateur dispose déjà d'une
Un identifiant valide a été mis en correspondance avec excludeCredentials
.
"excludeCredentials": [
{"id": "<id-1>", "type": "public-key"},
{"id": "<id-2>", "type": "public-key"}
]
Ce fichier JSON peut être utilisé pour empêcher les authentificateurs avec l'un des
d’identifiants d’être enregistrés
plusieurs fois. Chaque "<id-*>
" doit
sera renseigné avec l'identifiant du jeu d'identification à exclure.
Consultez le W3C pour en savoir plus sur excludeCredentials
.
recommandation