Skip to content

Режим непривилегированного пользователя ​

В системах Linux с systemd Сервер CommuniGate Pro может запускаться от системного пользователя cgatepro с основной группой mail. Необходимые для работы привилегированные операции разрешаются через Linux capabilities, заданные в файле службы CommuniGate-nonroot.service.

Новая установка по умолчанию использует режим непривилегированного пользователя. Обновление сохраняет существующую службу и её настройки Администратора. Установщик не изменяет права существующих данных. Переключение режима выполняется Администратором отдельно.

systemd назначает пользователя и capabilities до запуска Сервера. При работе от root или с capabilities сверх CAP_NET_BIND_SERVICE на странице Общее Веб Интерфейса Администратора отображается предупреждение и записывается в Журнал Сервера.

Выбор при установке пакета ​

При новой установке Сервер по умолчанию запускается от cgatepro:mail через CommuniGate-nonroot.service. Установщик создаёт отсутствующего пользователя cgatepro. Группа mail должна существовать.

Установка DEB и RPM не запрашивает выбор режима. Для явного выбора службы используется CGP_INSTALL_SERVICE. Например, для новой установки от root:

sh
sudo env CGP_INSTALL_SERVICE=CommuniGate.service dpkg -i ./CGatePro-Linux.deb
sudo env CGP_INSTALL_SERVICE=CommuniGate.service rpm -Uvh ./CGatePro-Linux.rpm

Замените имя пакета на фактическое. Значение CommuniGate-nonroot.service явно выбирает режим непривилегированного пользователя. При новой установке выбранная служба включается в автозапуск и запускается. При обновлении этот параметр указывает существующую службу и не переключает режим. Для смены режима используйте порядок перехода.

Обновление существующей установки ​

Обновление сохраняет существующую службу, её локальные настройки и права данных. Пользователь не создаётся, рекурсивная смена владельцев не выполняется. Исключение - подготовка Манифеста. Отсутствующий Манифест создаётся автоматически. Содержимое существующего обычного файла сохраняется. Обработка ссылок и неподходящих прав описана в разделе о Манифесте.

Служба определяется по работающей службе, затем по включённому автозапуску и сохранённому выбору. Для старой установки без этих сведений сохраняется CommuniGate.service. Настройки пользователя этой службы также сохраняются.

Автозапуск и маскирование существующей службы сохраняются. Порядок запуска при обновлении зависит от типа пакета:

  • DEB. Перед остановкой сохраняется состояние службы. Работавшая служба перезапускается, остановленная остаётся остановленной. При обновлении старого пакета, который не сохраняет это состояние, или при ошибке его сохранения прежняя активность неизвестна. Тогда служба запускается только при включённом автозапуске, а Установщик выводит предупреждение.
  • RPM. Работающая служба определяется во время установки новой версии и перезапускается после успешной подготовки Манифеста. Остановленная служба остаётся остановленной, даже если у неё включён автозапуск.

Повторная установка с сохранёнными данными или настройками не считается новой. Если прежняя служба не определена, то Установщик сообщает об этом и пропускает её автоматическую настройку. Укажите существующую службу и повторите установку, например:

sh
sudo env CGP_INSTALL_SERVICE=CommuniGate.service dpkg -i ./CGatePro-Linux.deb
sudo env CGP_INSTALL_SERVICE=CommuniGate.service rpm -Uvh --replacepkgs ./CGatePro-Linux.rpm

Параметр RPM --replacepkgs позволяет повторно установить уже установленную версию пакета. Если Установщик сообщает о конфликтующем состоянии служб, сначала устраните конфликт. CGP_INSTALL_SERVICE не отменяет эту проверку.

Допустимы CommuniGate.service, CommuniGate-nonroot.service и external. Значение external используйте при самостоятельном управлении запуском. Оно сохраняется в /etc/CommuniGate/service-unit, и Установщик не включает и не запускает пакетные службы. Параметр не переключает уже обнаруженную службу на другую.

Определение директории данных ​

Установщик и утилита manifest определяют директорию данных по параметрам работающего Сервера или настройкам службы. Если путь не указан, используется существующая /var/CommuniGate. При новой установке эта директория создаётся при необходимости.

Для нестандартной конфигурации задайте абсолютный путь через CGP_BASE_DIR. Он имеет приоритет над автоматическим определением:

