Учетные данные в интеграциях
IDENTYX может безопасно передавать подключенному приложению подходящие учетные данные вошедшего пользователя, а также хранить отдельные сервисные секреты самого приложения. На этой странице описано, что настраивает пользователь или администратор. Технический контракт находится в Swagger.
Два сценария
Подключенное приложение использует активную OIDC-сессию, чтобы запросить подходящие личные и групповые учетные данные вошедшего пользователя для своих объектов.
Серверная интеграция может хранить собственные сервисные логины, пароли, ключи и токены. Они изолированы от пользовательских секретов и доступны только приложению с его client_id и client_secret.
Что настраивает пользователь
- Добавьте учетные данные к нужному объекту в окне учетных записей, которое открывает само приложение: в Infrax — пункт Учётные записи в контекстном меню узла, в Nodyx — кнопка Настроить учётные данные на странице Мои ресурсы. В обоих окнах можно добавить и личную запись, и запись группы, в которой вы состоите. При подключении приложение может использовать и личную, и доступную пользователю групповую запись.
- Сохраненные записи видны в меню Мои → Секреты на вкладке Хранилище секретов: там их можно изменить или удалить, но не создать.
- Запустите подключение из интегрированного приложения через IDENTYX. Приложение получит только подходящие учетные данные в рамках активной OIDC-сессии.
Цепочку объектов передаёт само приложение: сначала объект, затем его родители от ближайшего, поэтому запись, сохранённая на папке, подходит и для объектов внутри неё. Если для объекта существует несколько подходящих записей, при подборе на сервере IDENTYX учитывает их тип, источник и то, на каком уровне цепочки они сохранены. В окне выбора учетной записи порядок по типу и источнику не применяется: все подходящие по типу записи ближайшего уровня — личные и групповые, типизированные и универсальные — равноправны (подробнее — в разделе Автоподстановка учетных записей). Настройка личных записей подробно описана в разделе Личные учетные записи, групповых — в разделе Групповые учетные записи.
Что настраивает администратор
- создаёт OIDC-приложение и передаёт его владельцу
client_idиclient_secretбезопасным способом; - настраивает объекты приложения и групповые учетные данные;
- выдаёт пользователям и группам необходимые права на приложение и его объекты.
Создание приложения описано в разделе Создание OIDC приложения. Интерактивный вход и получение пользовательской сессии — в разделе OIDC интеграция.
Аутентификация интеграции
client_id + client_secretидентифицируют само приложение и используются серверными интеграциями.- OIDC-сессия подтверждает, от имени какого вошедшего пользователя выполняется подбор учетных данных.
- PAT предназначен для делегированного доступа роботов к выбранным API-поверхностям. Он не заменяет активную OIDC-сессию в сценарии автоматической подстановки пользовательских секретов.
Не помещайте client_secret, идентификаторы сессий, пароли и приватные ключи в браузерный код, открытые репозитории или журналы. Используйте HTTPS и храните секреты только на доверенной серверной стороне.
Технический контракт
Актуальные операции, поля запросов и форматы ответов приведены в Backend API Swagger. На странице Swagger выберите схему Identyx Backend API.
Обзор всех способов доступа к API и отличие Backend API от стабильного Public API v1 приведены в разделе Описание API.