Autorisez la réutilisation des clés d'accès sur vos sites avec les requêtes d'origine associées

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.com et example.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.com et acmerewards.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.

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 est ror-1 (et non ror-2).
  • Une fois que vous avez créé une clé d'accès sur ror-1 ou ror-2, vous pouvez l'utiliser pour vous authentifier sur les deux ror-1ror-2. Comme ror-2 spécifie ror-1 en 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-1 ou ror-2, Chrome peut la saisir automatiquement sur ror-1 et ror-2.
  • Un identifiant créé sur l'un de ces sites aura un ID de RP de ror-1.
Chrome utilise la saisie automatique sur les deux sites.
Grâce aux requêtes d'origine associée, les utilisateurs peuvent utiliser les mêmes identifiants de clé d'accès sur ror-1 et ror-2. Chrome saisira également automatiquement les identifiants.

Voir le code :

É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.com comme ID de RP dans les options de création d'identifiants qui sont transmises à l'appel d'interface navigator.credentials.create et généralement générées côté serveur.
    • Définissez site-1.com comme ID de RP attendu, car vous effectuez des vérifications d'identifiants avant de les enregistrer dans votre base de données.
  • Après l'authentification :
    • Définissez site-1.com comme ID de RP dans les options d'authentification qui sont transmis à l'appel d'interface navigator.credentials.get et généralement générés côté serveur.
    • Définissez site-1.com comme ID de RP attendu à valider sur le serveur, car vous effectuez des validations d'identifiants avant d'authentifier l'utilisateur.

Dépannage

Pop-up de message d'erreur dans Chrome.
Message d'erreur dans Chrome lors de la création d'identifiants. Cette erreur est générée si votre fichier `.well-known/webauthn` est introuvable à l'emplacement `https://{RP ID}/.well-known/webauthn`.
Pop-up de message d'erreur dans Chrome.
Message d'erreur dans Chrome lors de la création d'un identifiant. Cette erreur est générée si votre fichier `.well-known/webauthn` est trouvé, mais qu'il ne liste pas l'origine à partir de laquelle vous essayez de créer un identifiant.

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 :

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.