45. pepsi-stage-dot-forward

Traiter les fichiers ~/.forward par utilisateur.

45.1. Rôle

pepsi-stage-dot-forward permet au propriétaire d’un compte local de rediriger son propre courrier avec un fichier ~/.forward. Pour chaque destinataire d’enveloppe qui est local (le même test LOCAL_DOMAINS / TARGETS / RECIPIENT_DELIMITER que pepsi-stage-relay-to-maildir), elle exécute le ~/.forward de cet utilisateur via le helper pepsi-helper-dot-forward(1) setuid-root, qui abandonne d’abord ses privilèges vers l’utilisateur. Les destinataires non locaux sont laissés intacts. L’étape se place normalement juste avant la remise locale. Référence : pepsi-stage-dot-forward(1).

45.2. Fonctionnalités

45.2.1. Issues par destinataire

  • Pas de ~/.forward — le destinataire est laissé passer tel quel et avance vers NEXT_STAGE (typiquement la remise locale).

  • Redirigé — le destinataire est remplacé par les adresses que le ~/.forward a nommées ; celles-ci redémarrent le pipeline à RESTART_STAGE (par défaut init) afin d’être réauthentifiées et réacheminées comme un courrier nouvellement arrivé, après une retenue aléatoire d’au plus [pepsi] REFLECTION_HOLD_MAX (30 s), puisqu’une copie réexpédiée est du courrier réfléchi (Destinataires inconnus et backscatter). Un résultat vide (le message a été consommé par une directive |pipe//file) supprime le destinataire.

  • Échoué — le destinataire est acheminé vers BOUNCE_STAGE lorsque son ~/.forward échoue : une erreur de commande de pipe, une erreur d’écriture de fichier, une directive désactivée, plus de 100 adresses, ou une adresse que l’étape refuse comme inutilisable (plus de 256 octets, espaces, caractères de contrôle, < > " , ; ou un domaine invalide).

  • Problème d’hôte — le helper n’a pas pu agir du tout (pas installé setuid-root, échec d’une recherche passwd, un répertoire personnel ou un ~/.forward qui n’appartient pas exclusivement à l’utilisateur), ou une |command a demandé à être réessayée (code de sortie 75, EX_TEMPFAIL) ou a épuisé ses 300 secondes. Rien n’est rebondi : le message reste en file et est réessayé jusqu’à MAX_LIFETIME, et les destinataires déjà traités lors de cette passe sont validés d’abord, de sorte qu’aucun ~/.forward ne s’exécute deux fois pour eux.

Un message comportant plusieurs destinataires peut mêler ces issues ; les adresses redirigées, les rebonds par destinataire et les destinataires conservés sont réconciliés en un seul découpage du message suivi de son terminal (une seule instruction lorsqu’aucun destinataire ne reste sur le message).

45.2.2. Directives ~/.forward

Le helper agit sur chaque entrée en tant que l’utilisateur. Il ignore les lignes vides et les lignes #, et une ligne peut contenir plusieurs entrées séparées par des virgules, éventuellement entre guillemets doubles. Une adresse nue devient une adresse de redirection. |command envoie le message par tube à /bin/sh -c lorsque ALLOW_PIPE est activé, avec un environnement construit uniquement à partir de l’entrée passwd de l’utilisateur et d’un PATH fixe. /absolute/path ajoute le message à un fichier lorsque ALLOW_FILE est activé. Lorsque ALLOW_PIPE et ALLOW_FILE sont tous deux désactivés, le corps du message n’est même pas remis au helper.

Une adresse écrite avec le \ initial de sendmail signifie « remettre à ce nom et ne pas le développer davantage », et n’est pas relancée à RESTART_STAGE. La ligne canonique pour conserver une copie locale, \bob dans ~bob/.forward, conserve simplement ce destinataire d’enveloppe sur cette ligne, de sorte qu’elle avance vers NEXT_STAGE et est remise localement ; tout autre \name devient une ligne sœur à NEXT_STAGE. C’est aussi ce qui empêche une entrée \ de rentrer de nouveau dans cette étape.

45.2.3. Prévention des boucles

Comme la redirection relance le pipeline, chaque ligne redirigée porte sa chaîne de redirection dans state["dot-forwarders"] (voir L’état du message) : la chaîne de la ligne dont elle provient, plus le login dont le ~/.forward l’a redirigée. Un destinataire dont l’utilisateur figure déjà dans la chaîne de sa ligne est acheminé vers BOUNCE_STAGE sans que son ~/.forward soit réexécuté (un message à expéditeur nul est supprimé à la place), de sorte qu’un cycle de redirection se termine et que l’expéditeur en est informé. La chaîne est propre à chaque chemin de redirection : plusieurs destinataires d’un même message qui redirigent reçoivent chacun une ligne sœur ne portant que leur propre chaîne.

45.2.4. Adresses recyclées

Un destinataire local dont le paramètre RRVS= ou le champ Require-Recipient-Valid-Since nomme une date antérieure à un changement de propriétaire consigné de son login rebondit avec 550 5.7.17 avant que le helper ne s’exécute, de sorte que le ~/.forward d’un nouveau propriétaire ne puisse pas emporter le message (Un identifiant de connexion qui change de propriétaire). Les adresses de redirection n’héritent pas de la demande.

45.3. Privilèges

L’étape doit être installée setgid pepsi-forward, avec le mode 2550 et le propriétaire pepsi:pepsi-forward. Seul le propriétaire peut l’exécuter, de sorte qu’aucun autre utilisateur local n’atteint le bit setgid. C’est cette appartenance au groupe qui permet au worker pepsi du dispatcher d’exécuter le helper 4750 root:pepsi-forward. Seul le helper exécute le ~/.forward en tant qu’utilisateur cible, et il refuse d’agir pour root ou tout uid inférieur à UID_MIN. L’étape applique aussi elle-même la règle : s’exécutant avec le bit setgid, elle refuse un utilisateur réel autre que root ou pepsi avant de lire toute configuration. Le helper refuse un répertoire personnel ou un ~/.forward qui n’appartient pas exclusivement à l’utilisateur (un problème d’hôte, le message attend donc), ouvre ~/.forward sans suivre les liens symboliques, et exécute une |command dans son propre groupe de processus avec un environnement construit uniquement à partir de l’entrée passwd de l’utilisateur ; une commande dispose de 300 secondes et le helper dans son ensemble de 330 avant d’être tué et réessayé. Voir La séparation des privilèges et Un utilisateur shell local. Porter ce bit est la raison pour laquelle l’étape est un binaire autonome plutôt que l’un des programmes repliés dans le binaire pepsi unifié.

45.4. Configuration

[stage-<name>] : PROGRAM = pepsi-stage-dot-forward, NEXT_STAGE (où va un destinataire en passage direct — normalement la remise locale), BOUNCE_STAGE (où va un destinataire dont le ~/.forward a échoué), RESTART_STAGE (par défaut init), ALLOW_PIPE et ALLOW_FILE (tous deux yes par défaut), HELPER (par défaut pepsi-helper-dot-forward) et les options de localité partagées LOCAL_DOMAINS (valant par défaut [pepsi-ingress] ACCEPTED_DOMAINS), TARGETS et RECIPIENT_DELIMITER. pepsi-setup vérifie que RESTART_STAGE nomme une étape réelle. Voir pepsi-stage-dot-forward(1).

45.5. État

  • Entrées : state["dot-forwarders"] (la protection contre les boucles) et state.dsn.

  • Sorties : state["dot-forwarders"] sur chaque ligne redirigée (redémarrée ou \name) : la chaîne de la ligne source plus le login dont le ~/.forward l’a produite. state.dsn.rcpt est reconstruit de concert avec les destinataires de chaque ligne, et chaque cible de redirection est marquée avec expanded_from (le destinataire qu’elle remplace). Un DSN au sujet d’une cible ne nomme donc que ce destinataire (pepsi-stage-bounce), et une copie envoyée hors site part avec une adresse de retour de réexpédition (pepsi-stage-srs, Les adresses de retransmission dans les rapports de remise). Ainsi, un rapport du propre serveur de la cible reçoit la même réponse au lieu d’être relayé. La ligne d’un destinataire rebondi porte state.bounce.

45.6. Voir aussi

pepsi-stage-relay-to-maildir, pepsi-stage-aliases, pepsi-stage-bounce, Fonctionnalités prises en charge, pepsi-stage-dot-forward(1), pepsi-helper-dot-forward(1).