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, значение которого будет использоваться как имя учётной записи IvaMail. Может включать доменную часть, например username@domain.name.

StatusAttr

строка

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

ObjectClass

строка

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

SettingsMap

объект

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

Объект ActiveDirectory.Group

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

NameAttr

строка

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

StatusAttr

строка

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

ObjectClass

строка

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

Секция «IvaMail»

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

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

IvaMail.Host

строка

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

IvaMail.Port

число

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

IvaMail.User

строка

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

IvaMail.Pass

строка

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

IvaMail.Domain

строка

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

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-структура не нарушена (отсутствуют лишние запятые, скобки закрыты). Для проверки можно использовать онлайн-валидаторы.