Работа с агентами на хосте

На хосте доступны следующие операции над агентами:

Способ выполнения каждой операции зависит от используемой ОС на хосте агента.

Для выполнения операций над агентами необходимо обладать правами администратора или суперпользователя (root).

Запуск агента

После установки агента в ОС создается служба, запускающая его автоматически после каждой перезагрузки хоста.

При этом сам агент автоматически не запускается сразу после установки. Первый запуск агента можно осуществить вручную, или он произойдет автоматически после перезагрузки хоста.

После запуска агента происходит его регистрация в системе.

Ниже представлены способы запуска агента вручную.

  • Linux

  • Windows

  • macOS

  • Для дистрибутивов Astra Linux и РОСА Хром Сервер:

    sudo systemctl start evo-agent.service

  • Для остальных дистрибутивов:

    • Если переменная окружения EVO_AGENT_HOME не задана:

      sudo /opt/rvision/agent/bin/rpoint-launcher start

    • Если переменная окружения EVO_AGENT_HOME задана:

      sudo -E ${EVO_AGENT_HOME}/bin/rpoint-launcher start

Используйте командную оболочку PowerShell:

  • Запуск через cmdlet-команду:

    Start-Service -Name RvisionAgent

  • Запуск через вызов rpoint-launcher:

    • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

      & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' start

    • Если переменная RVISION_AGENT_INSTALL_PATH задана:

      & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" start
sudo /Library/R-Vision/agent/bin/rpoint-launcher start

При запуске агента осуществляется подключение к шлюзу, указанному в конфигурационном файле rpoint.conf, а также выполняется сбор его инвентарной информации.

Запуск агента с дополнительными параметрами

  • При необходимости вы можете указать адрес подключения к шлюзу явно через параметр --gateway-url. Например:

    • Linux

    • Windows

    • macOS

    Для всех дистрибутивов, кроме Astra Linux и РОСА Хром Сервер:

    • Если переменная окружения EVO_AGENT_HOME не задана:

      sudo /opt/rvision/agent/bin/rpoint-launcher start --gateway-url=nats://<addr>:<port>

    • Если переменная окружения EVO_AGENT_HOME задана:

      sudo -E ${EVO_AGENT_HOME}/bin/rpoint-launcher start --gateway-url=nats://<addr>:<port>

    • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

      & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' start --gateway-url=nats://<addr>:<port>

    • Если переменная RVISION_AGENT_INSTALL_PATH задана:

      & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" start --gateway-url=nats://<addr>:<port>
    sudo /Library/R-Vision/agent/bin/rpoint-launcher start --gateway-url=nats://<addr>:<port>

    Здесь:

    • <addr> — адрес подключения к шлюзу.

    • <port> — порт подключения к шлюзу.

  • При необходимости вы можете указать явно, нужно ли включать механизм получения агентом сведений о доступных ему доменных адресах (FQDN) шлюзов. Подробные сведения о данном механизме приведены в описании параметра gateway_discovery_enabled файла конфигурации rpoint.conf.

    Чтобы включить или отключить данный механизм, используйте один из следующих параметров:

    • --gateway-discovery-enable — включает механизм обнаружения доступных FQDN шлюзов и позволяет агенту переключаться между шлюзами. Меняет значение параметра gateway_discovery_enabled на true.

    • --gateway-discovery-disable — отключает механизм обнаружения доступных FQDN шлюзов и не позволяет агенту переключаться между шлюзами. Меняет значение параметра gateway_discovery_enabled на false.

    Ниже приведены примеры запуска агента без включения данного механизма:

    • Linux

    • Windows

    • macOS

    Для всех дистрибутивов, кроме Astra Linux и РОСА Хром Сервер:

    • Если переменная окружения EVO_AGENT_HOME не задана:

      sudo /opt/rvision/agent/bin/rpoint-launcher start --gateway-discovery-disable

    • Если переменная окружения EVO_AGENT_HOME задана:

      sudo -E ${EVO_AGENT_HOME}/bin/rpoint-launcher start --gateway-discovery-disable

    • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

      & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' start --gateway-discovery-disable

    • Если переменная RVISION_AGENT_INSTALL_PATH задана:

      & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" start --gateway-discovery-disable
    sudo /Library/R-Vision/agent/bin/rpoint-launcher start --gateway-discovery-disable

  • При необходимости вы можете указать явно, может ли агент использовать значения по умолчанию для параметров deny_imports и deny_exports. Подробные сведения об этих параметрах приведены в описании следующих параметров файла конфигурации rpoint.conf:

    Чтобы указать логику использования значений по умолчанию, используйте следующие параметры:

    • --default-deny-exports-enable — указывает агенту использовать значения deny_exports по умолчанию и меняет значение параметра default_deny_exports_enabled на true.

    • --default-deny-exports-disable — указывает агенту не использовать значения deny_exports по умолчанию и меняет значение параметра default_deny_exports_enabled на false.

    • --default-deny-imports-enable — указывает агенту использовать значения deny_imports по умолчанию и меняет значение параметра default_deny_imports_enabled на true.

    • --default-deny-imports-disable — указывает агенту не использовать значения deny_imports по умолчанию и меняет значение параметра default_deny_imports_enabled на false.

    Ниже приведены примеры запуска агента с отключением использования deny_exports:

    • Linux

    • Windows

    • macOS

    Для всех дистрибутивов, кроме Astra Linux и РОСА Хром Сервер:

    • Если переменная окружения EVO_AGENT_HOME не задана:

      sudo /opt/rvision/agent/bin/rpoint-launcher start --default-deny-exports-disable

    • Если переменная окружения EVO_AGENT_HOME задана:

      sudo -E ${EVO_AGENT_HOME}/bin/rpoint-launcher start --default-deny-exports-disable

    • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

      & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' start --default-deny-exports-disable

    • Если переменная RVISION_AGENT_INSTALL_PATH задана:

      & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" start --default-deny-exports-disable
    sudo /Library/R-Vision/agent/bin/rpoint-launcher start --default-deny-exports-disable

