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

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

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

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

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

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

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

```sh
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. Положите [файлы](https://cloud.g-sys.ru/s/k7aS87FkeQaeijY) рядом `makegpo.ps1`, `install-globalerp.sh` и `globalerp-browser-extension.deb`.
2. Измените блок `CONFIG` в `makegpo.ps1`: имя GPO, DN домена или OU и DNS-имя домена.
3. Запустите:

```powershell
powershell -ExecutionPolicy Bypass -File .\makegpo.ps1
```

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

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

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

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

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

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

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

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

```sh
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`.

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

```sh
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`:

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

### 4.2. Kerberos

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

```sh
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`:

```sh
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 контроллера домена:

```sh
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 и разрешение имён:

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

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

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

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

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

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

```sh
net ads testjoin -P
systemctl restart winbind
```

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

```text
Join is OK
```

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

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

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

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

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

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

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

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

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

или:

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

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

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

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

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

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

```sh
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
```

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

```sh
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
```

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

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

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

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

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

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

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

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

```sh
samba-gpupdate --force
```

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

```sh
samba-gpupdate
```

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

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

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

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

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

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

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

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

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

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

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

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

```sh
mkdir -p /etc/chromium/policies/managed
```

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

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

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

```sh
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`                                |

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

```sh
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 работал, домашний каталог создавался автоматически.

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