# ПРИЛОЖЕНИЕ 2: EVENT API

##### ****Приложение 2: event api****

<span style="color: windowtext;">API для получения внешними системами информации о событиях приложения</span>

<span style="color: windowtext;">Kaspersky Anti Targeted Attack Platform предоставляет интерфейс API для доступа внешних систем к информации о зарегистрированных приложением событиях.</span>

<span style="color: windowtext; white-space: pre-wrap;"> Вы можете указать в параметрах запроса фильтры, чтобы получить информацию только о тех событиях, которые удовлетворяют требуемым условиям.</span>

<span style="color: windowtext; white-space: pre-wrap;"></span>

<span style="color: windowtext;">При появлении новых событий приложение не отправляет информацию о них автоматически на основе предыдущих запросов. Для получения актуальной информации требуется отправить повторный запрос.</span>

<span style="color: windowtext; white-space: pre-wrap;"> Параметры фильтрации событий. Задаются с помощью языка запросов для работы с событиями.</span>

<span style="color: windowtext; white-space: pre-wrap;"> Язык запросов для фильтрации событий поддерживает следующие функции и операторы:</span>

<span style="white-space: pre-wrap;">· </span><span style="color: windowtext;">Функции: in.</span>

<span style="white-space: pre-wrap;">· </span><span style="color: windowtext; white-space: pre-wrap;">Операторы сравнения для значений типа </span><span style="color: rgb(45, 194, 107);">String</span><span style="color: windowtext; white-space: pre-wrap;"> или </span><span style="color: rgb(45, 194, 107);">Boolean: ==, !=.</span>

<span style="white-space: pre-wrap;">· </span><span style="color: windowtext; white-space: pre-wrap;">Операторы сравнения для чисел и переменных: </span><span style="color: rgb(45, 194, 107);">AND, OR, NOT, ==, !=, &gt;, &gt;=, &lt;, &lt;=.</span>

<span style="color: windowtext; white-space: pre-wrap;"> Вы можете посмотреть список полей, по которым можно отфильтровать события, в разделе Поля для фильтрации событий. Полный перечень полей приведен в таблице ниже.</span>

<span style="color: windowtext; white-space: pre-wrap;"> Если вы хотите получить информацию о событиях разного типа, вам нужно создать отдельный запрос для каждого типа событий.</span>

```
EventType=='threatdetect' AND EventType=='threatprocessingresult'
```

<span style="color: windowtext; white-space: pre-wrap;"> Поддерживаются константы числового и строкового типа. Строковые константы заключаются в апострофы: </span><span style="color: rgb(45, 194, 107);">'example'</span><span style="color: windowtext; white-space: pre-wrap;">. Для строковых констант поддерживаются метасимволы </span>\*<span style="color: windowtext; white-space: pre-wrap;"> и </span>?.<span style="color: windowtext; white-space: pre-wrap;"> Если вы не хотите использовать метасимволы, вам нужно экранировать их: </span>\\\*, \\?.<span style="color: windowtext; white-space: pre-wrap;"> Также в строковых константах вам нужно экранировать специальные символы.</span>

<span style="color: windowtext; white-space: pre-wrap;"> Состав передаваемых данных об окружении обнаруженных объектов в зависимости от источника объекта приведен в таблице ниже.</span>

<table id="bkmrk-%D0%98%D1%81%D1%82%D0%BE%D1%87%D0%BD%D0%B8%D0%BA-%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82%D0%B0%D0%9F%D0%B0%D1%80%D0%B0" style="border-collapse: collapse; border: none;"><colgroup><col></col><col></col><col style="width: 333px;"></col><col style="width: 85px;"></col><col style="width: 269px;"></col></colgroup><tbody><tr><td style="border: 1pt solid windowtext; padding: 0cm 5.4pt;">****Источник объекта****

</td><td style="border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: none; border-image: initial; padding: 0cm 5.4pt;">****Параметр****

</td><td style="border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: none; border-image: initial; padding: 0cm 5.4pt;">****Описание****

</td><td style="border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: none; border-image: initial; padding: 0cm 5.4pt;">****Тип данных****

