Как разрешить повторное использование ключей доступа на сайтах с помощью Related Origin Requests

Ключи доступа привязаны к определенному сайту и могут использоваться только для входа на него.

Это указывается в идентификаторе проверяющей стороны (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.
Chrome будет автоматически заполнять данные на обоих сайтах.
Благодаря Related Origin Requests пользователи могут использовать один и тот же ключ доступа на ror-1 и ror-2. Chrome также автоматически заполнит учетные данные.

Посмотреть код

Шаг 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 в качестве ожидаемого идентификатора проверяющей стороны, который будет проверяться на сервере, поскольку вы выполняете проверку учетных данных перед аутентификацией пользователя.

Устранение неполадок

Всплывающее окно с сообщением об ошибке в Chrome.
Сообщение об ошибке в Chrome при создании учетных данных. Эта ошибка возникает, если файл `.well-known/webauthn` не найден по адресу `https://{RP ID}/.well-known/webauthn`.
Всплывающее окно с сообщением об ошибке в Chrome.
Сообщение об ошибке в Chrome при создании учетных данных. Эта ошибка возникает, если файл.well-known/webauthn найден, но в нем не указан источник, из которого вы пытаетесь создать учетные данные.

Дополнительные рекомендации

Как использовать ключи доступа на сайтах и в мобильных приложениях

Функция Related Origin Requests позволяет пользователям использовать один ключ доступа на нескольких сайтах. Чтобы пользователи могли использовать один и тот же ключ доступа на сайте и в мобильном приложении, воспользуйтесь следующими методами:

Как использовать пароли на разных сайтах

Запросы связанных источников позволяют пользователям использовать один и тот же ключ доступа на разных сайтах. Решения для обмена паролями между сайтами различаются в зависимости от менеджера паролей. Для Google Менеджера паролей используйте [протокол] связи цифровых объектов . В Safari используется другая система.

Роль менеджеров учетных данных и агентов пользователя

Это выходит за рамки вашей компетенции как разработчика сайта, но обратите внимание, что в долгосрочной перспективе идентификатор RP не должен быть концепцией, видимой пользователю в агенте пользователя или менеджере учетных данных, который используют ваши пользователи. Вместо этого агенты пользователя и менеджеры учетных данных должны показывать пользователям, где использовались их учетные данные. Для реализации этого изменения потребуется время. Временным решением может быть показ как текущего сайта, так и исходного сайта регистрации.