95.1.5. pepsi-stage-srs¶
rewrite the envelope sender with the Sender Rewriting Scheme
- Section du manuel:
1
95.1.5.1.1. Nom¶
pepsi-stage-srs - l’étape de réécriture d’expéditeur d’enveloppe SRS du pipeline Pepsi.
95.1.5.1.2. Synopsis¶
pepsi-stage-srs [GLOBAL-OPTIONS] worker
pepsi-stage-srs [GLOBAL-OPTIONS] forward ADDRESS
pepsi-stage-srs [GLOBAL-OPTIONS] reverse ADDRESS
95.1.5.1.3. Description¶
Cette étape a FUSION = yes par défaut : lorsque la fusion d’étapes est activée ([pepsi] ALLOW_FUSION, la valeur par défaut) et que cette étape est pliée dans le binaire pepsi unifié, un prédécesseur peut l’exécuter dans son propre processus worker plutôt que de la dispatcher séparément. Voir pepsi-dispatch(1) et pepsi.conf(5).
pepsi-stage-srs est un programme d’étape exécuté par pepsi-dispatch(1) comme un worker persistant lisant les identifiants de message sur l’entrée standard. Il implémente le Sender Rewriting Scheme (SRS).
Lorsque Pepsi redirige un message, il garde le corps intact mais le relaie depuis ses propres adresses IP. La vérification SPF du saut suivant voit alors Pepsi envoyer un courrier dont l’expéditeur d’enveloppe est encore le domaine de l’expéditeur original, qui n’autorise pas les IP de Pepsi, et la vérification échoue. SRS résout cela en réécrivant l’expéditeur d’enveloppe (MAIL FROM) en une adresse locale d’un domaine contrôlé par Pepsi (SRS_DOMAIN), qui encode l’expéditeur original et le signe par un HMAC :
SRS0=HHHH=TT=origin.example=alice@srs.example.net
SPF au saut suivant vérifie désormais srs.example.net, qui envoie légitimement depuis les IP de Pepsi. Le corps et ses signatures DKIM sont intacts. L’étape fait ensuite avancer le message vers son NEXT_STAGE (l’étape de remise). Outre l’expéditeur d’enveloppe, elle ne change que state.srs.original, où elle note l’expéditeur d’origine. Le reste du state de la ligne, y compris d’éventuels paramètres RFC 3461 dans state.dsn, reste intact pour que les étapes ultérieures l’honorent.
L’expéditeur nul (<>, c’est-à-dire un rebond de retour) n’est jamais réécrit, et un expéditeur déjà dans SRS_DOMAIN est laissé inchangé (la réécriture est idempotente). Un expéditeur qui est déjà une adresse SRS, parce que le message a atteint Pepsi via un autre redirecteur, est re-signé sous la forme compacte SRS1 plutôt qu’imbriqué, afin qu’un rebond remonte un redirecteur à la fois.
95.1.5.1.3.1. Un domaine dédié¶
SRS_DOMAIN doit être un domaine à part entière, non aligné au sens de DMARC avec un domaine que sert cet hôte. La réécriture s’applique à chaque message réexpédié, quel que soit son résultat DMARC à l’arrivée, et la réussite SPF qu’elle obtient au saut suivant est une réussite pour SRS_DOMAIN. Si ce domaine s’aligne avec le domaine du From: du message, parce qu’il est le domaine servi lui-même, un sous-domaine ou un parent de celui-ci, la réussite est alignée, et DMARC réussit sur elle seule. Prenons un message falsifié au nom d’un domaine servi, reçu de l’extérieur (où il a échoué à DMARC) et envoyé à une adresse qui réexpédie. Il quitterait alors cet hôte en réussissant DMARC : la réexpédition blanchit la contrefaçon. Avec un domaine dédié, SPF réussit encore, mais ne s’aligne pas avec le From:, de sorte que DMARC au saut suivant doit reposer sur la propre signature DKIM de l’auteur, qu’une réexpédition fidèle conserve et qu’une contrefaçon n’a jamais eue. (La signature que pepsi-stage-dkim-sign(1) peut ajouter au courrier réexpédié est retenue pour un message qui a échoué à DMARC à l’arrivée, de sorte qu’elle ne peut pas non plus en blanchir un.)
pepsi-setup(1) refuse donc un SRS_DOMAIN aligné avec une entrée d”ACCEPTED_DOMAINS ou une autre identité d’envoi, sauf si [pepsi-srs] ALLOW_ALIGNED_DOMAIN = yes l’accepte. Il émet alors un avertissement qui nomme ce qui ferme la voie (aspf=s dans l’enregistrement DMARC du domaine servi pour un sous-domaine, ou un p= contraignant avec [pepsi-ingress] DMARC_ENFORCE = yes), et pepsi-setup check vérifie ce point contre le DNS réel. L’assistant demande un domaine dédié au lieu de proposer par défaut le domaine principal. L’opérateur publie le DNS du domaine : un enregistrement MX pointant vers cet hôte (voir ci-dessous), et l’enregistrement SPF que pepsi-setup(1) affiche pour lui, comme pour toute identité d’envoi. Personne n’écrit de courrier depuis ce domaine, de sorte que son enregistrement DMARC peut indiquer p=reject. Lorsque l’assistant importe un serveur de courrier existant et qu’un postsrsd installé à côté réécrit déjà vers un domaine, ce domaine est proposé par défaut (les rebonds du courrier réexpédié avant la migration lui sont adressés) ; un domaine aligné y est refusé aussi. Le raisonnement est exposé sous « Forwarded forgeries of our own domain » dans le chapitre sécurité du manuel de Pepsi.
95.1.5.1.3.2. Sens inverse¶
pepsi-ingress(1) effectue l’autre moitié de SRS au moment du RCPT, et non ce programme : il reconnaît un rebond renvoyé à une adresse SRS, vérifie sa signature et son horodatage, décode l’expéditeur original et y relaie le rebond. Un destinataire dans SRS_DOMAIN dont la partie locale est un jeton SRS valide est accepté et réécrit en l’expéditeur original (même si le domaine de cet expéditeur n’est pas un domaine que Pepsi sert : la signature valide autorise le relais) ; un jeton falsifié ou expiré est rejeté avec 550. Les deux sens lisent la même configuration partagée [pepsi-srs], de sorte que le secret et le domaine correspondent.
Cette moitié est ce qui fait de SRS_DOMAIN un domaine qui doit recevoir du courrier, et non seulement un domaine sous lequel cette machine envoie. Réécrire l’expéditeur d’enveloppe fait de Pepsi la destination des rejets d’un message qu’il n’a pas écrit ; si le domaine ne publie ni MX ni enregistrement d’adresse, le rejet qui revient est abandonné par le MTA qui a tenté de l’envoyer et l’auteur d’origine n’est jamais informé. pepsi-setup(1) le vérifie à chaque exécution, dans ses recoupements DNS, parce que les enregistrements SPF et DMARC du domaine paraissent complets sans lui.
95.1.5.1.3.3. Copies réexpédiées¶
Une copie qu’un alias (pepsi-stage-aliases(1)) ou un ~/.forward (pepsi-stage-dot-forward(1)) envoie hors site ne reçoit pas d’adresse SRS. Un tel destinataire porte state.dsn.rcpt[].expanded_from (l’adresse qu’a utilisée l’expéditeur), et la ligne part avec une adresse de retour de réexpédition à la place :
fwd+<sealed record>=<tag>@srs.example.net
L’enregistrement est chiffré et authentifié avec des clés dérivées du secret SRS (HMAC-SHA256 selon le schéma SIV, une étiquette de 80 bits ; l’adresse est en base32 minuscule). Il contient l’expéditeur d’enveloppe d’origine, l’adresse qu’a utilisée l’expéditeur, si le message est arrivé chiffré, si l’expéditeur était authentifié, le NOTIFY de l’expéditeur pour ce destinataire et le jour où il a été émis ; rien de tout cela n’est lisible dans l’adresse. Un rapport qu’un hôte distant envoie au sujet de la copie revient à pepsi-ingress(1). L’ingress ne l’accepte que de l’expéditeur nul et seulement tant que l’enregistrement se vérifie et date de moins de MAX_AGE_DAYS ; il y répond par un DSN propre à cet hôte au sujet de l’adresse qu’a utilisée l’expéditeur. Le rapport distant est journalisé puis abandonné, car il révélerait la cible de la réexpédition, la réponse de l’hôte qui se trouve derrière et, pour un message arrivé chiffré, le contenu déchiffré. Une adresse SRS aurait relayé ce rapport à l’expéditeur sans modification.
L’adresse est sans état (rien n’est stocké) et donc longue : deux adresses ne tiennent pas dans les 64 octets que la RFC 5321 accorde à une partie locale, et une adresse typique fait de 80 à 120 caractères, comme l’adresse SRS d’un long expéditeur. Sa longueur n’est pas plafonnée : un prochain saut qui refuse un long expéditeur d’enveloppe fait échouer la remise, et le DSN que cet hôte écrit alors nomme l’adresse qu’a utilisée l’expéditeur, comme tout autre DSN. Une adresse SRS à sa place permettrait à quiconque choisit un long expéditeur d’enveloppe de rouvrir le chemin que ferme l’adresse de retour de réexpédition. Seul un expéditeur qui ne peut pas du tout être scellé (plus de 254 octets) fait partir la copie avec l’expéditeur nul, avec un avertissement dans le journal. L’expéditeur nul lui-même n’est jamais réécrit, de sorte qu’un rebond réexpédié conserve <> ; un expéditeur déjà dans SRS_DOMAIN est laissé tel quel.
L’expéditeur d’enveloppe est unique par ligne. Une ligne dont les destinataires nécessiteraient des expéditeurs différents, comme une copie réexpédiée et un relais ordinaire, ou des copies pour deux alias différents, est donc d’abord scindée en une ligne par destinataire, chacune revenant seule à cette étape.
95.1.5.1.4. Configuration¶
L’étape n’a besoin que d’un NEXT_STAGE dans sa propre section [stage-<name>] (PROGRAM = pepsi-stage-srs) ; les paramètres SRS (SRS_DOMAIN, SECRET/SECRET_FILE, PREVIOUS_SECRET_FILE, MAX_AGE_DAYS, ALLOW_ALIGNED_DOMAIN) résident dans la section [pepsi-srs], que l’étape partage avec pepsi-ingress(1). Tous sont documentés dans pepsi.conf(5). Omettre [pepsi-srs] désactive SRS : un worker de cette étape refuse alors de démarrer (comme lorsque le secret ne peut être lu), de sorte que le dispatcher garde en file les messages qui lui sont destinés jusqu’à ce que la configuration soit corrigée plutôt que de les mettre en échec, et pepsi-ingress(1) traite les destinataires d’apparence SRS comme des adresses ordinaires. Le secret est relu pour chaque message, de sorte qu’un secret renouvelé ne demande aucun redémarrage ; s’il devient illisible pendant qu’un worker tourne, le message est réessayé avec un back-off (voir pepsi-dispatch(1)). L’étape signe avec le seul SECRET ; PREVIOUS_SECRET_FILE nomme des secrets retirés que pepsi-ingress(1) accepte encore sur les adresses qui reviennent, de sorte que le secret peut être remplacé sans casser les adresses déjà en circulation.
95.1.5.1.5. État¶
Entrées : la colonne mail_from ; state.dsn.rcpt[].expanded_from et .notify (quels destinataires sont des copies réexpédiées), state.crypto.in et l’enregistrement d’authentification state.auth / state.local_origin (scellés dans une adresse de retour de réexpédition).
Sorties : state.srs.original, l’expéditeur d’enveloppe que la réécriture a remplacé. Rien d’autre dans state n’est touché ; state.dsn et le reste sont préservés inchangés. La disposition de l’état est décrite dans pepsi.state(7).
Cette unique clé existe pour un DSN que Pepsi émet après le passage de cette étape, ce qu’est tout DSN sur un chemin de relais : cette étape précède nécessairement l’étape de remise, de sorte que pepsi-stage-bounce(1) adresserait sinon le rapport à notre propre alias SRS et lui ferait faire un aller-retour vers le saut suivant puis de nouveau vers l’intérieur par notre MX pour être décodé. L’étape de rebond lit ceci plutôt que d’inverser l’alias, ce qui garde le secret SRS hors d’une étape qui ne fait que composer du courrier. Elle n’est écrite que lorsqu’elle est absente, de sorte qu’un message réécrit deux fois conserve l’adresse qui nomme un correspondant réel plutôt que l’alias intermédiaire.
Transitions : avance vers NEXT_STAGE, que l’expéditeur d’enveloppe ait été réécrit ou passé sans changement (un expéditeur nul, ou un déjà dans SRS_DOMAIN). Une ligne dont les destinataires nécessitent des expéditeurs d’enveloppe différents est scindée en un destinataire par ligne et remise en file à cette étape. L’étape ne met jamais en pause, n’échoue, ne réachemine ni ne termine.
95.1.5.1.6. Commandes¶
Exécuté comme worker, le programme réécrit l’expéditeur d’enveloppe de chaque message et le fait avancer. Les sous-commandes sont des outils d’opérateur :
- forward ADDRESS
Imprimer la réécriture SRS de ADDRESS (le sens direct) et quitter. Utile pour inspecter ce que devient un expéditeur donné.
- reverse ADDRESS
Décoder et vérifier ADDRESS (une adresse SRS ou une partie locale nue) et imprimer l’expéditeur original, ou échouer si ce n’est pas une adresse SRS valide.
95.1.5.1.7. Options globales¶
- -c FILE, –config FILE
Lit la configuration depuis FILE au lieu du chemin de recherche par défaut.
- -L LOGLEVEL, –log LOGLEVEL
Règle la verbosité de journalisation (
error,warn,info,debug,trace; par défaut[pepsi] LOG, sinoninfo).- -h, –help
Affiche un résumé d’utilisation et quitte.
- -V, –version
Affiche la version et quitte.
95.1.5.1.8. Code de sortie¶
L’issue de chaque message est signalée à pepsi-dispatch(1) sur la ligne d’état du worker, et non par le code de sortie.
- 0
Le worker a tourné jusqu’à la fermeture de son entrée standard, ou la sous-commande forward / reverse a réussi.
- 1
Une erreur fatale s’est produite (configuration illisible, base de données impossible à ouvrir, échec de l’entrée/sortie standard, ou reverse a reçu une adresse qui n’est pas une adresse SRS valide). La raison est écrite dans le journal.
- 78
Le worker a refusé de démarrer :
[pepsi-srs]manque, ne s’analyse pas ou son secret ne peut pas être lu (ou le schéma de la base de données ne correspond pas à ce binaire). Le dispatcher remet en file ce qu’il lui avait confié et réessaie l’étape plus tard.
95.1.5.1.9. Exemples¶
Montrer en quoi un expéditeur est réécrit
pepsi-stage-srs -c /etc/pepsi/pepsi.conf forward alice@origin.example
Décoder une adresse de rebond renvoyée
pepsi-stage-srs -c /etc/pepsi/pepsi.conf reverse 'SRS0=HHHH=TT=origin.example=alice@srs.example.org'
95.1.5.1.10. Voir aussi¶
pepsi-config(1), pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-internet(1), pepsi-stage-bounce(1), pepsi-stage-dkim-sign(1), pepsi-dispatch(1), pepsi-ingress(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)
95.1.5.1.11. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.