Ключи доступа привязаны к определенному сайту и могут использоваться только для входа на него.
Это указывается в идентификаторе проверяющей стороны (RP ID). Для ключей доступа, созданных для домена example.com, это может быть www.example.com или example.com.
Идентификаторы проверяющей стороны не позволяют использовать ключи доступа как единые учетные данные для аутентификации на всех сайтах, но создают проблемы в следующих случаях:
- Сайты с несколькими доменами. Пользователи не могут использовать один и тот же ключ доступа для входа в домены разных стран (например,
example.comиexample.co.uk), управляемые одной компанией. - Брендированные домены. Пользователи не могут использовать одни и те же учетные данные в разных доменах, принадлежащих одному бренду (например,
acme.comиacmerewards.com). - Мобильные приложения. У них часто нет собственного домена, что усложняет управление учетными данными.
Существуют обходные пути, основанные на федерации идентификационной информации, и другие, основанные на фреймах iframe, но в некоторых случаях они неудобны. Решить эту проблему можно с помощью Related Origin Requests.
Решение
С помощью запросов связанных источников сайт может указать источники, которым разрешено использовать его идентификатор доверяющей стороны.
Это позволит пользователям использовать один и тот же ключ доступа на нескольких ваших сайтах.
Чтобы использовать запросы к связанным источникам, вам нужно разместить специальный JSON-файл по определенному URL https://{RP ID}/.well-known/webauthn. Если example.com хочет разрешить дополнительным источникам использовать его в качестве идентификатора проверяющей стороны, он должен предоставить следующий файл по адресу https://example.com/.well-known/webauthn:
{
"origins": [
"https://example.co.uk",
"https://example.de",
"https://example-rewards.com"
]
}
Когда один из этих сайтов в следующий раз отправит вызов для создания ключа доступа (navigator.credentials.create) или аутентификации (navigator.credentials.get), используя example.com в качестве идентификатора доверяющей стороны, браузер обнаружит, что идентификатор не соответствует источнику запроса. Если браузер поддерживает запросы к связанным источникам, он сначала ищет файл webauthn по адресу https://{RP ID}/.well-known/webauthn. Если файл существует, браузер проверяет, есть ли источник, отправляющий запрос, в allowlist.
Если да, то переходит к созданию ключа доступа или аутентификации.
Если браузер не поддерживает запросы к связанным источникам, он выдает ошибку SecurityError.
Поддержка браузеров
Запросы связанных источников поддерживаются в Chrome и Safari. По состоянию на январь 2026 года Firefox все ещё рассматривает эту функцию. Вы можете отслеживать статус в запросе на позицию Mozilla по стандартам.
Как настроить связанные запросы к источнику
В следующей демонстрации используются два сайта: https://ror-1.glitch.me и https://ror-2.glitch.me.
Чтобы пользователи могли входить в оба аккаунта с помощью одного ключа доступа, компания использует запросы связанных источников, позволяющие ror-2.glitch.me использовать ror-1.glitch.me в качестве идентификатора проверяющей стороны.
Демоверсии
https://ror-2.glitch.me реализует Related Origin Requests, чтобы использовать ror-1.glitch.me в качестве идентификатора проверяющей стороны. Таким образом, и ror-1, и ror-2 используют ror-1.glitch.me в качестве идентификатора проверяющей стороны при создании ключа доступа или аутентификации с его помощью.
Мы также внедрили общую базу данных ключей доступа для этих сайтов.
Пользователь видит следующее:
- Вы можете успешно создать ключ доступа и выполнить аутентификацию с его помощью на
ror-2, даже если его идентификатор RP –ror-1, а неror-2. - Создав ключ доступа на устройстве
ror-1илиror-2, вы сможете использовать его для аутентификации на обоихror-1ror-2устройствах. Поскольку вror-2указан идентификатор проверяющей стороныror-1, создание ключа доступа или запрос аутентификации с любого из этих сайтов равносильны запросу на ror-1. Идентификатор проверяющей стороны – это единственное, что связывает запрос с источником. - Если вы создадите ключ доступа на сайте
ror-1илиror-2, Chrome сможет автоматически подставлять его на обоих сайтахror-1ror-2. - Учетные данные, созданные на любом из этих сайтов, будут иметь идентификатор доверяющей стороны
ror-1.
Посмотреть код
- Посмотрите, как настроен файл
/.well-known/webauthnв базе кода ror-1. - Посмотрите
RP_ID_RORвхождений в базе кода ror-2.
Шаг 1. Реализуйте общую базу данных аккаунтов
Если вы хотите, чтобы пользователи могли входить с одним и тем же ключом доступа на сайты site-1 и site-2, создайте общую базу данных аккаунтов для этих сайтов.
Шаг 2. Настройте JSON-файл .well-known/webauthn на сайте 1
Сначала настройте site-1.com так, чтобы site-2.com мог использовать его в качестве идентификатора проверяющей стороны. Для этого создайте JSON-файл webauthn:
{
"origins": [
"https://site-2.com"
]
}
Объект JSON должен содержать ключ с названием origins, значением которого является массив из одной или нескольких строк, содержащих источники.
Важное ограничение: не более пяти ярлыков
Каждый элемент этого списка будет обработан для извлечения ярлыка eTLD + 1.
Например, ярлыки eTLD + 1 для example.co.uk и example.de – это example. Но у example-rewards.com это example-rewards.
В Chrome можно добавить не более пяти ярлыков.
Шаг 3. Разместите JSON-файл .well-known/webauthn на сайте site-1
Затем разместите файл JSON по адресу site-1.com/.well-known/webauthn.
Например, в Express:
app.get("/.well-known/webauthn", (req, res) => {
const origins = {
origins: ["https://site-2.com"],
};
return res.json(origins);
});
В нашем примере используется фреймворк res.json, который уже задает правильный заголовок content-type ('application/json').
Шаг 4. Укажите идентификатор проверяющей стороны на сайте 2
В базе кода site-2 задайте site-1.com в качестве идентификатора проверяющей стороны везде, где это необходимо:
- После создания учетных данных:
- Укажите
site-1.comв качестве идентификатора проверяющей стороны при создании учетных данных.options, которые передаются в вызов интерфейсаnavigator.credentials.createи обычно генерируются на стороне сервера. - Укажите
site-1.comв качестве ожидаемого идентификатора проверяющей стороны, так как вы проверяете учетные данные перед сохранением в базе данных.
- Укажите
- После аутентификации:
- Укажите
site-1.comв качестве идентификатора проверяющей стороны вoptionsаутентификации, которые передаются в вызов интерфейсаnavigator.credentials.getи обычно генерируются на стороне сервера. - Укажите
site-1.comв качестве ожидаемого идентификатора проверяющей стороны, который будет проверяться на сервере, поскольку вы выполняете проверку учетных данных перед аутентификацией пользователя.
- Укажите
Устранение неполадок
Дополнительные рекомендации
Как использовать ключи доступа на сайтах и в мобильных приложениях
Функция Related Origin Requests позволяет пользователям использовать один ключ доступа на нескольких сайтах. Чтобы пользователи могли использовать один и тот же ключ доступа на сайте и в мобильном приложении, воспользуйтесь следующими методами:
- В Chrome: Digital Asset Links. Подробнее о том, как добавить поддержку протокола Digital Asset Links…
- В Safari: Связанные домены.
Как использовать пароли на разных сайтах
Запросы связанных источников позволяют пользователям использовать один и тот же ключ доступа на разных сайтах. Решения для обмена паролями между сайтами различаются в зависимости от менеджера паролей. Для Google Менеджера паролей используйте [протокол] связи цифровых объектов . В Safari используется другая система.
Роль менеджеров учетных данных и агентов пользователя
Это выходит за рамки вашей компетенции как разработчика сайта, но обратите внимание, что в долгосрочной перспективе идентификатор RP не должен быть концепцией, видимой пользователю в агенте пользователя или менеджере учетных данных, который используют ваши пользователи. Вместо этого агенты пользователя и менеджеры учетных данных должны показывать пользователям, где использовались их учетные данные. Для реализации этого изменения потребуется время. Временным решением может быть показ как текущего сайта, так и исходного сайта регистрации.