</td><td style="border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: none; border-image: initial; padding: 0cm 5.4pt;">****Пример****

</td></tr><tr><td rowspan="7" style="border-top: none; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; padding: 0cm 5.4pt;"><span style="color: windowtext;">WEB</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">sourceIP</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">IP-адрес компьютера, установившего соединение.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">IP address</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">192.0.2.0</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">sourceHostname</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">Имя компьютера, установившего соединение.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">String</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">example.com</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">destinationIp</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">IP-адрес компьютера, с которым установлено соединение.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">IP address</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">198.51.100.0</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">destinationPort</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">Порт компьютера, с которым установлено соединение.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">Integer</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">3128</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">URL</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">URL-адрес интернет-ресурса, к которому выполнено обращение.

Для обнаружений, выполненных технологией IDS, этот параметр отсутствует.

<span style="color: windowtext; white-space: pre-wrap;">Для обнаружений, выполненных технологией URL, этот параметр совпадает с параметром </span>`<span class="editor-theme-code">detectedObject</span>`<span style="color: windowtext;">.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">String</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">https://example.com:443/</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">method</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">Метод HTTP-запроса.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">String</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">Connect</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">referrer</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">URL-адрес, на который была выполнена переадресация.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">String</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">https://example.com:443/</span>`

</td></tr><tr><td rowspan="4" style="border-top: none; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; padding: 0cm 5.4pt;">`<span class="editor-theme-code">MAIL</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">mailFrom</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">Адрес электронной почты отправителя.</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">String</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">sender@example.com</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">mailTo</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">Список адресов электронной почты получателей через запятую.</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">Array</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">recipient1@example.com, recipient2@example.com</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">subject</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">Тема сообщения.</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">String</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">'You are the winner'</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">messageId</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">ID сообщения электронной почты.</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">String</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">1745028736.156014.1542897410859.JavaMail.svc_jira_pool@hqconflapp2</span>`

</td></tr><tr><td rowspan="2" style="border-top: none; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; padding: 0cm 5.4pt;">`<span class="editor-theme-code">Endpoint,</span>`

`<span class="editor-theme-code">external</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">hostName</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">Имя компьютера, на котором выполнено обнаружение.</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">String</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">computername.example.com</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">IP</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">IP-адрес компьютера, на котором выполнено обнаружение.</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">IP address</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">198.51.100.0</span>`

</td></tr><tr><td rowspan="6" style="border-top: none; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; padding: 0cm 5.4pt;">`<span class="editor-theme-code">DNS</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">sourceIp</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">IP-адрес компьютера, инициировавшего соединение по протоколу DNS.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">IP address</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">192.0.2.0</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">destinationIp</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">IP-адрес компьютера, с которым установлено соединение по протоколу DNS (как правило, DNS-сервера).</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">IP address</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">198.51.100.0</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">destinationPort</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">Порт компьютера, с которым установлено соединение по протоколу DNS (как правило, DNS-сервера).</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">Integer</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">3128</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">dnsMessageType</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">Тип DNS-сообщения:

<span style="white-space: pre-wrap;">· </span>`<span class="editor-theme-code">Request</span>`.

`<span class="editor-theme-code">Response</span>`<span style="color: windowtext;">.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">String</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">Request</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">dnsRequestType</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">Один из следующих типов записи DNS-запроса:

<span style="white-space: pre-wrap;">· </span>`<span class="editor-theme-code">A</span>`.

<span style="white-space: pre-wrap;">· </span>`<span class="editor-theme-code">AAA</span>`.

<span style="white-space: pre-wrap;">· </span>`<span class="editor-theme-code">CNAME</span>`.

`<span class="editor-theme-code">MX</span>`<span style="color: windowtext;">.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">String</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">MX</span>`

</td></tr><tr><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">domainToBeResolved</span>`

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">Имя домена из DNS-запроса.</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;"><span style="color: windowtext;">String</span>

</td><td style="border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt;">`<span class="editor-theme-code">example.com</span>`

</td></tr></tbody></table>