60. pepsi-stage-if¶
Brancher le pipeline selon une valeur d’état stockée.
60.1. Rôle¶
pepsi-stage-if est un embranchement programmable : elle teste l’égalité d’un membre du JSON state du message avec une valeur configurée et avance le message vers TRUE_STAGE lorsqu’ils sont égaux, sinon vers FALSE_STAGE. Elle permet à un opérateur d’acheminer selon n’importe quel verdict qu’une étape antérieure a noté — state.spam, state.auth.dkim, state.local_origin, … — sans écrire de code. Elle ne fait que déplacer la colonne stage ; elle ne réécrit jamais un message, ne le met jamais en pause et ne le fait jamais échouer, et laisse state intact. Référence : pepsi-stage-if(1).
60.2. Fonctionnalités¶
Chemins d’état pointés :
STATE_PATHest un chemin séparé par des points dansstate. Un segment sélectionne le membre d’un objet par son nom, ou l’élément d’un tableau par une position entière non négative — par exemplespam,auth.dkim,dsn.rcpt.0.notify.Comparaison textuelle scalaire : la valeur trouvée est comparée à
VALUEpar sa forme textuelle naturelle — une chaîne correspond à son texte, un booléen àtrue/false, un nombre à son rendu décimal, le null JSON au littéralnull.Faux si absent ou non scalaire : un chemin manquant, ou qui se résout en un tableau ou un objet (qui n’a pas de forme scalaire), n’est jamais égal et prend donc la branche
FALSE_STAGE.VALUEest obligatoire et ne peut pas être vide.Non destructif : le corps n’est jamais chargé et
state(y comprisstate.dsn) est préservé à travers la branche, de sorte que l’étape peut être placée n’importe où dans le graphe.
Un usage courant est de scinder le pipeline par direction : pepsi-ingress note state.local_origin = true pour une soumission authentifiée, de sorte qu’un test STATE_PATH = local_origin / VALUE = true envoie le courrier sortant sur un chemin de signature/relais et le courrier entrant sur le chemin de filtrage/remise (voir Démarrage sur un VPS bon marché).
Un autre est de retenir le courrier chiffré d’inconnus qu’aucune clé d’ici ne peut ouvrir, qui passerait sinon tous les filtres de contenu sous forme de texte chiffré : après pepsi-stage-check-whitelist, un if laisse passer les expéditeurs en liste blanche (spam = false) et un second envoie crypto.in.failure = no-decryption-key vers une étape de quarantaine ou de rejet silencieux (pepsi-stage-if(1) donne les sections). Il doit brancher uniquement sur « pas de clé ici », jamais sur un déchiffrement échoué, et ne doit jamais mener à un rebond : un acheminement qui dépend de ce qu’un texte chiffré AES-CBC modifié se déchiffre ou non est un oracle de remplissage (Oracles de remplissage et de format CBC contre S/MIME non authentifié, Le courrier non sollicité chiffré échappe aux filtres de contenu).
60.3. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-if, STATE_PATH (le chemin pointé à tester), VALUE (obligatoire, la valeur à laquelle comparer) et les cibles de branche TRUE_STAGE/FALSE_STAGE. pepsi-setup vérifie que les deux cibles de branche se résolvent en de vraies étapes, comme NEXT_STAGE. Voir pepsi-stage-if(1).
Les quatre options sont soumises aux paramètres par adresse : si l’étape figure dans les EDITABLE_STAGES d’une étape edit-settings, un correspondant peut rediriger son propre courrier vers l’une ou l’autre branche ou n’importe où ailleurs. N’inscrivez jamais une étape if qui protège une décision de sécurité (voir Les paramètres par adresse sont une frontière de confiance).
60.4. État¶
Entrées : l’unique membre de
statesélectionné parSTATE_PATH.Sorties : aucune — l’étape ne fait qu’avancer le message et laisse
stateinchangé.
60.5. Voir aussi¶
pepsi-stage-check-whitelist, pepsi-stage-bounce, Fonctionnalités prises en charge, Démarrage sur un VPS bon marché, pepsi-stage-if(1).