Docs
Личный кабинет

Linux

Агент для установки на устройства различными дистрибутивами Linux


Установка агента

Для ОС Linux установка и удаление агента производится через ansible роль. Роль и инструкция по настройке находится в репозитории.

Ansible - система управления конфигурациями, написанная на языке программирования Python, с использованием декларативного языка разметки для описания конфигураций. Применяется для автоматизации настройки и развёртывания программного обеспечения. Документация ansible: https://docs.ansible.com/

Для установки агента необходимо, чтобы на основной машине был доступ по SSH до всех целевых машин.

Проверьте, установлен ли модуль pip:

bash

Если модуль отсутствует, то его необходимо установить

Установить ansible:

bash

Проверить установленную версию можно выполнив команду:

bash

Создайте директорию, в которой будут находиться файлы для установки агента:

bash

Создайте дочернюю директорию и скачайте ansible роль агента

bash

Вернитесь в каталог exploitdog

bash

Создайте плейбук, например agent.yaml, со следующим содержимым:

yaml

В поле exploitdog_agent_url необходимо указать URL личного кабинета. Например, для облачного решения:

Список доступных коллекторов можно посмотреть в соответствующем разделе документации (см. Доступные коллекторы)

Далее необходимо создать инвентарь и указать в нём параметры подключения для всех машин, на которые необходимо установить агент, в примере файл будет называться hosts:

ini

Структура директории должна иметь следующий вид:

text

Теперь можно запустить установку:

bash

Удаление агента

Для удаления агента необходимо запустить плейбук с указанием переменной uninstall=true :

bash

Поддерживаемые системы и дистрибутивы

  • Alpine Linux ≥2.2

  • Red Hat Enterprise 6, 7, 8

  • CentOS 6, 7, 8

  • Oracle Linux 5, 6, 7, 8

  • openSUSE Leap 42, 15

  • SUSE Enterprise Linux 11, 12, 15

  • Debian GNU/Linux 7, 8, 9, 10, 11, 12

  • Ubuntu *

  • Rocky Linux 8, 9

  • Astra Linux *1.5, *1.6, *1,7

  • РЕД ОС 7.3

Логирование

Для быстрой диагностики возможных проблем с передачей данных агентом предусмотрена система логирования. Полноту логирования данных и выбор варианта вывода логов пользователь может выбрать при конфигурации установочного файла агента или внеся изменение в файл конфигурации уже установленного агента. В случае, если при конфигурации агента пользователь выбрал логирование в файл, логи находятся по адресу: /var/log/exploitdog_agent/

Файл конфигурации

Параметры агента в момент его установки сохраняются в файле конфигурации config.json. Данный файл находится по адресу: /etc/exploitdog_agent/config.json

Назад

Windows