Быстрый старт#

В данном разделе описаны примеры подключения и синхронизации внешних ресурсов с IDMX. Эти инструкции предназначены для разработчиков, которым нужно подключить свою систему к IDMX.

Пререквизиты#

Для выполнения примеров понадобятся:

  • Развернутая инсталляция IDMX (подробнее смотрите в Руководстве по установке).

  • Источник данных об аккаунтах в формате CSV. Для выполнения руководства можно воспользоваться примером.

  • Целевая система, аккаунтами в которой будет управлять IDMX. В примерах используется простой сервер OpenLDAP.

  • Опционально - IDE для работы с XML-файлами.

Подключение ресурса и импорт данных#

Первое, что нужно сделать для начала работы с IDMX — создать учетные карточки пользователей в IDMX. Этом можно сделать вручную, но проще, быстрее и реалистичнее будет импортировать готовый список из, например, кадровой системы.

Для импорта данных из CSV-файла необходимо подключить его как ресурс IDMX. Для этого нужно создать конфигурационную схему ресурса IDMX. Схему ресурса можно составлять на XML, YAML или JSON. Схема ресурса определяет параметры подключения IDMX к источнику данных, корреляцию атрибутов учетной записи в источнике к атрибутам учетной карточки IDMX, настройки политик, применяемых к учетным записям и действия при синхронизации данных между источником и IDMX. Подробнее о составлении схемы и ее элементах вы можете узнать в разделе Конфигурирование ресурса Руководства для операторов.

В рамках данного примера мы воспользуемся XML-схемой.

Для подключения ресурса выполните следующие шаги:

  1. Войдите в интерфейс администратора IDMX.

  2. Нажмите кнопку Импортировать и выберите конфигурационную схему hr-csv-example.xml.

  3. Убедитесь, что ресурс успешно подключен. Для этого:

    1. Перейдите на вкладку Ресурсы, откройте ресурс HR System и нажмите кнопку Протестировать соединение. В данном примере источник данных это всего лишь файл в файловой системе сервера IDMX, поэтому подключение должно быть быстрым и безошибочным.

    2. В ресурсе HR System выберите раздел Аккаунты и переключите тумблер Искать в на значение Ресурс. В окне должен отобразиться список учетных записей из CSV-файла.

После этих шагов ресурс подключен к IDMX. Теперь можно синхронизировать данные из ресурса с данными в IDMX, по правилам, определенным в конфигурационной схеме ресурса. Поскольку нужно импортировать данные из ресурса в IDMX, воспользуйтесь задачей импорта данных, нажав на кнопку Импортировать в нижней части экрана со списком аккаунтов ресурса HR System.

После того, как задача на импорт закончит исполняться, можно просмотреть созданные учетные карточки пользователей IDMX в подразделе Все пользователи раздела Пользователи.