Что такое OIDC за один экран
OpenID Connect — тонкий слой идентичности поверх OAuth 2.0. Приложение получает два токена:id_token (кто пользователь) и access_token (доступ к API). Приложение не проверяет пароли
само — оно доверяет это issuer’у (authorization server), а тот возвращает подписанные
токены.
Authorization Code Flow + PKCE
Стандартный безопасный поток для веб- и десктоп-приложений:- Приложение перенаправляет пользователя на
/authorizeissuer’а (сstate,nonceи PKCE-параметрами). - Пользователь аутентифицируется на стороне issuer’а.
- Issuer возвращает короткоживущий
codeна зарегистрированныйredirect_uri. - Приложение меняет
code(+ PKCEcode_verifier) на токены через/token.
S256 обязателен для публичных клиентов — он защищает обмен code от
перехвата.
Куда вставляется Veriqa
Veriqa встаёт между шагами 2 и 3 — на месте «пользователь аутентифицируется». Вместо формы входа issuer открывает транзакцию Veriqa: показывает QR-код или точку входа, ждёт подтверждения в доверенном канале, формируетClaimsPrincipal из результата и отдаёт его OpenIddict для
выпуска code. Дальше — обычный OIDC (code → /token → токены).
Эта схема описывает вход. Чтобы подтвердить действие, ваш бэкенд напрямую вызывает
API серверного подтверждения, без перенаправления OIDC.
Полный поток по шагам
От старта транзакции до выпуска токенов OpenIddict.
Адаптер канала в потоке
Адаптер канала (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.
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-хосту.
Подготовка к продакшну
Чек-лист перед продакшном.