sh
sudo env CGP_BASE_DIR=/srv/CommuniGate dpkg -i ./CGatePro-Linux.deb
sudo env CGP_BASE_DIR=/srv/CommuniGate rpm -Uvh ./CGatePro-Linux.rpm
sudo env CGP_BASE_DIR=/srv/CommuniGate /opt/CommuniGate/manifest

CGP_BASE_DIR не меняет параметры запуска Сервера. Путь должен соответствовать --Base или --CGateBase в настройках службы. При обновлении директория должна существовать и быть доступна, включая подключение хранилища.

Ошибки подготовки и запуска службы ​

Если не удалось определить службу, найти директорию данных или подготовить Манифест, Установщик выводит причину в консоль. Установка исполняемых файлов продолжается, автоматическая настройка или запуск службы пропускаются.

Устраните указанную причину, при необходимости повторите подготовку Манифеста и запустите выбранную службу. Проверьте состояние и Журнал:

sh
systemctl status CommuniGate-nonroot.service
journalctl -u CommuniGate-nonroot.service -b

Для существующей установки используйте имя её службы. Успешная установка пакета сама по себе не означает, что Сервер запущен.

Подготовка ​

Команды подготовки и переключения режима ниже выполняются от суперпользователя. В примерах используются стандартные пути: /opt/CommuniGate для директории программ и /var/CommuniGate для директории данных. Если на вашей системе выбраны другие пути, замените их в командах.

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

    sh
    getent passwd cgatepro
    id cgatepro

    При переходе с root создайте пользователя, если он отсутствует. Если учётная запись была удалена из существующей установки, восстановите её с прежним UID.

    sh
    useradd --system --gid mail --home-dir /var/CommuniGate --no-create-home --shell /usr/sbin/nologin cgatepro

    При другой директории данных измените --home-dir и проверьте путь к nologin в своей системе (например, /sbin/nologin). Существующую учётную запись проверьте, а не создавайте повторно. Отдельная группа cgatepro не требуется.

  • Проверьте параметры обеих служб:

    sh
    systemctl cat CommuniGate.service CommuniGate-nonroot.service

    Перенесите необходимые параметры запуска и ограничения ресурсов в настройки новой службы с помощью systemctl edit CommuniGate-nonroot.service. Дополнения к CommuniGate.service не применяются к другой службе автоматически. Сохраните значения User=cgatepro, Group=mail и настройки capabilities новой службы. Для системных портов в поставляемой службе уже указан параметр --UseSystemPorts YES.

    Директория данных определяется параметром --Base или --CGateBase в SUPPLPARAMS. Параметр systemd WorkingDirectory не заменяет эти параметры запуска. Удалите --dropRoot из параметров обеих служб: запуск с этой удалённой опцией завершается ошибкой.

    Обе службы по умолчанию читают переменные из /var/CommuniGate/Startup.sh. При переносе этого файла измените EnvironmentFile в настройках обеих служб. При использовании Environment=SUPPLPARAMS вместо файла сбросьте EnvironmentFile, как показано в разделе Настройки среды запуска. Файл Startup.sh читается как набор переменных окружения, а не исполняется как сценарий командной оболочки.

  • Если используются внешние INBOX, настройте доступ к ним перед запуском службы режима непривилегированного пользователя.

  • Проверьте требования установленных Помощников к capabilities. Дополнительные права задаются в настройках службы.

  • Для общего хранилища Кластера согласуйте числовые UID пользователя cgatepro и GID группы mail на всех узлах. Одинаковые имена не гарантируют одинаковых идентификаторов.

Общее хранилище и NFS ​

Перед переходом настройте службу через systemctl edit, чтобы она ожидала подключения хранилища, например:

ini
[Unit]
RequiresMountsFor=/var/CommuniGate

Укажите фактический путь к хранилищу. Числовые UID/GID и доступ к файлам должны быть согласованы на всех узлах и сервере хранилища. Если NFS root squash не позволяет назначить Манифесту root:mail, подготовьте файл на сервере хранилища. Установщик не отключает root squash. Проверьте доступность монтирования перед запуском Сервера. Установка пакета сама по себе не гарантирует, что том данных подключён.

Переход на режим непривилегированного пользователя ​

Остановите обе службы и остальные процессы, изменяющие директорию данных. При общем хранилище остановите все обращающиеся к нему узлы Кластера:

sh
systemctl stop CommuniGate.service CommuniGate-nonroot.service

