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

Группы

Расположение в интерфейсе

Объекты → Домены → <домен> → Объекты домена

Отдельного раздела «Группы» в навигационном меню нет.

Создание группы происходит через карточку домена.

Для перехода в карточку группы нужно нажать на имя группы в списке объектов домена.

Назначение

Группа (группа рассылки) представляет собой объект домена, объединяющий несколько адресатов под одним электронным адресом.

Сообщения, отправленные на адрес группы, доставляются всем участникам группы.

Группы используются для организации коллективных адресов, например:

Группа является самостоятельным объектом домена и отображается в общем списке объектов наряду с аккаунтами, ресурсными аккаунтами и переадресаторами.

Список участников группы может формироваться:

  • вручную — администратор добавляет адреса участников в карточке группы;

  • автоматически — участники запрашиваются из справочника по LDAP-запросу, например из группы безопасности или группы рассылки Active Directory, группы FreeIPA или другой службы каталога (см. Динамический состав группы);

  • одновременно вручную и автоматически.

Группы, участники которых формируются автоматически, принято называть динамическими. В IVA Mail отдельного типа «динамическая группа» нет: любую группу можно настроить на автоматическое формирование состава.

Создание группы

Для создания группы:

  1. Перейдите в раздел Объекты → Домены.

  2. Выберите нужный домен.

  3. В поле создания группы укажите имя группы.

  4. Нажмите Создать группу.

После создания группа появится в списке объектов домена с типом LocalGroup.

Имя группы используется как локальная часть почтового адреса.

Например, для группы с именем support в домене example.ru будет создан адрес support@example.ru.

Настройка группы

Переход в карточку группы осуществляется через блок Объекты домена внутри конкретного домена.

Карточка группы предназначена для управления составом участников группы и её параметрами.

Доступны следующие операции:

  • переименование группы и добавление дополнительных имён;

  • изменение названия и комментария;

  • настройка параметров доставки;

  • настройка динамического состава группы;

  • добавление и удаление участников;

  • экспорт данных;

  • удаление группы.

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

Параметры доставки

Параметры доставки группы
Параметр Описание

Ограничения отправителей в группу

Определяет, от кого группа принимает сообщения (настройка AcceptMailFrom):

  • любой отправитель (anyone) — ограничение отсутствует;

  • пользователи сервера (server) — только от пользователей сервера группы;

  • пользователи домена (domain) — только от пользователей домена группы;

  • члены группы (members) — только от участников группы;

  • доверенные (trusted) — только от адресов из настройки Список доменов и адресов электронной почты, разрешённых для обмена сообщениями (EmailWhitelist). Список заполняется так же, как белый список адресатов аккаунта (используя единый Формат списка).

Указывать группу в качестве отправителя

Добавляет в сообщения, рассылаемые участникам, заголовок Sender с адресом группы или заменяет существующий (настройка GroupIsSender).

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

Разрешает группе принимать автоматически сформированные сообщения (настройка AcceptAutoMail).

Направлять ответы в группу

Добавляет в сообщения, рассылаемые участникам, заголовок Reply-To с адресом группы (или заменяет существующий). Ответы участников будут направляться в группу (настройка ReplyToGroup).

Публичная группа

Разрешает участникам группы просматривать список участников (настройка Public).
Включайте параметр Принимать автоматические письма с осторожностью: автоответы и уведомления о доставке могут привести к бесконечному циклу приёма и отправки сообщений.

Владелец группы

Владелец группы — пользователь, который отвечает за группу и может настраивать её состав и параметры.

Владелец назначается только через CLI командой GroupSetOwner или настройкой Owner:

GroupSetOwner "example.ru" "sales" "manager@example.ru"

В панели администратора назначение владельца пока не реализовано.

Отчёты о недоставке

От параметров группы зависит, кому приходят отчёты о недоставке (NDR) сообщений участникам:

  • если группа публичная — отчёт получает отправитель;

  • если группа непубличная и задан владелец — отчёт получает владелец группы;

  • если группа непубличная и владелец не задан — отчёт не отправляется.

Переименование группы

Для изменения имени группы:

  1. Откройте карточку группы.

  2. Введите новое имя в поле переименования.

  3. Нажмите Переименовать группу.

После переименования адрес группы изменится на новый.

Добавление участника группы

Для добавления участника:

  1. Откройте карточку группы.

  2. Введите имя аккаунта в поле добавления участника.

  3. Нажмите Добавить участника.

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

Удаление участника

Для удаления участника:

  1. Откройте карточку группы.

  2. Выберите участника в списке.

  3. Нажмите Удалить участника.

После удаления аккаунт перестанет получать сообщения группы.

Динамический состав группы

Принцип работы

Список участников группы может формироваться автоматически по LDAP-запросу к справочнику IVA Mail. Запрос хранится в настройках группы и выполняется сервером при получении списка участников.

