Как интегрировать Колибри-АРМ с ITSM, Service Desk и CMDB

В корпоративной инфраструктуре управление устройствами редко существует как изолированный процесс. Заявки поступают через Service Desk, сведения об активах хранятся в CMDB или ITAM, объекты пользователей и компьютеров учитываются в службах каталогов, а административные операции выполняются в системе централизованного управления.

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

OpenAPI Колибри-АРМ позволяет встроить операции управления компьютерами и коллекциями в существующие корпоративные процессы. Внешняя система может инициировать предусмотренные действия после согласования заявки, а Колибри-АРМ — выполнять их на управляемых рабочих станциях и серверах.

Запросить демонстрацию

Ключевые выводы

• Колибри-АРМ выступает исполнительным уровнем управления рабочими станциями и серверами.
• ITSM и Service Desk отвечают за заявки, согласования, ответственных и сроки.
• CMDB и ITAM хранят сведения об активах, их владельцах, назначении и связях.
• OpenAPI позволяет связать корпоративные процессы с операциями над компьютерами, коллекциями и папками Колибри-АРМ.
• Внешние источники данных помогают дополнить техническую инвентаризацию корпоративными атрибутами.
• Службы каталогов и Колибри-АРМ решают взаимодополняющие задачи идентификации и управления устройствами.
• OpenAPI предоставляет техническую основу интеграции, а готовый коннектор создаётся для конкретной внешней системы и сценария.
• Архитектура интеграции определяется процессами, источниками данных и требованиями конкретной организации.

Зачем интегрировать управление устройствами с корпоративными системами

Сокращение ручных операций

При ручной обработке типовой процесс может выглядеть так:

1. пользователь создаёт заявку на установку приложения;
2. руководитель или владелец сервиса согласовывает её;
3. администратор вручную находит компьютер;
4. определяет целевую группу;
5. назначает установку;
6. проверяет результат;
7. переносит сведения обратно в заявку.

Даже если каждый шаг занимает несколько минут, при большом количестве обращений накапливается значительная операционная нагрузка.

При программной интеграции согласование остаётся в ITSM или Service Desk, а предусмотренная техническая операция передаётся в Колибри-АРМ автоматически.

Единообразие выполнения операций

Интеграция позволяет связать утверждённый процесс с заранее определённым действием:

• созданием компьютера;
• добавлением устройства в коллекцию;
• удалением устройства из коллекции;
• запуском инвентаризации;
• выполнением доступной административной команды.

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

Связь технических данных с бизнес-контекстом

Колибри-АРМ собирает технические сведения:

• об операционной системе;
• аппаратной конфигурации;
• установленном программном обеспечении;
• сетевых параметрах;
• состоянии управляемого устройства.

CMDB или ITAM, в свою очередь, может содержать:

• владельца устройства;
• подразделение;
• местоположение;
• бизнес-сервис;
• категорию критичности;
• ответственного;
• статус жизненного цикла;
• инвентарный номер.

Интеграция помогает использовать эти данные совместно, сохраняя профильную роль каждой системы.

Как распределяются роли между системами

Такое распределение позволяет заранее определить границы ответственности. Колибри-АРМ дополняет ITSM и CMDB, выполняя операции управления рабочими станциями и серверами в рамках общего процесса.

Какие возможности OpenAPI доступны в Колибри-АРМ

В версии 26.02.2.1 OpenAPI охватывает операции:

• с компьютерами;
• с коллекциями;
• с папками внутри коллекций.

В официальных материалах по версиям 26.02 и 26.02.2.1 также приводятся примеры операций:

• создание компьютеров;
• удаление компьютеров;
• выполнение команд на управляемых устройствах;
• добавление устройств в коллекции;
• удаление устройств из коллекций;
• запуск инвентаризации.

Функциональность API продолжает развиваться, поэтому при проектировании интеграции необходимо ориентироваться на документацию конкретной установленной версии Колибри-АРМ.

Типовые сценарии интеграции

Установка ПО после согласования заявки

Пользователь запрашивает приложение через Service Desk. После согласования внешняя система инициирует предусмотренную операцию в Колибри-АРМ.

Возможная последовательность:

