Перейти к основному содержанию
Этот разбор — для разработчиков, которые работали с OIDC, но не с Veriqa. Он показывает, где именно Veriqa встраивается в стандартный поток и где останавливается.

Что такое OIDC за один экран

OpenID Connect — тонкий слой идентичности поверх OAuth 2.0. Приложение получает два токена: id_token (кто пользователь) и access_token (доступ к API). Приложение не проверяет пароли само — оно доверяет это issuer’у (authorization server), а тот возвращает подписанные токены.

Authorization Code Flow + PKCE

Стандартный безопасный поток для веб- и десктоп-приложений:
  1. Приложение перенаправляет пользователя на /authorize issuer’а (с state, nonce и PKCE-параметрами).
  2. Пользователь аутентифицируется на стороне issuer’а.
  3. Issuer возвращает короткоживущий code на зарегистрированный redirect_uri.
  4. Приложение меняет code (+ PKCE code_verifier) на токены через /token.
PKCE с методом S256 обязателен для публичных клиентов — он защищает обмен code от перехвата.

Куда вставляется Veriqa

Veriqa встаёт между шагами 2 и 3 — на месте «пользователь аутентифицируется». Вместо формы входа issuer открывает транзакцию Veriqa: показывает QR-код или точку входа, ждёт подтверждения в доверенном канале, формирует ClaimsPrincipal из результата и отдаёт его OpenIddict для выпуска code. Дальше — обычный OIDC (code → /token → токены). Эта схема описывает вход. Чтобы подтвердить действие, ваш бэкенд напрямую вызывает API серверного подтверждения, без перенаправления OIDC.

Полный поток по шагам

От старта транзакции до выпуска токенов OpenIddict.
Ключевое: Veriqa не заменяет OpenIddict — выпуск токенов, discovery, JWKS, refresh остаются за ним. Veriqa лишь поставляет аутентификацию пользователя через доверенный канал.

Адаптер канала в потоке

Адаптер канала (MAX / Telegram / WhatsApp / другие мессенджеры / Email) связывает транзакцию с конкретным мессенджером: доставляет запрос подтверждения пользователю, принимает его ответ и возвращает в транзакцию установленную идентичность пользователя. Каждый канал — отдельный адаптер, набор расширяем.

Resolved identity и claims

После подтверждения Veriqa формирует снимок идентичности и преобразует его в OIDC claims: channel — собственный scope Veriqa: канальные claims выдаются только с ним. Не запросили — эти два claim не попадут ни в access_token, ни в id_token, ни в ответ /connect/userinfo. Добавьте channel в запрашиваемые scopes RP и в AllowedScopes клиента, если ваше приложение их читает. avatar — второй собственный scope Veriqa: без него picture не выдаётся. Значение — само изображение в виде URI data:image/…;base64,… (канал с публичной ссылкой на фото, например MAX, может отдать https URL). Claim попадает только в access_token, поэтому доходит до вас только через /connect/userinfo; в id_token он не попадает никогда. Запросите avatar (и добавьте его в AllowedScopes клиента), заберите claims из userinfo (GetClaimsFromUserInfoEndpoint = true в ASP.NET Core); нет picture — нет аватара. В ASP.NET Core picture по умолчанию в principal не маппится, и маппить его не нужно: data URI в cookie аутентификации раздувает заголовки запросов. Берите изображение из JSON userinfo в OnUserInformationReceived и храните в своём хранилище. /connect/userinfo отдаёт только те claims, что разрешены scopes и конфигурацией. Набор маппинга переопределяется своим IClaimsMapper.
preferred_username — подсказка, а не идентичность. В канале Email (режим Push) в него попадает display name отправителя — строка, которую пишет сам отправитель в заголовке From. SPF, DKIM и DMARC её не подтверждают: они проверяют домен и адрес, но не отображаемое имя. Veriqa очищает значение (убирает bidi-override и управляющие символы, обрезает по длине), но подтвердить его не может.Идентификатор пользователя — только sub; подтверждённый адрес — email рядом с email_verified. Не сопоставляйте по preferred_username учётные записи и не показывайте его как проверенное имя.

Step-up и подтверждение в терминах OIDC

2FA и step-up — не отдельные типы транзакции. Step-up — это новый запрос authorize перед чувствительным действием, то есть обычная транзакция login: приложение проверяет sub и auth_time в новом id_token (Второй фактор и step-up). Чтобы подтвердить конкретное действие, например платёж с суммой и получателем, ваш бэкенд вызывает API серверного подтверждения: это транзакция confirmation в том же доверенном канале, без перенаправления OIDC.

Чего Veriqa НЕ делает

Veriqa — OpenID Connect провайдер, но не IAM: она не хранит учётные записи пользователей и не управляет ими. Veriqa добавляет к вашей системе способ входа и привязку каналов, а пользовательская база остаётся у вас.

Дальше

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

Подключите Veriqa к ASP.NET Core-хосту.

Подготовка к продакшну

Чек-лист перед продакшном.