Интеграция с SecurITM

Раздел: Интеграции
Тип: Серверный коннектор (воркер по расписанию)
Направление: LSUS → SecurITM (экспорт активов)

Обзор¶

Коннектор автоматически экспортирует инвентаризационные данные LSUS в
SecurITM через API POST /api/v1/assets/import.
Каждый хост LSUS → актив типа «Операционная система» с дочерними элементами
(оборудование, ПО) и полями пользователей.

Настройка¶

Хосты → Инвентаризация → источник «API доступ» → Экспорт в SecurITM

Включить экспорт — тумблер активации
URL SecurITM — https://service.securitm.ru (или свой инстанс)
Токен SecurITM API — Bearer-токен из настроек SecurITM
Интервал (часы) — периодичность автоэкспорта (по умолчанию 6 ч)
Экспортировать сейчас — ручной запуск вне расписания
Журнал — последние 10 отправок (время, статус, хостов, HTTP, ошибка)

Маппинг данных¶

Каждый хост LSUS → один актив в SecurITM:

Поле SecurITM	Источник LSUS	Описание
`name`	`host.hostname`	Имя хоста
`type`	`operating_system`	Фиксированный тип
`ip`	`host.ip_address`	IP-адрес
`inventory_number`	`host.machine_id`	Machine ID
`os_name`	`host.os_name`	Имя ОС (Windows 11 Pro / RED OS 7.3)
`os_version`	`host.os_version`	Версия ОС
`kernel`	`host.kernel_version`	Версия ядра (Windows: `10.0.22631`; Linux: `6.1.0-23-amd64`)
`users`	`User.normalized_username`	Все пользователи хоста (через запятую)
`active_user`	`ActiveSession.is_active`	Активный сейчас пользователь (через запятую, если несколько)

Дочерние активы (`locationChilds`)¶

Категория	Пример	Тип
CPU	`CPU: Intel i7-12700 (12 ядер)`	hardware
RAM	`RAM: 16 GB`	hardware
Диски	`Disk: Samsung SSD 500 GB (SSD)`	hardware
Плата	`Motherboard: Dell OptiPlex 7090`	hardware
Мониторы	`Monitor: Dell U2419 24.0″`	hardware
Принтеры	`Printer: HP LaserJet (сетевой)`	hardware
USB-модемы	`USB: Huawei E3372 LTE (модем 3G/4G/5G)`	hardware
USB-носители	`USB: Kingston DataTraveler (накопитель)`	hardware
USB-прочее	`USB: Logitech USB Receiver (HID)`	hardware
ПО	`Software: Firefox 120.0`	software

Пример payload¶

{
  "assets": [
    {
      "name": "ws-001",
      "type": "operating_system",
      "ip": "10.0.0.42",
      "inventory_number": "550e8400-e29b-41d4-a716-446655440000",
      "os_name": "RED OS 7.3",
      "os_version": "7.3.1",
      "kernel": "6.1.0-23-amd64",
      "users": "redadmin@REDOS.LOC, user2@REDOS.LOC",
      "active_user": "redadmin@REDOS.LOC",
      "locationChilds": [
        {"name": "CPU: Intel i7-12700 (12 ядер)", "type": "hardware"},
        {"name": "RAM: 16 GB", "type": "hardware"},
        {"name": "Disk: Samsung SSD 500 GB (SSD)", "type": "hardware"},
        {"name": "Monitor: Dell U2419 24.0″", "type": "hardware"},
        {"name": "Software: Firefox 120.0", "type": "software"}
      ]
    }
  ]
}

Журнал отправок¶

Каждая отправка (ручная или автоматическая) логируется в таблицу
securitm_export_runs (миграция 136). В UI видны:

Время — начала отправки
Статус — success / error / running
Хостов — отправлено / всего (например 42/45)
HTTP — код ответа SecurITM
Ошибка — текст при неудаче

Диагностика¶

error: Не задан URL или токен — заполните настройки
HTTP 401/403 — неверный токен SecurITM
HTTP 422 — некорректный payload, проверьте поля активов
Таймаут — большие парки (>500 хостов), увеличьте таймаут или дробите экспорт