Подготовка окружения

Для начала работы с API необходимо выполнить интеграцию внешней системы с Kaspersky Anti Targeted Attack Platform. Внешняя система должна пройти авторизацию на сервере Kaspersky Anti Targeted Attack Platform.

Чтобы выполнить интеграцию внешней системы с Kaspersky Anti Targeted Attack Platform:

Сгенерируйте уникальный идентификатор внешней системы для авторизации в Kaspersky Anti Targeted Attack Platform – sensorId.
Сгенерируйте сертификат сервера внешней системы.
Создайте любой запрос от внешней системы в Kaspersky Anti Targeted Attack Platform, содержащий идентификатор sensorId. Например, вы можете создать запрос на проверку объекта из внешней системы в Kaspersky Anti Targeted Attack Platform. (Создание запроса будет рассмотрено в разделе 2)

Методы и возвращаемые ответы

Kaspersky Anti Targeted Attack Platform предоставляет HTTPS REST интерфейс проверки объектов, хранящихся во внешних системах.

Ипользуются HTTP-методы POST, GET, DELETE.

Возвращаемое значение

Код возврата	Описание
`200`	Проверка выполнена успешно.
`204`	Нет содержимого.
`400`	Требуется авторизация.
`401`	Требуется авторизация. Ошибка ввода параметров.
`404`	Не найдены результаты проверки по указанному идентификатору.
`429`	Превышено количество запросов. Повторите запрос позднее.
`500, 502, 503, 504`	Внутренняя ошибка сервера. Повторите запрос позднее.

Создание UUID

Сгенерируйте уникальный идентификатор внешней системы для авторизации в Kaspersky Anti Targeted Attack Platform – sensorId

Для создания UUID необходимо перейти на сайт https://www.uuidgenerator.net/version1 и нажать на кнопку «Generate a version 1 UUID» будет сформирован UUID.

Скопируйте получившееся значение и сохраните для последующего использования это значение будет присвоено переменной sensorId.

1.3. Создание ключей шифрования/ SSL Сертификатов

Сгенерируйте сертификат сервера внешней системы.

В зависимости от используемого решения необходимо формировать либо пару ключей, либо один crt.

1-й вариант

Создайте пару 2048-битных ключей шифрования (открытый и закрытый) для аутентификации и защиты передаваемых файлов. Тип шифрования RSA.

Команда для создания ключей в linux под Postman:

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout key.pem -out crt.pem

Во время генерации заполните необходимые поля:

Country Name (2 letter code) [AU]:RU

State or Province Name (full name) [Some-State]:apisystem

Locality Name (eg, city) []:

Organization Name (eg, company) [Internet Widgits Pty Ltd]:apisystem

Organizational Unit Name (eg, section) []:localhost

Common Name (e.g. server FQDN or YOUR name) []:apisystem.sales.lab

Email Address []: