Перейти к основному содержанию
Это руководство объясняет, как устроена продакшн-интеграция Didit Authentication: от первого перенаправления до контрольного списка перед запуском. Если вы ещё не выполняли вход для пользователя, начните с быстрого старта, а код для каждого SDK берите из быстрых стартов для платформ.

Архитектура

В процессе участвуют четыре части: API-ключ Didit и секрет не должны попадать в ваше приложение ни в каком виде: публикуемый ключ доступен публично, а обмен кода авторизации защищён PKCE вместо клиентского секрета.

Размещённые страницы или собственные экраны

Выберите, где пользователи будут вводить email, пароль или код. Настройка называется sign_in_ui (по умолчанию hosted, либо own), и её можно изменить позже. Ключи доступа привязаны к источнику входа вашего приложения. Методы SDK для ключей доступа работают только на страницах, открытых с этого origin, поэтому на ваших собственных экранах на другом домене направляйте пользователей на размещённую страницу для ключей доступа.

Выбор SDK

Если SDK не используется, реализуйте поток авторизации с кодом и PKCE самостоятельно: в быстром старте для JavaScript показан весь контракт.

Защита вашего бэкенда

Проверка сессии на фронтенде управляет только тем, что вы показываете. Ваш бэкенд принимает все решения и опирается на проверенный токен.
  1. Проверяйте токен доступа при каждом запросе. Проверьте подпись ES256 по JWKS вашего издателя, затем iss, aud, exp и typ: at+jwt, и отклоняйте токен, у которого act не равен null, если только маршрут не принимает ИИ-агентов. См. проверка токена на вашем сервере.
  2. Проверяйте действующую сессию перед чувствительным действием. Токен доступа остаётся действительным до истечения срока, но не дольше 5 минут. GET /session/ сразу возвращает ошибку, если сессия отозвана, простаивала или истекла, если пользователь заблокирован или если сессия больше не соответствует вашей политике MFA. См. проверка сессии.
  3. Запрашивайте step-up, когда действие рискованное. Перед выплатой, добавлением нового банковского счёта или изменением адреса электронной почты или номера телефона спросите у Didit, нужно ли пользователю пройти верификацию повторно, и действуйте только по step-up со статусом approved, который ваш бэкенд получил сам. См. step-up перед чувствительными действиями.
  4. Берите vendor_data из проверенного токена, никогда из поля, которое отправил браузер, и используйте его для верификаций и транзакций пользователя.

Sessions

Значения длительности сессии и тайм-аута бездействия можно изменить в разделе Authentication > Security and sessions или через API в настройках приложения.
Представление Active sessions в Didit Business Console: список активных сессий с устройством, местоположением, временем начала, последней активностью, временем окончания и кнопкой Revoke

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.

Чек-лист перед запуском в продакшн

  1. Аутентификация включена для вашего Live-приложения на странице Products.
  2. Ваши продакшн-URL перенаправления https:// и разрешённые origin зарегистрированы в Live-приложении. Live-приложение не принимает адреса http://.
  3. Каждый метод входа через социальные сети использует идентификатор клиента и секрет вашего собственного приложения: тестовые учётные данные Didit работают только в песочнице.
  4. В вашей продакшн-конфигурации указаны публикуемый ключ Live (pk_live_) и ваш издатель для Live.
  5. Политика MFA, время жизни сессии, тайм-аут бездействия, длина пароля и политика регистрации соответствуют вашим требованиям. См. настройки приложения.
  6. Защита от ботов включена, вместе с проверкой скомпрометированных паролей.
  7. Ваш бэкенд проверяет каждый токен доступа и вызывает GET /session/ перед чувствительными действиями.
  8. Брендинг, тексты страниц и ссылки на условия использования и политику конфиденциальности настроены. Если вы планируете пользовательский домен, активируйте его до того, как пользователи начнут добавлять ключи доступа.
  9. Для адреса назначения webhook настроена подписка на типы auth.*, которые вы обрабатываете.
  10. Вы протестировали на Live-приложении регистрацию, повторный вход, отмену, восстановление пароля, MFA, истечение сессии, выход и отозванную сессию.

Устранение неполадок

Последнее изменение 22 ноября 2026 г.