Перезапуск агента

Перезапуск позволяет остановить агент и запустить его заново с помощью одной команды.

Например, перезапуск агента может потребоваться, если нужно применить актуальную конфигурацию после изменения файла rpoint.conf.

После перезапуска агента происходит его регистрация в системе.

  • Linux

  • Windows

  • macOS

  • Для дистрибутивов Astra Linux и РОСА Хром Сервер:

    sudo systemctl restart evo-agent.service

  • Для остальных дистрибутивов:

    • Если переменная окружения EVO_AGENT_HOME не задана:

      /opt/rvision/agent/bin/rpoint-launcher restart

    • Если переменная окружения EVO_AGENT_HOME задана:

      sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher restart

Используйте командную оболочку PowerShell:

  • Перезапуск через cmdlet-команду:

    Restart-Service -Name RvisionAgent

  • Перезапуск через вызов rpoint-launcher:

    • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

      & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' restart

    • Если переменная RVISION_AGENT_INSTALL_PATH задана:

      & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" restart
sudo /Library/R-Vision/agent/bin/rpoint-launcher restart

При перезапуске агента выполняется сбор его инвентарной информации.

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

  • Linux

  • Windows

  • macOS

  • Для дистрибутивов Astra Linux и РОСА Хром Сервер:

    sudo systemctl stop evo-agent.service

  • Для остальных дистрибутивов:

    • Если переменная окружения EVO_AGENT_HOME не задана:

      /opt/rvision/agent/bin/rpoint-launcher stop

    • Если переменная окружения EVO_AGENT_HOME задана:

      sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher stop

Используйте командную оболочку PowerShell:

  • Остановка через cmdlet-команду:

    Stop-Service -Name RvisionAgent

  • Остановка через вызов rpoint-launcher:

    • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

      & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' stop

    • Если переменная RVISION_AGENT_INSTALL_PATH задана:

      & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" stop
sudo /Library/R-Vision/agent/bin/rpoint-launcher stop

Остановка процессов агента

Помимо полной остановки агента, можно также останавливать его конкретные процессы.

  • Linux

  • Windows

  • macOS

sudo pkill -9 <process_name>

Используйте командную оболочку PowerShell:

Stop-Process -Name "<process_name>" -Force -ErrorAction SilentlyContinue
sudo pkill -9 <process_name>

Здесь:

  • <process_name> — имя процесса, который необходимо остановить.

  • Если попытаться остановить любой процесс, кроме rpoint-launcher, то этот процесс будет автоматически перезапущен.

  • Если попытаться остановить процесс rpoint-launcher, то дальнейшее поведение процессов будет зависеть от сервиса WatchDog:

    • Если сервис WatchDog активен, то процесс rpoint-launcher будет автоматически перезапущен.

    • Если сервис WatchDog неактивен, то процесс rpoint-launcher не будет перезапущен. В этом случае остальные процессы агента могут быть также успешно остановлены.

Перегенерация TLS-сертификата и токена авторизации

Агент подключается к локальному NATS-серверу через TLS-соединение. Для этого при запуске агент автоматически генерирует необходимые TLS-сертификаты и токен авторизации, если они отсутствуют.

TLS-сертификаты и токен авторизации располагаются по следующим путям:

  • Сертификаты:

    • <install_path>/etc/client_key.pem;

    • <install_path>/etc/client_cert.pem.

  • Токен:

    • Файл токена: <install_path>/var/run/nats_token;

    • Информация о токене: в поле authorization.token конфигурационного файла <install_path>/etc/nats-leafnode.conf.