Перед обработкой сценарий проверяет отсутствие локальных процессов с именем CGServer. Проверить остановку Помощников и других узлов Кластера он не может.

Подготовьте Манифест до смены владельца данных. Проверьте настройки Помощников, Правил Выполнить, CGI-программ и т.д. Если Манифест отсутствует, создайте его из проверенных настроек от root:

sh
CGP_BASE_DIR=/var/CommuniGate /opt/CommuniGate/manifest

Проверьте полученный список. Существующий файл с другим владельцем или правом записи для группы либо остальных пользователей отклоняется утилитой без изменений. После остановки всех изменяющих данные процессов проверьте такой файл и явно подготовьте его как root:mail, 0640 по инструкции. Любая служба требует корректного Манифеста независимо от UID процесса.

Назначьте владельца и права на директорию данных:

sh
bash /opt/CommuniGate/nonroot.sh

Сценарий nonroot.sh назначает каталогам права 2770, не меняет права чтения, записи и исполнения обычных файлов, а Манифест обрабатывает отдельно (root:mail, 0640), исключая его из общего изменения владельца и прав. Установка пакета не выполняет эту обработку существующих данных. Согласуйте GID группы mail на всех узлах до перехода.

По умолчанию обрабатывается /var/CommuniGate. Для другой директории укажите --base /path/to/base. Владелец по умолчанию - cgatepro:mail. Параметр --mode root выбирает root:mail.

Переключите службы:

sh
systemctl disable CommuniGate.service
systemctl mask CommuniGate.service
systemctl unmask CommuniGate-nonroot.service
systemctl daemon-reload
systemctl enable --now CommuniGate-nonroot.service

После успешного запуска сохраните выбор службы от root:

sh
install -d -m 0755 -o root -g root /etc/CommuniGate
install -m 0600 -o root -g root /dev/null /etc/CommuniGate/service-unit
printf '%s\n' 'CommuniGate-nonroot.service' > /etc/CommuniGate/service-unit

Подождите 10-15 секунд и проверьте запуск:

sh
systemctl status CommuniGate-nonroot.service
journalctl -u CommuniGate-nonroot.service -n 100 --no-pager
pid=$(systemctl show CommuniGate-nonroot.service -p MainPID --value)
grep -E '^(Uid|Gid|Groups|Cap)' /proc/"$pid"/status
ss -ltnp 'sport = :25'

Все значения строки Uid должны соответствовать cgatepro, строки Gid - группе mail. Проверьте Приёмники, доступ к данным и Помощники. Для новой установки также требуется Первоначальная настройка, включая пароль postmaster.

Владельцы файлов ​

nonroot.sh назначает всей директории данных владельца cgatepro:mail. Параметр --mode root выбирает root:mail. Директории получают права 2770. Права чтения, записи и исполнения обычных файлов сохраняются, но смена владельца может снять с исполняемых файлов биты setuid/setgid. Для директорий setgid устанавливается после смены владельца. Обрабатываются также вложенные примонтированные файловые системы. Смена владельца файла с жёсткими ссылками затрагивает все его имена, в том числе вне директории данных.

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

Чтобы обработать также цели ссылок, добавьте --follow-symlinks:

sh
bash /opt/CommuniGate/nonroot.sh --follow-symlinks

С этим параметром сценарий меняет владельца файлов, на которые указывают ссылки, и обходит целевые каталоги, включая расположенные вне директории данных. Каталоги в этих деревьях также получают права 2770. Перед запуском проверьте цели ссылок и остановите процессы, изменяющие эти данные. Параметр можно сочетать с --base и --mode root.

Исключением является Settings/ChildProcs.data. Он должен оставаться обычным файлом root:mail с правами 0640, без дополнительных жёстких ссылок. Settings не должна быть символической ссылкой. Параметр --follow-symlinks не отменяет эти требования. Манифест исключается из общей смены владельца и прав также при обращении через другую символическую ссылку. Сценарий не создаёт отсутствующий Манифест. Подготовьте его утилитой manifest до смены владельцев.

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

Доступ к внешнему INBOX ​

