95.1.14. pepsi-stage-dot-forward¶
process per-user ~/.forward files
- Section du manuel:
1
95.1.14.1.1. Nom¶
pepsi-stage-dot-forward - l’étape de traitement de ~/.forward du pipeline Pepsi.
95.1.14.1.2. Synopsis¶
pepsi-stage-dot-forward [GLOBAL-OPTIONS] worker
95.1.14.1.3. Description¶
pepsi-stage-dot-forward est un programme d’étape exécuté par pepsi-dispatch(1). Pour chaque destinataire d’enveloppe qui se résout en un compte local, il exécute le fichier ~/.forward de cet utilisateur, le mécanisme sendmail/Postfix classique par lequel un titulaire de compte redirige son propre courrier. La localité est décidée exactement comme dans pepsi-stage-relay-to-maildir(1) : le domaine du destinataire doit être dans LOCAL_DOMAINS, son nom de boîte aux lettres (local-part, sous-adresse après RECIPIENT_DELIMITER retirée, mise en minuscules) doit se résoudre en une entrée passwd, et cet uid doit être permis par TARGETS. Un destinataire qui n’est pas local est laissé intact et avance vers NEXT_STAGE. Une consultation passwd qui échoue (un backend LDAP ou sssd en panne) n’est pas interprétée comme « non local » : le message est réessayé, plutôt que remis en contournant le ~/.forward de l’utilisateur.
Le ~/.forward lui-même est lu et exécuté par le helper privilégié pepsi-helper-dot-forward(1), qui commence par abandonner ses privilèges au profit de l’utilisateur cible. Le code de sortie du helper indique à l’étape ce qu’est devenu ce destinataire :
pas de ~/.forward — le destinataire est un passthrough : il reste sur le message, qui avance vers NEXT_STAGE (typiquement la remise locale, puis un smarthost). Un
~/.forwardvide, ou ne contenant que des lignes vides et des commentaires, ne redirige rien et compte comme absent. Un destinataire conservé par sa propre entrée\nameavance aussi vers NEXT_STAGE, mais, chaque fois que le message est scindé, sur une ligne sœur qui lui est propre, afin qu’aucun réessai de cette étape n’exécute son~/.forwardune seconde fois.réexpédié — le destinataire est remplacé par les adresses que nommait le
~/.forward. Celles-ci relancent le pipeline à RESTART_STAGE (par défautinit) sur une nouvelle ligne sœur, de sorte que les destinataires réécrits sont réauthentifiés et réacheminés comme du courrier neuf. Chaque adresse note le destinataire qu’elle remplace (expanded_fromdans son entréestate.dsn, à côté d’unORCPTqui le nomme), de sorte qu’un DSN que Pepsi écrit à son sujet ne nomme que ce destinataire, avec un diagnostic générique (pepsi-stage-bounce(1)) : les cibles d’un~/.forwardne sont pas divulguées à l’expéditeur. Une copie envoyée hors site part avec une adresse de retour de réexpédition (pepsi-stage-srs(1)) plutôt qu’avec une adresse SRS, de sorte qu’un rapport qu’envoie le propre serveur de la cible revient à pepsi-ingress(1), qui y répond par le même type de DSN et ne le transmet pas. La ligne commencepausedpour une durée aléatoire d’au plus[pepsi] REFLECTION_HOLD_MAX(30 s par défaut ; pepsi.conf(5)), puisqu’une copie réexpédiée est du courrier réfléchi ; le dispatcher la libère ensuite.consommé — des directives
|pipeou/fileont pris le message et le~/.forwardne nomme aucune adresse (code de sortie4). Le destinataire a son courrier et quitte le message.échoué — le helper a refusé ou échoué pour ce destinataire (code de sortie
2) : une commande de tube a quitté avec un code non nul (autre que75), un fichier n’a pu être écrit, une directive désactivée a été demandée, ou le~/.forwardnomme plus de 100 adresses ; ou l’étape a refusé une adresse que le helper a renvoyée (une adresse de plus de 256 octets, contenant une espace, un caractère de contrôle ou l’un de< > " , ;, ou avec un domaine invalide). Le destinataire est acheminé vers BOUNCE_STAGE afin qu’un DSN d’échec soit généré (en honorant leNOTIFYde l’expéditeur). Un message qui est lui-même un rebond (expéditeur nul) n’est jamais renvoyé en rebond.problème d’hôte — le helper a signalé un échec opérationnel (code de sortie
3), une|commanda demandé à être réessayée, ou le helper n’a pas pu être exécuté du tout, a été tué par un signal, ou a quitté avec un statut qu’il ne documente pas. Un échec opérationnel signifie que le helper n’est pas installé setuid-root, que la consultation passwd a échoué, que le compte est refusé (root, un uid inférieur àUID_MIN, un répertoire personnel relatif), que le répertoire personnel ou le~/.forwardn’appartient pas exclusivement à l’utilisateur (il n’en est pas propriétaire, ou il est accessible en écriture au groupe ou à tous), ou que le~/.forwardest un lien symbolique, n’est pas un fichier ordinaire ou ne peut pas être lu. Le helper vérifie le répertoire personnel avant de chercher un~/.forward; cette vérification refuse donc aussi les comptes qui n’en ont pas. Une|commanddemande à être réessayée lorsqu’elle quitte avec75(EX_TEMPFAIL), manque de temps ou ne peut pas être lancée. Aucun de ces cas n’est un verdict sur le destinataire, donc rien ne rebondit : le message est réessayé (une minute, doublée jusqu’à une heure, jusqu’à MAX_LIFETIME, après quoi il va vers BOUNCE_STAGE, ou est mis en échec s’il n’y en a pas ; voir pepsi-dispatch(1)).Les destinataires traités plus tôt dans la même passe ont été pris en charge : leurs tubes ont été exécutés et leurs fichiers écrits. Avant le réessai, ils sont donc validés avec leur issue (redirigé, conservé, rebondi), et le message est réduit aux destinataires que le helper n’a pas atteints. Un réessai n’exécute donc jamais deux fois le
~/.forwardd’un destinataire. La seule exception est le destinataire dont le propre~/.forwarda différé en cours de route : les directives situées au-dessus de celle qui a différé ont agi, et agissent de nouveau.
Un même message peut présenter un mélange de ces issues selon ses destinataires ; les adresses redirigées, les rebonds par destinataire et les destinataires conservés (passthrough) sont réconciliés en une seule scission du message, suivie de son terminal (dans la même instruction lorsqu’aucun destinataire ne reste sur le message). Le jeton de chaque ligne sœur est dérivé du destinataire ou du login de redirection qu’elle porte, de sorte qu’une passe réessayée ne peut jamais entrer en collision avec une ligne créée par une passe antérieure.
95.1.14.1.4. Boucles de redirection¶
Comme un message redirigé redémarre tout le pipeline, deux utilisateurs se redirigeant l’un vers l’autre (~bob → alice, ~alice → bob) boucleraient. Pour empêcher cela, chaque ligne redirigée porte sa chaîne de redirection dans state["dot-forwarders"] (voir pepsi.state(7)) : la chaîne de la ligne depuis laquelle elle a été redirigée, 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 n’est pas remis et le helper n’est pas appelé (un avertissement est journalisé), de sorte que la chaîne se termine. Le destinataire est acheminé vers BOUNCE_STAGE comme n’importe quel autre échec de ~/.forward, afin que l’expéditeur soit informé (la RFC 5321 §6.1 exige une notification une fois le message accepté). Si le message est lui-même un rebond, le destinataire est abandonné à la place.
La chaîne appartient à un chemin de redirection, pas au message : lorsque plusieurs destinataires d’un même message redirigent, les adresses de chacun partent sur une ligne sœur à part, qui ne porte que la chaîne de ce destinataire. Un saut ultérieur par le ~/.forward d’un destinataire n’est donc jamais pris pour une boucle à cause de l’entrée d’un autre destinataire dans la chaîne. Une adresse vers laquelle plusieurs d’entre eux redirigent est remise une seule fois, sur la ligne du premier destinataire qui l’a nommée.
95.1.14.1.5. Adresses recyclées (RFC 7293)¶
Un ~/.forward est la propre redirection de son propriétaire. Selon la RFC 7293 section 5.2.1, il ne passe le test de propriété continue que pour le propriétaire que visait l’expéditeur. Un destinataire local peut porter une demande de propriété depuis une date (un paramètre RRVS=, ou un champ d’en-tête Require-Recipient-Valid-Since qui nomme le destinataire ; voir pepsi-stage-relay-to-maildir(1)). Lorsque le login du destinataire a un changement de propriétaire consigné après cette date, le destinataire rebondit donc avec 550 5.7.17 via BOUNCE_STAGE avant que le helper ne s’exécute, afin que la réexpédition du nouveau propriétaire ne puisse pas emporter le message. Pour un tel destinataire, la vérification note l’uid actuel du login dans pepsi.login_assignment comme le fait la remise locale (un destinataire sans demande n’est pas noté ici) ; une erreur de base de données fait réessayer le destinataire. Les adresses de réexpédition n’héritent pas de la demande (RFC 7293 section 8.2 : Pepsi ne détient aucun enregistrement de propriété pour la nouvelle destination).
95.1.14.1.6. Arguments et sous-commandes¶
- worker
Exécuté comme un worker persistant de pepsi-dispatch(1), lisant les identifiants de message sur l’entrée standard et écrivant une ligne de statut pour chacun. C’est ainsi que le dispatcher exécute l’étape en production.
95.1.14.1.7. Configuration¶
Lu depuis la section [stage-<stage>] du message :
- PROGRAM
Doit être
pepsi-stage-dot-forward.- RESTART_STAGE
L’étape à laquelle un message redirigé avec succès redémarre. Par défaut
init(réexécutant tout le pipeline entrant, y compris l’authentification). Réglez-la sur une étape ultérieure (par exemplesrs) pour sauter la réauthentification d’un message redirigé en interne. Doit nommer une étape existante.- ALLOW_PIPE
Si les directives
|commanddans un~/.forwardsont honorées (le message est envoyé par tube à la commande, exécutée en tant que l’utilisateur). Par défautyes.- ALLOW_FILE
Si les directives
/path(ajouter le message à un fichier) sont honorées. Par défautyes. Lorsque ALLOW_PIPE et ALLOW_FILE sont tous deuxno, l’étape n’envoie pas du tout le corps du message au helper par tube (le helper n’a besoin que de lire les adresses de redirection).- TARGETS, LOCAL_DOMAINS, RECIPIENT_DELIMITER
La sélection de compte local, de signification identique à pepsi-stage-relay-to-maildir(1). TARGETS vaut par défaut la plage d’uid ordinaires (non système) de
/etc/login.defs, et pepsi-helper-dot-forward(1) refuse tout uid inférieur àUID_MINquoi qu’elle indique (pepsi-setup(1) avertit d’un jeton qui descend en dessous) ; LOCAL_DOMAINS vaut par défaut[pepsi-ingress] ACCEPTED_DOMAINS; RECIPIENT_DELIMITER vaut par défaut[pepsi] RECIPIENT_DELIMITERet, à défaut,+(nonedésactive le retrait de sous-adresse).- HELPER
Le helper de
~/.forwardprivilégié à exécuter. Par défautpepsi-helper-dot-forward(résolu sur le$PATH) ; indiquez un chemin absolu pour le redéfinir.- NEXT_STAGE
Où les destinataires passthrough (pas de
~/.forward) avancent. Obligatoire, car la plupart des destinataires n’ont pas de~/.forward. L’étape est normalement placée juste avant la remise locale, de sorte que NEXT_STAGE est l’étape de remise locale.- BOUNCE_STAGE
L’étape qui génère les DSN. Un destinataire y est acheminé lorsque l’exécution de son
~/.forwardéchoue. Sans elle, ce destinataire reste sur une ligne au statutfailed, avec le diagnostic dansstate.last_error, jusqu’à ce que pepsi-failure-bouncer(1) ou un opérateur la trouve.
95.1.14.1.8. Un fichier ~/.forward¶
Le helper lit au plus les 64 premiers Kio du ~/.forward de l’utilisateur. Les lignes vides et les lignes commençant par # sont ignorées ; une ligne peut contenir plusieurs entrées séparées par des virgules, et une entrée peut être placée entre guillemets doubles (une virgule à l’intérieur des guillemets ne sépare pas), comme dans le "|exec /usr/bin/procmail" documenté par procmail. Chaque entrée est l’une des suivantes :
une adresse e-mail — collectée et utilisée comme nouveau destinataire. Un nom nu comme
alicedésigne ce compte sur ce site : il est qualifié avec le domaine du destinataire, de sorte quealicedans un courrier àbob@example.comdevientalice@example.com;\name— le marqueur sendmail « remettre à name et ne pas l’étendre davantage ». L’adresse n’est pas redémarrée à RESTART_STAGE : si elle nomme le compte du destinataire lui-même (le\bobcanonique dans~bob/.forward, la façon dont un utilisateur garde une copie locale tout en redirigeant), ce destinataire reste simplement sur le message et avance vers NEXT_STAGE. Tout autre\namedevient une ligne sœur à NEXT_STAGE ; un nom seul est qualifié par le domaine du destinataire. Comme un tel destinataire ne repasse jamais par cette étape, le marqueur ne peut pas créer de boucle non bornée. Notez qu’il contourne aussi le~/.forwardde cet utilisateur, ce qui est précisément le sens de « ne pas étendre davantage » ;|command— lorsque ALLOW_PIPE est activé, le message est envoyé par tube à/bin/sh -c commandexécuté en tant que l’utilisateur, dans un groupe de processus qui lui est propre et avec un environnement construit de zéro :HOME,USER,LOGNAMEetSHELLd’après l’entrée passwd de l’utilisateur etPATHfixé à/usr/local/bin:/usr/bin:/bin; rien n’est hérité de l’étape ;/absolute/path— lorsque ALLOW_FILE est activé, le message est ajouté à ce fichier (style mbox) en tant que l’utilisateur.
Un nom nu redémarre à RESTART_STAGE comme toute autre adresse, de sorte que le propre nom du destinataire revient à cette étape comme une boucle de redirection et rebondit. Pour conserver une copie locale, écrivez \name.
Une |command dispose de 300 secondes pour se terminer, après quoi tout son groupe de processus est tué et le destinataire est réessayé comme pour une commande qui a quitté avec 75 (un agent de remise lent ne nous apprend rien sur le destinataire, et le faire rebondir jetterait du courrier qui aurait été accepté une minute plus tard). L’étape à son tour abandonne et tue un helper qui n’a pas fini au bout de 330 secondes, et signale ce cas comme une erreur réessayable plutôt que comme un rebond. Les deux limites sont des constantes de compilation, et non de la configuration. Elles existent pour qu’un |sleep infinity d’un seul compte, ou une directive de fichier nommant une FIFO, ne puisse pas occuper indéfiniment un worker du dispatcher, et pour que PARALLELISM comptes de ce genre ne puissent pas arrêter l’étape. Une directive de fichier doit nommer un fichier ordinaire ; une FIFO, un périphérique ou un lien symbolique est refusé.
95.1.14.1.9. Installation et privilèges¶
Pour atteindre le helper setuid-root, pepsi-stage-dot-forward doit lui-même être installé set-group-id au groupe pepsi-forward, avec le mode 2550 et le propriétaire pepsi:pepsi-forward. Ce mode le rend exécutable par le propriétaire et non par tous, car le bit setgid est la barrière devant le helper setuid-root. Le droit d’exécution ne peut pas non plus venir des bits de groupe, puisque pepsi n’est délibérément pas membre du groupe ; il vient donc du propriétaire. pepsi-dispatch(1) exécute l’étape en tant qu’utilisateur de service pepsi non privilégié. Le bit setgid donne au worker un gid effectif de pepsi-forward, et c’est exactement ce qui lui permet d’exécuter le pepsi-helper-dot-forward(1) restreint au groupe ; rien d’autre sur l’hôte n’obtient cette capacité. make install met cela en place (son étape install-forward-stage), à condition d’être exécuté en tant que root et que le groupe pepsi-forward existe ; sinon il imprime les commandes exactes à exécuter à la main.
Comme le bit setgid est cette barrière, le programme applique lui-même la même règle. Lorsqu’il s’exécute avec ce bit et que l’utilisateur réel n’est ni root ni le compte de service pepsi, il sort en erreur avant qu’aucune configuration ne soit lue. Comme les étapes de cryptographie setuid, il retire aussi les variables d’environnement qui pilotent le chargement de la configuration (HOME, XDG_CONFIG_HOME, PG*, TALER_*, PEPSI_*) et fixe PATH à une valeur par défaut sûre. Le mode de fichier relève du déploiement et cette vérification relève du programme, si bien qu’aucun des deux n’a à assurer la protection seul.
Le chapitre Sécurité du manuel de Pepsi énumère chaque programme portant un bit setuid ou setgid et pourquoi ; son chapitre Modèle de menace énonce ce qu’un compte local peut ou ne peut pas obtenir par leur biais.
95.1.14.1.10. Voir aussi¶
pepsi-helper-dot-forward(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-aliases(1), pepsi-stage-bounce(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7)
95.1.14.1.11. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.