Перейти к основному содержанию
Didit Authentication позволяет включать методы входа и получать настройки вашего приложения через API. Используйте грант, одобренный владельцем, или именованный API-ключ с областью authentication.
Продукт Authentication является новым. Сначала настройте метод в песочнице приложения, а затем в продакшн-приложении.
Каждый вызов ниже отправляется в API управления Authentication вашего приложения. MANAGEMENT_BASE имеет следующий вид:
Те же маршруты описаны в openapi-authentication.json под тегом Setup; серверные SDK заново генерируются на основе этого файла.

Какие учётные данные использовать

Подходят любые из трёх видов учётных данных, и каждый вид ограничен тем, что его владелец одобрил. Эти учётные данные отклоняются с кодом 403 на каждом маршруте настройки, независимо от того, что запрашивает запрос:
  • Основной секрет приложения.
  • Токен, полученный из POST /programmatic/login, который выпускается для приложения, а не для консоли.
  • Ключ без области authentication, включая ключ, созданный со всеми ресурсами на максимальном уровне: такие ключи отображаются как полный доступ, поле scopes остаётся пустым, и на этих маршрутах они не принимаются.
  • Ключ другого приложения, грант, ограниченный областью didit:verification, а также грант, одобренный для другой организации.
Запрос без каких-либо учётных данных возвращает 401. Грант или ключ дополнительно сохраняют собственные ограничения: у гранта это его области, организации и роль пользователя, у ключа это его области, список разрешённых IP-адресов и срок действия.

Одобрение доступа

С именованным API-ключом

Откройте Developers -> API keys в Business Console и создайте ключ для приложения, которое вы настраиваете. Назначьте ему ресурс authentication с правом read или write. Право read дает доступ ко всем вызовам, которые читают настройки (GET). Право write дает доступ ко всем вызовам, которые их меняют (POST, PUT, PATCH, DELETE), и также позволяет читать настройки. Сведения о сроке действия, списках разрешенных IP-адресов и ротации см. в разделе API-ключи. Ключ принадлежит одному приложению и работает только с ним.

Через подключение MCP

Агент, подключенный к MCP-серверу Didit, использует доступ, который его владелец одобрил на экране согласия, с областью didit:management. См. Аутентификация MCP.

Для владельца без пароля

Грант кода устройства (RFC 8628) позволяет владельцу, который входит через Google, ключ доступа или код из письма, одобрить тот же доступ из любого браузера, без ввода пароля. См. вход без браузера.

Включение кода по электронной почте

PUT methods/{name}/ принимает только enabled, и больше ничего, если для метода не нужны учетные данные.
В ответе возвращается метод в текущем состоянии:
Когда вы читаете конфигурацию, запись для кода по электронной почте содержит credential_source: null. Методы, которые всегда включены, отключить нельзя: такой запрос возвращает {"enabled": "always_on"}.

Включение Google

Способ входа через социальную сеть принимает учетные данные вашего собственного OAuth-приложения или тестового приложения Didit для приложения в песочнице.

С собственным приложением Google

Зарегистрируйте у своего провайдера callback_uri, который возвращается в ответе. Секрет доступен только для записи: ни один ответ его не возвращает, а client_id - единственная часть, которую можно прочитать обратно. Если включить способ входа без учетных данных, когда они не были сохранены ранее, сервер ответит {"credentials": "required"}.

С тестовым приложением Didit (didit_test)

Приложение в песочнице может использовать социальные приложения самой Didit вместо ваших. Этого достаточно, чтобы завершить настройку и проверить, что она работает:
didit_test поддерживает Google, Microsoft, Apple и GitHub, только для приложений в песочнице: GET для конфигурации указывает в didit_test_credentials, каких провайдеров тестовое приложение может обслуживать для этого приложения. Для всех четырех значение false в продакшн-приложении.

Чтение настроек

GET на MANAGEMENT_BASE возвращает настройки: каждый метод с enabled и credential_source, а также URL-адреса обратного вызова, правила сессии и политику регистрации.
Отключённые методы тоже включены в ответ, поэтому один GET показывает, что включено, а что нет. Значение enabled на верхнем уровне равно false, если аутентификация отключена для приложения. Любое изменение настроек с грантом управления или именованным ключом в этом случае возвращает 409 с {"detail": "product_disabled"}, и ничего не записывается. Ни один вызов для изменения настроек не включает аутентификацию: её включает пользователь в консоли для приложения, после чего ваши вызовы начинают работать.

Остальная настройка

Ключ или грант получает доступ только к настройке и её счётчикам, но никогда не к данным конечных пользователей: users/, sessions/, sign-ins/, overview/, клиентские организации, роли, импорты, сессии агентов и тестовые письма по-прежнему требуют сессии в консоли. Настройка agent_humans_only действует на всё приложение. Изменить её может только владелец или администратор организации. Именованный ключ получит 403 owner_or_admin_required. Включение этой настройки также требует зарегистрированного ключа доступа (passkey_required).

Ошибки

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