Так можно создавать группы рассылки на основе групп службы каталога (групп безопасности, групп рассылки и других групп) с настраиваемой синхронизацией данных о членстве пользователей в этих группах.

Особенности:

  • участники, полученные по запросу, отображаются в карточке группы вместе с участниками, добавленными вручную, и визуально от них не отличаются;

  • если в группе есть участники, добавленные вручную, итоговый список объединяет оба набора; повторяющиеся адреса не дублируются;

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

Для удобства администрирования не рекомендуется совмещать в одной группе ручной и автоматический состав.

Поддерживаемые источники данных

Источником участников может быть:

  • внутренний справочник IVA Mail — аккаунты доменов сервера;

  • внешний LDAP-сервер, подключённый к справочнику IVA Mail как том, например Active Directory, FreeIPA, OpenLDAP или другая служба каталога.

Требования к внешнему LDAP-серверу:

  • поддержка протокола LDAP;

  • аутентификация типа simple (другие типы аутентификации не поддерживаются);

  • наличие в записях атрибута с адресом электронной почты (например, mail).

Подключение внешнего LDAP-сервера описано в разделе Модуль Справочник.

Синхронизация состава

Результат LDAP-запроса кэшируется. В течение времени, заданного параметром Время кэширования динамических членов (настройка DynamicMembersCacheTime), сервер использует сохранённый результат и не выполняет запрос повторно. По истечении этого времени состав группы обновляется из справочника.

Рекомендуется устанавливать Время кэширования динамических членов равным 0 мин. — в этом случае состав группы запрашивается из справочника при каждом обращении и всегда соответствует данным службы каталога.

Формат LDAP-запроса

Запрос задаётся в настройке группы DynamicMembersUri в формате:

directory://?base_dn=<base_dn>&scope=<scope>&field=<field>&filter=<filter>
Параметр Описание

base_dn

DN узла справочника, с которого начинается поиск. Строка $domaindn заменяется на DN домена группы.

scope

Область поиска:

  • base — только запись с указанным DN;

  • one — непосредственные дочерние записи указанного DN;

  • sub — все дочерние записи указанного DN.

field

Атрибут, значение которого возвращает запрос. Для формирования списка участников атрибут должен содержать адрес электронной почты, например mail.

filter

LDAP-фильтр, применяемый к записям справочника, в формате (<атрибут>=<значение>).

В значении можно использовать подстановочные знаки: * — любое количество любых символов, ? — один любой символ.

Для объединения условий используются:

  • (&(…​)(…​)) — логическое И (выполняются все условия);

  • (|(…​)(…​)) — логическое ИЛИ (выполняется хотя бы одно условие).

Например, запрос

directory://?base_dn=uid=1&scope=sub&field=mail&filter=(mail=user*)

для домена с DN uid=1 возвращает значения атрибута mail всех дочерних записей DN uid=1, у которых адрес начинается с user.

Поиск выполняется только в поддереве справочника, относящемся к домену группы.

Чтобы получать участников из другого домена или из внешней службы каталога, подключите соответствующий том справочника с точкой монтирования внутри поддерева домена группы (см. Пример: группа по членству в группе Active Directory).

Атрибуты аккаунтов во внутреннем справочнике

При формировании записей внутреннего справочника сервер сопоставляет настройки аккаунтов IVA Mail с атрибутами LDAP. Эти атрибуты можно использовать в фильтре запроса.

Данные аккаунта IVA Mail Атрибут LDAP

Идентификатор (UID) объекта

uid

Имя объекта

cn (commonName)

Настройка RealName

sn (surname), middlename, gn (givenName)

Настройка Department

ou (organizationalUnitName)

Настройка Position

title

Настройка TelephoneNumber

telephonenumber

Основной адрес электронной почты

mail

Настройка динамического состава

В панели администратора:

  1. Откройте карточку группы.

  2. В блоке Динамические члены группы введите LDAP-запрос и нажмите Фильтр.

  3. Выберите Время кэширования динамических членов и нажмите Модифицировать.

  4. Проверьте список участников группы и значение поля Последняя загрузка динамической группы.

Через CLI — командой ObjectSetSetting:

ObjectSetSetting "example.ru" "sales" "DynamicMembersUri" "directory://?base_dn=$domaindn&scope=sub&field=mail&filter=(ou=Sales)"

Пример: группа по подразделению

Группа содержит всех пользователей домена, у которых в карточке аккаунта указано подразделение Department2.

LDAP-запрос:

directory://?base_dn=$domaindn&scope=sub&field=mail&filter=(ou=Department2)

Поиск выполняется во всём поддереве домена группы, запрос возвращает значение атрибута mail записей, у которых подразделение — Department2.

