Перейти к основному содержанию
Veriqa работает внутри вашего ASP.NET Core-хоста и работает как сервер авторизации на OpenIddict. Поток входа всегда один и тот же: старт транзакции, подтверждение в доверенном канале на телефоне, завершение аутентификации в OpenIddict. Для приложения это обычный OIDC Authorization Code Flow — Veriqa лишь заменяет форму входа на подтверждение в мессенджере.
Вход через Veriqa: приложение отправляет браузер на страницу входа редиректом OpenID Connect, в окне входа QR-код, камера телефона его сканирует, пользователь нажимает «Подтвердить» в MAX, Veriqa возвращает браузер, и приложение получает обычные токены OpenID Connect с claims, например sub, name, phone_number и email.

Что видит пользователь: QR-код в окне входа, камера телефона, одно касание в MAX.

Шаг за шагом

1

Старт транзакции

Приложение перенаправляет пользователя на /connect/authorize. Veriqa открывает транзакцию с контекстом клиента, correlation id, временем жизни и выбранным каналом, и показывает страницу входа с QR-кодом и кнопками каналов.
2

Подтверждение в канале

Пользователь открывает доверенный канал на телефоне (MAX / Telegram / WhatsApp / другие мессенджеры / Email) и подтверждает вход. Адаптер канала возвращает в транзакцию установленную идентичность пользователя.
3

Завершение

Десктоп узнаёт о завершении по живому статусу (SignalR) или опросом статуса транзакции, после чего Veriqa формирует ClaimsPrincipal и передаёт его OpenIddict.
4

Выпуск токенов

OpenIddict выпускает authorization code, приложение меняет его на токены через /connect/token. Дальше — стандартный OIDC.

Повторный вход

Пользователь может начать вход в то же приложение заново — в новой вкладке или вторым сканированием — и прийти в канал тем же аккаунтом. Тогда его прежние входы в это приложение, ещё ждущие ответа, закрываются, включая вход, который ждёт недостающих claims. Остаётся только тот, что привязан к аккаунту канала последним:
  • в чат о закрытых входах ничего не приходит — ни квитанции, ни сообщения «время истекло». Вопрос, оставшийся в чате, на нажатие отвечает обычной квитанцией истечения;
  • их открытые страницы показывают экран истечения и остаются на месте: по входу, который пользователь оставил, ваше приложение не получает error на redirect_uri;
  • в событиях, журнале аудита и статусе транзакции такой вход — транзакция Failed с причиной superseded_by_new_sign_in; в метриках его исход — superseded.
Входы сопоставляются по тенанту, приложению, типу канала и идентификатору пользователя в этом канале — в момент, когда новый вход впервые привязывается к аккаунту канала: старт в мессенджере, ссылка из письма, входящее письмо. Уже завершённый вход и серверное подтверждение так не закрываются.

Термины Veriqa и OIDC

Дальше

OIDC + Veriqa: разбор

Где именно Veriqa встаёт в стандартный OIDC-поток — и чего не делает.

Быстрый старт .NET

Подключите поток в своём приложении.