95.3.1. pepsi.state¶
per-message state object carried through the Pepsi pipeline
- Section du manuel:
7
95.3.1.1.1. Nom¶
pepsi.state - l’objet JSON state attaché à chaque message Pepsi.
95.3.1.1.2. Description¶
Chaque message en transit est une ligne de la table pepsi.workqueue. Outre l’enveloppe et le corps du message, chaque ligne porte un objet JSON de forme libre — la colonne state (JSONB PostgreSQL) — qui voyage avec le message depuis l’ingress jusqu’à son étape terminale. Le state est le seul canal par lequel les étapes du pipeline communiquent : une étape enregistre un verdict ou un élément de provenance, une étape ultérieure le lit.
Cette page documente la disposition de cet objet : les clés que les étapes standard écrivent, quand elles sont écrites, et quelles étapes les consomment. C’est une référence de format de données, indépendante de toute configuration ; le graphe du pipeline et les options qui pilotent chaque étape sont décrits dans pepsi.conf(5).
95.3.1.1.3. Sémantique de fusion¶
state est construit de façon incrémentale. Chaque helper terminal d’étape qui modifie une ligne fusionne ses nouvelles clés dans l’objet existant (les fonctions SQL terminales évaluent state || $new), plutôt que de le remplacer. Par conséquent, une clé écrite tôt survit pendant toute la durée de vie du message, à moins qu’une étape ne réécrive délibérément cette clé précise ; c’est le cas de la provenance origin semée par l’ingress et des paramètres dsn.
La fusion est superficielle : state || {"auth": {"arc": "pass"}} remplacerait tout l’objet auth, et pas seulement son membre arc. Les étapes qui mettent à jour un membre d’un objet imbriqué lisent donc l’objet courant, l’amendent et le réécrivent en entier (c’est ce que font set_auth_verdict/set_auth_fields pour auth.arc).
La seule réécriture structurelle est dsn.rcpt, qui est un tableau parallèle à rcpt_to : chaque helper qui réduit une ligne à un sous-ensemble de ses destinataires, ou éclate un groupe sur une ligne sœur, redécoupe ce tableau de concert, et l’étape d’alias le reconstruit lorsqu’elle écrit une liste de destinataires entièrement nouvelle. Une étape ne doit jamais toucher à rcpt_to sans passer par ces helpers.
Il existe exactement une exception : pepsi-stage-bounce(1) remplace state par un retry_since isolé (ci-dessous), en ne gardant qu’une étiquette tls_required valant "required", lorsqu’il réécrit un message en notification d’état de remise, car le rebond est un tout nouveau message à expéditeur nul qui n’hérite d’aucune provenance de l’original.
95.3.1.1.4. Clés de premier niveau¶
Les clés ci-dessous sont écrites par le pipeline standard. Une étape qui ne reconnaît pas une clé la laisse simplement intacte (la règle de fusion la préserve), de sorte que l’ensemble est ouvert ; des étapes personnalisées peuvent ajouter les leurs.
95.3.1.1.4.1. origin¶
(objet) Les métadonnées d’origine SMTP de la connexion qui a remis le message, semées par pepsi-ingress(1). Elles sont lues par pepsi-stage-arc(1) (qui a besoin de l”authserv_id et du fragment ar_results rendu pour reproduire l’identité Authentication-Results de l’ARC sans réexécuter SPF/DKIM/DMARC) et par les étapes de relais, dont la décision de rétrogradation 8BITMIME/SMTPUTF8 par saut consulte les déclarations BODY=/smtputf8 originales
{
"origin": {
"remote_ip": "203.0.113.7", // connecting client IP (null for local injection)
"helo": "mail.example.com", // HELO/EHLO name announced by the client
"esmtp": true, // client used EHLO (ESMTP) rather than HELO
"smtputf8": false, // SMTPUTF8 requested on MAIL FROM
"body_8bit": false, // BODY=8BITMIME declared on MAIL FROM (RFC 6152);
// cleared by pepsi-stage-dkim-sign once it has
// converted the body to 7-bit
"declared_size": 12345, // SIZE= declared on MAIL FROM (null if absent)
"tls": { "version": "TLSv1.3",
"cipher": "TLS13_AES_128_GCM_SHA256",
"sni": "mx.example.net" }, // null on a cleartext session
"listener": { "local_addr": "0.0.0.0:25", "mode": "starttls" },
"reverse_dns": "host.example.com", // PTR name of remote_ip (null if none)
"iprev": "pass", // RFC 8601 iprev / FCrDNS verdict
"ip_blocklist": { "listed": true, // the downloaded IP blocklists' verdict
"lists": { "blocklist-de-mail": true } },
// (absent unless a list was consulted)
"auth_method": "sasl", // how the session authenticated (null if not)
"auth_mechanism": "PLAIN", // SASL mechanism (sasl sessions only)
"auth_identity": "alice", // authentication id / peer login
"auth_authzid": null, // authorization id, when distinct
"from_bound": true, // From: bound to the account (see below)
"authserv_id": "mail.example.org", // this receiver's id (for pepsi-stage-arc)
"ar_results": ";\r\n\tdkim=pass header.d=example.com;\r\n\tdmarc=pass ..."
// rendered Authentication-Results body, reused by
// pepsi-stage-arc for the AAR (no SPF/DKIM/DMARC re-run)
}
}
Les quatre membres auth_* décrivent comment la session s’est identifiée, par opposition à la clé voisine auth ci-dessous, qui porte sur ce que le message prétend. Ils sont notés parce que local_origin est un unique booléen et confond deux affirmations très différentes : « un compte que nous avons authentifié a soumis ceci » et « ceci est arrivé d’une adresse que nous avons choisi de croire ». Une étape de politique ne peut pas retrouver cette distinction à partir du booléen, pas plus qu’un milter, à qui ces membres sont remis sous forme des macros RFC 4954 {auth_type} / {auth_authen} / {auth_author} / {auth_ssf}.
auth_methodComment la session s’est authentifiée :
sasl(unAUTHRFC 4954 a réussi),peercred(un pair de socket UNIX dont l’uid s’est résolu en un login autorisé),client-cert(un certificat client TLS a correspondu à un épinglage) oumynetworks(l’adresse du pair figure dansMYNETWORKS).nulllorsque la session ne s’est pas authentifiée. UnAUTHSASL ultérieur écrase une méthode antérieure établie à la connexion : c’est la prétention la plus forte, et la seule qui porte un nom d’utilisateur.auth_mechanismLe mécanisme SASL qui a réussi (
PLAIN,LOGIN), en majuscules. Positionné uniquement pourauth_method = sasl. Les méthodes non SASL le laissent ànullplutôt que de placer un jeton qui n’est pas un mécanisme dans un champ qu’un filtre compare peut-être à une liste de mécanismes réels.auth_identityL’identité d’authentification : l”authcid SASL, ou le login auquel l’uid d’un pair UNIX s’est résolu.
nullpourmynetworksetclient-cert, qui authentifient une adresse ou une clé et ne nomment personne.peercredproduit donc une identité sans mécanisme — la description honnête d’une session que le noyau, et non SASL, a authentifiée.auth_authzidL’identité d’autorisation, notée seulement lorsque le client a demandé à agir en tant que quelqu’un d’autre que celui en tant que qui il s’est authentifié (le champ authzid de SASL
PLAIN).nulllorsque les deux coïncident, ce qui est le cas normal : la RFC 4954 permet une authzid vide et les clients y répètent couramment l’authcid.from_boundtruelorsque le champFrom:nomme exactement une boîte aux lettres et que cette boîte a correspondu à une entréeUSERNAME_MAPconcrète (sans joker) du compte authentifié, ou à sonlogin@HOSTNAMEpar défaut ;falsesinon, y compris pour une session sans aucune autorisation de compte. Être autorisé à envoyer en tant qu’une adresse suffit pour envoyer ; être lié à elle est ce qui permet à une soumission de parler en son nom. pepsi-stage-encrypt(1) n’enregistre une clé tirée du message, ou n’exécute une commande de clé par e-mail, que lorsqueauth_methodvautmynetworksouclient-cert, ou vautsasl/peercredavecfrom_bound = true: un compte autorisé pour*@example.orgpeut envoyer au nom de ses collègues, mais ne doit pas pouvoir implanter une clé pour eux.ip_blocklistCe que disent de
remote_iples listes de blocage IP téléchargées par pepsi-reputation(1) :listedvauttruelorsqu’au moins une liste la nomme, etlistsa un membretruepour chaque liste qui la nomme. Consigné seulement pour une session non authentifiée venant du réseau, et seulement lorsqu’au moins une liste activée était assez récente pour être consultée (MAX_AGE) ; sinon le membre est absent, de sorte que « inconnu » n’est jamais confondu avec « propre ». Acheminez selon lui avec pepsi-stage-if(1) :STATE_PATH = origin.ip_blocklist.listed,VALUE = true, ouorigin.ip_blocklist.lists.NAMEpour une seule liste.
95.3.1.1.4.2. auth¶
(objet) Les verdicts d’authentification entrante que l’ingress a calculés, également reflétés dans l’en-tête Authentication-Results ajouté en tête. Le verdict arc est semé comme none et écrasé par pepsi-stage-arc(1) une fois qu’il réévalue la chaîne ARC entrante (ses voisins spf/dkim/dmarc sont laissés intacts). Lu par pepsi-stage-check-whitelist(1), dont la barrière dkim_required accepte une ligne sur auth.dkim = pass, ou sur auth.arc = pass seulement conjointement avec auth.dmarc = pass, et dont la barrière sealer_domain ne consulte auth.arc_sealers que lorsque auth.arc vaut pass
{
"auth": {
"spf": "pass", // SPF verdict (pass/fail/softfail/neutral/temperror/permerror/none)
"dkim": "pass", // DKIM verdict ("pass" only for a signature aligned with From:)
"dkim_temperror": ["example.org"], // d= of signatures with a temporary error; absent if none
"dmarc": "pass", // DMARC verdict (pass/fail/temperror/permerror; none = no record)
"arc": "none", // inbound ARC chain verdict (filled in by pepsi-stage-arc)
"arc_sealers": [] // d= of each inbound ARC-Seal (filled in by pepsi-stage-arc)
}
}
auth.dmarc_policy (chaîne, facultatif) est la politique DMARC que publie le domaine du From:, none, quarantine ou reject (la plus stricte lorsque le champ nomme plusieurs domaines), consignée quel que soit le verdict ; elle est absente lorsqu’aucun domaine d’auteur ne publie d’enregistrement. pepsi-stage-list-post(1) fonde sur elle son atténuation DMARC.
auth.display_name_mismatch (chaîne, facultatif) n’est présent que sur le courrier d’une session non authentifiée dont le nom d’affichage du From: (ou un commentaire dans le champ) nomme une adresse autre que celle de sa propre boîte aux lettres : il contient cette adresse revendiquée, en minuscules. L’ingress ajoute alors aussi en tête X-Pepsi-Warning: display-name-claims-other-address. Voir pepsi-ingress(1), Authentification.
auth.warnings (tableau de chaînes, facultatif) liste chaque valeur X-Pepsi-Warning que l’ingress a écrite sur le message, dans l’ordre des en-têtes : display-name-claims-other-address, from-has-bidi-or-invisible-characters (un From: portant un contrôle bidirectionnel ou un caractère invisible), from-domain-resembles-served-domain (un domaine From: ayant le squelette d’un domaine servi mais un autre nom), attachment-name-has-bidi-or-invisible-characters (un nom de fichier de pièce jointe portant un tel caractère), duplicate-header-date, duplicate-header-subject, duplicate-header-to, duplicate-header-cc, duplicate-header-reply-to et duplicate-header-sender (des copies différentes de ce champ d’en-tête de message acceptées : toujours pour Cc, pour les autres sous MIME_ANOMALIES = log), from-ambiguous (un From: qui ne peut pas être lu d’une seule façon, ou qui nomme des boîtes aux lettres dans plusieurs domaines), served-domain-not-authenticated (un From: dans un domaine servi venant de l’extérieur sans réussite DMARC, DKIM alignée ou SPF alignée), served-sender-not-authenticated (un Sender: dans un domaine servi sans réussite DKIM ou SPF alignée) et dmarc-fail-not-enforced (un fail DMARC sur lequel la configuration n’a pas agi). Absent lorsqu’aucune n’a été écrite, et jamais présent sur le courrier d’une session authentifiée. Les quatre dernières placent aussi l’étiquette [external] sur le Subject sauf si EXTERNAL_SUBJECT_TAG = no. Voir pepsi-ingress(1), Marquage du courrier venu de l’extérieur.
95.3.1.1.4.3. local_origin¶
(booléen) Semé par l’ingress : true lorsque la session de remise a été authentifiée (le client était dans MYNETWORKS, a mené à bien un AUTH SASL, a présenté un certificat client TLS correspondant, ou — sur une socket UNIX avec AUTH_PEERCRED, qui y est la valeur par défaut — était un pair dont l’uid s’est résolu en un login autorisé, le chemin que prend tout message soumis localement ; voir les sections [pepsi-ingress-listener-*] dans pepsi.conf(5)), false sinon. Il marque le courrier provenant d’un expéditeur de confiance et est préservé à travers le pipeline pour que les étapes en aval le testent (la couche de paramètres par adresse s’indexe sur l”expéditeur pour les messages local_origin, et pepsi-stage-edit-settings(1) et le rôle de libre-service de wallet de pepsi-stage-auto-pay(1) ne traitent un message comme un message de contrôle que lorsqu’il est local_origin).
95.3.1.1.4.4. notice¶
(objet) {"kind": KIND}, écrit seulement par le composant qui a composé le message, sur un message que Pepsi a écrit lui-même : enrol (le lien de connexion à la console, pepsi-httpd(1)), secure-link (les notifications de lien, de PIN et d’accusé du portail), secretary (le défi et l’avis de confirmation), payment-request (pepsi-stage-anti-spam(1)), wallet (la réponse de libre-service de pepsi-stage-auto-pay(1)), settings (la réponse de pepsi-stage-edit-settings(1)), keys (les réponses aux commandes de clés et les avis de clés de pepsi-stage-encrypt(1)), key-change (l’avis de pepsi-stage-autocrypt-learn(1)) et vacation (pepsi-stage-vacation(1)). secretary, payment-request et vacation vont à un tiers et sont laissés non marqués tant qu’une redéfinition par adresse s’applique au message qui les a provoqués. Lu par pepsi-stage-encrypt(1) sous NOTICE_SIGNER, qui signe exactement les messages marqués avec l’identité d’avis du déploiement. Jamais présent sur le courrier venu du réseau, sur les réponses du portail, le courrier de liste, les rebonds ou les rapports TLS.
95.3.1.1.4.5. dsn¶
(objet) Les paramètres de notification d’état de remise RFC 3461 que l’expéditeur a demandés, semés par l’ingress : les ret/envid au niveau du message et un tableau par destinataire parallèle à rcpt_to de notify/orcpt. Chaque étape doit le préserver et l’honorer — les étapes de relais ne transmettent les paramètres au saut suivant que lorsqu’il annonce DSN, et pepsi-stage-bounce(1) consulte le notify par destinataire pour décider s’il émet ou non un rapport. L’entrée d’un destinataire porte aussi sa valeur RRVS= RFC 7293, telle quelle, sous rrvs : ce n’est pas un paramètre DSN, mais elle est par destinataire et maintenue alignée avec rcpt_to de la même manière. La remise locale la teste, les étapes de relais la transmettent (voir pepsi-ingress(1)), et une cible d’alias ou de ~/.forward n’en hérite pas. L’entrée d’une telle cible porte à la place expanded_from, l’adresse qu’a utilisée l’expéditeur (la première adresse d’une chaîne de développements), et pepsi-stage-bounce(1) fait son rapport sur cette adresse au lieu de la cible. pepsi-stage-aliases(1) et pepsi-stage-dot-forward(1) l’écrivent, et créent le tableau à cette fin lorsque l’expéditeur n’a donné aucun paramètre. Elle n’est jamais envoyée à un saut suivant
{
"dsn": {
"ret": "hdrs", // RET= (full|hdrs), if given
"envid": "QQ314159", // ENVID= xtext, if given
"rcpt": [ { "notify": ["success", "failure"], // NOTIFY= keywords
"orcpt": "rfc822;user@example.com", // ORCPT= xtext
"rrvs": "2014-04-03T23:01:00Z;C" } ] // RRVS= value
}
}
95.3.1.1.4.6. tls_required¶
(chaîne) L’étiquette RFC 8689, semée par pepsi-ingress(1) : "required" lorsque le message est arrivé avec le paramètre REQUIRETLS de MAIL FROM (sur une session protégée par TLS, la seule sorte sur laquelle il est accepté), "no" lorsqu’il est arrivé sans le paramètre mais portant un champ d’en-tête TLS-Required: No ; absente sinon. Chaque ligne scindée ou clonée depuis le message en hérite. Les étapes de relais la lisent (pepsi-stage-relay-to-internet(1), pepsi-stage-relay-to-smarthost(1)) : "required" signifie un TLS validé vers un saut suivant validé qui annonce REQUIRETLS, ou un rebond ; "no" rend indicatives pour ce message la politique DANE et MTA-STS du domaine destinataire. pepsi-stage-bounce(1) renvoie un message "required" avec ses en-têtes seulement et copie l’étiquette sur le DSN, la seule clé de l’état de l’original qu’un DSN conserve
{ "tls_required": "required" }
95.3.1.1.4.7. bounce¶
(objet) Écrit par toute étape qui achemine un message vers son BOUNCE_STAGE — les étapes de remise (pepsi-stage-relay-to-internet(1), pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1)) et pepsi-stage-discard(1), mais tout autant pepsi-stage-milter(1), pepsi-stage-block-language(1), pepsi-stage-anti-spam(1), pepsi-stage-encrypt(1), pepsi-stage-decrypt(1), pepsi-stage-secretary(1) et pepsi-stage-dot-forward(1). Toutes le construisent avec les mêmes helpers partagés, de sorte que la forme ci-dessous est la même quelle que soit l’étape qui l’a écrit. Il est consommé par pepsi-stage-bounce(1) pour construire le rapport. Son kind est permanent (un rebond d’échec, Action: failed), success (un rapport positif, Action: delivered), delay (Action: delayed) ou unknown (la remise a été abandonnée et le message est peut-être arrivé, Action: failed avec Status: 4.4.2) ; diagnostic et failed_recipient sont la raison lisible par un humain et le destinataire concerné, et les notify/orcpt/envid facultatifs sont copiés depuis l’entrée state.dsn du destinataire afin que l’étape de rebond puisse honorer NOTIFY et renvoyer en écho les ENVID/ORCPT originaux ; de même pour expanded_from, qui fait nommer par le rapport cette adresse avec un diagnostic générique au lieu de la cible et de sa réponse. Les étapes de relais notent aussi un détail structuré du saut suivant (remote_mta, smtp_code, enhanced_status, phase, reply_text) afin qu’un modèle de rebond puisse énoncer précisément pourquoi le MTA suivant a refusé le message, et enhanced_status alimente le champ Status: du DSN. pepsi-stage-relay-to-lmtp(1) n’a pas de rebond propre vers lequel acheminer : il écrit cet objet sur la ligne qu’il achemine vers NEXT_STAGE, QUOTA_LIMIT_STAGE, SIEVE_REJECT_STAGE, UNKNOWN_MAILBOX_STAGE ou (pour success/delay) NOTIFY_STAGE, avec remote_mta nommant la socket LMTP ou host:port. Une boîte aux lettres pleine refusée par pepsi-stage-relay-to-maildir(1) porte smtp_code 552, enhanced_status 5.2.2 et phase local delivery. Le ret au niveau du message est lui aussi porté ici, pour la même raison que envid : l’étape de rebond efface state en réécrivant le message, de sorte que tout ce dont elle a besoin passé ce point doit se trouver à l’intérieur de cet objet
{ "bounce": { "kind": "permanent",
"diagnostic": "550 5.1.1 user unknown",
"failed_recipient": "bob@example.net",
"remote_mta": "mx.example.net",
"smtp_code": 550,
"enhanced_status": "5.1.1",
"phase": "RCPT TO",
"reply_text": "5.1.1 user unknown",
"notify": ["failure"],
"orcpt": "rfc822;bob@example.net",
"envid": "QQ314159",
"ret": "hdrs" } }
95.3.1.1.4.8. attempts / last_error / delay_sent¶
Données de travail que les étapes de remise (et pepsi-stage-milter(1), pour un report) notent lorsqu’elles mettent un message en pause pour réessai : attempts (nombre) est le nombre de tentatives jusqu’ici, ce qui est ce qui pilote le recul entre réessais, et delay_sent (booléen, présent seulement lorsqu’il est vrai) marque que le DSN NOTIFY=DELAY à usage unique a déjà été émis, de sorte qu’il n’est jamais envoyé deux fois. pepsi-stage-anti-spam(1) écrit delay_sent de la même manière à son point de contrôle DELAY_DSN_AFTER, et last_error tant que son backend marchand est indisponible.
last_error (chaîne) est le texte d’erreur le plus récent. Il n’est pas confiné au chemin de réessai : les étapes de remise, de milter, de cryptographie, de signature DKIM et de ~/.forward l’écrivent aussi lorsqu’elles font échouer un message de manière terminale, de sorte que sur une ligne failed c’est la première chose à lire (pepsi-queue(1) l’affiche comme partie du state de la ligne, et pepsi-status(1) le liste sous chaque message bloqué).
95.3.1.1.4.9. temporary_failures / temporary_stage¶
(nombre / chaîne) Écrits, avec last_error, par l’infrastructure des étapes lorsque l’erreur d’une étape n’a pas été marquée permanente – imputable à l’hôte plutôt qu’au message (voir pepsi-dispatch(1)) : le nombre de fois que le message a été mis en pause pour cette raison jusqu’ici à temporary_stage, qui détermine l’espacement des réessais, d’une minute doublant jusqu’à une heure. Un compte enregistré à une autre étape n’est pas poursuivi. Supprimés lorsque le worker abandonne.
95.3.1.1.4.10. failed_stage / failure_class / failed_at¶
La trace d’un échec survenu sur cet hôte plutôt qu’au prochain saut. failed_stage (chaîne) est l’étape où il s’est produit. failure_class (chaîne) dit comment il s’est terminé : permanent (l’étape a marqué l’erreur comme un défaut du message), retries-exhausted (réessayé jusqu’à MAX_LIFETIME), crashed ou timed-out (le message a fait planter ou bloqué son worker trois fois), ou quarantine-expired (retenu dans une étape de quarantaine au-delà de [pepsi-queue] QUARANTINE_MAX_AGE_DAYS, voir pepsi-queue(1), ou au-delà du MAX_HOLD d’une étape pepsi-stage-quarantine(1), en route vers EXPIRE_STAGE). failed_at (chaîne, RFC 3339) est apposé par la base de données chaque fois que la ligne devient failed ou timeout ; le MIN_AGE de pepsi-failure-bouncer(1) se compte à partir de lui. pepsi-stage-bounce(1) construit un DSN à partir de failed_stage et failure_class lorsqu’aucun relais n’a signalé l’échec (bounce ci-dessus), avec un texte générique ; last_error n’est jamais copié dans un DSN.
95.3.1.1.4.11. arc_temperrors¶
(nombre) Écrit par pepsi-stage-arc(1) chaque fois qu’il a rencontré une erreur DNS temporaire en validant une chaîne ARC entrante : le message est mis en pause cinq minutes et réessayé, au plus trois fois ; si les recherches échouent encore après la troisième pause, la chaîne est scellée cv=fail comme le serait une chaîne en échec.
95.3.1.1.4.12. mime_anomalies, mime_normalise, mime_normalised¶
Écrits par pepsi-ingress(1) pour un message dont la structure MIME est ambiguë (voir sa section Structure MIME ambiguë). mime_anomalies (tableau de chaînes) liste les classes trouvées — empty-boundary, nul-in-header, conflicting-content-type, conflicting-transfer-encoding, encoded-word-boundary, conflicting-date, conflicting-subject, conflicting-to, conflicting-reply-to, conflicting-sender (les classes dures, refusées sous MIME_ANOMALIES = enforce), conflicting-cc (la classe marquée, stockée telle que reçue avec X-Pepsi-Warning), unknown-transfer-encoding, qp-soft-break-whitespace, base64-non-alphabet, missing-close-delimiter, duplicate-content-type, duplicate-transfer-encoding, duplicate-header-field, delimiter-in-epilogue (les classes douces, réécrites). mime_normalise (booléen) vaut true tant que la réécriture des classes douces est due à pepsi-stage-arc(1), qui le met à false une fois fait : un message arrivé porteur d’une chaîne ARC est stocké tel que reçu afin que la chaîne puisse être vérifiée sur les octets que ses scelleurs ont signés. mime_normalised (chaîne) nomme le programme qui a réécrit le message, pepsi-ingress ou pepsi-stage-arc ; absent lorsque rien n’a été réécrit (mode log, ou seulement à l’intérieur de parties signées ou chiffrées).
95.3.1.1.4.13. ingress_milter¶
(tableau d’objets) Écrit par pepsi-ingress(1) pour un message au sujet duquel des milters ont été consultés pendant la session SMTP (voir sa section Milters). Un objet par milter ayant décidé quelque chose au sujet du message, dans l’ordre où ils ont été interrogés : name (chaîne), le suffixe de section du milter ; verdict (chaîne), continue, accept ou failed ; modifications (tableau de chaînes, s’il y en a), ce qu’il a changé (addheader:X-Spam-Score, replbody, addrcpt:…) ; failed (booléen, lorsqu’il est vrai), le milter n’a pas pu être consulté et son ON_FAILURE a laissé entrer le message. Un message refusé ou rejeté sans avis n’est pas stocké, si bien qu’aucune ligne ne porte de refus.
95.3.1.1.4.14. arc_original¶
(chaîne) Écrit par pepsi-ingress(1), avec la valeur pepsi-ingress, lorsqu’un milter a modifié un message qui porte une chaîne ARC : le message tel que reçu est conservé dans workqueue.arc_original_body_id, et pepsi-stage-arc(1) vérifie la chaîne entrante sur ces octets tout en scellant le message stocké.
95.3.1.1.4.15. strikes¶
(nombre) Écrit par pepsi-dispatch(1) chaque fois que le message a fait planter son worker ou l’a retenu au-delà de MAX_RUNTIME ; la troisième pénalité met le message en échec, sauf que MAX_LIFETIME décide pour un worker tué dans une étape de remise.
95.3.1.1.4.16. lost_acks¶
(nombre) Écrit par pepsi-stage-relay-to-lmtp(1) : combien de tentatives ont envoyé tout le message sans obtenir de réponse. Avec strikes à cette étape, il décide du moment où l’étape s’arrête et signale que le résultat est inconnu.
95.3.1.1.4.17. retry_since¶
(chaîne, RFC 3339) Écrit par pepsi-stage-bounce(1) sur le DSN qu’elle construit, qui remplace le message dans sa ligne : l’instant à partir duquel le MAX_LIFETIME des étapes est compté au lieu de l’heure d’arrivée de la ligne, de sorte qu’un DSN ne naisse pas déjà expiré.
95.3.1.1.4.18. srs¶
(objet) Écrit par pepsi-stage-srs(1) lorsqu’il réécrit l’expéditeur d’enveloppe, notant l’adresse qu’il a remplacée
{ "srs": { "original": "alice@example.org" } }
Elle existe pour un DSN que ce déploiement émet lui-même. SRS s’exécute nécessairement avant l’étape de remise, puisque réécrire l’enveloppe pour le passage de relais est toute sa raison d’être. Au moment où une étape de remise appelle complete_success, ou où un relais achemine un échec vers son BOUNCE_STAGE, le mail_from de la ligne est donc l’un de nos propres alias SRS. pepsi-stage-bounce(1) adresserait alors le DSN à cet alias. Le DSN partirait vers le saut suivant puis reviendrait par notre propre MX pour être décodé, et il devrait survivre à tout le pipeline entrant en tant que message à expéditeur nul, pour n’aboutir qu’à une adresse qui figurait dans la ligne depuis le début. Là où cet aller-retour ne fonctionne pas, le DSN est perdu sans que rien ne le signale.
L’étape de rebond préfère donc cette valeur à mail_from. Elle est notée plutôt que récupérée en inversant l’alias parce que Srs::reverse a besoin du secret HMAC de SRS, et qu’une étape dont le travail est de composer un rebond n’a aucune raison de détenir du matériel de clé : l’expéditeur est une métadonnée de message ordinaire, ce à quoi state sert.
Écrite uniquement 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. Un rebond (expéditeur nul) n’est jamais réécrit et n’en note donc jamais ; une valeur vide se lit comme absente, et l’étape de rebond se rabat sur l’expéditeur d’enveloppe. Une copie qui part avec une adresse de retour de réexpédition la consigne aussi.
95.3.1.1.4.19. forward_return¶
(booléen) Écrit par pepsi-ingress(1) sur la ligne qu’il crée à partir d’un rapport distant au sujet d’une copie réexpédiée (un rapport envoyé à l’adresse de retour de réexpédition de la copie, voir pepsi-stage-srs(1)). La ligne entre à l’étape de rebond avec l’expéditeur d’origine comme expéditeur d’enveloppe, l’adresse qu’a utilisée l’expéditeur comme destinataire et un enregistrement bounce ne portant que l’issue et la classe de statut du rapport ; pepsi-stage-bounce(1) le transforme en DSN propre à cet hôte. Le rapport lui-même n’est pas stocké.
95.3.1.1.4.20. pay_deadline¶
(nombre) Écrit par pepsi-stage-anti-spam(1) : des secondes Unix depuis l’époque, l’échéance avant laquelle le bon de commande du péage à l’envoi doit être réglé. Elle est conservée dans state (plutôt que dans la colonne timeout de la ligne) car le dispatcher annule timeout chaque fois qu’il remet en file un message en pause. Une valeur écrite comme chaîne JSON est lue comme « aucune échéance », de sorte que tout ce qui la pose à la main doit écrire un nombre. L’étape court-circuite sa barrière de paiement lorsque state.paid vaut true.
95.3.1.1.4.21. spam / paid¶
(booléen) Indicateurs de court-circuit anti-abus.
spam est écrit par pepsi-stage-check-whitelist(1), qui le met à false sur une correspondance de liste blanche (et le laisse sinon non positionné), par pepsi-ingress(1), qui le met à false pour un message dont l”unique destinataire est <Postmaster> (joignabilité RFC 5321 §4.5.1), et par pepsi-stage-secretary(1), qui le met à false sur un message qu’il libère parce que son expéditeur a confirmé. Une valeur false fait transmettre le message par pepsi-stage-block-language(1), pepsi-stage-secretary(1) et pepsi-stage-anti-spam(1) sans appliquer leur barrière. Une valeur true fait abandonner le message à pepsi-stage-anti-spam(1) au lieu de le soumettre à la barrière, l’envoie sur le chemin d’expiration de pepsi-stage-secretary(1), supprime l’apprentissage de clés dans pepsi-stage-autocrypt-learn(1) à moins que le LEARN_FROM_SPAM de cette étape ne soit activé, et bloque les répondeurs automatiques de la RFC 3834 qui utilisent les règles de suppression partagées (pepsi-stage-vacation(1), le défi du secrétaire et les réponses automatiques des listes de diffusion). Seul un booléen explicite compte : une clé absente ne déclenche aucun des deux comportements.
Notez qu”aucune étape livrée n’écrit jamais spam = true : les écrivains ci-dessus n’écrivent jamais que false. La valeur true est le point d’accroche qu’utilisent un pipeline piloté par milter, un opérateur ou une étape propre au site — le même arrangement que paid ci-dessous.
paid est écrit par pepsi-stage-anti-spam(1) elle-même, et uniquement comme false : elle stocke paid = false à côté de pay_deadline à chaque mise en pause une fois le bon de commande créé (une pause due à l’impossibilité de créer encore le bon de commande ne porte que pay_deadline et last_error), ce qui marque le message comme en attente de paiement. Lorsque le marchand signale le bon de commande réglé, l’étape avance simplement le message ; aucune étape de l’arbre n’écrit donc jamais paid = true — cette valeur est un point de redéfinition pour un opérateur ou une étape propre au site, et la barrière de paiement est sautée lorsqu’elle est positionnée (comme elle l’est lorsque spam vaut false).
95.3.1.1.4.22. dot-forwarders¶
(tableau de chaînes) Les noms de login en minuscules dont les fichiers ~/.forward ont redirigé cette ligne, c’est-à-dire la chaîne de redirection qui y a mené, maintenue par pepsi-stage-dot-forward(1) comme protection contre les boucles de redirection. Une ligne redirigée reçoit la chaîne de la ligne dont elle est issue plus l’unique login qui l’a redirigée, de sorte que la liste décrit un seul chemin de redirection, et non chaque ~/.forward que le message a traversé. Comme un message redirigé redémarre le pipeline, un destinataire dont l’utilisateur est déjà listé ici fait l’objet d’un rebond au lieu d’être repassé par son ~/.forward, de sorte qu’un cycle (~bob → alice, ~alice → bob) se termine.
95.3.1.1.4.23. language¶
(chaîne) Écrit par pepsi-stage-detect-language(1) comme une chaîne de style Accept-Language décrivant la ou les langues détectées du corps, avec des valeurs q par ordre de préférence.
pepsi-stage-block-language(1) la lit pour noter le message par rapport à ses listes d’autorisation/de refus, mais c’est tout autant la clé de localisation : chaque étape qui compose de la prose destinée à un humain y choisit la langue de son modèle ou de son message, en retombant, lorsqu’elle est absente ou ne nomme rien de pris en charge, sur le DEFAULT_LANGUAGE de l’étape lorsqu’elle en a un (pepsi-stage-vacation(1), pepsi-stage-secretary(1)) et sur l’anglais sinon — pepsi-stage-vacation(1) (l’avis d’absence), pepsi-stage-anti-spam(1) (la demande de paiement), pepsi-stage-secretary(1) (le défi), pepsi-stage-encrypt(1), pepsi-stage-auto-pay(1) et pepsi-stage-secure-link(1) (leurs messages de réponse) et pepsi-stage-edit-settings(1) (sa réponse de confirmation ou d’erreur). C’est pourquoi un déploiement qui ne fait aucun blocage de langue peut tout de même vouloir l’étape de détection dans le pipeline.
95.3.1.1.4.24. vacation¶
(objet) Écrit par pepsi-stage-vacation(1) lorsqu’il a répondu à un message pour le compte du destinataire, notant ce qu’il a fait
{ "vacation": { "notified": true,
"recipient": "alice@example.org", // who is away
"range": "2026-08-01:2026-08-14",
"language": "de" } } // the notice's language
Aucune étape n’en tient compte si vous n’en configurez pas une pour cela : il existe pour que la décision soit visible dans pepsi-queue(1), pour que pepsi-stage-if(1) puisse brancher dessus, et pour qu’une question de support sur une réponse d’absence surprenante trouve réponse dans la ligne plutôt que dans le journal. Absent sur tout message auquel il n’a pas été répondu.
95.3.1.1.4.25. secretary¶
(objet) Écrit par pepsi-stage-secretary(1). Sur un message qu’il retient
{ "secretary": { "challenge": "00112233445566778899aabbccddeeff", // the cookie
"deadline": 1769812345, // Unix seconds, when it expires
"whitelist": "correspondents" } } // where a confirmation writes
Une confirmation ajoute "confirmed": true en libérant la ligne (l’étape la transmet alors avec spam = false) ; un défi revenu en rebond ajoute "abandoned": true, l’envoyant plus tôt sur le chemin d’expiration. Un message que l’étape ne voulait pas soumettre à un défi et qu’elle a acheminé vers son UNCHALLENGEABLE_STAGE porte à la place { "secretary": { "unchallengeable": "<reason>" } }. Le chemin d’expiration supprime entièrement la clé : rien d’un défi ne lui survit. Comme pay_deadline, l’échéance est conservée dans state parce que le dispatcher efface le timeout de la ligne lorsqu’il remet en file un message en pause.
95.3.1.1.4.26. keydisc¶
(objet) Ce qu’attend un message garé : l’adresse du correspondant dont la clé n’a pas pu être trouvée dans le cache, et le moment où l’attente a commencé
{ "keydisc": { "address": "bob@example.com", // the address a key is wanted for
"since": 1769812345 } } // Unix seconds, when the park happened
Il est écrit par le terminal de mise en attente de la découverte de clés, qui en un aller-retour valide tout ce que l’étape avait déjà réécrit, fusionne cette clé, met la ligne en paused avec un délai de réessai, et met une demande en file dans pepsi.key_request. Un service pepsi-keydisc(1) qui règle cette demande apparie les attendants sur keydisc.address — via un index partiel portant exactement sur cette expression — et les rebascule en pending, de sorte qu”une étape ne doit ni renommer ni écrire cette clé à la main. Le délai de réessai est le filet de sécurité d’un déploiement qui n’exploite aucun service de découverte : il est toujours fixé après l’échéance de découverte, de sorte que la libération se produit normalement d’abord.
La libération ne déplace que le status de la ligne et efface son timeout, de sorte que la clé y survit : un message repris porte encore la trace de l’attente qui vient de s’achever, et une étape qui gare de nouveau l’écrase simplement.
95.3.1.1.4.27. secure_link¶
(objet) Marque un message que le portail de lien sécurisé de pepsi-httpd(1) a injecté : une réponse qu’un destinataire a saisie dans le portail après avoir ouvert un message que pepsi-stage-secure-link(1) y avait scellé
{ "secure_link": { "reply": true,
"token": "b3d1…" } } // the portal token replied to
local_origin est délibérément absent d’un tel message, et cette absence est toute la propriété de sécurité : c’est le seul bit qui sépare une réponse du portail d’un relais ouvert. Sans lui, la réponse ne peut pas emprunter le chemin de soumission : il n’y a donc pas de relais en notre nom, pas de mise en liste blanche automatique de son destinataire, ni de SRS en tant qu’origine locale. Elle est traitée pour ce qu’elle est : du courrier entrant qui se trouve avoir pris naissance sur notre propre serveur web.
95.3.1.1.4.28. tlsrpt¶
(booléen) Un indicateur de protection contre les boucles posé sur un message qui est lui-même un rapport SMTP TLS Reporting (pepsi-tlsrpt(1)). Les étapes de relais ne notent pas de ligne pepsi.tls_session pour un tel message, de sorte qu’un rapport sur une remise de rapport échouée ne peut récurser.
95.3.1.1.4.29. auth.arc¶
Écrasé par pepsi-stage-arc(1) avec le verdict de la chaîne ARC entrante qu’il a réévaluée, remplaçant le none que l’ingress a semé sous auth (voir la clé auth ci-dessus) : none (pas de chaîne), pass ou fail (toute chaîne qui ne s’est pas validée, y compris un temperror DNS et un ensemble signé avec rsa-sha1).
95.3.1.1.4.30. auth.arc_sealers¶
(tableau de chaînes) Écrit par pepsi-stage-arc(1) à côté de auth.arc : le d= des champs ARC-Seal que le message portait à son arrivée, en minuscules, point racine final retiré, dédupliqué et ordonné par instance de sorte que l’ADMD la plus proche de l’auteur vienne en premier. Notre propre ARC_DOMAIN n’y figure jamais — la liste est lue avant que le propre ensemble de cette étape ne soit rendu
{ "auth": { "arc": "pass", "arc_sealers": ["lists.example.org", "mx.forwarder.example"] } }
Il existe parce qu”auth.arc seul ne peut pas soutenir une décision de politique : la RFC 8617 §8.4 énonce qu’une chaîne valide ne transmet aucune fiabilité, seulement que les ADMD nommées ont manipulé le message, et laisse le reste au destinataire. Nommer un intermédiaire acceptable est cette politique locale, et voici ce à quoi une telle règle est comparée — les lignes sealer_domain de pepsi-stage-check-whitelist(1).
Pour une chaîne qui s’est validée, seuls sont listés les scelleurs dont le propre ARC-Message-Signature se vérifie encore sur le message : la validation de chaîne ne vérifie que le plus récent, et les sceaux ne couvrent pas le message, de sorte qu’un ensemble authentique copié sur un autre contenu nommerait sinon un scelleur qui ne l’a jamais vu. Pour une chaîne qui ne s’est pas validée, le tableau est la trace de ce que le message a prétendu ; un sceau s’analyse sans se vérifier. Tout lecteur doit donc exiger auth.arc = pass avant de faire confiance à une entrée, ce que fait check-whitelist en écartant sinon toute la liste.
95.3.1.1.4.31. crypto¶
(objet) Ce qu’ont fait les étapes de cryptographie de bout en bout. La moitié sortante, crypto.out, est écrite par pepsi-stage-encrypt(1)
{ "crypto": { "out": {
"signed": true,
"protocol": "openpgp",
"signer": "alice@example.org",
"signer_fingerprint": "ABCD…",
"recipients": {
"bob@example.net": { "outcome": "encrypted",
"protocol": "openpgp",
"fingerprint": "1234…",
"key_source": "wkd",
"trust": "wkd-advanced",
"content_algorithm": "seipdv2-aead",
"downgraded": false } },
"key_attached": true } } }
signer est l’auteur du From:, jamais l’expéditeur d’enveloppe : la signature porte sur l’auteur que voit le destinataire. L”outcome de chaque destinataire vaut encrypted, signed-only, cleartext, secure-link, bounced ou oversize, et route nomme le chemin ON_NO_KEY/ON_OVERSIZE emprunté lorsque ce n’était pas le chemin ordinaire. reason porte une courte formule pour le journal de l’opérateur et pour le rebond.
content_algorithm et downgraded sont notés afin qu’un opérateur puisse répondre à « à qui parlons-nous encore en SEIPDv1 ? » sans lire de journaux. downgraded n’apparaît qu’à côté d’un content_algorithm : un false sur un destinataire qui n’a pas été chiffré du tout se lirait comme « nous avons chiffré, sans rétrograder », ce qui est une autre affirmation.
key_source et trust valent tous deux own lorsque le destinataire est une adresse pour laquelle ce déploiement détient sa propre identité. Ce n’est pas un rang sur l’échelle de découverte : notre propre clé préempte entièrement le cache pepsi.peer_key pour une telle adresse, de sorte qu’aucun plancher MIN_TRUST ne s’applique et qu’aucune clé découverte n’a été consultée. Voir pepsi-stage-encrypt(1).
Comme l’étape scinde les destinataires divergents à raison d’un par ligne, l’objet recipients d’une ligne contient normalement exactement les destinataires du rcpt_to de cette ligne.
key_attached (booléen, présent seulement lorsqu’il est vrai) note que la clé publique de l’expéditeur est partie sous forme de fichier application/pgp-keys (ATTACH_KEYS_AS_FILES). client_protected (booléen, présent seulement lorsqu’il est vrai) note que le propre client de messagerie de l’utilisateur avait déjà chiffré la soumission, de sorte que l’étape n’y a pas touché : ni chiffrement, ni signature, ni en-tête Autocrypt:, ni fichier de clé de la part de Pepsi.
La moitié entrante, crypto.in, est écrite par pepsi-stage-decrypt(1)
{ "crypto": { "in": {
"encrypted": true,
"outer_gossip": true,
"decrypted": true,
"decryption": "decrypted",
"protocol": "openpgp",
"decrypted_with": { "identity": 7,
"address": "bob@example.org",
"fingerprint": "ABCD…" },
"signature": { "status": "valid",
"signer": "alice@example.net",
"fingerprint": "1234…",
"key_source": "wkd",
"trust": "wkd",
"algorithm": "ed25519",
"signed_at": 1785000000,
"covers_plaintext": true },
"layers": [ { "kind": "encrypted", "protocol": "openpgp",
"encoding": "pgp-mime", "verdict": "good",
"container": "seipdv1-mdc", "downgraded": true },
{ "kind": "signed", "protocol": "openpgp",
"encoding": "pgp-mime", "verdict": "good" } ] } } }
decryption vaut not-encrypted, decrypted, failed, for-client ou withheld ; sur failed, une clé voisine failure porte la raison lisible par une machine (no-decryption-key, decryption-failed, too-large, …), et failed_unauthenticated (booléen, présent seulement lorsqu’il est vrai) consigne que le texte chiffré en échec ne portait aucune protection d’intégrité (ou n’a pas pu être identifié), ce que ON_DECRYPT_FAILURE = bounce-if-unproblematic abandonne plutôt que de le faire rebondir. withheld désigne un message transmis sans être ouvert pour le client du destinataire, par UNAUTHENTICATED_PLAINTEXT = require-signature ou OPEN_ENVELOPED_DATA = no. route nomme le chemin ON_DECRYPT_FAILURE/ON_BAD_SIGNATURE emprunté lorsque ce n’était pas le chemin ordinaire (quarantine, bounce, bounce-generic ou drop ; une mauvaise signature issue d’un conteneur enveloped-data sous ON_BAD_SIGNATURE = bounce est drop).
for-client signifie que le message est chiffré pour la propre clé MUA du destinataire (une identité avec custody = client, dont la moitié privée ne vit que dans son client de messagerie) et qu’il a été transmis sans être ouvert, même lorsque l’une de nos propres clés figurait aussi parmi les destinataires. Ce n’est pas un échec : ON_DECRYPT_FAILURE n’est pas consulté. La clé voisine for_client vaut alors true et client_fingerprint nomme la clé. Rien n’a été vérifié, donc signature_verified n’est pas positionné.
unauthenticated (booléen, présent seulement lorsqu’il est vrai) consigne que le texte en clair est issu d’un texte chiffré sans protection d’intégrité (un conteneur S/MIME EnvelopedData, container sur la couche) et qu’aucune signature valide à l’intérieur ne couvre le texte en clair, de sorte que rien n’exclut une réécriture bloc par bloc (les gadgets CBC d’EFAIL). sanitised (text) indique alors que le texte en clair a été réduit à un contenu qu’aucun client ne rend comme du balisage ([stage-decrypt] UNAUTHENTICATED_PLAINTEXT = text) ; il est aussi positionné, sans unauthenticated, lorsque DECRYPTED_MARKUP = text a réduit un texte en clair authentifié. withheld comme valeur de decryption signifie que le même message a plutôt été transmis sans être ouvert (require-signature) : ce n’est pas un échec, rien ne l’a ouvert pour l’utilisateur, et decrypted vaut false.
isolated (tableau, présent seulement lorsqu’il n’est pas vide) liste les règles qui ont modifié le message avant le déchiffrement ou un texte en clair récupéré : encrypted (la première unité chiffrée d’un message qui portait du texte chiffré à côté d’un autre contenu est devenue le message et les autres parties ont été déplacées dans des pièces jointes inertes, ISOLATE_ENCRYPTED) et signed (le contenu non signé situé à côté d’un contenu signé a été abandonné, ISOLATE_SIGNED). encrypted est aussi listé lorsque seuls des messages joints ont été réduits ; nested (entier, présent seulement lorsqu’il n’est pas nul) les compte.
protected_mismatch (tableau, présent seulement lorsqu’il n’est pas vide) nomme les champs d’en-tête protégés (from, to, reply-to, mail-reply-to, mail-followup-to, subject) dont la copie signée à l’intérieur du message diffère du champ extérieur que voit le destinataire. Une discordance de from ou d’orientation des réponses (reply-to, mail-reply-to, mail-followup-to) coûte sa confiance à la signature, parce que la signature se porte alors garante d’un message de quelqu’un d’autre, ou que les réponses iraient là où le signataire ne l’a pas dit : valid est rapporté comme valid-untrusted, de sorte que signature_verified n’est pas positionné. Un champ d’orientation des réponses qu’une liste de diffusion a ajouté (List-Id présent, aucun des trois signé) est signalé mais garde valid, avec signature.reply_to_unsigned (booléen, présent seulement lorsqu’il est vrai). Un subject qui ne diffère que par des segments entre crochets insérés en tête n’est pas une discordance ; une différence plus importante est signalée et, sur une signature valid, c’est l’objet signé qui est affiché à la place, ce qui est consigné comme subject_promoted (booléen, présent seulement lorsqu’il est vrai). Les différences de to sont seulement signalées, puisque les logiciels de réexpédition et de listes le modifient légitimement. Un Subject: extérieur qui est l’espace réservé propre à la protection des en-têtes ne compte pas. La même liste apparaît comme protected-mismatch= dans l’en-tête X-Pepsi-Crypto.
signer_domain (chaîne, présente seulement dans ce cas) est le domaine du signataire sous forme d’A-label lorsqu’il s’agit d’un nom de domaine internationalisé ou qu’il ressemble à un domaine servi ou connu (signature.withheld = lookalike-domain).
usually_signed (objet, présent seulement dans ce cas) est positionné sur un message sans signature valid dont l’adresse From: en avait une dans les limites de MISSING_SIGNATURE_WINDOW_DAYS : last_valid_signature (entier) est le moment où cette signature s’est vérifiée pour la dernière fois, en secondes Unix (pepsi.signed_sender). X-Pepsi-Crypto le porte sous la forme usually-signed=<date> ; la suite relève d”ON_MISSING_SIGNATURE (pepsi-stage-decrypt(1)).
demoted et dropped (entiers, présents seulement lorsqu’ils ne sont pas nuls) comptent les parties qu”ISOLATE_ENCRYPTED a déplacées hors du message : demoted celles remises comme pièces jointes (chaque fichier en lequel un texte chiffré déplacé a été ouvert compte une fois), dropped celles non remises – à côté d’un conteneur PGP/MIME ou S/MIME transmis sans être ouvert, et, à côté d’un texte en clair signé, le clair et le texte chiffré non signés par la même clé.
La présence d”encrypted ou de decrypted positionné à true indique aussi à pepsi-stage-bounce(1) et aux étapes de réponse automatique de retenir le contenu du message : un DSN ne cite alors que ses champs d’adressage, et aucune réponse ne cite son objet.
signature.binding (chaîne, présente lorsqu’une clé a été trouvée) est la relation entre la clé du signataire et l’adresse From: telle que l’a vue le vérificateur : matched, mismatched ou no-identity (la clé ne nomme aucune adresse). signature.anchor (chaîne, présente sur une signature S/MIME ancrée) est l’empreinte de l’ancre ca_trust à laquelle s’est terminée la chaîne. signature.bound_to (chaîne, présente seulement sur ``valid``) est l’adresse à laquelle la signature est liée, celle que nomme l’étiquette [verified: …]. signature.withheld (chaîne, présente seulement dans ce cas) est la raison pour laquelle une signature qui s’est vérifiée est valid-untrusted plutôt que valid : ciphertext-cover, protected-from, protected-subject, reply-to, no-identity, display-name, multiple-from, lookalike-domain, old-signature ou future-signature (pepsi-stage-decrypt(1), Ce pour quoi valid est accordé). signature.signed_at (entier, présent seulement dans ce cas) est l’heure de création que revendique la signature, en secondes Unix ; elle est comparée à l’heure d’arrivée sous MAX_SIGNATURE_AGE_DAYS. signature.unsigned_surface (chaîne, présente seulement dans ce cas) est la raison pour laquelle un bloc clearsigned vérifié est partial : armor-headers ou html.
signature.covers_plaintext est présent dès qu’il existe un verdict de signature : true lorsque le verdict a été accordé par une signature sur le texte en clair, false lorsqu’il provient d’une couche enveloppant du texte chiffré. pepsi-stage-autocrypt-learn(1) ne note qu’un correspondant détient l’une de nos clés (pepsi.peer_has_own_key) que sur une signature valid ou valid-untrusted avec covers_plaintext = true dont le signataire est l’adresse From:, sur un message que nous avons déchiffré.
outer_gossip (booléen, présent uniquement lorsqu’il est vrai) note que le message tel qu’il est arrivé portait déjà un champ Autocrypt-Gossip: sur son bloc d’en-têtes extérieur — quelque chose que n’importe quel saut du chemin a pu écrire, et que le réassemblage PGP en ligne peut faire traverser le déchiffrement. Il est écrit ici parce que le texte clair est validé par-dessus les octets arrivants, de sorte que rien en aval ne pourrait répondre à la question plus tard. Avec encrypted, c’est ce que pepsi-stage-autocrypt-learn(1) consulte avant d’apprendre la moindre clé issue du gossip : un champ extérieur non authentifié met son veto à l’ensemble. Si LEARN_GOSSIP est activé et que rien n’est appris d’un message chiffré, c’est la clé à regarder.
signature.status vaut l’un de :
noneAucune signature.
validCryptographiquement saine et la clé était ancrée — une chaîne X.509 vers une ancre
ca_trust, ou une clé OpenPGP issue de WKD, de DANE validé par DNSSEC, ajoutée par l’opérateur, ou notre propre identité pour l’expéditeur — et le signataire est lié à la ligneFrom:telle que la voit le lecteur. Une clé issue d’un serveur de clés (VKS, LDAP) estvalid-untrusted.partialSerait
valid, mais le lecteur se voit montrer, à côté du texte signé, du texte que la signature ne couvre pas : un bloc clearsigned en ligne, remis tel qu’il est arrivé, avec des lignes d’en-tête d’armure autres queHash:ou dans une partietext/html(signature.unsigned_surface). Pas d’étiquette, pas designature_verified.valid-untrustedSaine, mais la clé n’a pu être rattachée à rien : une clé vue pour la première fois, une clé apprise du message lui-même, ou un certificat d’une AC pour laquelle ce déploiement ne détient aucune ancre — ou une signature ancrée à laquelle l’une des règles de l’étape a refusé
valid(signature.withheld) : unFrom:ouReply-To:protégé qui diffère, un certificat ne nommant aucune boîte aux lettres, un nom d’affichage montrant une autre adresse, plusieurs boîtes aux lettresFrom:, un domaine de signataire sosie. Jamais rapportée comme ``valid`` ; faire cette distinction est la raison d’être de l’étape.invalidLa signature ne vérifie pas, ou le certificat du signataire est expiré, révoqué ou lié à une autre adresse.
signature.failuredit lequel.unverifiableAucune clé n’était disponible pour le signataire prétendu.
signature.key_source et signature.trust portent ici le vocabulaire de provenance propre à la couche cryptographique (anchor, dane, wkd, autocrypt, pinned, attached, unknown), plus grossier que les noms d’échelons de la moitié sortante. Une signature vérifiée contre notre propre identité pour l’expéditeur prétendu rapporte pinned — la valeur la plus forte de ce vocabulaire, et la bonne, puisque la clé est consignée pour cette adresse. C’est la même préemption que la moitié sortante appelle own : pour une adresse dont ce déploiement détient une clé, aucune ligne peer_key n’est offerte au vérificateur. Voir pepsi-stage-decrypt(1).
Un message portant plusieurs couches de signature prend le pire de leurs verdicts — parmi les couches qui couvrent le texte clair. Une couche de signature marquée covers_ciphertext (voir ci-dessous) n’est consultée que s’il n’y en a pas d’autre, et ne peut même alors jamais donner valid.
layers est ordonné le plus extérieur d’abord, et cet ordre compte : c’est à partir de lui que sont rendues les étiquettes d’objet, de sorte que encrypted(signed(body)) et signed(encrypted(body)) soient distinguables. Il survit donc à une mise en pause, raison pour laquelle l’étape le note plutôt que de le recalculer. container et downgraded n’apparaissent que sur les couches de texte chiffré, afin qu’un opérateur voie quelle part du courrier entrant est encore pré-AEAD.
"covers_ciphertext": true apparaît sur une couche de signature à l’intérieur de laquelle une couche de texte chiffré est imbriquée — la signature extérieure de signed(encrypted(body)). Elle n’est présente que lorsqu’elle est vraie. Une telle signature a été calculée sur le texte chiffré : elle dit donc que le signataire a transmis le bloc et rien de ce qui en est sorti ; quiconque obtient un message chiffré peut l’envelopper dans sa propre signature et le réexpédier. La couche conserve son propre verdict honnête, mais elle ne peut pas élever signature.status à valid et ne peut donc pas positionner signature_verified. Dans signed(encrypted(signed(body))), seule la couche extérieure est marquée, et c’est la couche intérieure — celle qui parle pour le contenu — qui décide du verdict.
La moitié stockage, crypto.store, est écrite par pepsi-stage-reencrypt(1) sur une ligne dont le crypto.in indique que le message a été déchiffré
"crypto": {
"in": { … },
"store": { "outcome": "reencrypted", "protocol": "openpgp",
"fingerprint": "…", "container": "seipdv2-aead",
"downgraded": false }
}
outcome vaut reencrypted (scellé pour la propre clé MUA du destinataire, désignée par fingerprint), plaintext (classé tel quel : aucune clé MUA utilisable sous ON_NO_CLIENT_KEY = plaintext, ou destinataire non local — reason précise lequel) ou bounced (refusé sous ON_NO_CLIENT_KEY = bounce ; reason). L’étape fusionne l’objet crypto entier, de sorte que crypto.in survit, et c’est la présence de store qui l’empêche de sceller une ligne deux fois.
95.3.1.1.4.32. encrypted¶
(booléen) Mis à true par pepsi-stage-encrypt(1) lorsque le message de cette ligne a réellement été chiffré vers une clé de destinataire, et par pepsi-stage-decrypt(1) lorsque le message est arrivé chiffré. pepsi-stage-auto-whitelist(1) le recopie dans la colonne signature_required de la nouvelle ligne de liste blanche, de sorte qu’un correspondant atteint sous chiffrement soit soumis plus tard à la même exigence. Absent (plutôt que false) lorsque rien n’a été chiffré.
95.3.1.1.4.33. signature_verified¶
(booléen) Mis à true par pepsi-stage-decrypt(1) pour le verdict de signature valid, et pour celui-là seul. La barrière signature_required de pepsi-stage-check-whitelist(1) le teste : laisser valid-untrusted le positionner ouvrirait donc une barrière que l’opérateur destinait à une clé de confiance — et, pour la même raison, une signature qui ne couvre que du texte chiffré (covers_ciphertext, ci-dessus) ne le positionne jamais non plus. Absent (plutôt que false) sinon.
95.3.1.1.4.34. milter¶
(objet) Ce qu’a fait pepsi-stage-milter(1) — le verdict du filtre, la version de protocole négociée, la durée de la conversation, et chaque modification appliquée, étiquetée
{ "milter": { "stage": "spam-filter",
"verdict": "reject",
"version": 6,
"elapsed_ms": 42,
"actions": ["addheader:X-Spam-Status", "replbody"],
"reply_code": "550 5.7.1 blocked",
"quarantine_reason": "virus found",
"rejected_recipients": 1 } }
stage est le libellé de l’étape milter qui a agi (non son MILTER_NAME, qui n’est que la macro {daemon_name} remise au filtre). verdict vaut continue, accept, reject, tempfail, discard ou — lorsque le filtre n’a pas pu être contacté du tout, ou a envoyé une modification qui ne peut pas être appliquée — failed, auquel cas l’enregistrement ne contient que stage, verdict et une error portant le diagnostic, et l’acheminement a suivi l”ON_FAILURE de l’étape. reply_code, quarantine_reason et rejected_recipients ne sont présents que lorsqu’ils s’appliquent.
Aucune étape n’en tient compte si vous n’en configurez pas une pour cela. Il existe pour que pepsi-queue(1) puisse montrer pourquoi un message a été étiqueté, pour que pepsi-stage-if(1) puisse brancher dessus, et pour qu’une question de support sur un en-tête surprenant trouve réponse dans la ligne plutôt que dans le journal — la même justification que pour vacation ci-dessus. Un message rejeté porte en outre l’objet bounce habituel, avec le code SMTP propre du filtre, le code d’état étendu RFC 3463 et le texte répartis dans leurs propres champs.
95.3.1.1.4.35. quarantine¶
(objet) L’enregistrement de quarantaine. Toute partie qui envoie un message à une étape pepsi-stage-quarantine(1) en écrit un neuf, qui remplace en bloc tout enregistrement antérieur : pepsi-stage-milter(1) lorsqu’un filtre met en quarantaine et que QUARANTINE_STAGE est défini, et pepsi-ingress(1) pour un milter avant la mise en file. L’étape de quarantaine ajoute les horodatages
{ "quarantine": { "reason": "virus found",
"by": "milter:clamav",
"since": "2026-11-15T10:00:00Z",
"until": "2026-11-29T10:00:00Z",
"released_at": "2026-11-16T08:30:00Z" } }
reason (chaîne, facultatif) est la raison pour laquelle le message est retenu, telle que l’a formulée l’émetteur de la demande (le texte SMFIR_QUARANTINE d’un milter). by (chaîne, facultatif) nomme cet émetteur : milter:<MILTER_NAME> ou stage:<name>. since (RFC 3339) est le moment où l’étape de quarantaine a commencé à retenir le message, until celui où la rétention prend fin d’elle-même (avec MAX_HOLD), released_at celui où un opérateur l’a libéré, et expired (true) indique que la rétention est arrivée à son terme. L’étape retient un message dont l’enregistrement n’a pas de since, ou dont la rétention antérieure a pris fin (released_at ou expired est défini), si bien qu’un message libéré une fois puis remis en quarantaine plus tard est de nouveau retenu. pepsi-queue(1) quarantine et pepsi-status(1) lisent l’enregistrement ; le webhook POST /resume de pepsi-httpd(1) laisse un message tranquille tant qu’il est retenu.
95.3.1.1.4.36. crypto_policy_refused¶
(booléen, présent seulement lorsqu’il est vrai) Écrit à côté de last_error par pepsi-stage-encrypt(1), pepsi-stage-decrypt(1) et pepsi-stage-reencrypt(1) lorsqu’ils font échouer un message parce que la politique configurée l’a refusé et qu’il n’y avait aucun BOUNCE_STAGE vers lequel le faire rebondir — ON_NO_KEY/ON_OVERSIZE = bounce pour un destinataire pour lequel on n’a pas pu chiffrer, un rebond ON_DECRYPT_FAILURE/ON_BAD_SIGNATURE, ON_NO_CLIENT_KEY = bounce. Il distingue un refus délibéré d’une erreur de transport ou de programmation, qui autrement se ressemblent à l’identique sur une ligne failed : réessayer le premier ne servira jamais à rien.
95.3.1.1.4.37. encrypt_dns_deferred¶
(booléen, présent seulement lorsqu’il est vrai) Écrit avec last_error (et delay_sent une fois qu’un DSN de délai est parti) par pepsi-stage-encrypt(1) lorsqu’il met un message en pause parce que la recherche de clé d’un destinataire a échoué dans le DNS, plutôt que de l’envoyer non chiffré ; voir « Échecs DNS des destinataires » dans cette page.
95.3.1.1.4.38. milter_error¶
(chaîne) Écrit par pepsi-stage-milter(1) lorsqu’un filtre a rejeté un message mais que ni REJECT_STAGE ni BOUNCE_STAGE n’était configuré, de sorte que l’étape n’avait nulle part où l’acheminer. À distinguer de milter.error à l’intérieur de l’objet milter ci-dessus, qui est le diagnostic d’un filtre auquel on n’a pas pu parler du tout.
95.3.1.1.4.39. list¶
(objet) Le descripteur de liste de diffusion. pepsi-stage-list(1) l’écrit sur chaque ligne qu’il achemine vers un rôle de liste (l”id de la liste, le role, l”address à laquelle le message est arrivé, plus le token d’une adresse -confirm+, ou le détail verp d’une adresse -bounces+, tel quel : l’étape de rebond le vérifie et le décode) ; pepsi-stage-list-post(1) écrit un descripteur par membre (id, member, lang, serial, duplicate) sur chaque ligne de remise qu’il déploie, plus pending_rcpt sur une publication partiellement déployée et rejected sur une publication refusée ; pepsi-list(1) positionne moderator_approved ; les lignes d’un numéro de résumé portent digest (true), sur la ligne en attente et sur chaque descripteur par membre déployé à partir d’elle. Lu par pepsi-stage-list-post(1), pepsi-stage-list-command(1), pepsi-stage-list-deliver(1) et pepsi-stage-list-bounce(1) ; voir ces pages pour les champs qu’utilise chacun.
95.3.1.1.4.40. dispatch_error¶
(chaîne) Écrit par pepsi-dispatch(1) lorsqu’il force une ligne à un état terminal qu’elle n’a pas atteint d’elle-même — le diagnostic pour un programme d’étape qui a planté (failed), pour un programme qui a dépassé MAX_RUNTIME (timeout), ou pour une ligne restée à une étape que la configuration ne définit pas. pepsi-status(1) le liste sous chaque message bloqué.
95.3.1.1.5. Voir aussi¶
pepsi.conf(5), pepsi-ingress(1), pepsi-dispatch(1), pepsi-stage-arc(1), pepsi-stage-bounce(1), pepsi-stage-check-whitelist(1), pepsi-stage-anti-spam(1), pepsi-stage-detect-language(1), pepsi-stage-block-language(1), pepsi-stage-vacation(1), pepsi-stage-secretary(1), pepsi-stage-milter(1), pepsi-stage-encrypt(1), pepsi-stage-decrypt(1), pepsi-stage-auto-whitelist(1), pepsi-stage-list(1), pepsi-tlsrpt(1), pepsi-keydisc(1), pepsi-keys(1)