36. pepsi-stage-srs¶
Sender Rewriting Scheme — faire réussir SPF au saut suivant.
36.1. Rôle¶
pepsi-stage-srs réécrit l’expéditeur d’enveloppe en une adresse locale d’un SRS_DOMAIN contrôlé par Pepsi afin que la vérification SPF du saut suivant réussisse. Le sens inverse (décoder les rebonds renvoyés à une adresse SRS) est assuré par pepsi-ingress au moment du RCPT. Les deux lisent la section partagée [pepsi-srs]. Référence : pepsi-stage-srs(1).
36.2. Fonctionnalités¶
Réécriture directe :
MAIL FROMdevientSRS0=HHHH=TT=domain=local@srs, signant en HMAC l’expéditeur original et apposant un horodatage à granularité journalière ; le MAC tronqué est encodé en base32 (RFC 4648).Re-signature compacte : une adresse qui est déjà SRS (le courrier a atteint Pepsi via un autre redirecteur) est re-signée sous la forme
SRS1plutôt qu’imbriquée, de sorte qu’un rebond remonte un redirecteur à la fois.Idempotent / sûr : l’expéditeur nul (un rebond de retour) n’est jamais réécrit, et un expéditeur déjà dans
SRS_DOMAINest laissé inchangé.Décodage inverse (dans l’ingress) : un destinataire qui est un jeton SRS valide est vérifié (signature + horodatage) et relayé vers l’expéditeur original décodé, même en dehors des domaines servis ; un jeton falsifié/expiré est rejeté
550.Adresse de retour de réexpédition pour les copies réexpédiées : un destinataire produit par un alias ou un
~/.forward(state.dsn.rcpt[].expanded_from) part au contraire avecfwd+<sealed>=<tag>@srs, qui scelle l’expéditeur d’origine, l’adresse qu’a utilisée l’expéditeur, l’indicateur d’arrivée chiffrée, l’authentification et leNOTIFYde l’expéditeur, et le jour. Un rapport distant au sujet de la copie reçoit alors de pepsi-ingress une réponse sous forme du propre DSN de cet hôte au sujet de l’adresse qu’a utilisée l’expéditeur, jamais relayé (Les adresses de retransmission dans les rapports de remise). Une ligne dont les destinataires nécessitent des expéditeurs d’enveloppe différents est d’abord scindée en un destinataire par ligne.Corps intact : seul l’expéditeur d’enveloppe change ; les hachages de corps DKIM survivent.
Outils d’opérateur : les sous-commandes
forward/reversecalculent une réécriture ou décodent une adresse à la main.
36.3. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-srs et NEXT_STAGE. Les paramètres SRS sont partagés dans [pepsi-srs] : SRS_DOMAIN, SECRET/SECRET_FILE (la clé HMAC ; doit rester stable et identique entre instances), PREVIOUS_SECRET_FILE (des clés retirées qui vérifient encore les adresses qui reviennent mais ne signent rien, afin que la clé puisse être renouvelée : Rotating the SRS key dans Exploiter Pepsi), MAX_AGE_DAYS (fenêtre de validité, 21 par défaut) et ALLOW_ALIGNED_DOMAIN. SRS_DOMAIN doit être un domaine dédié qui n’est aligné au sens de DMARC avec aucun domaine servi. La réussite SPF qu’obtient une réexpédition au saut suivant vaut pour ce domaine. S’il était aligné, un message falsifié d’un domaine servi réussirait DMARC une fois réexpédié d’ici. pepsi-setup refuse un domaine aligné sauf si ALLOW_ALIGNED_DOMAIN = yes (voir Forwarded forgeries of our own domain dans Modèle de sécurité, qui soutient Un expéditeur distant) ; lorsque l’assistant importe un serveur doté d’un postsrsd, son domaine SRS devient la valeur par défaut. Omettre [pepsi-srs] désactive SRS : le worker refuse alors de démarrer et le dispatcher retient ses messages. N’inscrivez jamais l’étape dans EDITABLE_STAGES : elle protège la réputation du domaine, pas une préférence d’utilisateur (Les paramètres par adresse sont une frontière de confiance). Voir pepsi-stage-srs(1).
36.4. État¶
Entrées : la colonne
mail_from;state.dsn.rcpt[].expanded_fromet.notify,state.crypto.inet l’enregistrement d’authentification (state.auth,state.local_origin), que scelle une adresse de retour de réexpédition.Sorties :
state.srs.original— l’expéditeur d’enveloppe tel qu’il était avant la réécriture, écrit uniquement lorsqu’une réécriture a eu lieu et seulement si la clé n’y est pas déjà (de sorte qu’une seconde passeSRS1conserve le premier correspondant réel). Lorsque ce déploiement émet un DSN, pepsi-stage-bounce l’adresse à cet expéditeur plutôt qu’à notre propre alias SRS. Tout le reste destate, y comprisstate.dsn, est préservé.
36.5. Voir aussi¶
pepsi-ingress, pepsi-stage-relay-to-internet, Fonctionnalités prises en charge, pepsi-stage-srs(1).