Установка расширения на Debian через GPO#

Инструкция по настройке Debian 12 для установки расширения GlobalERP через групповые политики Active Directory.

Проверенная среда: Debian 12 (bookworm), Samba 4.17, домен server.local.

Схема работы: GPO → samba-gpupdate → startup-скрипт от root → установка .deb. Интернет на клиенте для загрузки расширения не требуется.

1. Параметры и требования#

Все команды выполняются на Debian-клиенте от root, если не указано иное.

Задайте параметры домена:

DC=192.168.200.11
REALM=SERVER.LOCAL
DOM=server.local
NETBIOS=SERVER

Замените значения на параметры своей сети.

Потребуются:

  • контроллер домена AD и учётная запись, имеющая право вводить компьютеры в домен;

  • пакет globalerp-browser-extension.deb;

  • файлы makegpo.ps1, install-globalerp.sh и client-setup.sh из комплекта.

2. Создание GPO на контроллере домена#

На Windows DC откройте PowerShell от имени администратора домена.

  1. Положите файлы рядом makegpo.ps1, install-globalerp.sh и globalerp-browser-extension.deb.

  2. Измените блок CONFIG в makegpo.ps1: имя GPO, DN домена или OU и DNS-имя домена.

  3. Запустите:

powershell -ExecutionPolicy Bypass -File .\makegpo.ps1

Скрипт создаёт GPO, привязывает её к корню домена, копирует файлы в SYSVOL, формирует manifest.xml и увеличивает версию GPT.INI.

GPO можно привязать к корню домена или OU с компьютерами Debian. К контейнеру CN=Computers привязать GPO нельзя.

Требование к manifest.xml#

Для Samba 4.17 элемент <parameters> обязателен и должен быть непустым. Рабочий вариант:

<script>install-globalerp.sh</script>
<parameters> </parameters>
<hash>MD5(install-globalerp.sh + .deb), ВЕРХНИЙ РЕГИСТР</hash>
<run_once/>

makegpo.ps1 из комплекта должен генерировать этот формат. Отсутствующий или пустой <parameters> может привести к ошибке обработки манифеста.

3. Установка компонентов Samba#

На Debian-клиенте выполните:

apt-get update
apt-get install -y samba samba-common-bin samba-dsdb-modules python3-samba \
    winbind krb5-user smbclient acl attr

samba-dsdb-modules предоставляет ildap.so, необходимый для LDAP-аутентификации samba-gpupdate.

Проверьте наличие файлов:

ls -l /usr/lib/x86_64-linux-gnu/samba/ldb/ildap.so
ls -l /usr/sbin/samba-gpupdate

4. Настройка Kerberos и Samba#

4.1. Имя компьютера#

Добавьте FQDN клиента в /etc/hosts:

sed -i "s/^127\.0\.1\.1.*/127.0.1.1	$(hostname).$DOM $(hostname)/" /etc/hosts

4.2. Kerberos#

Создайте /etc/krb5.conf:

cat >/etc/krb5.conf <<EOF
[libdefaults]
    default_realm = $REALM
    dns_lookup_realm = false
    dns_lookup_kdc = true
    rdns = false

[realms]
    $REALM = {
        kdc = $DC
        admin_server = $DC
    }

[domain_realm]
    .$DOM = $REALM
    $DOM = $REALM
EOF

4.3. Samba#

Создайте /etc/samba/smb.conf:

cat >/etc/samba/smb.conf <<EOF
[global]
    workgroup = $NETBIOS
    realm = $REALM
    security = ads
    kerberos method = secrets and keytab
    template shell = /bin/bash
    winbind use default domain = yes
    idmap config * : backend = tdb
    idmap config * : range = 3000-7999
    idmap config $NETBIOS : backend = rid
    idmap config $NETBIOS : range = 10000-999999
EOF

testparm -s

Проверьте вывод testparm -s на ошибки конфигурации.

5. Настройка DNS#

Для минимальной установки Debian без NetworkManager используется /etc/dhcp/dhclient.conf.

Добавьте настройки DNS контроллера домена:

cat >>/etc/dhcp/dhclient.conf <<EOF

# AD DNS (GPO deploy)
supersede domain-name "$DOM";
supersede domain-name-servers $DC;
supersede domain-search "$DOM";
EOF

systemctl restart networking

Проверьте настройки DNS и разрешение имён:

cat /etc/resolv.conf
getent hosts "$(hostname -d)"
getent hosts <FQDN-контроллера>

Замените <FQDN-контроллера> на полное DNS-имя DC. Имя контроллера должно разрешаться в IP-адрес. DNS должен также разрешать SRV-записи домена, необходимые для поиска контроллера.

6. Ввод в домен и проверка winbind#

Введите машину в домен:

net ads join -U <доменный_пользователь>

Команда запросит пароль. Затем проверьте доверительные отношения и перезапустите winbind:

net ads testjoin -P
systemctl restart winbind

Ожидаемый результат net ads testjoin -P:

Join is OK

Перезапуск winbind необходим, если служба была запущена до создания или изменения smb.conf.

6.1. Проверка доменных пользователей#

Включите создание домашнего каталога при первом входе:

DEBIAN_FRONTEND=noninteractive pam-auth-update --enable mkhomedir

Проверьте домен и учётную запись:

