Регистрация Системы в KATA по API

Чтобы настроить интеграцию Системы с KATA по API, нужно авторизовать Систему в KATA как внешнюю систему. Для этого со стороны внешней системы отправляется запрос на интеграцию. Запрос создаётся не в консоли KATA: первый API-запрос с уникальным идентификатором системы автоматически появляется в веб-интерфейсе KATA в разделе «Внешние системы». Администратор KATA подтверждает этот запрос.

Для авторизации используется клиентский сертификат. После подтверждения запроса сохраните идентификатор и сертификат для настройки подключения СЗИ в Системе.

Порядок регистрации

  1. Сгенерируйте уникальный идентификатор sensorId в формате UUID и сохраните его. Один и тот же идентификатор потребуется при регистрации и последующих запросах к API KATA.

  2. Подготовьте сертификат для защищённого соединения с KATA. Например, создайте закрытый ключ, запрос на сертификат и самоподписанный сертификат:

    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

    При создании запроса на сертификат заполните запрашиваемые поля для своей организации. Файлы certificate.crt и private.key понадобятся для отправки запроса. Храните закрытый ключ в защищённом месте.

  3. Отправьте первый запрос к 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 доверен на узле, с которого выполняется команда.

  4. До подтверждения запроса ответ 401 Unauthorized ожидаем: цель первого запроса — зарегистрировать внешнюю систему в KATA, а не получить данные. Если возникла ошибка соединения или сертификата, проверьте адрес центрального узла и настройки TLS.

  5. Войдите в веб-интерфейс KATA под учётной записью администратора. В разделе «Внешние системы» найдите запрос на авторизацию от Системы, нажмите «Принять» и подтвердите действие.

  6. Повторите тот же запрос GET. После подтверждения KATA должна вернуть HTTP 200 и данные об ограничениях сканирования. Пример ответа:

    {
      "maxObjectSize": 1073741824,
      "version": "cf32775a-6c0a-4c47-afdc-3379b69bc39c"
    }

Для дальнейшей настройки шаблона kata_poll_api_base_template создайте в подразделе «Секреты» секрет KATA_SENSOR_ID со значением sensorId и сохраните сертификат с закрытым ключом для настройки подключения.