rt-mailgate-4 - Интернет в облаке

ПРОГРАММА:

ИМЯ

rt-mailgate - почтовый шлюз для трекера запросов

СИНТАКСИС

rt-mailgate --help: этот текст

Обычный вызов (из MTA):

rt-mailgate --action (соответствует | комментарий | ...) --queue queuename
--url http://your.rt.server/
[--debug]
[--extension (очередь | действие | билет)]
[--timeout секунд]

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

"--действие"
Указывает, что происходит с электронным письмом, отправленным на этот псевдоним. Доступные основные действия:
«соответствовать», «комментировать».

Если вы установили переменную конфигурации RT "UnsafeEmailCommands", "взять" и "разрешить"
также доступны. Вы можете выполнить два или более действий с одним сообщением, используя
Список, разделенный знаком «-». RT выполнит действия в указанном порядке. Например, вы
в качестве действий можно использовать «принять-комментарий», «согласовать-разрешить» или «принять-комментировать-разрешить».

Обратите внимание, что действия «принять» и «разрешить» игнорируют текст сообщения, если они используются отдельно. Включите
действие «комментарий» или «соответствие», если вы хотите, чтобы RT записывал входящее сообщение.

Действие по умолчанию - «соответствовать».

"--очередь"
Этот флаг определяет, в какой очереди этот псевдоним должен создать билет, если нет билета.
идентификатор найден.

"--url"
Этот флаг сообщает почтовому шлюзу, где он может найти ваш RT-сервер. Вы, наверное, должны
используйте тот же URL-адрес, который пользователи используют для входа в RT.

Если у вас есть самоподписанный сертификат SSL, вам также может потребоваться передать "--ca-file" или
"--no-verify-ssl", ниже.

"--ca-файл" путь
Задает путь к общедоступному сертификату SSL для центра сертификации, который
следует использовать для проверки SSL-сертификата веб-сайта. Если ваш веб-сервер использует самообслуживание
подписанный сертификат, вы должны использовать эту опцию предпочтительнее, чем "--no-verify-ssl",
поскольку он гарантирует, что самозаверяющий сертификат, который почтовый шлюз видит
правую самоподписанный сертификат.

"--no-verify-ssl"
Этот флаг указывает почтовому шлюзу доверять всем SSL-сертификатам, независимо от того,
имя хоста соответствует сертификату и независимо от CA. Это необходимо, если у вас есть
самозаверяющий сертификат или какой-либо другой сертификат, который нельзя отследить до
сертификат, которому ваша система безоговорочно доверяет.

"--extension" ДОПОЛНИТЕЛЬНО
Некоторые MTA будут перенаправлять почту, отправленную на user-foo @ host или user + foo @ host на user @ host и
представить "foo" в переменной окружения $ EXTENSION. Указав значение «очередь»
для этого параметра очередь, в которую должно быть отправлено это сообщение, будет установлена ​​в
значение $ EXTENSION. Если указать "билет", $ EXTENSION будет интерпретироваться как идентификатор
билета, к которому относится это сообщение. "действие" позволит пользователю указать
либо «комментарий», либо «соответствует» в расширении адреса.

"--debug" ДОПОЛНИТЕЛЬНО
Распечатать отладочный вывод в стандартную ошибку

"--timeout" ДОПОЛНИТЕЛЬНО
Настройте тайм-аут для отправки сообщения на веб-сервер. Тайм-аут по умолчанию
составляет 3 минуты (180 секунд).

ОПИСАНИЕ

Почтовый шлюз RT - это основной механизм для связи с RT по электронной почте. Этот
программа просто направляет электронное письмо на веб-сервер RT, который обрабатывает переписку
и отправка любой необходимой почты. Он предназначен для работы в рамках доставки почты.
процесс, вызываемый либо непосредственно MTA или "procmail", либо в .вперед или эквивалент.

УСТАНОВКА

Большая часть настройки почтового шлюза зависит от вашего MTA и конфигурации маршрутизации почты.

Вам необходимо направлять почту на «rt-mailgate» для очередей, которые вы отслеживаете. Например, если
вы используете / etc / aliases и у вас есть очередь "ошибок", вам понадобится что-то вроде этого:

ошибки: "| / usr / bin / rt-mailgate --queue bugs --action соответствуют
--url http://rt.mycorp.com/"

bugs-comment: "| / usr / bin / rt-mailgate --queue bugs --action comment
--url http://rt.mycorp.com/"

Обратите внимание, что вам не нужно запускать свой RT-сервер на своем почтовом сервере в качестве почтового шлюза.
с радостью перенаправит на другую машину.

ИЗГОТОВЛЕНИЕ

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

Вы можете установить массив @MailPlugins как список плагинов. Плагин по умолчанию, если это
не указано, это "Auth :: MailFrom" - то есть аутентификация человека выполняется на основе
заголовок "От" электронного письма. Если у вас есть дополнительные фильтры или аутентификация
механизмы, вы можете перечислить их здесь, и они будут вызываться по порядку:

Установить (@MailPlugins =>
"Фильтр :: SpamAssassin",
"Auth :: LDAP",
#...
);

См. Документацию о любых дополнительных плагинах, которые у вас есть.

Вы также можете поместить подпрограммы Perl в массив @MailPlugins, если они ведут себя, как описано
внизу.

ПИСЬМО PLUGINS

Фактически, в приведенном выше описании происходит то, что @MailPlugins - это список модулей Perl; RT
добавляет "RT :: Interface :: Email ::" к имени, чтобы сформировать имя пакета, а затем "использовать"
этот модуль. Ожидается, что модуль предоставит подпрограмму "GetCurrentUser", которая принимает
хеш из нескольких параметров:

Сообщение
Объект «MIME :: Entity», представляющий электронное письмо.

Текущий пользователь
Объект "RT :: CurrentUser"

Аутстат
Уровень аутентификации, возвращенный предыдущим плагином.

Билет [ДОПОЛНИТЕЛЬНО]
Обсуждаемый билет

Очередь [НЕОБЯЗАТЕЛЬНО]
Если у нас еще нет идентификатора билета, нам нужно знать, о какой очереди мы говорим.

Экшн
Выполняемое действие. На данный момент это один из вариантов «комментарий» или «переписка».

Он возвращает два значения: новый объект «RT :: CurrentUser» и новый уровень аутентификации.
Уровень аутентификации может быть нулевым, не разрешено вообще связываться с RT (a
сообщение об ошибке "доступ запрещен" отправляется корреспонденту) или один, который является нормальным режимом
операции. Кроме того, если возвращается «-1», то обработка плагинов
немедленно останавливается, и сообщение игнорируется.

ОКРУЖАЮЩАЯ СРЕДА

РАСПРОСТРАНЕНИЕ
Некоторые MTA будут перенаправлять почту, отправленную на user-foo @ host или user + foo @ host на user @ host и
представьте "foo" в переменной окружения "EXTENSION". Mailgate увеличивает ценность этого
в сообщение в поле «X-RT-Mail-Extension» заголовка сообщения.

См. Также параметр «--extension». Обратите внимание, что значение переменной среды всегда
добавляется в заголовок сообщения, если он не пустой, даже если параметр "--extension" не установлен
при условии.

Используйте rt-mailgate-4 онлайн с помощью сервисов onworks.net