openssl genrsa -out private.key 2048
openssl req -new -key private.key -out request.csr
openssl x509 -req -days 365 -in request.csr -signkey private.key -out certificate.crtРегистрация Системы в KATA по API
Чтобы настроить интеграцию Системы с KATA по API, нужно авторизовать Систему в KATA как внешнюю систему. Для этого со стороны внешней системы отправляется запрос на интеграцию. Запрос создаётся не в консоли KATA: первый API-запрос с уникальным идентификатором системы автоматически появляется в веб-интерфейсе KATA в разделе «Внешние системы». Администратор KATA подтверждает этот запрос.
Для авторизации используется клиентский сертификат. После подтверждения запроса сохраните идентификатор и сертификат для настройки подключения СЗИ в Системе.
Порядок регистрации
Сгенерируйте уникальный идентификатор
sensorIdв формате UUID и сохраните его. Один и тот же идентификатор потребуется при регистрации и последующих запросах к API KATA.Подготовьте сертификат для защищённого соединения с KATA. Например, создайте закрытый ключ, запрос на сертификат и самоподписанный сертификат:
При создании запроса на сертификат заполните запрашиваемые поля для своей организации. Файлы
certificate.crtиprivate.keyпонадобятся для отправки запроса. Храните закрытый ключ в защищённом месте.Отправьте первый запрос к API KATA. Это и есть запрос на интеграцию. Вместо
<адрес_Central_Node>укажите адрес центрального узла KATA, вместо<sensorId>— UUID из шага 1:curl -i --cert certificate.crt --key private.key -X GET \ "https://<адрес_Central_Node>:443/kata/scanner/v1/sensors/<sensorId>/scans/filters"Здесь запрос
GETобращается к ограничениям сканирования объектов. Пример предполагает, что сертификат сервера KATA доверен на узле, с которого выполняется команда.До подтверждения запроса ответ
401 Unauthorizedожидаем: цель первого запроса — зарегистрировать внешнюю систему в KATA, а не получить данные. Если возникла ошибка соединения или сертификата, проверьте адрес центрального узла и настройки TLS.Войдите в веб-интерфейс KATA под учётной записью администратора. В разделе «Внешние системы» найдите запрос на авторизацию от Системы, нажмите «Принять» и подтвердите действие.
Повторите тот же запрос
GET. После подтверждения KATA должна вернутьHTTP 200и данные об ограничениях сканирования. Пример ответа:{ "maxObjectSize": 1073741824, "version": "cf32775a-6c0a-4c47-afdc-3379b69bc39c" }
Для дальнейшей настройки шаблона kata_poll_api_base_template создайте в подразделе «Секреты» секрет KATA_SENSOR_ID со значением sensorId и сохраните сертификат с закрытым ключом для настройки подключения.
Эта страница была полезна?
Спасибо за отзыв!
Спасибо, мы учтём это для улучшения документации.