Перейти к основному содержанию
Подтверждение происходит на телефоне, а инициатор ждёт на другом устройстве. Отсюда вопрос, который на обычном OIDC-провайдере не возникает: как инициатор узнаёт, что вход подтверждён? Способов три, и они не альтернативы друг другу, а разные уровни: возврат по redirect — обязателен всегда, живой статус и опрос — про то, что показывать пользователю, пока он ждёт.

1. Возврат по redirect_uri — основной путь

Итог входа приходит так же, как в любом OIDC: браузер инициатора возвращается на redirect_uri с кодом авторизации, приложение меняет его на токены. Ничего специфичного для Veriqa здесь нет. Этого достаточно для веб-приложения на десктопе: страница входа сама доводит пользователя до возврата.
В query возврата передаётся iss (RFC 9207). Строгой проверяющей стороне стоит сверять его со своим ожидаемым issuer — это дешёвая защита от подмены провайдера.

2. Живой статус — SignalR

Пока человек берёт телефон, сканирует код и нажимает кнопку, инициатор может показывать состояние: «ждём подтверждения», «подтверждено», «отклонено». Для этого есть хаб /hubs/auth — страница входа Veriqa использует его сама, и он же доступен вашей поверхности. Это то, что делает ожидание понятным на телевизоре или киоске, где пользователь не смотрит в адресную строку.

3. Опрос статуса — запасной путь

Там, где WebSocket недоступен (жёсткий прокси, ограниченная сеть, встроенное устройство), остаётся опрос:
Этот эндпоинт — про опрос состояния текущего входа. Подтверждение, которое создаёт ваш сервер, идёт через отдельные эндпоинты: POST /api/transaction/confirmation создаёт транзакцию подтверждения (приложение аутентифицируется по client credentials и получает transaction_id с точкой входа для пользователя), а GET /api/transaction/{id}/result отдаёт её исход (токен приложения обязателен). Полный контракт — в API серверного подтверждения.Если в запросе создания передать include_channel_entries: true, ответ дополнительно несёт channel_entries — deep link с QR-кодом по каждому доступному каналу — рядом с единственным channel_entry, который остаётся прежним. Какие каналы попадут в список и в каком порядке, задаёт конфигурация показа каналов (включая запись ui_config), а не ваш запрос. Канал без адреса, который можно открыть, — например Email в Pull-режиме — в список не попадает, а если подтверждение настроено на веб-странице, массив пуст. Показать ли одну точку входа из списка — решаете вы. response_valid_until тогда — самый ранний момент среди всех отданных точек входа.После исхода confirmed клиент, которому это разрешил интегратор, может получить и id_token подтвердившего — см. привязку с сервера.

Канал Email ведёт себя иначе

Важное для интегратора отличие: шаг веб-подтверждения зависит от канала.
  • на Telegram возврат /connect/authorize/callback сразу отдаёт редирект: человек уже нажал «да» в мессенджере;
  • на Email тот же адрес показывает страницу «Подтвердите вход» с формой — без её отправки кода не будет.
Причина: клик по ссылке из письма не доказывает, что за браузером тот же человек. Но интегратор, отладивший поток на Telegram, на Email упирается в «лишний» экран — это свойство канала, а не сбой. Страница «Подтвердите вход» задаёт тот же вопрос, что пришёл бы в чат мессенджера, и своей строки с аккаунтом не добавляет. Аккаунт, которым выполняется вход, вопрос называет, только если ваша формулировка confirmation-prompt использует слоты аккаунта под маской — например, номер телефона, скрытый до четырёх последних цифр. Поставляемая формулировка их не использует. Страницу может держать не владелец аккаунта, и аккаунт, названный в вопросе, позволяет ему отказаться от входа в чужой аккаунт — см. Veriqa:MessageTemplates. Оба ответа возвращают браузер на ваш redirect_uri, в том числе на другом домене. Ссылка в письме транзакции подтверждения (действия, которое ваше приложение просит подтвердить, а не входа) открывает ту же страницу, что ссылка письма входа, только с формулировками подтверждения. Страница предлагает «Продолжить подтверждение» и «Отмена». В браузере, участвовавшем в подтверждении, она продолжает сама, без нажатия. Открытие ссылки ничего не меняет, поэтому почтовый сканер, переходящий по ссылкам, ни за кого не действует. «Продолжить подтверждение» ведёт на страницу, где показано, что именно подтверждается. Ответ принимается только в браузере, прошедшем по ссылке: окно, открытое на другом устройстве, видит нейтральную страницу, а отвечает человек там, где читает письмо.

Что после подтверждения

Поведение окна после успеха настраивается (закрыть, показать сообщение, автоматически продолжить) на стороне конфигурации входа — набором настроек, который владелец проекта или интегратор назначает клиенту. Само получение токенов от этого не зависит.

Дальше

Поверхности входа

Чем ТВ и киоск отличаются от десктопа.

Диагностика

Что означают отказы на callback.