# Интеграция внешней системы (Postman) по API с Central node KATAP

### <span style="color: rgb(0, 109, 92);">Интеграция внешней системы (postman) по api с Central Node kata</span>

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

<span style="color: windowtext;">Взаимодействие внешних систем с Kaspersky Anti Targeted Attack Platform осуществляется с помощью интерфейса API.</span>

<span style="color: windowtext;">Вызовы методов API доступны только для авторизованных внешних систем.</span>

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

<table id="bkmrk-%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%B4%D0%B8%D0%BC-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D0%BF" style="border-collapse: collapse; border: none;"><colgroup><col style="width: 148.6pt;"></col><col style="width: 712px;"></col></colgroup><tbody><tr style="height: 1cm;"><td style="width: 148.6pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 1cm;"><span style="color: windowtext;">Создадим запрос на получение обнаружений. Выберите в Postman запрос «Получить Алерты / Обнаружения». Проверьте коректность введенных данных и переменных.</span>

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

<span style="color: windowtext;">На первый запрос, вы получите ответ «</span>****401 Unauthorized****<span style="color: windowtext;">», т.к. Postman (или любая внешняя система) еще не авторизованы.</span>

</td><td style="width: 347pt; 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; height: 1cm;">![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/7NQr5U3ZbvZZ6mb0-image.png)

<span style="color: rgb(33, 33, 33); background-color: white; white-space: pre-wrap;"></span>

<span style="color: rgb(33, 33, 33); background-color: white;">https://</span><span style="background-color: white;">{{kata\_ip}}</span><span style="color: rgb(33, 33, 33); background-color: white;">:443/kata/scanner/v1/sensors/</span><span style="background-color: white;">{{sensorid}}</span><span style="color: rgb(33, 33, 33); background-color: white;">/detects?detect\_type=am,sb,yara,ids,url\_reputation&amp;limit=100</span>

<span style="color: windowtext;">Где:</span>

<span style="background-color: white;">kata\_ip – адрес Central Node</span>

<span style="background-color: white;">sensorid – созданный ранее UUID</span>

![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/G1hEcnPK2DSwtIul-image.png)

</td></tr><tr style="height: 1cm;"><td style="width: 148.6pt; 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; height: 1cm;"><span style="color: windowtext;">Перейдите в</span><span style="white-space: pre-wrap;"> </span><span style="color: windowtext;">веб-интерфейс Kaspersky Anti Targeted Attack Platform. Войдите под УЗ локального администратора. В разделе «</span>****Внешние системы****<span style="color: windowtext; white-space: pre-wrap;">» отобразится запрос на авторизацию от внешней системы. Нажмите на кнопку </span>****Принять****<span style="color: windowtext;">.</span>

</td><td style="width: 347pt; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt; height: 1cm;">![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/BvRDNFKDIvgEK02b-image.png)

</td></tr><tr style="height: 1cm;"><td style="width: 148.6pt; 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; height: 1cm;"><span style="color: windowtext; white-space: pre-wrap;"></span>

<span style="color: windowtext;">Внешняя система будет авторизована. Обратите внимание на «</span><span style="color: rgb(29, 29, 27); background-color: white;">ID» и «Отпечаток сертификата». Они должны совпадать с теми данными, которые были введены в Postman (использованы при запросе из сторонней системы)</span>

</td><td style="width: 347pt; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt; height: 1cm;">![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/sI0FziWY0fKAZNaa-image.png)

</td></tr><tr style="height: 1cm;"><td style="width: 148.6pt; 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; height: 1cm;"><span style="color: windowtext;">Выполните повторно запрос «Получить Алерты / Обнаружения».</span>

<span style="color: windowtext;">CN уже выдаст корректный</span>

</td><td style="width: 347pt; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt; height: 1cm;">[![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/oEM5CR2UijZGsGf7-image.png)](https://antiapt-community.ru/uploads/images/gallery/2025-12/oEM5CR2UijZGsGf7-image.png)

</td></tr><tr style="height: 1cm;"><td colspan="2" style="width: 495.6pt; 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; height: 1cm;">#### ****API для получения внешними системами информации о событиях приложения****

</td></tr><tr style="height: 1cm;"><td colspan="2" style="width: 495.6pt; 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; height: 1cm;"><span style="color: windowtext;">Для получения информации о состоянии приложения и его событиях необходимо дополнительно авторизоваться в системе. (В веб интерфейсе Central Node будет 2 авторизации от внешней системы с одинаковым UUID/IP адресом). Отличие в том, что у вас будет дополнительный токен для авторизации.</span>

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

<span style="color: windowtext;">При первом запросе Kaspersky Anti Targeted Attack Platform создает ContinuationToken (далее также "токен"). Приложение передает события, доступные в системе на момент создания токена. При создании нового токена Kaspersky Anti Targeted Attack Platform отправляет события, доступные в системе на момент создания этого токена.</span>

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

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

</td></tr><tr style="height: 1cm;"><td style="width: 148.6pt; 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; height: 1cm;"><span style="color: windowtext;">Для первого запроса аторизации, запустите команду «Получение информации о событиях CN (Запрос авторизации)»</span>

<span style="color: windowtext;">Будет отправлен запрос на авторизацию в CN.</span>

</td><td style="width: 347pt; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt; height: 1cm;"><span style="color: windowtext;">Пример: GET https://{{kata\_ip}}:443/kata/events\_api/v1/{{sensorid}}/events</span>

![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/tvLFhFdqLKnK1jSG-image.png)

</td></tr><tr style="height: 1cm;"><td style="width: 148.6pt; 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; height: 1cm;"><span style="color: windowtext;">Перейдите в</span><span style="white-space: pre-wrap;"> </span><span style="color: windowtext;">веб-интерфейс Kaspersky Anti Targeted Attack Platform. Войдите под УЗ локального администратора. В разделе «</span>****Внешние системы****<span style="color: windowtext; white-space: pre-wrap;">» отобразится запрос на авторизацию от внешней системы. Нажмите на кнопку </span>****Принять****<span style="color: windowtext;">.</span>

</td><td style="width: 347pt; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt; height: 1cm;">[![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/6rRpNv81ITTyHrri-image.png)](https://antiapt-community.ru/uploads/images/gallery/2025-12/6rRpNv81ITTyHrri-image.png)

</td></tr><tr style="height: 1cm;"><td style="width: 148.6pt; 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; height: 1cm;"><span style="color: windowtext; white-space: pre-wrap;"></span>

<span style="color: windowtext;">Внешняя система будет авторизована. Обратите внимание на «</span><span style="color: rgb(29, 29, 27); background-color: white;">ID» и «Отпечаток сертификата». Они должны совпадать с теми данными, которые были введены в Postman (использованы при запросе из сторонней системы)</span>

</td><td style="width: 347pt; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt; height: 1cm;">[![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/sou3KnJWD0mlHVcn-image.png)](https://antiapt-community.ru/uploads/images/gallery/2025-12/sou3KnJWD0mlHVcn-image.png)

</td></tr><tr style="height: 1cm;"><td style="width: 148.6pt; 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; height: 1cm;"><span style="color: windowtext;">При повторном запросе, подгрузятся все полседние события на CN, поэтому необходимо выгрузить полученный результат в файл и забрать из него полученный токен.</span>

</td><td style="width: 347pt; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0cm 5.4pt; height: 1cm;">[![image.png](https://antiapt-community.ru/uploads/images/gallery/2025-12/scaled-1680-/jGToPey6bldbvYHk-image.png)](https://antiapt-community.ru/uploads/images/gallery/2025-12/jGToPey6bldbvYHk-image.png)

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