Skip to main content
В hop-режиме QR-код на странице входа несёт не ссылку мессенджера, а короткую одноразовую ссылку на ваш сервер Veriqa. Телефон открывает её, сервер отмечает скан и отправляет пользователя дальше — в мессенджер или почту. Этот один лишний переход и даёт лучший пользовательский опыт, который есть в Veriqa.
Hop-режим рекомендуем включать. По умолчанию он выключен только потому, что ему нужен issuer, заданный абсолютным адресом https и доступный телефону. Как включить — ниже.

​
Главные отличия

​
Как это выглядит для пользователя

  1. На компьютере, телевизоре или терминале пользователь сканирует QR-код камерой телефона.
  2. Телефон открывает короткую ссылку. Страница входа на компьютере в ту же секунду пишет «QR-код отсканирован» и показывает, что делать дальше.
  3. Телефон переходит в мессенджер — сразу или через страницу запуска, смотря по стилю перехода.
  4. Пользователь подтверждает вход одним касанием, и вход завершается на компьютере.
Отсканировал не тем устройством или передумал — кнопка «Выбрать другой способ» возвращает выбор каналов на той же странице, с тем же входом. Как только канал ответил на старт, кнопка уходит: вход уже привязан к этому каналу.

​
Стиль перехода

Interstitial надёжнее там, где прямой переход в приложение мессенджера срабатывает не всегда. У канала Email свои правила — см. Email в hop-режиме.

​
Как включить

appsettings.json
Режим включается для всего сервера, для отдельного канала (Veriqa:Channels:{Channel}:HopEnabled) или для одного приложения — в записи его OIDC-клиента. Все ключи и порядок, в котором они перекрывают друг друга, — в справочнике Veriqa:HopMode. Каждая hop-ссылка строится на Veriqa:OpenIddict:Server:Issuer, поэтому при включённом режиме issuer обязан быть абсолютным адресом https — иначе сервер не стартует. Чтобы попробовать режим на своей машине, выставьте Veriqa через HTTPS-туннель — см. Локальная проверка интеграции.

​
Безопасность

  • Это не сокращатель ссылок. Куда вести пользователя, сервер всегда выводит из транзакции, а не берёт из ссылки, — открытым редиректом hop-ссылку не сделать.
  • Контекст сканирующего телефона — сигнал риска, а не фактор аутентификации. Он помогает распознать чужой запрос, но вход по-прежнему подтверждает сам пользователь в своём мессенджере. Что собирать, решают ключи HopMode.Collect*: IP, браузер и тип устройства — по умолчанию да, отпечаток браузера и геолокация — только если вы их включили.