---
canonical: https://docs.ideco.ru/v22/ru/ngfw/api/reports-ips-api
---



# События безопасности

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          width: 'auto'
        - text: Высокопроизводительный VCE
          theme: outlined
          url: https://docs.ideco.ru/api/vpp-v22/ru/ngfw/stat-api/get-ips-alerts
          width: 'auto'    
        - text: Документация
          theme: outlined
          url: https://docs.ideco.ru/v22/ru/ngfw/settings/reports/security-events
          width: 'auto'
    resetPaddings: false
    textWidth: l
    size: m
    centered: false
:::

## Журнал IPS

```
GET /ips/alerts?<GET-параметры, разделенные знаком &>
```

#### Параметры запроса

#|
|| **Параметр** | **Тип** | **Описание** ||
|| `limit` | integer | Ограничение на количество срабатываний (строк). Минимальное значение – `0` ||
|| `offset` | integer | Количество строк, которые необходимо пропустить, прежде чем начать выводить записи. Минимальное значение – `0` ||
|| `sort` | array | Список параметров сортировки. Сортировка производится в прямом порядке следования в массиве:
  - `field` – столбец, по которому производится сортировка;
  - `direction` – направление сортировки: `asc` – по возрастанию, `desc` – по убыванию ||
|#

#### Ответ на успешный запрос

```json5
{
    "meta": [
        {
            "name": "string",
            "type": "string"
        }
    ],
    "data": [
        {
            "id": "string",
            "sid": "integer",
            "description": "string",
            "date_time": "integer",
            "result": "string",
            "severity": "integer",
            "protocol": "string",
            "source_ip": "string",
            "source_port": "integer",
            "source_country": "string",
            "source_country_code": "string",
            "source_user_name": "string",
            "source_user_login": "string",
            "source_user_group": "string",
            "destination_ip": "string",
            "destination_port": "integer",
            "destination_country": "string",
            "destination_country_code": "string",
            "destination_user_name": "string",
            "destination_user_login": "string",
            "destination_user_group": "string",
            "security_event": "string",
            "source_id": "string",
            "vce_id": "string",
            "vce_name": "string",
            "node_id": "string",
            "node_name": "string",
            "cluster_id": "string",
            "cluster_name": "string",
            "version": "string",
            "hwid": "string",
            "hostname": "string"
        }
    ],
    "rows": "integer",
    "rows_before_limit_at_least": "integer"
}
```

#|
|| **Параметр** | **Тип** | **Описание** ||
|| `meta` | array | Массив метаданных, описывающих поля запроса. Каждый объект содержит:
  - `name` – имя поля данных;
  - `type` – тип данных. ||
|| `data` | array | Массив, содержащий информацию об одном срабатывании правила системы предотвращения вторжений. Соответствует одной строке таблицы. ||
|| `data[].id` | string | Идентификатор правила срабатывания ||
|| `data[].sid` | integer | Идентификатор сигнатуры ||
|| `data[].description` | string | Описание правила ||
|| `data[].date_time` | integer | Дата и время, когда правило сработало. Число в формате `YYYYMMDDhhmmss` ||
|| `data[].result` | string | Результат анализа:
  - `blocked` – блокировано;
  - `allowed` – пропускать ||
|| `data[].severity` | integer | Уровень угрозы. Значение от `0` до `255`, где `1` – самый высокий уровень угрозы, `0` – у правила нет уровня угрозы ||
|| `data[].protocol` | string | Протокол ||
|| `data[].source_ip` | string | IP-адрес источника ||
|| `data[].source_port` | integer | Порт источника ||
|| `data[].source_country` | string | Название страны источника ||
|| `data[].source_country_code` | string | ISO-код страны источника ||
|| `data[].source_user_name` | string | Имя пользователя источника. Если IP-адрес источника не найден в списке авторизованных сессий, строка будет пустой ||
|| `data[].source_user_login` | string | Логин пользователя источника. Если IP-адрес источника не найден в списке авторизованных сессий, строка будет пустой ||
|| `data[].source_user_group` | string | Название группы пользователя источника. Если IP-адрес источника не найден в списке авторизованных сессий, строка будет пустой ||
|| `data[].destination_ip` | string | IP-адрес назначения ||
|| `data[].destination_port` | integer | Порт назначения ||
|| `data[].destination_country` | string | Название страны назначения ||
|| `data[].destination_country_code` | string | ISO-код страны назначения ||
|| `data[].destination_user_name` | string | Имя пользователя назначения. Если IP-адрес назначения не найден в списке авторизованных сессий, строка будет пустой ||
|| `data[].destination_user_login` | string | Логин пользователя назначения. Если IP-адрес назначения не найден в списке авторизованных сессий, строка будет пустой ||
|| `data[].destination_user_group` | string | Название группы назначения. Если IP-адрес назначения не найден в списке авторизованных сессий, строка будет пустой ||
|| `data[].security_event` | string | Описание события безопасности ||
|| `data[].source_id` | string | Идентификатор источника данных ||
|| `data[].vce_id` | string | Идентификатор VCE ||
|| `data[].vce_name` | string | Название VCE ||
|| `data[].node_id` | string | Идентификатор ноды ||
|| `data[].node_name` | string | Название ноды ||
|| `data[].cluster_id` | string | Идентификатор кластера ||
|| `data[].cluster_name` | string | Название кластера. Если кластер отсутствует, то значение совпадает с `node_name` ||
|| `data[].version` | string | Версия Ideco NGFW Novum в формате `major.minor.build`. Пример: `21.1.352` ||
|| `data[].hwid` | string | Идентификатор аппаратной платформы из EFI или dmidecode ||
|| `data[].hostname` | string | Имя сервера Ideco NGFW Novum ||
|| `rows` | integer | Количество объектов в массиве `data` ||
|| `rows_before_limit_at_least` | integer | Общее количество строк без учета `limit` и `offset`. Если в параметрах запроса отсутствуют `limit` и `offset`, поле может отсутствовать ||
|#
