Установка расширения на 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. Обновление расширения#

  1. Замените globalerp-browser-extension.deb в каталоге files/ на новую версию.

  2. Повторно запустите makegpo.ps1 на контроллере домена.

  3. Убедитесь, что скрипт обновил хэш в manifest.xml и версию GPT.INI.

  4. Дождитесь запуска таймера на Ubuntu либо выполните вручную:

sudo samba-gpupdate --target=Computer

Расширение run_once выполняет скрипт повторно при изменении хэша настройки. Поэтому обновление должно менять хэш, связанный с .deb и установочным скриптом.

Не используйте --force для обычного обновления без необходимости: этот параметр повторно применяет все политики.

8. Диагностика#

Симптом

Что проверить

DSID-0C090A37, ошибка LDAP bind

Установлен ли samba-dsdb-modules, присутствует ли ildap.so, работает ли машинная аутентификация

Ошибка загрузки GPO через SMB

DNS, время, доступ к SYSVOL, sudo net ads testjoin -P

GPO отсутствует в RSOP

Привязку GPO, OU компьютера и наследование политик

Скрипт есть в RSOP, но не запускается

Путь к скрипту в кэше, manifest.xml, журнал установки

Ошибка generate_attribute или None

Структуру manifest.xml; не добавляйте пустой элемент <parameters></parameters>

После замены пакета установка не повторяется

Изменение хэша в manifest.xml и версии GPT.INI

Пакет установлен, но расширение отсутствует в браузере

Файлы в /opt/global-erp/browser-extension/, политику браузера и поддержку локального file://-источника

Полезные команды:

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. Если браузер и его политика поддерживают такую схему установки, доступ к интернету для получения расширения не требуется.