Заполнение форм для одноразовых кодов в междоменных элементах iframe с помощью WebOTP API

WebOTP API теперь может получать одноразовые пароли из окон iframe.

Одноразовые пароли, отправляемые по SMS, часто используются для подтверждения номеров телефонов, например в качестве второго этапа аутентификации или для подтверждения платежей в интернете. Однако переключение между браузером и приложением для обмена SMS, чтобы скопировать и вставить или вручную ввести одноразовый код, усложняет процесс и может привести к ошибкам.

WebOTP API позволяет сайтам программно получать одноразовый код из SMS и автоматически вводить его в форму. Пользователю достаточно нажать одну кнопку, не переключаясь между приложениями. SMS имеет специальный формат и привязано к источнику, поэтому мошенникам сложнее украсть одноразовый код.

Один из вариантов использования, который ещё не поддерживается в WebOTP, – таргетинг на источник внутри iframe. Обычно это используется для подтверждения платежа, особенно с помощью 3D Secure. Благодаря общему формату, поддерживающему перекрестные фреймы iframe, WebOTP API теперь доставляет одноразовые пароли, привязанные к вложенным источникам, начиная с Chrome 91.

Как работает WebOTP API

Сам WebOTP API достаточно прост:

…
  const otp = await navigator.credentials.get({
    otp: { transport:['sms'] }
  });
…

SMS должно быть отформатировано с использованием одноразовых кодов, привязанных к источнику.

Your OTP is: 123456.

@web-otp.example.com #12345

Обратите внимание, что в последней строке содержится источник, который нужно связать, перед которым стоит @, а за ним следует одноразовый код, перед которым стоит #.

Когда приходит текстовое сообщение, появляется информационная панель с предложением подтвердить номер телефона. После того как пользователь нажмет кнопку Verify, браузер автоматически перенаправит одноразовый код на сайт и разрешит navigator.credentials.get(). Затем сайт может извлечь одноразовый код и завершить процесс проверки.

Ознакомьтесь с основами использования WebOTP в статье Подтверждение номеров телефонов на сайтах с помощью WebOTP API.

Примеры использования iframe из разных источников

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

Пример:

  • Пользователь заходит на сайт shop.example, чтобы купить пару обуви с помощью кредитной карты.
  • После ввода номера кредитной карты интегрированный поставщик платежных услуг показывает форму от bank.example в окне iframe, в которой пользователю предлагается подтвердить номер телефона для быстрой оплаты.
  • bank.example отправляет пользователю SMS с одноразовым кодом, который нужно ввести для подтверждения личности.

Как использовать WebOTP API из iframe с другим источником

Чтобы использовать WebOTP API из iframe, размещенного на другом источнике, необходимо сделать две вещи:

  • Аннотируйте источник верхнего фрейма и источник iframe в текстовом сообщении SMS.
  • Настройте правила разрешений, чтобы разрешить междоменному iframe получать одноразовый код непосредственно от пользователя.
WebOTP API в iframe в действии.

Вы можете попробовать демо-версию самостоятельно на сайте https://web-otp-iframe-demo.stackblitz.io.

Добавьте в SMS-сообщение аннотацию с указанием связанных источников.

Если WebOTP API вызывается из iframe, текстовое SMS-сообщение должно содержать источник верхнего фрейма, перед которым указан символ @, затем одноразовый код, перед которым указан символ #, и источник iframe, перед которым указан символ @.

@shop.example #123456 @bank.exmple

Как настроить Permissions Policy

Чтобы использовать WebOTP в междоменном окне iframe, встраиваемый объект должен предоставить доступ к этому API через правило разрешений otp-credentials. Это позволит избежать нежелательного поведения. В целом, есть два способа достичь этой цели:

  • В HTTP-заголовке:
Permissions-Policy: otp-credentials=(self "https://bank.example")
  • через атрибут allow тега iframe:
<iframe src="https://bank.example/…" allow="otp-credentials"></iframe>

Ознакомьтесь с другими примерами того, как задать Permissions Policy.

Важные примечания

Уровни вложенности

В настоящее время Chrome поддерживает вызовы WebOTP API только из окон iframe в других источниках, у которых в цепочке предков не более одного уникального источника. В следующих случаях:

  • a.com -> b.com
  • a.com -> b.com -> b.com
  • a.com -> a.com -> b.com
  • a.com -> b.com -> c.com

Использование WebOTP на сайте b.com поддерживается, а на сайте c.com – нет.

Обратите внимание, что следующий сценарий также не поддерживается из-за отсутствия спроса и сложностей с UX.

  • a.com -> b.com -> a.com (вызывает WebOTP API)

Совместимость

Хотя в браузерах, работающих не на Chromium, WebOTP API не реализован, в Safari используется тот же формат SMS с поддержкой input[autocomplete="one-time-code"]. В Safari, как только приходит SMS, содержащее одноразовый код, привязанный к источнику, с соответствующим источником, клавиатура предлагает ввести одноразовый пароль в поле ввода.

С апреля 2021 г. Safari поддерживает iframe с уникальным форматом SMS, в котором используется %. Однако в ходе обсуждения спецификации было решено использовать @, поэтому мы надеемся, что реализация поддерживаемого формата SMS будет унифицирована.

Как оставить отзыв

Ваши отзывы очень важны для улучшения WebOTP API, поэтому попробуйте его и сообщите нам, что вы думаете.

Ресурсы