Что такое вход через Fidmos

Fidmos — централизованный провайдер идентичности (SSO) на OAuth2 с расширением OpenID Connect. Продукты Fidmos и партнёрские сайты выступают OAuth2-клиентами: они приводят пользователя к нам, получают код и меняют его на токен.

Две формы входа

Встроенное окно — форма входа рисуется нашим скриптом (sdk.js) прямо в документе партнёра, поверх его страницы. Пользователь не уходит на сторонний домен.
Редиректный путь — классический OAuth2: браузер уходит на /oauth/authorize, пользователь входит и возвращается с кодом.

Обе кончаются одинаково: партнёр получает код авторизации и меняет его на токен через POST /oauth/token.

Версии API

Наши собственные адреса живут под /api/v1/ — встройка (/api/v1/embed/*) и Server-to-Server API (/api/v1/users). Ломающее изменение контракта выйдет новым префиксом /api/v2/, рядом со старым. Протокольные адреса версии не несут: /oauth/* и /.well-known/* заданы спецификациями OAuth 2.0 и OpenID Connect — их пути фиксированы.

Парный `sub`

Идентификатор пользователя наружу — это поле sub. Оно парное (в терминах OIDC — pairwise, идентификатор типа PPID): для каждого партнёра свой стабильный идентификатор одного и того же человека.

Федеративный, а не единый вход

Вход через Fidmos на одном партнёрском сайте не заводит сессию на другом. Со второго сайта человека спрашивают заново — код из письма, подпись кошелька или Telegram. Это осознанное устройство: каждый партнёр проводит вход сам.

Способы входа

Человек может войти кодом из письма, через Telegram или подписью кошелька (EVM). Какой способ он выбрал — детали окна; вам приходит один результат: код авторизации и, после обмена, sub. Почты у пользователя может не быть вовсе (вход кошельком или Telegram) — тогда в claims не будет email и email_verified.

Практическая интеграция — в быстром старте и справочнике API.