95.3.1. pepsi.state¶
per-message state object carried through the Pepsi pipeline
- Handbuchabschnitt:
7
95.3.1.1.1. Name¶
pepsi.state - das JSON-state-Objekt, das an jede Pepsi-Nachricht angehängt ist.
95.3.1.1.2. Beschreibung¶
Jede in Bearbeitung befindliche Nachricht ist ein Datensatz der pepsi.workqueue-Tabelle. Neben dem Umschlag und dem Nachrichtentext trägt jeder Datensatz ein frei strukturiertes JSON-Objekt — die Spalte state (PostgreSQL-JSONB) — das mit der Nachricht vom Ingress bis zu ihrer terminalen Stage reist. Das state ist der einzige Kanal, über den die Stages der Pipeline kommunizieren: Eine Stage hält ein Urteil oder ein Stück Herkunft fest, eine spätere Stage liest es.
Diese Seite dokumentiert das Layout dieses Objekts: die Schlüssel, die die Standard-Stages schreiben, wann sie geschrieben werden und welche Stages sie verbrauchen. Sie ist eine Datenformat-Referenz, unabhängig von jeder Konfiguration; der Pipeline-Graph und die Optionen, die jede Stage antreiben, werden in pepsi.conf(5) beschrieben.
95.3.1.1.3. Zusammenführungssemantik¶
state wird inkrementell aufgebaut. Jeder terminale Stage-Helper, der einen Datensatz verändert, führt seine neuen Schlüssel in das bestehende Objekt zusammen (die terminalen SQL-Funktionen werten state || $new aus), statt es zu ersetzen. Folglich überdauert ein früh geschriebener Schlüssel die gesamte Lebensdauer der Nachricht, sofern nicht eine Stage genau diesen Schlüssel absichtlich überschreibt; Beispiele sind die von Ingress gesäte origin-Herkunft und die dsn-Parameter.
Die Zusammenführung ist flach: state || {"auth": {"arc": "pass"}} würde das gesamte auth-Objekt ersetzen, nicht nur dessen arc-Mitglied. Stages, die ein Mitglied eines verschachtelten Objekts aktualisieren, lesen daher das aktuelle Objekt, ergänzen es und schreiben es als Ganzes zurück (genau das tun set_auth_verdict/set_auth_fields für auth.arc).
Die eine strukturelle Umschreibung ist dsn.rcpt, ein Array parallel zu rcpt_to: Jeder Helper, der einen Datensatz auf eine Teilmenge seiner Empfänger reduziert oder eine Gruppe auf einen Geschwisterdatensatz auffächert, schneidet dieses Array im Gleichschritt neu zu, und die Alias-Stage baut es neu auf, wenn sie eine gänzlich neue Empfängerliste schreibt. Eine Stage darf rcpt_to niemals ohne diese Helper anfassen.
Es gibt genau eine Ausnahme: pepsi-stage-bounce(1) ersetzt state durch ein einzelnes retry_since (unten), wobei es nur eine tls_required-Markierung "required" behält, wenn es eine Nachricht in eine Zustellungsstatusbenachrichtigung umschreibt, weil der Bounce eine brandneue Null-Absender-Nachricht ist, die keine der Herkunftsdaten des Originals erbt.
95.3.1.1.4. Schlüssel der obersten Ebene¶
Die folgenden Schlüssel werden von der Standard-Pipeline geschrieben. Eine Stage, die einen Schlüssel nicht erkennt, lässt ihn einfach unberührt (die Zusammenführungsregel bewahrt ihn), sodass die Menge offen ist; eigene Stages dürfen ihre eigenen hinzufügen.
95.3.1.1.4.1. origin¶
(Objekt) Die SMTP-Ursprungs-Metadaten der Verbindung, die die Nachricht zugestellt hat, von pepsi-ingress(1) gesät. Es wird von pepsi-stage-arc(1) gelesen (das die authserv_id und das gerenderte ar_results-Fragment benötigt, um die ARC-Authentication-Results-Identität ohne erneutes Ausführen von SPF/DKIM/DMARC zu reproduzieren) und von den Relay-Stages, deren Herabstufungsentscheidung zu 8BITMIME/SMTPUTF8 je Hop die ursprünglichen BODY=/smtputf8-Deklarationen heranzieht:
{
"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)
}
}
Die vier auth_*-Mitglieder beschreiben, wie sich die Sitzung ausgewiesen hat, im Unterschied zum benachbarten auth-Schlüssel unten, bei dem es darum geht, was die Nachricht behauptet. Sie werden festgehalten, weil local_origin ein einzelner Boolescher ist und zwei sehr verschiedene Aussagen zusammenfallen lässt: „ein von uns authentifiziertes Konto hat dies eingeliefert“ und „dies kam von einer Adresse, der wir zu vertrauen beschlossen haben“. Eine Richtlinien-Stage kann diese Unterscheidung aus dem Booleschen nicht wiedergewinnen, und ein Milter ebenso wenig, dem diese Mitglieder als die RFC-4954-Makros {auth_type} / {auth_authen} / {auth_author} / {auth_ssf} übergeben werden.
auth_methodWie sich die Sitzung authentifiziert hat:
sasl(einAUTHnach RFC 4954 war erfolgreich),peercred(ein UNIX-Socket-Peer, dessen uid auf ein erlaubtes Login auflöste),client-cert(ein TLS-Client-Zertifikat passte auf eine Pinnung) odermynetworks(die Peer-Adresse liegt inMYNETWORKS).null, wenn sich die Sitzung nicht authentifiziert hat. Ein späteres SASL-AUTHüberschreibt eine frühere Methode aus der Verbindungszeit: Es ist die stärkere Behauptung und die einzige, die einen Benutzernamen trägt.auth_mechanismDer erfolgreiche SASL-Mechanismus (
PLAIN,LOGIN), großgeschrieben. Nur beiauth_method = saslgesetzt. Die Nicht-SASL-Methoden lassen ihnnull, statt ein Nicht-Mechanismus-Token in ein Feld zu setzen, das ein Filter womöglich gegen eine Liste echter Mechanismen vergleicht.auth_identityDie Authentifizierungsidentität: die SASL-authcid oder das Login, auf das die uid eines UNIX-Peers auflöste.
nullbeimynetworksundclient-cert, die eine Adresse oder einen Schlüssel authentifizieren und niemanden benennen.peercredliefert daher eine Identität ohne Mechanismus — die ehrliche Beschreibung einer Sitzung, die der Kernel und nicht SASL authentifiziert hat.auth_authzidDie Autorisierungsidentität, nur festgehalten, wenn der Client darum bat, als jemand anderes zu handeln als der, als der er sich authentifiziert hat (das authzid-Feld von SASL
PLAIN).null, wenn beide gleich sind, was der Normalfall ist: RFC 4954 erlaubt eine leere authzid, und Clients wiederholen dort routinemäßig die authcid.from_boundtrue, wenn dasFrom:-Feld genau ein Postfach benennt und dieses Postfach auf einen konkreten (platzhalterfreien)USERNAME_MAP-Eintrag des authentifizierten Kontos oder auf dessen Standardlogin@HOSTNAMEpasste; andernfallsfalse, auch für eine Sitzung ohne Kontofreigabe. Die Erlaubnis, als eine Adresse zu senden, genügt zum Senden; an sie gebunden zu sein ist das, was einer Einlieferung erlaubt, für sie zu sprechen. pepsi-stage-encrypt(1) registriert einen Schlüssel aus der Nachricht oder führt einen E-Mail-Schlüsselbefehl nur aus, wennauth_methodmynetworksoderclient-certist odersasl/peercredmitfrom_bound = true: Ein Konto, dem*@example.orggewährt ist, darf als seine Kollegen senden, darf aber keinen Schlüssel für sie unterschieben können.ip_blocklistWas die von pepsi-reputation(1) heruntergeladenen IP-Sperrlisten über
remote_ipsagen:listedisttrue, wenn mindestens eine Liste sie nennt, undlistshat eintrue-Mitglied für jede Liste, die das tut. Nur für eine nicht authentifizierte Sitzung aus dem Netz festgehalten und nur, wenn mindestens eine aktivierte Liste aktuell genug war, um sie zu konsultieren (MAX_AGE); andernfalls fehlt das Mitglied, sodass „unbekannt“ nie mit „sauber“ verwechselt wird. Routen Sie danach mit pepsi-stage-if(1):STATE_PATH = origin.ip_blocklist.listed,VALUE = trueoderorigin.ip_blocklist.lists.NAMEfür eine Liste.
95.3.1.1.4.2. auth¶
(Objekt) Die eingehenden Authentifizierungsurteile, die der Ingress berechnet hat, auch im vorangestellten Authentication-Results-Header widergespiegelt. Das arc-Urteil wird als none gesät und von pepsi-stage-arc(1) überschrieben, sobald es die eingehende ARC-Kette neu bewertet (seine spf/dkim/dmarc-Geschwister bleiben unberührt). Gelesen von pepsi-stage-check-whitelist(1), dessen dkim_required-Schranke einen Datensatz bei auth.dkim = pass akzeptiert oder bei auth.arc = pass nur zusammen mit auth.dmarc = pass, und dessen sealer_domain-Schranke auth.arc_sealers nur konsultiert, wenn auth.arc pass ist:
{
"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 (Zeichenkette, optional) ist die DMARC-Richtlinie, die die From:-Domain veröffentlicht, none, quarantine oder reject (die strengste, wenn das Feld mehrere Domains nennt), unabhängig vom Urteil festgehalten; sie fehlt, wenn keine Autordomain einen Eintrag veröffentlicht. pepsi-stage-list-post(1) richtet seine DMARC-Abschwächung danach.
auth.display_name_mismatch (Zeichenkette, optional) ist nur bei Mail aus einer nicht authentifizierten Sitzung vorhanden, deren From:-Anzeigename (oder ein Kommentar im Feld) eine andere Adresse als die der eigenen Mailbox nennt: Es enthält diese behauptete Adresse, kleingeschrieben. Der Ingress stellt dann außerdem X-Pepsi-Warning: display-name-claims-other-address voran. Siehe pepsi-ingress(1), Authentication.
auth.warnings (Array von Zeichenketten, optional) führt jeden X-Pepsi-Warning-Wert auf, den der Ingress an die Nachricht geschrieben hat, in Header-Reihenfolge: display-name-claims-other-address, from-has-bidi-or-invisible-characters (ein From:, das ein bidirektionales Steuerzeichen oder ein unsichtbares Zeichen trägt), from-domain-resembles-served-domain (eine From:-Domain mit dem Skelett einer bedienten Domain, aber anderem Namen), attachment-name-has-bidi-or-invisible-characters (ein Anhangsdateiname mit einem solchen Zeichen), duplicate-header-date, duplicate-header-subject, duplicate-header-to, duplicate-header-cc, duplicate-header-reply-to und duplicate-header-sender (abweichende Kopien dieses Nachrichten-Header-Felds angenommen: für Cc immer, für die anderen unter MIME_ANOMALIES = log), from-ambiguous (ein From:, das sich nicht auf nur eine Weise lesen lässt oder Mailboxen in mehreren Domains nennt), served-domain-not-authenticated (ein From: in einer bedienten Domain von außen ohne DMARC-, ausgerichteten DKIM- oder ausgerichteten SPF-Pass), served-sender-not-authenticated (ein Sender: in einer bedienten Domain ohne ausgerichteten DKIM- oder SPF-Pass) und dmarc-fail-not-enforced (ein DMARC-fail, das die Konfiguration nicht umgesetzt hat). Fehlt, wenn keiner geschrieben wurde, und nie bei Mail aus einer authentifizierten Sitzung. Die letzten vier setzen außerdem die Markierung [external] an das Subject, sofern nicht EXTERNAL_SUBJECT_TAG = no. Siehe pepsi-ingress(1), Marking mail from outside.
95.3.1.1.4.3. local_origin¶
(boolescher Wert) Vom Ingress gesät: true, wenn die zustellende Sitzung authentifiziert war (der Client war in MYNETWORKS, hat ein SASL-AUTH abgeschlossen, ein passendes TLS-Client-Zertifikat vorgelegt oder war — auf einem UNIX-Socket mit AUTH_PEERCRED, dem dortigen Standardwert — ein Peer, dessen uid auf ein erlaubtes Login auflöste, der Weg, den jede lokal eingelieferte Nachricht nimmt; siehe die [pepsi-ingress-listener-*]-Abschnitte in pepsi.conf(5)), sonst false. Es markiert Mail, die von einem vertrauenswürdigen Absender stammt, und bleibt durch die Pipeline erhalten, damit nachgelagerte Stages es testen können (die Einstellungsschicht je Adresse stützt sich für local_origin-Nachrichten auf den Absender, und pepsi-stage-edit-settings(1) und die Wallet-Self-Service-Rolle von pepsi-stage-auto-pay(1) behandeln eine Nachricht nur dann als Steuernachricht, wenn sie local_origin ist).
95.3.1.1.4.4. notice¶
(Objekt) {"kind": KIND}, nur von der Komponente geschrieben, die die Nachricht verfasst hat, auf einer Nachricht, die Pepsi selbst geschrieben hat: enrol (der Anmeldelink der Konsole, pepsi-httpd(1)), secure-link (die Link-, PIN- und Bestätigungsbenachrichtigungen des Portals), secretary (die Challenge und die Bestätigungsbenachrichtigung), payment-request (pepsi-stage-anti-spam(1)), wallet (die Self-Service-Antwort von pepsi-stage-auto-pay(1)), settings (die Antwort von pepsi-stage-edit-settings(1)), keys (die Antworten auf Schlüsselbefehle und die Schlüsselbenachrichtigungen von pepsi-stage-encrypt(1)), key-change (die Benachrichtigung von pepsi-stage-autocrypt-learn(1)) und vacation (pepsi-stage-vacation(1)). secretary, payment-request und vacation gehen an einen Dritten und bleiben unmarkiert, solange für die Nachricht, die sie ausgelöst hat, eine adressbezogene Überschreibung gilt. Gelesen von pepsi-stage-encrypt(1) unter NOTICE_SIGNER, das genau die markierten Nachrichten mit der Benachrichtigungsidentität der Installation signiert. Nie vorhanden bei Mail von der Leitung, bei Portal-Antworten, Listen-Mail, Bounces oder TLS-Berichten.
95.3.1.1.4.5. dsn¶
(Objekt) Die RFC-3461-Parameter für Zustellungsstatusbenachrichtigungen, die der Absender angefordert hat, vom Ingress gesät: das ret/envid auf Nachrichtenebene und ein Array je Empfänger parallel zu rcpt_to aus notify/orcpt. Jede Stage muss es bewahren und beachten — die Relay-Stages geben die Parameter nur dann an den nächsten Hop weiter, wenn dieser DSN ankündigt, und pepsi-stage-bounce(1) zieht das notify je Empfänger heran, um zu entscheiden, ob überhaupt ein Bericht ausgegeben wird. Der Eintrag eines Empfängers trägt außerdem seinen RRVS=-Wert nach RFC 7293, unverändert, als rrvs: kein DSN-Parameter, aber je Empfänger und auf dieselbe Weise mit rcpt_to abgeglichen. Die lokale Zustellung prüft ihn, die Relay-Stages geben ihn weiter (siehe pepsi-ingress(1)), und ein Alias- oder ~/.forward-Ziel erbt ihn nicht. Der Eintrag eines solchen Ziels trägt stattdessen expanded_from, die vom Absender verwendete Adresse (die erste Adresse einer Kette von Expansionen), und pepsi-stage-bounce(1) berichtet über diese Adresse statt über das Ziel. pepsi-stage-aliases(1) und pepsi-stage-dot-forward(1) schreiben es und legen das Array dafür an, wenn der Absender keine Parameter angegeben hat. Es wird nie an einen nächsten Hop gesendet:
{
"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¶
(Zeichenkette) Die Markierung nach RFC 8689, von pepsi-ingress(1) gesät: "required", wenn die Nachricht mit dem REQUIRETLS-Parameter von MAIL FROM eintraf (auf einer TLS-geschützten Sitzung, der einzigen Art, auf der er angenommen wird), "no", wenn sie ohne den Parameter, aber mit einem TLS-Required: No-Header-Feld eintraf; sonst fehlt sie. Jeder aus der Nachricht aufgeteilte oder geklonte Datensatz erbt sie. Die Relay-Stages lesen sie (pepsi-stage-relay-to-internet(1), pepsi-stage-relay-to-smarthost(1)): "required" bedeutet validiertes TLS zu einem validierten nächsten Hop, der REQUIRETLS ankündigt, oder einen Bounce; "no" macht die DANE- und MTA-STS-Richtlinie der Empfängerdomain für diese Nachricht zur bloßen Empfehlung. pepsi-stage-bounce(1) gibt eine "required"-Nachricht nur mit Headern zurück und kopiert die Markierung auf die DSN, der eine Schlüssel des Zustands des Originals, den eine DSN behält:
{ "tls_required": "required" }
95.3.1.1.4.7. bounce¶
(Objekt) Von jeder Stage geschrieben, die eine Nachricht zu ihrem BOUNCE_STAGE routet — den Zustell-Stages (pepsi-stage-relay-to-internet(1), pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1)) und pepsi-stage-discard(1), aber ebenso 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) und pepsi-stage-dot-forward(1). Sie alle bauen es mit denselben gemeinsamen Helpern, sodass die Form unten dieselbe ist, welche Stage es auch geschrieben hat. Es wird von pepsi-stage-bounce(1) verbraucht, um den Bericht zu bauen. Sein kind ist permanent (ein Failure-Bounce, Action: failed), success (ein positiver Bericht, Action: delivered), delay (Action: delayed) oder unknown (die Zustellung wurde aufgegeben, und die Nachricht kann angekommen sein, Action: failed mit Status: 4.4.2); diagnostic und failed_recipient sind der menschenlesbare Grund und der betroffene Empfänger, und die optionalen notify/orcpt/envid werden aus dem state.dsn-Eintrag des Empfängers kopiert, sodass die Bounce-Stage NOTIFY beachten und das ursprüngliche ENVID/ORCPT übernehmen kann; ebenso expanded_from, das den Bericht diese Adresse mit einer generischen Diagnose nennen lässt statt des Ziels und seiner Antwort. Die Relay-Stages halten außerdem strukturierte Detailangaben zum nächsten Hop fest (remote_mta, smtp_code, enhanced_status, phase, reply_text), sodass eine Bounce-Vorlage genau angeben kann, warum der nächste MTA die Nachricht abgelehnt hat, und enhanced_status speist das DSN-Status:-Feld. pepsi-stage-relay-to-lmtp(1) hat keinen eigenen Bounce, zu dem es routen könnte: Es schreibt dieses Objekt auf den Datensatz, den es zu NEXT_STAGE, QUOTA_LIMIT_STAGE, SIEVE_REJECT_STAGE, UNKNOWN_MAILBOX_STAGE oder (bei success/delay) NOTIFY_STAGE routet, wobei remote_mta den LMTP-Socket oder host:port nennt. Ein von pepsi-stage-relay-to-maildir(1) abgelehntes volles Postfach trägt smtp_code 552, enhanced_status 5.2.2 und phase local delivery. Das ret auf Nachrichtenebene wird aus demselben Grund wie envid ebenfalls hier mitgeführt: Die Bounce-Stage löscht state, während sie die Nachricht umschreibt, sodass alles, was sie danach noch braucht, in diesem Objekt liegen muss:
{ "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¶
Zwischendaten, die die Zustell-Stages (und pepsi-stage-milter(1) bei einem Aufschub) festhalten, wenn sie eine Nachricht mit pause für eine Wiederholung pausieren: attempts (Zahl) ist die Anzahl der bisherigen Versuche, was den Wiederholungs-Backoff steuert, und delay_sent (boolescher Wert, nur vorhanden, wenn wahr) markiert, dass die einmalige NOTIFY=DELAY-DSN bereits ausgegeben wurde, sodass sie nie zweimal gesendet wird. pepsi-stage-anti-spam(1) schreibt delay_sent auf dieselbe Weise an seinem DELAY_DSN_AFTER-Kontrollpunkt und last_error, solange sein Händler-Backend nicht verfügbar ist.
last_error (Zeichenkette) ist der jüngste Fehlertext. Er ist nicht auf den Wiederholungspfad beschränkt: Die Zustell-, Milter-, Krypto-, DKIM-Signier- und ~/.forward-Stages schreiben ihn ebenfalls, wenn sie eine Nachricht terminal fehlschlagen lassen, sodass er bei einem failed-Datensatz das Erste ist, was man liest (pepsi-queue(1) zeigt ihn als Teil des state des Datensatzes, und pepsi-status(1) führt ihn unter jeder hängengebliebenen Nachricht auf).
95.3.1.1.4.9. temporary_failures / temporary_stage¶
(Zahl / Zeichenkette) Wird zusammen mit last_error vom Stage-Gerüst geschrieben, wenn der Fehler einer Stage nicht als permanent markiert war – die Schuld des Hosts und nicht der Nachricht (siehe pepsi-dispatch(1)): wie oft die Nachricht bisher deswegen bei temporary_stage pausiert wurde, was den Backoff von einer Minute, sich verdoppelnd, bis zu einer Stunde steuert. Ein bei einer anderen Stage festgehaltener Zähler wird nicht fortgesetzt. Entfernt, wenn der Worker aufgibt.
95.3.1.1.4.10. failed_stage / failure_class / failed_at¶
Die Aufzeichnung eines Fehlschlags, der auf diesem Host geschah und nicht beim nächsten Hop. failed_stage (Zeichenkette) ist die Stage, bei der er geschah. failure_class (Zeichenkette) sagt, wie er endete: permanent (die Stage markierte den Fehler als Mangel der Nachricht), retries-exhausted (bis MAX_LIFETIME wiederholt), crashed oder timed-out (die Nachricht hat ihren Worker dreimal abstürzen oder hängen lassen) oder quarantine-expired (in einer Quarantäne-Stage über [pepsi-queue] QUARANTINE_MAX_AGE_DAYS hinaus festgehalten, siehe pepsi-queue(1), oder über das MAX_HOLD einer pepsi-stage-quarantine(1)-Stage hinaus auf dem Weg zu EXPIRE_STAGE). failed_at (Zeichenkette, RFC 3339) wird von der Datenbank gestempelt, sobald der Datensatz failed oder timeout wird; MIN_AGE von pepsi-failure-bouncer(1) zählt ab diesem Zeitpunkt. pepsi-stage-bounce(1) baut aus failed_stage und failure_class eine DSN mit einem generischen Text, wenn kein Relay den Fehlschlag gemeldet hat (bounce oben); last_error wird nie in eine DSN kopiert.
95.3.1.1.4.11. arc_temperrors¶
(Zahl) Von pepsi-stage-arc(1) jedes Mal geschrieben, wenn sie beim Validieren einer eingehenden ARC-Kette auf einen vorübergehenden DNS-Fehler traf: Die Nachricht wird fünf Minuten pausiert und wiederholt, höchstens dreimal; schlagen die Abfragen nach der dritten Pause noch fehl, wird die Kette mit cv=fail versiegelt, wie es bei einer fehlgeschlagenen geschähe.
95.3.1.1.4.12. mime_anomalies, mime_normalise, mime_normalised¶
Von pepsi-ingress(1) für eine Nachricht geschrieben, deren MIME-Struktur mehrdeutig ist (siehe dort Ambiguous MIME structure). mime_anomalies (Array von Zeichenketten) führt die gefundenen Klassen auf — 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 (die harten Klassen, unter MIME_ANOMALIES = enforce abgelehnt), conflicting-cc (die markierte Klasse, wie empfangen mit X-Pepsi-Warning gespeichert), 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 (die weichen Klassen, umgeschrieben). mime_normalise (boolescher Wert) ist true, solange die Umschreibung der weichen Klassen pepsi-stage-arc(1) geschuldet ist, das es nach getaner Arbeit auf false setzt: Eine Nachricht, die mit einer ARC-Kette eintraf, wird wie empfangen gespeichert, damit die Kette über die Bytes verifiziert werden kann, die ihre Versiegler signiert haben. mime_normalised (Zeichenkette) nennt das Programm, das die Nachricht umgeschrieben hat, pepsi-ingress oder pepsi-stage-arc; fehlt, wenn nichts umgeschrieben wurde (log-Modus oder nur innerhalb signierter oder verschlüsselter Teile).
95.3.1.1.4.13. ingress_milter¶
(Array von Objekten) Von pepsi-ingress(1) für eine Nachricht geschrieben, zu der während der SMTP-Sitzung Milter befragt wurden (siehe dort Milter). Ein Objekt je Milter, der etwas über die Nachricht entschieden hat, in der Reihenfolge, in der sie gefragt wurden: name (Zeichenkette), das Abschnittssuffix des Milters; verdict (Zeichenkette), continue, accept oder failed; modifications (Array von Zeichenketten, falls vorhanden), was er geändert hat (addheader:X-Spam-Score, replbody, addrcpt:…); failed (boolescher Wert, wenn wahr), der Milter konnte nicht befragt werden, und sein ON_FAILURE hat die Nachricht eingelassen. Eine abgelehnte oder verworfene Nachricht wird nicht gespeichert, daher trägt kein Datensatz eine Ablehnung.
95.3.1.1.4.14. arc_original¶
(Zeichenkette) Von pepsi-ingress(1) mit dem Wert pepsi-ingress geschrieben, wenn ein Milter eine Nachricht geändert hat, die eine ARC-Kette trägt: Die Nachricht, wie sie empfangen wurde, wird in workqueue.arc_original_body_id aufbewahrt, und pepsi-stage-arc(1) verifiziert die eingehende Kette über diese Bytes, während sie die gespeicherte Nachricht versiegelt.
95.3.1.1.4.15. strikes¶
(Zahl) Von pepsi-dispatch(1) jedes Mal geschrieben, wenn die Nachricht ihren Worker zum Absturz brachte oder ihn über MAX_RUNTIME hinaus festhielt; der dritte Strike lässt die Nachricht fehlschlagen, nur entscheidet bei einem in einer Zustell-Stage beendeten Worker MAX_LIFETIME.
95.3.1.1.4.16. lost_acks¶
(Zahl) Von pepsi-stage-relay-to-lmtp(1) geschrieben: wie viele Versuche die ganze Nachricht gesendet und keine Antwort erhalten haben. Zusammen mit strikes an dieser Stage entscheidet es, wann die Stage aufhört und meldet, dass das Ergebnis unbekannt ist.
95.3.1.1.4.17. retry_since¶
(Zeichenkette, RFC 3339) Von pepsi-stage-bounce(1) auf der DSN geschrieben, die es baut und die die Nachricht in ihrem Datensatz ersetzt: der Zeitpunkt, ab dem das MAX_LIFETIME der Stages statt ab der Ankunftszeit des Datensatzes gezählt wird, sodass eine DSN nicht schon abgelaufen zur Welt kommt.
95.3.1.1.4.18. srs¶
(Objekt) Von pepsi-stage-srs(1) geschrieben, wenn es den Umschlagabsender umschreibt, und hält die ersetzte Adresse fest:
{ "srs": { "original": "alice@example.org" } }
Es existiert für eine DSN, die diese Installation selbst erzeugt. SRS läuft notwendigerweise vor der Zustell-Stage, denn den Umschlag für die Übergabe umzuschreiben ist sein ganzer Zweck. Zu dem Zeitpunkt, zu dem eine Zustell-Stage complete_success aufruft oder ein Relay einen Fehlschlag zu seiner BOUNCE_STAGE routet, ist das mail_from des Datensatzes daher einer unserer eigenen SRS-Aliase. pepsi-stage-bounce(1) würde die DSN dann an diesen Alias adressieren. Die DSN ginge hinaus zum nächsten Hop und käme über unseren eigenen MX zum Dekodieren wieder herein, und sie müsste als Null-Absender-Nachricht die gesamte eingehende Pipeline überstehen, nur um bei einer Adresse anzukommen, die die ganze Zeit im Datensatz stand. Wo diese Rundreise nicht funktioniert, geht die DSN verloren, ohne dass irgendetwas es meldet.
Die Bounce-Stage zieht diesen Wert daher mail_from vor. Er wird festgehalten, statt durch Umkehrung des Alias wiedergewonnen zu werden, weil Srs::reverse das SRS-HMAC-Geheimnis benötigt und eine Stage, deren Aufgabe das Verfassen eines Bounce ist, keinen Grund hat, Schlüsselmaterial zu halten: Der Absender ist gewöhnliche Nachrichtenmetadaten, und dafür ist state da.
Wird nur geschrieben, wenn abwesend, sodass eine zweimal umgeschriebene Nachricht die Adresse behält, die einen echten Korrespondenten benennt, und nicht den Zwischenalias. Ein Bounce (Null-Absender) wird nie umgeschrieben und hält daher nie einen fest; ein leerer Wert liest sich als abwesend, und die Bounce-Stage fällt auf den Umschlagabsender zurück. Eine Kopie, die mit einer Weiterleitungs-Rücksendeadresse hinausgeht, hält ihn ebenfalls fest.
95.3.1.1.4.19. forward_return¶
(boolescher Wert) Von pepsi-ingress(1) auf dem Datensatz geschrieben, den es aus einem entfernten Bericht über eine weitergeleitete Kopie erzeugt (einem, der an die Weiterleitungs-Rücksendeadresse der Kopie gesendet wurde, siehe pepsi-stage-srs(1)). Der Datensatz tritt bei der Bounce-Stage ein, mit dem ursprünglichen Absender als Umschlagabsender, der vom Absender verwendeten Adresse als Empfänger und einem bounce-Eintrag, der nur das Ergebnis und die Statusklasse des Berichts trägt; pepsi-stage-bounce(1) verwandelt ihn in die eigene DSN dieses Hosts. Der Bericht selbst wird nicht gespeichert.
95.3.1.1.4.20. pay_deadline¶
(Zahl) Von pepsi-stage-anti-spam(1) geschrieben: Unix-Epoch-Sekunden, die Frist, bis zu der die Pay-to-Send-Bestellung beglichen sein muss. Sie wird in state gehalten (statt in der timeout-Spalte des Datensatzes), weil der Dispatcher timeout nullt, wann immer er eine pausierte Nachricht erneut einreiht. Ein als JSON-Zeichenkette geschriebener Wert wird als „keine Frist“ gelesen; wer dies von Hand setzt, muss also eine Zahl schreiben. Die Stage schließt ihre Zahlungsschranke kurz, wenn state.paid true ist.
95.3.1.1.4.21. spam / paid¶
(boolescher Wert) Kurzschluss-Flags gegen Missbrauch.
spam wird von pepsi-stage-check-whitelist(1) geschrieben, das es bei einem Treffer in der weißen Liste auf false setzt (und es andernfalls ungesetzt lässt), von pepsi-ingress(1), das es für eine Nachricht auf false setzt, deren einziger Empfänger <Postmaster> ist (Erreichbarkeit nach RFC 5321 §4.5.1), und von pepsi-stage-secretary(1), das es bei einer Nachricht auf false setzt, die es freigibt, weil ihr Absender bestätigt hat. Ein Wert false lässt pepsi-stage-block-language(1), pepsi-stage-secretary(1) und pepsi-stage-anti-spam(1) die Nachricht weiterleiten, ohne ihre Schranke anzuwenden. Ein Wert true lässt pepsi-stage-anti-spam(1) die Nachricht verwerfen, statt sie an einer Schranke zu halten, schickt sie auf den Timeout-Pfad von pepsi-stage-secretary(1), unterdrückt das Lernen von Schlüsseln in pepsi-stage-autocrypt-learn(1), sofern nicht das LEARN_FROM_SPAM jener Stage an ist, und blockiert die RFC-3834-Auto-Responder, die die gemeinsamen Unterdrückungsregeln verwenden (pepsi-stage-vacation(1), die Challenge des Sekretärs und die automatischen Antworten der Mailinglisten). Nur ein expliziter boolescher Wert zählt: Ein fehlender Schlüssel löst keines der beiden Verhalten aus.
Beachten Sie: Keine mitgelieferte Stage schreibt jemals spam = true: Die obigen Schreiber schreiben stets nur false. Der Wert true ist der Haken, den eine milter-getriebene Pipeline, ein Betreiber oder eine standortspezifische Stage verwendet — dieselbe Anordnung wie bei paid weiter unten.
paid wird von pepsi-stage-anti-spam(1) selbst geschrieben, und immer nur als false: Die Stage speichert bei jeder Pause, sobald die Bestellung existiert, paid = false neben pay_deadline (eine Pause, weil die Bestellung noch nicht erstellt werden konnte, trägt nur pay_deadline und last_error), und das ist es, was die Nachricht als auf Zahlung wartend markiert. Meldet der Händler die Bestellung als beglichen, schaltet die Stage die Nachricht einfach weiter, sodass keine Stage im Baum je paid = true schreibt — dieser Wert ist ein Überschreibungshaken für einen Betreiber oder eine standortspezifische Stage, und die Zahlungsschranke wird übersprungen, wenn er gesetzt ist (so wie sie es wird, wenn spam false ist).
95.3.1.1.4.22. dot-forwarders¶
(Array von Zeichenketten) Die kleingeschriebenen Login-Namen, deren ~/.forward-Dateien diesen Datensatz weitergeleitet haben, d. h. die Weiterleitungskette, die zu ihm geführt hat, von pepsi-stage-dot-forward(1) als Weiterleitungsschleifen-Schutz gepflegt. Ein weitergeleiteter Datensatz erhält die Kette des Datensatzes, aus dem er stammt, plus das eine Login, das ihn weitergeleitet hat, sodass die Liste einen Weiterleitungspfad beschreibt, nicht jedes ~/.forward, das die Nachricht durchlaufen hat. Weil eine weitergeleitete Nachricht die Pipeline neu startet, wird ein Empfänger, dessen Benutzer hier bereits aufgeführt ist, gebounct, statt erneut durch sein ~/.forward geführt zu werden, sodass ein Zyklus (~bob → alice, ~alice → bob) terminiert.
95.3.1.1.4.23. language¶
(Zeichenkette) Von pepsi-stage-detect-language(1) als Accept-Language-artige Zeichenkette geschrieben, die die erkannte(n) Sprache(n) des Nachrichtentexts beschreibt, mit q-Werten in Präferenzreihenfolge.
pepsi-stage-block-language(1) liest sie, um die Nachricht gegen seine Allow-/Deny-Listen zu bewerten, doch sie ist ebenso der Lokalisierungs-Schlüssel: Jede Stage, die Prosa für einen Menschen verfasst, wählt daraus die Sprache ihrer Vorlage oder Nachricht und fällt, wenn sie fehlt oder nichts Unterstütztes benennt, auf das DEFAULT_LANGUAGE der Stage zurück, wo sie eines hat (pepsi-stage-vacation(1), pepsi-stage-secretary(1)), und sonst auf Englisch — pepsi-stage-vacation(1) (die Abwesenheitsnotiz), pepsi-stage-anti-spam(1) (die Zahlungsaufforderung), pepsi-stage-secretary(1) (die Challenge), pepsi-stage-encrypt(1), pepsi-stage-auto-pay(1) und pepsi-stage-secure-link(1) (ihre Antwortnachrichten) und pepsi-stage-edit-settings(1) (seine Bestätigungs- oder Fehlerantwort). Deshalb kann eine Installation, die gar keine Sprach-Blockierung betreibt, die Erkennungs-Stage dennoch in der Pipeline wollen.
95.3.1.1.4.24. vacation¶
(Objekt) Von pepsi-stage-vacation(1) geschrieben, wenn es eine Nachricht stellvertretend für den Empfänger beantwortet hat, und hält fest, was es getan hat:
{ "vacation": { "notified": true,
"recipient": "alice@example.org", // who is away
"range": "2026-08-01:2026-08-14",
"language": "de" } } // the notice's language
Keine Stage richtet sich danach, solange Sie keine dafür konfigurieren: Es existiert, damit die Entscheidung in pepsi-queue(1) sichtbar ist, damit pepsi-stage-if(1) darauf verzweigen kann und damit eine Supportfrage zu einer überraschenden Abwesenheitsantwort aus dem Datensatz heraus statt aus dem Journal beantwortbar ist. Abwesend bei jeder Nachricht, die nicht beantwortet wurde.
95.3.1.1.4.25. secretary¶
(Objekt) Von pepsi-stage-secretary(1) geschrieben. Bei einer Nachricht, die es zurückhält:
{ "secretary": { "challenge": "00112233445566778899aabbccddeeff", // the cookie
"deadline": 1769812345, // Unix seconds, when it expires
"whitelist": "correspondents" } } // where a confirmation writes
Eine Bestätigung fügt "confirmed": true hinzu, während sie den Datensatz freigibt (die Stage leitet ihn dann mit spam = false weiter); eine gebouncte Challenge fügt "abandoned": true hinzu und schickt ihn vorzeitig auf den Timeout-Pfad. Eine Nachricht, für die die Stage keine Challenge stellen wollte und die sie zu ihrem UNCHALLENGEABLE_STAGE geroutet hat, trägt stattdessen { "secretary": { "unchallengeable": "<reason>" } }. Der Timeout-Pfad entfernt den Schlüssel vollständig: Nichts von einer Challenge überdauert ihn. Wie pay_deadline wird die Frist in state gehalten, weil der Dispatcher das timeout des Datensatzes löscht, wenn er eine pausierte Nachricht wieder einreiht.
95.3.1.1.4.26. keydisc¶
(Objekt) Worauf eine geparkte Nachricht wartet: die Korrespondentenadresse, deren Schlüssel im Cache nicht gefunden werden konnte, und wann das Warten begann:
{ "keydisc": { "address": "bob@example.com", // the address a key is wanted for
"since": 1769812345 } } // Unix seconds, when the park happened
Es wird vom Park-Terminal der Schlüsselentdeckung geschrieben, das in einem Round-Trip alles committet, was die Stage bereits umgeschrieben hatte, diesen Schlüssel zusammenführt, den Datensatz mit einem Wiederholungs-Timeout auf paused setzt und eine Anfrage in pepsi.key_request einreiht. Ein pepsi-keydisc(1)-Dienst, der diese Anfrage erledigt, findet die Wartenden über keydisc.address — durch einen partiellen Index genau auf diesem Ausdruck — und schaltet sie zurück auf pending, sodass eine Stage den Schlüssel weder umbenennen noch von Hand schreiben darf. Das Wiederholungs-Timeout ist das Sicherheitsnetz für eine Installation, die überhaupt keinen Entdeckungsdienst betreibt: Es ist stets später gesetzt als die Entdeckungsfrist, sodass die Freigabe normalerweise zuerst geschieht.
Die Freigabe bewegt nur den status des Datensatzes und löscht sein timeout, sodass der Schlüssel sie überlebt: Eine fortgesetzte Nachricht trägt weiterhin die Aufzeichnung des soeben beendeten Wartens, und eine Stage, die erneut parkt, überschreibt sie schlicht.
95.3.1.1.4.27. secure_link¶
(Objekt) Markiert eine Nachricht, die das Secure-Link-Portal von pepsi-httpd(1) injiziert hat: eine Antwort, die ein Empfänger im Portal eingetippt hat, nachdem er eine Nachricht geöffnet hatte, die pepsi-stage-secure-link(1) dort versiegelt hatte:
{ "secure_link": { "reply": true,
"token": "b3d1…" } } // the portal token replied to
local_origin fehlt bei einer solchen Nachricht bewusst, und diese Abwesenheit ist die ganze Sicherheitseigenschaft: Sie ist das einzige Bit, das eine Portalantwort von einem offenen Relay trennt. Ohne es kann die Antwort den Einlieferungspfad nicht nehmen, es gibt also kein Weiterleiten als wir, kein automatisches Aufnehmen ihres Empfängers in die weiße Liste und kein SRS als lokaler Ursprung. Sie wird als das behandelt, was sie ist: eingehende Mail, die zufällig auf unserem eigenen Webserver entstanden ist.
95.3.1.1.4.28. tlsrpt¶
(boolescher Wert) Ein Schleifenschutz-Flag, das auf einer Nachricht gesetzt wird, die selbst ein SMTP-TLS-Reporting-Bericht ist (pepsi-tlsrpt(1)). Die Relay-Stages überspringen das Festhalten eines pepsi.tls_session-Datensatzes für eine solche Nachricht, sodass ein Bericht über eine fehlgeschlagene Berichtszustellung nicht rekursieren kann.
95.3.1.1.4.29. auth.arc¶
Von pepsi-stage-arc(1) mit dem Urteil der von ihm neu bewerteten eingehenden ARC-Kette überschrieben, das das none ersetzt, das der Ingress unter auth gesät hat (siehe den auth-Schlüssel oben): none (keine Kette), pass oder fail (jede Kette, die nicht validiert wurde, einschließlich eines DNS-temperror und eines mit rsa-sha1 signierten Sets).
95.3.1.1.4.30. auth.arc_sealers¶
(Array von Zeichenketten) Von pepsi-stage-arc(1) neben auth.arc geschrieben: das d= der ARC-Seal-Felder, die die Nachricht bei ihrer Ankunft trug, kleingeschrieben, um einen abschließenden Wurzelpunkt gekürzt, dedupliziert und nach Instanz geordnet, sodass die dem Urheber nächste ADMD zuerst kommt. Unser eigenes ARC_DOMAIN ist nie enthalten — die Liste wird gelesen, bevor das eigene Set dieser Stage gerendert wird:
{ "auth": { "arc": "pass", "arc_sealers": ["lists.example.org", "mx.forwarder.example"] } }
Es existiert, weil auth.arc allein keine Richtlinienentscheidung tragen kann: RFC 8617 §8.4 stellt fest, dass eine gültige Kette keine Vertrauenswürdigkeit vermittelt, sondern nur, dass die benannten ADMDs die Nachricht bearbeitet haben, und überlässt den Rest dem Empfänger. Einen akzeptablen Vermittler zu benennen ist diese lokale Richtlinie, und dies ist das, wogegen eine solche Regel abgeglichen wird — die sealer_domain-Datensätze von pepsi-stage-check-whitelist(1).
Für eine Kette, die validiert wurde, werden nur die Versiegler aufgeführt, deren eigene ARC-Message-Signature sich noch über die Nachricht verifizieren lässt: Die Kettenvalidierung prüft nur die neueste, und die Siegel decken die Nachricht nicht ab, sodass ein echtes, auf anderen Inhalt kopiertes Set sonst einen Versiegler nennen würde, der ihn nie gesehen hat. Für eine Kette, die nicht validiert wurde, ist das Array die Aufzeichnung dessen, was die Nachricht behauptet hat; ein Siegel parst, ohne zu verifizieren. Jeder Leser muss daher auth.arc = pass verlangen, bevor er einem Eintrag traut, was check-whitelist tut, indem es andernfalls die ganze Liste verwirft.
95.3.1.1.4.31. crypto¶
(Objekt) Was die Ende-zu-Ende-Krypto-Stages getan haben. Die ausgehende Hälfte, crypto.out, wird von pepsi-stage-encrypt(1) geschrieben:
{ "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 ist der From:-Autor, nie der Umschlagabsender: Die Signatur handelt von dem Autor, den der Empfänger sieht. Das outcome jedes Empfängers ist eines von encrypted, signed-only, cleartext, secure-link, bounced oder oversize, und route benennt den ON_NO_KEY/ON_OVERSIZE-Pfad, wenn es nicht der gewöhnliche war. reason trägt eine kurze Wendung für das Journal des Betreibers und für den Bounce.
content_algorithm und downgraded werden festgehalten, damit ein Betreiber „mit wem reden wir noch in SEIPDv1?“ beantworten kann, ohne Journale zu lesen. downgraded erscheint nur neben einem content_algorithm: ein false bei einem Empfänger, an den überhaupt nicht verschlüsselt wurde, läse sich als „wir haben verschlüsselt, ohne herabzustufen“, was eine andere Behauptung ist.
key_source und trust lauten beide own, wenn der Empfänger eine Adresse ist, für die diese Installation eine eigene Identität hält. Das ist kein Rang auf der Entdeckungsleiter: Unser eigener Schlüssel verdrängt den pepsi.peer_key-Cache für eine solche Adresse vollständig, sodass keine MIN_TRUST-Untergrenze gilt und kein entdeckter Schlüssel herangezogen wurde. Siehe pepsi-stage-encrypt(1).
Da die Stage auseinandergehende Empfänger auf je einen Datensatz aufteilt, enthält das recipients-Objekt eines Datensatzes normalerweise genau die Empfänger im rcpt_to dieses Datensatzes.
key_attached (boolesch, nur vorhanden, wenn wahr) hält fest, dass der öffentliche Schlüssel des Absenders als application/pgp-keys-Datei mitging (ATTACH_KEYS_AS_FILES). client_protected (boolesch, nur vorhanden, wenn wahr) hält fest, dass der eigene Mail-Client des Benutzers die Einlieferung bereits verschlüsselt hatte, sodass die Stage sie unangetastet ließ: keine Verschlüsselung, keine Signatur, kein Autocrypt:-Header und keine Schlüsseldatei von Pepsi.
Die eingehende Hälfte, crypto.in, wird von pepsi-stage-decrypt(1) geschrieben:
{ "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 ist not-encrypted, decrypted, failed, for-client oder withheld; bei failed trägt ein benachbarter failure-Schlüssel den maschinenlesbaren Grund (no-decryption-key, decryption-failed, too-large, …), und failed_unauthenticated (boolescher Wert, nur vorhanden, wenn wahr) hält fest, dass das fehlgeschlagene Chiffrat keinen Integritätsschutz trug (oder nicht identifiziert werden konnte), was ON_DECRYPT_FAILURE = bounce-if-unproblematic verwirft, statt einen Bounce zu erzeugen. withheld ist eine für den Client des Empfängers ungeöffnet weitergereichte Nachricht, durch UNAUTHENTICATED_PLAINTEXT = require-signature oder OPEN_ENVELOPED_DATA = no. route benennt den ON_DECRYPT_FAILURE/ON_BAD_SIGNATURE-Pfad, wenn es nicht der gewöhnliche war (quarantine, bounce, bounce-generic oder drop; eine schlechte Signatur aus einem enveloped-data-Container unter ON_BAD_SIGNATURE = bounce ist drop).
for-client bedeutet, dass die Nachricht an den eigenen MUA-Schlüssel des Empfängers verschlüsselt ist (eine Identität mit custody = client, deren privater Teil nur in seinem Mail-Client liegt) und ungeöffnet weitergereicht wurde, auch wenn einer unserer eigenen Schlüssel ebenfalls Empfänger war. Es ist kein Fehlschlag: ON_DECRYPT_FAILURE wird nicht herangezogen. Das benachbarte for_client ist dann true, und client_fingerprint benennt den Schlüssel. Es wurde nichts verifiziert, daher wird signature_verified nicht gesetzt.
unauthenticated (boolescher Wert, nur vorhanden, wenn wahr) hält fest, dass der Klartext aus einem Chiffrat ohne Integritätsschutz stammt (einem S/MIME-EnvelopedData-Container, container an der Schicht) und keine gültige Signatur darin den Klartext abdeckt, sodass nichts eine blockweise Umschreibung ausschließt (die CBC-Gadgets von EFAIL). sanitised (text) sagt dann, dass der Klartext auf Inhalt reduziert wurde, den kein Client als Markup darstellt ([stage-decrypt] UNAUTHENTICATED_PLAINTEXT = text); es wird auch ohne unauthenticated gesetzt, wenn DECRYPTED_MARKUP = text einen authentifizierten Klartext reduziert hat. withheld als decryption bedeutet, dass dieselbe Nachricht stattdessen ungeöffnet weitergereicht wurde (require-signature): kein Fehlschlag, nichts hat sie für den Benutzer geöffnet, und decrypted ist false.
isolated (Array, nur vorhanden, wenn nicht leer) führt die Regeln auf, die die Nachricht vor der Entschlüsselung oder einen wiedergewonnenen Klartext verändert haben: encrypted (die erste verschlüsselte Einheit einer Nachricht, die Chiffrat neben anderem Inhalt trug, wurde zur Nachricht, und die anderen Teile wurden in inerte Anhänge verschoben, ISOLATE_ENCRYPTED) und signed (unsignierter Inhalt neben signiertem Inhalt wurde verworfen, ISOLATE_SIGNED). encrypted wird auch aufgeführt, wenn nur angehängte Nachrichten reduziert wurden; nested (Ganzzahl, nur vorhanden, wenn nicht null) zählt sie.
protected_mismatch (Array, nur vorhanden, wenn nicht leer) nennt die geschützten Header-Felder (from, to, reply-to, mail-reply-to, mail-followup-to, subject), deren signierte Kopie innerhalb der Nachricht von dem äußeren Feld abweicht, das dem Empfänger gezeigt wird. Eine Abweichung bei from oder einem antwortlenkenden Feld (reply-to, mail-reply-to, mail-followup-to) kostet die Signatur ihr Vertrauen, weil die Signatur dann für eine Nachricht von jemand anderem bürgt oder Antworten irgendwohin gingen, was der Unterzeichner nicht gesagt hat: valid wird als valid-untrusted gemeldet, sodass signature_verified nicht gesetzt wird. Ein antwortlenkendes Feld, das eine Mailingliste hinzugefügt hat (List-Id vorhanden, keines der drei signiert), wird gemeldet, behält aber valid, mit signature.reply_to_unsigned (boolescher Wert, nur vorhanden, wenn wahr). Ein subject, das sich nur durch vorn eingefügte eingeklammerte Segmente unterscheidet, ist keine Abweichung; ein größerer Unterschied wird gemeldet und bei einer valid-Signatur stattdessen der signierte Betreff angezeigt, festgehalten als subject_promoted (boolescher Wert, nur vorhanden, wenn wahr). to-Unterschiede werden nur gemeldet, da Weiterleitungs- und Listensoftware es legitim ändern. Ein äußeres Subject:, das der eigene Platzhalter des Header-Schutzes ist, zählt nicht. Dieselbe Liste erscheint als protected-mismatch= im X-Pepsi-Crypto-Header.
signer_domain (Zeichenkette, nur dann vorhanden) ist die Domain des Unterzeichners als A-Label, wenn sie ein internationalisierter Domainname ist oder wie eine bediente oder bekannte Domain aussieht (signature.withheld = lookalike-domain).
usually_signed (Objekt, nur dann vorhanden) wird auf einer Nachricht ohne valid-Signatur gesetzt, deren From:-Adresse innerhalb von MISSING_SIGNATURE_WINDOW_DAYS eine hatte: last_valid_signature (Ganzzahl) ist, wann diese Signatur zuletzt verifiziert wurde, in Unix-Sekunden (pepsi.signed_sender). X-Pepsi-Crypto trägt es als usually-signed=<date>; was folgt, bestimmt ON_MISSING_SIGNATURE (pepsi-stage-decrypt(1)).
demoted und dropped (Ganzzahlen, nur vorhanden, wenn nicht null) zählen die Teile, die ISOLATE_ENCRYPTED aus der Nachricht verschoben hat: demoted die als Anhänge zugestellten (jede Datei, in die ein verschobenes Chiffrat geöffnet wurde, zählt einmal), dropped die nicht zugestellten – neben einem ungeöffnet weitergereichten PGP/MIME- oder S/MIME-Container und, neben einem signierten Klartext, Klartext und Chiffrat, die nicht mit demselben Schlüssel signiert sind.
Die Anwesenheit von encrypted oder decrypted mit dem Wert true sagt außerdem pepsi-stage-bounce(1) und den automatisch antwortenden Stages, den Inhalt der Nachricht zurückzuhalten: Eine DSN zitiert dann nur ihre Adressierungsfelder, und keine Antwort zitiert ihren Betreff.
signature.binding (Zeichenkette, vorhanden, wenn ein Schlüssel gefunden wurde) ist, wie sich der Schlüssel des Unterzeichners zur From:-Adresse verhielt, wie der Verifizierer sie sah: matched, mismatched oder no-identity (der Schlüssel nennt keine Adresse). signature.anchor (Zeichenkette, vorhanden bei einer verankerten S/MIME-Signatur) ist der Fingerabdruck des ca_trust-Ankers, bei dem die Kette endete. signature.bound_to (Zeichenkette, nur bei ``valid`` vorhanden) ist die Adresse, an die die Signatur gebunden ist, diejenige, die die Markierung [verified: …] nennt. signature.withheld (Zeichenkette, nur dann vorhanden) ist, warum eine Signatur, die verifiziert wurde, valid-untrusted statt valid ist: ciphertext-cover, protected-from, protected-subject, reply-to, no-identity, display-name, multiple-from, lookalike-domain, old-signature oder future-signature (pepsi-stage-decrypt(1), What valid is granted for). signature.signed_at (Ganzzahl, nur dann vorhanden) ist der Erstellungszeitpunkt, den die Signatur behauptet, in Unix-Sekunden; er wird unter MAX_SIGNATURE_AGE_DAYS mit der Ankunftszeit verglichen. signature.unsigned_surface (Zeichenkette, nur dann vorhanden) ist, warum ein verifizierter Clearsigned-Block partial ist: armor-headers oder html.
signature.covers_plaintext ist vorhanden, wann immer es ein Signatururteil gibt: true, wenn das Urteil von einer Signatur über den Klartext gewährt wurde, false, wenn es von einer um Chiffrat gelegten Schicht stammt. pepsi-stage-autocrypt-learn(1) hält fest, dass ein Korrespondent einen unserer Schlüssel besitzt (pepsi.peer_has_own_key), nur bei einer valid- oder valid-untrusted-Signatur mit covers_plaintext = true, deren Unterzeichner die From:-Adresse ist, auf einer Nachricht, die wir entschlüsselt haben.
outer_gossip (boolescher Wert, nur vorhanden, wenn wahr) hält fest, dass die Nachricht so, wie sie ankam, bereits ein Autocrypt-Gossip:-Feld auf ihrem äußeren Header-Block trug — etwas, das jeder Hop auf dem Weg geschrieben haben könnte und das der Wiederzusammenbau von Inline-PGP durch die Entschlüsselung tragen kann. Es wird hier geschrieben, weil der Klartext über die eintreffenden Bytes committet wird, sodass nachgelagert niemand die Frage später beantworten könnte. Zusammen mit encrypted ist es das, was pepsi-stage-autocrypt-learn(1) heranzieht, bevor es einen gegossipten Schlüssel lernt: Ein nicht authentifiziertes äußeres Feld legt sein Veto gegen alle ein. Wenn LEARN_GOSSIP an ist und aus einer verschlüsselten Nachricht nichts gelernt wird, ist dies der Schlüssel, den man ansehen sollte.
signature.status ist eines von:
noneKeine Signatur.
validKryptographisch einwandfrei und der Schlüssel war verankert — eine X.509-Kette zu einem
ca_trust-Anker oder ein OpenPGP-Schlüssel aus WKD, aus DNSSEC-validiertem DANE, vom Betreiber hinzugefügt oder unsere eigene Identität für den Absender — und der Unterzeichner ist an dieFrom:-Zeile gebunden, wie der Leser sie sieht. Ein Schlüssel von einem Keyserver (VKS, LDAP) istvalid-untrusted.partialWäre
valid, aber dem Leser wird neben dem signierten Text Text gezeigt, den die Signatur nicht abdeckt: ein eingebetteter Clearsigned-Block, zugestellt, wie er eintraf, mit anderen Armor-Header-Zeilen alsHash:oder in einemtext/html-Teil (signature.unsigned_surface). Keine Markierung, keinsignature_verified.valid-untrustedEinwandfrei, aber der Schlüssel ließ sich an nichts binden: ein erstmals gesehener Schlüssel, einer aus der Nachricht selbst gelernter oder ein Zertifikat einer CA, für die diese Installation keinen Anker hält — oder eine verankerte Signatur, der eine der Regeln der Stage
validvorenthalten hat (signature.withheld): ein abweichendes geschütztesFrom:oderReply-To:, ein Zertifikat ohne Mailbox, ein Anzeigename, der eine andere Adresse zeigt, mehrereFrom:-Mailboxen, eine Doppelgänger-Domain des Unterzeichners. Nie als ``valid`` gemeldet; diese Unterscheidung zu treffen ist der Zweck, für den die Stage existiert.invalidDie Signatur verifiziert nicht, oder das Zertifikat des Signierenden ist abgelaufen, widerrufen oder an eine andere Adresse gebunden.
signature.failuresagt, welches davon.unverifiableFür den behaupteten Signierenden war kein Schlüssel verfügbar.
signature.key_source und signature.trust tragen hier das eigene Herkunftsvokabular der Kryptoschicht (anchor, dane, wkd, autocrypt, pinned, attached, unknown), das gröber ist als die Leiternamen der ausgehenden Hälfte. Eine Signatur, die gegen unsere eigene Identität für den behaupteten Absender geprüft wurde, meldet pinned — den stärksten Wert, den dieses Vokabular hat, und den richtigen, denn der Schlüssel ist für diese Adresse verzeichnet. Es ist dieselbe Verdrängung, die die ausgehende Hälfte own nennt: Für eine Adresse, für die diese Installation einen Schlüssel hält, wird dem Verifizierer überhaupt kein peer_key-Datensatz angeboten. Siehe pepsi-stage-decrypt(1).
Eine Nachricht mit mehreren Signaturschichten nimmt das schlechteste ihrer Urteile — unter den Schichten, die den Klartext abdecken. Eine als covers_ciphertext markierte Signaturschicht (siehe unten) wird nur herangezogen, wenn es keine andere gibt, und kann selbst dann nie valid ergeben.
layers ist von außen nach innen geordnet, und die Reihenfolge ist wichtig: Aus ihr werden die Betreffmarkierungen gerendert, sodass encrypted(signed(body)) und signed(encrypted(body)) unterscheidbar sind. Sie überlebt daher eine Pause, weshalb die Stage sie festhält, statt sie neu zu berechnen. container und downgraded erscheinen nur an Chiffratschichten, sodass ein Betreiber sehen kann, wie viel eingehende Mail noch vor-AEAD ist.
"covers_ciphertext": true erscheint an einer Signaturschicht, in die eine Chiffratschicht eingeschachtelt ist — die äußere Signatur von signed(encrypted(body)). Es ist nur vorhanden, wenn es zutrifft. Eine solche Signatur wurde über das Chiffrat berechnet, sagt also, dass der Signierende den Blob übertragen hat, und nichts darüber, was daraus hervorging; jeder, der eine verschlüsselte Nachricht erlangt, kann sie in seine eigene Signatur wickeln und weiterleiten. Die Schicht behält ihr eigenes ehrliches Urteil, kann aber signature.status nicht auf valid heben und daher signature_verified nicht setzen. In signed(encrypted(signed(body))) ist nur die äußere Schicht markiert, und die innere — diejenige, die für den Inhalt spricht — entscheidet das Urteil.
Die Speicherhälfte, crypto.store, wird von pepsi-stage-reencrypt(1) auf einem Datensatz geschrieben, dessen crypto.in besagt, dass die Nachricht entschlüsselt wurde:
"crypto": {
"in": { … },
"store": { "outcome": "reencrypted", "protocol": "openpgp",
"fingerprint": "…", "container": "seipdv2-aead",
"downgraded": false }
}
outcome ist reencrypted (versiegelt für den eigenen MUA-Schlüssel des Empfängers, benannt durch fingerprint), plaintext (so abgelegt, wie sie ist: kein brauchbarer MUA-Schlüssel unter ON_NO_CLIENT_KEY = plaintext oder kein lokaler Empfänger — reason sagt, welches von beiden) oder bounced (abgelehnt unter ON_NO_CLIENT_KEY = bounce; reason). Die Stage führt das ganze crypto-Objekt zusammen, sodass crypto.in erhalten bleibt, und das Vorhandensein von store verhindert, dass sie einen Datensatz zweimal versiegelt.
95.3.1.1.4.32. encrypted¶
(boolescher Wert) Von pepsi-stage-encrypt(1) auf true gesetzt, wenn die Nachricht auf diesem Datensatz tatsächlich an einen Empfängerschlüssel verschlüsselt wurde, und von pepsi-stage-decrypt(1), wenn die Nachricht verschlüsselt ankam. pepsi-stage-auto-whitelist(1) kopiert ihn in die signature_required-Spalte des neuen Datensatzes in der weißen Liste, sodass ein Korrespondent, der unter Verschlüsselung erreicht wurde, später am selben Maßstab gemessen wird. Abwesend (statt false), wenn nichts verschlüsselt wurde.
95.3.1.1.4.33. signature_verified¶
(boolescher Wert) Von pepsi-stage-decrypt(1) auf true gesetzt für das Signatururteil valid, und nur für dieses. Die signature_required-Schranke von pepsi-stage-check-whitelist(1) prüft ihn, sodass valid-untrusted ihn setzen zu lassen eine Schranke öffnen würde, die der Betreiber für einen vertrauenswürdigen Schlüssel gedacht hatte — und aus demselben Grund setzt ihn auch eine Signatur nie, die nur Chiffrat abdeckt (covers_ciphertext, oben). Andernfalls abwesend (statt false).
95.3.1.1.4.34. milter¶
(Objekt) Was pepsi-stage-milter(1) getan hat — das Urteil des Filters, die ausgehandelte Protokollversion, wie lange das Gespräch dauerte, und jede angewandte Änderung, beschriftet:
{ "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 ist die Bezeichnung der Milter-Stage, die gehandelt hat (nicht ihr MILTER_NAME, das nur das dem Filter übergebene Makro {daemon_name} ist). verdict ist continue, accept, reject, tempfail, discard oder — wenn der Filter überhaupt nicht ansprechbar war oder eine Änderung gesendet hat, die sich nicht anwenden lässt — failed, in welchem Fall der Eintrag nur stage, verdict und ein error mit der Diagnose enthält und das Routing dem ON_FAILURE der Stage folgte. reply_code, quarantine_reason und rejected_recipients sind nur vorhanden, wenn sie zutreffen.
Keine Stage richtet sich danach, solange Sie keine dafür konfigurieren. Es existiert, damit pepsi-queue(1) zeigen kann, warum eine Nachricht markiert wurde, damit pepsi-stage-if(1) darauf verzweigen kann und damit eine Supportfrage zu einem überraschenden Header aus dem Datensatz heraus statt aus dem Journal beantwortbar ist — dieselbe Begründung wie bei vacation oben. Eine abgelehnte Nachricht trägt zusätzlich das übliche bounce-Objekt, mit dem eigenen SMTP-Code des Filters, dem erweiterten Status nach RFC 3463 und dem Text, aufgeteilt auf eigene Felder.
95.3.1.1.4.35. quarantine¶
(Objekt) Der Quarantäne-Eintrag. Wer eine Nachricht an eine pepsi-stage-quarantine(1)-Stage schickt, schreibt einen frischen und ersetzt dabei jeden früheren Eintrag als Ganzes: pepsi-stage-milter(1), wenn ein Filter unter Quarantäne stellt und QUARANTINE_STAGE gesetzt ist, und pepsi-ingress(1) für einen Milter vor der Warteschlange. Die Quarantäne-Stage fügt die Zeiten hinzu:
{ "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 (Zeichenkette, optional) ist der Grund, aus dem die Nachricht zurückgehalten wird, so wie ihn der Absender der Anfrage formuliert hat (der SMFIR_QUARANTINE-Text eines Milters). by (Zeichenkette, optional) nennt diesen Absender: milter:<MILTER_NAME> oder stage:<name>. since (RFC 3339) ist der Zeitpunkt, zu dem die Quarantäne-Stage begann, die Nachricht zurückzuhalten, until der, zu dem das Zurückhalten von selbst endet (mit MAX_HOLD), released_at der, zu dem ein Betreiber sie freigegeben hat, und expired (true) besagt, dass das Zurückhalten abgelaufen ist. Die Stage hält eine Nachricht zurück, deren Eintrag kein since hat oder deren früheres Zurückhalten geendet hat (released_at oder expired ist gesetzt), sodass eine einmal freigegebene und später erneut unter Quarantäne gestellte Nachricht wieder zurückgehalten wird. pepsi-queue(1) quarantine und pepsi-status(1) lesen den Eintrag; der POST /resume-Webhook von pepsi-httpd(1) lässt eine Nachricht in Ruhe, solange sie zurückgehalten wird.
95.3.1.1.4.36. crypto_policy_refused¶
(boolescher Wert, nur vorhanden, wenn wahr) Von pepsi-stage-encrypt(1), pepsi-stage-decrypt(1) und pepsi-stage-reencrypt(1) neben last_error geschrieben, wenn sie eine Nachricht fehlschlagen lassen, weil die konfigurierte Richtlinie sie abgelehnt hat und es kein BOUNCE_STAGE gab, zu dem ein Bounce hätte gehen können — ON_NO_KEY/ON_OVERSIZE = bounce für einen Empfänger, an den nicht verschlüsselt werden konnte, ein Bounce durch ON_DECRYPT_FAILURE/ON_BAD_SIGNATURE, ON_NO_CLIENT_KEY = bounce. Es unterscheidet eine bewusste Ablehnung von einem Transport- oder Programmierfehler, die auf einem failed-Datensatz sonst gleich aussehen: Die erste erneut zu versuchen wird nie helfen.
95.3.1.1.4.37. encrypt_dns_deferred¶
(boolescher Wert, nur vorhanden, wenn wahr) Mit last_error (und delay_sent, sobald eine Verzögerungs-DSN hinausgegangen ist) von pepsi-stage-encrypt(1) geschrieben, wenn es eine Nachricht pausiert, weil die Schlüsselabfrage eines Empfängers im DNS fehlschlug, statt sie unverschlüsselt zu senden; siehe dort „DNS-Fehlschläge bei Empfängern“.
95.3.1.1.4.38. milter_error¶
(Zeichenkette) Von pepsi-stage-milter(1) geschrieben, wenn ein Filter eine Nachricht abgelehnt hat, aber weder REJECT_STAGE noch BOUNCE_STAGE konfiguriert war, sodass die Stage sie nirgendwohin routen konnte. Zu unterscheiden von milter.error im milter-Objekt weiter oben, das die Diagnose für einen Filter ist, mit dem überhaupt nicht gesprochen werden konnte.
95.3.1.1.4.39. list¶
(Objekt) Der Mailinglisten-Deskriptor. pepsi-stage-list(1) schreibt ihn auf jeden Datensatz, den es zu einer Listenrolle routet (die id der Liste, die role, die address, an der die Nachricht ankam, dazu das token einer -confirm+-Adresse oder das verp-Detail einer -bounces+-Adresse, unverändert: Die Bounce-Stage verifiziert und dekodiert es); pepsi-stage-list-post(1) schreibt einen Deskriptor je Mitglied (id, member, lang, serial, duplicate) auf jeden Zustelldatensatz, den es auffächert, dazu pending_rcpt bei einem teilweise aufgefächerten Beitrag und rejected bei einem abgelehnten; pepsi-list(1) setzt moderator_approved; die Datensätze einer Digest-Ausgabe tragen digest (true), auf dem ausstehenden Datensatz und auf jedem daraus aufgefächerten Deskriptor je Mitglied. Gelesen von pepsi-stage-list-post(1), pepsi-stage-list-command(1), pepsi-stage-list-deliver(1) und pepsi-stage-list-bounce(1); siehe deren Seiten für die Felder, die jede davon verwendet.
95.3.1.1.4.40. dispatch_error¶
(Zeichenkette) Von pepsi-dispatch(1) geschrieben, wenn er einen Datensatz in einen terminalen Zustand zwingt, den er nicht selbst erreicht hat — die Diagnose für ein Stage-Programm, das abgestürzt ist (failed), eines, das MAX_RUNTIME überschritten hat (timeout), oder einen Datensatz, der bei einer Stage sitzt, die die Konfiguration nicht definiert. pepsi-status(1) führt sie unter jeder hängengebliebenen Nachricht auf.
95.3.1.1.5. Siehe auch¶
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)