Перейти к основному содержанию
Чувствительные действия — удаление важных данных, смена реквизитов, выдача кому-то доступа, подтверждение платежа — стоит подтверждать заново, даже если пользователь уже вошёл. Veriqa делает это одним нажатием в мессенджере, а не кодом из SMS. Способов два. Повторный вход подходит, когда нужно убедиться, что за экраном тот же человек. Подтверждение действия — когда человек должен увидеть, что именно он подтверждает, например сумму и получателя платежа.

Что отправляете

Новый authorize-запрос перед самим действием, такой же, как при входе:

Что проверяете

В новом id_token проверьте два claim:
  • sub — тот же человек. Выполняйте операцию, только если это sub вошедшего пользователя или, после подтверждения в другом канале, sub, привязанный к его учётной записи (см. Два разных канала). Без этой проверки тот, кто перехватил сессию, подтвердит операцию в своём мессенджере.
  • auth_time — свежее подтверждение, момент его завершения. Свежесть определяете вы: сравните auth_time с текущим временем и решите, укладывается ли он в приемлемое для этой операции окно.
Не доверяйте своей локальной куке. Признак свежего подтверждения — auth_time из нового id_token, а не наличие сессии в вашем приложении: сессия говорит лишь о том, что человек когда-то вошёл.
max_age ядро не читает. Стандартный маркер OIDC max_age=0 посылать не вредно, но на поведение Veriqa он не влияет — не стройте на нём логику. Механизм свежести здесь один: новый authorize плюс проверка auth_time.

Почему это работает

Обходить нечего: долгоживущей сессии у issuer’а нет. Единственная кука между callback и authorize одноразовая и снимается сразу при выдаче кода, поэтому каждый свежий authorize-запрос заново спрашивает подтверждение в канале.

Усиление: два разных канала

Одну чувствительную операцию можно подтвердить в двух разных доверенных каналах — например WhatsApp плюс Email. Сузить канал конкретного запроса помогает параметр acr_values:
Несколько значений разделяются пробелом — тогда пользователь выбирает из перечисленных. У одного человека в каждом канале свой sub, поэтому подтверждение в другом канале вернёт не тот sub, с которым пользователь вошёл. Храните у учётной записи sub каждого привязанного канала и проверяйте, что новый sub — один из них, как в сценарии «Усиленный вход цепочкой каналов». sub, которого у учётной записи нет, проверку не проходит, каким бы свежим ни был auth_time. Проверяйте и amr: он должен называть канал из ваших acr_values, но не тот, которым пользователь вошёл. Запрос идёт через браузер пользователя, acr_values из него можно убрать, и тогда новый id_token может прийти из того же канала, через который пользователь вошёл.

Добор профиля попутно

Подтверждение — удобный момент, чтобы получить недостающие данные: если запросить scope=email или phone, приложение получает верифицированный контакт прямо в ходе подтверждения, без отдельной формы и отдельной проверки. Состав claims зависит от канала.

Подтверждение конкретного действия

Подтверждение действия через Veriqa: сервер создаёт транзакцию, пользователь сканирует QR-код, который показывает приложение, подтверждает в канале, а сервер читает ответ и выполняет действие.
Когда человек должен увидеть, что подтверждает, бэкенд создаёт серверную транзакцию: POST /api/transaction/confirmation с объявленным типом действия и значениями его слотов. Человек получает в мессенджере сообщение с самим действием, например «Одобрить платёж 42.00 EUR в пользу ACME Ltd?», и подтверждает его. Чтобы принять подтверждение только от владельца учётной записи, бэкенд передаёт expected_identities и сверяет matched_type в результате. Браузер в этом не участвует: бэкенд получает токен по client credentials и дожидается итога транзакции.
Подтверждение действия: приложение показывает QR-код для выдачи роли «Администратор», камера телефона его сканирует, пользователь подтверждает в MAX, бот отвечает «Подтверждено».

Приложение показывает QR-код, пользователь подтверждает выдачу роли в MAX.

Готовый пример — samples/dotnet/inproc/step-up, остальные — на странице «Step-up, второй фактор, HIL». Поля и ошибки описаны в справочнике «API серверного подтверждения».
Посмотреть вживую. В онлайн-примере Helio закрытие и удаление тикета подтверждаются в мессенджере, в Nova Stream — покупка фильма. Подтвердить может только тот, кто вошёл.