wbinfo -t
getent passwd <пользователь>
wbinfo -a '<NETBIOS>\<пользователь>%<пароль>'

Замените placeholders реальными данными. Команда wbinfo -a содержит пароль в аргументах; используйте её только если это допустимо в вашей среде.

Для входа используйте имя, которое разрешается через NSS:

su - <пользователь>

или:

su - '<NETBIOS>\<пользователь>'

Для SSH указывайте IP-адрес или имя Debian-клиента:

ssh <пользователь>@<IP-клиента>

su принимает имя пользователя NSS, а не Kerberos UPN вида user@realm. В команде ssh user@server.local часть после @ — имя SSH-сервера, а не realm пользователя.

7. Автоматическое применение GPO#

В Debian/Ubuntu обычно нет готового systemd-таймера для samba-gpupdate. Создайте службу:

cat >/etc/systemd/system/samba-gpupdate.service <<'EOF'
[Unit]
Description=Apply Samba Group Policy (machine)
Wants=network-online.target
After=network-online.target

[Service]
Type=oneshot
ExecStart=/usr/sbin/samba-gpupdate --target=Computer
EOF

Создайте таймер:

cat >/etc/systemd/system/samba-gpupdate.timer <<'EOF'
[Unit]
Description=Periodically apply Samba Group Policy (machine)

[Timer]
OnBootSec=2min
OnUnitActiveSec=1h
Persistent=true

[Install]
WantedBy=timers.target
EOF

Включите таймер:

systemctl daemon-reload
systemctl enable --now samba-gpupdate.timer
systemctl status samba-gpupdate.timer

Вместо ручного создания юнитов можно использовать files/client-setup.sh из комплекта, если его настройки соответствуют вашей сети.

8. Применение и проверка политики#

Сначала проверьте, видит ли клиент startup-скрипт:

samba-gpupdate --rsop | grep -A3 "Startup Scripts"

В выводе ожидается путь к INSTALL-GLOBALERP.SH в локальном кэше GPO.

При первом применении выполните:

samba-gpupdate --force

Для последующих обычных обновлений используйте:

samba-gpupdate

Проверьте установку:

cat /var/log/globalerp-gpo-install.log
dpkg -l globalerp-browser-extension
ls -l /opt/global-erp/browser-extension/

Ожидается статус пакета install ok installed и файлы:

globalerp-extension.crx
globalerp-extension.json
update.xml

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

9. Настройка браузера Chromium#

Пакет настраивает установленный браузер семейства Chromium через локальную политику ExtensionInstallForcelist. Файлы расширения берутся из /opt/global-erp/browser-extension/; доступ к интернету для их загрузки не требуется.

На Debian пакет Chromium может не создать каталог политик заранее. Проверьте наличие файла:

cat /etc/chromium/policies/managed/globalerp-extension.json

Ожидаемый формат:

{
  "ExtensionInstallForcelist": [
    "ngfgcgjklkfnbpandhelhehghbfbebai;file:///opt/global-erp/browser-extension/update.xml"
  ]
}

Если используемый install-globalerp.sh не создаёт каталог политик, добавьте создание каталога перед установкой пакета:

mkdir -p /etc/chromium/policies/managed

После установки пакетный триггер можно запустить повторно:

/usr/share/globalerp-browser-extension/trigger-browsers.sh install

Проверьте появление расширения в профиле Chromium после запуска браузера:

ls ~/.config/chromium/Default/Extensions/ngfgcgjklkfnbpandhelhehghbfbebai/

Firefox этим скриптом не настраивается: для него нужна отдельная политика установки расширений.

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

Симптом

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

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

Установлен ли samba-dsdb-modules, присутствует ли ildap.so

AttributeError: 'NoneType' object has no attribute 'text'

В manifest.xml отсутствует <parameters>

Ошибка generate_attribute / None

Элемент <parameters> пуст; в манифесте должен быть непустой текст, например пробел

The object name is not found при поиске DC

DNS и SRV-записи домена, разрешение FQDN контроллера

/etc/resolv.conf снова содержит DNS роутера

Настройки DHCP и перезапуск networking после изменения dhclient.conf

GPO не отображается в RSOP

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

Не создаётся политика Chromium

Каталог /etc/chromium/policies/managed и запуск trigger-browsers.sh

wbinfo -u не находит пользователей

Выполните systemctl restart winbind, проверьте smb.conf и DNS

Пакет не переустанавливается после обновления

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

Дополнительные команды:

samba-gpupdate --rsop -d 3
ls -R /var/cache/samba/gpo_cache/SERVER.LOCAL/POLICIES/{GUID}
systemctl status samba-gpupdate.timer
journalctl -u samba-gpupdate.service -n 50 --no-pager

Замените {GUID} на идентификатор GPO.

11. Результат проверки#

В исходной проверке на Debian 12, Samba 4.17 и домене server.local:

  • RSOP показывал VGP/Unix Settings/Startup Scripts;

  • samba-gpupdate --force устанавливал globalerp-browser-extension 0.19.5.0-1;

  • повторный запуск не переустанавливал пакет;

  • после создания каталога политики Chromium подхватывал расширение без интернета;

  • доменный вход через su - и SSH работал, домашний каталог создавался автоматически.

Результат зависит от версии пакета расширения, настроек домена и содержимого скриптов комплекта.