Las llaves de acceso están vinculadas a un sitio web específico y solo se pueden usar para acceder al sitio web para el que se crearon.
Esto se especifica en el ID de la parte que confía (ID de RP), que, para las llaves de acceso creadas para el dominio example.com, podría ser www.example.com o example.com.
Si bien los IDs de RP evitan que las llaves de acceso se usen como una credencial única para autenticarse en cualquier lugar, crean problemas para lo siguiente:
- Sitios con varios dominios: Los usuarios no pueden usar la misma llave de acceso para acceder a diferentes dominios específicos de un país (por ejemplo,
example.comyexample.co.uk) administrados por la misma empresa. - Dominios de marca: Los usuarios no pueden usar la misma credencial en
diferentes dominios que use una sola marca (por ejemplo,
acme.comyacmerewards.com). - Apps para dispositivos móviles: Las apps para dispositivos móviles no suelen tener su propio dominio, lo que dificulta la administración de credenciales.
Existen soluciones alternativas basadas en la federación de identidades y otras basadas en iframes, pero, en algunos casos, no son convenientes. Las solicitudes de origen relacionado ofrecen una solución.
Solución
Con las solicitudes de origen relacionadas, un sitio web puede especificar los orígenes que pueden usar su ID de RP.
Esto permite que los usuarios reutilicen la misma llave de acceso en varios sitios que administras.
Para usar las solicitudes de origen relacionadas, debes entregar un archivo JSON especial en una
URL específica https://{RP ID}/.well-known/webauthn. Si example.com quiere permitir que los orígenes adicionales lo usen como un ID de RP, debe entregar el siguiente archivo en https://example.com/.well-known/webauthn:
{
"origins": [
"https://example.co.uk",
"https://example.de",
"https://example-rewards.com"
]
}
La próxima vez que cualquiera de estos sitios realice una llamada para crear una llave de acceso (navigator.credentials.create) o autenticar (navigator.credentials.get) que use example.com como ID de RP, el navegador notará que el ID de RP no coincide con el origen de la solicitud. Si el navegador admite solicitudes de origen relacionadas, primero busca un archivo webauthn en https://{RP ID}/.well-known/webauthn. Si el archivo existe,
el navegador verifica si el origen que realiza la solicitud está en la allowlist.
Si es así, se procede a los pasos de creación o autenticación de la llave de acceso.
Si el navegador no admite solicitudes de origen relacionadas, arroja un SecurityError.
Navegadores compatibles
Las solicitudes de origen relacionadas son compatibles con Chrome y Safari. A partir de enero de 2026, Firefox aún está considerando la función. Puedes hacer un seguimiento de su estado en el problema de posición de los estándares de Mozilla.
Configura solicitudes de origen relacionadas
En la siguiente demostración, se usan dos sitios: https://ror-1.glitch.me y https://ror-2.glitch.me.
Para permitir que los usuarios accedan con la misma llave de acceso en ambos sitios, se usan solicitudes de origen relacionadas para permitir que ror-2.glitch.me use ror-1.glitch.me como su ID de RP.
Demostración
https://ror-2.glitch.me implementa solicitudes de origen relacionadas para usar ror-1.glitch.me como ID de RP, por lo que tanto ror-1 como ror-2 usan ror-1.glitch.me como ID de RP cuando se crea una llave de acceso o se autentica con ella.
También implementamos una base de datos de llaves de acceso compartida en estos sitios.
Observa la siguiente experiencia del usuario:
- Puedes crear correctamente una llave de acceso y autenticarte con ella en
ror-2, aunque su ID de RP searor-1(y noror-2). - Una vez que crees una llave de acceso en
ror-1oror-2, podrás autenticarte con ella en ambosror-1ror-2sistemas operativos. Comoror-2especificaror-1como un ID de RP, realizar una solicitud de creación o autenticación de llave de acceso desde cualquiera de estos sitios es lo mismo que realizar la solicitud en ror-1. El ID de RP es lo único que vincula una solicitud con un origen. - Una vez que crees una llave de acceso en
ror-1oror-2, Chrome podrá autocompletarla en ambosror-1ror-2sistemas operativos. - Una credencial creada en cualquiera de estos sitios tendrá un ID de RP de
ror-1.
Consulta el código:
- Consulta la configuración del archivo
/.well-known/webauthnen la base de código ror-1. - Consulta las repeticiones de
RP_ID_RORen la base de código ror-2.
Paso 1: Implementa una base de datos de cuentas compartidas
Si quieres que tus usuarios puedan acceder con la misma llave de acceso en
site-1 y site-2, implementa una base de datos de cuentas que se comparta entre estos
dos sitios.
Paso 2: Configura tu archivo JSON .well-known/webauthn en site-1
Primero, configura site-1.com de modo que permita que site-2.com lo use como un
ID de RP. Para ello, crea tu archivo JSON de webauthn:
{
"origins": [
"https://site-2.com"
]
}
El objeto JSON debe contener una clave llamada origins cuyo valor sea un array de una o más cadenas que contengan orígenes web.
Limitación importante: 5 etiquetas como máximo
Cada elemento de esta lista se procesará para extraer la etiqueta de eTLD+1.
Por ejemplo, las etiquetas de eTLD+1 de example.co.uk y example.de son example. Sin embargo, la etiqueta eTLD+1 de example-rewards.com es example-rewards.
En Chrome, la cantidad máxima de etiquetas es 5.
Paso 3: Entrega tu JSON .well-known/webauthn en site-1
Luego, entrega tu archivo JSON en site-1.com/.well-known/webauthn.
Por ejemplo, en Express:
app.get("/.well-known/webauthn", (req, res) => {
const origins = {
origins: ["https://site-2.com"],
};
return res.json(origins);
});
Aquí, usamos res.json de Express, que ya establece el
content-type correcto ('application/json').
Paso 4: Especifica el ID de RP en site-2
En tu base de código de site-2, establece site-1.com como el ID de RP en todos los lugares necesarios:
- Cuando se crean las credenciales, ocurre lo siguiente:
- Establece
site-1.comcomo el ID de RP en lasoptionsde creación de credenciales que se pasan a la llamada de frontendnavigator.credentials.createy que, por lo general, se generan del lado del servidor. - Establece
site-1.comcomo el ID de RP esperado, ya que ejecutas verificaciones de credenciales antes de guardarlas en tu base de datos.
- Establece
- Después de la autenticación, ocurrirá lo siguiente:
- Establece
site-1.comcomo el ID de RP en lasoptionsde autenticación que se pasan a la llamada de frontendnavigator.credentials.gety, por lo general, se generan del lado del servidor. - Establece
site-1.comcomo el ID de RP esperado que se verificará en el servidor, ya que ejecutas verificaciones de credenciales antes de autenticar al usuario.
- Establece
Solución de problemas
Otras consideraciones
Cómo compartir llaves de acceso entre sitios y apps para dispositivos móviles
Las solicitudes de origen relacionadas permiten que los usuarios reutilicen una llave de acceso en varios sitios. Para permitir que tus usuarios reutilicen una llave de acceso en un sitio web y una app para dispositivos móviles, usa las siguientes técnicas:
- En Chrome: Vínculos de recursos digitales. Obtén más información en Cómo agregar compatibilidad con Vínculos de recursos digitales.
- En Safari: Dominios asociados.
Comparte contraseñas entre sitios
Las solicitudes de origen relacionadas permiten que tus usuarios reutilicen una llave de acceso en varios sitios. Las soluciones para compartir contraseñas entre sitios varían según el administrador de contraseñas. Para el Administrador de contraseñas de Google, usa los Vínculos de recursos digitales . Safari tiene un sistema diferente.
Rol de los administradores de credenciales y los usuarios-agentes
Esto va más allá de tu alcance como desarrollador del sitio, pero ten en cuenta que, a largo plazo, el ID de RP no debería ser un concepto visible para el usuario en el usuario-agente ni en el Credential Manager que usan tus usuarios. En su lugar, los usuarios-agentes y los administradores de credenciales deben mostrarles a los usuarios dónde se usaron sus credenciales. Este cambio llevará tiempo implementarlo. Una solución temporal sería mostrar el sitio web actual y el sitio de registro original.