Установка коллектора в сетевой инфраструктуре KUMA

Коллектор состоит из двух частей: одна часть создается внутри Консоли KUMA, а другая устанавливается на сервере сетевой инфраструктуры, предназначенном для получения событий. В сетевой инфраструктуре устанавливается вторая часть коллектора.

Чтобы установить коллектор:

1. Войдите на сервер, на котором вы хотите установить службу.
2. Создайте папку /opt/kaspersky/kuma/.
3. Скопируйте файл "kuma" в папку /opt/kaspersky/kuma/. Файл находится внутри установщика в папке /kuma-ansible-installer/roles/kuma/files/.

   Убедитесь, что файл kuma имеет достаточные права для запуска. Если файл не является исполняемым, измените права для запуска с помощью следующей команды:

   sudo chmod +x /opt/kaspersky/kuma/kuma

4. Поместите в директорию /opt/kaspersky/kuma/ файл LICENSE из /kuma-ansible-installer/roles/kuma/files/ и примите условия Лицензионного соглашения, выполнив следующую команду:

   sudo /opt/kaspersky/kuma/kuma license

5. Создайте пользователя kuma:

   sudo useradd --system kuma && usermod -s /usr/bin/false kuma

6. Выдайте пользователю kuma права на директорию /opt/kaspersky/kuma и все файлы внутри директории:

   sudo chown -R kuma:kuma /opt/kaspersky/kuma/

7. Выполните следующую команду:

   sudo /opt/kaspersky/kuma/kuma collector --core <FQDN>:<port> --pair.fingerprint <fingerprint ID of the KUMA Core CA certificate> --id <service ID> --api.port <API port>

   где:

   • <FQDN> – полное доменное имя сервера Ядра KUMA.
   • <port> – порт, используемый для связи с Ядром KUMA.
   • <fingerprint ID of the KUMA Core CA certificate> – идентификатор отпечатка CA-сертификата, используемый для проверки подлинности при подключении сервиса.

     Аргумент --pair.fingerprint является необязательным. При создании сервиса OSMP автоматически добавляет этот параметр в команду установщика и указывает идентификатор отпечатка.

     Вы можете установить сервис без указания параметра --pair.fingerprint. В этом случае OSMP использует значение insecure по умолчанию, которое пропускает проверку сертификата центра сертификации (CA) Ядра KUMA при установлении подключения. Если значение insecure, отпечаток не нужно обновлять после перевыпуска сертификата центром сертификации (CA).

     Для обеспечения проверки подлинности CA-сертификата Ядра KUMA рекомендуется не удалять параметр --pair.fingerprint с идентификатором отпечатка при установке сервиса. При перевыпуске CA-сертификата необходимо скопировать новый отпечаток сертификата в веб-интерфейсе и перезапустить сервис с обновленным значением параметра.

   • <service ID> – это идентификатор сервиса KUMA, скопированный из веб-интерфейса.
   • <API port> – это порт, используемый для связи с установленным компонентом.

   Пример:

   sudo /opt/kaspersky/kuma/kuma collector --core https://kuma.example.com:7210 --pair.fingerprint XXXX --id XXXX --api.port YYYY

   Если в результате выполнения команды были выявлены ошибки, проверьте корректность параметров. Например, наличие требуемого уровня доступа, сетевой доступности между службой коллектора и ядром, уникальность выбранного API-порта. После устранения ошибок продолжите установку коллектора.

   Если ошибки не выявлены, а статус коллектора в Консоли KUMA изменился на зеленый, остановите выполнение команды и перейдите к следующему шагу.

   Команду можно скопировать на последнем шаге мастера установщика. В ней автоматически указывается адрес и порт сервера Ядра KUMA, идентификатор устанавливаемого коллектора, а также порт, который этот коллектор использует для связи.

   При развертывании нескольких сервисов KUMA на одном хосте в процессе установки необходимо указать уникальные порты для каждого компонента с помощью параметра --api.port <порт>. По умолчанию используется значение --api.port 7221.

   Перед установкой необходимо убедиться в сетевой связности компонентов KUMA.

8. Выполните команду повторно, добавив ключ --install:

   sudo /opt/kaspersky/kuma/kuma collector --core <FQDN>:<port> --pair.fingerprint <fingerprint ID of the KUMA Core CA certificate> --id <service ID> --api.port <API port> --install

   где:

   • <FQDN> – полное доменное имя сервера Ядра KUMA.
   • <port> – порт, используемый для связи с Ядром KUMA (по умолчанию используется порт 7210).
   • <fingerprint ID of the KUMA Core CA certificate> – идентификатор отпечатка CA-сертификата, используемый для проверки подлинности при подключении сервиса.

     Аргумент --pair.fingerprint является необязательным. При создании сервиса OSMP автоматически добавляет этот параметр в команду установщика и указывает идентификатор отпечатка.

     Вы можете установить сервис без указания параметра --pair.fingerprint. В этом случае OSMP использует значение insecure по умолчанию, которое пропускает проверку сертификата центра сертификации (CA) Ядра KUMA при установлении подключения. Если значение insecure, отпечаток не нужно обновлять после перевыпуска сертификата центром сертификации (CA).

     Для обеспечения проверки подлинности CA-сертификата Ядра KUMA рекомендуется не удалять параметр --pair.fingerprint с идентификатором отпечатка при установке сервиса. При перевыпуске CA-сертификата необходимо скопировать новый отпечаток сертификата в веб-интерфейсе и перезапустить сервис с обновленным значением параметра.

   • <service ID> – это идентификатор сервиса KUMA, скопированный из веб-интерфейса.
   • <API port> – это порт, используемый для связи с установленным компонентом.

   Пример:

   sudo /opt/kaspersky/kuma/kuma collector --core https://kuma.example.com:7210 --pair.fingerprint XXXX --id XXXX --api.port YYYY --install

9. Добавьте порт коллектора KUMA в исключения брандмауэра.

   Для правильной работы приложения убедитесь, что компоненты KUMA могут взаимодействовать с другими компонентами и приложениями по сети через протоколы и порты, указанные во время установки компонентов KUMA.

Коллектор установлен. С его помощью можно получать и передавать на обработку данные из источника события.