Архитектура
В процессе участвуют четыре части:
API-ключ Didit и секрет не должны попадать в ваше приложение ни в каком виде: публикуемый ключ доступен публично, а обмен кода авторизации защищён PKCE вместо клиентского секрета.
Размещённые страницы или собственные экраны
Выберите, где пользователи будут вводить email, пароль или код. Настройка называетсяsign_in_ui (по умолчанию hosted, либо own), и её можно изменить позже.
Ключи доступа привязаны к источнику входа вашего приложения.
Методы SDK для ключей доступа работают только на страницах, открытых с этого origin, поэтому на ваших собственных экранах на другом домене направляйте пользователей на размещённую страницу для ключей доступа.
Выбор SDK
Если SDK не используется, реализуйте поток авторизации с кодом и PKCE самостоятельно: в быстром старте для JavaScript показан весь контракт.
Защита вашего бэкенда
Проверка сессии на фронтенде управляет только тем, что вы показываете. Ваш бэкенд принимает все решения и опирается на проверенный токен.- Проверяйте токен доступа при каждом запросе. Проверьте подпись ES256 по JWKS вашего издателя, затем
iss,aud,expиtyp: at+jwt, и отклоняйте токен, у которогоactне равенnull, если только маршрут не принимает ИИ-агентов. См. проверка токена на вашем сервере. - Проверяйте действующую сессию перед чувствительным действием. Токен доступа остаётся действительным до истечения срока, но не дольше 5 минут.
GET /session/сразу возвращает ошибку, если сессия отозвана, простаивала или истекла, если пользователь заблокирован или если сессия больше не соответствует вашей политике MFA. См. проверка сессии. - Запрашивайте step-up, когда действие рискованное. Перед выплатой, добавлением нового банковского счёта или изменением адреса электронной почты или номера телефона спросите у Didit, нужно ли пользователю пройти верификацию повторно, и действуйте только по step-up со статусом
approved, который ваш бэкенд получил сам. См. step-up перед чувствительными действиями. - Берите
vendor_dataиз проверенного токена, никогда из поля, которое отправил браузер, и используйте его для верификаций и транзакций пользователя.
Sessions
Значения длительности сессии и тайм-аута бездействия можно изменить в разделе Authentication > Security and sessions или через API в настройках приложения.

Authentication > Sign-ins > Active sessions, с кнопкой Revoke в каждой сессии.
Нативные приложения
Didit возвращает пользователей в нативное приложение только через HTTPS-перенаправление: пользовательские URL-схемы не поддерживаются.- iOS: настройте перенаправление как связанный домен, добавив
webcredentialsв вашapple-app-site-association. - Android: настройте перенаправление как App Link с помощью вашего
assetlinks.json. - Зарегистрируйте каждый URL перенаправления в разделе Authentication > Security and sessions, как и веб-callback.
PUT native-apps/ в API управления аутентификацией.
Затем Didit добавит их в apple-app-site-association и assetlinks.json, которые он размещает на источнике входа вашего приложения.
MANAGEMENT_BASE указывает адрес API управления вашим приложением, а запрос можно выполнить с помощью API-ключа с областью authentication и уровнем доступа write.
Вызов заменяет оба списка, поэтому отправляйте оба:
Быстрые старты для iOS и Android показывают настройку на стороне приложения.
Подключение верификации личности и мониторинга транзакций
У каждого человека есть одно значениеvendor_data в его токенах и сессии.
Используйте его как vendor_data, когда создаёте сессию верификации или отправляете транзакцию, и консоль показывает входы в систему, верификации и транзакции одного и того же человека.
- Чтобы проверять людей при регистрации или повторно перед выплатой без создания собственного процесса верификации, используйте верификацию личности.
- События входа автоматически попадают в правила событий и разделы по мошенничеству. Не отправляйте собственные события
auth.loginдля тех же входов. - Успешный вход никогда не одобряет верификацию или транзакцию: решение по каждому продукту принимайте отдельно.
Получение событий входа
Подпишите адрес назначения webhook на типыauth.*, которые вам нужны, например auth.new_device или auth.account_locked.
Дедуплицируйте события по auth_event.event_id и проверяйте подпись так же, как для любого webhook от Didit.
Все типы и их payload описаны в разделе события и webhook.
Перенос существующих пользователей
Если ваши пользователи уже имеют учётные записи на другой платформе идентификации или в вашей базе данных, импортируйте их до переключения входа. Импортируйте хеши паролей, если исходная система их предоставляет, сохраняйте привязки к социальным сетям и сохраняйте собственные идентификаторы пользователей какexternal_id, который становится их vendor_data.
Для пользователей ничего не меняется, пока вы не переключите приложение на Didit.
Чек-лист перед запуском в продакшн
- Аутентификация включена для вашего Live-приложения на странице Products.
- Ваши продакшн-URL перенаправления
https://и разрешённые origin зарегистрированы в Live-приложении. Live-приложение не принимает адресаhttp://. - Каждый метод входа через социальные сети использует идентификатор клиента и секрет вашего собственного приложения: тестовые учётные данные Didit работают только в песочнице.
- В вашей продакшн-конфигурации указаны публикуемый ключ Live (
pk_live_) и ваш издатель для Live. - Политика MFA, время жизни сессии, тайм-аут бездействия, длина пароля и политика регистрации соответствуют вашим требованиям. См. настройки приложения.
- Защита от ботов включена, вместе с проверкой скомпрометированных паролей.
- Ваш бэкенд проверяет каждый токен доступа и вызывает
GET /session/перед чувствительными действиями. - Брендинг, тексты страниц и ссылки на условия использования и политику конфиденциальности настроены. Если вы планируете пользовательский домен, активируйте его до того, как пользователи начнут добавлять ключи доступа.
- Для адреса назначения webhook настроена подписка на типы
auth.*, которые вы обрабатываете. - Вы протестировали на Live-приложении регистрацию, повторный вход, отмену, восстановление пароля, MFA, истечение сессии, выход и отозванную сессию.