Группа с участниками по подразделению

Та же настройка через CLI:

ObjectSetSetting "ivamail.local" "group4" "DynamicMembersUri" "directory://?base_dn=$domaindn&scope=sub&field=mail&filter=(ou=Department2)"

Пример: группа по членству в группе Active Directory

Группа содержит пользователей, которые входят в группу Group1 Active Directory. Тип группы AD (группа безопасности или группа рассылки) значения не имеет.

Так же настраиваются группы на основе групп FreeIPA и других LDAP-совместимых служб каталога: меняются только адрес сервера, DN и фильтр.

Шаг 1. Подключите LDAP-сервер к справочнику IVA Mail.

  1. Перейдите в раздел Модули → Справочник и добавьте том типа ldap.

  2. Заполните параметры тома:

    Параметр Значение в примере

    Том

    Точка монтирования тома в справочнике IVA Mail. Должна находиться внутри поддерева домена группы.

    Например, ou=exchangetestou,uid=2 — том будет подключён как ou=exchangetestou в домене с DN uid=2.

    Локальный IP-адрес

    Адрес и порт LDAP-сервера (в примере — контроллера домена AD): [192.168.0.181]:389.

    Аккаунт

    Учётная запись для подключения к LDAP-серверу, например iva\administrator.

    Тип аутентификации

    simple.

    Пароль

    Пароль учётной записи.

    Поддерево DN на сервере

    DN поддерева на LDAP-сервере, в котором находятся записи пользователей, например ou=iva-lab-users,dc=iva,dc=lab.

  3. Нажмите Модифицировать.

    Том справочника типа ldap

Шаг 2. Настройте LDAP-запрос группы.

В домене с DN uid=2 откройте карточку группы и задайте запрос:

directory://?base_dn=ou=exchangetestou,uid=2&scope=sub&field=mail&filter=(memberOf=CN=Group1,OU=IVA-lab-users,DC=iva,DC=lab)
Группа с участниками из группы Active Directory

Или через CLI:

ObjectSetSetting 2 4 "DynamicMembersUri" "directory://?base_dn=ou=exchangetestou,uid=2&scope=sub&field=mail&filter=(memberOf=CN=Group1,OU=IVA-lab-users,DC=iva,DC=lab)"

Поиск выполняется только в поддереве подключённого тома (ou=exchangetestou,uid=2), чтобы не создавать лишнюю нагрузку. Фильтр memberOf возвращает записи пользователей, входящих в группу CN=Group1,OU=IVA-lab-users,DC=iva,DC=lab, запрос возвращает их адреса из атрибута mail. В карточке группы участники отображаются с адресами домена службы каталога.

Фильтр memberOf возвращает только непосредственных участников группы AD. Участники вложенных групп в результат не попадают.

Экспорт данных

Кнопка Экспорт данных позволяет выгрузить информацию о группе и её участников для последующей обработки и архивирования.

Удаление группы

Для удаления группы:

  1. Откройте карточку группы.

  2. Нажмите Удалить группу.

  3. Подтвердите удаление.

После удаления адрес группы перестанет существовать.

Удаление группы не приводит к удалению входящих в неё аккаунтов.

Сценарии использования

Общий адрес подразделения:

  1. Создаётся группа: sales@example.ru.

  2. В качестве участников добавляются сотрудники отдела продаж — вручную или автоматически по подразделению (см. Пример: группа по подразделению).

  3. Все сообщения, отправленные на адрес группы, доставляются каждому сотруднику отдела.

Адрес службы поддержки:

  1. Создаётся группа: support@example.ru.

  2. В группу включаются сотрудники технической поддержки.

  3. Клиенты используют единый адрес независимо от состава команды.

  4. Все сообщения, отправленные на адрес группы, доставляются каждому сотруднику технической поддержки.

Рассылка по группе службы каталога:

  1. К справочнику IVA Mail подключается LDAP-сервер организации (Active Directory, FreeIPA и т. п.).

  2. Создаётся группа, например all-staff@example.ru, с LDAP-запросом по членству в группе службы каталога (см. Пример: группа по членству в группе Active Directory).

  3. При изменении состава группы в службе каталога состав группы IVA Mail обновляется автоматически.

CLI

Для управления группами используются команды:

Команда Назначение

GroupCreate

Создание группы.

GroupListMembers

Получение списка участников группы.

GroupAddAccount

Добавление участника.

GroupDelAccount

Удаление участника.

GroupHasAccount

Проверка наличия участника в группе.

GroupGetOwner

Получение владельца группы.

GroupSetOwner

Назначение владельца группы.

ObjectSetSetting

Изменение настроек группы, в том числе DynamicMembersUri, DynamicMembersCacheTime, AcceptMailFrom, Public.

Подробнее в разделе Справочник команд CLI.