Здесь:

  • <install_path> — полный путь установки агента.

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

Ниже представлены способы перегенерации сертификатов и токена.

  • Linux

  • Windows

  • macOS

  • Если переменная окружения EVO_AGENT_HOME не задана:

    /opt/rvision/agent/bin/rpoint-launcher tls-generate

  • Если переменная окружения EVO_AGENT_HOME задана:

    sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher tls-generate

Используйте командную оболочку PowerShell:

  • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

    & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' tls-generate

  • Если переменная RVISION_AGENT_INSTALL_PATH задана:

    & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" tls-generate
sudo /Library/R-Vision/agent/bin/rpoint-launcher tls-generate

При выполнении команды начинается процесс перегенерации. После успешной перегенерации TLS-сертификатов и токена авторизации агент автоматически перезапускается.

Запрос статуса агента

  • Linux

  • Windows

  • macOS

  • Если переменная окружения EVO_AGENT_HOME не задана:

    /opt/rvision/agent/bin/rpoint-launcher status

  • Если переменная окружения EVO_AGENT_HOME задана:

    sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher status

Используйте командную оболочку PowerShell:

  • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

    & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' status

  • Если переменная RVISION_AGENT_INSTALL_PATH задана:

    & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" status
sudo /Library/R-Vision/agent/bin/rpoint-launcher status

В результате выполнения команды будет выведена информация о текущем статусе агента.

Пример информации о статусе агента
[{"name":"nats-server","status":"running"},{"name":"vm","reason":"Disabled by config","status":"not running"}]

После установки и запуска агента модуль nats-server должен иметь статус running, например:

[{"name":"nats-server","status":"running"},...]

Если статус модуля отличается от running, необходимо переустановить агент.

Запрос статуса приложения rpoint-endpoint-security

Для корректной работы агента в macOS приложение rpoint-endpoint-security должно иметь полный доступ к диску. Вы можете проверить это с помощью следующей команды:

/Library/R-Vision/agent/bin/rpoint-endpoint-security.app/Contents/MacOS/rpoint-endpoint-security verify
Команда работает только в macOS.
Возможные результаты выполнения команды
Результат команды Значение

Module is operational

Клиент сбора событий успешно создан, приложение работоспособно.

Module is not operational: error connection to Endpoint Security subsystem

Не удалось установить соединение с фреймворком Endpoint Security.

Module is not operational: client contained one or more invalid arguments

Некорректные параметры при создании клиента сбора событий.

Module is not operational: application isn’t properly entitled to connect to Endpoint Security

Некорректная подпись приложения.

Module is not operational: missing permissions - check full disk access.

Недостаточно разрешений для работы приложения.

Module is not operational: application isn’t running as root

Приложение работает не от root-пользователя.

Module is not operational: too many users of ESF

Слишком много подключений к фреймворку Endpoint Security.

Просмотр статуса rpoint-endpoint-security в статусе агента

Статус приложения rpoint-endpoint-security также отображается при запросе статуса агента в macOS.

Возможные статусы приложения в информации о статусе агента:

  • Приложение работоспособно и включено:

    {"name":"endpoint-security","status":"running"}

  • Приложение работоспособно, но выключено конфигурацией:

    {"name":"endpoint-security","reason":"Disabled by config","status":"not running"}

  • Приложение неработоспособно:

    {"name":"endpoint-security","reason":"<reason>","status":"not running"}

    Здесь <reason> — причина неработоспособности.

    Причины неработоспособности
    Причина Значение

    error connection to Endpoint Security subsystem

    Не удалось установить соединение с фреймворком Endpoint Security.

    client contained one or more invalid arguments

    Некорректные параметры при создании клиента сбора событий.

    application isn’t properly entitled to connect to Endpoint Security

    Некорректная подпись приложения.

    missing permissions - check full disk access

    Недостаточно разрешений для работы приложения.

    application isn’t running as root

    Приложение работает не от root-пользователя.

    too many users of ESF

    Слишком много подключений к фреймворку Endpoint Security.

Запрос версии агента

  • Linux

  • Windows

  • macOS

  • Если переменная окружения EVO_AGENT_HOME не задана:

    /opt/rvision/agent/bin/rpoint-launcher --version

  • Если переменная окружения EVO_AGENT_HOME задана:

    sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher --version

Используйте командную оболочку PowerShell:

  • Если переменная RVISION_AGENT_INSTALL_PATH не задана:

    & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' version

  • Если переменная RVISION_AGENT_INSTALL_PATH задана:

    & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" version
sudo /Library/R-Vision/agent/bin/rpoint-launcher --version

В результате выполнения команды будет выведена текущая версия агента.

Была ли полезна эта страница?

+7 (499) 755 55 70 sales@rvision.ru

О компании Пользовательское соглашение Политика cookies

Обратная связь