Перейти к содержанию

Модель

IntegrationType

Тип интеграции (тип интеграционного подключения):

Параметр Тип Обязательность Описание
id string Required Идентификатор типа интеграции в формате uuid
name string Required Наименование типа интеграции. Обычно наименование сторонней системы, с которой выполняется взаимодействие
state boolean Required Состояние типа интеграции. Возможные значения:
- true - тип интеграции активирован в платформе;
- false - тип интеграции неактивен.
## ParameterMeta

Параметры типа интеграции:

Параметр Тип Обязательность Описание
id string Required Идентификатор параметра в формате uuid
integration_type_id string Required Идентификатор типа интеграции в формате uuid
parameter_order integer Required Порядок параметра в веб-интерфейсе платформы
parameter_name string Required Название параметра с учётом вложенности по структуре конфигурации
value_type string Required Тип переменной. Допустимые значения:
- boolean
- integer
- string
- number
- array
required_field boolean Required Является ли параметр обязательным к заполнению
value_params object Required Объект, содержащий информацию о значении параметра
value_params{title} string Required Наименование параметра в веб-интерфейсе платформы
value_params{description} string Optional Описание параметра в веб-интерфейсе платформы
value_params{min_value} integer Optional Минимальное значение (используется для параметров с типом int)
value_params{max_value} integer Optional Максимальное значение (используется для параметров с типом int)
value_params{example} string Optional Пример

Integration

Экземпляр интеграции:

Параметр Тип Обязательность Описание
id string Required Идентификатор экземпляра интеграции в формате uuid
created_at string Required Дата создания в формате date-time
updated_at string Required Дата изменения в формате date-time
integration_type_id string Required Идентификатор типа интеграции
integration_name string Required Наименование экземпляра интеграции
state boolean Required Состояние экземпляра интеграции. Возможные значения:
- true - тип интеграции активирован в платформе;
- false - тип интеграции неактивен.
params Array<Params> Required Параметры интеграции

Params

Параметр Тип Обязательность Описание
host string Required Адрес API сервера
port integer Required Порт
login string Required Логин для подключения к серверу
password string Required Пароль
is_jobs_active boolean Required Использовать ли периодические задачи синхронизации: true, false
is_actions_active boolean Required Использовать ли активные действия: true, false

IntegrationJob

Периодическая задача экземпляра интеграции

Параметр Тип Обязательность Описание
id string Required Идентификатор задачи в формате uuid
created_at string Required Дата создания в формате date-time
updated_at string Required Дата изменения в формате date-time
integration_type_id string Required Идентификатор типа интеграции
integration_id string Required Идентификатор экземпляра интеграции, в которой исполняется задача
state boolean Required Состояние задачи:
- true - задача активна;
- false - задача неактивна.
cron string Required CRON-выражение, описывающее периодичность выполнения задачи

IntegrationJobsMeta

Периодические задачи типа интеграции

Параметр Тип Обязательность Описание
id string Required Идентификатор задачи в формате uuid
integration_type_id string Required Идентификатор типа интеграции в формате uuid
name string Required Название задачи
command string Required Текст запускаемой команды
state boolean Required Глобальное состояние задачи:
- true - задача активна;
- false - задача неактивна.
mappings Array<object> Required Массив передаваемых параметров
mappings{parameter_name} string Required Имя передаваемого параметра
mappings{parameter_type} string Required Тип передаваемого параметра

IntegrationAction

Активное действие:

Параметр Тип Обязательность Описание
id string Required Идентификатор активного действия в формате uuid
integration_id string Required Идентификатор экземпляра интеграции в формате uuid
created_at string Required Дата создания в формате date-time
updated_at string Required Дата изменения в формате date-time
state boolean Required Состояние скрипта Вкл/выкл
integration_type_id string Required Идентификатор типа интеграции в формате uuid
name string Required Название активного действия
script_lin string Optional Скрипт активного действия для ОС Linux
script_win string Optional Скрипт активного действия для ОС Windows
state boolean Required Глобальное состояние скрипта (вкл/выкл) для всех экземпляров платформы
params Array<object> Required Список параметров для запуска скрипта
params{parameter_name} string Required Имя передаваемого для запуска скрипта параметра
params{parameter_value} string Required Что необходимо передать в качестве значения параметра (поле события)
params{from_event} boolean Required Берётся ли значение параметра из поля события или ручной ввод значения