1. заявка проходит согласование;
2. Service Desk определяет целевое устройство;
3. компьютер добавляется в коллекцию, для которой настроено развёртывание;
4. Колибри-АРМ выполняет операцию;
5. результат используется для дальнейшей обработки заявки.

Возможность автоматически инициировать установку программного обеспечения после согласования заявки приводится в официальном описании REST API Колибри-АРМ. Конкретный способ передачи и возврата статуса зависит от возможностей внешней системы и реализованного интеграционного сценария.

Подключение нового устройства

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

Далее устройство можно:

• создать в Колибри-АРМ;
• поместить в требуемую папку;
• добавить в соответствующие коллекции;
• запустить инвентаризацию;
• подготовить к дальнейшим административным операциям.

Актуализация сведений в CMDB

Колибри-АРМ может выступать источником технических сведений о фактическом состоянии управляемого устройства:

• версии операционной системы;
• аппаратной конфигурации;
• установленном ПО;
• сетевых параметрах;
• других собранных инвентарных данных.

CMDB при этом сохраняет бизнес-контекст и связи конфигурационной единицы. Состав передаваемых полей, направление обмена и периодичность актуализации определяются архитектурой конкретной интеграции.

Автоматизация инвентаризации

ITSM, ITAM или другая внешняя система может инициировать сбор актуальных сведений при наступлении определённого события:

• постановке устройства на учёт;
• изменении владельца;
• завершении ремонта;
• переводе в другое подразделение;
• подготовке к списанию;
• проверке перед миграцией.

После запуска инвентаризации Колибри-АРМ собирает актуальные технические сведения об управляемом устройстве.

Управление составом коллекций

Коллекции используются как целевые группы для массовых операций. Через API можно автоматизировать работу с их составом и структурой.

Например, внешняя система может добавлять устройство в коллекцию на основании:

• подразделения;
• местоположения;
• типа устройства;
• этапа миграции;
• согласованной заявки;
• статуса жизненного цикла.

После этого к устройству могут применяться предусмотренные для коллекции административные процессы.

Внешние источники данных в Колибри-АРМ

Помимо OpenAPI, Колибри-АРМ поддерживает подключение внешних источников данных:

• служб каталогов;
• систем управления базами данных;
• табличных файлов;
• сторонних приложений и других источников.

Подключение выполняется из графического интерфейса и позволяет дополнить техническую инвентаризацию корпоративными сведениями.

Например, карточку устройства можно дополнить данными:

• о владельце;
• подразделении;
• местоположении;
• инвентарном номере;
• организационной единице;
• внутреннем статусе актива.

Полученные атрибуты могут использоваться при анализе инфраструктуры и формировании целевых коллекций.

Интеграция со службами каталогов

Служба каталогов и Колибри-АРМ решают взаимодополняющие задачи.

Служба каталогов отвечает за

• объекты пользователей и компьютеров;
• группы;
• аутентификацию;
• авторизацию;
• структуру каталога.

Колибри-АРМ отвечает за

• инвентаризацию рабочих станций и серверов;
• установку программного обеспечения;
• управление обновлениями;
• контроль конфигураций;
• удалённое администрирование;
• выполнение массовых операций.

Колибри-АРМ позволяет импортировать объекты из служб каталогов и использовать полученные сведения при постановке устройств под управление.

Совместимость Колибри-АРМ с Avanpost Directory Service 1.7 подтверждена совместными испытаниями. В ходе тестирования проверялись импорт объектов каталога, аутентификация и авторизация пользователей, а также сценарии развёртывания и сопровождения рабочих мест в распределённой инфраструктуре.

Конкретный состав поддерживаемых сценариев необходимо проверять применительно к используемой службе каталогов и версии Колибри-АРМ.

Для чего используется Kerberos

Поддержка Kerberos в версии Колибри-АРМ 26.02.2.1 относится к развёртыванию агентов на компьютерах Windows.

Она позволяет устанавливать агенты в инфраструктурах, где:

• NTLM ограничен;
• NTLM запрещён требованиями информационной безопасности;
• для доменной аутентификации должен использоваться Kerberos.

Поддержка Kerberos в данном сценарии относится к доменной аутентификации при развёртывании агентов Windows. Возможности синхронизации ролей, единой аутентификации пользователей и реализации других механизмов управления доступом оцениваются отдельно для конкретной службы каталогов и версии продукта.

