rt-mailgate-4 - En ligne dans le Cloud

PROGRAMME:

Nom

rt-mailgate - Passerelle de messagerie pour Request Tracker

SYNOPSIS

rt-mailgate --help : ce texte

Invocation habituelle (depuis MTA) :

rt-mailgate --action (correspond|commentaire|...) --queue nom_file
--url http://your.rt.server/
[ --debug ]
[ --extension (file d'attente|action|ticket) ]
[ --timeout secondes ]

OPTIONS

"--action"
Spécifie ce qu'il advient du courrier électronique envoyé à cet alias. Les actions de base disponibles sont :
"correspondre", "commenter".

Si vous avez défini la variable de configuration RT "UnsafeEmailCommands", "prendre" et "résoudre"
sont également disponibles. Vous pouvez exécuter deux actions ou plus sur un même message à l'aide d'un
"-" liste séparée. RT exécutera les actions dans l'ordre indiqué. Par exemple vous
peut utiliser "take-comment", "correspond-resolve" ou "take-comment-resolve" comme actions.

Notez que les actions « take » et « resolve » ignorent le texte du message si elles sont utilisées seules. Inclure un
action "commenter" ou "correspondre" si vous souhaitez que RT enregistre le message entrant.

L'action par défaut est « correspondre ».

"--file d'attente"
Ce drapeau détermine dans quelle file d'attente cet alias doit créer un ticket si aucun ticket
l'identifiant est trouvé.

"--url"
Ce drapeau indique à la passerelle de messagerie où elle peut trouver votre serveur RT. Vous devriez probablement
utilisez la même URL que les utilisateurs utilisent pour se connecter à RT.

Si vous disposez d'un certificat SSL auto-signé, vous devrez peut-être également transmettre "--ca-file" ou
"--no-verify-ssl", ci-dessous.

"--ca-fichier" chemin
Spécifie le chemin d'accès au certificat SSL public pour l'autorité de certification qui
doit être utilisé pour vérifier le certificat SSL du site Web. Si votre serveur Web utilise un
certificat signé, vous devez utiliser cette option de préférence plutôt que "--no-verify-ssl",
car il garantira que le certificat auto-signé que le mailgate voit le
bon certificat auto-signé.

"--no-verify-ssl"
Cet indicateur indique à la passerelle de messagerie de faire confiance à tous les certificats SSL, que leur
le nom d'hôte correspond au certificat, et indépendamment de l'autorité de certification. Ceci est obligatoire si vous avez un
certificat auto-signé, ou un autre certificat qui ne permet pas de remonter à un
certificat auquel votre système fait confiance en dernier ressort.

"--extension" FACULTATIF
Certains MTA achemineront le courrier envoyé à user-foo@host ou user+foo@host vers user@host et
présentez "foo" dans la variable d'environnement $EXTENSION. En spécifiant la valeur "file d'attente"
pour ce paramètre, la file d'attente à laquelle ce message doit être soumis sera définie sur
valeur de $EXTENSION. En spécifiant "ticket", $EXTENSION sera interprété comme l'identifiant
du ticket auquel ce message est lié. "action" permettra à l'utilisateur de spécifier
soit « commenter » ou « correspondre » dans l'extension d'adresse.

"--debug" FACULTATIF
Imprimer la sortie de débogage sur l'erreur standard

"--timeout" FACULTATIF
Configurez le délai d'expiration pour publier le message sur le serveur Web. Le délai d'attente par défaut
est de 3 minutes (180 secondes).

DESCRIPTION

La passerelle de messagerie RT est le principal mécanisme de communication avec RT par e-mail. Cette
programme dirige simplement l'e-mail vers le serveur Web RT, qui gère le classement de la correspondance
et l'envoi de tout courrier requis. Il est conçu pour être exécuté dans le cadre de la distribution du courrier
processus, soit appelé directement par le MTA ou "procmail", soit dans un .vers l'avant ou équivalent.

SETUP

Une grande partie de la configuration de la passerelle de messagerie dépend de votre MTA et de votre configuration de routage de messagerie.

Vous devez acheminer le courrier vers "rt-mailgate" pour les files d'attente que vous surveillez. Par exemple, si
vous utilisez / etc / aliases et vous avez une file d'attente de "bugs", vous voudrez quelque chose comme ceci :

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

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

Notez que vous n'êtes pas obligé d'exécuter votre serveur RT sur votre serveur de messagerie, en tant que passerelle de messagerie
se fera un plaisir de relayer à une autre machine.

PERSONNALISATION

Par défaut, la passerelle de messagerie accepte le courrier de n'importe qui. Cependant, il existe des situations
dans lequel vous souhaiterez authentifier les utilisateurs avant de leur permettre de communiquer avec le
système. Vous pouvez le faire via un mécanisme de plug-in dans la configuration RT.

Vous pouvez définir le tableau @MailPlugins comme une liste de plugins. Le plugin par défaut, s'il s'agit
pas donné, est "Auth::MailFrom" - c'est-à-dire que l'authentification de la personne est basée sur
l'en-tête « De » de l'e-mail. Si vous avez des filtres ou une authentification supplémentaires
mécanismes, vous pouvez les lister ici et ils seront appelés dans l'ordre :

Définir( @MailPlugins =>
"Filtre::SpamAssassin",
"Auth::LDAP",
#...
);

Consultez la documentation pour tous les plugins supplémentaires dont vous disposez.

Vous pouvez également mettre des sous-routines Perl dans le tableau @MailPlugins, si elles se comportent comme décrit
ci-dessous.

L'ÉCRITURE PLUGINS

Ce qui se passe réellement dans ce qui précède, c'est que @MailPlugins est une liste de modules Perl ; RT
ajoute "RT::Interface::Email ::" au nom, pour former un nom de package, puis "use"'s
ce module. Le module devrait fournir un sous-programme "GetCurrentUser", qui prend
un hachage de plusieurs paramètres :

Message
Un objet "MIME::Entity" représentant l'email

Utilisateur actuel
Un objet "RT::CurrentUser"

AuthStat
Le niveau d'authentification renvoyé par le plugin précédent.

Billet [FACULTATIF]
Le billet en discussion

File d'attente [FACULTATIF]
Si nous n'avons pas encore d'identifiant de ticket, nous devons savoir de quelle file d'attente nous parlons

Action
L'action en cours. Pour le moment, c'est l'un des "commenter" ou "correspondre"

Il renvoie deux valeurs, le nouvel objet "RT::CurrentUser" et le nouveau niveau d'authentification.
Le niveau d'authentification peut être zéro, pas du tout autorisé à communiquer avec RT (un
l'erreur "autorisation refusée" est envoyée par courrier au correspondant) ou une, qui est le mode normal
De fonctionnement. De plus, si "-1" est renvoyé, le traitement des plug-ins
s'arrête immédiatement et le message est ignoré.

ENVIRONNEMENT

EXTENSION
Certains MTA achemineront le courrier envoyé à user-foo@host ou user+foo@host vers user@host et
présente "foo" dans la variable d'environnement "EXTENSION". Mailgate ajoute de la valeur à ce
variable au message dans le champ "X-RT-Mail-Extension" de l'en-tête du message.

Voir aussi l'option "--extension". Notez que la valeur de la variable d'environnement est toujours
ajouté à l'en-tête du message lorsqu'il n'est pas vide même si l'option "--extension" n'est pas
à condition de.

Utilisez rt-mailgate-4 en ligne en utilisant les services onworks.net