Эта настройка нужна только для Внешних Папок, расположенных вне директории данных. В Домене задаётся шаблон пути (например, /var/mail/*), а использование внешнего INBOX включается для отдельных Пользователей. Серверу требуется доступ и для чтения, и для записи.

Перед изменением прав остановите Сервер и локальные почтовые программы, использующие эти файлы. Следующие команды выполняются от root. В примере файл /var/mail/ivan уже существует и принадлежит пользователю ОС ivan; замените имя на нужное:

sh
chown root:mail /var/mail
chmod 2775 /var/mail
chgrp mail /var/mail/ivan
chmod 0660 /var/mail/ivan

Директория разрешает группе mail создавать файлы, а бит setgid обеспечивает наследование этой группы новыми файлами. Остальным пользователям сохраняется проход через директорию, чтобы локальные почтовые программы могли обращаться к их ящикам. Владельцем файла остаётся ivan. И он, и группа mail могут читать и изменять файл. Повторите последние две команды для каждого внешнего INBOX, используемого Сервером. Участники mail получают доступ к этим ящикам и право записи в общую директорию. Включайте в группу только доверенные учётные записи.

Проверьте доступ от пользователя службы:

sh
runuser -u cgatepro -g mail -- sh -ec '
  test -x /var/mail
  test -w /var/mail
  test -r /var/mail/ivan
  test -w /var/mail/ivan
  echo "External INBOX access OK"
'

Если ящики расположены в другом месте, измените пути и обеспечьте право прохода через все родительские директории. Программы локальной доставки и почтовые программы должны сохранять группу mail и права группы на чтение и запись при создании или замене файлов ящиков. Setgid директории обеспечивает наследование группы, но не добавляет права чтения и записи файлу, созданному с режимом 0600. CAP_CHOWN по умолчанию не включена. Существующие ящики с настроенным доступом доступны Серверу без неё. Если внешний INBOX отсутствует, Сервер пытается создать файл и назначить владельцем соответствующего пользователя ОС. Без CAP_CHOWN смена владельца на другой UID завершается ошибкой, созданный файл удаляется и операция создания INBOX не выполняется. Заранее создайте файл от имени нужного пользователя и настройте доступ через группу mail либо добавьте CAP_CHOWN в обе настройки службы, как описано ниже. Одних прав на директорию /var/mail для смены владельца недостаточно.

Сценарий nonroot.sh не выполняет описанную настройку доступа к внешнему INBOX. По умолчанию он обрабатывает только директорию данных. С параметром --follow-symlinks он также изменяет владельцев и права каталогов по ссылкам из неё, поэтому перед запуском проверьте, не ведут ли они в /var/mail или к файлам внешних INBOX. После настройки запустите Сервер и проверьте доставку и доступ к внешнему INBOX.

Capabilities и Помощники ​

Поставляемая служба задаёт следующие capabilities в AmbientCapabilities и CapabilityBoundingSet:

CapabilityНазначение
CAP_NET_BIND_SERVICEРабота Приёмников на портах ниже 1024

Следующие capabilities в поставляемой службе не включены. Добавляйте их только для используемых функций:

CapabilityКогда требуется
CAP_SETUIDЗапуск дочерних программ от другого пользователя ОС, в том числе действием Правила Выполнить (Execute) с заданным OSUserName
CAP_SETGIDНазначение основной и дополнительных групп дочерних процессов
CAP_KILLОстановка дочерних процессов с другим UID
CAP_CHOWNСоздание отсутствующих внешних Unix-INBOX с назначением владельцем соответствующего пользователя ОС
CAP_NET_ADMINУправление IPVS и сетевыми настройками через IPVSHelper
CAP_NET_RAWВызов arping и операции RAW/PACKET-сокетов из IPVSHelper

Для запуска от другого пользователя ОС нужны обе capabilities: CAP_SETUID меняет UID, а CAP_SETGID назначает основную и дополнительные группы. Без любой из них запуск завершится ошибкой. Для остановки таких дочерних процессов добавьте также CAP_KILL. Дочерние процессы, работающие с тем же UID, что и Сервер, можно останавливать без CAP_KILL. Для настройки запуска и остановки программ от другого пользователя выполните systemctl edit CommuniGate-nonroot.service и добавьте:

ini
[Service]
AmbientCapabilities=CAP_SETUID CAP_SETGID CAP_KILL
CapabilityBoundingSet=CAP_SETUID CAP_SETGID CAP_KILL

При обычном запуске дочерняя программа наследует группы Сервера. CAP_SETGID для этого не требуется. Группа mail назначается службой systemd. Если OSUserName задан явно, Сервер заново устанавливает группы даже для своего пользователя cgatepro, поэтому в этом случае CAP_SETGID необходима.

Для автоматического создания внешних INBOX аналогично добавьте CAP_CHOWN в обе строки. Для IPVSHelper добавьте:

ini
[Service]
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_RAW
CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_RAW

CAP_NET_RAW не требуется штатным TCP/UDP Приёмникам Сервера. Дополнительные Помощники могут иметь собственные требования к capabilities.

Помощники, CGI, программы, запущенные действием Правила Выполнить (Execute), и прочие дочерние процессы наследуют capabilities Сервера при обычном запуске. Они сохраняются и при назначении другого пользователя ОС. В режиме непривилегированного пользователя запуск от другого пользователя с целевым UID 0 запрещён. Сервер возвращает ошибку до создания дочернего процесса. Для запуска от root используйте CommuniGate.service. Прежнее поведение этой службы сохраняется.

Если Помощнику нужны дополнительные права, добавьте их в обе настройки через systemctl edit CommuniGate-nonroot.service. Например:

ini
[Service]
AmbientCapabilities=CAP_SYS_NICE
CapabilityBoundingSet=CAP_SYS_NICE

Дополнительные строки дополняют поставляемые списки. Для удаления capability сначала сбросьте соответствующий список пустой строкой, затем перечислите полный оставшийся набор. Примените изменения:

sh
systemctl daemon-reload
systemctl restart CommuniGate-nonroot.service

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

Для Помощников, использующих iptables-legacy, также обеспечьте доступ к общему файлу /run/xtables.lock. Чтобы создавать отсутствующий файл и сохранять права после перезагрузки, добавьте следующее правило в /etc/tmpfiles.d/communigate-ipvs.conf (предварительно проверьте существующие правила):

text
f /run/xtables.lock 0660 root mail -

Примените его от root командой systemd-tmpfiles --create /etc/tmpfiles.d/communigate-ipvs.conf. Сохраняйте общий файл блокировки. Не заменяйте его отдельным и не удаляйте во время использования.

Запрет получения новых привилегий ​

В поставляемой службе режима непривилегированного пользователя установлено NoNewPrivileges=yes. При запуске программ Сервер и его дочерние процессы не могут получать дополнительные права через биты setuid/setgid или capabilities, назначенные исполняемому файлу (file capabilities). Ограничение наследуется дочерними процессами. Они не могут самостоятельно его снять.

Если Помощник требует получения прав именно через setuid/setgid или file capabilities, проверьте возможность работы с capabilities, заданными в службе. Эти права получат весь Сервер и его дочерние процессы. Если такой вариант не подходит, Администратор может отключить запрет командой systemctl edit CommuniGate-nonroot.service:

ini
[Service]
NoNewPrivileges=no

Это исключение действует на всю службу и её дочерние процессы. Оно не отменяет ограничений CapabilityBoundingSet и запрета запуска действия Выполнить от UID 0 в режиме непривилегированного пользователя. Для применения выполните:

sh
systemctl daemon-reload
systemctl restart CommuniGate-nonroot.service

Возврат на root ​

Остановите обе службы и другие процессы, изменяющие директорию данных. Для общего хранилища остановите соответствующие узлы Кластера:

sh
systemctl stop CommuniGate.service CommuniGate-nonroot.service

Чтобы вернуть владельца root:mail, выполните:

sh
bash /opt/CommuniGate/nonroot.sh --mode root

Для нестандартной директории данных добавьте --base /path/to/base. Существующий манифест сохраняет root:mail и права 0640.

Перенесите актуальные параметры запуска в CommuniGate.service. Проверьте systemctl cat CommuniGate.service и удалите локальное переопределение User=, если оно задаёт непривилегированного пользователя. В поставляемой службе пользователь не указан, поэтому служба запускается от root. Включите службу:

sh
systemctl disable CommuniGate-nonroot.service
systemctl mask CommuniGate-nonroot.service
systemctl unmask CommuniGate.service
systemctl daemon-reload
systemctl enable --now CommuniGate.service

После успешного запуска сохраните выбор службы от root:

sh
install -d -m 0755 -o root -g root /etc/CommuniGate
install -m 0600 -o root -g root /dev/null /etc/CommuniGate/service-unit
printf '%s\n' 'CommuniGate.service' > /etc/CommuniGate/service-unit

Подождите 10-15 секунд, проверьте systemctl status CommuniGate.service, Журнал, работу Приёмников и Помощников. При следующем переходе на режим непривилегированного пользователя повторите обработку прав. Запуск от имени root может создать новые файлы с владельцем root.