Zimbra: грамотно работаем с фильтрами сообщений в веб-клиенте и в командной строке

Содержание: как правильно экспортировать и импортировать фильтры обработки сообщений из учетных записей зимбры.

Веб-интерфейс позволяет создавать фильтры для обработки сообщений. Они сохраняются в параметре zimbraMailSieveScript.

Например:

$ zmprov ga учетка zimbramailsievescript

zimbraMailSieveScript: require ["fileinto", "reject", "tag", "flag"];

# только от диспетчеров
if allof (not address :all :contains :comparator "i;ascii-casemap" ["from"] "диспетчер@мой-домен") {
    fileinto "Inbox/ошибка отправителя";
    stop;
}

# test-forwards
if anyof (address :localpart :contains :comparator "i;ascii-casemap" ["to","cc"] "+sms",
  header :contains ["subject"] "sms:",
  header :contains ["subject"] "+sms",
  header :contains ["subject"] "смс:",
  header :contains ["subject"] "+смс") {
    redirect "номер@sms.megafondv.ru";
    redirect "адрес@домен";
    redirect "псевдоним@sms.megafondv.ru";
    keep;
    stop;
}

В менее человеческом виде этот скрипт показывает команда

zmmailbox -m аккаунт -A -z gfrl

Экспорт и импорт таких скриптов расписан, например, здесь

https://pario.no/2011/07/21/migrate-zimbra-mail-filter-rules-between-servers/

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

Решение  простое: выполняем эти операции из-под рута, указывая полный путь к скрипту и полные пути к используемым бинарникам.

1. делаем экспорт из-под зимбры или из-под рута - не важно, экспортируется правильно, в текущей системной кодировке (у меня это UTF-8)

# регистр в названии параметра не важен, можно написать и zimbramailsievescript
# я принципиально добавляю к скриптам оболочки расширение sh, чтобы самому было понятно. Разумеется, другие не обязаны следовать этому правилу.

/opt/bin/zmprov ga учетка zimbraMailSieveScript>имя-скрипта.sh

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

chmod  +x имя-скрипта.sh

Любым редактором правим этот файл, я предпочитаю mcedit. Убираем красное, добавляем зеленое

/opt/zimbra/bin/zmprov ga $1 zimbraMailSieveScript
# name учетка
/opt/zimbra/bin/zmprov ma $1 zimbraMailSieveScript: 'require ["fileinto", "reject", "tag", "flag"];

# имя фильтра
if anyof (address :localpart :contains :comparator "i;ascii-casemap" ["to","cc"] "+sms",
...
}'
/opt/zimbra/bin/zmprov ga $1 zimbraMailSieveScript

Кусок скрипта вырезан, чтобы не загромождать пример. Особое внимание на два зеленых апострофа вокруг текста экспортированного скрипта - выделяем ими длинную строку от "require" до закрывающей фигурной скобки.

Для красоты и удобства, особенно если фильтр требуется применить к нескольким учеткам, подставляем вместо имени учётки переменную, и дважды - до и после операции - выводим состояние параметра zimbraMailSieveScript.

3. Полученный сценарий выполняем из-под рута! Исполнение из-под зимбры приведёт к к тому, что вся кириллица похерится.

Вот пример. Создаем простенький бурчащий фильтр :-)



zimbra@host:~$ zmprov ga учётка zimbramailsievescript
# name учётка@домен
zimbraMailSieveScript: require ["fileinto", "reject", "tag", "flag"];

# бурbur
if anyof (header :contains ["subject"] "burбур") {
    keep;
    stop;
}

root@host:/opt/zimbra/bin# ./zmprov ga учётка zimbramailsievescript
# name учётка@домен
zimbraMailSieveScript: require ["fileinto", "reject", "tag", "flag"];

# бурbur
if anyof (header :contains ["subject"] "burбур") {
    keep;
    stop;
}
Как видно, оба экспорта идентичны. А теперь попробуем импортировать (текст правим, как я писал выше).

$ cat bur.sh
# показать текущее состояние
/opt/zimbra/bin/zmprov ga $1 zimbramailsievescript
# очистить для верности
/opt/zimbra/bin/zmprov ma $1 zimbramailsievescript ""
# обновляем
/opt/zimbra/bin/zmprov ma $1 zimbramailsievescript 'require ["fileinto", "reject", "tag", "flag"];

# бурbur
if anyof (header :contains ["subject"] "burбур") {
    keep;
    stop;
}'

/opt/zimbra/bin/zmprov ga $1 zimbramailsievescript
Запуск под зимброй:

zimbra@host:~$ /tmp/bur.sh учётка
# name учётка@домен
zimbraMailSieveScript: require ["fileinto", "reject", "tag", "flag"];

# бурbur
if anyof (header :contains ["subject"] "burбур") {
    keep;
    stop;
}

# name учётка@домен
zimbraMailSieveScript: require ["fileinto", "reject", "tag", "flag"];

# ������bur
if anyof (header :contains ["subject"] "bur������") {
    keep;
    stop;
}

Некрасиво, правда?

Теперь тот же скрипт из-под рута (не буду вычищать то, что наделалось при предыдущем импорте - пусть меняется неправильный фильтр):

root@host:/tmp# ./bur.sh учётка
# name учётка@домен
zimbraMailSieveScript: require ["fileinto", "reject", "tag", "flag"];

# ??????bur
if anyof (header :contains ["subject"] "bur??????") {
    keep;
    stop;
}

# name учётка@домен
zimbraMailSieveScript: require ["fileinto", "reject", "tag", "flag"];

# бурbur
if anyof (header :contains ["subject"] "burбур") {
    keep;
    stop;
}
Результирующий скриншот не привожу, он совпадает с первым.

На сладкое. В менее наглядной форме с фильтрами позволяет работать zmmailbox. Если zmprov может импортировать только набор фильтров целиком (каждый фильтр начинается с комментария со своим именем, синтаксис можно найти в интернетах, пример - в самом первом листинге этой статьи: два фильтра "только от диспетчеров" и "test-forwards"), то zmmailbox позволяет работать с отдельными фильтрами. К сожалению, способа работать с отдельными правилами в пределах фильтра я не нашел, поэтому, если надо изменить одно правило, делаем экспорт фильтра, меняем в его тексте нужное правило, импортируем обратно. Параметры и ключи CLI zmmailbox - в манах и интернетах.

Вот как выглядит "бурбур" в исполнении zmmailbox:

zimbra@host:~$ zmmailbox -m учётка -A -z gfrl
"бурbur" active any header "subject" contains "burбур" keep stop


название фильтра
состояние (active/inactive)
условия
действия

edit: для отключения фильтра через SieveScript (соответствует inactive для gfrl) надо в начале текста добавить "disabled_":

действует:

# бурbur
if anyof (header :contains ["subject"] "burбур") {
    keep;
    stop;
}

Не действует:

# бурbur
disabled_if anyof (header :contains ["subject"] "burбур") {
    keep;
    stop;
}