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

## 1. Требования

- Контроллер домена Windows Server с RSAT и модулем PowerShell `GroupPolicy` либо подготовленная среда для создания GPO.
- Ubuntu-клиент, введённый в домен Active Directory.
- На клиенте настроены DNS и машинная аутентификация Samba.
- Пакет [скриптов](https://cloud.g-sys.ru/s/k7aS87FkeQaeijY) 
- Администраторские права для настройки GPO и Ubuntu.

Для применения политик на Ubuntu используется `samba-gpupdate` и расширение Samba `VGP/Unix Settings/Startup Scripts`.

**Важно:** подготовка Ubuntu выполняется отдельно. Доставить клиент GPO на неподготовленную машину с помощью этой же GPO нельзя.

## 2. Подготовка файлов

Подготовьте [комплект](https://cloud.g-sys.ru/s/k7aS87FkeQaeijY):

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

```powershell
$GpoName   = 'GlobalERP_BrowserExtension'
$DomainDN  = 'DC=server,DC=local'
$SysvolDom = 'server.local'
```

Укажите собственное имя домена и DN домена или OU, в котором находятся компьютеры Ubuntu.

### 3.2. Создание политики

Запустите PowerShell от имени администратора в каталоге с комплектом:

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

Проверьте, что в каталоге политики появились файлы:

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

```bash
sudo apt-get update
sudo apt-get install -y python3-samba samba-common-bin samba-dsdb-modules
```

Проверьте наличие утилиты и LDAP-модуля:

```bash
command -v samba-gpupdate
ls -l /usr/lib/x86_64-linux-gnu/samba/ldb/ildap.so
```

Если путь к `ildap.so` отличается, найдите файл в установленных пакетах Samba.

### 4.2. Проверка домена

```bash
sudo net ads testjoin -P
```

Ожидаемый результат:

```text
Join is OK
```

Также проверьте DNS:

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

Запустите:

```bash
sudo sh ./files/client-setup.sh
```

Скрипт должен настроить DNS и создать `samba-gpupdate.service` и `samba-gpupdate.timer`.

Проверьте таймер:

```bash
sudo systemctl status samba-gpupdate.timer
sudo systemctl list-timers samba-gpupdate.timer
```

## 5. Применение политики

Запустите применение машинных политик вручную:

```bash
sudo samba-gpupdate --target=Computer
```

Проверьте результирующий набор политик:

```bash
sudo samba-gpupdate --rsop
```

В выводе должна присутствовать политика `VGP/Unix Settings/Startup Scripts` с путём к `install-globalerp.sh`.

Если скрипт отображается в RSOP, но пакет не устанавливается, проверьте наличие скрипта и `.deb` в локальном кэше Samba, а также журнал установки.

## 6. Проверка установки

Проверьте журнал:

```bash
sudo cat /var/log/globalerp-gpo-install.log
```

Проверьте пакет:

```bash
dpkg -l | grep globalerp
```

Проверьте файлы расширения:

```bash
sudo ls -l /opt/global-erp/browser-extension/
```

Ожидается установленный пакет `globalerp-browser-extension` и файлы:

```text
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 либо выполните вручную:

```bash
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://`-источника |

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

```bash
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`. Согласно исходной конфигурации, расширение устанавливается из локальных файлов:

```text
/opt/global-erp/browser-extension/
├── globalerp-extension.crx
├── globalerp-extension.json
└── update.xml
```

Пример локального источника в политике:

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

В `update.xml` указывается локальный путь к `.crx`. Если браузер и его политика поддерживают такую схему установки, доступ к интернету для получения расширения не требуется.
