Введение
Что такое Tapok и как подключить вход через Сбер ID.
Tapok
Tapok — платформа авторизации через Сбер ID и открытый TypeScript SDK @orria/tapok. SDK отвечает за OAuth Authorization Code Flow, PKCE и интеграцию с browser/framework-приложениями. Доступ к платформе и Connect-приложениям управляется Tapok.
Два режима
Hosted и Connect используют единый unversioned API Tapok. Hosted не требует регистрации; для Connect требуется зарегистрированное приложение или доступ Tapok.
Hosted
Hosted popup API возвращает отдельный для точного origin UID, nullable-признак 18+ и 10-минутный подписанный токен. Профиль, контакты, дата рождения и исходный идентификатор провайдера не передаются.
Connect
Приложение регистрируется в Tapok и получает публичный client_id. Его backend использует API key для обмена authorization code. После отдельного подтверждения пользователя приложение может получить pairwise ID и данные из разрешённых scopes.
Два интерфейса входа
В каждом режиме можно:
- открыть стандартный интерфейс Сбер ID;
- передать заранее введённый номер через
loginHint.
Номер имеет формат 79001234567. Login Hint не подтверждает номер и не предоставляет scope phone.
Быстрый выбор
- Достаточно origin-pairwise UID и nullable 18+ без профиля — Hosted.
- Нужны профильные scopes или управляемая Connect-интеграция — Connect.
- Сайт без фреймворка — Vanilla JS.
- React / Preact — React.
- Vue — Vue.
- Nuxt — Nuxt.