Verificahub ID

Verificahub ID — готовая страница входа по номеру телефона. Вы отправляете пользователя на id.verificahub.ru, он входит удобным способом и возвращается к вам, а ваш сервер получает его подтверждённый номер и подписанное подтверждение (JWT).

Поток устроен как OAuth 2.0 authorization code: браузер только проходит через страницу входа, а номер ваш сервер забирает напрямую у нас — по одноразовому коду и секрету клиента.

Verificahub ID или API

	Verificahub ID	Verificahub API
Интерфейс	готовая страница входа под ваш бренд	строите сами
Что делает ваш сервер	перенаправляет пользователя и меняет код на номер	создаёт сессию, принимает вебхуки, проверяет коды
Результат	номер + JWT, подписанный Verificahub	статус сессии
Подходит, когда	нужен вход по номеру быстро и без своего UI	нужен полный контроль над интерфейсом

Как это работает

Пошагово — в разделе Подключение, про всплывающее окно и мобильные приложения — в разделе Где открывать страницу.

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

Набор и порядок способов задаются в настройках клиента. Либо пользователь выбирает способ сам (choice), либо страница сразу просит номер, а способ выбирает Verificahub по списку (ladder).

По номеру телефона — номер проверяет Verificahub:

Способ	method	Уровень acr
SIM-push (МТС «Мобильный ID») — запрос на SIM-карту, без ввода кода	mts_id	high
Звонок — код это последние цифры номера, с которого мы звоним	flash_call	medium
SMS с кодом	sms	medium
Код в Telegram	telegram_otp	medium
Код в MAX	max_otp	medium
Бот MAX — пользователь открывает бота и делится номером, бот присылает код	max_bot	medium
«Позвонить нам» — пользователь звонит на наш номер, номер сверяется по Caller ID	reverse_flash_call	low

Через аккаунт — номер отдаёт провайдер, у которого пользователь его уже подтверждал:

Провайдер	method	Уровень acr
Яндекс ID	yandex	low
VK ID	vk	low

Уровень low у двух способов, и по разным причинам. При «позвонить нам» никакой секрет не передаётся: мы сверяем номер входящего вызова, а его можно подделать. При входе через аккаунт провайдер ручается за номер, подтверждённый когда-то, а не за SIM-карту в руках пользователя прямо сейчас. Если вам важно владение номером в момент входа — проверяйте acr и при low запрашивайте код. Сбер ID, T-ID и МТС ID — в разработке.

Что получает ваш сервер

• Номер телефона в формате E.164 (+79991234567).
• Способ входа (method) и уровень доверия (acr).
• Подтверждение — JWT, подписанный ключом Verificahub ID. Именно ему стоит доверять, а не остальным полям ответа: подпись проверяется по открытым ключам https://id-api.verificahub.ru/.well-known/jwks.json.

Пароли, коды и данные карт пользователя Verificahub ID не запрашивает и не передаёт.