IntegrationActionMeta

Активное действие типа интеграции:

Параметр Тип Обязательность Описание
id string Required Идентификатор активного действия в формате uuid
integration_type_id string Required Идентификатор типа интеграции в формате uuid
name string Required Название активного действия
params Array<object> Required Список параметров для запуска скрипта
params{parameter_name} string Required Имя передаваемого для запуска скрипта параметра
params{parameter_value} string Required Что необходимо передать в качестве значения параметра (поле события)
params{from_event} boolean Required Берётся ли значение параметра из поля события или ручной ввод значения
script_lin string Optional Скрипт активного действия для ОС Linux
script_win string Optional Скрипт активного действия для ОС Windows
created_at string Required Дата создания в формате date-time
updated_at string Required Дата изменения в формате date-time

IntegrationActionsLog

Журнал работы активных действий:

Параметр Тип Обязательность Описание
id string Required Идентификатор записи в формате uuid
integration_id string Required Идентификатор экземпляра интеграции в формате uuid
integration_action_id string Required Идентификатор активного действия в формате uuid
integration_script_id string Required Идентификатор скрипта
incident_id string Required Идентификатор связанного инцидента
service_asset_id string Required Идентификатор актива
rule_id string Required Идентификатор сработавшего правила корреляции
executed_at string Required Дата и время запуска команды от активного действия
result_at string Required Дата и время получения ответа после выполнения команды
executed_by string Required Инициатор запуска команды (пользователь или система на основе правила)
params object Required Объект с параметрами запуска
result string Required Результат выполнения команды
return_code integer Required Код ответа команды
integration string Required
integration_action string Required
integration_script string Required
service_asset string Required
logmule_go_rule string Required
_relations object Required Словарь, описывающий связанные сущности через идентификаторы

ActionsHistoryRecord

Запись истории выполнения активного действия на активе:

Параметр Тип Обязательность Описание
id integer Required Идентификатор записи
integration_id string Required Идентификатор экземпляра интеграции
integration_script_id integer Required Идентификатор отработавшей команды активного действия
name string Required Название активного действия
params Array<object> Required Параметры запуска команды
params{parameter_name} string Required Имя параметра, передаваемого для запуска команды
params{parameter_value} string Required Что необходимо передать в качестве значения параметра (поле события)
executed_at string Required Время запуска команды
result_at string Required Время получения ответа команды
result string Required Ответ после выполнения команды
executed_by string Required Инициатор запуска команды: пользователь или правило корреляции
rule_id string Required Правило корреляции в рамках которого выполнилась команда
incident_id string Optional Если был создан инцидент, его ИД
service_assets_id string Required Идентификатора актива, на котором была выполнена команда

LogmuleGoRulesIntegrationAction

Активное действие интеграции в правиле корреляции:

Параметр Тип Обязательность Описание
id string Required Идентификатор активного действия в формате uuid
created_at string Required Дата создания в формате date-time
updated_at string Required Дата изменения в формате date-time
rule_id string Required Идентификатор правила корреляции в формате uuid
integration_script_id string Required Идентификатор команды (скрипта) интеграции в формате uuid
params Array<object> Required Список параметров для запуска команды (скрипта) интеграции
params{parameter_name} string Required Имя передаваемого параметра
params{parameter_value} string Required Значение параметра
params{from_logline} boolean Required Флаг для получения значения параметра из логлайна (события).
Если true, поле parameter_value должно содержать название поля логлайна (может содержать . для полей вложенных объектов)
params{strategy} string Required Стратегия выбора логлайна из массива. Поддерживаемые значения:

- first — выбора первого логлайна,
- last — выбора последнего логлайна.
state boolean Required Состояние активного действия в интеграции: вкл/выкл
logmule_go_rule Array<object> Required Модель связанного правила корреляции
integration_script Array<object> Required Связанная команда (скрипт) интеграции
integration_script{id} string Required Идентификатор команды (скрипта)
integration_script{created_at} string Required Дата создания в формате date-time
integration_script{updated_at} string Required Дата изменения в формате date-time