Установка расширения на Ubuntu через GPO#
1. Требования#
Контроллер домена Windows Server с RSAT и модулем PowerShell
GroupPolicyлибо подготовленная среда для создания GPO.Ubuntu-клиент, введённый в домен Active Directory.
На клиенте настроены DNS и машинная аутентификация Samba.
Пакет скриптов
Администраторские права для настройки GPO и Ubuntu.
Для применения политик на Ubuntu используется samba-gpupdate и расширение Samba VGP/Unix Settings/Startup Scripts.
Важно: подготовка Ubuntu выполняется отдельно. Доставить клиент GPO на неподготовленную машину с помощью этой же GPO нельзя.
2. Подготовка файлов#
Подготовьте комплект:
GlobalERP_Ubuntu_GPO/
├── README.md
└── files/
├── makegpo.ps1
├── install-globalerp.sh
├── client-setup.sh
└── globalerp-browser-extension.deb
Передайте на контроллер домена каталог files/ целиком.
makegpo.ps1 создаёт GPO, копирует файлы в SYSVOL, формирует manifest.xml и обновляет версию GPT.INI.
install-globalerp.sh устанавливает пакет .deb и записывает результат в /var/log/globalerp-gpo-install.log.
3. Создание GPO на контроллере домена#
3.1. Настройка параметров#
Откройте files/makegpo.ps1 и измените блок CONFIG:
$GpoName = 'GlobalERP_BrowserExtension'
$DomainDN = 'DC=server,DC=local'
$SysvolDom = 'server.local'
Укажите собственное имя домена и DN домена или OU, в котором находятся компьютеры Ubuntu.
3.2. Создание политики#
Запустите PowerShell от имени администратора в каталоге с комплектом:
powershell -ExecutionPolicy Bypass -File .\files\makegpo.ps1
Проверьте, что в каталоге политики появились файлы:
<SYSVOL>\<домен>\Policies\{GUID}\Machine\VGP\VTLA\Unix\Scripts\Startup\
├── manifest.xml
├── install-globalerp.sh
└── globalerp-browser-extension.deb
Привязка GPO: привяжите политику к корню домена или OU, содержащему компьютеры Ubuntu. К стандартному контейнеру CN=Computers привязать GPO нельзя — при необходимости перенесите компьютеры в отдельный OU.
4. Подготовка Ubuntu#
На каждой машине один раз выполните подготовку клиента.
4.1. Установка компонентов Samba#
sudo apt-get update
sudo apt-get install -y python3-samba samba-common-bin samba-dsdb-modules
Проверьте наличие утилиты и LDAP-модуля:
command -v samba-gpupdate
ls -l /usr/lib/x86_64-linux-gnu/samba/ldb/ildap.so
Если путь к ildap.so отличается, найдите файл в установленных пакетах Samba.
4.2. Проверка домена#
sudo net ads testjoin -P
Ожидаемый результат:
Join is OK
Также проверьте DNS:
resolvectl status
host <dc-fqdn>
В выводе resolvectl status должен быть указан DNS-сервер домена, а имя контроллера должно разрешаться в IP-адрес.
Если машина введена в домен только через SSSD/realmd, проверьте наличие машинных учётных данных Samba. Для работы samba-gpupdate недостаточно одной пользовательской доменной авторизации.
4.3. Настройка автоматического применения GPO#
Откройте files/client-setup.sh и измените блок CONFIG согласно комментариям в скрипте:
IP-адрес контроллера домена;
имя или UUID сетевого подключения NetworkManager.
Запустите:
sudo sh ./files/client-setup.sh
Скрипт должен настроить DNS и создать samba-gpupdate.service и samba-gpupdate.timer.
Проверьте таймер:
sudo systemctl status samba-gpupdate.timer
sudo systemctl list-timers samba-gpupdate.timer
5. Применение политики#
Запустите применение машинных политик вручную:
sudo samba-gpupdate --target=Computer
Проверьте результирующий набор политик:
sudo samba-gpupdate --rsop
В выводе должна присутствовать политика VGP/Unix Settings/Startup Scripts с путём к install-globalerp.sh.
Если скрипт отображается в RSOP, но пакет не устанавливается, проверьте наличие скрипта и .deb в локальном кэше Samba, а также журнал установки.
6. Проверка установки#
Проверьте журнал:
sudo cat /var/log/globalerp-gpo-install.log
Проверьте пакет:
dpkg -l | grep globalerp
Проверьте файлы расширения:
sudo ls -l /opt/global-erp/browser-extension/
Ожидается установленный пакет globalerp-browser-extension и файлы:
globalerp-extension.crx
globalerp-extension.json
update.xml
Фактическая версия пакета и наличие файлов зависят от поставленного .deb.
7. Обновление расширения#
Замените
globalerp-browser-extension.debв каталогеfiles/на новую версию.Повторно запустите
makegpo.ps1на контроллере домена.Убедитесь, что скрипт обновил хэш в
manifest.xmlи версиюGPT.INI.Дождитесь запуска таймера на Ubuntu либо выполните вручную:
sudo samba-gpupdate --target=Computer
Расширение run_once выполняет скрипт повторно при изменении хэша настройки. Поэтому обновление должно менять хэш, связанный с .deb и установочным скриптом.
Не используйте --force для обычного обновления без необходимости: этот параметр повторно применяет все политики.
8. Диагностика#
Симптом |
Что проверить |
|---|---|
|
Установлен ли |
Ошибка загрузки GPO через SMB |
DNS, время, доступ к SYSVOL, |
GPO отсутствует в RSOP |
Привязку GPO, OU компьютера и наследование политик |
Скрипт есть в RSOP, но не запускается |
Путь к скрипту в кэше, |
Ошибка |
Структуру |
После замены пакета установка не повторяется |
Изменение хэша в |
Пакет установлен, но расширение отсутствует в браузере |
Файлы в |
Полезные команды:
sudo samba-gpupdate --rsop -d 10
sudo systemctl status samba-gpupdate.service
sudo journalctl -u samba-gpupdate.service -n 50 --no-pager
sudo cat /var/log/globalerp-gpo-install.log
9. Работа без интернета#
Пакет настраивает браузеры семейства Chromium через trigger-browsers.sh. Согласно исходной конфигурации, расширение устанавливается из локальных файлов:
/opt/global-erp/browser-extension/
├── globalerp-extension.crx
├── globalerp-extension.json
└── update.xml
Пример локального источника в политике:
{
"ExtensionInstallForcelist": [
"ngfgcgjklkfnbpandhelhehghbfbebai;file:///opt/global-erp/browser-extension/update.xml"
]
}
В update.xml указывается локальный путь к .crx. Если браузер и его политика поддерживают такую схему установки, доступ к интернету для получения расширения не требуется.