OpenAPI и готовый коннектор: разные уровни интеграции

Наличие OpenAPI означает, что внешняя система может программно обращаться к предусмотренным операциям Колибри-АРМ.

Для конкретной интеграции необходимо определить:

• какая система является инициатором процесса;
• какая система считается источником данных;
• какие объекты и поля сопоставляются;
• какие операции разрешено выполнять;
• как идентифицируется устройство;
• как обрабатываются ошибки;
• как исключается повторное выполнение одной операции;
• где фиксируется итоговый статус;
• кто отвечает за сопровождение интеграции.

OpenAPI предоставляет техническую основу для программного взаимодействия. Готовый двусторонний коннектор к конкретному продукту ITSM, Service Desk или CMDB создаётся с учётом его интерфейсов, модели данных и выбранного интеграционного сценария.

Как спроектировать интеграционный сценарий

1. Выбрать один конкретный процесс

Для пилота лучше использовать ограниченный и измеримый сценарий:

• установка приложения после согласования;
• подключение нового устройства;
• запуск инвентаризации;
• добавление компьютера в коллекцию;
• актуализация технических данных актива.

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

2. Определить систему — источник данных

Для каждого типа сведений должен быть назначен основной источник.

Если один атрибут независимо редактируется в нескольких системах, возникает риск рассинхронизации.

3. Определить разрешённые операции

Интеграционной учётной записи следует предоставить только те возможности, которые требуются конкретному процессу.

Например:

• чтение необходимых сведений об устройствах;
• создание компьютеров;
• добавление устройств в коллекцию;
• запуск инвентаризации.

Интеграционной учётной записи предоставляют минимально необходимый набор полномочий для реализации выбранного сценария.

4. Предусмотреть обработку повторных запросов

Внешняя система может повторить запрос после тайм-аута или временного сбоя. Интеграция должна понимать, была ли операция уже выполнена.

Необходимо определить:

• уникальный идентификатор запроса;
• условия повторного выполнения;
• правила проверки существования объекта;
• действия при повторном добавлении устройства;
• порядок обработки дублирующих команд.

Это особенно важно для операций создания компьютеров и изменения состава коллекций.

5. Предусмотреть обработку ошибок

Интеграция должна корректно обрабатывать ситуации, когда:

• устройство уже существует;
• устройство не найдено;
• коллекция отсутствует;
• операция уже была выполнена;
• Колибри-АРМ временно недоступен;
• внешняя система передала неполные данные;
• административная команда завершилась ошибкой.

Для каждого случая необходимо определить статус, дальнейшее действие и ответственного.

6. Проверить аудит операций

В Колибри-АРМ реализован административный аудит с выделенной базой событий. Он фиксирует операции управления инфраструктурой и действия пользователей и администраторов.

При автоматизации необходимо различать:

• действие пользователя;
• решение, принятое в ITSM;
• запрос интеграционной учётной записи;
• операцию, выполненную в Колибри-АРМ;
• технический результат на устройстве.

Это позволяет восстановить последовательность событий при разборе ошибок или инцидентов.

7. Запустить пилот на ограниченном контуре

Для первичной проверки достаточно:

• одной внешней системы;
• одного процесса;
• ограниченной группы устройств;
• нескольких успешных и ошибочных сценариев;
• заранее определённых критериев результата.

После подтверждения работоспособности интеграцию можно распространять на дополнительные подразделения и процессы.

Основные риски интеграции

Какие сценарии требуют отдельной технической проверки

Следующие сценарии необходимо подтверждать применительно к конкретной версии Колибри-АРМ и архитектуре проекта:

• экспорт событий в SIEM по Syslog или CEF;
• готовые парсеры и корреляционные правила для SIEM;
• интеграция с Git или другими SCM;
• Just-In-Time-доступ к репозиториям;
• создание временных токенов;
• хранение и автоматическая ротация секретов;
• PAM-функциональность;
• автоматическая синхронизация ролей из групп Active Directory;
• готовые веб-хуки для конкретной CMDB;
• двусторонняя синхронизация с конкретной ITSM-системой.

Их включение в интеграционный проект возможно после проверки доступных интерфейсов, документации установленной версии и требований заказчика.

