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 FROM devient SRS0=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 SRS1 plutô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_DOMAIN est 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 avec fwd+<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 le NOTIFY de 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/reverse calculent 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_from et .notify, state.crypto.in et 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 passe SRS1 conserve 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 de state, y compris state.dsn, est préservé.

36.5. Voir aussi

pepsi-ingress, pepsi-stage-relay-to-internet, Fonctionnalités prises en charge, pepsi-stage-srs(1).