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