Распространение агентов через групповые политики Windows
Распространение агентов на конечные устройства с помощью групповых политик осуществляется только в ОС Windows и состоит из следующих этапов:
Подготовка окружения
Развертывание выполняется автоматически, от пользователя целевого устройства никаких действий не требуется. Все операции выполняются от имени учетной записи компьютера средствами групповых политик и PowerShell-скриптов.
На целевых устройствах должен использоваться стандартный путь установки агента — C:\Program Files (x86)\RVision\Agent. Скрипты развертывания не учитывают переменную окружения RVISION_AGENT_INSTALL_PATH: при нестандартном пути установки настройка rpoint.conf, запуск службы и проверка состояния агента выполнены не будут.
|
Для распространения агентов через групповые политики Windows необходимы следующие элементы ИТ-инфраструктуры:
-
Настроенный домен Active Directory.
-
Целевые рабочие станции и серверы под управлением ОС Windows поддерживаемых версий.
-
Права доменного администратора на следующие операции:
-
копирование файлов в
SYSVOL; -
создание и редактирование групповых политик;
-
привязка групповых политик к организационному подразделению.
-
-
Общий каталог
SYSVOL, доступный по пути:\\<domain>\SYSVOL\<domain>\scripts.Здесь и далее:
-
<domain>— домен Active Directory вашей организации. Например:domain.local.
-
Получение установочных файлов и скриптов
Для настройки автоматизированного развертывания потребуются следующие компоненты:
-
evo-agent-x64.msi— установщик агента. Поставляется в комплекте с продуктом. -
VC_redist.x64.exe— установщик Microsoft Visual C++ Redistributable (x64) поддерживаемой версии. Актуальную версию необходимо скачать с официального сайта Microsoft.Скрипт проверки и установки проверяет наличие 64-разрядной версии среды выполнения. На 32-разрядных ОС установка данного компонента пропускается. -
ca_root.cer— корневой сертификат вашего шлюза. Инструкция по созданию сертификата приведена в разделе Добавление TLS-сертификата на хосте агента. Полученный файл корневого сертификатаca.crtнеобходимо переименовать вca_root.cer. Подготовленный файл должен полностью совпадать с сертификатом, установленным на сервере шлюза.Файл сертификата в каталоге SYSVOLслужит резервным источником для импорта корневого сертификата на случай сбоя групповой политики, а также используется в качестве эталона при проверке состояния агента. СкриптAgent-HealthCheck.ps1сверяет отпечаток сертификата из данного файла с содержимым хранилища Доверенные корневые центры сертификации локального компьютера. -
Служебные скрипты для развертывания агентов через групповые политики:
-
Install-VCRedist.ps1— скрипт установки зависимостей. -
Agent-Config.ps1— основной скрипт установки и конфигурации агента. -
Agent-HealthCheck.ps1— скрипт проверки состояния агента. -
Agent-Deploy.cmd— стартовый скрипт (обертка для групповых политик).
-
Файлы VC_redist.x64.exe и Install-VCRedist.ps1 не требуются, если для развертывания используется пакет формата evo-agent-<build_no>.s-<bit_depth>.msi, в который уже включен Microsoft Visual C++ Redistributable. В этом случае их можно не добавлять в каталог SYSVOL, а этап установки зависимостей будет автоматически пропущен.
|
Если имена файлов MSI, установщика VC++ или корневого сертификата отличаются от указанных выше, необходимо переименовать их в evo-agent-x64.msi, VC_redist.x64.exe и ca_root.cer соответственно.
|
Подготовка дистрибутива в SYSVOL
Все служебные файлы и скрипты должны храниться в общем каталоге SYSVOL на контроллере домена.
Чтобы подготовить каталог:
-
На контроллере домена или АРМ администратора откройте проводник.
-
Перейдите в каталог скриптов:
\\<domain>\SYSVOL\<domain>\scripts -
Создайте в нем каталог
EVO-Agent. -
Скопируйте в каталог
\\<domain>\SYSVOL\<domain>\scripts\EVO-Agentследующие файлы:-
evo-agent-x64.msi; -
VC_redist.x64.exe— не требуется при использовании пакета форматаevo-agent-<build_no>.s-<bit_depth>.msi; -
ca_root.cer; -
Install-VCRedist.ps1— не требуется при использовании пакета форматаevo-agent-<build_no>.s-<bit_depth>.msi; -
Agent-Config.ps1; -
Agent-HealthCheck.ps1; -
Agent-Deploy.cmd.
-
-
Настройте права доступа к созданному каталогу
EVO-Agent:-
Для группы Компьютеры домена установите тип разрешения Чтение.
-
Для группы Администраторы и сервисных учетных записей установите тип разрешения Изменение.
-
Настройка скриптов развертывания
Перед созданием групповых политик необходимо адаптировать скрипты под вашу инфраструктуру, указав параметры шлюза и корректные сетевые пути.
Настройка параметров подключения
В файле Agent-Config.ps1 укажите данные шлюза, к которому будут подключаться агенты. Для этого:
-
Откройте файл
\\<domain>\SYSVOL\<domain>\scripts\EVO-Agent\Agent-Config.ps1в текстовом редакторе. -
Найдите блок переменных и укажите актуальные значения для вашей системы:
-
$GatewayHost— полное доменное имя (FQDN) или IP-адрес шлюза. -
$GatewayPort— порт подключения к шлюзу. Допустимые значения:30000—32767. Указанный порт должен соответствовать значению, заданному для шлюза в веб-интерфейсе системы. -
$UseTls— нужно ли использовать защищенное соединение по протоколу TLS:-
$true— используется TLS-соединение. -
$false— используется незащищенное соединение.
-
Пример настроек переменных$GatewayHost = "gw01.evo.local" $GatewayPort = 32000 $UseTls = $true -
-
Сохраните изменения.
|
Скрипт
Благодаря такой логике соблюдается строгая последовательность операций по установке, настройке |
Настройка пути запуска
В файле Agent-Deploy.cmd необходимо указать путь к сетевому каталогу вашего домена, чтобы основной скрипт мог запуститься по сети. Для этого:
-
Откройте файл
\\<domain>\SYSVOL\<domain>\scripts\EVO-Agent\Agent-Deploy.cmdв текстовом редакторе. -
Найдите переменную
PS_SCRIPT. -
Замените в значении переменной плейсхолдеры
<domain>на доменное имя вашей организации. Итоговый путь должен указывать на файлAgent-Config.ps1в сетевом каталогеSYSVOL. Например:set PS_SCRIPT=\\company.local\SYSVOL\company.local\scripts\EVO-Agent\Agent-Config.ps1 -
Сохраните изменения.
При настройке политики файл Agent-Deploy.cmd копируется в ее скрытый каталог. В результате применения политики целевые устройства используют данную копию, а не исходный файл из каталога \\<domain>\SYSVOL\<domain>\scripts\EVO-Agent. В связи с этим все изменения в файл Agent-Deploy.cmd необходимо вносить перед его копированием. При обновлении параметров в будущем потребуется повторно скопировать измененный файл в каталог политики.
|
Добавление TLS-сертификата
При необходимости вы можете обеспечить безопасную передачу данных между агентами и шлюзами с помощью защищенного соединения по протоколу TLS (Transport Layer Security).
Чтобы настроить защищенное подключение агента, необходимо добавить TLS-сертификат для групповой политики. Для этого:
-
Откройте консоль управления доменными групповыми политиками
gpmc.msc. Это можно сделать следующим образом:-
Нажмите сочетание клавиш WIN+R. Откроется окно Выполнить.
-
Введите в окне
gpmc.mscи нажмите ОК.
-
-
Создайте новую политику, например,
RVision-EVO-TLS-RootCA. -
Привяжите созданную политику к организационному подразделению, в котором находятся целевые устройства.
-
Откройте контекстное меню групповой политики и выберите опцию Изменить. Откроется редактор управления групповыми политиками.
-
Перейдите в раздел Конфигурация компьютера → Политики → Конфигурация Windows → Параметры безопасности → Политики открытого ключа → Доверенные корневые центры сертификации.
-
Выполните команду контекстного меню Импорт. Откроется мастер импорта сертификатов.
-
Нажмите Далее на стартовой странице мастера.
-
На странице выбора сертификата укажите файл
\\<domain>\SYSVOL\<domain>\scripts\EVO-Agent\ca_root.cerи нажмите Далее.Удостоверьтесь, что для импорта выбран именно указанный файл, поскольку скрипт проверки состояния агента сравнивает отпечаток сертификата из него с содержимым хранилища и при импорте другого файла проверка будет завершаться с ошибкой. -
Удостоверьтесь, что на странице выбора хранилища выбран вариант Поместить все сертификаты в следующее хранилище и выбрано хранилище Доверенные корневые центры сертификации. Нажмите Далее.
-
Проверьте корректность указанных параметров на странице завершения импорта и нажмите Готово. Сертификат будет добавлен в список доверенных.
-
Выйдите из редактора политики с помощью команды главного меню Файл → Выход. После репликации групповой политики сертификат будет добавлен в хранилище Доверенные корневые центры сертификации локального компьютера на всех устройствах целевого организационного подразделения.
Отдельная перезагрузка на этом этапе не требуется, поскольку целевые устройства перезагружаются один раз после настройки всех политик.
Настройка политики для установки агента
Для установки агента при загрузке системы используется стартовый скрипт. Чтобы настроить групповую политику:
-
Откройте консоль управления доменными групповыми политиками
gpmc.msc. -
Создайте новую политику, например,
RVision-EVO-Agent-Install. -
Привяжите созданную политику к организационному подразделению с целевыми устройствами, на которых требуется установить агенты.
-
Откройте редактор политики и перейдите в раздел Конфигурация компьютера → Политики → Конфигурация Windows → Сценарии (запуск/завершение).
-
Дважды нажмите на пункт Автозагрузка.
-
Нажмите на кнопку Показать файлы. Откроется скрытый каталог политики.
-
Скопируйте в этот каталог файл
Agent-Deploy.cmdиз каталога\\<domain>\SYSVOL\<domain>\scripts\EVO-Agent. -
Закройте проводник и в окне свойств автозагрузки на вкладке Сценарии нажмите на кнопку Добавить.
-
В поле Имя сценария выберите скопированный файл
Agent-Deploy.cmd. Поле Параметры сценария оставьте пустым. -
Нажмите на кнопку ОК.
Включение ожидания сети
Для корректной работы стартовых скриптов необходимо включить ожидание доступности сети при загрузке. Для этого:
-
В редакторе политики установки агента
RVision-EVO-Agent-Installперейдите в раздел Конфигурация компьютера → Политики → Административные шаблоны → Система → Вход в систему. -
Выберите параметр Всегда ждать сеть при запуске и входе в систему.
-
Установите значение Включена.
-
Сохраните изменения.
Настройка политики для регулярной проверки агента
Для обеспечения отказоустойчивости агента настройте планировщик задач. Для этого:
-
Откройте консоль управления доменными групповыми политиками
gpmc.msc. -
Создайте новую политику, например,
RVision-EVO-Agent-HealthCheck. -
Привяжите созданную политику к целевому организационному подразделению.
-
Откройте редактор политики и перейдите в раздел Конфигурация компьютера → Настройка → Параметры панели управления → Назначенные задания.
-
В контекстном меню правой панели выберите Создать → Запланированная задача (не ниже Windows 7).
-
В открывшемся окне на вкладке Общие задайте следующие параметры:
-
В поле Действие выберите вариант Обновить. Это обеспечит применение заданных параметров в том числе на тех устройствах, где задача уже создана.
-
Введите имя
RVision Agent HealthCheck. -
Укажите выполнение от имени учетной записи
NT AUTHORITY\System. -
Выберите вариант Выполнять вне зависимости от регистрации пользователя. В противном случае задача не будет выполняться при отсутствии интерактивного сеанса.
-
Установите флажок Выполнить с наивысшими правами.
-
-
На вкладке Триггеры добавьте триггер При запуске компьютера. Дополнительно можно настроить выполнение задачи по расписанию, например, ежедневно или ежечасно.
-
На вкладке Действия добавьте новое действие:
-
Действие: выберите вариант Запуск программы.
-
Программа или сценарий:
powershell.exe. -
Добавить аргументы:
-NoProfile -ExecutionPolicy Bypass -File "\\<domain>\SYSVOL\<domain>\scripts\EVO-Agent\Agent-HealthCheck.ps1"В строке аргументов обязательно замените
<domain>на имя вашего домена. Например:-NoProfile -ExecutionPolicy Bypass -File "\\company.local\SYSVOL\company.local\scripts\EVO-Agent\Agent-HealthCheck.ps1"
-
-
Сохраните задачу и закройте редактор групповой политики.
После применения групповой политики на целевых устройствах при их запуске или в соответствии с установленным расписанием будет выполняться скрипт Agent-HealthCheck.ps1, который выполняет следующие действия:
-
проверка текущего состояния службы и программных модулей агента;
-
автоматический запуск процесса восстановления с помощью скрипта
Agent-Config.ps1с параметром-Repairпри обнаружении сбоев; -
запись сведений о результатах проверки в локальные файлы логов и в системный журнал событий Application.
Проверка наличия корневого сертификата выполняется скриптом независимо от использования защищенного соединения. При настройке подключения без TLS и отсутствии сертификата проверка зарегистрирует событие с EventID 1001 и ошибочно инициирует процесс восстановления. Во избежание ложных срабатываний необходимо разместить файл сертификата в каталоге SYSVOL и настроить его распространение через групповую политику.
|
Завершение настройки и проверка
После завершения настройки политик целевые машины необходимо перезагрузить для применения изменений и запуска установки.
Скрипт групповых политик отрабатывает при каждой перезагрузке. Это обеспечивает автоматическое применение новых настроек, например, при смене порта шлюза. Для этого достаточно обновить в каталоге \\<domain>\SYSVOL\<domain>\scripts\EVO-Agent файлы Agent-Config.ps1, Agent-HealthCheck.ps1, evo-agent-x64.msi и ca_root.cer — изменения будут автоматически применены на целевых устройствах при следующей перезагрузке.
Исключением является файл Agent-Deploy.cmd. Запуск данного сценария осуществляется из скрытого каталога групповой политики. Для применения внесенных изменений необходимо повторно скопировать обновленный файл в каталог политики.
Локальная проверка на конечных устройствах
| Для выполнения перечисленных проверок на целевом устройстве требуются права локального администратора. |
Для диагностики процесса на конкретном хосте проверьте следующие элементы:
-
Логи установки:
-
C:\ProgramData\RVision\AgentDeploy\Agent-Deploy.log— лог стартового скрипта, содержащий код возврата процессаpowershell.exe. -
C:\ProgramData\RVision\AgentDeploy\Logs\Agent-Config.log— лог основного скрипта установки и конфигурации. -
C:\ProgramData\RVision\AgentDeploy\Logs\Install-VCRedist.log— лог установки зависимостей. -
C:\ProgramData\RVision\AgentDeploy\Logs\Agent-HealthCheck.log— лог проверки состояния агента. -
C:\ProgramData\RVision\AgentDeploy\Logs\Agent-HealthStatus.json— результаты последней проверки состояния в формате JSON.
-
-
Статус агента:
-
Наличие активной службы
RvisionAgentв оснасткеservices.msc. -
Корректный статус программных модулей при выполнении следующей команды из каталога
C:\Program Files (x86)\RVision\Agent\bin:rpoint-launcher.exe status
-
-
Конфигурационный файл: наличие актуального адреса шлюза в файле
C:\Program Files (x86)\RVision\Agent\etc\rpoint.conf. -
Сертификат: наличие сертификата шлюза в оснастке
certlm.mscв разделе Доверенные корневые центры сертификации.
Централизованная проверка
После применения групповых политик проверьте статус регистрации агентов и результаты автоматической проверки состояния:
-
Убедитесь, что агенты появились в разделе Агенты → Агенты веб-интерфейса системы и перешли в статус Онлайн.
Статус Зарегистрирован означает, что агент зарегистрировался в системе, но еще не подтвердил свою активность. Если агент остается в этом статусе, проверьте корректность адреса и порта шлюза в файле
Agent-Config.ps1, а при использовании защищенного соединения — наличие корневого сертификата шлюза на целевом устройстве. -
В Журнале событий Windows в разделе Приложение найдите события от источника
RVisionAgent-Deployи проверьте значениеEventID:-
1000— проверка состояния пройдена успешно. -
1001— обнаружены проблемы. Подробности указываются в тексте события и в файлеAgent-HealthStatus.json.
-
Была ли полезна эта страница?