46. pepsi-stage-relay-to-lmtp¶
Remettre localement via LMTP à un MDA (Dovecot) qui exécute Sieve.
46.1. Rôle¶
pepsi-stage-relay-to-lmtp est une étape de remise locale qui remet chaque message via LMTP (RFC 2033) à un Mail Delivery Agent, généralement Dovecot. Le MDA classe le message et, ce faisant, exécute le script Sieve (RFC 5228) du destinataire, de sorte que le filtrage côté serveur est délégué au MDA au lieu d’être implémenté dans Pepsi. C’est une alternative à pepsi-stage-relay-to-maildir. Avec LMTP, vous gagnez Sieve et un statut de remise net par destinataire, et vous n’avez besoin d”aucun helper setuid (le MDA effectue la remise par utilisateur) ; en contrepartie, vous devez faire tourner un serveur IMAP/LMTP local.
46.2. Remise native LMTP, remettre-et-acheminer¶
L’étape remet un destinataire par ligne, et donc un destinataire par transaction LMTP. Un message à plusieurs destinataires est d’abord scindé, et un destinataire nommé deux fois est écarté. Les réponses LMTP ne nomment aucun destinataire (RFC 2033 §4.2) : après une panne, rien ne permettrait de savoir à qui appartient une réponse ultérieure, et un seul programme Sieve lent retarderait tous les destinataires de la transaction. Le coût est d’une connexion et d’une exécution Sieve par destinataire ; les lignes partagent un même corps stocké. L’étape ne construit jamais elle-même de notification d’état de remise. Elle remet, et sinon achemine le destinataire plus loin selon la raison. Elle note cette raison sous state.bounce, pour qu’une pepsi-stage-bounce en aval (ou un relais) puisse agir en conséquence :
2xx— remis ; une notificationNOTIFY=SUCCESS(et les avertissementsDELAY) est acheminée vers leNOTIFY_STAGEfacultatif ;un rejet permanent est acheminé selon son code d’état étendu RFC 3463. Une mauvaise boîte aux lettres (
x.1.x,x.2.xautre quex.2.2, ainsi qu’un550nu sans aucun code d’état étendu) va versUNKNOWN_MAILBOX_STAGElorsque le destinataire appartient à l’un desLOCAL_DOMAINS(par défaut[pepsi-ingress] ACCEPTED_DOMAINS), sinon versNEXT_STAGE. Un dépassement de quota (x.2.2) va versQUOTA_LIMIT_STAGE(sinonNEXT_STAGE), un rejet Sieve ou de politique (x.7.x) versSIEVE_REJECT_STAGE(sinonNEXT_STAGE). Tout le reste va versBOUNCE_STAGElorsque le destinataire appartient à l’un desLOCAL_DOMAINSet que cette option est définie, et sinon versNEXT_STAGE;4xx— transitoire : réessayer ce destinataire (backoff exponentiel) jusqu’àMAX_LIFETIME, puis acheminer selon la même classification ;pas de réponse après l’envoi de tout le message — un accusé de réception perdu, après lequel personne ne sait si le MDA a classé le courrier. L’étape attend au moins 15 minutes avant un réessai et, après trois tentatives de ce genre ou lors de tout abandon ultérieur, achemine vers
BOUNCE_STAGE(sinonNEXT_STAGE) un rapport qui indique à l’expéditeur que le résultat est inconnu. Les workers tués à cette étape comptent aussi.
La ligne d’un destinataire remis prend fin, un destinataire acheminé devient une ligne pending à son étape cible, et un destinataire différé reste sur sa ligne pour le prochain réessai. Un échec de la session entière (connexion, STARTTLS, authentification, transfert des données) est lui aussi réessayé. Si cet échec est permanent, ou si le message a dépassé MAX_LIFETIME, l’étape achemine plutôt le destinataire plus loin.
Un destinataire porteur d’une demande RRVS= RFC 7293 la voit transmise lorsque le MDA annonce RRVS ; Dovecot ne le fait pas, de sorte que par défaut (action R) ce destinataire est refusé ici avec 5.7.19 et acheminé comme un rejet de politique, tandis que l’action C le remet (voir Un identifiant de connexion qui change de propriétaire).
Comme le MDA fait autorité sur les adresses qui sont locales, l’étape ne fait aucune vérification de localité propre. Placez-la après l’expansion d’alias, afin que seuls les destinataires censés être locaux l’atteignent. NEXT_STAGE est obligatoire (réglez-le sur une pepsi-stage-bounce pour produire un rebond, ou sur une étape de relais pour rediriger vers l’extérieur) ; un message atteignant l’étape sans en avoir un est marqué failed avant que le MDA soit contacté, de sorte que rien n’est remis.
46.3. Transport¶
La cible est soit une socket de domaine UNIX (SOCKET, la disposition Dovecot courante : pas de TLS, pas d’identifiants), soit TCP (HOST/PORT, PORT par défaut 24) avec TLS = off|starttls|tls et AUTH = none|plain|login|external facultatifs. L’authentification est refusée en clair, de sorte que tout AUTH autre que none exige TLS. Le client LMTP partagé réutilise la machinerie de transport, TLS et SASL du client SMTP (pepsi_common::smtp::deliver_lmtp).
L’étape s’exécute en tant qu’utilisateur non privilégié pepsi et ne porte aucun bit setuid ou setgid ; le MDA effectue la remise par utilisateur et on lui fait confiance pour ce qu’on lui remet, comme à tout helper externe que l’opérateur câble (Principaux et confiance accordée à chacun). Un PASSWORD est tenu hors du pepsi.conf lisible par tous : pepsi-setup le déplace dans secrets.d/pepsi.secret.
46.4. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-relay-to-lmtp, NEXT_STAGE (obligatoire), les cibles de motif facultatives QUOTA_LIMIT_STAGE / SIEVE_REJECT_STAGE / UNKNOWN_MAILBOX_STAGE (avec LOCAL_DOMAINS) / NOTIFY_STAGE, la cible (SOCKET, ou HOST/PORT avec TLS, TLS_VERIFY, TLS_CA, TLS_CLIENT_CERT, TLS_CLIENT_KEY, AUTH et ses USERNAME/PASSWORD), SERVER_NAME (le nom du LHLO ; par défaut [pepsi-ingress] HOSTNAME), les délais d’attente (CONNECT_TIMEOUT/COMMAND_TIMEOUT/DATA_TIMEOUT) et la politique de réessai (RETRY_INITIAL/RETRY_MAX_INTERVAL/RETRY_FACTOR/MAX_LIFETIME/ DELAY_DSN_AFTER). pepsi-setup exige NEXT_STAGE et vérifie que chacune des quatre cibles facultatives nomme une étape réelle. L’étape ne construit jamais de DSN elle-même. L’option commune BOUNCE_STAGE, lorsqu’elle est définie, reçoit un destinataire de LOCAL_DOMAINS qu’aucune autre option ne couvre, et un message dont l’erreur d’étape a persisté au-delà de MAX_LIFETIME.
46.5. État¶
Entrées :
state.dsn(NOTIFY/ORCPTpar destinataire) et la comptabilité de réessai qu’elle a écrite lors d’une passe antérieure.Sorties :
state.bouncesur chaque ligne sœur acheminée (consignant pourquoi le MDA a refusé, ou que la remise a réussi pour une notificationSUCCESS/DELAY), etattempts/last_error(plusdelay_sentune fois qu’un avertissement de délai a été acheminé) sur la ligne différée.state.dsn.rcptest découpé en phase avec les destinataires de chaque ligne.
46.6. Voir aussi¶
pepsi-stage-relay-to-maildir, pepsi-stage-aliases, pepsi-stage-bounce, pepsi-quota, Fonctionnalités prises en charge, pepsi-stage-relay-to-lmtp(1), pepsi.conf(5).