IVA ДОКУМЕНТАЦИЯ
ОБНОВЛЕНИЯ

Настройка (файл Config.json)

После установки перейдите в каталог приложения и откройте файл Config.json в любом текстовом редакторе (например, Блокнот или Notepad++).

Файл содержит несколько обязательных и опциональных секций в формате JSON.

Опциональные параметры отмечены символом *.

Секция «ActiveDirectory»

Параметры подключения к Active Directory и правила синхронизации объектов.

Параметр Тип Описание

ActiveDirectory.BaseDN

строка

Родительский DN (контейнер) для отслеживания изменений. Можно указать несколько DN через символ | (вертикальная черта) без пробелов.

ActiveDirectory.StartupSync

true/false

При значении true при каждом запуске службы выполняется полная синхронизация всех записей из указанных контейнеров.

ActiveDirectory.User

объект

Настройки синхронизации пользователей.

Объект ActiveDirectory.User

Параметр Тип Описание

NameAttr

строка

Имя атрибута AD, значение которого будет использоваться как имя аккаунта IVA Mail. Может включать доменную часть, например username@domain.name.

StatusAttr

строка

Атрибут статуса синхронизации. Возможные значения:
• enabled — аккаунт активен, синхронизация включена
• disabled — вход в почтовую систему ограничен
• deleted — вход ограничен, имя пользователя IVA Mail получает префикс deleted_

ObjectClass

строка

Класс LDAP, соответствующий записям пользователя (обычно user или inetOrgPerson).

SettingsMap

объект

Словарь сопоставления атрибутов AD и параметров IVA Mail, которые должны синхронизироваться (например, "mail" : "email"). Формат: "атрибут_AD" : "поле_IvaMail".

Объект ActiveDirectory.Group

Параметр Тип Описание

NameAttr

строка

Атрибут AD, значение которого станет именем группы в IVA Mail.

StatusAttr

строка

Атрибут статуса синхронизации группы (аналогично пользователям).

ObjectClass

строка

Класс LDAP для групп (обычно group).

Секция «IvaMail»

Параметры подключения к серверу IVA Mail.

Параметр Тип Описание

IvaMail.Host

строка

IP-адрес или доменное имя сервера IVA Mail. Можно указать несколько адресов через запятую.

IvaMail.Port

число

Порт протокола CMD на сервере IVA Mail (по умолчанию, вероятно, 5000, уточните в документации IVA Mail).

IvaMail.User

строка

Имя администратора IVA Mail.

IvaMail.Pass

строка

Пароль администратора IVA Mail.

IvaMail.Domain

строка

Домен IVA Mail, используемый по умолчанию для создаваемых пользователей.

IvaMail.TLS

true/false

Указывает, использовать ли шифрование SSL/TLS для соединения.

IvaMail.TLSDomain

строка

Домен для SNI (Server Name Indication), если адрес сервера и имя в сертификате различаются.

Секция «Log»

Настройки журналирования работы утилиты.

Параметр Тип Описание

Log.Directory

строка

Путь к каталогу для сохранения логов. По умолчанию: C:\Program Files (x86)\IVAMail\AD-IvaMail-Connector.

Log.Level

число

Уровень детализации: от 1 (минимальный) до 5 (максимальный).

Log.SizeLimit

число

Максимальный размер файла лога в байтах (при превышении выполняется ротация).

Log.RotationPeriod

число

Период ротации логов в днях.

Глобальные настройки

Параметр Тип Описание

CacheSize

число

Размер кэша утилиты (рекомендуется устанавливать значение порядка десятков тысяч для повышения производительности).

Пример файла Config.json

json
{
  "ActiveDirectory": {
    "BaseDN": "OU=Users,DC=contoso,DC=com|OU=Groups,DC=contoso,DC=com",
    "StartupSync": true,
    "User": {
      "NameAttr": "userPrincipalName",
      "StatusAttr": "extensionAttribute1",
      "ObjectClass": "user",
      "SettingsMap": {
        "givenName": "firstName",
        "sn": "lastName",
        "mail": "email"
      }
    },
    "Group": {
      "NameAttr": "cn",
      "StatusAttr": "extensionAttribute2",
      "ObjectClass": "group"
    }
  },
  "IvaMail": {
    "Host": "192.168.1.100",
    "Port": 5000,
    "User": "admin",
    "Pass": "securePassword",
    "Domain": "contoso.com",
    "TLS": true,
    "TLSDomain": "ivamail.contoso.com"
  },
  "Log": {
    "Directory": "C:\\Logs\\AD-Connector",
    "Level": 3,
    "SizeLimit": 10485760,
    "RotationPeriod": 7
  },
  "CacheSize": 50000
}
После редактирования файла убедитесь, что JSON-структура не нарушена (отсутствуют лишние запятые, скобки закрыты). Для проверки можно использовать онлайн-валидаторы.