# Интеграция с ALD Pro

## Цель

Настройка интеграции Printum с контроллером домена ALD Pro для синхронизации учётных записей пользователей, импорта оргструктуры и групп безопасности.

---

## Предусловия

- Развёрнутый и доступный сервер ALD Pro
- Учётная запись в домене с правами на чтение доменной структуры
- Настроена интеграция с почтовым сервером (SMTP)
- Printum запущен и доступен

---

## Шаги настройки

### Шаг 1. Добавление домена в Printum

Перейдите в раздел **Настройки → Интеграции → Домены** и нажмите кнопку **«Добавить»**.

Заполните поля:

- **Название** — любое удобное название для домена.
- **Тип** — выберите `ALD Pro`.
- **Адрес** — протокол, хост и порт домена (например, `ldap://aldpro.example.com:389`).
- **Логин и пароль в домене** — учётная запись с правами на чтение доменной структуры.
- **Фильтр** — фильтр поиска сотрудников. Если оставить значение по умолчанию `(&(objectCategory=person)(objectClass=user))`, будут импортированы объекты классов Person и User.
- **Стартовый уровень поиска** — уровень в домене для начала импорта (обычно самый верхний).
- **Атрибут для объединения учётных записей** — позволяет объединить несколько УЗ одного пользователя из разных доменов.
- **Выгружать оргструктуру** — включить для импорта иерархии. **Важно:** в ALD Pro нет разделения между группами и отделами, поэтому все отделы будут импортированы как группы.
- **Выгружать группы** — включить для выгрузки групп безопасности.
- **Требуется шифрование** — включить, если домен принимает только шифрованные запросы.

### Шаг 2. Тестовый импорт

Нажмите кнопку **«Тестовый импорт»**. При успешном подключении будет отображено количество отделов, сотрудников и групп. При ошибке — описание проблемы.

### Шаг 3. Сопоставление атрибутов

В разделе **«Атрибуты»** карточки домена настройте сопоставление атрибутов ALD Pro с атрибутами Printum:

|Атрибут в Printum|Атрибут в домене|Описание|
|:---|:---|:---|
|`username`|`uid`|Логин|
|`unique_id`|`uidNumber`|Идентификатор в домене|
|`last_name`|`sn`|Фамилия|
|`first_name`|`givenName`|Имя|
|`patronymic`|`rbtamiddlename`|Отчество|
|`email`|`mail`|Адрес электронной почты|
|`domain_groups`|`memberOf`|Доменные группы|
|`position`|`title`|Должность|
|`smb_path`|`homeDirectory`|Путь к папке|

Обязательные атрибуты: Логин, Фамилия, Имя, Идентификатор в домене, Адрес электронной почты.

### Шаг 4. Сохранение и расписание синхронизации

Нажмите **«Сохранить»**. В разделе **«Расписание»** настройте автоматическую синхронизацию (расписание общее для всех доменов). Либо нажмите **«Запустить сейчас»** для ручного запуска синхронизации.

---

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

После успешной настройки пользователи из ALD Pro синхронизируются в Printum. Поскольку в ALD Pro нет разделения между группами и отделами, все отделы импортируются как группы безопасности.

---

## Как проверить

- Тестовый импорт показывает количество отделов, сотрудников и групп без ошибок.
- Пользователи из ALD Pro отображаются в разделе «Пользователи» системы Printum.

---

## Связанные страницы

- [Интеграция с FreeIPA](http://wiki.printum.io/books/4-integracii/page/integraciia-s-freeipa)
- [Интеграция с Samba DC и РЕД АДМ](http://wiki.printum.io/books/4-integracii/page/integraciia-s-samba-dc-i-red-adm)
- [Интеграция с Active Directory](https://wiki.printum.io/books/4-integracii/page/integraciia-s-active-directory)

---

**Справочник атрибутов:** [Атрибуты доменов — справочник](https://wiki.printum.io/books/8-spravocnik/page/atributy-domenov-spravocnik) — сравнительная таблица по всем контроллерам домена.