Модель
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 |