Установка маршрутизатора событий на сервере

Чтобы установить маршрутизатор событий на сервере:

1. Войдите на сервер, на котором вы хотите установить сервис маршрутизатора событий.

   Если вы хотите установить сервис маршрутизатора событий на отдельном сервере, укажите хост в файле инвентаря в группе kuma_correlator и установите сервис маршрутизатора на этом хосте. При обновлении KUMA установщик выполнит обновление маршрутизатора, установленного на указанном в файле инвентаря хосте.

2. Создайте директорию /opt/kaspersky/kuma/.
3. Поместите в директорию /opt/kaspersky/kuma/ файл kuma, расположенный внутри установщика в директории /kuma-ansible-installer/roles/kuma/files/.
4. Убедитесь, что файл kuma имеет достаточные права для запуска. Если файл не является исполняемым, измените права для запуска с помощью следующей команды:

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

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

   sudo /opt/kaspersky/kuma/kuma license

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

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

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

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

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

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

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

   sudo /opt/kaspersky/kuma/kuma eventrouter --core https://<FQDN>:<port> --pair.fingerprint <CA_cert_ID> --id <service_ID> --api.port <API_port> --install

   где:

   • <FQDN> — полное доменное имя сервера Ядра KUMA.
   • <port> — номер порта Ядра KUMA для внутренних коммуникаций (по умолчанию используется порт 7210).
   • <CA_cert_ID> — идентификатор отпечатка CA-сертификата, используемый для проверки подлинности при подключении сервиса.

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

   • <service_ID> — идентификатор маршрутизатора, скопированный из веб-интерфейса KUMA.
   • <API_port> — порт, используемый для связи с устанавливаемым компонентом.

   Пример: 

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

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