Как Колибри-АРМ встраивается в корпоративный ИТ-контур

Колибри-АРМ занимает место исполнительной системы управления конечными устройствами и серверами.

Система позволяет:

• получать и актуализировать сведения об устройствах;
• работать с компьютерами и коллекциями через OpenAPI;
• запускать предусмотренные административные операции;
• использовать данные внешних источников;
• связывать управление устройствами с заявками и сервисными процессами;
• выполнять операции на устройствах Windows и Linux;
• фиксировать действия пользователей и администраторов.

ITSM, Service Desk, CMDB и службы каталогов при этом продолжают выполнять свои профильные функции.

Чек-лист готовности к интеграции

Проверьте, определены ли:

• автоматизируемый процесс;
• система — инициатор операции;
• основной источник каждого типа данных;
• идентификатор устройства;
• необходимые методы API;
• права интеграционной учётной записи;
• правила работы с коллекциями;
• обработка повторных запросов;
• обработка ошибок;
• порядок возврата статуса;
• журналирование действий;
• критерии успешности пилота;
• ответственные за сопровождение.

После определения этих параметров OpenAPI можно использовать для сокращения ручных операций и согласованного взаимодействия корпоративных систем.

Часто задаваемые вопросы

Можно ли интегрировать Колибри-АРМ с любой CMDB?

OpenAPI предоставляет техническую основу для программного взаимодействия, но возможность интеграции зависит и от интерфейсов конкретной CMDB. Для реализации может потребоваться настройка обмена, разработка адаптера или использование интеграционной платформы.

Какие объекты доступны через OpenAPI?

В публичном описании версии 26.02.2.1 указаны операции с компьютерами, коллекциями и папками внутри коллекций. Конкретный состав методов необходимо проверять по документации установленной версии Колибри-АРМ.

Можно ли запускать установку ПО из Service Desk?

Да. Такой сценарий приводится в официальных материалах: после согласования заявки установка программного обеспечения может автоматически инициироваться через Колибри-АРМ. Конкретная реализация зависит от используемой Service Desk и настройки процесса. Подробнее.

Как распределяются роли Колибри-АРМ и CMDB?

Колибри-АРМ собирает актуальные технические сведения и выполняет операции на управляемых устройствах. CMDB хранит конфигурационные единицы, их владельцев, бизнес-роли и связи. Совместное использование систем объединяет фактические данные об устройствах с бизнес-контекстом инфраструктуры.

Поддерживается ли интеграция со службами каталогов?

Колибри-АРМ поддерживает импорт объектов и подключение служб каталогов в качестве внешних источников данных. Отдельные сценарии аутентификации, авторизации и SSO зависят от используемой службы каталогов и версии продукта. Совместимость с Avanpost Directory Service 1.7 подтверждена совместными испытаниями.

Как организуется взаимодействие Колибри-АРМ с SIEM?

В Колибри-АРМ предусмотрен административный аудит, фиксирующий операции управления инфраструктурой и действия пользователей и администраторов. Формат передачи данных в конкретную SIEM, используемые протоколы и состав событий определяются при технической проверке и проектировании интеграционного сценария.

Сколько времени занимает интеграция?

Срок зависит от внешней системы, количества автоматизируемых процессов, состава данных, требований безопасности и объёма необходимой разработки. Ограниченный пилотный сценарий обычно реализуется быстрее комплексной двусторонней интеграции нескольких корпоративных систем.

Заключение

Интеграция Колибри-АРМ с ITSM, Service Desk и CMDB позволяет связать согласование и учёт с фактическим выполнением операций на рабочих станциях и серверах.

OpenAPI предоставляет доступ к операциям с компьютерами, коллекциями и их структурой, а внешние источники данных помогают дополнять техническую инвентаризацию корпоративными атрибутами.

Наиболее надёжный подход — начинать с одного измеримого процесса, чётко определить источники данных, ограничить права интеграционной учётной записи и проверить сценарий на пилотной группе.

В такой архитектуре Колибри-АРМ дополняет ITSM, CMDB и службы каталогов, выступая исполнительным уровнем централизованного управления устройствами Windows и Linux.

Источник изображения: Magnific AI

Обновлено: 29.07.2026