rt-mailgate-4: en línea en la nube

PROGRAMA:

NOMBRE

rt-mailgate: puerta de enlace de correo para el rastreador de solicitudes

SINOPSIS

rt-mailgate --help: este texto

Invocación habitual (de MTA):

rt-mailgate --acción (corresponde | comentario | ...) --queue nombre de la cola
--url http://your.rt.server/
[--debug]
[--extension (cola | acción | ticket)]
[--segundos de tiempo de espera]

OPCIONES

"--acción"
Especifica qué sucede con el correo electrónico enviado a este alias. Las acciones básicas disponibles son:
"corresponder", "comentar".

Si ha establecido la variable de configuración RT "UnsafeEmailCommands", "tomar" y "resolver"
también están disponibles. Puede ejecutar dos o más acciones en un solo mensaje utilizando un
"-" lista separada. RT ejecutará las acciones en el orden indicado. Por ejemplo tu
puede usar "tomar-comentar", "corresponder-resolver" o "tomar-comentar-resolver" como acciones.

Tenga en cuenta que las acciones de "tomar" y "resolver" ignoran el texto del mensaje si se usan solas. Incluir un
Acción "comentar" o "corresponder" si desea que RT grabe el mensaje entrante.

La acción predeterminada es "corresponder".

"--cola"
Esta bandera determina en qué cola este alias debe crear un ticket si no hay ticket
se encuentra el identificador.

"--url"
Esta bandera le dice a la puerta de enlace de correo dónde puede encontrar su servidor RT. Probablemente deberías
utilice la misma URL que utilizan los usuarios para iniciar sesión en RT.

Si tiene un certificado SSL autofirmado, es posible que también deba pasar "--ca-file" o
"--no-verify-ssl", a continuación.

"--ca-file" camino
Especifica la ruta al certificado SSL público para la autoridad certificadora que
debe utilizarse para verificar el certificado SSL del sitio web. Si su servidor web utiliza un
certificado firmado, debe utilizar preferentemente esta opción en lugar de "--no-verify-ssl",
ya que se asegurará de que el certificado autofirmado de que el mailgate esté viendo el
un Derecho certificado autofirmado.

"--no-verify-ssl"
Esta bandera le dice a la puerta de enlace de correo que confíe en todos los certificados SSL, independientemente de si su
El nombre de host coincide con el certificado e independientemente de la CA. Esto es necesario si tiene un
certificado autofirmado, o algún otro certificado que no sea rastreable hasta un
certificado en el que su sistema confía en última instancia.

"--extension" OPCIONAL
Algunos MTA enrutarán el correo enviado a user-foo @ host o user + foo @ host a user @ host y
presente "foo" en la variable de entorno $ EXTENSION. Especificando el valor "cola"
para este parámetro, la cola a la que se debe enviar este mensaje se establecerá en el
valor de $ EXTENSION. Al especificar "ticket", $ EXTENSION se interpretará como el id.
del ticket con el que está relacionado este mensaje. "acción" permitirá al usuario especificar
ya sea "comentar" o "corresponder" en la extensión de la dirección.

"--debug" OPCIONAL
Imprimir salida de depuración a error estándar

"--timeout" OPCIONAL
Configure el tiempo de espera para publicar el mensaje en el servidor web. El tiempo de espera predeterminado
es de 3 minutos (180 segundos).

DESCRIPCIÓN

La pasarela de correo RT es el mecanismo principal para comunicarse con RT a través del correo electrónico. Esta
El programa simplemente dirige el correo electrónico al servidor web RT, que se encarga de archivar la correspondencia.
y enviar cualquier correo requerido. Está diseñado para ejecutarse como parte de la entrega de correo.
proceso, ya sea llamado directamente por el MTA o "procmail", o en un .adelante o equivalente.

CONFIGURACIÓN

Gran parte de la configuración de la puerta de enlace de correo depende de su MTA y de la configuración del enrutamiento de correo.

Necesita enrutar el correo a "rt-mailgate" para las colas que está monitoreando. Por ejemplo, si
estas usando / etc / aliases y tienes una cola de "errores", querrás algo como esto:

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

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

Tenga en cuenta que no tiene que ejecutar su servidor RT en su servidor de correo, ya que la puerta de enlace de correo
felizmente retransmitirá a una máquina diferente.

CUSTOMIZACIÓN

De forma predeterminada, la puerta de enlace de correo aceptará correo de cualquier persona. Sin embargo, hay situaciones
en el que querrá autenticar a los usuarios antes de permitirles comunicarse con el
sistema. Puede hacer esto a través de un mecanismo de complemento en la configuración de RT.

Puede configurar la matriz @MailPlugins para que sea una lista de complementos. El complemento predeterminado, si es
no se proporciona, es "Auth :: MailFrom", es decir, la autenticación de la persona se realiza en función de
el encabezado "De" del correo electrónico. Si tiene filtros o autenticación adicionales
mecanismos, puede enumerarlos aquí y se llamarán en orden:

Establecer (@MailPlugins =>
"Filtro :: SpamAssassin",
"Auth :: LDAP",
#...
);

Consulte la documentación para conocer los complementos adicionales que tenga.

También puede poner subrutinas Perl en la matriz @MailPlugins, si se comportan como se describe
abajo.

ESCRITURA PLUGINS

Lo que realmente está sucediendo en lo anterior es que @MailPlugins es una lista de módulos Perl; RT
antepone "RT :: Interface :: Email ::" al nombre, para formar un nombre de paquete, y luego "usa"
este módulo. Se espera que el módulo proporcione una subrutina "GetCurrentUser", que requiere
un hash de varios parámetros:

Su mensaje
Un objeto "MIME :: Entity" que representa el correo electrónico

Usuario actual
Un objeto "RT :: CurrentUser"

Estadísticas de autenticación
El nivel de autenticación devuelto por el complemento anterior.

Boleto [OPCIONAL]
El boleto en discusión

Cola [OPCIONAL]
Si aún no tenemos un ID de ticket, necesitamos saber de qué cola estamos hablando

Acción
La acción que se está realizando. Por el momento, es uno de "comentar" o "corresponder"

Devuelve dos valores, el nuevo objeto "RT :: CurrentUser" y el nuevo nivel de autenticación.
El nivel de autenticación puede ser cero, no se le permite comunicarse con RT en absoluto, (un
El error "permiso denegado" se envía al corresponsal) o uno, que es el modo normal.
de operación. Además, si se devuelve "-1", el procesamiento de los complementos
se detiene inmediatamente y el mensaje se ignora.

MEDIO AMBIENTE

EXTENSIÓN
Algunos MTA enrutarán el correo enviado a user-foo @ host o user + foo @ host a user @ host y
presente "foo" en la variable de entorno "EXTENSION". Mailgate agrega valor a esto
variable a mensaje en el campo "X-RT-Mail-Extension" del encabezado del mensaje.

Consulte también la opción "--extension". Tenga en cuenta que el valor de la variable de entorno es siempre
agregado al encabezado del mensaje cuando no está vacío, incluso si la opción "--extension" no está
previsto.

Use rt-mailgate-4 en línea usando los servicios de onworks.net