Установка агента KUMA на устройствах Linux

Агент KUMA, установленный на устройствах Linux, останавливается при закрытии терминала или при перезапуске сервера. Если вы не хотите запускать агенты KUMA вручную, мы рекомендуем устанавливать их с помощью программы, которая автоматически запускает программы при перезапуске сервера, например с помощью программы Supervisor. Если вы хотите запускать агенты KUMA автоматически, укажите в конфигурационном файле KUMA параметры автоматического запуска и перезапуска. Подробнее о настройке параметров автоматического запуска и перезапуска см. официальную документацию программ для автоматического запуска программ.

Пример настройки параметров в программе Supervisor

Чтобы установить агент KUMA на устройство Linux:

1. На устройстве Linux, на котором вы хотите установить агент KUMA, создайте директории для конфигурационного файла и агентов KUMA, например:
   • /opt/kaspersky/kuma;
   • /opt/kaspersky/agent.
2. Поместите конфигурационный файл KUMA в созданную для него директорию. Конфигурационный файл KUMA расположен внутри установщика в директории /kuma-ansible-installer/roles/kuma/files.

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

3. Создайте пользователя KUMA выполнив команду:

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

4. Предоставьте пользователю KUMA доступ к директории с конфигурационным файлом KUMA, а также ко всем файлам внутри директории, выполнив команду:

   sudo chown -R kuma:kuma <path>

   где:

   <path> — путь к директории с конфигурационным файлом KUMA.

5. Установите агент KUMA, выполнив команду:

   sudo /opt/kaspersky/kuma/agent agent --core https://<FQDN>:<port> --pair.fingerprint <CA_cert_ID> --id <service_ID> --wd <path> [--accept-eula]

   где:

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

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

     Если вы хотите указать идентификатор отпечатка для обеспечения проверки подлинности CA-сертификата Ядра KUMA, перейдите в раздел Ресурсы и сервисы → Активные сервисы, установите флажок рядом с сервисом Ядра KUMA, в меню () выберите Копировать отпечаток сертификата, затем скопированный идентификатор используйте в команде установки агента. При перевыпуске CA-сертификата необходимо скопировать новый отпечаток сертификата в веб-интерфейсе и перезапустить сервис с обновленным значением параметра.

   • <service_ID> — идентификатор сервиса, скопированный из веб-интерфейса KUMA.
   • <path> — путь к директории, где будут размещаться файлы устанавливаемого агента KUMA. Если не указать этот параметр, файлы будут храниться в директории, где расположен файл kuma.

   Вы можете установить два агента KUMA на одном устройстве Linux. В этом случае агенты KUMA будут работать параллельно. При установке второго агента KUMA вам нужно указать для него отдельную директорию с помощью параметра --wd.

   Для запуска агента вам нужно принять Лицензионное соглашение. Вы можете добавить в команду параметр --accept-eula, чтобы автоматически принять Лицензионное соглашение во время установки агента KUMA. В этом случае установка не требует интерактивного взаимодействия. Если вы не укажете этот параметр, вам нужно будет принять или отклонить Лицензионное соглашение самостоятельно во время установки агента KUMA.

   Примеры установки агента KUMA:

   • Установка агента KUMA без автоматического принятия Лицензионного соглашения:

     sudo /opt/kaspersky/kuma/agent agent --core https://kuma.example.com:7210 --id XXXX --wd /opt/kaspersky/kuma/agent/XXXX

   • Установка агента KUMA с автоматическим принятием Лицензионного соглашения:

     sudo /opt/kaspersky/kuma/agent agent --core https://kuma.example.com:7210 --id XXXX --wd /opt/kaspersky/kuma/agent/XXXX --accept-eula

   Используя параметр --accept-eula во время установки агента KUMA, вы подтверждаете, что согласны с условиями Лицензионного соглашения и принимаете их.

6. Если вы выбрали установку KUMA с автоматическим принятием Лицензионного соглашения и хотите ознакомиться текстом лицензии или в процессе установки вам не был автоматически предоставлен текст Лицензионного соглашения, выполните команду:

   ./agent license --show

Агент KUMA будет установлен на устройстве Linux.

Вы можете настроить коллектор для приема данных, которые агент KUMA пересылает в KUMA.