Les clés d'accès sont liées à un site Web spécifique et ne peuvent être utilisées que pour se connecter au site Web pour lequel elles ont été créées.
Il est spécifié dans l'ID de partie de confiance (ID RP), qui, pour les clés d'accès créées pour le domaine example.com, peut être www.example.com ou example.com.
Bien que les ID de RP empêchent l'utilisation des clés d'accès comme identifiant unique pour s'authentifier partout, ils posent des problèmes pour :
- Sites avec plusieurs domaines : les utilisateurs ne peuvent pas utiliser la même clé d'accès pour se connecter à différents domaines spécifiques à un pays (par exemple,
example.cometexample.co.uk) gérés par la même entreprise. - Domaines de marque : les utilisateurs ne peuvent pas utiliser le même identifiant sur différents domaines utilisés par une même marque (par exemple,
acme.cometacmerewards.com). - Applications mobiles : les applications mobiles n'ont souvent pas leur propre domaine, ce qui complique la gestion des identifiants.
Il existe des solutions de contournement basées sur la fédération d'identité et d'autres basées sur les iFrames, mais elles ne sont pas pratiques dans certains cas. Les requêtes d'origine associée offrent une solution.
Solution
Avec les requêtes d'origine associées, un site Web peut spécifier les origines autorisées à utiliser son ID de tiers de confiance.
Les utilisateurs peuvent ainsi réutiliser la même clé d'accès sur plusieurs sites que vous gérez.
Pour utiliser les requêtes d'origine associée, vous devez diffuser un fichier JSON spécial à une URL spécifique https://{RP ID}/.well-known/webauthn. Si example.com souhaite autoriser les origines supplémentaires à l'utiliser comme ID de RP, il doit diffuser le fichier suivant sur https://example.com/.well-known/webauthn: :
{
"origins": [
"https://example.co.uk",
"https://example.de",
"https://example-rewards.com"
]
}
La prochaine fois que l'un de ces sites effectuera un appel pour la création (navigator.credentials.create) ou l'authentification (navigator.credentials.get) d'une clé d'accès utilisant example.com comme ID de RP, le navigateur remarquera que l'ID de RP ne correspond pas à l'origine de la requête. Si le navigateur est compatible avec les requêtes d'origine associée, il recherche d'abord un fichier webauthn à l'emplacement https://{RP ID}/.well-known/webauthn. Si le fichier existe, le navigateur vérifie si l'origine de la requête figure dans le fichier allowlist.
Si oui, il passe aux étapes de création ou d'authentification de la clé d'accès.
Si le navigateur n'est pas compatible avec les requêtes d'origine associée, il génère une erreur SecurityError.
Prise en charge des navigateurs
Les requêtes d'origine associée sont compatibles avec Chrome et Safari. En janvier 2026, Firefox envisageait toujours d'implémenter cette fonctionnalité. Vous pouvez suivre son état dans le problème de position des normes Mozilla.
Configurer les demandes d'origine associées
La démonstration suivante utilise deux sites, https://ror-1.glitch.me et https://ror-2.glitch.me.
Pour permettre aux utilisateurs de se connecter avec la même clé d'accès sur ces deux sites, il utilise les requêtes d'origine associée pour permettre à ror-2.glitch.me d'utiliser ror-1.glitch.me comme ID de RP.
Démo
https://ror-2.glitch.me implémente les requêtes d'origine associée pour utiliser ror-1.glitch.me comme ID de RP. Ainsi, ror-1 et ror-2 utilisent ror-1.glitch.me comme ID de RP lors de la création d'une clé d'accès ou de l'authentification avec celle-ci.
Nous avons également implémenté une base de données de clés d'accès partagée entre ces sites.
Voici comment se déroule l'expérience utilisateur :
- Vous pouvez créer une clé d'accès et vous authentifier avec elle sur
ror-2, même si son ID de RP estror-1(et nonror-2). - Une fois que vous avez créé une clé d'accès sur
ror-1ouror-2, vous pouvez l'utiliser pour vous authentifier sur les deuxror-1ror-2. Commeror-2spécifieror-1en tant qu'ID de RP, envoyer une demande de création ou d'authentification de clé d'accès depuis l'un de ces sites revient à envoyer la demande sur ror-1. L'ID de RP est le seul élément qui associe une requête à une origine. - Une fois que vous avez créé une clé d'accès sur
ror-1ouror-2, Chrome peut la saisir automatiquement surror-1etror-2. - Un identifiant créé sur l'un de ces sites aura un ID de RP de
ror-1.
Voir le code :
- Consultez le fichier
/.well-known/webauthnconfiguré dans la codebase ror-1. - Voir les occurrences de
RP_ID_RORdans la codebase ror-2.
Étape 1 : Implémenter une base de données de comptes partagés
Si vous souhaitez que vos utilisateurs puissent se connecter avec la même clé d'accès sur site-1 et site-2, implémentez une base de données de comptes partagée entre ces deux sites.
Étape 2 : Configurez votre fichier JSON .well-known/webauthn sur site-1
Tout d'abord, configurez site-1.com de manière à autoriser site-2.com à l'utiliser comme ID de RP. Pour ce faire, créez votre fichier JSON webauthn :
{
"origins": [
"https://site-2.com"
]
}
L'objet JSON doit contenir une clé nommée "origins" dont la valeur est un tableau d'une ou de plusieurs chaînes contenant des origines Web.
Limitation importante : 5 libellés maximum
Chaque élément de cette liste sera traité pour extraire l'étiquette eTLD+1.
Par exemple, les libellés eTLD+1 de example.co.uk et example.de sont tous deux example. Toutefois, le libellé eTLD+1 de example-rewards.com est example-rewards.
Dans Chrome, le nombre maximal de libellés est de cinq.
Étape 3 : Diffusez votre fichier JSON .well-known/webauthn sur site-1
Ensuite, diffusez votre fichier JSON sous site-1.com/.well-known/webauthn.
Par exemple, dans Express :
app.get("/.well-known/webauthn", (req, res) => {
const origins = {
origins: ["https://site-2.com"],
};
return res.json(origins);
});
Ici, nous utilisons res.json, qui définit déjà le content-type ('application/json') approprié.
Étape 4 : Spécifiez l'ID de RP dans site-2
Dans votre codebase site-2, définissez site-1.com comme ID de RP partout où cela est nécessaire :
- Lors de la création des identifiants :
- Définissez
site-1.comcomme ID de RP dans lesoptionsde création d'identifiants qui sont transmises à l'appel d'interfacenavigator.credentials.createet généralement générées côté serveur. - Définissez
site-1.comcomme ID de RP attendu, car vous effectuez des vérifications d'identifiants avant de les enregistrer dans votre base de données.
- Définissez
- Après l'authentification :
- Définissez
site-1.comcomme ID de RP dans lesoptionsd'authentification qui sont transmis à l'appel d'interfacenavigator.credentials.getet généralement générés côté serveur. - Définissez
site-1.comcomme ID de RP attendu à valider sur le serveur, car vous effectuez des validations d'identifiants avant d'authentifier l'utilisateur.
- Définissez
Dépannage
Autres points à noter
Partager des clés d'accès entre des sites et des applications mobiles
Les requêtes d'origine associée permettent à vos utilisateurs de réutiliser une clé d'accès sur plusieurs sites. Pour permettre à vos utilisateurs de réutiliser une clé d'accès sur un site Web et une application mobile, utilisez les techniques suivantes :
- Dans Chrome : Digital Asset Links. Pour en savoir plus, consultez Ajouter la prise en charge de Digital Asset Links.
- Dans Safari : Domaines associés.
Partager des mots de passe entre plusieurs sites
Les requêtes d'origine associée permettent à vos utilisateurs de réutiliser une clé d'accès sur plusieurs sites. Les solutions permettant de partager des mots de passe entre plusieurs sites varient d'un gestionnaire de mots de passe à l'autre. Pour le Gestionnaire de mots de passe de Google, utilisez Digital Asset Links . Safari utilise un système différent.
Rôle des gestionnaires d'identifiants et des user-agents
Cela dépasse votre champ d'action en tant que développeur de site, mais notez qu'à plus long terme, l'ID de RP ne devrait pas être un concept visible par l'utilisateur dans l'user-agent ou le Credential Manager utilisé par vos utilisateurs. À la place, les user-agents et les gestionnaires d'identifiants doivent indiquer aux utilisateurs où leurs identifiants ont été utilisés. Ce changement prendra du temps à mettre en œuvre. Une solution temporaire consisterait à afficher à la fois le site Web actuel et le site d'inscription d'origine.