Установка расширения на 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 от имени администратора домена.
Положите файлы рядом
makegpo.ps1,install-globalerp.shиglobalerp-browser-extension.deb.Измените блок
CONFIGвmakegpo.ps1: имя GPO, DN домена или OU и DNS-имя домена.Запустите:
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. Диагностика#
Симптом |
Что проверить |
|---|---|
|
Установлен ли |
|
В |
Ошибка |
Элемент |
|
DNS и SRV-записи домена, разрешение FQDN контроллера |
|
Настройки DHCP и перезапуск networking после изменения |
GPO не отображается в RSOP |
Привязку GPO к корню домена/OU и расположение компьютера |
Не создаётся политика Chromium |
Каталог |
|
Выполните |
Пакет не переустанавливается после обновления |
Изменились ли хэш в |
Дополнительные команды:
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 работал, домашний каталог создавался автоматически.
Результат зависит от версии пакета расширения, настроек домена и содержимого скриптов комплекта.