95.2.1. pepsi.conf¶
configuration file for the Pepsi pipeline
- Handbuchabschnitt:
5
95.2.1.1.1. Name¶
pepsi.conf - von allen Pepsi-Komponenten geteilte Konfigurationsdatei.
95.2.1.1.2. Beschreibung¶
Jede Pepsi-Komponente — pepsi-ingress(1), pepsi-dispatch(1), jedes pepsi-stage-*-Programm, pepsi-httpd(1), pepsi-queue(1), pepsi-tlsrpt(1), pepsi-setup(1) und die übrigen — liest die gleiche Konfigurationsdatei im INI-Stil, konventionell pepsi.conf. Das Format wird mit den GNU-Taler-Komponenten geteilt, auf denen Pepsi aufbaut.
Weil es eine Datei gibt, wird jede Einstellung einmal dokumentiert, unter dem Abschnitt, der sie besitzt. Eine Komponente liest nur die für sie relevanten Abschnitte: Die gemeinsamen Abschnitte [pepsi] und [pepsi-postgres] werden von allem gelesen; die [stage-<name>]-Pipeline-Abschnitte vom Dispatcher und den Stage-Programmen; komponentenspezifische Abschnitte ([pepsi-ingress], [pepsi-httpd], [pepsi-dispatch], [pepsi-payments], [pepsi-tlsrpt] …) von der jeweils benannten Komponente.
Eine Option, die nichts liest, wird ignoriert, sodass eine falsch geschriebene stillschweigend ihren Standardwert annimmt; pepsi-setup(1) warnt vor jeder solchen Option in einem Abschnitt, den es kennt, und nennt die nächstliegende echte Option.
Umbenannte Optionen. Wenn ein Release eine Option umbenennt, funktioniert der alte Name noch mindestens ein weiteres Release lang: Jedes Programm liest ihn unter dem neuen Namen und protokolliert eine entsprechende Warnung, und pepsi-setup(1) warnt ebenfalls. Sind beide Namen gesetzt, gewinnt der neue. NEWS führt jede Umbenennung auf.
95.2.1.1.3. Dateiformat¶
Eine Konfigurationsdatei ist eine Folge von [SECTION]-Kopfzeilen, jeweils gefolgt von OPTION = VALUE-Zuweisungen:
[pepsi-ingress]
HOSTNAME = mail.example.org
ACCEPTED_DOMAINS = example.org example.com
Abschnitts- und Optionsnamen sind unabhängig von der Groß-/Kleinschreibung und werden konventionell in Großbuchstaben geschrieben. Leerzeilen werden ignoriert. Ein # oder % am Zeilenanfang leitet einen Kommentar ein. Ein Wert kann in doppelte Anführungszeichen gesetzt werden, um führende oder nachgestellte Leerzeichen zu erhalten.
95.2.1.1.3.1. Direktiven¶
- @inline@ FILE
Bindet eine andere Konfigurationsdatei ein, relativ zur aktuellen Datei aufgelöst.
- @inline-matching@ GLOB
Bindet jede Datei ein, die auf das Shell-Glob GLOB passt.
- @inline-secret@ SECTION FILE
Führt den Abschnitt SECTION aus FILE (typischerweise eine modusbeschränkte Datei mit Zugangsdaten) in die Konfiguration zusammen. Eine Datei, die nicht gelesen werden kann, wird mit einer Warnung ignoriert. Dies hält Geheimnisse aus der für alle lesbaren Hauptdatei heraus.
Eine Direktive ist eine Zeile auf oberster Ebene: Wie
@inline@beendet sie den Abschnitt, in dem sie steht. Schreiben Sie sie hinter die letzte Option des Abschnitts, den sie versorgt. Eine darunter platzierte Option gehört zu keinem Abschnitt, und die gesamte Datei lässt sich dann nicht mehr laden (expected section header or directive). Aus diesem Grund gibt pepsi-setup(1) seine Direktiven stets als Letztes innerhalb eines Abschnitts aus:[pepsi-srs] SRS_DOMAIN = srs.example.net MAX_AGE_DAYS = 21 @inline-secret@ pepsi-srs secrets.d/pepsi-ingress.secret
Da ein nicht lesbares Fragment nur eine Warnung auslöst, wirkt eine Option, die es hätte liefern sollen, schlicht wie nicht gesetzt. Was den Wert benötigt, meldet dann das Rechteproblem, typischerweise als „… is not configured“. Pepsi erkennt diesen Fall und sagt es ausdrücklich, unter Nennung des Fragments, seines Eigentümers und seines Modus; führen Sie
pepsi-setup runals root aus, um jedes Fragment dem Konto zu geben, das es liest.
95.2.1.1.3.2. Wertersetzung¶
Als Pfade gelesene Optionen durchlaufen eine $-Expansion: $VAR und ${VAR} werden durch den Wert von VAR aus dem [PATHS]-Abschnitt oder, andernfalls, der Umgebung ersetzt. Die Form ${VAR:-default} liefert einen Ersatzwert. Der [PATHS]-Abschnitt ist mit den üblichen Installationsverzeichnissen (PREFIX, BINDIR, DATADIR und so weiter) vorbefüllt.
95.2.1.1.3.3. Werttypen¶
- Boolescher Wert
YESoderNO(unabhängig von der Groß-/Kleinschreibung).- Zahl
Eine dezimale Ganzzahl. Einige als solche dokumentierte Optionen nehmen stattdessen einen gebrochenen Wert an, und jede sagt das dort, wo sie beschrieben wird (die Verbindungsraten-Optionen des Ingress und das
RETRY_FACTORder Relay-Stages).- Dauer
Eine Zeitspanne wie
5 soder2 h. Siehe den Vorbehalt unten.- Pfad
Ein Dateisystempfad, der wie oben beschrieben einer
$-Expansion unterliegt.- Unix-Modus
Ein in Oktal geschriebenes Dateirecht, z. B.
660.
Warnung
duration-Werte werden von jiff::SignedDuration geparst, das nur Stunden/Minuten/Sekunden und kleinere Einheiten akzeptiert. Eine Kalendereinheit wie 5 d oder 2 weeks lässt sich nicht parsen. Für eine Dauer von einem Tag oder länger schreiben Sie das Äquivalent in Stunden (120 h) oder verwenden, wo vorhanden, eine ganzzahlige Option (z. B. [pepsi-srs] MAX_AGE_DAYS).
95.2.1.1.4. Die Datenbank-Überlagerung¶
Diese Datei ist die Basisschicht. Darüber liest jede Komponente eine Menge administrativ verwalteter Überschreibungen aus der Tabelle pepsi.config_override des geteilten Schemas, sodass eine Installation ohne Dateibearbeitung und, für die Stage-Abschnitte, ohne Neustart umkonfiguriert werden kann. Ohne Datensätze in jener Tabelle verhält sich eine Installation genau so, wie diese Datei es sagt; jede Überschreibung zu löschen führt sie in diesen Zustand zurück.
Die Geltungsbereichskette, niedrigste Präzedenz zuerst:
diese Datei;
Datenbank-Geltungsbereich
global;Datenbank-Geltungsbereich
domain:DOMAIN;Datenbank-Geltungsbereich
address:ADDRESS;die Tabelle
pepsi.settingsje Adresse (pepsi-settings(1)).
Höhere Schichten überschreiben niedrigere Option für Option, nie Abschnitt für Abschnitt: Eine Option, die keine Schicht erwähnt, behält den hier geschriebenen Wert. Die Adresse, gegen die ein domain:/address:-Geltungsbereich abgeglichen wird, ist der Umschlagabsender für eine lokal stammende Nachricht, sonst jeder Umschlagempfänger.
The last layer is a different table with a different write authority.
pepsi.settings is written by account owners themselves, by e-mail, within
the EDITABLE_STAGES allowlist; config_override defines the pipeline and
is writable only through the pepsi-config PostgreSQL role. pepsi-setup(1) grants that role INSERT/UPDATE/DELETE on the table, revokes them
from every service account, and verifies both against the live database after
each install. A stage worker parses hostile mail all day long, so it must not be
able to rewrite the configuration that defines its own stage.
95.2.1.1.4.1. Abschnitte, die nie aus der Datenbank gelesen werden¶
Eine Überschreibung, die eine davon benennt, wird zur Laufzeit ignoriert und beim Schreiben abgelehnt:
[pepsi],[pepsi-postgres],[PATHS]Gelesen, bevor eine Datenbankverbindung existieren kann — und
[pepsi]hält zusätzlich die nur für Administratoren bestimmte kryptographische Richtlinie.[pepsi-httpd],[pepsi-httpd-listener-*],[pepsi-httpd-cert-*]Der Server, der die Konfigurationsoberfläche bedient, muss immer starten können.
[pepsi-ingress-listener-*]Lauschende Sockets werden beim Start gebunden, oft unter Socket-Aktivierung und bevor Privilegien abgegeben werden.
[pepsi-secure-link]Sein
PEPPERist das serverseitige Geheimnis, das eine gestohlene Datenbank nutzlos macht. Eine Datenbank, die es ersetzen könnte, könnte dafür sorgen, dass die nächste gespeicherte Nachricht eine ist, die ein Angreifer öffnen kann. Die übrigen Optionen des Abschnitts bleiben mit ihm in der Datei.[pepsi-admin]Entscheidet, wer den Server verwalten darf und wie die administrative Oberfläche die Datenbank erreicht. Könnte die Datenbank dies festlegen, dann könnte sich jeder, der in die Datenbank schreiben kann, selbst Zugang zur Konsole verschaffen.
[pepsi-crypto],[pepsi-srs],[pepsi-origin]Jeder enthält einen serverseitigen Schlüssel, der gerade deshalb existiert, damit die Datenbank allein nicht genügt: die Schlüsselverschlüsselungsschlüssel (und welcher davon neue private Schlüssel einhüllt), den SRS-Schlüssel, der das Relaying an jede beliebige Adresse autorisiert, und den Herkunftsnachweis-Schlüssel, mit dem Pepsi einen zurückkehrenden Bounce oder eine Zahlungsaufforderung prüft. Eine Datenbank, die einen davon ersetzen könnte, könnte dafür sorgen, dass der nächste eingehüllte Schlüssel einer ist, den ein Angreifer öffnen kann, oder dass ein gefälschter Bounce weitergeleitet oder bezahlt wird. Die übrigen Optionen jedes Abschnitts bleiben mit ihm in der Datei.
[pepsi-wizard]Überhaupt keine Konfiguration, sondern die Aufzeichnung von pepsi-setup(1) über die Antworten, die ihm gegeben wurden, und die die Browser-Konsole als Entwurfs-Datensätze in eben dieser Tabelle zwischenlagert. Zur Laufzeit liest sie niemand, also liefert die Datenbank sie auch nie.
Drei weitere Regeln gelten in jedem anderen Abschnitt:
Keine Zugangsdaten werden je in der Datenbank gespeichert. In jedem Abschnitt wird eine Option beim Schreiben verweigert und zur Laufzeit ignoriert, wenn ihr Name sie als Zugangsdaten kennzeichnet, das heißt, wenn der Name
PASS(PASSWORD,PASSPHRASE,API_PASS),SECRET,TOKEN,CREDENTIAL,CLIENT_ID,PEPPERoderSYSTEM_IDenthält. (Dieselbe Regel maskiert einen Wert überall, wo eine Konfiguration angezeigt wird.) Das schließt die Datei ein, aus der Zugangsdaten gelesen werden, und den Endpunkt, an den sie gesendet werden (SECRET_FILE,TOKEN_FILE,TOKEN_ENDPOINT), denn eine Datenbank, die diese setzen könnte, könnte die Zugangsdaten umleiten. Zugangsdaten liegen in dieser Datei oder ihrensecrets.d-Fragmenten, jeweils nur für das Konto lesbar, das sie braucht.Kein Programm wird von der Datenbank gewählt.
HELPER,SCAN_HELPER,MAILBOX_HELPERundPIN_COMMANDnennen ein ausführbares Programm, und mehrere davon führt eine setgid-Stage oder ein setuid-Werkzeug aus. Sie werden in jedem Abschnitt beim Schreiben verweigert und zur Laufzeit ignoriert. DasPROGRAMeiner Stage wird nur als bloßerpepsi-stage-*-Befehl (ohne Pfadbestandteil) akzeptiert, sodass eine Stage weiterhin über die Datenbank hinzugefügt werden kann, aber immer nur ein installiertes Stage-Binärprogramm ausführt.Die Geltungsbereiche
domain:undaddress:nehmen nur[stage-*]-Abschnitte an. Diese Schichten werden von einer Stage je Nachricht für den Abschnitt konsultiert, den sie gerade ausführt; nichts liest einen anderen Abschnitt je Domain oder je Adresse, daher wird eine solche Überschreibung verweigert, statt gespeichert und nie gelesen zu werden.
Folglich gilt: Um einen Submission-Port hinzuzufügen oder das TLS-Material eines Listeners, die Datenbankverbindung oder die Krypto-Richtlinie zu ändern, bearbeiten Sie diese Datei und starten neu; keine administrative Oberfläche kann das tun. [pepsi-ingress] DB_POOL_SIZE und [pepsi-dispatch] DB_POOL_SIZE sind aus demselben Bootstrap-Grund nur in der Datei: Der Pool muss existieren, bevor die Überlagerung gelesen werden kann.
95.2.1.1.4.2. Hot Reload¶
Jeder Schreibvorgang auf der Tabelle löst eine config_changed-Benachrichtigung aus.
Jede [stage-*]-Änderung wird ohne Neustart angewandt, und zwar in beiden Hälften der Pipeline, im Dispatcher und in den Stage-Workern. Auf die Benachrichtigung hin baut pepsi-dispatch(1) seine eigene Stage-Tabelle aus der Überlagerung neu auf und setzt seine Stage-Worker außer Dienst, sodass die Nachfolger die Überlagerung neu lesen. Eine Stage kann daher im laufenden Betrieb hinzugefügt, geändert oder entfernt werden, und ein geändertes PROGRAM/PARALLELISM/MAX_MESSAGES/QUEUE_LIMIT wird wirksam. Keine Nachricht wird unterbrochen: Ein Worker bekommt keine weitere Arbeit mehr, und sein Platz wird aufgegeben, sobald seine laufenden Nachrichten zurückgemeldet haben.
Ein Neuladen routet Mail nie nach einer Pipeline, die die Worker nicht mehr teilen. Ein neu geladener Stage-Graph, der sich nicht parsen lässt, beendet den Dispatcher (Exit EX_CONFIG, über das gewöhnliche Herunterfahren, sodass nichts liegen bleibt), statt die vorherige Tabelle stehen zu lassen.
Jeder andere Abschnitt wird beim Start einmal von der Komponente gelesen, der er gehört, und braucht daher einen Neustart dieser Komponente — einschließlich der eigenen Optionen von [pepsi-dispatch], die bewusst nicht neu geladen werden. pepsi-config set gibt aus, welcher Fall zutrifft.
Eine Änderung an dieser Datei erreicht die Pipeline auf dieselbe Weise: pepsi-dispatch(1) prüft alle zwei Sekunden Änderungszeit und Größe der Datei und liest sie, wenn sie sich ändern, neu ein, baut seine Stage-Tabelle neu auf und beendet seine Worker. Eine Datei, die sich nicht parsen lässt, wird nicht angewendet; der Dispatcher protokolliert den Fehler und behält die Konfiguration, die er hat.
Eine Komponente, die eine Benachrichtigung verpasst, liest die Überlagerung erneut, wenn ihr Datenbank-Listener sich neu verbindet, sodass eine verlorene Benachrichtigung Latenz kostet, nicht Korrektheit.
Geheimnisse werden nie in der Datenbank gespeichert: Das Overlay verweigert Zugangsdaten (siehe oben), und die @inline-secret@-Referenz liegt in dieser Datei. Jedes Fragment bleibt im Besitz des einzigen Lesers, der es braucht.
Ein defekter Wert in der Datenbank kann kein Programm am Start hindern: Eine Überlagerung, die nicht gelesen werden kann oder keine brauchbare Konfiguration ergibt, wird lautstark protokolliert, und diese Datei wird unverändert verwendet.
Siehe pepsi-config(1) für set/unset/list, für dump --origin (das jeden effektiven Wert mit der Schicht annotiert, aus der er stammt) und für den verschlüsselten export/import dieser Datei und ihrer secrets.d-Fragmente.
95.2.1.1.5. Der Abschnitt [pepsi]¶
Übergreifende Identitäts- und Richtlinien-Einstellungen, die von den Pepsi-Werkzeugen geteilt werden. Dieser Abschnitt wird nie aus der Datenbank-Überlagerung gelesen.
- KEY_DIR = PATH
Verzeichnis, das DKIM-Schlüsseldateien je Domain aus einer älteren Installation enthalten kann (
<domain>/dkim.rsa.keyund<domain>/dkim.ed25519.key). Nichts signiert mit ihnen: Die DKIM- und ARC-Schlüssel gehören pepsi-dkim(1). Sobald dieser Daemon antwortet, löschtpepsi-setup rundiese Dateien und führt ihre Selektoren (<DKIM_SELECTOR>und<DKIM_SELECTOR>-ed25519) als Einträge auf, die aus dem DNS entfernt werden können. Optional; Standardwert ist/var/pepsi/keys.- DKIM_SELECTOR = NAME
Präfix der DKIM-Selektoren, die pepsi-dkim(1) seinen Schlüsseln gibt: Jede Schlüsselgeneration einer Domain wird unter
<NAME>-YYYYMM._domainkey.<domain>(RSA) und<NAME>-YYYYMM-ed25519._domainkey.<domain>(Ed25519) veröffentlicht, wobeiYYYYMMder Monat ist, in dem die Schlüssel erzeugt wurden (mit angehängtem Buchstaben, wenn dieser Name vergeben ist). Optional; Standardwert istpepsi.- DKIM_ALGORITHMS = LISTE
Die DKIM-Signaturen, die pepsi-stage-dkim-sign(1) hinzufügt: eine durch Leerzeichen oder Kommas getrennte Liste aus
rsaunded25519. Optional; Standardwert sind beide. Gmail, Microsoft 365 und Yahoo verifizieren keine Ed25519-Signaturen (RFC 8463); sie ignorieren sie, und Googles DMARC-Aggregatberichte führen den Ed25519-Selektor alsfail. Das ist harmlos — DMARC braucht ein ausgerichtetes Bestehen, und die RSA-Signatur liefert es —, aberrsaallein beseitigt das Rauschen.rsawegzulassen ist erlaubt, und pepsi-setup(1) warnt davor: Diese Empfänger sähen dann überhaupt keine verifizierbare Signatur. pepsi-setup veröffentlicht und prüft nur die verwendeten Selektoren (dazu denjenigen, den das ARC-Siegel braucht, wenn dies dieARC_DOMAINist), und pepsi-dkim(1) erzeugt nur für sie Schlüssel.- ARC_DOMAIN = DOMAIN
Domain, deren Identität pepsi-stage-arc(1) verwendet, um eingehende Mail per ARC zu versiegeln (RFC 8617). Das Siegel wird mit dem DKIM-Schlüssel dieser Domain für
ARC_ALGORITHMerstellt. pepsi-setup(1) fügt die Domain daher zu den Signierdomains hinzu, die es an pepsi-dkim(1) übergibt, das diesen Schlüssel für sie erzeugt, und zu den DKIM-DNS-Einträgen, die es ausgibt; ARC benötigt keinen separaten Eintrag. Optional; wenn nicht gesetzt, werden Authentifizierungsergebnisse festgehalten, aber nicht versiegelt.- ARC_ALGORITHM =
rsa|ed25519 Algorithmus, der das einzelne ARC-Siegel signiert (ARC erlaubt nur eines je Hop, anders als DKIM, das standardmäßig mit beiden signiert wird — siehe
DKIM_ALGORITHMS). Optional; Standardwert istrsafür die breiteste Interoperabilität.- ORIGINATE_SUCCESS_DSN =
yes|no Whether Pepsi may originate a positive (
Action: delivered) delivery-status notification when a delivery succeeds and the sender requestedNOTIFY=SUCCESS. Optional; defaults tono— Pepsi normally emits only failure bounces. Whenyes, the delivery 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)) and pepsi-stage-discard(1) route a successful delivery to theirBOUNCE_STAGE(for LMTP, itsNOTIFY_STAGE) to emit the report.Sie regelt nur
SUCCESS-Berichte.DELAY-Berichte haben ihren eigenen, stageweisen Schalter (dasDELAY_DSN_AFTEReiner Zustell-Stage, standardmäßig nicht gesetzt), undFAILURE-Bounces brauchen überhaupt keinen Schalter — sie sind der Standardwert, wenn dasNOTIFYeines Empfängers nichts sagt.SUCCESSundDELAYwerden gleichermaßen nur ausgegeben, wenn dasNOTIFYdes Absenders sie namentlich angefordert hat; keiner von beiden hat einen impliziten Standardwert.- MAILBOX_QUOTA = SIZE
Standardgrenze dafür, wie viel Mail ein lokales Konto halten darf, angewandt von pepsi-stage-relay-to-maildir(1). Eine schlichte Byte-Zahl oder ein
K/M/G/T-Suffix in Potenzen von 1024 (2G,500M,1048576), odernone. Optional; Standardwert istnone— keine Quota. Die Grenze eines einzelnen Kontos wird mit pepsi-quota(1)setgesetzt, was dies überschreibt; die kerneleigene Grenze verschärft, was auch immer gilt.Die Quota umfasst den gesamten Maildir++-Baum — die INBOX plus jeden Ordner (
.Sent,.Trash, …) —, denn das ist es, was der Benutzer sein Postfach nennt, und würde nur die INBOX gezählt, könnte jeder unbegrenzt Mail in einem anderen Ordner aufbewahren, nur einen Drag-and-drop davon entfernt.- MAILBOX_QUOTA_COUNT = N
Standardgrenze für die Anzahl der Nachrichten, die ein Konto halten darf;
0oder abwesend für keine. Eine sehr große Zahl sehr kleiner Nachrichten ist schon für sich ein Denial-of-Service gegen ein Postfach, und eine Byte-Grenze allein verhindert ihn nicht.- MAILBOX_OVER_QUOTA =
defer|bounce Was mit einem Empfänger geschieht, dessen Postfach voll ist. Optional; Standardwert ist
defer.deferhält die Nachricht in der Warteschlange und wiederholt sie bis zumMAX_LIFETIMEder Zustell-Stage, erzeugt dann einen Bounce, was dem Konto Zeit gibt, Platz zu schaffen.bounceweist sofort mit einem RFC-3463-5.2.2ab und routet den Empfänger zumQUOTA_LIMIT_STAGEder Zustell-Stage (sonst zu ihremBOUNCE_STAGE), sodass der Absender nicht tagelang wartet. Ein Kernel-EDQUOTzählt als volles Postfach und wird ebenso behandelt. Zum Zustellzeitpunkt regelt dies nur pepsi-stage-relay-to-maildir(1); pepsi-stage-relay-to-lmtp(1) routet die eigenex.2.2-Ablehnung des MDA zu seinemQUOTA_LIMIT_STAGE, was immer diese Option sagt.Dieselbe Wahl bestimmt die Antwort, die pepsi-ingress(1) gibt, wenn es einen Empfänger mit erschöpfter Quota bei
RCPTabweist:452 4.2.2fürdefer,552 5.2.2fürbounce.- MAILBOX_QUOTA_MAX_AGE = DURATION
Wie lange einer Postfachmessung für eine Abweisung zur
RCPT-Zeit vertraut werden darf. Optional; Standardwert ist15 m. Einheiten sindh/m/s.pepsi-ingress(1) weist einen Empfänger mit erschöpfter Quota nur auf einer Messung ab, die jünger als dies ist, nie auf der laufenden Nutzungsschätzung. Das ist eine Korrektheitsgrenze, keine Leistungsgrenze: Die Schätzung wächst nur (nichts sagt Pepsi, wann ein Benutzer Mail über IMAP löscht), sodass eine Abweisung darauf ein Postfach schlösse, dessen Eigentümer es inzwischen geleert hat. Es bliebe für immer geschlossen, denn wenn jede Nachricht abgewiesen wird, läuft keine Zustellung mehr, die das Postfach neu misst. Diese Grenze und pepsi-quota(1)
reconcileverhindern das.- MAILBOX_QUOTA_RCPT_CHECK =
yes|no Ob pepsi-ingress(1) die Quota-Tabelle zur
RCPT-Zeit heranzieht. Optional; Standardwert istyes. Dort abzuweisen kostet eine indizierte Abfrage und spart einen Bounce: Der sendende MTA ist noch in der Leitung, sodass er seinem Benutzer Bescheid gibt und Pepsi kein Backscatter an einen möglicherweise gefälschten Umschlagabsender erzeugt. Es auszuschalten verlagert die gesamte Durchsetzung auf die Zustellzeit.- MAILBOX_HELPER = PATH
Der privilegierte Helper, den pepsi-quota(1) ausführt, um ein Postfach zu messen — für seinen
measure-Unterbefehl und seinenreconcile-Durchlauf. Optional; Standardwert istpepsi-helper-maildir-writer, aufgelöst auf demPATHdes aufrufenden Prozesses.Es ist dasselbe Binärprogramm, das die Stage für die lokale Zustellung verwendet, in seinem
measure-Modus aufgerufen: EinMaildirist0700, daher ist dies der eine Prozess, der zum Benutzer werden und es lesen kann. Setzen Sie dies nur, wenn der Helper nicht unter seinem Namen auf demPATHvonpepsi-quotaliegt — vor allem bei einer Quellcode-Installation mit--prefix. Halten Sie es mit der eigenenHELPER-Option der Zustell-Stage in deren[stage-<name>]-Abschnitt im Gleichschritt (siehe pepsi-stage-relay-to-maildir(1)): Die beiden benennen dasselbe Programm für zwei Aufrufer, und nur die der Stage gilt je Stage. Wie jede Option, die ein Programm nennt, kann sie nicht über die Datenbank-Überlagerung gesetzt werden.- MAILBOX_FS_QUOTA =
yes|no Ob das Dateisystem, das die Home-Verzeichnisse hält, Platten-Quotas des Kernels durchsetzt, in welchem Fall Pepsi zusätzlich
quotactl(2) heranzieht und die Kernel-Grenze die effektive verschärfen lässt. Optional; Standardwert istno.Normalerweise für Sie gesetzt. Dies ist eine Tatsache über die Mounts des Hosts, keine Vorliebe, sodass pepsi-setup(1) danach sondiert und die Antwort ohne Nachfrage festhält. Ein expliziter Wert wird nie überschrieben. Schalten Sie es ein, wo es zutrifft: Die Buchführung des Kernels ist die einzige der drei Schichten, an der der Kontoinhaber nicht manipulieren kann (die Maildir++-Datei
maildirsizeliegt in seinem eigenen Verzeichnis), und sie zählt alles, was ihm auf jenem Dateisystem gehört, statt nur seine Mail.- RECIPIENT_DELIMITER = CHARACTER |
none Der standortweite Subadress-Trenner (
alice+listsist Kontoalice). Optional; Standardwert ist+. Ein[stage-<name>]-Abschnitt darf ihn für seine eigenen Zustellentscheidungen überschreiben, aber setzen Sie ihn vorzugsweise hier. pepsi-ingress(1) ermittelt mit diesem Wert, welche Postfach-Quota für einen Empfänger gilt, und hat keinen Stage-Abschnitt zu lesen. Verwendet eine Stage einen anderen Trenner, entgeht sub-adressierte Mail daher der Abweisung zurRCPT-Zeit; pepsi-setup(1) warnt, wenn eine Stage das tut.Mailinglisten verwenden diesen Wert, und nur diesen, für jede Subadresse, die sie schreiben und lesen: den VERP-Umschlagabsender jeder Kopie (
announce-bounces+alice=example.net=<code>@…), den Absender einer Bounce-Probe, die-confirm+token-Adresse und den Router von pepsi-stage-list(1), der sie bei ihrer Rückkehr erkennt.nonebelässt Listen bei+, da ein VERP-Absender nicht ohne Trennzeichen geschrieben werden kann.- MAX_QUEUE_ROWS = N |
none Zulassungskontrolle der Warteschlange: die höchste Zahl von Nachrichten (
pepsi.workqueue-Datensätzen), die die Warteschlange halten darf, bevor pepsi-ingress(1) keine Mail mehr annimmt. Optional; Standardwert1000000;none(oder0) für keine Grenze. Ein Datensatz ist eine Empfängergruppe, also vervielfacht der Fan-out einer Mailingliste diese Zahl, und ebenso eine Relay-Stage, die eine Nachricht in einen Datensatz pro Empfänger aufteilt.An der Grenze antwortet pepsi-ingress(1) bei
RCPT, beiDATA/dem erstenBDAT-Chunk und nach dem Ende der Daten mit452 4.3.1. Das ist eine vorübergehende Ablehnung: Der sendende MTA behält die Nachricht und versucht es erneut, während sich die bereits vorhandene Warteschlange leert. pepsi-stage-list-post(1) hält einen Fan-out fürQUEUE_THROTTLE_DELAYzurück, statt seinen nächsten Stapel auszugeben. Bereits Eingereihtes ist nicht betroffen: Bounces, DSNs und automatische Antworten, die die Pipeline selbst erzeugt, werden nie abgelehnt.- MAX_QUEUE_BYTES = SIZE |
none Die höchste Zahl von Oktetten, die die Warteschlange halten darf: jeder eingereihte Header-Block plus jeder eingereihte Nachrichtentext, wobei jeder Nachrichtentext einmal gezählt wird, gleich wie viele Empfänger-Datensätze ihn teilen (er wird einmal gespeichert — siehe GESPEICHERTE DATEN unten). Eine reine Byte-Zahl oder ein Suffix
K/M/G/Twie beiMAILBOX_QUOTA. Optional; Standardwertnone. Nach dem Ende der Daten bezieht die Prüfung die Größe der angebotenen Nachricht ein, sodass eine einzelne übergroße Nachricht aus eigenem Grund abgelehnt wird. Ablehnungen erfolgen wie beiMAX_QUEUE_ROWS.- MIN_FREE_SPACE = SIZE |
none Der freie Platz, der auf dem Dateisystem, das
FREE_SPACE_PATHenthält, verbleiben muss, damit Mail angenommen wird; eine Nachricht wird abgelehnt, wenn ihre Annahme weniger übrig ließe. Optional; Standardwert1G;noneschaltet die Messung ab. Diese Grenze sieht auch, was nicht die Warteschlange ist, etwa das Write-Ahead-Log, andere Datenbanken und Logs. Das ist wichtig, weil PostgreSQL nicht eingeschränkt weiterläuft, wenn sein Dateisystem voll wird: Es hält an, und mit ihm halten jede Stage, die Konsole und der Submission-Socket an. Ablehnungen erfolgen wie beiMAX_QUEUE_ROWS.- FREE_SPACE_PATH = PATH
Wo MIN_FREE_SPACE gemessen wird (
statvfs(3), der für einen unprivilegierten Schreiber verfügbare Platz). Optional; Standardwert/var/lib/postgresql, das Elternverzeichnis der Datenverzeichnisse der Debian-Cluster – ein Datenverzeichnis selbst ist0700 postgres, aberstatvfsmuss einen Pfad nur erreichen, und sein Elternverzeichnis liegt in einem Standardlayout auf demselben Dateisystem. Setzen Sie es auf das Datenverzeichnis (oder dessen Einhängepunkt), wenn PostgreSQL seine Daten anderswo hält. Liegt die Datenbank auf einem anderen Host, existiert der Standardpfad meist nicht und die Messung ist stillschweigend aus; ein hier gesetzter Pfad, der sich nicht messen lässt, wird einmal protokolliert, und die Grenze wird dann nicht durchgesetzt.- QUEUE_CHECK_INTERVAL = DURATION
Wie lange eine Messung der Warteschlange wiederverwendet wird. Optional; Standardwert
10 s. Eine Messung sind zwei sequenzielle Scans (die Funktionpepsi.queue_usage()), daher nimmt jeder Prozess höchstens eine je Intervall vor, und jedesRCPTdazwischen wird aus dem zwischengespeicherten Wert beantwortet; die Grenzen sind also bis auf die Zulassungen eines Intervalls ungenau. Schlägt eine Messung fehl, protokolliert Pepsi das und lässt Mail zu: Eine kurze Störung der Datenbank darf nicht selbst zum Ausfall werden, und Pepsi antwortet weiterhin mit451, wenn es eine Nachricht tatsächlich nicht speichern kann.- QUEUE_THROTTLE_DELAY = DURATION
Wie lange pepsi-stage-list-post(1) einen Fan-out zurückhält, nachdem es die Warteschlange voll vorgefunden hat, bevor es erneut nachsieht. Optional; Standardwert
60 s.- CT_CHECK =
warn|off Ob die TLS-Clients Certificate Transparency prüfen: die Signed Certificate Timestamps (SCTs), die in ein Serverzertifikat eingebettet sind, das zu den Systemwurzeln führt. Das umfasst MTA-STS und verifizierte Smarthost-Zustellung, den PKIX-Rückfall der DANE-Stage und die WKD/VKS-Abrufe der Schlüsselentdeckung (einschließlich derer unter
[pepsi-keydiscovery] TLS_CA_BUNDLE). Ein Zertifikat besteht mit mindestens zwei gültigen SCTs (drei, wenn es länger als 180 Tage gültig ist) aus Logs zweier verschiedener Betreiber. Optional; Standardwert istwarn.warnprotokolliert eine Warnung für ein Zertifikat, das nicht besteht, und verbindet sich trotzdem: Ein Zertifikat, das eine CA ausgestellt hat, ohne es zu loggen, erscheint in Pepsis eigenem Log, aber die Prüfung kann keine Mail aufhalten. Einen Modus, der ablehnt, gibt es bewusst nicht. Eine gegenTLS_CAoder dasTLS_CA_BUNDLEeines Smarthosts verifizierte Verbindung (die private CA eines Betreibers, deren Zertifikate nicht geloggt werden) wird nie geprüft.offprüft nichts.- CT_LOG_LIST = PATH
Die Liste der Certificate-Transparency-Logs, gegen die die SCTs geprüft werden, im JSON-Format der v3-Log-Liste von Google. pepsi-keys(1)
ct-logs update, täglich vonpepsi-keys-ct-logs.timerausgeführt, hält sie aktuell. Die Datei ist öffentlich und muss für jedes Pepsi-Programm lesbar sein. Ohne sie oder wenn ihrlog_list_timestampälter als 70 Tage ist, wird nichts geprüft (auf Debug-Stufe protokolliert). Optional; Standardwert ist/var/lib/pepsi/ct-log-list.json.- CT_LOG_LIST_URL = URL
Woher
pepsi-keys ct-logs updatedie Liste abruft. Optional; Standardwert isthttps://www.gstatic.com/ct/log_list/v3/log_list.json. Ein Betreiber kann sie auf einen Spiegel richten; eine Liste, die älter ist als die vorhandene, wird abgelehnt, sofern nicht--forceangegeben ist.- DNS_SERVERS = LIST
The resolvers for every program that makes DNS lookups and whose own section names none: the
DNS_SERVERSof pepsi-ingress(1), pepsi-stage-arc(1) and both relay stages, and the lookups that have no option of their own (DANE key discovery, pepsi-tlsrpt(1), pepsi-reputation(1)check, pepsi-setup(1), pepsi-status(1)). Optional; when unset,/etc/resolv.confis used.Einträge werden durch Leerraum oder Kommas getrennt, jeder davon eines von:
eine IP-Adresse (IPv4 oder IPv6): schlichtes DNS auf Port 53, UDP und dann TCP, wenn eine Antwort abgeschnitten ist;
tls://ADDRESS[:PORT]#NAME: DNS over TLS (RFC 7858), standardmäßig Port853;https://ADDRESS[:PORT][/PATH]#NAME: DNS over HTTPS (RFC 8484), ein HTTP/2-POSTan PATH (Standardwert/dns-query), standardmäßig Port443.
Eine IPv6-ADDRESS wird in den beiden URL-Formen in Klammern geschrieben (
tls://[2001:db8::53]#dns.example.net). Die Adresse ist erforderlich, sodass keine Abfrage nötig ist, um den Resolver zu erreichen, und ebenso NAME: Das Zertifikat des Resolvers muss für ihn gültig sein und zu den Systemwurzeln führen. Eine Liste enthält entweder schlichte oder verschlüsselte Einträge, nie beide (ein fehlschlagender verschlüsselter Resolver fiele sonst auf schlichtes DNS zurück), und es gibt keinen Rückfall auf schlichtes DNS, wenn die verschlüsselten Resolver nicht erreichbar sind: Die Abfrage scheitert als vorübergehender Fehler. Eine Liste, die sich nicht parsen lässt, lässt die Stages, die sie lesen, den Start verweigern und jede Abfrage scheitern, die sie verwenden würde.Ein verschlüsselter Eintrag schützt den Weg zum Resolver, daher vertraut Pepsi dem DNSSEC-AD-Bit eines darüber erreichten Resolvers, wie bei einem Resolver auf Loopback (siehe pepsi-stage-relay-to-internet(1), DANE). Der Resolver muss DNSSEC weiterhin selbst validieren.
- DNS_TIMEOUT = DURATION
Der DNS-Timeout pro Abfrage für jedes Programm, dessen eigener Abschnitt kein
DNS_TIMEOUTsetzt. Optional; wenn nicht gesetzt, gilt der eigene Standardwert jedes Programms (5 sfür die meisten). Wie dasDNS_TIMEOUTeines Abschnitts begrenzt es eine Abfrage nur dort, wo die Resolver aus einerDNS_SERVERS-Liste stammen; mit/etc/resolv.confgilt dasoptions timeout:des Systems.- MAIL_LOG =
off|summary|full Ob eine Aufzeichnung je Nachricht geführt wird. Optional; Standardwert ist
off.Pepsi löscht den Datensatz einer Nachricht, wenn die Pipeline mit ihr fertig ist, sodass es normalerweise kein Erfolgsjournal je Nachricht gibt: Eine gewöhnliche Installation sammelt keine Aufzeichnung der Korrespondenz ihrer Benutzer an und kann nicht gezwungen werden, eine herauszugeben, die sie nicht hat.
Diese Option zu setzen ändert das.
summaryschreibt einenpepsi.mail_log-Datensatz, wenn eine Nachricht die Pipeline verlässt: mit dem Umschlagabsender und den Empfängern, der Richtung (outboundfür lokal eingelieferte Mail, sonstinbound), der Stage, an der sie endete, dem Ergebnis (completed/failed) und dem, was die Pipeline über sie entschieden hat (eine geschlossene Liste vonstate-Schlüsseln: das Authentifizierungsurteil, die Spam- und die Bezahlt-Entscheidung, etwaige Fehlerdetails des nächsten Hops sowie die Krypto- und Sprachbefunde).fullhält zusätzlich dieSubject:-Zeile fest. Nachrichteninhalt wird bei keiner Einstellung je aufgezeichnet.Warnung
Dies einzuschalten bedeutet, dass die Installation eine Aufzeichnung darüber führt, wer mit wem korrespondiert. Manche Installationen brauchen diesen Nachweis wirklich; vergewissern Sie sich, dass Ihre dazugehört und dass es dort, wo Sie tätig sind, rechtmäßig ist, ihn aufzubewahren.
Datensätze sind über
GET /api/v1/mail-logfür einen Prinzipal lesbar, derlogs:readhält, sind für jede mailverarbeitende Komponente nur anfügbar und werden nach[pepsi-admin] MAIL_LOG_RETENTION_DAYSTagen beschnitten. Der Datensatz wird von derselben Anweisung geschrieben, die die Nachricht entfernt oder als fehlgeschlagen markiert, sodass das Aktivieren des Journals keinen zusätzlichen Datenbank-Round-Trip kostet. Siehe das Kapitel „Die administrative API“ des Handbuchs.- ALLOW_FUSION =
yes|no Ob Stage-Fusion erlaubt ist. Eine Stage fusioniert mit dem Nachfolger, zu dem sie weiterschaltet, wenn der Nachfolger mit
FUSION = yesmarkiert ist (siehe die stageweise Option unten), seinPROGRAMin dasselbe vereinheitlichtepepsi-Binärprogramm eingefaltet ist und er keine Nachrichtenspalte benötigt, die der Vorgänger nicht bereits geladen hat. Der Vorgänger führt dann den Rumpf des Nachfolgers in seinem eigenen Worker-Prozess aus. Das erspart sowohl das weiterschaltendeUPDATEals auch das ladendeSELECTdes Nachfolgers, und der Dispatcher erhält einen einzigen Abschluss für die gesamte fusionierte Kette. Optional; Standardwert istyes. Setzen Sie es aufno, um jeden Stage-Übergang zurück durch die Datenbank und den Dispatcher zu zwingen (der Benchmark, der die Kosten jeder Stage misst, tut dies, damit jede Stage als eigener, vom Dispatcher gestarteter Worker gemessen wird). In einem programmweisen (multibin-)Build findet nie Fusion statt, denn dort ist ein Nachfolger immer ein separater Prozess. Siehe pepsi-dispatch(1) für das vollständige Modell.- REFLECTION_HOLD_MAX
(Dauer, optional) Die längste zufällige Zurückhaltung reflektierter Mail — eine von pepsi-stage-bounce(1) geschriebene DSN, eine Kopie, die ein Alias (pepsi-stage-aliases(1)) oder eine
~/.forward(pepsi-stage-dot-forward(1)) erneut sendet, die Verteilung einer Mailingliste (pepsi-stage-list-post(1)). Jede solche Nachricht wird, bevor die nächste Stage sie sieht, für eine Zeit zurückgehalten, die jedes Mal neu und gleichverteilt zwischen null und diesem Wert gezogen wird: Die erzeugende Stage gibt siepausedmit diesemtimeoutstattpendingweiter, und der Durchlauf des Dispatchers für pausierte Wiederholungen gibt sie frei. Ginge reflektierte Mail nach der eigenen, vorhersehbaren Latenz der Pipeline hinaus, könnte der Absender des Originals sie so takten, dass die Reflexionen vieler Hosts ein Opfer in einem einzigen Puls erreichen. Verteilt jeder Host seine Reflexionen über ein zufälliges Fenster, glättet das diesen Puls. Standardwert30 s;0 sschaltet die Zurückhaltung ab; höchstens10 m(Einheitens/m). Automatische Antworten (die Abwesenheitsnotiz, eine Zahlungsaufforderung, eine Challenge) werden nicht zurückgehalten — sie werden stattdessen je Absender ratenbegrenzt.- MTA_STS_MODE =
enforce|testing|none Modus der für unsere Domains veröffentlichten MTA-STS-Richtlinie.
enforceundtestingveranlassen pepsi-setup(1), einen_mta-sts.<domain>-TXT-Eintrag auszugeben (und pepsi-httpd(1), die zugehörige Richtliniendatei anzubieten);noneschaltet das Veröffentlichen von MTA-STS ab. Optional; Standardenforce. MTA_STS_MX legt fest, welche Hosts die Richtlinie erlaubt.- MTA_STS_MX = EINTRAG[, EINTRAG…]
Die als
mx:-Zeilen in der MTA-STS-Richtlinie veröffentlichten Hosts, also jeder MX, an den ein Absender zustellen darf (RFC 8461 §3.2:mx„must appear at least once and may appear more than once“). Jeder EINTRAG ist entwederHOSTein Hostmuster, das für jede bediente Domain gilt, oder
DOMAIN:HOSTein Hostmuster, das für genau diese eine bediente Domain gilt.
Die
mx-Menge einer Domain sind die unqualifizierten Einträge plus die mit ihrem eigenen Namen qualifizierten; qualifizierte Einträge ergänzen die gemeinsame Menge, statt sie zu ersetzen, ein Betrieb, dessen Domains einen primären MX teilen, schreibt ihn also einmal und kann ihn nicht dadurch verlieren, dass er den Backup einer Domain qualifiziert. Ein Hostmuster darf eine einzelne führende Label-Wildcard verwenden (*.example.net), und:ist als Trenner eindeutig, weil ein Hostname keinen enthalten kann.Die Richtlinie ist daher je Domain, und genau das braucht ein Rechner, der mehrere Domains bedient: die MX-Einträge jeder Domain benennen ihre eigenen Hosts, und es gibt keinen Grund, weshalb diese übereinstimmen sollten. Die Richtlinie jeder Domain erhält ihre eigene
idin ihrem eigenen_mta-sts.<domain>-TXT-Eintrag, Absender speichern sie also unabhängig zwischen:MTA_STS_MX = example.org:mx.example.org, example.net:mail.example.net
Optional. When the option is absent entirely, every domain’s policy names the
[pepsi-ingress] HOSTNAME. That fallback is a last resort, not a good default:HOSTNAMEis theEHLOgreeting name, which need not be a name that anyMXrecord points at. When it is not, anenforcepolicy tells every compliant sender not to deliver to the domain at all. So set this option to the hosts yourMXrecords actually name. The pepsi-setup(1) wizard reads them out of DNS and writes the option for you, and everypepsi-setup runre-checks the resolved set against liveMXrecords and prints the option to set when they disagree (see pepsi-setup(1), MTA-STS cross-checks).Unter dem Standardmodus
enforcesagt eine Richtlinie, die einen Host auslässt, jedem konformen Absender, dass er dorthin nicht zustellen darf; ein aus dieser Liste weggelassener Backup-MX empfängt also keine Post, solange der primäre ausgefallen ist.Jeder genannte Host muss außerdem ein TLS-Zertifikat vorlegen, das für seinen eigenen Namen gültig ist (RFC 8461 §4.1), und pepsi-setup(1) stellt das bereit: die hier aufgeführten Hosts werden Subject Alternative Names auf dem Zertifikat der Ingress-Listener, das beim nächsten
pepsi-setup runüber certbot geweitet wird, falls es sie noch nicht abdeckt. Pepsi verwendet ein Zertifikat und nicht eines je Host, weil pepsi-ingress(1) je Listener ein einziges Zertifikat ausliefert und nicht nach SNI auswählt. Ein Wildcard-Eintrag ist die Ausnahme: HTTP-01 kann keinen beschaffen, dieses Zertifikat muss daher mitTLS_CERT/TLS_KEYbereitgestellt werden.- MTA_STS_MAX_AGE = SECONDS
Das in der MTA-STS-Richtlinie veröffentlichte
max_age(wie lange Absender sie zwischenspeichern dürfen). Optional; Standardwert ist604800(eine Woche). RFC 8461 §3.2 begrenzt es auf1..``31557600``, und ein Wert außerhalb davon wird zurückgewiesen — insbesondere0, das eine sofort ablaufende Richtlinie veröffentlichen und damit MTA-STS abschalten würde, während es aussähe, als wäre es konfiguriert.- TEMPLATE_DIR = PATH
Verzeichnis, das die zur Laufzeit expandierten Nachrichtenvorlagen (
<name>.<lang>.body) enthält — zum Beispiel die Zahlungsaufforderungs-Antwort von pepsi-stage-anti-spam(1) und denBOUNCE_MESSAGE-Body von pepsi-stage-bounce(1). Optional; Standardwert ist${DATADIR}/templates, womake installdie mitgelieferten Vorlagen ablegt.${DATADIR}wird aus dem Installationspräfix des laufenden Binärprogramms aufgelöst, sodass der Standardwert für eine--prefix=/usr-Installation/usr/share/pepsi/templatesist und jedem anderen Präfix folgt; setzen Sie diese Option nur, wenn die Vorlagen dort liegen, wo das Präfix es nicht impliziert.- LOG_JSON =
yes|no Gibt das Journal als strukturierte JSON-Zeilen (ein JSON-Objekt pro Eintrag) auf der Standardfehlerausgabe aus, statt im standardmäßigen menschenlesbaren Textformat, sodass ein Log-Aggregator wie Loki es ohne zusätzliches Parsen aufnehmen kann. Gilt für jedes Pepsi-Binärprogramm außer pepsi-setup(1), das das Logging einrichtet, bevor es eine Konfiguration lädt. Optional; Standardwert ist
no(Text). Die-L/--log-Log-Stufen-Option und-v/--verbosegelten in beiden Formaten.- LOG =
error|warn|info|debug|trace Standardmäßige maximale Log-Stufe für jedes Pepsi-Binärprogramm. Alle Komponenten laden dieselbe Konfiguration, auch die Stage-Worker, die der Dispatcher startet und die kein eigenes Kommandozeilen-Log-Flag erhalten. Diese Option ist daher die einzige Einstellung, die das Logging über die gesamte Pipeline auf einmal senkt oder anhebt; die Benchmark-Skripte setzen sie zum Beispiel auf
warn, damit das Logging je Nachricht ihre Messungen nicht verzerrt. Optional; Standardwert istinfo. Das-L/--log-Flag überschreibt sie, wenn angegeben, für diesen einen Prozess. pepsi-setup(1) ignoriert diese Option, da es das Logging einrichtet, bevor es eine Konfiguration lädt; übergeben Sie dort-L.- PUBLIC_RESOLVERS = IP … |
none Die öffentlichen rekursiven Resolver, über die pepsi-setup(1) die DNS-Einträge, von denen dieser Host abhängt, so erneut prüft, wie das Internet sie sieht: den Reverse-DNS jeder
PUBLIC_IP, dieMX- und TXT-Einträge jeder bedienten Domain und die Adressen des Ingress-HOSTNAME(siehe DNS, wie das Internet es sieht in pepsi-setup(1)). Eine durch Leerzeichen oder Kommas getrennte Liste von IP-Adressen. Optional; Standardwert sind Google (8.8.8.8,2001:4860:4860::8888), Cloudflare (1.1.1.1,2606:4700:4700::1111) und Quad9 (9.9.9.9,2620:fe::fe).noneschaltet die Prüfung ab.Die Prüfung gibt es, weil eine Abfrage von diesem Host aus nicht erkennen kann, wenn eine Zone nur aus dem Netz dieses Hosts erreichbar ist: Ein Nameserver hinter NAT, dessen Port 53 nicht weitergeleitet wird, sieht von innen gesund aus. Die Namen, die die Prüfung an diese Resolver sendet, sind Namen, die dieser Host für jedermann zur Abfrage veröffentlicht; setzen Sie trotzdem
none, wenn Sie lieber keinen fremden Resolver befragen lassen wollen, und prüfen Sie stattdessen von einem Rechner außerhalb Ihres Netzes. Nur von pepsi-setup gelesen.- SHARE_TELEMETRY =
yes|no Ob diese Installation anonyme Funktionsnutzungs-Telemetrie mit dem Pepsi-Projekt teilt. Opt-in: optional, Standardwert
no, sodass eine Installation, die es nie setzt, nichts teilt. Aufyesgesetzt erzeugt pepsi-setup(1) eine zufälligeSYSTEM_ID(unten), und der pepsi-telemetry-client(1)-Daemon aggregiert Funktionsnutzungs-Ereignisse von den Stage-Workern und pepsi-ingress(1) und übermittelt funktionsweise Zähler anTELEMETRY_SERVERunter dieser anonymen ID (keine Adressen, Nachrichtendaten, Hostnamen oder IP-Adressen). Aufnobelassen bleibt ein laufender Daemon ruhend (kein Socket, nichts wird übermittelt), es wird keineSYSTEM_IDerzeugt, und die In-Process-Telemetrie-Aufrufe sind No-Ops, die keinen Socket öffnen. Ein nicht parsbarer Wert wird alsnogelesen. Wer diese Option in der Datei ändert, benachrichtigt den Daemon (telemetry_changed); außerdem liest der Daemon die Datei jede Minute neu. Die Setup-Konsole im Browser kann sie nur einschalten, solange der Daemon mit einerSYSTEM_IDläuft.- SYSTEM_ID = 64-HEX
Anonymer 256-Bit-Bezeichner (64 Hexadezimalzeichen), der mit jedem Telemetriebericht übermittelt wird. Von pepsi-setup(1) erzeugt und hier geschrieben, erst wenn
SHARE_TELEMETRYeingeschaltet wurde, sodass eine Installation, die nicht zugestimmt hat, nie einen bekommt. Von pepsi-telemetry-client(1) benötigt. Ein Betreiber kann bei ausgeschalteter Telemetrie von Hand einen hinzufügen; das ist es, was der Browser-Konsole erlaubt, das Einschalten der Telemetrie anzubieten; ein Speichern in der Konsole behält ihn bei. Verwenden Sie ihn nicht über Installationen hinweg wieder.- TELEMETRY_SERVER = HOST | URL
Der zentrale Telemetrie-Collector. Optional; Standardwert ist
telemetry.pepsi.taler.net. pepsi-telemetry-client(1) übermittelt anhttps://<server>/telemetry/{usage,features}; ein Wert mit einem explizitenscheme://wird wörtlich beachtet (z. B.http://localhost:18080für lokales Testen).
Die folgenden CRYPTO_*-Optionen regeln die Ende-zu-Ende-Nachrichtenkryptographie (OpenPGP und S/MIME) — nicht die DKIM/ARC-Schlüssel oben. Sie sind bewusst Systemadministrator-Einstellungen und stehen in [pepsi] statt in einem [stage-*]-Abschnitt, was sie strukturell außer Reichweite der Überschreibungsschicht je Adresse bringt (pepsi.settings überschreibt nur Stage-Abschnitte) und daher von pepsi-stage-edit-settings(1): Algorithmuswahl, Herabstufungserlaubnis, Annahme schwacher Digests und Mindestschlüsselgrößen sind Sicherheitsentscheidungen mit sicherem Standardwert, keine Vorlieben je Benutzer. Jede ist optional; eine Installation ohne Ende-zu-Ende-Kryptographie kann sie alle ignorieren. Der Schlüsselspeicher, in dem jene Schlüssel liegen, wird in [pepsi-crypto] (unten) konfiguriert und mit pepsi-keys(1) verwaltet.
- CRYPTO_ALLOW_DOWNGRADE =
no|negotiate|yes Ob Pepsi einen herabgestuften Container ausgeben darf (S/MIME-AES-256-CBC-
EnvelopedData, OpenPGP-SEIPDv1-mit-MDC) und 3DES bei der Entschlüsselung annehmen darf. Optional; Standardwert istnegotiate, was je Empfänger herabstuft und nur, wenn dieser Empfänger es nicht besser kann. Das ist wichtig, denn ein großer Teil der installierten Basis kann eine RFC-9580-AEAD-Nachricht überhaupt nicht lesen. Das Lesen von SEIPDv1 und AES-CBC ist immer erlaubt und wird von dieser Option nicht beschränkt.Bei OpenPGP sagt das eigene Zertifikat des Empfängers, ob er SEIPDv2 liest. Bei S/MIME, dessen Zertifikate keine Inhaltsverschlüsselungsfähigkeit ankündigen, ist die Antwort der S/MIME-Fähigkeitsdatensatz des Empfängers: gelernt aus dem
SMIMECapabilities-Attribut nach RFC 8551 der signierten Mail des Korrespondenten (von pepsi-stage-autocrypt-learn(1)) oder konfiguriert mitpepsi-keys peer capability set ADDRESS aead|cbc. Unternegotiateerhält nur ein Empfänger, für den festgehalten ist, dass er AES-256-GCM-AuthEnvelopedDatanicht lesen kann, AES-256-CBC-EnvelopedData; ein Empfänger ohne Datensatz erhält AEAD. Thunderbird 140.12.0esr kannAuthEnvelopedDatanicht lesen und scheitert stillschweigend — kein Fehler, ein leerer Klartext —, daher braucht ein Thunderbird-Benutzer, der nie eine signierte Nachricht gesendet hat, einen konfigurierten Datensatz.nolehnt einen Empfänger ab, für den festgehalten ist, dass er AEAD nicht lesen kann (die Richtlinie der Verschlüsselungs-Stage für fehlende Schlüssel entscheidet);yessendetEnvelopedDataan jeden S/MIME-Empfänger, gleich was sein Datensatz sagt, für einen Betreiber, der die globale Herabstufung will. Die Messung istpepsi-crypto/tests/thunderbird.rs; die Client-Matrix steht im Interoperabilitätskapitel des Handbuchs.yesvergröbert OpenPGP nicht: Die Verschlüsselungs-Stage fordert den Containerautoan, den sowohlnegotiateals auchyesje Empfänger auflösen — AEAD für ein Zertifikat, das SEIPDv2 ankündigt, SEIPDv1+MDC nur für eines, das es nicht tut. Der Unterschied zwischen den beiden Werten ist der S/MIME-Container und die Annahme einer eingehenden 3DES-S/MIME-Nachricht, die unter keiner Einstellung je ausgegeben wird. Eingehendes OpenPGP-3DES wird unternegotiateebenso wie unteryesangenommen und nur unternoabgelehnt: Ein OpenPGP-Zertifikat gibt seine eigenen Chiffrierfähigkeiten an, sodassnegotiateetwas hat, womit es aushandeln kann, während X.509 keine ankündigt und daher die strengere Regel bekommt. Eingehendes OpenPGP-Blowfish, die andere Chiffre mit 64-Bit-Blöcken, folgt genau der 3DES-Regel.pepsi-setupschreibt diese Option nur auf Anforderung: Der Standardwert je Empfänger braucht keine Zeile inpepsi.conf, daher erfolgt eine bewusste Einstellung durch Bearbeiten vonpepsi.confvon Hand oder mitpepsi-setup --wizard --expert=CRYPTO_ALLOW_DOWNGRADE. Es warnt, wenn der Wertyesist.- CRYPTO_ALLOW_WEAK_DIGESTS =
yes|no SHA-1-Signaturen bei der Verifikation annehmen. Optional; Standardwert ist
no. Eine Signatur unter einem schwachen Digest wird als solche gemeldet, nie stillschweigend als gültig gezählt. Eine ECDSA-Signatur mit SHA-1 wird nur auf P-256 geprüft; auf P-384 wird sie unabhängig von dieser Option als nicht unterstützt gemeldet. Eine MD5-Signatur wird unabhängig von dieser Option abgelehnt: MD5-Kollisionen lassen sich in Sekunden berechnen, sodass eine solche Signatur nichts darüber aussagt, was signiert wurde. pepsi-setup(1) warnt, wenn esyesist.- CRYPTO_MIN_RSA_BITS = BITS
Kleinster RSA-Modulus, der bei eingehender Verifikation und ausgehender Verschlüsselung akzeptiert wird. Bei S/MIME gilt er für das Blattzertifikat und jedes Zwischenzertifikat der Kette, aber nicht für einen konfigurierten Vertrauensanker. Optional; Standardwert ist
2048. Werte unter1024werden rundweg abgelehnt. Wird die Untergrenze gesenkt, wird ein Schlüssel zwischen ihr und 2047 Bit zum Prüfen einer Signatur akzeptiert und als Warnung protokolliert, und pepsi-setup(1) warnt vor der gesenkten Untergrenze selbst. An einen solchen Schlüssel kann dennoch nicht verschlüsselt werden, und er kann weder signieren noch entschlüsseln, da AWS-LC, das jede RSA-Operation ausführt, dafür 2048 bis 8192 Bit annimmt; und eine SHA-384-Signatur mit ihm wird als nicht unterstützt gemeldet, da AWS-LC Schlüssel unter 2048 Bit nur mit SHA-1, SHA-256 und SHA-512 prüft. Unabhängig von der Untergrenze wird ein RSA-Schlüssel, dessen privater Schlüssel aus seinem Modulus folgt (der ROCA-Fingerabdruck oder Primzahlen nah genug für Fermats Methode), wie ein Schlüssel unter ihr abgelehnt, ebenso ein Schlüssel beliebigen Typs auf der Liste bekanntermaßen kompromittierter Schlüssel (pepsi.compromised_key, siehe[pepsi-keydiscovery] BADKEYS_URL).- CRYPTO_GENERATE_RSA_BITS =
2048|3072|4096|8192 Modulusgröße, die verwendet wird, wenn diese Installation einen RSA-Schlüssel erzeugt. Optional; Standardwert
2048. Das sind die vier Größen, die AWS-LC in konstanter Zeit erzeugt; jeder andere Wert wird beim Lesen der Konfiguration abgelehnt (vonpepsi-setup,pepsi-keysund den Krypto-Stages gleichermaßen), weil ein Schlüssel einer anderen Größe von einem Schlüsselgenerator stammen müsste, der nicht in konstanter Zeit arbeitet. Er darf nicht unterCRYPTO_MIN_RSA_BITSliegen, denn eine Installation darf keine Schlüssel erzeugen, die sie dann ablehnt. Die OpenPGP-Schlüsselerzeugung akzeptiert nur2048,3072oder4096. Jede spätere Verwendung des privaten Schlüssels (Signieren, Entschlüsseln) erfolgt ebenfalls durch AWS-LC.- CRYPTO_INLINE_PGP =
accept|reject Wie inline (nicht MIME) eingebettetes PGP zu behandeln ist. Optional; Standardwert
accept, denn echte Absender geben es weiterhin aus. Pepsi erzeugt es nie.- CRYPTO_OPENPGP_ALGORITHM =
ed25519|rsa Algorithmus, der beim Erzeugen einer neuen OpenPGP-Identität verwendet wird. Optional; Standardwert
ed25519— die Erzeugung ist augenblicklich, was zählt, weil eine Identität womöglich erzeugt werden muss, während eine Nachricht wartet.rsaverwendetCRYPTO_GENERATE_RSA_BITS.- CRYPTO_SMIME_ALGORITHM =
p256|p384|rsa Algorithmus, der beim Erzeugen einer neuen S/MIME-Identität verwendet wird. Optional; Standardwert
p256, ECDSA/ECDH über NIST P-256;p384ist dasselbe über P-384, undrsaist RSA mitCRYPTO_GENERATE_RSA_BITS.Die Wahl entscheidet, wie eingehendes S/MIME unseren privaten Schlüssel erreicht, weshalb der Standardwert eine Kurve ist. Mail an eine EC-Identität kommt als ECDH-Schlüsselvereinbarung (
KeyAgreeRecipientInfo) an und erreicht nie eine RSA-Private-Key-Operation auf einem Chiffrat, das der Absender gewählt hat; die Schlüsselvereinbarung, ECDSA-Signaturen und die Schlüsselerzeugung erfolgen durch AWS-LC, in konstanter Zeit, und das Erzeugen der Identität dauert Millisekunden. Mail an eine RSA-Identität kommt als RSA-Schlüsseltransport an (PKCS#1 v1.5 oder OAEP, wie der Absender wählt), den pepsi-stage-decrypt mit dem RSA von AWS-LC in konstanter Zeit und mit Blinding entpackt, mit impliziter Zurückweisung nach RFC 8017 und einer randomisierten Mindestdauer; eine Verzweigung über das Dekodierurteil von AWS-LC für PKCS#1 v1.5 oder OAEP bleibt, die seine Schnittstelle nicht vermeiden kann. AWS-LC akzeptiert RSA-Schlüssel von 2048 bis 8192 Bit. Eine RSA-Identität außerhalb dieses Bereichs kann weder entschlüsseln noch signieren und wird mit einer Warnung abgelehnt; Pepsi erzeugt keine solche, in der Praxis ist es also ein importierter Schlüssel unter 2048 Bit bei gesenktemCRYPTO_MIN_RSA_BITS. RSA-Signaturen und die Selbstsignaturen der Zertifikate und Anforderungen, die Pepsi erzeugt, erfolgen ebenfalls durch AWS-LC.Wählen Sie
rsafür eine Installation, deren Korrespondenten-Clients nicht an ein Elliptische-Kurven-Zertifikat verschlüsseln können, oder wenn SieCRYPTO_SMIME_SHARED_KEY = yeswollen, was nur mit RSA geht. Für OpenSSL 3.5 wurde gemessen, dass es an ein solches Zertifikat verschlüsseln kann; für Thunderbird 140 wurde nur das Lesen von ECDH-Chiffrat gemessen, und Outlook und Apple Mail wurden überhaupt nicht gemessen (siehe das Interoperabilitätskapitel des Handbuchs). Die Option prägt nur neu erzeugte Identitäten: Eine bestehende RSA-Identität, erzeugt oder importiert, signiert und entschlüsselt weiter, da jede Abfrage nach Fähigkeit statt nach Algorithmus auflöst, und die übrigen RSA-Vorbehalte oben gelten für sie weiterhin, bis eine neue Identität sie ablöst (pepsi-keys(1)identity generatemacht das neue Material zum primären).- CRYPTO_SMIME_SHARED_KEY =
yes|no Ein S/MIME-Zertifikat ausstellen, das sowohl
digitalSignatureals auchkeyEnciphermentträgt, statt eines getrennten Signier- und Verschlüsselungszertifikats. Optional; Standardwertno.Der Standardwert trennt sie, weil ein getrenntes Signierzertifikat bei Ablauf oder Widerruf zerstört werden kann — nichts Legitimes signiert je alte Mail neu, sodass ein ausgemusterter Signierschlüssel nur noch ein Fälschungsrisiko ist —, während die Entschlüsselungshälfte behalten wird, damit archiviertes und unterwegs befindliches Chiffrat lesbar bleibt. Wer dies einschaltet, halbiert die Zahl der Zertifikate, die ein Betreiber je Identität kauft, und gibt diese Trennung auf: Ein gemeinsamer Schlüssel folgt der Entschlüsselungsregel, sodass das Widerrufen eines kompromittierten Signierschlüssels auch die Fähigkeit beendet, an diesem Zertifikat neue verschlüsselte Mail zu empfangen.
Die Option entscheidet nur, wie neu erzeugte Identitäten aussehen. Beide Gestalten werden dauerhaft unterstützt und können für eine Adresse nebeneinander bestehen, sodass jede Abfrage nach Fähigkeit statt nach Gestalt auflöst. Zusammen mit einem Elliptische-Kurven-
CRYPTO_SMIME_ALGORITHMwird sie von pepsi-setup(1) abgelehnt: Einen EC-Schlüssel sowohl für ECDSA als auch für ECDH zu verwenden, ist algorithmusübergreifende Schlüsselwiederverwendung, und mehrere S/MIME-Clients lehnen sie ab.
95.2.1.1.6. Der Abschnitt [pepsi-postgres]¶
Gemeinsame Datenbank-Verbindungseinstellungen. Jede Pepsi-Komponente verbindet sich mit der gleichen Datenbank und dem gemeinsamen pepsi-Schema, daher liegen diese Einstellungen in einem Abschnitt, statt pro Komponente wiederholt zu werden.
Bemerkung
Verbindungsbudget. Jeder Pepsi-Prozess öffnet seinen eigenen Verbindungspool. Die Stage-Worker und die Betreiber-CLIs erledigen ihre Datenbankarbeit streng seriell, sodass jeder von ihnen eine einzige Verbindung verwendet. Der Dispatcher betreibt bis zu einen Worker-Prozess pro Stage-Slot (die Summe der PARALLELISM der Stages), daher hält diese Regel von einer Verbindung pro Worker den Großteil der Verbindungszahl vorhersagbar und minimal. Die nebenläufigen Komponenten halten einen kleinen begrenzten Pool, der durch ihre eigene DB_POOL_SIZE-Option dimensioniert wird: der pepsi-dispatch(1)-Koordinator (Standardwert 8, weil er die Ergebnisse vieler Worker nebenläufig verarbeitet) und die Server pepsi-ingress(1) und pepsi-httpd(1) (Standardwert je 1). Achten Sie beim Tuning darauf, dass Σ PARALLELISM (eine Verbindung pro lebendem Worker) + der Dispatcher-Pool + die Pools der beiden Server unter dem max_connections des Servers bleibt. Das QUEUE_LIMIT einer Stage geht nicht in dieses Budget ein: Mehr Nachrichten auf einen Worker zu pipelinen erhöht seine Zahl in Bearbeitung, nicht die Anzahl der Worker-Prozesse (oder Verbindungen), sodass man mit dieser Einstellung den Durchsatz gefahrlos erhöht, wenn max_connections der begrenzende Faktor ist.
- CONFIG
(Zeichenkette, erforderlich) PostgreSQL-Verbindungszeichenfolge oder -URI, z. B.
postgres:///pepsi. Der Server setzt den Schema-Suchpfad aufpepsiund verwendetREAD COMMITTED-Transaktionen (höchstens ein Schreiber berührt jemals einen gegebenen Warteschlangen-Datensatz, sodass serialisierbare Isolation unnötig ist).Diese Datei ist für alle lesbar, daher darf die Zeichenfolge kein Passwort enthalten; jede Komponente verweigert mit einem solchen den Start.
Lokale Datenbank (die kanonische Einrichtung). Jede Komponente verbindet sich über den UNIX-Socket als die Rolle, die nach ihrem eigenen Systemkonto benannt ist (
pepsi,pepsi-ingress,pepsi-httpd,pepsi-crypto, …), und die Peer-Authentifizierung von PostgreSQL prüft die UID. Nirgends existiert ein Passwort, und die Datenbankrechte jeder Rolle sind die Privilegiengrenze zwischen den Komponenten.Entfernte Datenbank (empfohlene Einrichtung). Behalten Sie dasselbe Modell bei: eine Rolle pro Konto, jede mit eigenen Zugangsdaten, die kein anderes Konto lesen kann. Wenn sich eine Komponente verbindet, wird der Platzhalter
{role}in der Verbindungszeichenfolge durch die Rolle ersetzt, als die sie sich verbindet, sodass eine Zeichenfolge für jede Rolle eine andere Datei benennt. Mit Client-Zertifikaten (diepg_hba.confder Datenbank verwendetcert):CONFIG = postgres://db.example.org/pepsi?sslmode=verify-full&sslcert=/etc/pepsi/postgres/{role}.crt&sslkey=/etc/pepsi/postgres/{role}.keyoder mit Passwörtern, eine libpq-Passwortdatei (
.pgpass-Format, z. B. die einzelne Zeile*:*:*:*:<password>) pro Rolle:CONFIG = postgres://db.example.org/pepsi?sslmode=verify-full&passfile=/etc/pepsi/postgres/{role}.pgpasssslmode=verify-fullprüft das Serverzertifikat gegen den Wurzelspeicher des Systems, wie jede andere TLS-Verbindung von Pepsi (SSL_CERT_FILEundSSL_CERT_DIRersetzen den Speicher), sodass ein Zertifikat einer lokalen CA verifiziert, sobald diese CA dort installiert ist (unter Debian: eine Datei in/usr/local/share/ca-certificatesundupdate-ca-certificates). Anders als bei libpq fügtsslrootcert=DATEIdie CA-Zertifikate ausDATEIdem Systemspeicher hinzu, statt ihn zu ersetzen.Jede Schlüssel- oder Passwortdatei gehört dem Konto ihrer Rolle und hat den Modus
0600oder0400; eine Passwortdatei, die jemand anderes lesen kann, wird abgelehnt, wie libpq sie ablehnt, und pepsi-setup run meldet jede Rolle, deren Konto auf dem Host existiert, deren Datei aber fehlt, einem anderen Konto gehört oder für andere offen ist. Lassen Sie den Benutzernamen in der Zeichenfolge weg (oder schreiben Sie dort{role}): Jede Komponente liefert ihren eigenen. Weil die Datei beim Öffnen der Verbindung gelesen wird, und zwar von dem Konto, das sie öffnet, liest eine setuid-Stage wie pepsi-stage-encrypt diepepsi-crypto-Datei, die der Dispatcher, der sie gestartet hat, nicht lesen kann. Die Zeichenfolge selbst enthält dann kein Geheimnis und bleibt in dieser Datei.Überschreibung per Umgebung. Die Umgebungsvariable
PEPSI_POSTGRES_CONFIGersetzt, wenn sie gesetzt und nicht leer ist, diese Option und darf ein Passwort enthalten. Jede mitgelieferte systemd-Unit liest sie ausEnvironmentFile=-/etc/pepsi/postgres.env(das vorangestellte-macht die Datei optional; halten Sie sie root-eigen mit0600, da systemd sie vor dem Start des Dienstes als root liest). Die setuid- und setgid-Programme behalten die Variable nur, wenn root oder das Dispatcher-Kontopepsisie gestartet hat, sodass die Stages die Datenbank des Dispatchers erreichen, während ein gewöhnlicher Benutzer ein privilegiertes Programm nicht auf eine andere richten kann. Ein Passwort darin ist ein Passwort für jede Rolle, was die Trennung zwischen den Komponenten aufgibt; bevorzugen Sie die Dateien pro Rolle oben und verwenden Sie die Variable für das, was sich zwischen Hosts unterscheidet. Ist sie gesetzt, darfCONFIGentfallen; ein Passwort inCONFIGwird auch dann abgelehnt. Ein aus einer Shell ausgeführtes Werkzeug (pepsi-setup run, pepsi-queue, …) braucht die Variable auf dieselbe Weise exportiert, z. B.set -a; . /etc/pepsi/postgres.env; set +a.- SQL_DIR
(Pfad, optional) Verzeichnis, das die SQL-Migrationsdateien enthält. Nur pepsi-setup(1) liest dies, beim Installieren des Schemas; die bedienenden Komponenten ignorieren es. Standardwert ist
${DATADIR}/sql(d. h.<install-prefix>/share/pepsi/sql, womake installdie Dateien ablegt). Überschreiben Sie es, wenn Sie aus einem Quellcode-Checkout ausführen.- WORKER_SYNCHRONOUS_COMMIT
(boolesch, optional) Ob die Datenbankverbindung eines Stage-Workers PostgreSQLs
synchronous_commitangeschaltet lässt. Standardwert istno.Ist es aus, kehrt das
COMMITeines Workers zurück, bevor der Write-Ahead-Log-Eintrag stabilen Speicher erreicht hat, was die Schreibvorgänge der Pipeline gruppiert committen lässt, statt dass jeder sein eigenes Flush bezahlt. Sonst ändert sich nichts: Isolation, Atomarität und Sichtbarkeit sind unberührt, und ein Absturz kann nie eine teilweise Transaktion offenlegen. Verloren gehen können die letzten paar hundert Millisekunden Dauerhaftigkeit — und das nur für Stage-Übergänge, nie für die Annahme einer Nachricht, denn pepsi-ingress(1) committet immer synchron. Ein250bedeutet weiterhin, dass die Nachricht auf der Platte ist.Verliert ein Maschinenabsturz einen Stage-Übergang, wird die Nachricht noch an der vorherigen Stage vorgefunden und läuft ein zweites Mal durch sie. Genau dasselbe passiert, wenn ein Worker getötet wird, nachdem er seine Arbeit getan hat, aber bevor er committet. Setzen Sie dies auf
yes, wenn eine Stage in Ihrer Pipeline Seiteneffekte hat, die auch über einen Stromausfall hinweg nicht wiederholt werden dürfen, und nehmen Sie die Durchsatzkosten in Kauf.
95.2.1.1.7. Der Abschnitt [pepsi-dkim]¶
Optionen für pepsi-dkim(1), den Signier-Daemon, der die privaten DKIM- und ARC-Schlüssel hält, sie rotiert und ihre DNS-Einträge meldet. Seine Manpage beschreibt jede Option vollständig; hier stehen die Namen und Standardwerte. Der Abschnitt wird vom Daemon gelesen, von pepsi-setup(1) (validate, run, check), von den Signier-Stages (nur SOCKET) sowie von pepsi-status(1) und pepsi-httpd(1) (nur PUBLIC_DIR).
- SOCKET = PATH
Der Signier-Socket. Standardwert
/run/pepsi-dkim/sign.sock.- STATE_DIR = PATH
Die privaten Schlüssel und der private Zustand des Daemons (Modus
0700, Eigentümerpepsi-dkim). Standardwert/var/lib/pepsi-dkim. Wird nicht gesichert: Nach einer Wiederherstellung erzeugt der Daemon neue Schlüssel.- PUBLIC_DIR = PATH
Das für alle lesbare Statusdokument
status.jsonund, mitPUBLISH_RETIRED_KEYS, die veröffentlichten außer Dienst gestellten Schlüssel. Standardwert/var/lib/pepsi-dkim-public.- RSA_BITS =
2048|3072|4096 Modulusgröße jedes neuen RSA-Schlüssels. Standardwert
2048.- ROTATION_DAYS = DAYS
Wie lange eine Schlüsselgeneration signiert, bevor die nächste übernimmt. Standardwert
0: keine automatische Rotation (pepsi-dkim rotaterotiert weiterhin auf Anforderung).- ROTATION_LEAD_DAYS = DAYS
Wie lange vor dem Wechsel die nächste Generation erzeugt wird, damit ihre Einträge veröffentlicht werden können. Standardwert
28; muss kürzer alsROTATION_DAYSsein.- RETIRE_AFTER_DAYS = DAYS
Wie lange der Eintrag eines ersetzten Schlüssels im DNS bleiben muss, bevor der Schlüssel außer Dienst gestellt wird. Standardwert
14; mindestens1, und er muss dasSIGNATURE_EXPIRATION_DAYSjeder pepsi-stage-dkim-sign(1)- und pepsi-stage-arc(1)-Stage überschreiten.- WAIT_FOR_DNS =
yes|no Ob ein geplanter oder angeforderter Wechsel wartet, bis jeder autoritative Server der Zone die Einträge der nächsten Generation ausliefert. Standardwert
yes.- DNS_CHECK_INTERVAL = DURATION
Wie oft jeder Eintrag bei den autoritativen Servern nachgeschlagen wird. Standardwert
1 h; mindestens eine Minute.- DNS_UPDATE =
none|rfc2136 Ob der Daemon seine Einträge selbst veröffentlicht und zurückzieht, per RFC-2136-UPDATE, mit TSIG signiert. Standardwert
none: Der Betreiber veröffentlicht sie.- DNS_UPDATE_SERVER = HOST
Wohin die Updates gehen. Standardwert: der
MNAMEdes SOA-Eintrags der Zone.- DNS_UPDATE_TTL = SECONDS
TTL der Einträge, die der Daemon hinzufügt. Standardwert
3600.- TSIG_KEY_NAME = NAME
Name des TSIG-Schlüssels. Erforderlich mit
DNS_UPDATE = rfc2136.- TSIG_ALGORITHM =
hmac-sha256|hmac-sha384|hmac-sha512 Standardwert
hmac-sha256.- TSIG_SECRET = BASE64
Der TSIG-Schlüssel. Erforderlich mit
DNS_UPDATE = rfc2136. Ein Geheimnis: pepsi-setup(1) hält es insecrets.d/pepsi-dkim.secret, nur für das Kontopepsi-dkimlesbar.- PUBLISH_RETIRED_KEYS =
yes|no Einen außer Dienst gestellten privaten Schlüssel unter
/.well-known/pepsi-dkim-retired/<domain>/<selector>.pemveröffentlichen, statt ihn zu löschen, sobald das DNS seine Einträge nicht mehr ausliefert, sodass alte Signaturen ihren Wert als Beweismittel verlieren. Standardwertno; sinnvoll mit Rotation.- NOTIFY =
yes|no Dem Postmaster eine Mail senden, höchstens einmal am Tag je ausstehender Änderung, wenn ein Eintrag hinzugefügt oder entfernt werden muss, eine Rotation auf das DNS wartet oder der DNS-Server ein Update abgelehnt hat. Standardwert
yes.- NOTIFY_ADDRESS = ADDRESS
Wer diese Benachrichtigungen erhält. Standardwert
postmaster@der ersten bedienten Domain.
95.2.1.1.8. Der Abschnitt [pepsi-srs]¶
Die Sender-Rewriting-Scheme-Parameter, geteilt von pepsi-stage-srs(1) (die Vorwärts-Umschreibung) und pepsi-ingress(1) (die Rückwärts-Dekodierung zur RCPT-Zeit), sodass Geheimnis und Domain in beiden Richtungen übereinstimmen. Das Weglassen des Abschnitts deaktiviert SRS: Die Stage verweigert die Ausführung, und Ingress behandelt SRS-aussehende Empfänger als gewöhnliche Adressen.
- SRS_DOMAIN
(Zeichenkette, erforderlich, um SRS zu aktivieren) Die Domain der umgeschriebenen Umschlagabsender. Sie muss eine Domain sein, die Sie kontrollieren: Ihr MX muss auf das Pepsi-Ingress zeigen (damit Bounces zurückkommen), und ihr SPF muss Pepsis Sende-IPs autorisieren. pepsi-setup(1) stellt Schlüssel und DNS dafür bereit. Den MX kann es nicht bereitstellen, da Sie entscheiden, wohin die Mail einer Domain geroutet wird; daher prüft es stattdessen den MX: Läuft eine Stage mit pepsi-stage-srs(1), wird eine
SRS_DOMAINohne MX und ohne Adresseintrag bei jedem Lauf gemeldet. Eine SRS-Adresse ist ein Rückweg, und eine Domain, die keine Mail empfangen kann, verliert jeden Bounce für die Mail, die dieser Host weiterleitet.Sie muss eine eigene Domain sein, die mit keiner Domain, die dieser Host bedient, DMARC-ausgerichtet ist: kein
ACCEPTED_DOMAINS-Eintrag oder eine andere Sendeidentität, keine Subdomain oder übergeordnete Domain einer solchen und keine, die ihre letzten zwei Labels mit einer solchen teilt (Pepsi hat keine Public-Suffix-Liste, daher neigt es dazu, zwei Domains als ausgerichtet anzusehen). Weitergeleitete Mail geht mit einem Umschlagabsender hinaus, der von Pepsis eigenen Adressen in diese Domain umgeschrieben wurde, sodass SPF dafür beim nächsten Hop besteht. Wäre die SRS-Domain mit einer bedienten Domain ausgerichtet, bestünde eine Nachricht, die als von dieser Domain stammend gefälscht, von außen empfangen und weitergeleitet wurde, beim nächsten Hop DMARC allein über SPF. Mit einer eigenen Domain besteht SPF weiterhin, aber DMARC stützt sich auf die eigene DKIM-Signatur des Autors. pepsi-setup(1) lehnt eine ausgerichteteSRS_DOMAINab, sofern nicht ALLOW_ALIGNED_DOMAIN gesetzt ist. Veröffentlichen Sie für diese Domain einenMX-Eintrag, der auf diesen Host zeigt, und den SPF-Eintrag, den pepsi-setup(1) ausgibt; da niemand Mail von ihr sendet, ist auch ein DMARC-Eintrag mitp=rejectangebracht. pepsi-ingress(1) dekodiert einen SRS-Local-Part bei dieser Domain, ob sie eine angenommene Domain ist oder nicht.- ALLOW_ALIGNED_DOMAIN
(boolesch, Standardwert no) Eine
SRS_DOMAIN, die mit einer bedienten Domain DMARC-ausgerichtet ist, mit einer Warnung statt eines Fehlers akzeptieren. Nur für einen Host, der keine eigene Domain haben kann: Weitergeleitete Fälschungen der ausgerichteten bedienten Domain bestehen dann beim nächsten Hop DMARC.p=quarantineoderp=rejectfür die bediente Domain zusammen mit[pepsi-ingress] DMARC_ENFORCE = yeszu veröffentlichen, lehnt solche Fälschungen stattdessen beim Ingress ab; für eine SRS-Domain, die eine Subdomain ist (oder jeder andere Name als die bediente Domain selbst), hältaspf=sim DMARC-Eintrag der bedienten Domain den SRS-Umschlag davon ab, sich auszurichten. Die Warnung nennt beides, undpepsi-setup checkmeldet den DMARC-Eintrag der bedienten Domain alsSRS alignment[MISMATCH], bis eines davon umgesetzt ist.- SECRET_FILE / SECRET
(erforderlich, wenn SRS_DOMAIN gesetzt ist) Das Geheimnis für den HMAC, der SRS-Adressen signiert, angegeben als Dateipfad (bevorzugt; speichern Sie es mit Modus 0600) oder inline. Die Schlüssel, die die Weiterleitungs-Rücksendeadressen weitergeleiteter Kopien versiegeln (pepsi-stage-srs(1)), werden unter eigenen Labels daraus abgeleitet. Es muss über die Zeit stabil bleiben, denn ein Tage später zurückgesendeter Bounce muss sich weiterhin verifizieren lassen, und es muss über alle Instanzen hinweg identisch sein. Um es zu ersetzen, verschieben Sie das alte Geheimnis nach PREVIOUS_SECRET_FILE (siehe „Rotating the SRS key“ im Betriebskapitel des Handbuchs).
- PREVIOUS_SECRET_FILE
(path list, optional) One file, or several separated by whitespace, each holding a retired SRS secret. These secrets are verify only: a returning address whose signature matches one of them is accepted, nothing new is signed with them, and
MAX_AGE_DAYSstill bounds every address. A missing or empty file is an error; a file holding the current secret is ignored with a warning. Each file gets the ownership and mode of the current secret’s fragment (pepsi-ingress,0640) frompepsi-setup run, and pepsi-setup(1) warns when one was last changed more thanMAX_AGE_DAYSago: every address that it signed has expired, so it verifies nothing and can be removed.- MAX_AGE_DAYS
(ganzzahlig, optional) Wie viele Tage eine umgeschriebene Adresse für zurückkehrende Bounces gültig bleibt (SRS-Zeitstempel sind taggenau) und wie viele Tage lang pepsi-ingress(1) einen an eine Weiterleitungs-Rücksendeadresse gesendeten Bericht beantwortet. Standardwert 21, was die Wiederholungen eines entfernten Hosts (typischerweise fünf Tage) zusätzlich zum eigenen
MAX_LIFETIMEdieses Hosts abdeckt. Begrenzt auf1..``1021``: Der Tageszähler läuft nach 1024 Tagen über, sodass ein Fenster von dieser Größe oder darüber jeden Zeitstempel verifizieren ließe und den Ablauf gänzlich abschaltete.
Die Signatur in einer umgeschriebenen Adresse ist 8 Base32-Zeichen lang — 40 Bit —, und keine kürzere wird je akzeptiert. Eine gefälschte Signatur würde echten Schaden anrichten: pepsi-ingress(1) behandelt einen verifizierten SRS-Empfänger als Autorisierung, an die dekodierte Adresse weiterzuleiten, auch wenn deren Domain keine ist, die diese Installation bedient, sodass ein gefälschtes Token diesen Host zum offenen Relay und zur Quelle beliebigen Backscatters in seinem Namen macht. Es gibt keine Option, eine schmalere Signatur zu akzeptieren: Sie ließe die Installation nur so stark wie den schmaleren MAC, solange sie gesetzt wäre. Die Obergrenze fehlgeschlagener SRS-Empfänger je Verbindung (pepsi-ingress(1) verwirft eine Verbindung nach dreien mit 421) begrenzt die Online-Suche gesondert; keine der beiden Grenzen ersetzt die andere.
95.2.1.1.9. Der Abschnitt [pepsi-origin]¶
Proof-of-origin keying, shared by both relay stages
(pepsi-stage-relay-to-internet(1) and pepsi-stage-relay-to-smarthost(1), which stamp the Pepsi-Origin header on outbound mail and record its
nonce) and pepsi-stage-anti-spam(1) (which verifies the header on a
returning bounce). The feature is on by default: when no secret is
configured, pepsi-setup(1) generates a random one on first run (provided
[pepsi-ingress] HOSTNAME is set). The secret is not stored inline in
this world-readable file; it is written to a secrets.d/pepsi-origin.secret
fragment beside the configuration (owned by the pepsi dispatcher account,
mode 0640) and pulled into this section with an @inline-secret@
directive. Re-running setup reuses the existing fragment rather than rotating
the key. ENABLED = no disables the feature — outbound mail is unstamped
and every bounce is then unverifiable (routed by the stage’s
BOUNCE_TARGET_STAGE, else forwarded). Removing the section does not: the
next pepsi-setup(1) run would provision a new secret.
- ENABLED
(boolesch, optional) Standardwert
YES.NOschaltet den Herkunftsnachweis für jede Komponente ab, die diesen Abschnitt liest, gleich welches Geheimnis konfiguriert ist, und hält pepsi-setup(1) davon ab, eines zu erzeugen. Ein vorhandenes Geheimnis-Fragment bleibt bestehen, sodass ein Wiedereinschalten mit demselben Schlüssel fortfährt.
Der Header trägt die Version, unser HOSTNAME (die [pepsi-ingress]-Option), das Ursprungs-Absenderkonto, eine 128-Bit-Nonce und einen Zeitstempel sowie einen HMAC-SHA256 über sie alle. Jede gestempelte Nonce wird für zwei Wochen in pepsi.origin_nonce festgehalten; einem Bounce wird nur vertraut, wenn der MAC seines eingebetteten Headers verifiziert und seine Nonce noch verfolgt wird. Siehe pepsi-stage-anti-spam(1).
- SECRET_FILE / SECRET
Das Geheimnis für den HMAC, angegeben als Dateipfad (bevorzugt; speichern Sie es mit Modus 0600) oder inline. Wie das SRS-Geheimnis muss es über die Zeit stabil bleiben, denn ein Tage später zurückgesendeter Bounce muss sich weiterhin verifizieren lassen, und es muss über alle Instanzen hinweg identisch sein. Wenn keines gesetzt ist, richtet pepsi-setup(1) ein zufälliges
SECRETin einemsecrets.d/pepsi-origin.secret-Fragment ein, das per@inline-secret@referenziert wird (siehe oben), und hält es so aus der für alle lesbaren Hauptkonfiguration heraus. Die Funktion erfordert[pepsi-ingress] HOSTNAME(in den MAC eingebunden).
95.2.1.1.10. Der Abschnitt [pepsi-crypto]¶
Verwahrung und Lebenszyklus des Ende-zu-Ende-Schlüsselspeichers — der von pepsi-keys(1) verwalteten Tabellen pepsi.crypto_identity, pepsi.peer_key und pepsi.ca_trust. Wie die CRYPTO_*-Optionen von [pepsi] oben ist dies nur für Administratoren, aber es geht um Speicherung statt um kryptographische Stärke. Lassen Sie den ganzen Abschnitt weg, wenn die Installation keine Ende-zu-Ende-Kryptographie betreibt; sobald er irgendetwas sagt, besteht pepsi-setup(1) auf einem brauchbaren KEY_WRAP_SECRET, denn ein Schlüsselspeicher, der keine Schlüssel speichern kann, ist ein Konfigurationsfehler und keine Wahl.
Privates Schlüsselmaterial wird in der Datenbank gehalten, mit AES-256-GCM unter einem aus KEY_WRAP_SECRET abgeleiteten Schlüsselverschlüsselungsschlüssel (KEK) versiegelt. Die Datenbank allein liefert daher nie einen privaten Schlüssel: Ein Dump, ein Replikat oder ein Sicherungsband erzeugt Chiffrat, und der Schlüssel, der es öffnet, ist ein separates, von Dateirechten bewachtes Artefakt. Die andere Hälfte der Grenze ist eine Datenbankberechtigung — crypto_identity.private_wrapped ist allein der Rolle pepsi-crypto gewährt; siehe pepsi-setup(1).
- KEY_WRAP_SECRET
(Zeichenkette, erforderlich, sobald der Abschnitt existiert) Der Schlüsselverschlüsselungsschlüssel (KEK), der privates Schlüsselmaterial im Ruhezustand verpackt. Halten Sie ihn aus dieser für alle lesbaren Datei heraus: Legen Sie ihn in ein
secrets.d/pepsi-crypto.secret-Fragment und referenzieren Sie ihn mit einer@inline-secret@-Direktive, genau wie die SRS- und Herkunftsnachweis-Geheimnisse behandelt werden. Jedesrunvon pepsi-setup(1) setzt Modus0640auf jenem Fragment erneut durch und übergibt es dempepsi-crypto-Konto. Ein Geheimnis mit weniger als 16 Zeichen wird abgelehnt.Sichern Sie ihn getrennt von der Datenbank. Geht er verloren, ist jeder gespeicherte private Schlüssel weg: Postfächer enthalten Klartext, sodass niemandes Mail unlesbar wird, aber unterwegs befindliches und archiviertes Chiffrat ist verloren, jede veröffentlichte Identität ist ungültig, und die Organisation muss neue Schlüssel ausstellen.
- KEY_WRAP_KEY_ID
(Zeichenkette, optional) Bezeichner des Schlüsselverschlüsselungsschlüssels (KEK), unter dem neues Material verpackt wird. Standardwert
k1. Muss eine nicht leere Folge aus ASCII-Buchstaben, Ziffern und Unterstrichen sein, denn er wird Teil des OptionsnamensKEY_WRAP_SECRET_<ID>, aus dem ein ausgemusterter Schlüssel gelesen wird. Jeder Datensatz hält die ID des Schlüssels fest, der ihn versiegelt hat, sodass eine Rotation Datensatz für Datensatz vorangehen kann statt auf einmal.- KEY_WRAP_SECRET_<ID>
(Zeichenkette, optional) Ein ausgemusterter Schlüsselverschlüsselungsschlüssel (KEK), aufbewahrt, bis jeder darunter verpackte Datensatz rotiert wurde.
<ID>ist die von ihm benanntewrap_key_id, großgeschrieben (alsoKEY_WRAP_SECRET_K0für Schlüsselk0). Zwischen dem Einführen eines neuen Schlüssels und dem Ausführen vonpepsi-keys wrap rotatearbeitet die Installation weiter: Neues Material wird unter dem neuen Schlüssel versiegelt, während sich altes Material weiterhin unter diesem öffnen lässt. Entfernen Sie ihn, sobald die Rotation meldet, dass alles neu verpackt ist.- AUTO_CREATE_IDENTITY
(boolesch, optional) Ob für eine bediente Adresse automatisch eine Identität erzeugt werden darf. Standardwert
YES. pepsi-stage-encrypt(1) handelt danach, und zwar nur für eine Adresse in einer Domain aus[pepsi-ingress] ACCEPTED_DOMAINS, die noch keinecrypto_identity-Zeile irgendeiner Art hat (ein widerrufener Schlüssel oder der eigene registrierte Schlüssel des Benutzers zählt), unterCRYPTO_OPENPGP_ALGORITHM/CRYPTO_SMIME_ALGORITHMundIDENTITY_VALIDITY_DAYS. Wann die Option wirkt, hängt vonENABLE_PEPdieser Stage ab:ENABLE_PEP = yes(der Standardwert): eifrig, bei der ersten lokal eingelieferten Nachricht des Absenders, ob sie Schutz angefordert hat oder nicht. Jeder Absender einer bedienten Domain hat daher am Ende einen eingehüllten privaten Schlüssel auf diesem Server, und der WKD der Installation liefert dessen öffentliche Hälfte aus.ENABLE_PEP = no: bei Bedarf, das erste Mal, wenn ein lokaler Absender ausdrücklich Schutz anfordert (zum Signieren oder nur zum Verschlüsseln), oder bei jeder Nachricht unterSIGN = alwaysdieser Stage; nie bloß deshalb, weil eine Adresse in einem Umschlag auftauchte, sodass ein Benutzer, der die Funktion nie nutzt, nie Schlüsselmaterial hat.
Diese Option ist das Veto des Betreibers über beides: Sie liegt in einem nur für Administratoren zugänglichen Abschnitt, sodass keine adressbezogene
pepsi.settings-Überschreibung die automatische Erzeugung wieder einschalten kann. Ist sie aus, wird jede Identität auf Anforderung erzeugt – mit pepsi-keys(1), der Web-Konsole oder dem E-Mail-Befehlgenerate.Weil der Auslöser auf dem ausgehenden Pfad liegt, bleibt eine Adresse, die nur empfängt, schlüssellos und wird nie veröffentlicht — Außenstehende haben daher nichts, womit sie an sie verschlüsseln könnten. Richten Sie solche Adressen vorab mit
pepsi-keys identity generateein.- IDENTITY_VALIDITY_DAYS
(Zahl, optional) Lebensdauer einer erzeugten Identität, in Tagen. Standardwert
730(zwei Jahre); muss positiv sein. Eine ganzzahlige Anzahl von Tagen statt einerduration, weil der Parser Kalendereinheiten ablehnt (siehe die Warnung am Anfang dieser Seite).pepsi-keys identity generate --daysüberschreibt sie für eine Identität.- ENCRYPTION_ROTATION_DAYS
(Zahl, optional) Das Forward-Secrecy-Profil.
0(der Standardwert) schaltet es ab. Eine positive Zahl von Tagen lässtpepsi-keys identity rotate-due(täglich vonpepsi-keys-rotate.timerausgeführt) jeden Verschlüsselungsschlüssel, den der Server hält (custody = local), ersetzen, sobald er so alt ist, und den alten außer Dienst stellen; der eigene MUA-Schlüssel eines Benutzers wird nie rotiert. Was es kostet: Ein Korrespondent, der den alten Schlüssel zwischengespeichert hat, verschlüsselt an einen außer Dienst gestellten, bis er den neuen abruft (Autocrypt, WKD). Sobald die private Hälfte des außer Dienst gestellten Schlüssels vernichtet ist (unten), lässt sich Mail, die weiterhin an ihn verschlüsselt eintrifft, nicht mehr öffnen, etwa verspätete Mail, Mail aus dem veralteten Cache eines Korrespondenten oder eine aus einem Backup erneut zugestellte Kopie. Siehe das Kapitel des Handbuchs zur Schlüsselverwaltung.- RETIRED_PRIVATE_GRACE_DAYS
(Zahl, optional) Bei gesetztem
ENCRYPTION_ROTATION_DAYS, wie viele Tage ein außer Dienst gestellter (widerrufener oder abgelaufener) servergeführter Entschlüsselungsschlüssel seine private Hälfte behält, bevorpepsi-keys identity rotate-duesie vernichtet. Standardwert30;0vernichtet beim ersten Lauf nach der Außerdienststellung. Ein Schlüssel, an den eine Nachricht in der Warteschlange noch verschlüsselt ist, wird behalten, bis diese Nachricht die Warteschlange verlassen hat. Wird ignoriert, solange die Rotation aus ist.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(Zeichenkette, optional) Welchen Domains und Konten eine Adresse zugerechnet wird, wenn entschieden wird, wem eine Identität gehört, ob nun pepsi-keys(1), der Setup-Applier oder pepsi-stage-encrypt(1) sie erzeugt — dieselben Optionsnamen, Bedeutungen und Standardwerte wie die Optionen der lokalen Zustell-Stages (pepsi-stage-relay-to-maildir(1)).
LOCAL_DOMAINSfällt auf[pepsi-ingress] ACCEPTED_DOMAINSzurück,TARGETSauf denUID_MIN..``UID_MAX``-Bereich aus/etc/login.defsundRECIPIENT_DELIMITERauf+. Eine Adresse, die zu einem lokalen Konto auflöst, bekommt diesen Login bei ihrer Identität festgehalten und darf von diesem Benutzer verwaltet werden; eine, die es nicht tut (eine Rollenadresse, eine gehostete Domain), ist nur für Betreiber.
95.2.1.1.11. Der Abschnitt [pepsi-keydiscovery]¶
Wie Pepsi den öffentlichen Schlüssel oder das Zertifikat eines Korrespondenten findet — die Eingabe für pepsi.peer_key, im Unterschied zu [pepsi-crypto] oben, das die Verwahrung unseres eigenen Schlüsselmaterials betrifft. Gelesen von den pepsi-keydisc(1)-Entdeckungsdiensten, von pepsi-keys(1) (dessen peer refresh --address dieselbe Auffächerung in einem Prozess ausführt) und von jeder Stage, die eine Nachricht an einem Schlüssel parken muss, den sie noch nicht hat.
Der ganze Abschnitt ist optional: ohne ihn läuft die Entdeckung mit der Standard-Quellenmenge.
Die Entdeckung ist asynchron. Eine Stage, die einen Schlüssel braucht, den sie nicht im Cache hat, betreibt keine eigene Netz-E/A: Sie schreibt ihre Arbeit fest, pausiert die Nachricht und reiht eine Anfrage in pepsi.key_request ein, und ein Entdeckungsdienst beantwortet die Anfrage und gibt jede an dieser Adresse geparkte Nachricht frei. Siehe pepsi-keydisc(1) für die Dienstseite und pepsi.state(7) für den keydisc-Schlüssel, den eine geparkte Nachricht trägt.
- SOURCES
(Zeichenkette, optional) Welche Entdeckungsmethoden diese Installation betreibt, als komma- oder leerraumgetrennte Liste aus
dane,wkd-advanced,wkd-direct,ldapundvks(wkdwird fürwkd-advancedangenommen,hkpfürvks; Duplikate werden ignoriert). Standardwertdane wkd-advanced wkd-direct vks.ldapfehlt bewusst, weil es ein Feature zur Übersetzungszeit braucht und bis zur Konfiguration nutzlos ist.Diese Liste ist auch die Menge der Methoden, auf die die Abbruchregel wartet, was zwei Folgen hat. Eine
pepsi-keydisc@<method>-Instanz, deren Methode nicht aufgeführt ist, verweigert den Start; und eine aufgeführte Methode ohne laufende Instanz lässt jede Anfrage das volleTIMEOUTwarten, bevor sie sich erledigt. Halten Sie die Liste und die laufenden Units im Gleichschritt:pepsi.targetstartet genau die vier Standardmethoden, lassen Sie die Option also ungesetzt, sofern Sie nicht auch Instanzen maskieren oder starten.inbound,inbound-signedundgossip(und ihre Aliaseharvested/autocrypt,autocrypt-signed/signedundautocrypt-gossip) werden abgelehnt. Einen Schlüssel aus einer Nachricht zu lernen ist kein Dienst, daher würde nie etwas darauf antworten: Es läuft inline in pepsi-stage-autocrypt-learn(1), aus Material, das ohnehin in der Nachricht steckt. Eine leere Liste wird ebenfalls zurückgewiesen; entfernen Sie die Option, um den Standardwert zu nehmen.- MIN_TRUST
(Zeichenkette, optional) Die Vertrauensuntergrenze — ein Schlüssel aus einer schlechter eingestuften Quelle wird nicht verwendet. Nach seiner Quelle benannt:
manual(auchapioderoperator),dane,wkd-advanced(auchwkd),wkd-direct,ldap,vks(auchhkp),inbound-signed(auchautocrypt-signedodersigned),harvested(auchinboundoderautocrypt) odergossip(auchautocrypt-gossip,any,none). Standardwertany— alles annehmen.Eine weitere Schreibweise,
owner-confirmed(owner_confirmed), benennt eine Sprosse danach, was der Nachweis ist, statt nach der Methode, die ihn erbracht hat: Sie löst sich zuvksauf, der schwächsten Sprosse, bei der jemand, der die Kontrolle über das Postfach oder die Domain nachweisen konnte, den Schlüssel absichtlich veröffentlicht hat. Es gibt sie, damit das Einfügen einer Sprosse zwischenvksundharvesteddiese Linie nicht stillschweigend verschieben kann. Sie ist außerdem der Standardwert von[stage-encrypt] GOSSIP_MIN_TRUST.Die Alternative dazu, an einen Schlüssel mit Vertrauen beim ersten Gebrauch zu verschlüsseln, ist kein besserer Schlüssel, sondern Klartext. Die Untergrenze anzuheben ist die Art, wie eine Installation sagt, dass sie lieber nichts sendet, als an einen unauthentifizierten Schlüssel zu senden. Die Einstufung ist auch beim Standardwert wichtig: Sie entscheidet Konflikte, und sie wird je Schlüssel festgehalten.
any/nonebenennen die unterste Sprosse, welche das gerade auch sei, während jede andere Schreibweise genau einen Rang benennt. Der Unterschied zählt für die drei, die sich ähneln.inbound-signed(Rang 7) ist das, was ein Korrespondent über seine eigene Adresse in einer Nachricht gesagt hat, die die DKIM-Signatur seiner Domain abdeckte;harvested(Rang 8) ist dieselbe Aussage in einer Nachricht, die nichts signiert hat; undgossip(Rang 9) ist die Einführung eines anderen durch einen Korrespondenten (Autocrypt Level 1 §5.3).MIN_TRUST = harvestedist daher die nützliche mittlere Einstellung: Sie behält die opportunistische Verschlüsselung bei, lehnt aber Einführungen durch Dritte ab.inbound-signedbehält sie nur für Korrespondenten, deren Domain ihre Mail signiert. Per Gossip erhaltene und unsignierte Schlüssel werden so oder so gespeichert; die Untergrenze entscheidet nur, ob sie verwendet werden dürfen.Die Untergrenze gilt nicht für eine Adresse, für die diese Installation eine Identität hält. Unser eigener Schlüssel ist kein entdeckter Schlüssel: Er greift der Abfrage vor, sodass kein
peer_key-Datensatz für diese Adresse herangezogen wird, welchen Rang er auch hat, und keine Untergrenze ihn ausschließen kann.own(auchlocal) wird der Vollständigkeit halber als Schreibweise angenommen — jeder Rang hat einen Namen, undstate.cryptostellt diesen dar —, aber als Untergrenze bedeutet es „nur an Adressen verschlüsseln, für die wir unseren eigenen Schlüssel halten“, d. h. kein externer Korrespondent bekommt je Chiffrat. Siehe pepsi-stage-encrypt(1) und pepsi-stage-decrypt(1).- TIMEOUT
(Dauer, optional) Frist der gesamten Anfrage: wie lange eine Anfrage ausstehen darf, bevor sie sich mit dem erledigt, was gefunden wurde. Standardwert
60 s. Verwendet nurh/m/s-Einheiten (siehe die Anmerkung zu Dauern oben).- INBOUND_TIMEOUT
(Dauer, optional) Dieselbe Frist für eine auf dem eingehenden Pfad geparkte Nachricht — die auf den Schlüssel wartet, der eine Signatur prüft —, standardmäßig
TIMEOUT. Sie ist getrennt, damit sie für sich gesenkt werden kann: Eine auf dem eingehenden Pfad geparkte Nachricht ist Mail, auf die jemand wartet, sodass ein Betreiber, der die Verzögerung bemerkt, dies auf Sekunden senken kann, ohne die ausgehende Frist zu verkürzen. pepsi-setup(1) warnt oberhalb von fünf Minuten.- RANK_GRACE
(Dauer, optional) Wägt Tempo gegen Gründlichkeit ab. Wenn eine Abfrage gelingt, wird jeder noch laufenden Methode, die besser rangiert,
RANK_GRACE× (um wie viele Ränge sie besser ist) an zusätzlicher Zeit gewährt; läuft die ab, gewinnt die beste vorliegende Antwort. Standardwert5 s, sodass ein Rang höher 5 s und drei Ränge höher 15 s bekommt.Diese eine Option deckt den ganzen Bereich ab.
0bedeutet, dass die erste brauchbare Antwort rundweg gewinnt. Mit dem Standardwert kann ein langsamer WKD-Server eine Nachricht nicht mehr aufhalten, sobald ein Keyserver bereits geantwortet hat, eine bessere Quelle, die fast ebenso schnell ist, gewinnt aber noch. Ein Wert auf oder überTIMEOUTbedeutet, dass auf jede Methode gewartet wird und die Einstufung vollständig gilt (pepsi-setup(1) merkt diesen Fall an, statt ihn als Fehler zu behandeln — er ist eine legitime Wahl).- METHOD_TIMEOUT
(Dauer, optional) Die eigene Netzfrist einer Methode, die Verbindungsaufbau, Handschlag und jeden Lesevorgang abdeckt. Standardwert
15 s. Sie überTIMEOUTzu setzen macht eine langsame Methode unfähig, innerhalb der Frist der gesamten Anfrage fertig zu werden, wovor pepsi-setup(1) warnt.- CACHE_TTL
(Dauer, optional) Wie lange ein gespeicherter Schlüssel verwendet wird, bevor
pepsi-keys peer refreshihn erneut prüft (er wird zumrefresh_afterdes Datensatzes) — über die Methode, die ihn gefunden hat, und nur, wenn das eine Netzwerkmethode ist, die noch inSOURCESsteht. Standardwert24 h.- NEGATIVE_TTL
(Dauer, optional) Wie lange ein autoritatives „diese Adresse hat keinen Schlüssel“ erinnert wird. Standardwert
24 h. Solange der Eintrag frisch ist, nimmt eine Nachricht für diese Adresse sofort den Pfad ohne Schlüssel und parkt nie: 60 s zu pausieren, um eine bekannte Antwort neu zu lernen, verzögert nur jede Nachricht an diesen Korrespondenten. Die in Kauf genommenen Kosten sind, dass ein vor fünf Minuten veröffentlichter Schlüssel unsichtbar bleibt, bis der Eintrag ausaltert — senken Sie dies, wenn das mehr zählt als die Verzögerung. Dasselbe Intervall taktet die Abfragen, die pepsi-stage-encrypt(1) im Hintergrund für eine Adresse stellt, deren einziger Schlüssel aus ihrer eigenen Mail geerntet oder per Gossip gelernt wurde: höchstens eine Anfrage je Adresse jeNEGATIVE_TTL, sodass ein Schlüssel, den der Inhaber später veröffentlicht, innerhalb dieser Zeit gefunden wird.- ERROR_TTL
(Dauer, optional) Dasselbe, nachdem eine Methode gescheitert ist, statt „hier ist nichts“ zu antworten. Standardwert
1 h: „der Server war unten“ ist es wert, früher erneut versucht zu werden als „es gibt keinen Schlüssel“.- MAX_RESPONSE_BYTES
(Zahl, optional) Obergrenze für den abgeholten Body einer WKD- oder VKS-Antwort, während des Streamens statt danach durchgesetzt, sodass ein 10 MB großer Body die Obergrenze und nicht 10 MB kostet. Standardwert
262144(256 KiB). Muss größer als null sein.- VKS_SERVERS
(Zeichenkette, optional) Abzufragende verifizierende Keyserver, der Reihe nach, als komma- oder leerraumgetrennte Liste. Standardwert
https://keys.openpgp.org. Jeder Eintrag muss einehttps://-URL sein, denn es gibt keinen Grund, einem über einen unauthentifizierten Kanal abgeholten Schlüssel zu glauben; ein abschließender/wird entfernt.- TLS_CA_BUNDLE
(Pfad, optional) Eine PEM-Datei mit CA-Zertifikaten, die den Wurzelspeicher des Systems für die WKD- und VKS-HTTPS-Abrufe ersetzt — die der Entdeckungsdienste, von
pepsi-keys peer refreshundidentity publish --vkssowie von pepsi-stage-vks-confirm(1). Fehlt sie (der Standard), werden die Systemwurzeln verwendet. Ein WKD-Host oder Keyserver, dessen Zertifikat nicht zu einem Zertifikat in der Datei führt, wird abgelehnt, wie jeder nicht vertrauenswürdige. LDAP und DANE sind nicht betroffen, und diehttps://-Abrufe von Sperrlisten (CRL_FETCH) behalten die Systemwurzeln, da eine CRL durch die Signatur ihres Ausstellers authentifiziert wird. Den Speicher einzuengen verkleinert die Menge der Zertifizierungsstellen, die ein Zertifikat für den WKD-Host eines Korrespondenten fälschlich ausstellen könnten. Der Preis dafür: Pepsi findet die WKD-Schlüssel von Korrespondenten nicht mehr, deren WKD-Host eine CA verwendet, die die Datei nicht enthält. Die Datei wird gelesen, wenn ein Abrufer gebaut wird: Eine Datei, die nicht gelesen werden kann oder kein PEM-Zertifikat enthält, lässt pepsi-keydisc(1) den Start verweigern und wird nie stillschweigend durch die Systemwurzeln ersetzt.- ALLOW_DOMAINS, DENY_DOMAINS
(Zeichenkette, optional) Abfragerichtlinie für Empfängerdomains, komma- oder leerraumgetrennt und am Domainteil ohne Beachtung der Groß-/Kleinschreibung abgeglichen. Ein nicht leeres
ALLOW_DOMAINSist ausschließend (nur jene Domains werden je abgefragt);DENY_DOMAINSgewinnt immer darüber. Beide sind standardmäßig leer, sodass jede Domain abgefragt werden darf. Eine Adresse ohne@wird nie abgefragt.Dies ist die Privatsphären-Steuerung auf der Empfängerseite, und sie ist die des Betreibers. Der Schalter je Benutzer unten ist die Absenderseite; die beiden sind nicht austauschbar.
- LDAP_URL, LDAP_BASE, LDAP_FILTER, LDAP_ATTRIBUTE, LDAP_BIND_DN, LDAP_BIND_PASSWORD
(Zeichenkette, optional) Das Verzeichnis, das
pepsi-keydisc@ldapabfragt.LDAP_URLmuss eineldap://- oderldaps://-URL sein und ist, zusammen mitLDAP_BASE, erforderlich, sobaldldapinSOURCESsteht.LDAP_FILTERist standardmäßig(mail={address})und muss den Platzhalter{address}enthalten (die Adresse wird vor dem Einsetzen nach RFC 4515 escaped, sodass ein Local-Part, der*oder(enthält, nicht zu Filtersyntax werden kann);LDAP_ATTRIBUTEist standardmäßiguserCertificate;binary. Ein abwesendesLDAP_BIND_DNbedeutet einen anonymen Bind; ein vorhandenes verlangt eineldaps://-URL, denn ein einfacher Bind sendet das Passwort wörtlich, und die Abfrage wird abgelehnt, statt im Klartext ausgeführt zu werden (dieselbe Regel, die die LMTP- und SMTP-Clients aufAUTHanwenden).Die LDAP-Unterstützung ist ein Compile-Zeit-Cargo-Feature. Auf einem Build ohne es wird
ldapinSOURCESvon pepsi-setup(1) abgelehnt, und diepepsi-keydisc@ldap-Instanz verweigert den Start.- CRL_FETCH
(boolesch, optional) Ob die Entdeckungsdienste die Zertifikatssperrlisten, die zwischengespeicherte S/MIME-Peer-Zertifikate in ihren
cRLDistributionPointsnennen (nurhttp://undhttps://), inpepsi.crl_cacheabrufen, damit pepsi-stage-decrypt(1) Signiererzertifikate dagegen prüfen kann. StandardwertYES. Jeder Verteilungspunkt wird abgerufen, wenn dasnextUpdateseiner Liste erreicht ist, aber mindestens täglich, sodass die CA erfährt, dass dieser Host irgendein von ihr ausgestelltes Zertifikat hält – nie welches, und nie, wann eine Nachricht eintrifft (kein OCSP-Responder wird je abgefragt; was ein TLS-Server heftet, wird nur für diese Sitzung ausgewertet). Eine abgerufene Liste wird nur gespeichert, wenn sie aktuell und nicht älter als die bereits zwischengespeicherte ist. MitNOwird nichts abgerufen, und der S/MIME-Widerruf lautet „nicht geprüft“. Siehe pepsi-keydisc(1).- CRL_MAX_BYTES
(Zahl, optional) Obergrenze für eine abgerufene CRL, beim Streamen durchgesetzt. Standardwert
1048576(1 MiB). Eine größere Liste wird nicht gespeichert, und die Zertifikate, die sie abgedeckt hätte, bleiben „nicht geprüft“. Muss größer als null sein.- CA_ISSUERS_FETCH
(boolesch, optional) Ob die Entdeckungsdienste den
caIssuers-Verweisen (authorityInfoAccess, nurhttp://undhttps://, nie LDAP) der zwischengespeicherten S/MIME-Peer-Zertifikate und der daraus abgerufenen Zertifikate bis zu drei Ebenen tief inpepsi.ca_issuer_cachefolgen. pepsi-stage-decrypt(1) übergibt die gespeicherten CA-Zertifikate dem Verifizierer als Zwischenzertifikate, sodass ein Korrespondent, der sein Zertifikat ohne dessen Zwischenzertifikate sendet, dennoch bis zu einem pepsi-keys(1)-ca-Anker validiert werden kann. Ein abgerufenes Zertifikat ist nie ein Anker und nennt nie einen Signierer. StandardwertNO: Jeder Abruf verrät einer CA, dass dieser Host mit einem ihrer Kunden korrespondiert. Antworten sind auf 64 KiB begrenzt und werden wöchentlich neu abgerufen. Siehe pepsi-keydisc(1).- BADKEYS_URL
(URL, optional) Woher
pepsi-keys blocklist updatedie Liste bekanntermaßen kompromittierter Schlüssel abruft;pepsi-keys-blocklist.timerführt diesen Befehl täglich aus. Standardwerthttps://update.badkeys.info/v0: die badkeys-Sperrliste (https://badkeys.info), die jeden RSA- und EC-Schlüssel enthält, den der Debian-OpenSSL-Fehler (CVE-2008-0166) erzeugen konnte, in RFCs, Testsuiten und Dokumentation veröffentlichte Schlüssel sowie aus Firmware und Softwarepaketen extrahierte Schlüssel.badkeysdata.jsonunterhalb dieser URL nennt die aktuelle Liste, die ebenfalls unterhalb der URL liegen muss; sie wird über verifiziertes TLS abgerufen (mit den Wurzeln vonTLS_CA_BUNDLE, wenn das gesetzt ist), bedingt, sodass eine unveränderte Liste eine kleine Anfrage kostet. Musshttps://sein. Stattdessen kann ein eigener Spiegel genannt werden, und ein Spiegel, der sich nie ändert, hält die Liste fest.Die Liste liegt in der Datenbank (
pepsi.compromised_key, etwa 240 MB für die Liste von 2026 mit drei Millionen Schlüsseln), neben den Moduli, diepepsi-keys peer screenfaktorisiert hat. Sie wächst nur: Ein Update fügt neue Einträge hinzu und entfernt keine. Der Schlüssel eines Korrespondenten auf der Liste wird überall dort abgelehnt, wo ein Schlüssel unter[pepsi] CRYPTO_MIN_RSA_BITSabgelehnt wird (für die Verschlüsselung, für die Signaturverifikation und in einer S/MIME-Kette), und Schlüsselentdeckung, Ernte undpepsi-keys peer importspeichern ihn nie. Bis zum ersten Update gelten nur die eigenen Funde des Screenings. Um die Updates zu stoppen,systemctl mask --now pepsi-keys-blocklist.timer(pepsi.targetstartet einen bloß deaktivierten Timer wieder);pepsi-keys blocklist dismissnimmt falsche Einträge außer Dienst. Siehe pepsi-keys(1).
95.2.1.1.11.1. Der Schalter je Absender: [stage-encrypt] DISCOVERY¶
Eine Stage, die den Schlüsselspeicher verbraucht, liest eine eigene Option, in ihrem [stage-<name>]-Abschnitt, sodass sie über die pepsi.settings-Schicht je Adresse überschrieben werden kann (pepsi-settings(1)):
- DISCOVERY
(boolesch, optional) Ob ein Cache-Fehltreffer eine Netz-Abfrage auslösen darf. Standardwert
YES. MitNOwerden die zwischengespeicherten Schlüssel weiterhin verwendet, aber ein Fehltreffer geht direkt auf den Kein-Schlüssel-Pfad der Stage, statt die Nachricht zu parken, da es nichts gäbe, worauf zu warten wäre.
Wichtig
Was die Überschreibung je Adresse tatsächlich bedeutet. Die Einstellungsschicht löst eine ausgehende Nachricht über ihren Umschlagabsender auf, sodass eine Überschreibung von DISCOVERY für eine Adresse bedeutet: „die Mail dieses Benutzers löst nie eine Abfrage aus“ — nicht „schlage diesen Korrespondenten nie nach“. Die Unterdrückung auf der Empfängerseite ist ALLOW_DOMAINS/DENY_DOMAINS des Betreibers oben; es gibt bewusst keine Empfänger-Sperrliste je Adresse, die eine eigene Spalte und eine zweite Liste bräuchte, um mit dieser konsistent zu bleiben.
DISCOVERY wird von pepsi-stage-encrypt(1) und pepsi-stage-decrypt(1) aus dem effektiven Abschnitt jener Stage gelesen, sodass eine pepsi.settings-Überschreibung greift. Ihre übrigen Optionen sind unter pepsi-stage-encrypt-Optionen und pepsi-stage-decrypt-Optionen dokumentiert.
95.2.1.1.12. Der Abschnitt [pepsi-keys]¶
Das Spiegelbild des Abschnitts oben: wie andere Leute die Schlüssel unserer Benutzer finden. Gelesen von pepsi-keys(1) und von pepsi-stage-vks-confirm(1). Der ganze Abschnitt ist optional, und eine Konfiguration, die ihn weglässt, veröffentlicht nichts bei irgendeinem Keyserver.
Die Web-Key-Directory-Veröffentlichung braucht überhaupt keine Optionen. Sie folgt dem published-Flag jeder Identität (standardmäßig an, mit pepsi-keys identity unpublish gelöscht) und wird von pepsi-httpd(1) von unserer eigenen Domain bedient, sodass sie bei der nächsten Anfrage wirksam wird und durch Löschen des Flags rückgängig gemacht wird. Was dieser Abschnitt konfiguriert, ist der andere Kanal, der sich ganz anders verhält: Ein Keyserver nimmt einen Schlüssel dauerhaft an: Man kann ihm später sagen, dass der Schlüssel widerrufen ist, aber nie, dass er ihn vergessen soll.
- VKS_PUBLISH
(boolesch, optional) Ob eine von Hand erzeugte oder importierte Identität (
pepsi-keys identity generate/import,generateder Web-Konsole oder der API, der E-Mail-Befehlgenerate) mit angefordertem Keyserver-Upload beginnt (crypto_identity.vks_wanted). Standardwert NO.Jede Identität hält fest, ob ihr Upload angefordert wurde, und die Wiederholungsaufgabe (
pepsi-keys identity publish --retry) lädt genau die veröffentlichten, aktiven OpenPGP-Identitäten hoch, bei denenvks_wantedgesetzt ist, und wiederholt es, bis sie verifiziert sind. Sie wird von dieser Option nicht beschränkt. Zwei Folgen:automatisch erzeugte Schlüssel (
[stage-encrypt] ENABLE_PEP) und aus der eigenen Mail eines Benutzers registrierte MUA-Schlüssel werden nie ungefragt hochgeladen, gleich was diese Option sagt – Autocrypt und der eigene WKD der Installation sind der Weg, auf dem sie gefunden werden;die ausdrückliche Upload-Anforderung eines Benutzers (
pepsi-keys identity publish <ID> --vks, Upload to the key server in der Web-Konsole,PATCH /api/v1/identities/{id}mitvks_wantedoder der E-Mail-Befehlpublish) wird befolgt, gleich was diese Option sagt.
„Nicht hochgeladen“ ist daher ein festgehaltener Zustand und kein Fehlen, und
pepsi-keys identity showgibt ihn aus. Ein Hochladen lässt sich nicht zurücknehmen, weshalb der Standardwert für von Hand erzeugte Schlüssel eine Entscheidung des Betreibers bleibt.- VKS_SERVER
(Zeichenkette, optional) Der Keyserver, zu dem Uploads gehen; nur
https://, und eine Klartext-URL wird abgelehnt statt herabgestuft. Standardwert ist der erste[pepsi-keydiscovery] VKS_SERVERS-Eintrag, sodass eine Installation, die bereits einen Keyserver zum Lesen gewählt hat, ihn nicht zweimal benennt.Ein Server, keine Liste: Wer denselben Schlüssel bei mehreren Servern veröffentlicht, wiederholt eine Handlung, die sich nicht rückgängig machen lässt, und jeder einzelne muss dann mit Widerrufen aktuell gehalten werden.
Sein Host ist außerdem der Standard-
VKS_HOSTvon pepsi-stage-vks-confirm(1): der einzige Host, von dem jene Stage eine Verifikationsmail annimmt und zu dem sie einem Link folgt.- VKS_MAX_ATTEMPTS
(ganzzahlig, optional) Wie viele Versuche eine Identität bekommt, bevor
pepsi-keys identity publish --retrysie in Ruhe lässt. Standardwert5. Der Datensatz behält seinen letzten Fehler, sodass eine aufgegebene Identität sagt, warum.- VKS_RETRY_INTERVAL
(Dauer, optional) Mindestabstand zwischen Versuchen für eine Identität. Standardwert
6 h. Kalendereinheiten werden abgelehnt:6 hparst,1 dnicht.- VKS_BATCH
(ganzzahlig, optional) An wie vielen Identitäten ein
--retry-Lauf arbeitet, damit der erste Lauf über eine große Installation nicht einen einzigen enormen Schwall von Anfragen an einen Dritten schickt. Standardwert50.
95.2.1.1.13. Der Abschnitt [pepsi-mpki]¶
Gelesen von pepsi-keys(1) mpki, das S/MIME-Zertifikate für die Benutzer einer Domain bei einer kommerziellen Zertifizierungsstelle bestellt (eine Managed PKI). Der Abschnitt ist optional, und jede Option hat einen Standardwert. Er enthält nur, was der Host braucht, um die CA zu erreichen und seine Hinweise per Mail zu verschicken: Ob eine Domain teilnimmt, mit welchem CA-Konto und nach welchen Regeln, wird je Domain in der Datenbank mit pepsi-keys mpki domain set festgelegt, und der API-Schlüssel des Kontos ist eine eigene Datei.
- CREDENTIAL_DIR
(path, optional) The directory that holds one
mpki-DOMAIN.secretfile per managed domain, with that domain’s CA API key. Default: thesecrets.ddirectory beside the configuration file (/etc/pepsi/secrets.d).pepsi-keys mpki credential setwrites the files, with mode0640and grouppepsi-crypto.- TIMEOUT
(Dauer, optional) Die Frist einer einzelnen Anfrage an die API der CA. Standardwert
60 s. Eine Anfrage, deren Zeit abläuft, ist ein vorübergehender Fehler, den ein späterer Durchlauf wiederholt.- NOTIFY_STAGE
(Zeichenkette, optional) Die Stage, an der die Hinweise eines Durchlaufs als eine Mail je Domain an die Benachrichtigungsadresse der Domain eingespeist werden (
pepsi-keys mpki domain set DOMAIN --notify ADDRESS), mit dem Null-Absender undAuto-Submitted: auto-generated. Nennen Sie eine Stage auf dem Weg, den ausgehende Mail nimmt, zum Beispiel die Stage, die sie per DKIM signiert. Ohne sie wird kein Hinweis per Mail verschickt, undpepsi-keys mpki noticeslistet trotzdem alle auf.- NOTIFY_FROM
(Zeichenkette, optional) Die
From:-Adresse einer Hinweismail. Standardwertpostmaster@DOMAIN, für die Domain, die die Hinweise betreffen.
95.2.1.1.14. Der Abschnitt [pepsi-ingress]¶
Globale Optionen, die die Nachrichtenannahme regeln, von pepsi-ingress(1) gelesen.
- HOSTNAME
(Zeichenkette, erforderlich) Hostname, der in der SMTP-Begrüßung und der
EHLO-Antwort angekündigt wird, z. B.mail.example.org.- ACCEPTED_DOMAINS
(Zeichenkette, erforderlich) Durch Leerraum oder Komma getrennte Liste von Domains, für die Mail angenommen wird. Empfänger in jeder anderen Domain werden als Relaying mit
550 5.7.1abgelehnt, sofern die Sitzung nicht authentifiziert ist (siehe die Listener-Abschnitte). Der Abgleich ist unabhängig von der Groß-/Kleinschreibung und erfolgt in IDNA-Form: Eine internationalisierte Domain kann als ihr U-Label (münchen.example) oder ihr A-Label (xn--mnchen-3ya.example) geschrieben werden, und Mail an jede der beiden Schreibweisen wird angenommen. Mindestens eine Domain muss angegeben werden.- USERNAME_MAP
(Pfad, optional) Datei, die jede SASL-Authentifizierungs-ID auf die E-Mail-Adressen abbildet, die sie als Umschlagabsender und
From:-Identität verwenden darf (RFC 6409 §6/§8.1). Jede nicht leere Zeile, die kein Kommentar ist, lautetusername: addr…— ein#beginnt einen Kommentar, der Schlüssel ist der SASL-Benutzername, und der Wert ist die durch Leerraum/Komma getrennte Liste erlaubter Adressen (die leer sein darf). Ein mit Adressen aufgeführter Benutzername darf genau diese (die erste konkrete ist die kanonische Identität, die für dieSender:-Korrektur verwendet wird); eine Adresse darf ein*-Wildcard wie*@example.orgsein (jede Adresse bei der Domain) oder ein bloßes*(jede Adresse). Einem ohne Adressen aufgeführten Benutzernamen wird jede Adresse verweigert (seinAUTHwird abgelehnt, obwohl die Zugangsdaten gültig sind); ein nicht aufgeführter Benutzername fällt auf den Standardwertusername@HOSTNAMEzurück. Die Datei wird neu gelesen, wann immer ihre Änderungszeit sich ändert (bei jeder Authentifizierung geprüft); eine fehlende/nicht lesbare Datei wird als leer behandelt. Wenn nicht gesetzt, wird jeder authentifizierte Benutzer auf seinen Standardwertusername@HOSTNAMEabgebildet. Siehe pepsi-ingress(1).- SENDER_MAP
(path, optional) File naming the addresses that a
MYNETWORKSnetwork or a TLS client certificate may send as. Each non-blank, non-comment line holds a key followed by at least one address in theUSERNAME_MAPsyntax (exact, a*@example.orgwildcard, or*for any address). The key is a CIDR network or bare address, orcert:followed by the 64-hex-digit SPKI pin of a TLS_AUTH_CLIENT key or of a TLS_AUTH_CLIENT_CA certificate. An address that one key names exactly is claimed: no other key’s wildcard reaches it. AMYNETWORKSsession is bound by the most specific network containing the peer, a certificate session by the key or CA under which it was recognised; a bound session is subject to theMAIL FROM/From:checks of USERNAME_MAP (550 5.7.1), and a CA-issued certificate that names a mailbox is confined to it. A certificate that no key matches authenticates nothing, and aMYNETWORKSentry outside loopback that no single key covers whole is refused: pepsi-ingress does not start and pepsi-setup(1)validatefails, naming the entry, since every host in it could otherwise send as any address and have it signed for every served domain. A bare*binds a network to every address, as an explicit decision; loopback (127.0.0.0/8,::1) needs no binding. pepsi-ingress (at every start) andpepsi-setup validatewarn about aMYNETWORKSentry that is wider than one host and whose most specific key is a bare*: every machine in that network may send signed mail as any address of every served domain, the configuration that the EchoSpoofing campaign abused. Read once at start-up; an error in the file stops pepsi-ingress from starting. See pepsi-ingress(1), Client certificates and Sender bindings for networks and certificates.- POSTMASTER
(string, optional) Routable address to which the reserved
<Postmaster>mailbox without a domain is rewritten. RFC 5321 §4.5.1 requires<Postmaster>(with no domain) to be accepted regardless ofACCEPTED_DOMAINS; on acceptance Pepsi rewrites it to this address so that the normal pipeline (aliases, local delivery, relay) can route it. When unset it is rewritten topostmaster@HOSTNAME— add an alias for that address in apepsi-stage-aliasesALIASESmap to deliver postmaster mail to a real person, or setPOSTMASTERto that person directly. See pepsi-ingress(1).- MAX_MESSAGE_SIZE
(Zahl, optional) Maximal akzeptierte Nachrichtentext-Größe in Bytes — die Größe der
DATA-Nutzlast. Der Wert wird über die ESMTP-SIZE-Erweiterung angekündigt; Nachrichten, die ihn überschreiten, werden mit552abgelehnt. Standardwert ist26214400(25 MiB).- MAX_HEADER_FIELDS
(Zahl, optional) Höchstzahl der Felder, die der Header-Block der obersten Ebene einer Nachricht tragen darf; eine Nachricht mit mehr wird am Ende der Daten mit
552 5.3.4abgelehnt, auf jedem Listener. Standardwert1000(gewöhnliche Mail trägt 20 bis 150);0ist unbegrenzt. Zusammen mit MAX_HEADER_FIELD_SIZE ist dies die Grenze, die die Dovecot-Advisories CVE-2024-23184 und CVE-2024-23185 vom MTA vor dem MDA verlangen. Header-Blöcke angehängter Nachrichten (message/rfc822-Teile) werden nicht gezählt; sie bleiben durch MAX_MESSAGE_SIZE begrenzt.- MAX_HEADER_FIELD_SIZE
(Zahl, optional) Größte Länge eines Header-Feldes in Oktetten, entfaltet: sein Name, Doppelpunkt und Wert mit jeder Fortsetzungszeile, Zeilenumbrüche nicht mitgezählt. Eine Nachricht mit einem größeren Feld wird am Ende der Daten mit
552 5.3.4abgelehnt. Standardwert102400(100 KiB, Postfix‘header_size_limit; einTo:mit tausend Empfängern hat etwa 40 KiB);0ist unbegrenzt.- MAX_CONNECTIONS
(Zahl, optional) Maximale Anzahl gleichzeitig über alle Listener bedienter SMTP-Verbindungen. Die effektive Zulassungsobergrenze ist die kleinere von diesem und
MAX_OPEN_SOCKETS. Standardwert ist1024.- DB_POOL_SIZE
(Zahl, optional) Maximale Anzahl von PostgreSQL-Verbindungen im Ingress-Datenbankpool. Ingress bedient viele SMTP-Sitzungen gleichzeitig, von denen jede kurz
workqueue_addaufruft, sodass es anders als die Einzelverbindungs-Stage-Worker mehr als eine verwenden kann. Standardwert ist1; erhöhen Sie es nur, wenn die einzelne Verbindung bremst, wie schnell Ingress Mail annimmt, und halten Sie die Summe der Pools jeder Komponente unter demmax_connectionsvon PostgreSQL.- MAX_OPEN_SOCKETS
(Zahl, optional) Harte Obergrenze gleichzeitig offener Client-Verbindungen, die vor Dateideskriptor-Erschöpfung schützt. Wenn nicht gesetzt, wird sie aus dem weichen
RLIMIT_NOFILEdes Prozesses minusRESERVED_SOCKETSabgeleitet. Wenn die Obergrenze erreicht ist und eine neue Verbindung eintrifft, schafft der Server Platz, indem er die am längsten untätige Verbindung im Quellbereich (einer IPv4-Adresse oder einem IPv6-/32) schließt, deren gesamte Leerlaufzeit am größten ist (ein421, dann schließen).- RESERVED_SOCKETS
(Zahl, optional) Dateideskriptoren, die vom aus
RLIMIT_NOFILEabgeleiteten Budget zurückgehalten werden (für den Datenbankpool, Listener, stdio und DNS-Sockets). Standardwert ist64. Wird ignoriert, wennMAX_OPEN_SOCKETSgesetzt ist.- CONN_RATE_PER_SECOND
(Zahl, optional) Token-Bucket-Nachfüllrate, die akzeptierte neue Verbindungen pro Quellbereich begrenzt, in Verbindungen pro Sekunde. Eine Verbindung über der Rate wird nach bestem Bemühen mit
421beantwortet und geschlossen; die Verbindung belegt einen Slot nur, solange diese Antwort geschrieben wird, und gar keinen (und erhält keine Antwort), wenn die Deskriptor-Obergrenze bereits erreicht ist. Standardwert ist1. Ein gebrochener Wert wird angenommen (0.2ist eine Verbindung alle fünf Sekunden). Lokale (UNIX-Socket-)Verbindungen werden nie ratenbegrenzt.- CONN_RATE_BURST
(Zahl, optional) Token-Bucket-Burst-Zugeständnis pro Quellbereich, ebenfalls gebrochen. Standardwert ist
1.- MAX_CONNECTIONS_PER_IP
(Zahl, optional) Wie viele gleichzeitige Verbindungen ein Quellbereich (eine IPv4-Adresse oder ein IPv6-
/32) halten darf. Eine Verbindung darüber hinaus wird wie eine ratenbegrenzte abgelehnt. Standardwert16;0schaltet die Obergrenze ab.- MAX_LOCAL_CONNECTIONS
(Zahl, optional) Wie viele gleichzeitige Verbindungen alle UNIX-Socket-Peers zusammen halten dürfen. Lokale Verbindungen sind von der Ratenbegrenzung und der serverweiten Verdrängung ausgenommen; diese Grenze hält also lokale Einlieferer davon ab, jeden Slot zu belegen. Eine Peer-uid darf höchstens die Hälfte davon halten (mindestens eine), sodass ein einzelnes lokales Konto die anderen nicht aussperren kann;
rootund die Dienstkonten sind nicht ausgenommen. Wenn lokale Verbindungen sie füllen, verdrängt eine neue Verbindung von einer uid, die weniger davon hält als die schwerste uid, die am längsten untätige Verbindung der schwersten uid, sofern diese Verbindung 5 Sekunden lang keine vollständige Befehlszeile gesendet hat; die verdrängte Sitzung wird mit421 4.3.2beantwortet. So können auch zusammenwirkende Konten sie nicht füllen;pepsi-sendmailschreibt seine ganze Nachricht ohne Pause und wird nie verdrängt. Standardwert32;0begrenzt sie nur durchMAX_CONNECTIONS, ohne Anteil pro uid.- MAX_MESSAGES_PER_SESSION
(Zahl, optional) Wie viele Mail-Transaktionen eine Sitzung beginnen darf; das nächste
MAILwird mit421beantwortet und die Sitzung geschlossen. Standardwert100;0ist unbegrenzt.- VERIFY_RECIPIENTS
(``auto`` oder ``off``, optional) Ob eine Adresse an einer bedienten Domain, die nichts auf diesem Host annehmen würde, zum
RCPT-Zeitpunkt mit550 5.1.1abgelehnt wird. Standardwertauto. Der sendende MTA benachrichtigt dann sofort seinen eigenen Benutzer. Würde die Nachricht angenommen, ginge sie später als Bounce an ihren Umschlagabsender. Spam fälscht diesen Absender, sodass der Bounce einen unbeteiligten Dritten erreicht (Backscatter) und diesen Host auf Blocklisten bringt.Nichts muss von Hand aufgeführt werden. Für jede bediente Domain werden die Quellen, die für eine Adresse bürgen können, aus den
[stage-*]-Abschnitten abgeleitet:die lokalen Konten, die eine pepsi-stage-relay-to-maildir(1) oder pepsi-stage-dot-forward(1) für ihre
LOCAL_DOMAINSauflöst,TARGETSundRECIPIENT_DELIMITEReingeschlossen;der MDA hinter einer pepsi-stage-relay-to-lmtp(1), für deren
LOCAL_DOMAINSmitRCPT TOund ohne Nachricht gefragt;das Backend hinter einer pepsi-stage-route(1), wie deren RECIPIENT_CHECK es vorgibt;
jede Map einer pepsi-stage-aliases(1), mit dem eigenen Abgleich der Stage;
die Mailinglisten, wenn ein pepsi-stage-list(1)-Router konfiguriert ist;
postmaster@undabuse@sowie die Steueradressen der Stages, die eine beantworten (pepsi@,pepsi-keys@,pepsi-wallet@,secretary@,dmarc-reports@).
Eine Adresse, für die irgendeine davon bürgt, wird angenommen. Ebenso jede Adresse an einer Domain, die sich nicht prüfen lässt:
ein Alias-Catch-All deckt die Domain ab;
eine Stage führt ein Programm aus, das Pepsi nicht kennt;
die Domain wird an ein Backend mit
RECIPIENT_CHECK = nonegeroutet;die Domain wird von einer Smarthost-Stage weitergeleitet, ohne dass hier etwas ihre Postfächer hält.
Auch jede Unsicherheit nimmt an: eine unlesbare Datei, ein Datenbankfehler, eine Probe, die fehlschlägt oder in ein Timeout läuft. pepsi-setup run gibt das Ergebnis für jede Domain aus.
offnimmt jede Adresse an einer bedienten Domain an. Beim Start gelesen: Ein geänderter Stage-Graph braucht einen Neustart des Ingress, während Änderungen an einer Alias-Map, einer Empfängerliste oder den Mailinglisten sofort gelten.Gleich was diese Option sagt, wird ein Local-Part mit
%(der Prozent-Hack) oder!(ein Bang-Pfad) bei einer bedienten Domain mit550 5.1.3abgelehnt, sofern keine der obigen Quellen für die Adresse bürgt, sodass einem Backend, das diese Formen noch beachtet, nie ein Weg zu einem Dritten übergeben wird.- MAX_INVALID_RECIPIENTS
(Zahl, optional) Wie viele unbekannte Empfänger eine Sitzung nennen darf. Beim Erreichen des Limits wird die Sitzung mit
421geschlossen, was einen Wörterbuchangriff (das Einsammeln gültiger Adressen oder das Bringen des MDA dazu, Rateversuch um Rateversuch zu beantworten) in einen Strom von Verbindungen verwandelt, den die Verbindungslimits bemessen. Standardwert10;0ist unbegrenzt.- MAX_SELF_HOPS
(Zahl, optional) Wie oft eine Nachricht den Ingress dieses Hosts bereits durchlaufen haben darf, bevor sie als Routing-Schleife mit
554 5.4.6abgelehnt wird. Gezählt aus denReceived:-Feldern, die der Ingress selbst schreibt (byHOSTNAME(pepsi-ingress)). Legitime Mail tritt höchstens ein paar Mal erneut ein: Ein Alias auf eine andere bediente Domain, eine~/.forwardoder ein Bericht an einen unserer eigenen Benutzer verlassen jeweils den Host über SMTP und kommen wieder herein. Eine Schleife dagegen liefe sonst bis zum allgemeinen Hop-Limit der Relay-Stages, Dutzende Durchläufe. Standardwert5;0schaltet die Prüfung ab.- AUTH_FAILURES_PER_HOUR
(Zahl, optional) Wie viele fehlgeschlagene
AUTH-Versuche ein Quellbereich pro Stunde über alle seine Sitzungen hinweg machen darf (ein Token-Bucket). Ist er aufgebraucht, wirdAUTHaus dem Bereich mit421abgelehnt, ohne das SASL-Backend zu befragen, bis sich der Bucket wieder füllt. Standardwert20;0ist unbegrenzt.- ACCOUNT_AUTH_FAILURES_PER_HOUR
(Zahl, optional) Wie viele fehlgeschlagene
AUTH-Versuche ein Konto (seine Authentifizierungs-ID, ohne Beachtung der Groß-/Kleinschreibung verglichen) pro Stunde aus allen Quellen zusammen sammeln darf (ein Token-Bucket). Ist das Budget aufgebraucht, wartet einAUTHfür das Konto aus einem Quellbereich, aus dem es sich in den letzten 30 Tagen nicht authentifiziert hat,ACCOUNT_AUTH_DELAY, bevor das SASL-Backend gefragt wird, und solche Versuche werden einzeln nacheinander geprüft, sodass ein über viele Adressen verteilter Rater einen Versuch je Verzögerung erhält. Das Konto wird nie gesperrt: Sein Inhaber meldet sich mit dem richtigen Passwort weiterhin an, nach der Verzögerung. Ein Versuch, der länger als drei Verzögerungen warten müsste, wird ohne Prüfung mit454 4.7.0beantwortet. Standardwert10;0schaltet die Verzögerung ab.- ACCOUNT_AUTH_DELAY
(Dauer, optional) Die unter
ACCOUNT_AUTH_FAILURES_PER_HOURbeschriebene Wartezeit und damit die kürzeste Zeit zwischen zwei geprüften Rateversuchen an einem Konto jenseits seines Budgets. Standardwert20 s;0 sschaltet die Verzögerung ab.- LOCAL_MESSAGES_PER_MINUTE
(Zahl, optional) Wie viele Nachrichten eine lokale UID pro Minute über ihre Sitzungen hinweg einliefern darf; die UID wird über
SO_PEERCREDin einer UNIX-Socket-Sitzung erkannt. EinMAILüber der Rate erhält451 4.7.1. Standardwert60;0ist unbegrenzt.- LOCAL_MESSAGE_BURST
(Zahl, optional) Der zusätzlich zu
LOCAL_MESSAGES_PER_MINUTEerlaubte Burst. Standardwert120.- USER_RECIPIENTS_PER_HOUR
(Zahl, optional) An wie viele Empfänger ein SASL-Konto (seine Authentifizierungs-ID, ohne Beachtung der Groß-/Kleinschreibung verglichen) pro Stunde über alle seine Sitzungen hinweg einliefern darf; ein
RCPTüber der Rate erhält450 4.7.1. Nur angenommene Empfänger zählen. Das begrenzt, wie viel Mail ein gestohlenes Passwort senden kann. Standardwert500;0ist unbegrenzt.- USER_RECIPIENT_BURST
(Zahl, optional) Der zusätzlich zu
USER_RECIPIENTS_PER_HOURerlaubte Burst. Standardwert500.- COMMAND_TIMEOUT
(Dauer, optional) Längste Zeit, die eine Sitzung auf den nächsten Befehl (oder eine
AUTH-Fortsetzung oder den Beginn einesDATA/BDAT-Nachrichtentexts) wartet, bevor die Verbindung mit421geschlossen wird (RFC 5321 §4.5.3.2). Standardwert ist300 s.- TLS_HANDSHAKE_TIMEOUT
(Dauer, optional) Längste Dauer eines TLS-Handshakes, auf einem Implicit-TLS-Listener und nach
STARTTLS, bevor die Verbindung geschlossen wird (ohne Antwort). Getrennt vonCOMMAND_TIMEOUT: Ein Handshake kostet einen funktionierenden Client wenige Round Trips, und jeder kostet den Server eine Private-Key-Operation, daher sollte ein Peer, der stockt oder ein ClientHello in kleinen Häppchen sendet, eine Verbindung nicht für die Dauer eines ganzen Befehls-Timeouts halten. Standardwert30 s; muss größer als null sein.- DATA_TIMEOUT
(Dauer, optional) Längste Zeit, die eine Sitzung beim Empfangen eines
DATA/BDAT-Nachrichtentexts auf den nächsten Block von Nutzlast-Oktetten wartet, bevor sie mit421schließt. Standardwert ist180 s.- SESSION_TIMEOUT
(Dauer, optional) Die längste Dauer einer Sitzung ab dem Moment der Verbindung; danach wird der nächste Lesevorgang — ein Befehl, eine
AUTH-Fortsetzung, ein Block eines Inhalts — mit421 4.4.2 Session time limit exceededbeantwortet und die Verbindung geschlossen, gleich was die Timeouts pro Lesevorgang sagen. Jedes Byte, das der Client sendet, setzt diese Timeouts zurück; ohne diese Grenze könnte ein Client daher eine Transaktion an einem Punkt seiner Wahl unbegrenzt offen halten: etwa kurz vor dem Ende vonDATA, bei Tausenden von Hosts zugleich, um sie alle im selben Augenblick abzuschließen. Standardwert30 m, weit über dem, was eine Sitzung braucht (ein Inhalt vonMAX_MESSAGE_SIZEpasst noch bei 15 KB/s); ein Massenversender, dessen Sitzung abgeschnitten wird, verbindet sich einfach neu.0 sschaltet die Frist ab.- DMARC_ENFORCE
(boolesch, optional) Bei
YESwird eine Nachricht aus einer nicht authentifizierten Sitzung, deren DMARC-Auswertung fehlschlägt und deren veröffentlichte Richtliniequarantineoderrejectist, zur SMTP-Zeit (550) abgelehnt; eingereichte Mail wird nie wegen DMARC abgelehnt. Der einkompilierte Standardwert istNO, sodass eine Konfiguration, die die Option nicht erwähnt, solche Mail mit festgehaltenem Fehlschlag weiterhin annimmt (und pepsi-stage-arc(1) sie versiegelt), damit ein nachgelagerter Empfänger entscheidet; pepsi-setup(1)--wizardschreibtYESfür eine neue Installation, und eine bestehendepepsi.confbehält, was sie sagt. pepsi-setup(1) warnt vor einer Konfiguration mit angenommenen Domains, die die Option nicht setzt, und vor einer mit abgeschalteter Option, während der DMARC-Eintrag einer bedienten Domain Empfänger bittet,quarantineoderrejectanzuwenden. Andere Authentifizierungsfehler lehnen eine Nachricht nie ab. EinFrom:, das mehrere Domains nennt, wird für jede von ihnen ausgewertet (bis zu 10) und kann für jede abgelehnt werden. MitYESwird auch eine Nachricht aus einer nicht authentifizierten Sitzung abgelehnt, auf die DMARC nicht anwendbar ist: eine ohneFrom:-Adresse (550 5.6.0) und eine, derenFrom:mehr als 10 Domains nennt (550 5.7.1). Eine fehlschlagende Nachricht wird stattdessen angenommen, wenn ein in ARC_TRUSTED_SEALERS aufgeführter Versiegler für ihre ARC-Kette bürgt.- EXTERNAL_SUBJECT_TAG
(boolesch, optional, Standardwert ``YES``) TAG_EXTERNAL an den Anfang des
Subjecteiner Nachricht aus einer nicht authentifizierten Sitzung setzen, wenn ihrFrom:eine bediente Domain ohne DMARC-, ausgerichteten DKIM- oder ausgerichteten SPF-Pass beansprucht, wenn ihrSender:eine ohne ausgerichteten DKIM- oder SPF-Pass beansprucht, wenn sich ihrFrom:nicht nur auf eine Weise lesen lässt oder mehrere Domains nennt oder wenn auf ihr DMARC-failnicht reagiert wurde. Zuvor Kopien der Markierung vom Anfang jedes eingehenden Betreffs entfernen, beurteilt so, wie ein Mail-Client ihn darstellt, damit ein Absender die Markierung nicht selbst schreiben kann. Eine Nachricht ohneSubjecterhält eines. DieX-Pepsi-Warning-Felder (from-ambiguous,served-domain-not-authenticated,served-sender-not-authenticated,dmarc-fail-not-enforced) undstate.auth.warningswerden in jedem Fall geschrieben. Siehe pepsi-ingress(1), Kennzeichnung von Mail von außen.- TAG_EXTERNAL
(Zeichenkette, optional, Standardwert ``[external]``) Die Markierung, die EXTERNAL_SUBJECT_TAG schreibt, ohne umgebenden Leerraum. Das dokumentierte
[external]wird aus eingehenden Betreffs auch dann entfernt, wenn dies etwas anderes ist, da ein Absender, der die dokumentierte Markierung fälscht, einen Indikator fälscht, den ein Leser anderswo gesehen haben kann. Ein leerer Wert schaltet die Markierung ab.- ARC_TRUSTED_SEALERS
(Zeichenkette, optional) Durch Leerraum oder Komma getrennte Domains, deren ARC-Kette (RFC 8617) einen DMARC-Fehlschlag unter DMARC_ENFORCE übersteuert. Tragen Sie die Mailinglisten-Hosts und Weiterleiter ein, von denen Sie wissen, dass sie DMARC für die Mail brechen, die sie weitergeben, und denen Sie zutrauen, diese Mail bei der Annahme authentifiziert zu haben. Eine Nachricht, die an DMARC scheitert, wird angenommen, wenn ihre ARC-Kette validiert (
cv=pass, aus den Signaturen neu berechnet, nie aus dem eigenencv=-Tag der Kette gelesen) und dasd=desARC-Sealmit der höchsten Instanz hier aufgeführt ist (in Kleinbuchstaben verglichen, ohne abschließenden Punkt). Dieses Siegel stammt von der ADMD, die zuletzt versiegelt hat, der einzigen, deren Signatur die Nachricht so abdeckt, wie sie empfangen wurde. Der Versiegler wird alsstate.auth.arc_overridefestgehalten;state.auth.dmarclautet weiterhinfail. Eine Kette, die zuletzt von jemand anderem versiegelt wurde, eine, die nicht validiert, oder gar keine lässt die Ablehnung bestehen. Standardwert leer: Ein unbekannter Versiegler beweist nichts. Die Kette jeder unter DMARC_ENFORCE abgelehnten Nachricht wird geprüft, gleich was die Liste enthält, und die Ablehnung wird mit ihrem letzten Versiegler protokolliert —arc-sealer=<domain>für eine Kette, die validiert, ein behaupteter Versiegler für eine, die es nicht tut —, sodass das Log die Weiterleiter und Listen nennt, die für diese Option in Frage kommen. Hat ohne DMARC_ENFORCE keine Wirkung, wovor pepsi-ingress(1) beim Start warnt.- MIME_ANOMALIES
(Zeichenkette, optional) Was mit einer Nachricht geschehen soll, deren MIME-Struktur mehrdeutig ist oder deren Nachrichten-Header abweichende Kopien eines Feldes trägt, das RFC 5322 nur einmal erlaubt. Eine Struktur ist mehrdeutig, wenn RFC 2045/2046 ihre Lesart dem Parser überlassen, sodass ein Filter etwas anderes prüft, als der Client zeigt.
enforce(der Standardwert) lehnt die harten Klassen mit554 5.6.0ab: ein leeresboundary=, ein NUL in einem MIME-Header, widersprüchliche doppelteContent-Type- oderContent-Transfer-Encoding-Felder, ein RFC-2047-Encoded-Word als Boundary und abweichendeDate-,Subject-,To-,Reply-To- oderSender-Felder. AbweichendeCc-Felder markiert es mitX-Pepsi-Warning: duplicate-header-cc. Die weichen Klassen schreibt es auf die eine Lesart um, die die Standards vorschreiben: eine unbekannte Transferkodierung, Leerraum nach einem weichen Quoted-Printable-Umbruch, Base64-Zeichen außerhalb des Alphabets, eine fehlende schließende Trennzeile, eine Trennzeile der Boundary des Multiparts nach seiner schließenden Trennzeile (der Epilog, den RFC 2046 zu ignorieren sagt, wird verworfen) und identische doppelte Felder. Das Umschreiben geschieht, bevor die Nachricht gespeichert wird, nie innerhalb eines signierten oder verschlüsselten Teils, nach SPF/DKIM/DMARC und vor dem ARC-Siegel (eine Nachricht mit ARC-Kette wird stattdessen von pepsi-stage-arc(1) umgeschrieben, sobald es die Kette verifiziert hat).logzählt und protokolliert die Klassen und speichert die Nachricht so, wie sie empfangen wurde, wobei jedes abweichende Header-Feld mitX-Pepsi-Warning: duplicate-header-<field>markiert wird. Beide halten die Klassen alsstate.mime_anomaliesfest. Siehe pepsi-ingress(1), „Mehrdeutige MIME-Struktur“, für die Klassen und die gemessene Basisrate.- IPREV_ACTION
(``none`` oder ``reject``, optional) Wie Ingress einen Client behandelt, dessen Reverse DNS eindeutig nicht validiert (RFC 8601
iprev=fail: Seine Adresse hat einen PTR-Namen, der nicht auf sie zurück auflöst, oder gar keinen).none(der Standardwert) hält das Urteil nur instate.origin.iprevund imReceived:-Header fest: Fehlerhaftes Reverse DNS ist ein Indiz über das DNS des Absenders, nicht über seine Nachricht, und kleine Sites haben es.rejectlehnt jeden Empfänger außerpostmastermit550 5.7.25(RFC 7372) ab, bei einer nicht authentifizierten Sitzung auf einem Listener, der kein Submission-Listener ist; eintemperroroderpermerrorlehnt nie ab.- DNS_SERVERS
(Zeichenkette, optional) Die Resolver für die SPF/DKIM/DMARC-Abfragen, in der Syntax von
[pepsi] DNS_SERVERS(schlichte Adressen odertls://- /https://-Einträge). Wenn nicht gesetzt, gilt[pepsi] DNS_SERVERS, und ohne dieses die Resolver-Konfiguration des Systems (/etc/resolv.conf).- DNS_TIMEOUT
(Dauer, optional) Timeout je Einzelabfrage für diese Abfragen. Standardwert ist
[pepsi] DNS_TIMEOUT, sonst5 s. Weil die Verifikation synchron beim Empfang vonDATAläuft, verzögert ein langsamer Resolver die250-Annahme.Sie gilt nur, wenn eine DNS_SERVERS-Liste die Resolver nennt (die dieses Abschnitts oder die von
[pepsi]). Ohne eine wird die Resolver-Konfiguration des Systems vollständig verwendet, Timeout eingeschlossen, daher hat diese Option keine Wirkung, und die Zeilenoptions timeout:/attempts:von/etc/resolv.confbegrenzen eine Abfrage.- MAX_DKIM_SIGNATURES
(Zahl, optional) Wie viele
DKIM-Signature-Felder einer eingehenden Nachricht verifiziert werden; diejenigen, derend=dieFrom:-Domain oder eine Eltern- oder Kind-Domain davon ist, kommen zuerst an die Reihe. Standardwert10.- VERIFY_TIMEOUT
(Dauer, optional) Frist für die eingehende Verifizierung: SPF und die ausgewählten DKIM-Signaturen werden darunter gleichzeitig geprüft, danach DMARC unter einer zweiten. Eine Prüfung, die sie verpasst, wird nur für diese Prüfung als
temperrorfestgehalten. Standardwert20 s.- DISPATCH_WAKE_INTERVAL
(Dauer, optional) Mindestabstand zwischen zwei
NOTIFYs, die pepsi-dispatch(1) mitteilen, dass neue Mail eingetroffen ist. Standardwert ist5 ms;0schaltet das Zusammenfassen ab und benachrichtigt einmal je angenommener Nachricht.Ingress benachrichtigt nicht aus der Transaktion heraus, die die Nachricht speichert. PostgreSQL hält von dem Moment an, in dem eine Transaktion eine Benachrichtigung einreiht, bis sie committet, eine datenbankweite Sperre, sodass benachrichtigende Transaktionen nicht gruppiert committen können — unter nebenläufiger Last serialisieren sie sich, und jede bezahlt ihr eigenes Platten-Flush. Zulassungen werden daher außerhalb des Bandes benachrichtigt, einmal je Intervall, nachdem die Datensätze committet sind; weil der Dispatcher jedes Aufwecken mit einem vollständigen Durchsuchen der Warteschlange beantwortet, bedient eine Benachrichtigung beliebig viele neu angenommene Nachrichten.
Die Begrenzung ist nachlaufend: Das erste Aufwecken nach einer Ruhephase wird sofort gesendet, sodass eine einzelne Nachricht überhaupt nicht verzögert wird, und nur Benachrichtigungen dahinter werden zusammengefasst. Ein höherer Wert bedeutet weniger Benachrichtigungen unter anhaltender Last, auf Kosten von etwas mehr Warteschlangenlatenz im schlechtesten Fall; es gibt selten einen Grund dazu.
- MILTERS
(optional) Die Milter, die während der SMTP-Sitzung befragt werden, mit den Namen ihrer
[pepsi-ingress-milter-*]-Abschnitte, getrennt durch Leerzeichen oder Kommas, in der Reihenfolge, in der sie befragt werden. Gilt für jeden Listener, der kein Submission-Listener ist; das eigene MILTERS eines Listener-Abschnitts ersetzt es für diesen Listener.none(der Standardwert) befragt keinen. Siehe Die Abschnitte [pepsi-ingress-milter-*] unten und pepsi-ingress(1), Milter.
Die ARC-Versiegelungsidentität und der -Algorithmus werden im gemeinsamen [pepsi]-Abschnitt (ARC_DOMAIN und ARC_ALGORITHM) oben konfiguriert und von pepsi-stage-arc(1) verwendet, nicht von Ingress.
95.2.1.1.15. Die Abschnitte [pepsi-ingress-listener-*]¶
Jeder Abschnitt, dessen Name mit pepsi-ingress-listener- beginnt, definiert einen Lausch-Socket. Das Suffix ist ein frei gewählter Name, der in Log-Meldungen verwendet wird, z. B. [pepsi-ingress-listener-mx]. Deklarieren Sie so viele Listener wie nötig.
- SERVE
(erforderlich) Die Art des zu bindenden Sockets. Eines von:
tcpBindet einen TCP-Socket. Erfordert BIND_TO und PORT.
unixBindet einen UNIX-Domain-Socket. Erfordert UNIXPATH; beachtet UNIXPATH_MODE und UNIXPATH_GROUP.
systemdÜbernimmt einen von einem systemd-Elternprozess über Socket-Aktivierung übergebenen Socket; siehe FD_INDEX.
- BIND_TO
(Zeichenkette) IP-Adresse, auf der bei
SERVE = tcpgelauscht wird, z. B.0.0.0.0oder::. Erforderlich fürtcp.- PORT
(Zahl) TCP-Port, auf dem bei
SERVE = tcpgelauscht wird. Erforderlich fürtcp.- UNIXPATH
(Pfad) Dateisystempfad des Sockets bei
SERVE = unix. Erforderlich fürunix.- UNIXPATH_MODE
(Unix-Modus, optional) Rechtebits des UNIX-Domain-Sockets, in Oktal. Standardwert ist
660.- UNIXPATH_GROUP
(Zeichenkette, optional) Gruppe, auf die der UNIX-Domain-Socket nach dem Binden
chgrpt wird (der Eigentümer bleibt unverändert). Kombiniert mit dem Standardmodus0660lässt dies einen bestimmten Peer den Socket erreichen, während er nicht für alle zugänglich bleibt — verwendet, wenn pepsi-httpd hinter einem Front-Webserver (z. B.www-data) läuft, der per Reverse-Proxy zu ihm weiterleitet. Die Gruppe muss existieren; eine unbekannte Gruppe ist ein Startfehler.- FD_INDEX
(Zahl, optional) Nullbasierter Index des von systemd übergebenen Dateideskriptors, der bei
SERVE = systemdübernommen wird. Index0ist der erste Deskriptor (SD_LISTEN_FDS_START). Standardwert ist0.Es ist eine Position, kein Name: Es zählt
ListenStream=-Einträge in der besitzenden.socket-Unit, sodass das Einfügen eines Eintrags jeden Listener danach umnummeriert, während das Anhängen eines nichts umnummeriert. Die Unit und diese Abschnitte sind zwei Hälften einer Aussage, und nichts prüft zur Konfigurationszeit, dass sie übereinstimmen, sodass eine Abweichung dort gemeldet wird, wo die Deskriptoren tatsächlich sind: Der Server protokolliert beim Start eine Warnung, die jeden Index benennt, den kein Listener beansprucht hat. Nehmen Sie die Warnung ernst: Ein Socket, auf dem der Server nie annimmt, ist schlimmer als ein fehlender, denn systemd reiht die Verbindung dennoch ein, und der Client blockiert bis zum Ablauf seines eigenen Lese-Timeouts, statt sofort abgewiesen zu werden.Ein Deskriptor kann ebenso gut ein UNIX-Domain-Socket wie ein TCP-Socket sein; welches von beidem, entscheidet die Unit, nicht diese Datei. Optionen, die von der Familie des Sockets abhängen, werden daher aufgelöst, sobald der Deskriptor vorliegt, statt beim Parsen: AUTH_PEERCRED muss ausdrücklich angegeben werden (es kann nicht wie bei
SERVE = unixerschlossen werden), und ein Klartext-SUBMISSION-Listener, der sich als Erbe eines Netzwerk-Sockets erweist, lässt pepsi-ingress(1) den Start verweigern, statt Zugangsdaten im Klartext zu tragen.- MODE
(optional) Transportsicherheit des Listeners. Eines von:
plainNur Klartext;
STARTTLSwird nicht angeboten. Dies ist der Standardwert.tlsImplizites TLS: Die Verbindung wird ab dem ersten Byte in TLS eingehüllt (z. B. der
submissions-Port 465). Erfordert TLS_CERT und TLS_KEY.starttlsKlartext, der mit dem
STARTTLS-Befehl aufgewertet werden kann. Erfordert TLS_CERT und TLS_KEY.
- TLS_CERT
(Pfad) PEM-Datei, die die Server-Zertifikatskette enthält. Erforderlich, wenn MODE
tlsoderstarttlsist — kann aber weggelassen werden, in welchem Fall pepsi-setup(1) den certbot-Pfad/etc/letsencrypt/live/<HOSTNAME>/fullchain.pemautomatisch ausfüllt und das Zertifikat beziehen kann (siehe pepsi-setup(1) und seine –no-certbot-Option).- TLS_KEY
(Pfad) PEM-Datei, die den privaten Schlüssel für TLS_CERT enthält. Erforderlich, wenn MODE
tlsoderstarttlsist; wie TLS_CERT kann sie weggelassen werden, damit pepsi-setup(1) sie automatisch ausfüllt (…/privkey.pem).- MYNETWORKS
(optional) Durch Leerraum/Komma getrennte Liste vertrauenswürdiger IPv4/IPv6-CIDR-Netze (eine bloße Adresse ist ein
/32- oder/128-Host). Eine Verbindung von einem dieser Netze wird ohne weiteren Nachweis authentifiziert und darf weiterleiten und als die Adressen senden, an die[pepsi-ingress]SENDER_MAP das Netz bindet. Jeder Eintrag außerhalb von Loopback (127.0.0.0/8,::1) muss von einem SENDER_MAP-Netzschlüssel abgedeckt sein, sonst verweigert pepsi-ingress den Start und pepsi-setup(1)validatescheitert; ein Loopback-Eintrag ist uneingeschränkt. Standardmäßig leer. pepsi-setup(1) warnt vor einem Eintrag, der größer als ein einzelner Host und kein Loopback ist.- AUTH_PEERCRED
(optional, Standardwert ``yes`` bei einem ``SERVE = unix``-Listener, sonst ``no``) Authentifiziert den Client anhand der vom Kernel gemeldeten Peer-Zugangsdaten des UNIX-Sockets (
SO_PEERCRED): Die Benutzer-ID des verbindenden Prozesses wird über die passwd-Datenbank zu einem Login aufgelöst, und dieses Login wird in USERNAME_MAP genau so nachgeschlagen wie ein SASL-Benutzername. Die Sitzung ist damit authentifiziert und trägt eine Submission-Identität, sodass die Regeln aus RFC 6409 §6/§8.1 gelten: Ein lokales Programm kann nur einen Umschlagabsender und einFrom:verwenden, auf die sein eigenes Konto abgebildet ist, und ein Konto, das auf keine Adresse abgebildet ist, wird abgelehnt.Dies ist der Mechanismus hinter pepsi-sendmail(1) und der Grund, warum der Socket gefahrlos für alle beschreibbar sein darf: Ihn öffnen zu können entscheidet nichts darüber, als wer Sie senden dürfen. Anders als MYNETWORKS, das einer Netzwerk-Position vertraut und daher jedem lokalen Prozess erlaubt, als beliebiger Absender zu senden, wird die Identität hier vom Kernel geliefert und kann vom Client nicht gefälscht werden.
Auf einem
SERVE = tcp-Listener wird die Option abgelehnt, da es dort keine Peer-Zugangsdaten zu lesen gibt. Setzen Sie sie aufnofür einen nicht authentifizierten lokalen Socket (etwa hinter einem Proxy) — ein solcher Listener kann dann aber nicht zugleich ein SUBMISSION-Listener sein, da nichts authentifizieren würde.Mit
SERVE = systemdwird sie angenommen, aber nicht erschlossen und muss daher ausgeschrieben werden: ob der geerbte Deskriptor ein UNIX-Socket oder ein TCP-Socket ist, ist eine Eigenschaft der.socket-Unit und nicht dieser Datei, und die ausgeliefertepepsi-ingress.socketreicht beide Arten durch. Erweist sich der Deskriptor als TCP-Socket, authentifiziert die Option niemanden, dennSO_PEERCREDhat dort keine Bedeutung, und jede Sitzung bleibt anonym. Dieser Fehler ist sicher, aber still, daher warnt pepsi-ingress(1) beim Start und nennt den Listener.- SASL_TYPE
(optional) SASL-Backend für den
AUTH-Befehl:none(Standardwert) oderdovecot.AUTH(MechanismenPLAINundLOGIN) wird nur auf einer TLS-geschützten Sitzung angeboten und akzeptiert; ein Klartext-AUTHwird mit504 5.5.4abgelehnt (RFC 4954 §4 — das538von RFC 2554 ist veraltet) und einAUTHauf einem Listener ohne Backend mit503 5.5.1. Jeder Wert außernoneerfordert MODEtlsoderstarttls.- SASL_PATH
(Pfad) Pfad des Dovecot-Auth-Client-Sockets. Erforderlich, wenn SASL_TYPE
dovecotist — es gibt keinen Standardwert, und ein Listener, derdovecotverlangt, ohne ihn zu setzen, lässt sich nicht parsen. Der Pfad, denpepsi-setupvorschlägt,/run/dovecot/auth-client-pepsi, ist ein Pepsi-privater Listener statt des geteiltenauth-client-Sockets von Dovecot: Letzterer ist0600 dovecotund für den unprivilegiertenpepsi-ingress-Benutzer nicht erreichbar, sodass ein darauf zeigender Submission-Listener einAUTHbekommt, das immer mit einem Rechtefehler fehlschlägt.pepsi-setup runprüft diesen Socket als Dienstbenutzer und bietet, falls er fehlt oder nicht lesbar ist, an, eine/etc/dovecot/conf.d/10-pepsi.confzu installieren, die einen dedizierten,pepsi-ingressgehörenden Listener hinzufügt (oder gibt sie aus, damit Sie sie ausrollen).- TLS_AUTH_CLIENT
(optional) Durch Leerraum/Komma getrennte Liste von SHA-256-Hashes (64 Hex-Zeichen) der DER-
SubjectPublicKeyInfoautorisierter Client-Schlüssel. Wenn gesetzt, fordert der Listener ein Client-Zertifikat an: Eine Sitzung ist authentifiziert, wenn der Schlüssel-Hash des vorgelegten Blattzertifikats aufgeführt ist und[pepsi-ingress]SENDER_MAP diesen Pin an die Adressen bindet, als die er senden darf; der Pin ist der Schlüssel, und das Zertifikat um ihn herum wird nicht herangezogen. Ein Hash, der eine CA in der vorgelegten Kette nennt, autorisiert nichts (eine CA gehört in TLS_AUTH_CLIENT_CA, deren Beschränkungen geprüft werden können). Ein nicht erkanntes Zertifikat bricht den Handshake nicht ab. Ein Zertifikat wird nur von einem Client angefordert, der TLS 1.3 aushandeln kann (siehe TLS_AUTH_CLIENT_TLS12). Erfordert MODEtlsoderstarttls. Berechnen Sie einen Hash mitopenssl x509 -in cert.pem -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256.- TLS_AUTH_CLIENT_CA
(Pfad, optional) PEM-Datei mit CA-Zertifikaten, deren Client-Zertifikate authentifizieren. Ein vorgelegtes Zertifikat wird angenommen, wenn es einen vollständigen Pfad nach RFC 5280 zu einer von ihnen bildet (Gültigkeit,
basicConstraintsund Pfadlänge, die der CA selbst eingeschlossen, Schlüsselverwendung, Namens- und Richtlinienbeschränkungen, Schlüsselstärke); wenn es eineextendedKeyUsageträgt, dieid-kp-clientAuthnennt, sowie das BitdigitalSignature; wenn es nicht widerrufen ist und jedes Zertifikat des Pfades, das einen Verteilungspunkt nennt, von einer aktuellen Liste abgedeckt ist (den Listen, die pepsi-keydisc(1) inpepsi.crl_cachehält; ohne Liste wird das Zertifikat nicht angenommen, und ein Submission-Listener antwortet beiMAIL FROMmit451 4.7.0, bis die Liste abgerufen ist); und wenn[pepsi-ingress]SENDER_MAP den Schlüssel-Hash der CA (beim Start protokolliert) an die Adressen bindet, als die ihre Zertifikate senden dürfen. Ein Zertifikat, das ein Postfach nennt, ist auf diejenigen seiner Postfächer beschränkt, die die Bindung erlaubt. Jedes Zertifikat in der Datei muss eine aktuell gültige CA sein, die Zertifikate signieren darf, sonst wird die Konfiguration abgelehnt. Erfordert MODEtlsoderstarttls. Siehe pepsi-ingress(1), Client-Zertifikate.- MILTERS
(optional) Die Milter, die dieser Listener während der SMTP-Sitzung befragt, getrennt durch Leerzeichen oder Kommas, in Reihenfolge;
nonebefragt keinen. Ohne Wert führt ein Listener, der kein Submission-Listener ist,[pepsi-ingress] MILTERSaus, und ein Submission-Listener (der lokale Submission-Socket eingeschlossen) führt keinen aus. Ein Name ohne[pepsi-ingress-milter-*]-Abschnitt verhindert den Start von Ingress.- TLS_AUTH_CLIENT_TLS12
(boolesch, optional, Standardwert ``no``) Auf einem Listener mit TLS_AUTH_CLIENT oder TLS_AUTH_CLIENT_CA wird ein Client-Zertifikat nur angefordert, wenn der Client TLS 1.3 anbietet, das das Zertifikat verschlüsselt; TLS 1.2 sendet es im Klartext, und mit ihm die Person oder das Gerät, das es nennt. Ein TLS-1.2-Client wird weiterhin bedient, ohne Zertifikatsanforderung (auf
infoprotokolliert), sodass er sich mit SASL oder gar nicht authentifizieren kann.yesfordert das Zertifikat auch unter TLS 1.2 an, für ein Gerät, das nichts Neueres spricht.- SUBMISSION
(optional, Standardwert ``no``) Bei
yesist der Listener ein RFC-6409-Message-Submission-Agent: Die Authentifizierung wird verpflichtend (ein nicht authentifiziertesMAIL FROMwird mit530 5.7.0abgelehnt), und jede angenommene Nachricht erhält die Submission-Korrekturen — ein fehlendesDate:undMessage-ID:werden ergänzt. Erfordert mindestens einen Authentifizierungsmechanismus (SASL_TYPE, TLS_AUTH_CLIENT, TLS_AUTH_CLIENT_CA, MYNETWORKS oder AUTH_PEERCRED); ein Submission-Listener ohne einen wird abgelehnt. Lassen Sie es für einen MX-Listener (Port 25) aus. Ein Submission-Listener enthält außerdem standardmäßig den einliefernden Client dem Trace-Header vor (RECEIVED_PRIVACY).Ein TLS-MODE ist ebenfalls erforderlich, außer auf einem
SERVE = unix-Listener (oder einemSERVE = systemd-Listener, der einen UNIX-Socket erbt, beim Start geprüft): Ein Dateisystem-Socket hat keinen Transportweg, den ein Angreifer beobachten oder in den er sich einklinken könnte, und seine Authentifizierung stammt vom Kernel statt von der Leitung, sodass ein dort verlangtes Zertifikat nichts schützen würde.- RECEIVED_PRIVACY
(optional, Standardwert: der Wert von **SUBMISSION*)* Bei
yesträgt derReceived:-Trace-Header, der für jede auf diesem Listener angenommene Nachricht geschrieben wird, keinefrom-Klausel, und die Header-FelderUser-AgentundX-Mailerdes Clients werden entfernt. Der Header enthält dann weder die IP-Adresse und den Reverse-Namen des Clients noch den Namen, den er inEHLOangekündigt hat, meist den Maschinennamen des Benutzers. Jeder Empfänger und jedes Listenarchiv erführe sonst aus einer gesendeten Nachricht die Adresse und Software des Einliefernden; dies ist die datenschutzfreundliche Konvention von draft-josefsson-email-received-privacy, der große Anbieter bei der Einlieferung folgen. Dieby-Klausel, das Protokollschlüsselwort nach RFC 3848, die TLS-Parameter, diefor-Klausel und das Datum bleiben, sodass die Schleifenerkennung (MAX_SELF_HOPS, das dieby-Klausel zählt) und der Transportnachweis unberührt bleiben, und das Journal von pepsi-ingress(1) hält den Client für die Missbrauchsbearbeitung weiterhin fest. Standardmäßig an für einen Submission-Listener, den impliziten lokalen Submission-Socket eingeschlossen; aus für einen MX-Listener, wo die Spur eines entfernten Peers das ist, was die Missbrauchsbearbeitung beim nächsten Hop braucht. Setzen Sie es ausdrücklich, um eines davon umzukehren.
Eine durch eines von MYNETWORKS, AUTH_PEERCRED, SASL AUTH oder ein Client-Zertifikat (TLS_AUTH_CLIENT, TLS_AUTH_CLIENT_CA) akzeptierte Sitzung wird mit state.local_origin = true festgehalten (sonst false) und darf an jede Domain weiterleiten, nicht nur an die bedienten Domains.
95.2.1.1.16. Die Abschnitte [pepsi-ingress-exchange-online-*]¶
Jeder Abschnitt, dessen Name mit pepsi-ingress-exchange-online- beginnt, nennt einen Microsoft-365-Mandanten (Exchange Online), dessen ausgehende Mail dieser Host weiterleitet, zum Beispiel [pepsi-ingress-exchange-online-example]. Das Suffix ist ein frei wählbarer Name, der in Lognachrichten erscheint und in state.exchange_tenant festgehalten wird.
Exchange Online sendet über einen ausgehenden Connector an Port 25, von Adressen, die alle Microsoft-365-Kunden gemeinsam nutzen, und kann sich beim Smarthost nicht authentifizieren. MYNETWORKS kann diesen Mandanten nicht von anderen unterscheiden und würde daher jeden Kunden als die bedienten Domains senden lassen. Stattdessen darf ein Client in SENDER_NETWORKS, dessen Umschlagabsender leer ist oder in einer der DOMAINS liegt, an einem MX-Listener (einem, der kein Submission-Listener ist) Empfänger außerhalb der bedienten Domains nennen. Am Ende der Daten wird die Nachricht nur weitergeleitet, wenn alle folgenden Bedingungen erfüllt sind, und sonst mit 550 5.7.1 abgelehnt:
der Header enthält genau ein Feld
X-MS-Exchange-CrossTenant-Id, und sein Wert ist TENANT_ID. Exchange Online fügt dieses Feld jeder Nachricht hinzu und nennt darin den sendenden Mandanten, behält aber eine Kopie, die der Absender geschrieben hat; eine Nachricht von einem anderen Mandanten, die diesen beansprucht, hat daher zwei;die Nachricht hat genau ein
From:-Postfach, in einer der DOMAINS;eine DKIM-Signatur dieser
From:-Domain wurde verifiziert. Dafür muss die DKIM-Signierung für die Domain in Microsoft 365 eingeschaltet sein (die Einträgeselector1undselector2).
Eine nachgewiesene Nachricht wird von da an wie eine Einlieferung behandelt (state.local_origin = true, state.origin.auth_method = exchange-online). Sie spricht nicht für ihre From:-Adresse und kann daher keine Schlüssel per E-Mail registrieren oder bedienen. Mail, die der Mandant für einen externen Absender weiterleitet, trägt keine Signatur der Domains des Mandanten und wird nicht weitergeleitet. Eine Nachricht, deren Empfänger alle in bedienten Domains liegen, ist gewöhnliche eingehende Mail und braucht keinen Nachweis.
- TENANT_ID
(erforderlich) Die Mandanten-ID, wie sie das Microsoft Entra Admin Center anzeigt (acht, vier, vier, vier und zwölf Hexadezimalziffern).
- DOMAINS
(erforderlich) Die Domains, als die der Mandant senden darf, getrennt durch Leerzeichen oder Kommas. Jede muss eine der
[pepsi-ingress] ACCEPTED_DOMAINSsein.- SENDER_NETWORKS
(optional) Die Netze, aus denen die Mail des Mandanten ankommt, getrennt durch Leerzeichen oder Kommas. Der Standard ist die Liste der ausgehenden Adressen von Exchange Online, die Microsoft im SPF-Eintrag
spf.protection.outlook.comveröffentlicht:40.92.0.0/15,40.107.0.0/16,52.100.0.0/15,52.102.0.0/16,52.103.0.0/17,104.47.0.0/17,2a01:111:f400::/48,2a01:111:f403::/49,2a01:111:f403:8000::/51,2a01:111:f403:c000::/51und2a01:111:f403:f000::/52. Der Nachweis beruht auf dieser Liste: Nur Mail, die wirklich von Exchange Online ankommt, trägt das Mandantenfeld, das Microsoft schreibt. Fügen Sie daher nie eine Adresse hinzu, von der auch jemand anderes senden kann.
95.2.1.1.17. Die Abschnitte [pepsi-ingress-milter-*]¶
Jeder Abschnitt, dessen Name mit pepsi-ingress-milter- beginnt, benennt einen Milter (einen Mailfilter, der das Milter-Protokoll von sendmail/Postfix spricht), den pepsi-ingress(1) während der SMTP-Sitzung befragt, zum Beispiel [pepsi-ingress-milter-greylist]. Das Suffix ist der Name, den MILTERS aufführt. Weil der Milter antwortet, während der Client noch verbunden ist, ist seine Ablehnung die SMTP-Antwort: Eine 5xx-Ablehnung meldet der sendende MTA seinem eigenen Benutzer, und eine 4xx-Ablehnung wiederholt er, und so funktioniert Greylisting. Nichts wird angenommen, wofür später ein Bounce erzeugt werden müsste. Wie die Sitzung einem Milter präsentiert wird und was jedes Urteil bewirkt, beschreibt pepsi-ingress(1), Milter. Ein Milter, der läuft, nachdem die Nachricht angenommen wurde, ist stattdessen eine pepsi-stage-milter-Stage (pepsi-stage-milter(1)), die die Nachricht nach der Entschlüsselung sieht.
- SOCKET
(erforderlich) Wo der Milter lauscht, in der Syntax, die
S=von sendmail undsmtpd_miltersvon Postfix verwenden:unix:/path(oderlocal:/path),inet:host:port,inet:port@hostoderinet6:[address]:port.- MILTER_NAME
(optional) Der Wert des Makros
{daemon_name}; Standardwert ist das Suffix des Abschnitts.- ALLOW_ACTIONS
(optional) Die Änderungen, die der Milter vornehmen darf, wie bei pepsi-stage-milter(1):
addhdrs,chghdrs,chgbody,addrcpt,addrcpt_par,delrcpt,chgfrom,quarantineoderall/none. Der Standardwert istaddhdrs chghdrs chgbody quarantine: alles, was ein Inhaltsfilter braucht, und keine Änderung am Umschlag. Ein Milter, der eine Aktion braucht, die ihm nicht angeboten wurde, scheitert bei seiner Aushandlung, was dann ON_FAILURE behandelt, und das Journal nennt die fehlende Aktion. Ein Empfänger, den ein Milter hinzufügt, unterliegt der Regel, der jedesRCPTunterliegt: eine Adresse in einer bedienten Domain, die etwas auf diesem Host annehmen würde, oder eine beliebige Adresse in einer authentifizierten Sitzung; alles andere wird verworfen und protokolliert, sodass ein Filter den Host nicht in ein offenes Relay verwandeln kann.quarantinewird nur angeboten, wenn es eine Quarantäne-Stage gibt (QUARANTINE_STAGE). Manche Filter verlangen mehr, als sie nutzen: rspamd etwa verlangt außer den Header- und Nachrichtentext-Aktionen auchaddrcpt,delrcptundquarantineund wird ohne sie abgewiesen.pepsi-setupschreibt, was ein erkannter Filter verlangt.- QUARANTINE_STAGE
(optional) Die Stage, bei der eine Nachricht, die der Milter in Quarantäne stellt, statt bei
initgespeichert wird. Standardwert ist die eine Stage, die pepsi-stage-quarantine(1) ausführt, sofern es genau eine gibt; ohne eine solche Stage wird dem Milter keine Quarantäne angeboten. Die Nachricht hältstate.quarantine.reason(den Text des Milters) undstate.quarantine.by(milter:<name>) fest.- ON_FAILURE
(optional, Standardwert ``accept``) Was ein Milter kostet, der nicht erreichbar ist, in einen Timeout läuft oder das Protokoll verletzt:
acceptbefragt ihn für den Rest der Sitzung nicht mehr, und die Mail wird angenommen, als wäre er nicht konfiguriert (protokolliert und in der Telemetrie gezählt);tempfailbeantwortet den aktuellen Befehl und jedes spätereMAILder Sitzung mit451 4.7.1;rejectbeantwortet sie mit550 5.7.1.acceptfolgt der Haltung, die Ingress überall sonst einnimmt: Ein abgestürzter Filter darf nicht alle eingehende Mail aufhalten. Wählen Sietempfailfür einen Filter, dessen Urteil nie übersprungen werden darf; die sendenden MTAs behalten die Mail dann, bis der Filter wieder da ist.- CONNECT_TIMEOUT, COMMAND_TIMEOUT, CONTENT_TIMEOUT
(Dauern, optional, Standardwerte ``30 s``, ``30 s`` und ``300 s``) Wie bei pepsi-stage-milter(1): Verbinden und Aushandeln, Warten auf die Antwort auf einen Befehl und Warten auf das Urteil am Nachrichtenende (
SMFIR_PROGRESSstartet das Warten neu, bis zum Zehnfachen des Timeouts). Der SMTP-Client wartet ebenso lange; RFC 5321 gibt ihm zehn Minuten für die Antwort auf das Ende der Daten, halten Sie CONTENT_TIMEOUT also deutlich darunter.- PROTOCOL_VERSION
(optional, Standardwert ``6``) Die höchste angebotene Version des Milter-Protokolls.
- MACROS_CONNECT, MACROS_HELO, MACROS_MAIL, MACROS_RCPT, MACROS_DATA, MACROS_EOH, MACROS_EOM
(optional) Die bei jeder Phase gesendeten Makros, standardmäßig die Listen von Postfix (
milter_connect_macrosund die übrigen);nonesendet in dieser Phase keine. Einem Milter, der mitSMFIF_SETSYMLISTseine eigene Liste verlangt, wird stattdessen diese gesendet. Ingress kenntj,_,v,i(das Token des Datensatzes, als der die Nachricht gespeichert wird),{daemon_name},{daemon_addr},{if_addr},{if_name},{client_addr},{client_port},{client_name},{client_ptr},{tls_version},{cipher},{auth_type},{auth_authen},{auth_author},{auth_ssf},{mail_addr},{mail_host},{mail_mailer},{rcpt_addr},{rcpt_host}und{rcpt_mailer}; alle anderen werden nicht gesendet.
95.2.1.1.18. Der Abschnitt [pepsi-greylist]¶
Gelesen von pepsi-greylist(1), dem Greylisting-Milter, von pepsi-status(1) und von pepsi-setup(1) validate. Jede Option und ihr Standardwert sind in pepsi-greylist(1) beschrieben: SOCKET, SOCKET_MODE, SOCKET_GROUP, DELAY, RETRY_WINDOW, PASSED_TTL, AUTO_WHITELIST_PASSES, AUTO_WHITELIST_TTL, IDENTITY, IPV4_MASK, IPV6_MASK, DNS_TIMEOUT, DNS_CACHE_TTL, DNS_SERVERS, EXEMPT_RECIPIENTS, RECIPIENT_DOMAINS, WHITELIST_BYPASS, WHITELIST_NAME (mit LOCAL_DOMAINS, RECIPIENT_DELIMITER und TARGETS, so wie eine Whitelist-Stage sie liest), BIG_SENDERS, SPF_BYPASS, REPLY, DB_POOL_SIZE und MAX_CONNECTIONS. Dauern können dort in Tagen und Wochen angegeben werden.
95.2.1.1.19. Die Abschnitte [pepsi-greylist-senders-*]¶
Ein Abschnitt je Gruppe von Absendern, die nie gegreylistet werden, [pepsi-greylist-senders-NAME], mit DOMAINS (die Identitätsdomain des Clients oder der vorwärtsbestätigte PTR-Name), NETWORKS (die Client-Adresse) und ENABLED. Die mitgelieferten Gruppen stehen in ${DATADIR}/config.d/greylist.conf; siehe pepsi-greylist(1).
95.2.1.1.20. Der Abschnitt [pepsi-reputation]¶
Gelesen von pepsi-reputation(1), das die IP-Sperrlisten herunterlädt, gegen die eingehende Mail geprüft wird, und prüft, ob dieser Host auf einer steht, sowie von pepsi-setup(1).
- CACHE_DIR
(Pfad, optional) Wo rsync seine Kopie jeder rsync-Liste hält, sodass der nächste Download nur den Unterschied überträgt. Standardwert
/var/lib/pepsi-reputation, das Zustandsverzeichnis vonpepsi-reputation-iplists.service.- CHECK_IP_ZONES
(Zeichenkette, optional) Die DNS-Sperrlisten, die
pepsi-reputation checknach den eigenen Adressen dieses Hosts fragt. Standardwertzen.spamhaus.org bl.spamcop.net b.barracudacentral.org psbl.surriel.com bl.mailspike.net dnsbl-1.uceprotect.net ix.dnsbl.manitu.net;nonefragt keine.- CHECK_DOMAIN_ZONES
(Zeichenkette, optional) Die Domain-Sperrlisten, die es nach den bedienten Domains fragt. Standardwert
dbl.spamhaus.org multi.surbl.org.- CHECK_ADDRESSES
(Zeichenkette, optional) Zu prüfende Adressen zusätzlich zur
PUBLIC_IPjederpepsi-stage-relay-to-internet-Stage und den Adressen von[pepsi-ingress] HOSTNAME.- GOOGLE_SITE_VERIFICATION
(Zeichenkette, optional)
DOMAIN:TOKEN-Paare, die Tokens, die die Gmail Postmaster Tools je Domain ausgeben. pepsi-setup(1) gibt jedes alsgoogle-site-verification=TOKEN-TXT-Eintrag für die Domain aus und prüft, dass er veröffentlicht ist.
95.2.1.1.21. Die Abschnitte [pepsi-reputation-list-*]¶
Ein Abschnitt je IP-Sperrliste, [pepsi-reputation-list-NAME]; NAME besteht aus Kleinbuchstaben, Ziffern und -. pepsi-reputation iplists update lädt jede aktivierte Liste vollständig in die Datenbank; pepsi-ingress(1) schlägt dort den Client jeder nicht authentifizierten Sitzung nach, hält die Listen, die ihn nennen, unter state.origin.ip_blocklist fest (siehe pepsi.state(7)) und lehnt bei einer Liste mit ACTION = reject die Empfänger der Sitzung ab. Kein Betreiber einer Liste wird nach einem Client gefragt, während dieser verbunden ist.
${DATADIR}/config.d/reputation.conf definiert spamhaus-drop-v4, spamhaus-drop-v6 und blocklist-de-mail (aktiviert) sowie uceprotect-1 (rsync, deaktiviert), alle mit ACTION = mark. Ändern Sie eine ihrer Optionen, indem Sie den Abschnitt in pepsi.conf nennen; die spätere Definition gewinnt Option für Option.
- URL
(Zeichenkette)
https://…oderrsync://HOST/MODULE/FILE(eine Datei, druckbares ASCII). Erforderlich, außer im Abschnitt einer mitgelieferten Liste, wo es und FORMAT standardmäßig die mitgelieferten Werte haben, sodass ein Abschnitt, der nurENABLEDsetzt, auch dort funktioniert, woconfig.dnicht installiert ist. Eine rsync-Liste braucht das Programmrsync, eine optionale Abhängigkeit: Auf einem Host ohne es wird die Liste nicht verwendet, ihre Einträge werden entfernt, und pepsi-setup(1) warnt.- FORMAT
(Zeichenkette, optional)
ip-list(Standardwert): ein Eintrag pro Zeile, wie dieip4set/ip6trie-Datensätze von rbldnsd oder eine schlichte Adressliste ihn haben – eine Adresse, ein Netz, ein Bereich (a.b.c.d-e.f.g.hodera.b.c.d-h) oder die Kurzform von rbldnsd (a.b.cfür ein /24), ein Ausschluss mit führendem!.spamhaus-drop: die JSON-Zeilen von Spamhaus DROP. Einträge größer als ein /8 (IPv4) oder ein /16 (IPv6) werden verworfen, und eine Datei, von der mehr als ein Zehntel keine Einträge sind, wird abgelehnt.- ENABLED
(boolesch, optional) Ob die Liste heruntergeladen und herangezogen wird. Standardwert
YES.- ACTION
(Zeichenkette, optional)
mark(Standardwert) hält die Listung für die Pipeline fest; pepsi-stage-if(1) kann nachorigin.ip_blocklist.listedoderorigin.ip_blocklist.lists.NAMErouten.rejectlehnt außerdem die Empfänger mit554 5.7.1ab, außer<postmaster>.- MIN_INTERVAL
(Dauer, optional) Die kürzeste Zeit zwischen zwei Downloads der Liste. Standardwert
45 m. Betreiber von Listen sperren Hosts aus, die zu oft herunterladen (UCEPROTECT: mehr als vier Dateien pro Stunde).- MAX_AGE
(Dauer, optional) Wie lange nach ihrer letzten erfolgreichen Prüfung Ingress die Liste noch heranzieht. Standardwert
12 h. Eine ältere Liste wird als unbekannt behandelt, was Mail zulässt und nichts festhält.- MAX_SIZE
(ganzzahlig, optional) Die größte angenommene Listendatei, in Bytes. Standardwert 67108864 (64 MiB).
95.2.1.1.22. Die Stage-Pipeline und die Abschnitte [stage-*]¶
Nach dem Ingress wird eine Nachricht durch eine Kette von Stage-Programmen weitergeschaltet. pepsi-dispatch(1) beansprucht einen pending-Datensatz, setzt ihn auf running und übergibt die Nachrichten-ID einem dauerhaften Worker-Prozess jener Stage. Der Worker wird als PROGRAM [-c FILE] worker gestartet, liest IDs von seiner Standardeingabe, eine je Zeile, und beantwortet jede mit einer Statuszeile; er erledigt seine Arbeit und schaltet den Datensatz weiter (oder schließt ihn ab). Es gibt keinen Aufruf mit positionaler ID: Ein PROGRAM, das ein Wrapper-Skript ist, muss daher seine Argumente und seine Standardeingabe weiterreichen. Neue Nachrichten treten bei der Anfangs-Stage [stage-init] ein, die existieren muss.
Jeder Abschnitt, dessen Name mit stage- beginnt, beschreibt eine Stage. Das Suffix ist der Stage-Name, z. B. [stage-init]. Der Stage-Name ist ein vom Betreiber gewähltes Etikett, unabhängig vom Binärprogramm, das er ausführt.
- PROGRAM
(Zeichenkette, erforderlich) Das auszuführende Stage-Binärprogramm, z. B.
pepsi-stage-relay-to-smarthost. Es wird auf demPATHgefunden, sofern nicht als absoluter Pfad angegeben. Dasselbe Binärprogramm kann mehrere Stages bedienen (es liest seine Optionen aus dem Abschnitt, an dem sich die Nachricht gerade befindet).- NEXT_STAGE
(Zeichenkette, optional) Die Stage, zu der eine Nachricht bei Erfolg weiterschaltet. Ohne eine entfernt eine erfolgreiche terminale Stage die Nachricht.
- BOUNCE_STAGE
(string, optional) The stage to which a message is routed so that a delivery-status notification is generated. For delivery stages (pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-internet(1)) and pepsi-stage-discard(1) it receives a permanently-failed (non-bounce) message for a bounce, and — when
[pepsi]ORIGINATE_SUCCESS_DSNis enabled — a successfully-delivered message for a positive report. With none, a permanently-failed message is markedfailed(delivery stages) or simply dropped (pepsi-stage-discard(1)).- PARALLELISM
(Zahl, optional) Obere Schranke für die Anzahl gleichzeitiger Worker-Prozesse, die pepsi-dispatch(1) für diese Stage betreibt. Worker werden bei Bedarf gestartet und im Leerlauf gestoppt, sodass dies eine Obergrenze ist, keine feste Pool-Größe. Jeder Worker hält eine Datenbankverbindung, sodass dies auch den Anteil der Stage am Verbindungsbudget begrenzt (siehe den
[pepsi-postgres]-Hinweis oben). Standardwert 4. Der Dispatcher senkt eine Stage vorübergehend unter diesen Wert, wenn die Datenbank meldet, dass ihr Verbindungslimit erschöpft ist (siehe pepsi-dispatch(1)).- MAX_RUNTIME
(Dauer, optional) Maximale Echtzeit, die ein Worker dieser Stage für eine einzelne Nachricht aufwenden darf. Sie ersetzt
[pepsi-dispatch] MAX_RUNTIMEfür diese Stage, sodass ein langsamer Hop Zeit bekommt, ohne jede andere Stage zu lockern. Diepepsi-stage-relay-to-*-Stages beenden eine Zustellung etwas früher, um ein Zehntel dieser Zeit (zwischen 1 s und 30 s), damit Zeit bleibt, ihr Ergebnis zu speichern: Bereits gelesene Antworten bleiben gültig, und der Rest wird wie jeder vorübergehende Fehler aufgeschoben. pepsi-setup(1) lehnt ein CONNECT_TIMEOUT, COMMAND_TIMEOUT oder DATA_TIMEOUT ab, das nicht in diese Zeit passt, auch eines, das auf seinem Standardwert belassen wurde.- MAX_MESSAGES
(Zahl, optional) Anzahl der Nachrichten, die ein Worker dieser Stage verarbeitet, bevor der Dispatcher ihn ausmustert und einen frischen Prozess startet (begrenzt das Speicherwachstum). Standardwert 1000.
- QUEUE_LIMIT
(number, optional) Upper bound on the number of messages pepsi-dispatch(1) pipelines to a single worker process of this stage at once. The worker still processes them strictly one at a time, but having the next ids already queued on its standard input removes a coordinator round-trip per message, so the stage’s total in-flight capacity is
QUEUE_LIMIT × PARALLELISM. Because the worker count (and thus the connection budget) is unchanged, raising this gains throughput without spending more database connections, at the cost of a little head-of-line latency (a message can wait behind a slower pipelined sibling on the same worker); lower it (e.g. to1) for a stage whose per-message work is long and uneven, such as a network relay. Default 4.- MAX_LIFETIME
(Dauer, optional) Wie lange eine Nachricht an dieser Stage immer wieder fehlschlagen darf, bevor der Worker aufgibt, gezählt ab dem Zeitpunkt, zu dem die Nachricht eingereiht wurde (bei einer DSN ab dem Zeitpunkt, zu dem pepsi-stage-bounce(1) sie gebaut hat). Das gilt für jeden Fehler, den die Stage nicht als permanent markiert, also einen Fehler, an dem der Host schuld ist und nicht die Nachricht, etwa eine unlesbare Resolver-Konfiguration, ein Helper, der sich nicht starten lässt, oder eine Vorlage, die sich nicht lesen lässt. Bis dahin wird die Nachricht pausiert und erneut versucht, nach einer Minute und dann jedes Mal doppelt so lange, bis zu einer Stunde, mit dem Fehler in
state.last_error. Danach wird sie zur BOUNCE_STAGE dieser Stage umgeleitet oder schlägt fehl, wenn es keine gibt oder die Nachricht die Kopie eines Listenbeitrags für ein Mitglied ist (siehe pepsi-dispatch(1)). Die Zustell-Stages und pepsi-stage-milter(1) lesen dieselbe Option für ihre eigenen Wiederholungen. Standardwert120 h.- FUSION =
yes|no (optional) Ob eine Vorgänger-Stage diese Stage in ihrem eigenen Worker-Prozess ausführen darf, statt den Datensatz
pendingzu schreiben und zu warten, bis der Dispatcher ihn beansprucht (Stage-Fusion; siehe[pepsi] ALLOW_FUSIONoben und pepsi-dispatch(1)). Fusion geschieht nur, wenn sie auch global aktiviert ist, das PROGRAM dieser Stage in das vereinheitlichtepepsi-Binärprogramm eingefaltet ist und diese Stage keine Nachrichtenspalte benötigt, die der Vorgänger nicht bereits geladen hat. Trifft eines davon nicht zu, wird die Fusion verweigert, und das Weiterschalten fällt auf einen normalen, vom Dispatcher zugeteilten Hop zurück, was stets sicher ist. Standardwert istnofür jedes Programm außer den schnellen, nachrichtentextfreien Routing- und Klassifizierungs-Stages, für die eryesist: pepsi-stage-if(1), pepsi-stage-discard(1), pepsi-stage-srs(1), pepsi-stage-check-whitelist(1), pepsi-stage-auto-whitelist(1), pepsi-stage-block-language(1), pepsi-stage-list(1), pepsi-stage-edit-settings(1) (das für jede Nachricht nachrichtentextfrei ist, die keine Steuernachricht ist, also praktisch für alle), pepsi-stage-dmarc-report(1) (nachrichtentextfrei für alle Mail, die nicht an seine Berichtsadresse geht) und pepsi-stage-defang(1) (nachrichtentextfrei für jeden Empfänger, der es nicht eingeschaltet hat). Zwei davon brauchen den Header-Block statt nur des Umschlags, sodass jede von beiden nur in einen Vorgänger fusioniert, der ihn bereits geladen hat: pepsi-stage-block-language(1), dessenENFORCEMENT = soft-Pfad denSubject:umschreibt, und pepsi-stage-check-whitelist(1), dasList-Id:liest. Ein Programm hier aufzuführen setzt nur den Standardwert seinerFUSION-Option; ob ein bestimmtes Paar tatsächlich fusionieren darf, wird je Paar zur Laufzeit entschieden.
Die übrigen Optionen in einem [stage-<name>]-Abschnitt hängen von seinem PROGRAM ab. Die untenstehenden Unterabschnitte dokumentieren die Optionen, die jedes Stage-Programm aus seinem eigenen Abschnitt liest; ein Abschnitt liest nur die für sein PROGRAM aufgeführten Schlüssel plus die allgemeinen Schlüssel oben.
Einige Programme sind die Ausnahme und werden nur in ihren eigenen Handbuchseiten dokumentiert, weil ihre Optionsmengen groß sind und sich mit dem Zustellmechanismus ändern, den sie ansteuern: pepsi-stage-relay-to-maildir(1) (dessen SERVER_NAME erforderlich ist — die Stage verweigert ohne ihn den Start — plus HELPER, UNKNOWN_MAILBOX_STAGE, QUOTA_LIMIT_STAGE, die RETRY_*-Familie, MAX_LIFETIME und die Lokalitätsoptionen LOCAL_DOMAINS, TARGETS und RECIPIENT_DELIMITER), pepsi-stage-relay-to-lmtp(1) (SOCKET oder HOST/PORT, TLS, TLS_VERIFY, TLS_CA, TLS_CLIENT_CERT/TLS_CLIENT_KEY, AUTH, USERNAME, PASSWORD, SERVER_NAME, QUOTA_LIMIT_STAGE, SIEVE_REJECT_STAGE, UNKNOWN_MAILBOX_STAGE, LOCAL_DOMAINS, NOTIFY_STAGE, die Timeouts und die RETRY_*-Familie mit MAX_LIFETIME und DELAY_DSN_AFTER), pepsi-stage-dot-forward(1) (HELPER, RESTART_STAGE, ALLOW_PIPE, ALLOW_FILE und die Lokalitätsoptionen) sowie die Mailinglisten-Stages pepsi-stage-list(1) (POST_STAGE, COMMAND_STAGE), pepsi-stage-list-post(1) (DELIVERY_STAGE, RESPONSE_STAGE, REMOVE_DKIM_HEADERS, SITE_HEADER_MATCH_CHAIN, SENDER_POSTS_PER_HOUR, MAX_HELD_MESSAGES), pepsi-stage-list-deliver(1), pepsi-stage-list-command(1) (RESPONSE_STAGE, MAX_COMMAND_LINES, REQUIRE_AUTHENTICATED) und pepsi-stage-list-bounce(1) (RESPONSE_STAGE), deren standortweite Optionen weiter unten in [pepsi-list] stehen. Alles auf dieser Seite über [stage-<name>] im Allgemeinen gilt weiterhin für sie. Die gemeinsamen Abschnitte, aus denen diese Programme ebenfalls schöpfen, sind anderswo auf dieser Seite dokumentiert: [pepsi] (Signieridentität), [pepsi-srs] (die SRS-Engine), [pepsi-payments] (das Händler-Backend) und die Smarthost-Abschnitte [pepsi-stage-relay-to-smarthost-mta-*].
95.2.1.1.22.1. pepsi-stage-arc-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-arc liest neben einem erforderlichen NEXT_STAGE ihre DNS-Einstellungen und die Signaturparameter des ARC-Sets, das sie hinzufügt (diese gelten für die ARC-Message-Signature; die ARC-Seal wird stets relaxed-kanonisiert über eine feste Header-Menge, gemäß RFC 8617):
- DNS_SERVERS
(Zeichenkette, optional) Resolver, in der Syntax von
[pepsi] DNS_SERVERS, für die Schlüsselabfragen, die die eingehende ARC-Kette validieren (SPF, DKIM und DMARC wurden von pepsi-ingress(1) verifiziert und werden hier nicht erneut ausgeführt). Wenn nicht gesetzt, gilt[pepsi] DNS_SERVERS, und ohne dieses die System-resolv.conf.- DNS_TIMEOUT
(Dauer, optional) DNS-Timeout pro Abfrage. Standardwert
[pepsi] DNS_TIMEOUT, sonst5 s.- HEADER_CANONICALIZATION
(``relaxed`` | ``simple``, optional) Header-Kanonisierung der AMS (die linke Hälfte von
c=). Standardwertrelaxed.- BODY_CANONICALIZATION
(``relaxed`` | ``simple``, optional) Nachrichtentext-Kanonisierung der AMS (die rechte Hälfte von
c=). Standardwertrelaxed. ARC unterstützt jede Kombination der beiden.- SIGNATURE_EXPIRATION_DAYS
(ganzzahlig, optional) Wenn auf eine positive Anzahl von Tagen gesetzt, trägt die AMS einen Ablauf (
x=) so viele Tage nach dem Signieren. Nicht gesetzt (der Standardwert) gibt keinen Ablauf aus. Die ARC-Seal hat in RFC 8617 keinx=-Tag und trägt nie eines, was diese Option auch sagt.- SIGNED_HEADERS
(Zeichenkette, optional) Durch Leerraum/Komma getrennte Liste der Header, die die AMS abdeckt (
h=). MussFromenthalten. Standardwert ist die eingebaute Menge von Urheber-/MIME-Headern plusDKIM-Signature, sodass die DKIM-Signaturen, deren Ergebnisse die AAR festhält, nicht hinter dem Siegel entfernt oder ersetzt werden können. Jedes Feld außerDKIM-Signaturewird zweimal aufgeführt, sodass eine nach dem Siegel hinzugefügte Kopie davon das Set bricht.DKIM-Signaturewird einmal aufgeführt und nur bei einer Nachricht signiert, die eine trägt: Ein fehlendes Feld inh=zu nennen, würde es übersignieren, und eine nach dem Siegel hinzugefügte DKIM-Signatur (etwa vonpepsi-stage-dkim-signan einer weitergeleiteten Nachricht) bräche dann das Set.
Die ARC-Signieridentität und der Algorithmus stammen aus dem gemeinsamen [pepsi]-Abschnitt (ARC_DOMAIN, ARC_ALGORITHM); der Schlüssel wird von pepsi-dkim(1) gehalten, und das Siegel wird von ihm signiert. Der Hash ist immer SHA-256; der Signaturalgorithmus (a=) ist die einzige [pepsi] ARC_ALGORITHM-Wahl, da ARC eine Signatur pro Hop erlaubt.
95.2.1.1.22.2. pepsi-stage-srs-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-srs benötigt nur ein NEXT_STAGE in ihrem eigenen [stage-<name>]-Abschnitt; alle ihre Parameter (SRS_DOMAIN, SECRET/SECRET_FILE, MAX_AGE_DAYS, ALLOW_ALIGNED_DOMAIN) liegen im oben dokumentierten gemeinsamen [pepsi-srs]-Abschnitt, sodass sie mit der Rückwärts-Dekodierung von Ingress identisch sind.
95.2.1.1.22.3. pepsi-stage-encrypt-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-encrypt signiert lokal eingelieferte Mail als ihren From:-Autor und verschlüsselt sie an jeden Empfänger. Sie liest, neben einem erforderlichen NEXT_STAGE und einem optionalen BOUNCE_STAGE:
Warnung
Platzieren Sie diese Stage vor der DKIM-Signier-Stage, nicht danach: … → encrypt → srs → dkim-sign → relay. DKIM muss die Bytes signieren, die tatsächlich übertragen werden, und diese Stage schreibt den Nachrichtentext um. Zuerst zu signieren ergibt Mail, die gültig aussieht, deren Signatur aber nicht durchgeht. Das ist schlimmer als keine Signatur, denn eine defekte ist für einen Empfänger ein stärkeres negatives Signal als eine fehlende. pepsi-setup(1) warnt, wenn es eine DKIM-Signier-Stage findet, die zu dieser führt.
Die Pay-to-Send-Schranke und die Spracherkennung lesen beide den Nachrichtentext und wollen beide Klartext; auf dem ausgehenden Pfad laufen sie vor dieser Stage, weshalb die Verschlüsselung zuletzt kommt.
Jede Option unten ist verhaltensbezogen und ist je Adresse über die pepsi.settings-Tabelle überschreibbar (pepsi-settings(1)), für ausgehende Mail auf den Umschlagabsender geschlüsselt. Die kryptographische Richtlinie — Algorithmen, Herabstufungserlaubnis, Mindestschlüsselgrößen — steht in den CRYPTO_*-Optionen von [pepsi] und in [pepsi-crypto], ist nur für Systemadministratoren und ist von hier aus bewusst nicht erreichbar.
- ENABLE_PEP
(boolesch, optional) Verhält sich wie das Projekt pretty Easy privacy (pEp): Jeder lokale Absender an einer bedienten Domain erhält bei seiner ersten Nachricht einen Schlüssel, Mail wird verschlüsselt, wann immer ein Empfängerschlüssel bekannt oder auffindbar ist, und der Schlüssel des Absenders geht mit jeder Nachricht hinaus. Standardwert
YES.Eine Voreinstellung von Standardwerten, kein erzwingender Modus: Sie ändert den Standardwert von
SIGNaufencrypted-onlyund schaltet das eifrige Erzeugen von Schlüsseln ein. Jede ausdrücklich ausgeschriebene Option hat weiterhin Vorrang. MitENABLE_PEP = noist der Standardwert vonSIGNopportunistic, und Schlüssel werden nur auf ausdrückliche Anforderung (Signieren oder Verschlüsseln) oder unterSIGN = alwayserzeugt. Das eifrige Erzeugen benötigt zusätzlich[pepsi-crypto] AUTO_CREATE_IDENTITY(das Veto des Betreibers, das keine adressbezogene Überschreibung erreicht) und einKEY_WRAP_SECRET, und es geschieht nur für eine Adresse an einer[pepsi-ingress] ACCEPTED_DOMAINS-Domain, die keinerleicrypto_identity-Zeile hat. Ein Benutzer kann sich mitENABLE_PEP = noin seiner eigenenpepsi.settings-Überschreibung abmelden, woEDITABLE_STAGESes erlaubt. Es wird kein pEp-Leitungsformat erzeugt: keinX-pEp-Version-Header, keine pEp-2.x-Verpackung, keine Trustwords und keine Schlüsselsynchronisation. Siehe pepsi-stage-encrypt(1).- SIGN
(``no`` | ``encrypted-only`` | ``opportunistic`` | ``always``, optional) Ob mit dem Schlüssel des
From:-Autors signiert wird. Standardwertencrypted-onlyunterENABLE_PEP, sonstopportunistic.encrypted-onlysigniert nur eine Nachricht, die diese Stage verschlüsselt, und zwar innerhalb des Chiffrats; Klartext-Mail trägt den Schlüssel des Absenders, aber keine Signatur, sodass ein Empfänger, der keine Kryptografie verwendet, nie einesignature.ascsieht. Eine ausdrückliche Anforderung (X-Pepsi-Sign: yes, ein[sign]-Betreff-Schlüsselwort) signiert Klartext dennoch.opportunisticsigniert, wenn der Autor brauchbares Material hat, und sendet sonst unsigniert.alwayssigniert auf dieselbe Weise und lässt zusätzlich für einen Autor, der keine hat, eine Identität erzeugen, unter denselben Bedingungen wie das eifrige Erzeugen vonENABLE_PEP(AUTO_CREATE_IDENTITY, einKEY_WRAP_SECRET, eine bediente Domain, keinerlei Identität), es sei denn,X-Pepsi-Sign: nohat die Signatur abgelehnt. Keiner dieser Werte ist eine Garantie: Ein Autor, den diese Installation nicht bedient, wird unsigniert gesendet statt gebounct. Eine Nachricht, die der einliefernde Client bereits signiert hat, erhält von Pepsi keine zweite Signatur, und eine, die der Client bereits verschlüsselt hat, bleibt vollständig unangetastet.- ENCRYPT
(``no`` | ``opportunistic`` | ``required``, optional) Standardwert
opportunistic: an einen Empfänger verschlüsseln, für den wir einen brauchbaren Schlüssel haben, und gewöhnliche Mail an einen senden, für den wir keinen haben.requiredbedeutet, dass ein Empfänger ohne brauchbaren Schlüssel den sicheren Link oder einen Bounce bekommt, nie Klartext.- PREFER
(``openpgp`` | ``smime``, optional) Zu welchem Protokoll gegriffen wird, wenn ein Korrespondent verwendbare Schlüssel beider Protokolle auf derselben Sprosse der Vertrauensleiter hat. Ein besser eingestufter Schlüssel des anderen Protokolls gewinnt immer, sodass ein aus unsignierter Mail geernteter Schlüssel nie ein Zertifikat des anderen Protokolls aus einem Verzeichnis, aus DANE, vom Betreiber oder aus einer authentifizierten Nachricht übersteuert. Standardwert
openpgp;pgpwird als Synonym dafür akzeptiert.- ON_NO_KEY
(``cleartext`` | ``secure-link`` | ``bounce``, optional) Was mit einem Empfänger ohne brauchbaren Schlüssel geschieht. Standardwert aus ENCRYPT:
cleartextfürno/opportunistic, und fürrequiredentwedersecure-link(wennSECURE_LINK_STAGEgesetzt ist) oderbounce. Es ausdrücklich zu setzen überschreibt das — außer dass eine Nachricht, deren eigene Anfrage die Richtlinie aufrequiredangehoben hat, nie aufcleartextzurückfällt.Vorsicht
ON_NO_KEY = cleartextzusammen mit[pepsi] CRYPTO_ALLOW_DOWNGRADE = nosendet einem Korrespondenten, der keinen authentifizierten Container lesen kann, Klartext. Das ist strikt schlimmer als das SEIPDv1+MDC oder AES-256-CBC-EnvelopedData, das die Option vermeiden sollte. Der größte Teil der installierten OpenPGP-Basis (GnuPG 2.4 und älter) ist in dieser Lage, ebenso jeder S/MIME-Korrespondent, dessen Fähigkeitsdatensatz sagt, dass erAuthEnvelopedDatanicht lesen kann. pepsi-setup(1) warnt vor dem Paar. Belassen Sie die Option auf ihrem Standardwertnegotiate, der herabstuft statt abzulehnen, und nur, wenn der eigene Schlüssel (OpenPGP) oder Fähigkeitsdatensatz (S/MIME) des Empfängers zeigt, dass es sein muss.- ON_OVERSIZE
(``cleartext`` | ``secure-link`` | ``bounce``, optional) Was mit einer Nachricht geschieht, die größer als
MAX_SIZEist. Standardwert genau wie beiON_NO_KEY, sodassrequirednicht zu Klartext wird, weil ein Anhang groß war.- PADDING
(boolesch, optional) Was diese Stage verschlüsselt, auf eine Padmé-Länge auffüllen, sodass die Größe des Chiffrats weniger über die Nachricht verrät: Ein Beobachter erfährt die Länge nur bis auf einen Bereich genau, der mit ihr wächst, mit höchstens 12 % Mehraufwand. Innerhalb eines SEIPDv2-Containers ist dies ein Padding-Paket nach RFC 9580 nach der Signatur; SEIPDv1 und S/MIME, die kein Padding haben, das ein Leser überspringt, tragen stattdessen ein
Pepsi-Padding:-Füll-Header-Feld an der verschlüsselten MIME-Entität. Standardwertyes. Schalten Sie es nur für einen Leser ab, für den gemessen wurde, dass er eines von beiden falsch behandelt.- MAX_SIZE
(Zahl, optional) Die größte Nachricht, in Bytes, die diese Stage verschlüsselt. Standardwert
25000000(25 MB). Weder der CMS-Builder noch die OpenPGP-Pfade streamen, sodass die ganze Nachricht während der Verschlüsselung resident ist, einmal je Empfänger; eine sichtbare Obergrenze hält den Speicherbedarf jedes Workers vorhersagbar, stattPARALLELISMWorker je eine mehrere hundert Megabyte große Nachricht halten zu lassen.- MIN_TRUST
(``own`` | ``manual`` | ``dane`` | ``wkd-advanced`` | ``wkd-direct`` | ``ldap`` | ``vks`` | ``owner-confirmed`` | ``inbound-signed`` | ``harvested`` | ``gossip`` | ``any``, optional) Die am niedrigsten eingestufte Schlüsselquelle, an die diese Stage verschlüsselt. Standardwert ist
[pepsi-keydiscovery] MIN_TRUST, sodass eine Installation eine Untergrenze hat, sofern sie nicht bewusst zwei will. Siehe Der Abschnitt [pepsi-keydiscovery] für die Einstufung, dafür, warum die Standarduntergrenze alles annimmt, und für den Unterschied zwischenharvestedundgossip.- SUBJECT_KEYWORDS_SIGN, SUBJECT_KEYWORDS_ENCRYPT, SUBJECT_KEYWORDS_BOTH
(kommagetrennte Liste, optional) Schlüsselwörter, die ein Absender irgendwo im
Subjectplatzieren darf, um Schutz zu erbitten. Standardwerte[sign],[encrypt]und[secure]. Ohne Beachtung der Groß-/Kleinschreibung abgeglichen; das getroffene Schlüsselwort wird aus dem ausgehendenSubjectentfernt. Ein Verschlüsselungs-Schlüsselwort hebt die Richtlinie für diese Nachricht aufrequiredan — eine bewusste menschliche Bitte als „versuchen und stillschweigend aufgeben“ zu lesen machte die Funktion zur Lüge. Kommas, nicht Leerzeichen, trennen die Liste, denn ein Schlüsselwort darf rechtmäßig ein Leerzeichen enthalten.- STRIP_REQUEST_HEADERS
(boolesch, optional) Jedes
X-Pepsi-*-Feld aus der ausgehenden Nachricht entfernen. StandardwertYES. Die zwei Header, auf die diese Stage reagiert (X-Pepsi-Sign,X-Pepsi-Encrypt), werden bedingungslos entfernt, was auch immer diese Option sagt: Ein Steuerkanal, der auf die Leitung überlebt, ist einer, dem der nächste Hop zu gehorchen aufgetragen werden kann. Diese Option entscheidet nur über das Schicksal der übrigenX-Pepsi-*-Felder, die ein Add-in hinzugefügt haben mag.Pepsi-Originliegt nicht in diesem Namensraum und wird nie angetastet.- PROTECT_HEADERS
(boolesch, optional) Die Header-Felder nach RFC 5322 (
From,Sender,To,Cc,Reply-To,Subject,Date,Message-ID,In-Reply-To,References; nieBcc) mit einemprotected-headers="v1"-Parameter in den geschützten Teil kopieren (injizierte Header nach RFC 9788) und bei einer verschlüsselten Nachricht das äußereSubjectdurch...ersetzen (so implementiert es Thunderbird für PGP/MIME); eine nur signierte Nachricht behält ihr äußeresSubject. Das geschützteFrom:lässt pepsi-stage-decrypt(1) auf der Empfangsseite eine unter einem anderen Autor erneut gesendete signierte Nachricht bemerken, und die geschütztenTo:undCc:stellen die Empfänger für einen Client, der Pepsis eigenes Empfängerattribut nicht liest, in die Signatur. StandardwertNO: Der Betreff einer verschlüsselten Nachricht lautet...in einem Client, der nicht in den geschützten Teil schauen kann.- AUTOCRYPT
(boolesch, optional) Den eigenen OpenPGP-Schlüssel des
From:-Autors in einemAutocrypt:-Header ankündigen. StandardwertYES, und auf jeder lokal eingelieferten Nachricht — signiert, verschlüsselt oder schlichter Klartext —, denn ein Korrespondent muss den Schlüssel aus gewöhnlicher Mail lernen, bevor es etwas zu verschlüsseln gibt.Der Schlüssel wird auf die minimale Fünf-Paket-Form von Autocrypt Level 1 §2.1.1 reduziert. Nur OpenPGP wird angekündigt (Autocrypt hat keine S/MIME-Form), nur für eine Identität, die ihr privates Material noch hält, und nie auf einer Nachricht, die bereits ein
Autocrypt:-Feld trägt: Der eigene Header eines echten Clients benennt den Schlüssel, mit dem er entschlüsseln kann, und ein zweites Feld lässt Level-1-Parser beide verwerfen.prefer-encrypt=mutualwird nur beansprucht, wenn das effektiveENCRYPTrequiredist; siehe pepsi-stage-encrypt(1).Nichts wird angekündigt, wenn das öffentliche Gesicht der Adresse der eigene MUA-Schlüssel des Benutzers ist (
custody = client), oder bei einer Nachricht, die der Client bereits verschlüsselt hat: Der Mail-Client kündigt seinen eigenen Schlüssel an.Schalten Sie es aus, um die Schlüsselveröffentlichung auf das Web Key Directory und DNS zu beschränken, was eine vertretbare Wahl für eine Installation ist, die nicht möchte, dass die Schlüssel ihrer Benutzer auf jeder Nachricht mitreisen, die sie senden.
- ATTACH_KEYS_AS_FILES
(boolesch, optional) Hängt den öffentlichen Schlüssel des Absenders zusätzlich zum
Autocrypt:-Header auch alsapplication/pgp-keys-Datei namensOpenPGP_0x<long key ID>.ascan, auf die klassische OpenPGP-Weise. StandardwertNO, unabhängig vonENABLE_PEP; ein Betreiber, der nur die Datei will, setzt zusätzlichAUTOCRYPT = no.Bei einer verschlüsselten Nachricht kommt die Datei in das Chiffrat; bei Klartext wird die Nachricht in ein
multipart/mixedverpackt (oder der Schlüssel einem vorhandenen hinzugefügt). Sie wird angehängt, bis jeder Empfänger nachweislich den Schlüssel besitzt – er hat eine an ihn verschlüsselte und von ihm signierte Nachricht zurückgeschickt, festgehalten inpepsi.peer_has_own_key–, und beginnt für einen neuen Schlüssel von vorn. Nie, wenn das öffentliche Gesicht der eigene MUA-Schlüssel des Benutzers ist, nie bei Mail, die der Client verschlüsselt hat, und nicht bei Klartext, den der Client signiert hat.- KEYS_CONTROL_LOCAL_PART
(Zeichenkette, optional) Lokaler Teil der Adresse, unter der ein Benutzer seine eigenen Schlüssel per E-Mail verwaltet: Eine lokal eingelieferte Nachricht, deren einziger Empfänger
<KEYS_CONTROL_LOCAL_PART>@<served domain>ist, ist ein Befehl (status,generate,register,publish [FPR],retire FPR,pin FPR,otp enroll,otp confirm CODE,otp removeimSubject:), der verbraucht und beiRESPONSE_STAGEbeantwortet wird. Jeder Befehl außerstatuswird unter einem Antwort- oder Weiterleitungspräfix (Re:,Fwd:,AW:, …) abgelehnt. Standardwertpepsi-keys;noneschaltet diese Schnittstelle ab. BenötigtRESPONSE_STAGE.- OTP_CONFIRM_WINDOW
(Dauer, optional) Wie lange ein per E-Mail eingerichteter zweiter Faktor (
otp enroll) darauf wartet, dass sein Inhaber ihn mit einem Code bestätigt (otp confirm), bevor er verfällt; bis dahin bleibt ein bereits geltender zweiter Faktor in Kraft. DerExpires:-Header der Registrierungsantwort nennt das Ende dieses Fensters. Standardwert1h.- RESPONSE_STAGE
(Stage-Name, optional) Wohin die Antworten auf die E-Mail-Schlüsselbefehle und die Hinweise „für Ihre Adresse wurde ein neuer Schlüssel registriert“ als neue Nachrichten mit Null-Absender injiziert werden. Normalerweise die ausgehende DKIM-Signier-Stage, die pepsi-setup –wizard schreibt (
dkim-sign). Nicht gesetzt bedeutet keine Hinweise und keine E-Mail-Befehle (Steuermail wird dann wie jede andere Nachricht weitergesendet); pepsi-setup(1) warnt davor, lehnt einen Namen ab, der keine Stage ist, und verlangt die Rückfallvorlagenkey-registered.en.bodyundkeys.en.body, wenn die Option gesetzt ist.- AUTOCRYPT_GOSSIP
(boolesch, optional) Die OpenPGP-Schlüssel der anderen Empfänger in
Autocrypt-Gossip:-Feldern ankündigen (Autocrypt Level 1 §5.3), sodass zwei Korrespondenten, die einander nie geschrieben haben, einander nach einer Nachricht dennoch verschlüsselt antworten können. StandardwertNO.Standardmäßig aus, weil es nicht dieselbe Art von Handlung ist wie
AUTOCRYPT: Jenes veröffentlicht einen Schlüssel, dessen Eigentümer diese Installation gebeten hat, ihn zu halten, während dieses die Schlüssel Dritter, also hier bloß zwischengespeichertes Material, an Korrespondenten weiterverteilt, die nicht danach gefragt haben.Es gilt nur für eine Nachricht, die diese Stage tatsächlich verschlüsselt, und die Felder gehen in das Chiffrat, nie auf den äußeren Header-Block: Ihr ganzer Zweck ist, die Empfänger einander vorzustellen, ohne die Empfängermenge dem Netz preiszugeben. Es gibt daher kein Gossip beim Klartext-Durchreichen, bei einer signierten, aber unverschlüsselten Nachricht oder bei einem S/MIME-Container (Autocrypt ist über OpenPGP definiert und hat keine S/MIME-Form). Ein Feld wird je eingeführtem Empfänger ausgegeben (anders als bei
Autocrypt:, wo ein zweites Feld einen Level-1-Parser die Nachricht verwerfen lässt), undprefer-encrypterscheint nie, da es die eigene Richtlinie des Absenders angibt und dieses Feld für jemand anderen spricht.Warnung
Blindkopien werden nie gegossipt. Die angekündigten Adressen werden aus den geparsten
To:- undCc:-Feldern der Nachricht gelesen und aus nichts sonst; die Umschlagempfängerliste wird nur herangezogen, um eine Adresse aus der Menge zu entfernen. EinBcc-Empfänger steht auf dem Umschlag und in keinem der beiden Felder, sodass keine Kopie der Nachricht einen Header tragen kann, der ihn benennt. Auf diese Eigenschaft kann man sich verlassen, denn ein Gossip-Header für einen blinden Empfänger sagte jedem anderen Empfänger, dass ein verborgener existiert und wer er ist. Das gilt auch, wenn einBcc:-Feld von einem defekten einliefernden Client auf der Nachricht belassen wurde, denn das Feld wird nicht gelesen.Die Umkehrung ist Absicht: Die eigene Kopie eines blinden Empfängers trägt sehr wohl Gossip über die
To:/Cc:-Empfänger. Er hat jene Header-Felder wie alle anderen erhalten, sodass es nichts offenlegt, was er nicht ohnehin lesen kann, und es ist das, was ihn verschlüsselt antworten lässt.Ein Empfänger, für den diese Installation keinen zwischengespeicherten Schlüssel hält, wird schlicht ausgelassen: Die Stage betreibt keine Schlüsselentdeckung in seinem Namen und verzögert nie eine Nachricht, um den Schlüssel eines Dritten zu holen. Eine Nachricht mit mehr als 50 sichtbaren Empfängern bekommt überhaupt kein Gossip: In dieser Größe ist sie eine Rundsendung statt eines Gesprächs, jeder eingeführte Schlüssel wird im Chiffrat jedes Empfängers wiederholt, und eine beliebige Teilmenge einzuführen wäre schlimmer, als keine einzuführen.
- GOSSIP_MIN_TRUST
(``own`` | ``manual`` | ``dane`` | ``wkd-advanced`` | ``wkd-direct`` | ``ldap`` | ``vks`` | ``owner-confirmed`` | ``inbound-signed`` | ``harvested`` | ``gossip`` | ``any``, optional) Die am niedrigsten eingestufte Schlüsselquelle, deren Schlüssel in einem
Autocrypt-Gossip:-Feld weiterveröffentlicht werden darf. Standardwertowner-confirmed— die schwächste Sprosse, auf der jemand, der zu der Adresse berechtigt ist, einen bewussten Schritt getan hat, den Schlüssel zu veröffentlichen.Es ist eine echte Verschärfung gegenüber
MIN_TRUST, und das mit Absicht: An einen Schlüssel mit Vertrauen beim ersten Gebrauch zu verschlüsseln ist ein guter Tausch, denn die Alternative ist Klartext, aber diesen Schlüssel an Dritte weiterzugeben ist eine andere Handlung. Jeder, der einen gegossipten Schlüssel empfängt, speichert ihn auf einer Sprosse, die er nach unserem Wort beurteilt und nicht danach, wie wir den Schlüssel bekommen haben; wer eine Vermutung weitergibt, macht sie daher zu etwas, das wie Wissen aussieht.Die tatsächlich angewandte Untergrenze ist die strengere von dieser und
MIN_TRUST: Einen Korrespondenten an einen Schlüssel heranzuführen, an den diese Stage selbst nicht verschlüsseln würde, hieße etwas zu empfehlen, das sie abgelehnt hat. Eine der beiden Optionen anzuheben verschärft also das Gossip, eine von beiden zu senken kann es nicht über die andere hinaus lockern, und ein Betreiber, derMIN_TRUSThärtet, muss sich nicht merken, dass eine zweite Option existiert.GOSSIP_MIN_TRUST = anygossipt jeden Schlüssel, an den verschlüsselt werden darf. Ohne Wirkung, sofernAUTOCRYPT_GOSSIPnicht an ist.- SECURE_LINK_STAGE
(Stage-Name, optional) Wohin ein Empfänger geschickt wird, der den
secure-link-Weg nimmt. Erforderlich, wennON_NO_KEY/ON_OVERSIZEaufsecure-linkauflöst.- DISCOVERY
(boolesch, optional) Ob ein Cache-Fehltreffer eine Netzabfrage auslösen darf; dokumentiert unter Der Schalter je Absender: [stage-encrypt] DISCOVERY.
- DISCOVERY_TIMEOUT
(zeitlich, optional) Überschreibt
[pepsi-keydiscovery] TIMEOUTfür die Nachrichten, die diese Stage parkt. Beachten Sie, dassSection::duration()Kalendereinheiten ablehnt:90 sund2 hparsen,1 dnicht.- SUBJECT_KEYWORDS_CLEAR_OK
(durch Kommas getrennte Liste, optional) Schlüsselwörter, mit denen ein lokaler Absender Klartext für einen Empfänger akzeptiert, dessen Schlüsselabfrage im DNS fehlschlug (siehe „DNS-Fehlschläge bei Empfängern“ in pepsi-stage-encrypt(1)). Standardwert
[clear-ok]. Wie die anderen Schlüsselwörter abgeglichen und entfernt, nur fürstate.local_origin-Mail beachtet, und es schwächt nieENCRYPT = required.- CLEAR_ON_DNS_FAILURE
(boolesch, optional) Dieselbe Zustimmung als dauerhafte Einstellung, normalerweise je Absender über
pepsi.settingsgegeben. StandardwertNO: Ein Empfänger, dessen Domain-DNS nicht antwortet, wird aufgeschoben und beiMAX_LIFETIMEals Bounce zurückgewiesen, und einer, dessen Schlüsseleinträge weiter fehlschlagen, während die Domain antwortet, geht zuSECURE_LINK_STAGEoder wird als Bounce zurückgewiesen, statt im Klartext gesendet zu werden.- DELAY_DSN_AFTER
(Dauer, optional) Während eine Nachricht wegen eines DNS-Fehlschlags eines Empfängers aufgeschoben ist, ihrem Absender eine „delayed“-DSN senden, sobald sie so lange gewartet hat, aber nur, wenn der Absender
NOTIFY=DELAYangefordert hat und einBOUNCE_STAGEgesetzt ist. Standardwert4 h.- NOTIFY_CLEARTEXT
(``no`` | ``author``, optional) Ob der Autor einer lokal eingelieferten Nachricht informiert wird, wenn sie unverschlüsselt hinausging, obwohl Verschlüsselung gewünscht war: ein Empfänger ohne verwendbaren Schlüssel unter
ON_NO_KEY = cleartextoder eine Nachricht überMAX_SIZEunterON_OVERSIZE = cleartext. Mitauthorspeist die Stage je solcher Kopie eine Benachrichtigung beiRESPONSE_STAGEein (Null-Absender, an dieFrom:-Adresse), die die Empfänger und den Grund nennt; nie für eine Nachricht mit Null-Absender oder einen Listenbeitrag. Die Empfänger ohne Schlüssel einer Nachricht teilen sich eine Kopie, also teilen sie sich eine Benachrichtigung. Standardwertno; normalerweise je Absender überpepsi.settingseingeschaltet. Hier gesetzt, braucht esRESPONSE_STAGE(der Worker verweigert ohne es den Start). Vorlagencleartext-notice.<lang>.body. Unabhängig von dieser Option wird ein Betreff, der mit etwas beginnt, das eines derSUBJECT_KEYWORDS_*knapp verfehlt (ein Tippfehler, ein Doppelgänger-Buchstabe,[encrypted]), beiRESPONSE_STAGEmit einer Warnung beantwortet, die das Schlüsselwort nennt, dem er ähnelte (keyword-near-miss.<lang>.body).- NOTICE_SIGNER
(E-Mail-Adresse, optional) Die Identität, die jede Nachricht signiert, die Pepsi selbst verfasst hat, also die Datensätze mit
state.notice(siehe pepsi.state(7)): Anmelde- und Portal-Links, Secretary-Challenges, Zahlungsaufforderungen, Befehlsantworten, Schlüsselwechsel- und Abwesenheitsbenachrichtigungen. Nur signiert, nie verschlüsselt, im erstenPREFER-Protokoll, das die Identität hat, und mitFrom:dieser Adresse gesendet (das vorherigeFrom:wird zuReply-To:, sofern die Benachrichtigung keines gesetzt hat). Nicht gesetzt (der Standard): Solche Nachrichten nehmen den gewöhnlichen Pfad der Stage, der an Mail ohnelocal_originnichts ändert. Nur aus der Konfigurationsdatei gelesen, nie überpepsi.settings. Braucht[pepsi-crypto] KEY_WRAP_SECRET(der Worker verweigert ohne es den Start) und eine mit pepsi-keys(1)identity generateerstellte Identität, bei einer bedienten Domain, damit das Web Key Directory sie veröffentlicht; ohne eine warten die Benachrichtigungen und werden erneut versucht. Normalerweise in einem eigenen Stage-Abschnitt gesetzt, auf den die Programme, die Benachrichtigungen erzeugen, mit ihren OptionenRESPONSE_STAGE,BLOCK_RESPONSE_STAGE,[pepsi-admin] ENROL_STAGEund[pepsi-secure-link] NOTIFY_STAGEzeigen; siehe „Pepsis eigene Benachrichtigungen signieren“ in pepsi-stage-encrypt(1).
Eine Autorenidentität, die diese Stage erzeugt oder registriert, wird über LOCAL_DOMAINS, TARGETS und RECIPIENT_DELIMITER von [pepsi-crypto] einem passwd-Login zugeordnet, so wie pepsi-keys(1) eine zuordnet, sodass die Eigentumsregel von Der Abschnitt [pepsi-crypto] nicht davon abhängt, welches Programm den Schlüssel erzeugt hat. Eine Adresse, die zu keinem lokalen Konto auflöst, ist ein legitimer Zustand (eine Rollenadresse oder eine gehostete Domain), kein Fehlschlag. [pepsi-crypto] AUTO_CREATE_IDENTITY entscheidet, ob überhaupt eine Identität erzeugt werden darf, und die Erzeugung wird nur für einen Autor in einer [pepsi-ingress] ACCEPTED_DOMAINS-Domain angeboten.
Das Binärprogramm wird setuid pepsi-crypto installiert, Modus 4750 pepsi-crypto:pepsi, denn es muss die eine Datenbankrolle sein, der crypto_identity.private_wrapped gewährt ist (die Peer-Authentifizierung richtet sich nach der effektiven uid), und es muss das 0640-Fragment lesen, das den Schlüsselverschlüsselungsschlüssel (KEK) enthält und demselben Konto gehört. Siehe pepsi-stage-encrypt(1).
95.2.1.1.22.4. pepsi-stage-decrypt-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-decrypt entschlüsselt Mail, die an von diesem Host bediente Empfänger gerichtet ist, und verifiziert, welche Signatur sie auch trägt. Sie liest, neben einem erforderlichen NEXT_STAGE und einem optionalen BOUNCE_STAGE:
- ENABLED
(boolesch, optional) Ob überhaupt Kryptographie betrieben wird. Standardwert
YES.NOentfernt weiterhin denX-Pepsi-*-Header-Namensraum aus eingehender Mail: Eine deaktivierte Stage darf nicht zum Kanal für einen gefälschten Indikator werden.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(optional) Welche Empfänger dieser Host bedient — dieselben Optionen, mit denselben Standardwerten, wie pepsi-stage-relay-to-maildir(1) und pepsi-stage-dot-forward(1).
LOCAL_DOMAINSfällt auf[pepsi-ingress] ACCEPTED_DOMAINSzurück.- REQUIRE_ACCOUNT
(boolesch, optional) Ob ein lokaler Empfänger zusätzlich zu einem von
TARGETSerlaubten passwd-Konto auflösen muss. StandardwertNO, was der Unterschied zu den Zustell-Stages ist: Sie müssen wissen, wessen Postfach zu schreiben ist, während diese Stage nur wissen muss, ob die Nachricht uns gehört. Eine gehostete Domain, deren Benutzer Krypto-Identitäten, aber keine Shell-Konten halten, ist eine gewöhnliche Installation.- ON_DECRYPT_FAILURE
(``passthrough`` | ``quarantine`` | ``bounce-if-unproblematic``, Alias ``bounce``, optional) Was mit einer Nachricht zu tun ist, die dieser Host nicht öffnen konnte. Standardwert
passthrough: Der Benutzer hält den Schlüssel womöglich in seinem eigenen Client, und für Mail, die wir bloß nicht öffnen konnten, einen Bounce zu erzeugen, hilft niemandem.quarantinebrauchtQUARANTINE_STAGE;bounce-if-unproblematicbrauchtBOUNCE_STAGE.bounce-if-unproblematicerzeugt nur für eine Nachricht einen Bounce, deren fehlgeschlagenes Chiffrat integritätsgeschützt ist (OpenPGP, S/MIME-AuthEnvelopedData, beurteilt am Chiffrat selbst, nicht an seiner Bezeichnung), wo jede Veränderung gleich fehlschlägt, und seine Diagnose nennt keinen Grund (der Grund wird protokolliert). Jede andere fehlgeschlagene Nachricht wird verworfen, ohne eine Spur, die der Absender sehen könnte: Für eine AES-CBC-S/MIME-Nachricht, die keinen Integritätsschutz hat, wäre eine DSN ein Padding-Orakel (ein Angreifer, der ein Chiffrat abgefangen hat, sendet veränderte Kopien erneut und erfährt aus jeder DSN oder ihrem Ausbleiben, ob das veränderte Padding gültig war; etwa 2.000 solcher Nachrichten entschlüsseln einen 16-Byte-Block). Der Wertbounceist ein Alias für das längere, aber eindeutigebounce-if-unproblematic: Der Bounce wird nur bei Nachrichten gesendet, bei denen das CBC-Orakel nicht greift, weil die Nachricht nicht mit CBC verschlüsselt ist; der Worker und pepsi-setup(1) warnen, wenn die kurze Schreibweise verwendet wird. pepsi-stage-decrypt(1) erklärt die Wahl.- ON_BAD_SIGNATURE
(``record`` | ``quarantine`` | ``bounce``, optional) Was mit einer Nachricht zu tun ist, deren Signatur sich nicht verifizieren ließ. Standardwert
record: Mailinglisten, die Nachrichtentexte umschreiben, Weiterleiter und Clients mit defekter Kanonisierung erzeugen alle schlechte Signaturen auf völlig legitimer Mail. Nur dasinvalid-Urteil zählt hier als schlecht —valid-untrustedundunverifiablesind der Normalzustand von Mail eines unbekannten Korrespondenten und werden nie geroutet.bouncebrauchtBOUNCE_STAGEund verwirft eine Nachricht, deren Signatur aus einem S/MIME-EnvelopedData-Container stammt, statt einen Bounce zu erzeugen: Ob ein verändertes CBC-Chiffrat einen Klartext ergibt, der signiert aussieht, hängt von seinem Padding ab.- ON_MISSING_SIGNATURE
(``record`` | ``tag`` | ``quarantine``, optional) Was mit einer Nachricht zu tun ist, die ohne
valid-Signatur ankommt (unsigniert,unverifiable,valid-untrustedoderpartial) von einerFrom:-Adresse, deren Mail innerhalb der letztenMISSING_SIGNATURE_WINDOW_DAYSeinevalid-Signatur mit einem verankerten Schlüssel trug. Die Stage hält je Adresse fest, wann eine solche Signatur zuletzt verifiziert wurde (pepsi.signed_sender); ein gefälschtesFrom:eines Korrespondenten, der immer signiert, fällt dann auf, auch wo DMARC nicht durchgesetzt wird. Standardwertrecord: Die Tatsache geht inX-Pepsi-Crypto(usually-signed=<date>) undstate.crypto.in.usually_signed, für Sieve-Regeln und die Client-Erweiterungen, und sonst ändert sich nichts, weil ein Korrespondent, der von einem Telefon oder einem neuen Client schreibt, genau diese Form erzeugt.tagstellt zusätzlichTAG_MISSING_SIGNATUREdemSubjectvoran;quarantineleitet die Nachricht zuQUARANTINE_STAGE.ON_BAD_SIGNATUREbehandelt eineinvalid-Signatur, und eine Nachricht, die hier nicht geöffnet wurde (ein Entschlüsselungsfehler, Mail für den eigenen Client-Schlüssel des Benutzers), wird nicht beurteilt.- MISSING_SIGNATURE_WINDOW_DAYS
(ganzzahlig, optional) Wie lange, in Tagen, eine
valid-Signatur einer Adresse deren unsignierte Mail auffallen lässt (ON_MISSING_SIGNATURE). Standardwert90.0schaltet die Prüfung ab; Signaturen werden weiterhin festgehalten.- MAX_SIGNATURE_AGE_DAYS
(ganzzahlig, optional) Wie viele Tage vor dem Eintreffen der Nachricht eine Signatur erstellt worden sein darf, um noch
validzu erhalten. Eine früher oder mehr als einen Tag nach dem Eintreffen erstellte Signatur verifiziert, wird aber alsvalid-untrustedgemeldet (withheld=old-signature/future-signature): keine[verified]-Markierung, keinstate.signature_verified. Das erfasst eine abgefangene signierte Nachricht, die unter frischen äußeren Headern wiedereingespielt wird. Die Ankunftszeit ist die, die dieser Host festgehalten hat, nie das vom Absender geschriebeneDate:; eine Signatur ohne Erstellungszeit (CMS ohnesigningTime) wird nicht beurteilt. Standardwert7;0schaltet die Prüfung ab. Eine Installation, deren Mail oft verspätet zugestellt wird (eine moderierte Liste, ein erneut eingespeistes Archiv), erhöht ihn.- UNAUTHENTICATED_PLAINTEXT
(``text`` | ``require-signature`` | ``open``, optional) Was aus einem Klartext wird, der aus einem S/MIME-
EnvelopedData-Container gewonnen wurde (AES-CBC oder 3DES, wo[pepsi] CRYPTO_ALLOW_DOWNGRADEes zulässt), wenn ihn keine gültige Signatur innerhalb des Containers abdeckt. Ein solches Chiffrat hat keinen Integritätsschutz: Wer eine Kopie hält, kann seinen Klartext Block für Block (die CBC-Gadgets von EFAIL) in HTML umschreiben, das den Rest des Klartexts an seinen Server sendet, sobald ein Client es darstellt. Standardwerttext: Der Klartext wird zugestellt, wobei jeder Teil, den ein Client als Markup darstellen würde (text/html,text/enriched, XHTML, auch innerhalb angehängter Nachrichten), alstext/plainneu bezeichnet wird, einmultipart/alternativeauf seine Klartextalternative reduziert wird und dasSubjectmitTAG_UNAUTHENTICATEDanstelle vonTAG_DECRYPTEDmarkiert wird; der Text kommt an, nichts wird dargestellt, und die HTML-Formatierung solcher Mail geht verloren.require-signaturereicht eine solche Nachricht ungeöffnet, weiterhin verschlüsselt, für den eigenen Mail-Client des Benutzers weiter, der dann den S/MIME-Container sieht und seine eigenen EFAIL-Abwehrmaßnahmen anwendet; unsignierte CBC-Mail an einen Benutzer ohne Client-Schlüssel kommt unlesbar an. Es ist kein Entschlüsselungsfehler:ON_DECRYPT_FAILUREwird nicht herangezogen.openstellt den Klartext so zu, wie er aus dem Container kam, Markup eingeschlossen, gleichwohl markiert. Eine Signatur über den Klartext zählt, gleich was ihr Schlüssel wert ist (validodervalid-untrusted); eine um das Chiffrat herum nicht, da ein Angreifer ein umgeschriebenes Chiffrat mit einem eigenen Schlüssel neu signiert. Inhalt aus einem AEAD-Container (AuthEnvelopedData, jeder OpenPGP-Container, den Pepsi akzeptiert) ist nie betroffen. Siehe pepsi-stage-decrypt(1).- OPEN_ENVELOPED_DATA
(boolesch, optional) Ob S/MIME-
EnvelopedData(AES-CBC, 3DES) überhaupt geöffnet wird. StandardwertYES: Die meisten S/MIME-Clients senden nichts anderes.NOreicht jede solche Nachricht ungeöffnet für den eigenen Mail-Client des Benutzers weiter, wierequire-signaturees mit einer unsignierten tut, ohne einen privaten Schlüssel auf sie anzuwenden: Der Algorithmusbezeichner des Containers ist nicht authentifiziert, daher kann der Inhaltsschlüssel einer abgefangenen AES-GCM-Nachricht, die ohne Schlüsselableitung nach RFC 9709 gesendet wurde, unter einem synthetischen AES-CBC-Container erneut eingereicht werden, und mit dieser Option aus wird er nie auf einen solchen angewendet. Das ist kein Entschlüsselungsfehler:ON_DECRYPT_FAILUREwird nicht herangezogen. Ein Container mitid-alg-cek-hkdf-sha256nach RFC 9709 ist konstruktionsbedingt schlüsselgetrennt, ist aber weiterhin einEnvelopedDataund bleibt ebenfalls ungeöffnet. Setzen Sie es je Empfängeradresse oder Domain mit eineraddress:/domain:-Überlagerung (pepsi-config(1)), um CBC den Clients von Benutzern zu überlassen, deren KorrespondentenAuthEnvelopedDatasenden.- DECRYPTED_MARKUP
(``keep`` | ``text``, optional) Was aus Markup in einem Klartext wird, den diese Stage entschlüsselt hat, wenn
UNAUTHENTICATED_PLAINTEXTihn nicht bereits reduziert hat. Standardwertkeep: Der Klartext wird so zugestellt, wie er aus einem authentifizierten Container kam, HTML eingeschlossen, und entfernte Inhalte darin bleiben den eigenen Einstellungen des Clients überlassen (siehe das Kapitel des Handbuchs über Mail-Clients).textbezeichnet jeden Markup-Teil genau so alstext/plainneu, wie esUNAUTHENTICATED_PLAINTEXT = texttut (sanitised=textinX-Pepsi-Crypto), sodass kein Client für eine entschlüsselte Nachricht entfernte Inhalte abruft, um den Preis ihrer Formatierung; eine Signatur über einen neu bezeichneten Teil verifiziert im Client nicht.- QUARANTINE_STAGE
(Stage-Name, optional) Wohin ein
quarantine-Weg führt. Erforderlich, wenn eine der obigen Richtlinien aufquarantinegesetzt ist.- SUBJECT_TAGS
(boolesch, optional) Die erworbenen Tags in Verschachtelungsreihenfolge dem
Subjectvoranstellen:encrypted(signed(body))ergibt[decrypted][verified] …undsigned(encrypted(body))ergäbe[verified][decrypted] …. StandardwertYES: Für die meisten Benutzer ist dies das einzige Signal, das sie je sehen werden. Der Preis ist ein verändertes benutzersichtbares Feld, was Suche, Threading und zitierte Betreffs in Antworten betrifft. (Beide Gestalten gehen auf. Die zweite erwirbt[verified]nur aus einer Signatur innerhalb des Chiffrats: Eine äußere Signatur deckt Chiffrat ab und erreicht nie dasvalid-Urteil, für das der Tag geschrieben wird; siehe pepsi-stage-decrypt(1).)- TAG_DECRYPTED, TAG_VERIFIED, TAG_UNAUTHENTICATED
(Zeichenkette, optional) Der Wortlaut der Markierungen. Standardwerte
[decrypted],[verified]und[decrypted, unauthenticated];noneschreibt keine Markierung (ein leerer Wert gilt als nicht gesetzt).TAG_VERIFIEDwird nur für das Urteilvalidgeschrieben, und die Adresse, an die der Signierer gebunden ist, steht innerhalb seiner schließenden Klammer ([verified: alice@example.org]; eine Schreibweise ohne schließende Klammer erhält die Adresse nach einem Doppelpunkt angehängt);TAG_UNAUTHENTICATEDersetztTAG_DECRYPTEDbei einem Klartext aus einem Container ohne Integritätsschutz, den keine Signatur abdeckt (UNAUTHENTICATED_PLAINTEXT).- TAG_VERIFIED_EXCEPT_REPLY_TO
(Zeichenkette, optional) Wird statt
TAG_VERIFIEDgeschrieben, wenn die Signaturvalidist, aber das äußereReply-To:von einer Mailingliste hinzugefügt wurde (List-Idvorhanden, kein signiertesReply-To:) und von nichts abgedeckt wird. Standardwert[verified (except reply-to)], die Adresse darin wie oben.- TAG_BAD_SIGNATURE
(Zeichenkette, optional) Die Markierung für das Urteil
invalidbei einer Signatur außerhalb eines Chiffrats. Standardmäßig leer: Eine schlechte Signatur ist eine alltägliche Eigenschaft legitimer Mail, daher würde eine standardmäßig aktive Markierung einen großen Teil des Posteingangs eines Benutzers mit einer Anschuldigung versehen.- TAG_BAD_SIGNATURE_ENCRYPTED
(Zeichenkette, optional) Die Markierung für das Urteil
invalidbei einer Signatur innerhalb eines Chiffrats. Standardwert[bad signature]: Eine Mailingliste kann keinen Inhalt umschreiben, den sie nicht lesen kann, daher gilt der Grund, aus demTAG_BAD_SIGNATUREstandardmäßig leer ist, innerhalb eines Chiffrats nicht, und ein wiedereingespieltes Chiffrat läse sich sonst[decrypted], als käme es von seinem Signierer.noneschaltet sie ab (ein leerer Wert gilt als nicht gesetzt).- TAG_UNVERIFIED_SIGNER
(Zeichenkette, optional) Die Markierung für eine Signatur innerhalb eines Chiffrats, die einwandfrei, aber nicht
validist:valid-untrusted,unverifiableoderpartial. Standardwert[unverified signer], aus demselben Grund.noneschaltet sie ab. Außerhalb eines Chiffrats erhalten diese Urteile keine Markierung.- TAG_MISSING_SIGNATURE
(Zeichenkette, optional) Die Markierung, die
ON_MISSING_SIGNATURE = tageiner Nachricht von einer üblicherweise signierenden Adresse voranstellt, die ohnevalid-Signatur ankam. Standardwert[unsigned, usually signed].- STRIP_SUBJECT_TAGS
(boolesch, optional) Alles, was als Sicherheitsindikator angezeigt würde, vom Anfang eines eingehenden
Subjectentfernen, bevor unseres vorangestellt wird. StandardwertYES, und faktisch verpflichtend: Ohne es schreibt ein externer Absender einfach selbst[verified]. Das Vokabular wird aus denTAG_*-Optionen plus ihren eingebauten Standardwerten abgeleitet, die Adressform[verified: …]als Ganzes eingeschlossen, gleich wie lang die Adresse ist, sodass das Umbenennen einer Markierung das Loch nicht wieder öffnen kann, und der Vergleich erfolgt am dekodierten Betreff mit gefalteten Doppelgänger-Zeichen, sodass auch Encoded-Words, Klammern voller Breite, kyrillische Buchstaben und Zeichen mit Nullbreite keine Markierung verbergen. Jede führende eingeklammerte Gruppe, die eine Sicherheitseigenschaft nennt ([secure],(signature OK)), wird ebenfalls entfernt. pepsi-stage-decrypt(1) gibt die vollständige Regel an.- STRIP_SUBJECT_KEYWORDS
(kommagetrennte Liste, optional) Zusätzliche eingehende Betreff-Tags, die zu entfernen sind. Kommas statt Leerraum, denn ein Schlüsselwort darf ein Leerzeichen enthalten.
- ADD_RESULT_HEADER
(boolesch, optional) Den Ergebnis-Header
X-Pepsi-Cryptoeiner Nachricht hinzufügen, die Schutz trug. StandardwertYES. Seine Grammatik ist in pepsi-stage-decrypt(1) dokumentiert. JedesX-Pepsi-*-Feld wird zuvor aus eingehender Mail entfernt, bedingungslos und was auch immer diese Option sagt — diese Entfernung ist das, was den Header glaubwürdig macht.- ISOLATE_ENCRYPTED
(boolesch, optional) Trägt eine Nachricht Chiffrat neben anderem Inhalt, ihre erste verschlüsselte Einheit zur Nachricht machen und jeden anderen Teil in einen inerten Anhang verschieben (
application/octet-stream, Dispositionattachment), bevor irgendetwas entschlüsselt wird. StandardwertYES. Das vermeidet EFAIL-Direktexfiltration, sowohl durch diese Stage als auch durch den Client eines Empfängers, der die Nachricht selbst entschlüsselt. Verschobene Chiffrate werden ebenfalls in Anhänge geöffnet; neben einem signierten Klartext werden nur die mit demselben Schlüssel signierten behalten, und neben einem PGP/MIME- oder S/MIME-Container, der nicht geöffnet wird, werden die verschobenen Teile verworfen (siehe pepsi-stage-decrypt(1)). Abgeschaltet wird die Nachricht so zugestellt, wie sie ankam.- ISOLATE_SIGNED
(boolesch, optional) Trägt eine Nachricht ohne Chiffrat signierten Inhalt neben unsigniertem, sie auf ihre signierten Einheiten reduzieren. Standardwert
YES. Ein Signatururteil gilt dann für alles, was der Benutzer sieht. Abgeschaltet bleiben Mailinglisten-Fußzeilen, die außerhalb einer Signatur angehängt werden, erhalten, um den Preis, dass der Text eines Fremden neben einem gültig signierten Teil den Benutzer unter derselben[verified]-Markierung erreicht.- MAX_LAYERS
(ganzzahlig, optional) Wie viele verschachtelte verschlüsselte Schichten ausgepackt werden. Standardwert
4. Eine Nachricht mit mehr wird mit dem ungeöffneten Rest zugestellt.- TRUST_ANCHOR_TTL
(zeitlich, optional) Wie lange ein Worker-Prozess die zuletzt gelesenen
ca_trust-Anker wiederverwendet. Standardwert5 m. Ein hinzugefügter oder deaktivierter Anker wird innerhalb dieses Fensters wirksam; starten Sie die Worker neu, um ihn sofort anzuwenden. Kalendereinheiten werden abgelehnt (5 mund2 hparsen,1 dnicht).- DISCOVERY
(boolesch, optional) Ob ein Cache-Fehltreffer eine Netzabfrage auslösen darf; dokumentiert unter Der Schalter je Absender: [stage-encrypt] DISCOVERY. Von demselben Leser aus diesem Abschnitt gelesen, sodass die beiden Krypto-Stages sich über seinen Namen oder seinen Standardwert nicht uneinig sein können.
- DISCOVERY_TIMEOUT
(zeitlich, optional) Überschreibt
[pepsi-keydiscovery] INBOUND_TIMEOUTfür die Nachrichten, die diese Stage parkt.
[pepsi] CRYPTO_ALLOW_DOWNGRADE beschränkt diese Richtung nicht. OpenPGP-SEIPDv1+MDC und CMS-AES-CBC-EnvelopedData sind lesbar, was auch immer die Ausgaberichtlinie sagt (OPEN_ENVELOPED_DATA oben ist der eigene Schalter dieser Stage): Sie eingehend abzulehnen machte diesen Host unfähig, Mail aus dem größten Teil der Welt zu empfangen, während es niemanden schützte. Nur 3DES (und daneben OpenPGP-Blowfish) und die schwachen Signatur-Digests sind eingehend beschränkt, und jede Ablehnung erzeugt ihr eigenes Urteil. Was ein Klartext aus einem solchen Container nach dem Lesen darf, entscheidet UNAUTHENTICATED_PLAINTEXT.
Das Binärprogramm wird setuid pepsi-crypto installiert, Modus 4750 pepsi-crypto:pepsi, aus genau den Gründen, die oben für pepsi-stage-encrypt(1) genannt sind. Siehe pepsi-stage-decrypt(1).
95.2.1.1.22.5. pepsi-stage-reencrypt-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-reencrypt nimmt eine Nachricht, die die Decrypt-Stage geöffnet hat, und versiegelt sie vor der lokalen Zustellung für den eigenen Mail-Client-Schlüssel (MUA-Schlüssel) des Empfängers. Sie handelt nur bei Datensätzen, deren state.crypto.in besagt, dass die Nachricht verschlüsselt ankam und entschlüsselt wurde. NEXT_STAGE ist verpflichtend.
- ON_NO_CLIENT_KEY
(Zeichenkette, optional) Was mit einem lokalen Empfänger ohne verwendbaren MUA-Schlüssel geschieht:
plaintext(Standardwert) legt den Klartext ab;bounceweist die Nachricht über BOUNCE_STAGE mit einer5.7.5-DSN zurück, die nur die Adressierungs-Headerfelder und keinen Nachrichtentext trägt (RET=HDRSwird erzwungen). Eine Nachricht, die die Decrypt-Stage aus einem S/MIME-EnvelopedData-Container (ohne Integritätsschutz) geöffnet hat, wird stattdessen verworfen: Der Bounce ginge nur hinaus, weil sich das Chiffrat öffnen ließ, was bei einem veränderten AES-CBC-Chiffrat verrät, ob sein Padding gültig war.pepsi-setuplehntbounceohne BOUNCE_STAGE ab. Überschreibungen pro Empfänger überpepsi.settingsgelten.- PROTECT_HEADERS
(boolesch, optional) Kopiert die RFC-5322-Felder in das Chiffrat und ersetzt das äußere
Subjectdurch.... StandardwertNO, wie bei der Encrypt-Stage: Die Kopie ist für das Postfach, dessen Server nach dem äußeren Betreff auflistet und sucht.- ENABLED
(boolesch, optional) Ausgeschaltet reicht die Stage jede Nachricht durch. Standardwert
YES.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER, REQUIRE_ACCOUNT
Welche Empfänger hier bedient werden, wie bei pepsi-stage-decrypt-Optionen. Andere Empfänger werden weder versiegelt noch abgewiesen.
Der Container folgt [pepsi] CRYPTO_ALLOW_DOWNGRADE und dem S/MIME-Fähigkeitsdatensatz je Peer wie bei der ausgehenden Verschlüsselung. Das Binärprogramm ist unprivilegiert und in das Multi-Call-Binärprogramm pepsi eingefaltet: Es versiegelt für öffentliche Schlüssel und liest nur die öffentlichen Spalten von pepsi.crypto_identity. Siehe pepsi-stage-reencrypt(1).
95.2.1.1.22.6. pepsi-stage-defang-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-defang entfernt die entfernten Verweise (Bilder, Stylesheets, Schriften, Frames, url(), @import) aus den HTML- und CSS-Teilen einer Nachricht außerhalb jeder Signatur, behält Links, cid:-Teile und eingebettete data:-Bilder und markiert eine veränderte Nachricht mit X-Pepsi-Warning: remote-content-defanged. NEXT_STAGE ist Pflicht.
- DEFANG
(Zeichenkette, optional)
onoderoff(Standardwertoff). Gedacht, um je Adresse überpepsi.settingsgesetzt zu werden; solange es aus ist, reicht die Stage die Nachricht unverändert weiter. Siehe pepsi-stage-defang(1).
95.2.1.1.22.7. Der Abschnitt [pepsi-secure-link]¶
Das Secure-Link-Rückfallportal: wo eine Nachricht gehalten wird, die nicht verschlüsselt werden konnte, und wie der Empfänger hereingelassen wird. Gelesen von drei Programmen — der Stage, die eine Nachricht speichert (pepsi-stage-secure-link), dem Server, der sie bedient (pepsi-httpd(1)), und der Betreiber-CLI (pepsi-secure-link(1)) —, weshalb es ein globaler Abschnitt ist statt in einen [stage-*]-Abschnitt kopierter Optionen.
Diese Platzierung ist außerdem eine Entscheidung darüber, wer diese Werte ändern darf. Dies ist kein [stage-<name>]-Abschnitt, sodass er außer Reichweite von pepsi.settings und pepsi-stage-edit-settings(1) liegt: Ein Korrespondent kann sich nicht selbst einen längeren Ablauf, eine kürzere PIN oder eine deaktivierte Sperre mailen. Die einzige wirklich verhaltensbezogene Einstellung ist [stage-encrypt] ON_NO_KEY, die entscheidet, ob eine Nachricht, die sich nicht verschlüsseln lässt, überhaupt zum Portal geht; diese Option ist je Adresse überschreibbar.
- BASE_URL
(Zeichenkette) Öffentlicher Ursprung, unter dem das Portal erreichbar ist, z. B.
https://secure.example.org. Ihn (zusammen mitPEPPER) zu setzen aktiviert die Funktion; der einem Empfänger gemailte Link ist<BASE_URL>/secure/<token>. Nichts hier sagt, wo das Portal eingehängt ist — ein eigener Listener und Hostname oder einer, der mit der API und dem Web Key Directory geteilt wird, werden beide unterstützt.- PEPPER
(Zeichenkette) Das serverseitige Geheimnis, das in jede Inhaltsschlüssel-Ableitung eingemischt wird. Von pepsi-setup(1) nach
secrets.d/pepsi-secure-link.secretgeschrieben und mit@inline-secret@referenziert; die Stage (die alspepsiläuft) und das Portal lesen es beide, daher wird es mit Modus0640und Eigentümerpepsi-httpd:pepsiinstalliert. Ohne es ist das Portal aus — es gibt keinen Modus, in dem eine Nachricht im Klartext gespeichert wird. Es zu verlieren oder zu ändern macht jede gespeicherte Nachricht unlesbar, was dieselbe Eigenschaft ist, die eine gestohlene Datenbank wertlos macht.- EXPIRY_DAYS
(ganzzahlig, optional) Wie lange eine gespeicherte Nachricht lebt. Standardwert
7. Eine ganzzahlige Anzahl von Tagen statt einer Dauer, dennduration-Werte lehnen Kalendereinheiten ab.- PIN_LENGTH
(ganzzahlig, optional) Anzahl der Zeichen in einer erzeugten PIN, aus einem 31-Symbol-Alphabet ohne Mehrdeutigkeiten (kein
0/O, kein1/I/L). Standardwert und Minimum10(etwa 49 Bit). Eine kürzere PIN wird abgelehnt: Die PIN ist das einzige Geheimnis, das ein Angreifer, der sowohl die Datenbank als auch den Pepper hält, noch finden muss, und da PINs erzeugt werden, kostet eine längere nichts.- MAX_ATTEMPTS, LOCKOUT
(ganzzahlig / zeitlich, optional) Anzahl falscher PINs, bevor das Token sperrt (Standardwert
10), und das erste Sperrfenster (Standardwert15 m). Das Fenster verdoppelt sich mit jeder weiteren Sperre, gedeckelt beim 64-fachen der Basis.- SESSION_LIFETIME
(zeitlich, optional) Wie lange die Portalsitzung nach einer korrekten PIN dauert. Standardwert
30 m.- RATE_LIMIT
(ganzzahlig, optional) Anfragen pro Minute je Peer-Adresse über alle Portalrouten hinweg. Standardwert
30;0deaktiviert den Begrenzer.- NOTIFY_STAGE
(Zeichenkette) Erforderlich. Wohin die Link-Mail, die PIN-Mail und Lesebestätigungen injiziert werden: eine Stage auf dem ausgehenden Pfad, da dies Nachrichten sind, die die Installation originiert.
- REPLY_STAGE
(Zeichenkette, optional) Wohin eine im Portal verfasste Antwort injiziert wird. Ungesetzt deaktiviert das Antworten. Richten Sie es auf den eingehenden Pfad: Eine Portalantwort wird von einer externen Partei geschrieben, sodass sie ohne
state.local_origininjiziert wird und nicht als eine Ihrer Domains DKIM-signiert werden darf (pepsi-setup(1) warnt, wenn es auf eine Signier-Stage auflöst).- SEND_RECEIPT
(boolesch, optional) Dem Absender einmal mitteilen, dass die Nachricht gelesen wurde. Standardwert
yes. Die Bestätigung meldet wer und wann, nie was — es gibt nichts, was sie zitieren könnte.- PIN_DELIVERY
(``sender`` | ``command`` | ``none``, optional) Wie der zweite Faktor den Empfänger erreicht. Standardwert
sender: Die PIN wird an den Absender gemailt, der sie per Telefon oder Textnachricht weitergibt.commandführtPIN_COMMANDaus.nonesetzt die PIN in den Link selbst und ist strikt schwächer — das Postfach wird zum einzigen Faktor.- PIN_COMMAND
(Zeichenkette, optional) Das auszuführende Programm; ein wörtlich genommener Dateisystempfad, der also anders als eine Option vom Typ Pfad nicht
$-expandiert wird. VonPIN_DELIVERY = commandbenötigt. Wird als PIN_COMMAND--RECIPIENT ausgeführt, mit der PIN auf der Standardeingabe (eine Kommandozeile ist über/procfür alle lesbar). Das--kommt zuerst, weil die Empfängeradresse vom Absender gewählt wird und ihr Local-Part mit-beginnen kann: Ein Programm, das Optionen parst, hört dort auf und nimmt die Adresse als Operanden, und eines, das das nicht tut, findet die Adresse in seinem zweiten Argument. Bei einem Exit ungleich null wird nichts gespeichert, und die Nachricht wird erneut versucht (bis zumMAX_LIFETIMEder Stage, dann als Bounce zurückgewiesen), statt einen Link zurückzulassen, den niemand öffnen kann. Dasselbe geschieht, wenn der Befehl länger als 30 Sekunden läuft; er wird dann getötet, denn ein SMS-Gateway-Client, der auf einer unerreichbaren Adresse blockiert, hielte sonst für immer einen Stage-Worker fest, da der Datensatzrunningbleibt und nichts ihn erneut beansprucht.- MAX_REPLY_SIZE, MAX_REPLY_FILES, MAX_REPLIES
(ganzzahlig, optional) Obergrenzen für eine Portalantwort: Gesamtoktette (Standardwert
25000000, passend zu[stage-encrypt] MAX_SIZE), Dateien je Antwort (Standardwert10) und Antworten je gespeicherter Nachricht (Standardwert20). Die Größenobergrenze wird während des Body-Streamens durchgesetzt, sodass ein Client, derContent-Lengthfalsch angibt, nichts gewinnt.- ACCESS_LOG_ROWS
(ganzzahlig, optional) Je Nachricht aufbewahrte Zugriffsjournal-Datensätze. Standardwert
100. Das Journal wird mit der Nachricht gelöscht.- NOTIFY_FROM
(Zeichenkette, optional) Der
From:-Header der drei Benachrichtigungen, die das Portal originiert (der Link, die PIN und die Lesebestätigung). Ungesetzt — der Standardwert — trägt jedeFrom:den ursprünglichen Absender, sodass sie sich liest, als käme sie von der Person, die tatsächlich geschrieben hat; das ist für die Link- und die PIN-Mail richtig und für die Lesebestätigung fragwürdig, die eine automatische Nachricht mit Null-Absender ist und dann vorgibt, von der eigenen Adresse des Absenders zu kommen. Setzen Sie dies, um auf alle drei ein neutrales Postfach mit eigener Marke zu setzen. Es wird wörtlich in den Header geschrieben, geben Sie also einen vollständigen RFC-5322-Wert an (Example Ltd <secure@example.com>). Der Umschlagabsender bleibt in beiden Fällen unverändert.- ORGANIZATION, BRAND_COLOR, LOGO_FILE
(Zeichenkette / Zeichenkette / Pfad, optional) Erscheinungsbild.
BRAND_COLORmuss#rgboder#rrggbbsein — es wird in das Stylesheet der Seite interpoliert, sodass beliebiger Text abgelehnt statt escaped wird.LOGO_FILEist ein lokales PNG, JPEG, GIF oder WebP, alsdata:-URI eingebettet (SVG wird abgelehnt: Es kann Skript tragen). Eine Logo-URL ist bewusst keine Option — dieContent-Security-Policydes Portals verbietet entfernte Inhalte, was auch ein CDN daran hindert zu erfahren, wer was gelesen hat.
95.2.1.1.22.8. pepsi-stage-secure-link-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-secure-link nimmt keine eigenen Optionen: Alles steht in [pepsi-secure-link] oben. Sie hat kein NEXT_STAGE (sie ist terminal — die Nachricht verlässt die Warteschlange, und ihre Benachrichtigung ist eine neue, bei NOTIFY_STAGE injizierte Nachricht).
95.2.1.1.22.9. pepsi-stage-dkim-sign-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-dkim-sign liest neben einem erforderlichen NEXT_STAGE und einem optionalen BOUNCE_STAGE (wo eine Nachricht für eine Domain ohne Schlüssel hier oder ohne verwendbares From: gemeldet wird; ohne eines schlägt eine solche Nachricht fehl):
- HEADER_CANONICALIZATION, BODY_CANONICALIZATION
(``relaxed`` | ``simple``, optional) Die beiden Hälften der
c=-Kanonisierung. Beide haben den Standardwertrelaxedund können unabhängig gesetzt werden; alle vier Kombinationen sind sowohl für die DKIM-Signierung als auch die ARC-Versiegelung gültig.- SIGNATURE_EXPIRATION_DAYS
(ganzzahlig, optional) Die Signaturen tragen ein Ablaufdatum (
x=) so viele Tage nach dem Signieren. Standardwert7: Eine wiedereingespielte Kopie der Nachricht oder eine mit einem gestohlenen Schlüssel signierte verifiziert eine Woche nach dem Signieren nicht mehr, was immer noch den Wiederholungsplan jedes Empfängers überdauert.0gibt kein Ablaufdatum aus.- SIGNED_HEADERS
(Zeichenkette, optional) Durch Leerraum/Komma getrennte Liste der Header, die die Signaturen abdecken (
h=). MussFromenthalten. Standardwert ist die eingebaute Menge von Urheber-/MIME-Headern plusList-UnsubscribeundList-Unsubscribe-Post, deren Abdeckung durch eine DKIM-Signatur RFC 8058 verlangt, bevor ein Empfänger die Abmeldung mit einem Klick anbieten darf. Jedes Feld wird im Standardwert zweimal aufgeführt, sodass jedes übersigniert ist: Eine später hinzugefügte Kopie eines davon bricht die Signatur.- SIGNING_DOMAIN
(Zeichenkette, optional) Erzwingt die Signierdomain (
d=). Wenn nicht gesetzt, wird die Domain aus dem ersten Postfach desFrom:-Headers jeder Nachricht entnommen, streng gelesen: Ein Feld, das sich nicht vollständig als RFC-5322-Postfachliste parsen lässt, ergibt keine Domain, und die Nachricht wird abgelehnt statt signiert (siehe pepsi-stage-dkim-sign(1)). Eine festeSIGNING_DOMAINist eine Sendeidentität, daher richtet pepsi-setup(1) ihre Schlüssel und ihr DNS ein.
Die Schlüssel werden von pepsi-dkim(1) gehalten und die Signaturen von ihm erstellt; seine Selektoren beginnen mit [pepsi] DKIM_SELECTOR, und [pepsi] DKIM_ALGORITHMS wählt die Algorithmen. Der Hash ist immer SHA-256; es werden eine RSA- (rsa-sha256) und eine Ed25519-Signatur (ed25519-sha256) ausgegeben oder nur diejenigen, die [pepsi] DKIM_ALGORITHMS nennt.
95.2.1.1.22.10. pepsi-stage-relay-to-internet-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-relay-to-internet liest (ein NEXT_STAGE und BOUNCE_STAGE sind die allgemeinen Schlüssel oben):
- SERVER_NAME
(Zeichenkette, erforderlich) Unser eigener Hostname, in
EHLOangekündigt und in denReceived:-Trace-Header geschrieben, z. B.mail.example.org.- EHLO_FROM_PTR
(Boolesch, optional, Standard no) Mit
yesnimmt die Stage den Namen, den sie inEHLOankündigt, aus dem Reverse-DNS der lokalen Adresse jeder Verbindung. Sie fragt denPTR-Eintrag dieser Adresse ab und kündigt den ersten Namen an, der ein Hostname ist und auf dieselbe Adresse zurückführt (vorwärts bestätigtes Reverse-DNS). Gibt es keinen solchen Namen oder schlägt die Abfrage fehl, kündigt sie SERVER_NAME an, wie ohne die Option. Empfänger wie Gmail und Microsoft vergleichen denEHLO-Namen mit demPTRder verbindenden Adresse, und ein fester SERVER_NAME kann nur zu einem einzigenPTRpassen. Die Option ist gedacht für einen Host, dessen Adressen Namen tragen, die der Besitzer der Adresse gewählt hat, für einen Host mit mehreren Adressen und für eine IPv4- und eine IPv6-Adresse mit verschiedenen Namen. Jede Adresse wird einmal pro Stunde nachgeschlagen (nach einer erfolglosen Abfrage wieder nach fünf Minuten), über DNS_SERVERS. SERVER_NAME bleibt der Name imReceived:-Header.- POSTMASTER
(Zeichenkette, optional) Adresse, die einen Doppel-Bounce empfängt — einen Bounce (Null-Absender), der selbst unzustellbar ist. Die Zeile bleibt in der Warteschlange, bis dort eine Kopie zugestellt wurde: Sie wird wiederholt, solange die Kopie aufgeschoben wird, und als
failedmarkiert, wenn die Kopie abgelehnt wird oder MAX_LIFETIME abläuft. Ohne eine werden solche Doppel-Bounces verworfen.- PUBLIC_IP
(Zeichenkette, optional) Die öffentlichen Adressen, von denen dieses Relay sendet, von pepsi-setup(1) gelesen, um den SPF-Eintrag zu bauen (und, für diese Stage, um das Reverse-DNS zu prüfen). Diese Option der Relay-Stages ist weiter unten unter Die Egress-Identitätsoption: PUBLIC_IP dokumentiert.
- CONNECT_TIMEOUT / COMMAND_TIMEOUT / DATA_TIMEOUT
(Dauer, optional) Verbindungs-Timeouts für jeweils das Herstellen der TCP-Verbindung, einen SMTP-Befehl/eine SMTP-Antwort und die
DATA-Übertragung. Standardwerte300 s/300 s/600 s.- RETRY_INITIAL / RETRY_MAX_INTERVAL / RETRY_FACTOR
(Dauer / Dauer / Zahl, optional) Exponentieller Backoff-Zeitplan zwischen Zustellversuchen einer vorübergehend fehlschlagenden Nachricht: die erste Wartezeit, die Obergrenze der Wartezeit und der bei jedem Versuch angewandte Multiplikator. Standardwerte
300 s/2 h/2.- MAX_LIFETIME
(Dauer, optional) Wie lange eine Nachricht in der Pipeline bleiben darf, bevor ein vorübergehender Fehler dauerhaft wird (sie wird dann gebounct oder schlägt fehl). Standardwert
5 dWanduhrzeit, aber der Wert muss mith/m/s-Einheiten geschrieben werden — der Dauer-Parser lehnt died-Kalendereinheit ab (schreiben Sie also120 h, nicht5 d).- DELAY_DSN_AFTER
(Dauer, optional) Wenn gesetzt, wird dem Absender eine einmalige
Action: delayed-DSN gesendet, sobald eine noch nicht zugestellte Nachricht mindestens so lange eingereiht war und der AbsenderNOTIFY=DELAYangefordert hat. Mussh/m/s-Einheiten verwenden. Nicht gesetzt (der Standardwert) deaktiviert Delay-Warnungen.- MAX_HOP_COUNT
(Zahl, optional) Maximale Anzahl von
Received:-Headern, die toleriert werden, bevor die Nachricht als Mail-Schleife behandelt und dauerhaft fehlgeschlagen wird. Standardwert30.- DNS_SERVERS
(Zeichenkette, optional) Resolver, in der Syntax von
[pepsi] DNS_SERVERS, für dieMX-, Adress- und DANE-Abfragen. Wenn nicht gesetzt, gilt[pepsi] DNS_SERVERS, und ohne dieses die System-resolv.conf.- DNS_TIMEOUT
(Dauer, optional) DNS-Timeout pro Abfrage. Standardwert
[pepsi] DNS_TIMEOUT, sonst5 s.- MTA_STS
(boolesch, optional) Ob MTA-STS-Richtlinien der Empfängerdomain ermittelt und durchgesetzt werden (RFC 8461). Standardwert
yes.- MTA_STS_TIMEOUT
(Dauer, optional) Timeout für das Abrufen einer MTA-STS-Richtliniendatei über HTTPS. Standardwert
10 s.- ADDRESS_FAMILY
(optional) Welche IP-Adressfamilien beim Verbinden zu Mail-Exchangern verwendet werden:
any(Standardwert),ipv4(auchv4/v4onlygeschrieben) oderipv6(v6/v6only). Der konfigurierte Wert wird mit dem geschnitten, was der lokale Host tatsächlich routen kann, sodass das Festlegen auf eine Familie, für die der Host keine Route hat, nichts zum Verbinden übrig lässt. pepsi-stage-relay-to-smarthost(1) hat dieselbe Option, zusätzlich je MTA-Eintrag setzbar.- DANE
(optional) DANE/TLSA-(RFC 7672-)Durchsetzung für den Ziel-MX:
off(keineTLSA-Abfragen),warn(ein ausdrückliches Opt-out: validieren, aber bei einer Nichtübereinstimmung protokollieren und über TLS mit der nicht verifizierten Zertifikatsprüfung zustellen, die ohne DANE gilt) oderstrict(der Standardwert, wie RFC 7672 Abschnitt 2.2 es verlangt: Ein nutzbarer, aber nicht übereinstimmender Eintrag oder eine fehlgeschlageneTLSA- oderMX-Sicherheitsabfrage schiebt die Zustellung auf — daher braucht ein Host, dessen ResolverTLSA-Abfragen nicht beantworten kann,warnoderoff). Erfordert einen DNSSEC-validierenden Resolver (Pepsi vertraut dem AD-Bit der Antwort; siehe DNS_SERVERS; ein mit eingeschaltetem DANE gestarteter Worker warnt, wenn dieser Resolver weder eine Loopback-Adresse ist noch übertls://oderhttps://erreicht wird); nutzbareTLSA-Einträge haben Vorrang vor MTA-STS, außer dasswarnnie die PKIX-Validierung einerenforce-MTA-STS-Richtlinie ersetzt. Wo eine Verwendung und ein Selektor sowohl unter SHA-256 als auch unter SHA-512 veröffentlicht sind, werden nur die SHA-512-Einträge abgeglichen (RFC 7671 Abschnitt 9). In beiden Modi macht ein sicheresTLSA-RRsetSTARTTLSfür diesen MX verpflichtend (RFC 7672 Abschnitt 2.2): Ein Host, der es nicht anbietet, schiebt die Nachricht auf.
95.2.1.1.22.11. pepsi-stage-relay-to-smarthost-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-relay-to-smarthost liest die untenstehenden Betriebsoptionen; die vorgelagerten Smarthosts selbst werden einmal in den gemeinsamen [pepsi-stage-relay-to-smarthost-mta-*]-Abschnitten definiert (siehe Die Smarthost-(MTA-)Abschnitte unten). Ein NEXT_STAGE und BOUNCE_STAGE sind die allgemeinen Schlüssel oben.
- SERVER_NAME
(Zeichenkette, erforderlich) Unser eigener Hostname, in
EHLOangekündigt (sofern ein MTA ihn nicht mitHELO_NAMEüberschreibt) und in denReceived:-Header geschrieben.- EHLO_FROM_PTR
(Boolesch, optional, Standard no) Wie bei pepsi-stage-relay-to-internet: Jede Verbindung kündigt den vorwärts bestätigten
PTR-Namen ihrer lokalen Adresse an, und SERVER_NAME, wenn es keinen gibt. Ein MTA-Abschnitt, der einen eigenenHELO_NAMEsetzt, behält diesen Namen, weil der Betreiber ihn für diesen Smarthost gewählt hat.- CONNECT_TIMEOUT / COMMAND_TIMEOUT / DATA_TIMEOUT
(Dauer, optional) Verbindungs-Timeouts für den TCP-Connect, einen SMTP-Befehl/eine SMTP-Antwort und die
DATA-Übertragung. Standardwerte300 s/300 s/600 s.- RETRY_INITIAL / RETRY_MAX_INTERVAL / RETRY_FACTOR
(Dauer / Dauer / Zahl, optional) Exponentieller Backoff-Zeitplan zwischen Relay-Versuchen. Standardwerte
300 s/2 h/2.- MAX_LIFETIME
(Dauer, optional) Wie lange eine Nachricht in der Pipeline bleiben darf, bevor ein vorübergehender Fehler dauerhaft wird. Standardwert
5 dWanduhrzeit, aber schreiben Sie es mith/m/s-Einheiten — der Parser lehnt died-Kalendereinheit ab.- DELAY_DSN_AFTER
(Dauer, optional) Wenn gesetzt, wird eine einmalige
Action: delayed-DSN gesendet, sobald eine noch nicht zugestellte Nachricht mindestens so lange eingereiht war und der AbsenderNOTIFY=DELAYangefordert hat. Mussh/m/s-Einheiten verwenden. Nicht gesetzt deaktiviert es.- MAX_HOP_COUNT
(Zahl, optional) Maximale Anzahl von
Received:-Headern, bevor die Nachricht als Schleife behandelt und dauerhaft fehlgeschlagen wird. Standardwert30.- POSTMASTER
(Zeichenkette, optional) Adresse, die einen Doppel-Bounce empfängt, wie oben bei pepsi-stage-relay-to-internet(1). Die Kopie hat den Null-Absender und nimmt die Route der Domain der Adresse, daher muss einer der
[pepsi-stage-relay-to-smarthost-mta-*]-Abschnitte diese Domain bedienen.- ADDRESS_FAMILY
(optional) Die Adressfamilie, die jeder MTA-Eintrag erbt, sofern sein eigener
[pepsi-stage-relay-to-smarthost-mta-*]-Abschnitt sie nicht überschreibt:any(Standardwert),ipv4(auchv4/v4only) oderipv6(v6/v6only). Dieselbe Option, dieselben Schreibweisen wie die von pepsi-stage-relay-to-internet(1) oben.- PUBLIC_IP
(Zeichenkette, optional) Die öffentlichen Adressen, von denen dieses Relay sendet, von pepsi-setup(1) gelesen, um den SPF-Eintrag zu bauen. Diese Option der Relay-Stages ist weiter unten unter Die Egress-Identitätsoption: PUBLIC_IP dokumentiert.
- DNS_SERVERS
(Zeichenkette, optional) Resolver, in der Syntax von
[pepsi] DNS_SERVERS, für die DANE-TLSA-Abfragen. Wenn nicht gesetzt, gilt[pepsi] DNS_SERVERS, und ohne dieses die System-resolv.conf.Wird für jeden verschlüsselnden MTA-Eintrag herangezogen, dessen
DANEnichtoffist (der Standardwert iststrict); der Resolver muss DNSSEC validieren, und ein mit eingeschaltetem DANE gestarteter Worker warnt, wenn er weder eine Loopback-Adresse ist noch übertls://oderhttps://erreicht wird.- DNS_TIMEOUT
(Dauer, optional) Timeout pro Abfrage für die DANE-
TLSA-Abfragen. Standardwert[pepsi] DNS_TIMEOUT, sonst5 s.
95.2.1.1.22.12. Bounce-Stage-Optionen¶
Ein [stage-<name>]-Abschnitt mit PROGRAM = pepsi-stage-bounce liest zusätzlich aus seinem eigenen Abschnitt:
- SERVER_NAME
(Zeichenkette, erforderlich) Hostname, der in den
From:- undReporting-MTA-Feldern des erzeugten Bounces und in seinerMessage-ID-Domain verwendet wird, z. B.mail.example.org.- POSTMASTER
(Zeichenkette, optional)
From:-Adresse erzeugter Bounces (Mail Delivery Subsystem <POSTMASTER>) und die DKIM-Signieridentität — der Bounce wird als die Domain dieser Adresse signiert, deren Schlüssel pepsi-setup(1) einrichtet. Standardwert istpostmaster@<SERVER_NAME>.- NEXT_STAGE
(Zeichenkette, für diese Stage erforderlich) Die Stage, zu der der umgeschriebene Bounce weitergeschaltet wird. Weil der Bounce unsigniert gelassen wird, ist dies normalerweise eine pepsi-stage-dkim-sign(1)-Stage (die ihn als die Domain des Postmasters signiert), die ihrerseits auf eine Zustell-Stage wie pepsi-stage-relay-to-internet(1) zeigt.
- BOUNCE_MESSAGE
(Zeichenkette, optional) Name der Vorlage, die den menschenlesbaren (
text/plain-)Teil des Bounces rendert. Die Vorlagendatei istbounce-<NAME>.<lang>.bodyunter dem[pepsi]-TEMPLATE_DIR, und sie ist eine Mustache-Vorlage.<lang>folgt derstate.languageder Nachricht (der in der ursprünglichen Nachricht erkannten Sprache, an deren Absender der Bounce geht) in ihrerq-Reihenfolge, mit Rückfall aufbounce-<NAME>.en.body, das existieren muss. Ist die Option nicht gesetzt oder schlägt das Rendering fehl, wird stattdessen ein eingebauter englischer Hinweis verwendet, sodass immer ein Bounce erzeugt wird. Drei Vorlagenfamilien werden vonmake installinstalliert:bounce-default,bounce-language(die Sprachrichtlinie von pepsi-stage-block-language(1)) undbounce-payment(die unbezahlte Schranke von pepsi-stage-anti-spam(1)).Das gesamte Nachrichten-
stateaußer dem, was die eingehenden Krypto-Stages festgehalten haben (state.crypto,state.encrypted,state.signature_verified), wird der Vorlage als Rendering-Kontext übergeben, ergänzt um die Komfortvariablenserver_name,postmaster,bounce_to,failed_recipient,diagnostic,actionund die Booleansfailed/delayed/delivered. Insbesondere hält die Zustell-Stage strukturierte Detailangaben zum nächsten Hop unterstate.bouncefest —remote_mta,smtp_code,enhanced_status,phaseundreply_text—, sodass die Vorlage genau angeben kann, warum der nächste MTA die Nachricht abgelehnt hat. Wenn einstate.bounce.enhanced_status(RFC 3463) vorhanden ist, wird es auch für das maschinenlesbareStatus:-Feld der DSN verwendet.- RET_FULL_MAX_SIZE
(ganzzahlig, optional) Die größte Originalnachricht, in Bytes, die ein
RET=FULL-Bounce vollständig zurücksendet. Standardwert262144(256 KiB);0hebt die Grenze auf.RFC 3461 §6.2 sagt, die vollständige Nachricht „SOLLTE zurückgesendet werden“, wenn der Absender
RET=FULLbeiMAIL FROMgesetzt hat, und erlaubt ausdrücklich, allein die Header zurückzusenden, wenn die Nachricht „eine implementierungsspezifische Größe überschreitet“ — die Grenze ist also Teil konformen Verhaltens und keine Flucht daraus. Ohne eine würde aus einer fehlgeschlagenen 40-MB-Nachricht ein 40-MB-Bounce an einen Absender, der ohnehin schon einen schlechten Tag hat. Oberhalb der Grenze fällt die DSN auftext/rfc822-headerszurück, genau wie es einRET=HDRS-Bounce (oder einer ohneRET) tut, und der Rückfall wird protokolliert.Der Nachrichtentext wird nur für eine Nachricht aus der Datenbank geholt, deren Absender darum gebeten hat und die innerhalb der Grenze liegt; ein gewöhnlicher Bounce lädt weiterhin nichts als den Header-Block.
Eine Nachricht, die verschlüsselt ankam, wird nie vollständig zurückgegeben, gleich was
RETsagt: Die DSN zitiert nur ihre FelderFrom,Sender,To,Cc,DateundMessage-ID. Siehe pepsi-stage-bounce(1).- BOUNCE_UNAUTHENTICATED
(``drop`` oder ``send``, optional) Was mit einem Bericht geschieht, der an einen Umschlagabsender adressiert ist, den die eingehende Nachricht nicht authentifiziert hat. Standardwert
drop.Spam fälscht seinen Umschlagabsender, sodass ein Bounce dafür an einen unbeteiligten Dritten geht. Das ist Backscatter: Die Empfänger beschweren sich, und die IP dieses Hosts landet auf Blocklisten. Unter
dropwird ein Bericht nur gesendet, wenn:die Nachricht von einem unserer eigenen Benutzer kam (
state.local_origin);SPF für die Domain des Umschlagabsenders bestanden hat; oder
eine ausgerichtete DKIM-Signatur für eine
From:-Domain bestanden hat, die die Domain des Umschlagabsenders oder eine ihr über- oder untergeordnete Domain ist; oderein vorübergehender DNS-Fehler eine Prüfung gestoppt hat, die eines davon hätte zeigen können, und weder SPF noch DMARC eindeutig fehlgeschlagen sind. Nur ein Fehler zur eigenen Domain des Umschlagabsenders zählt: SPF endet mit
temperroroder, bei einemFrom:an dieser Domain, DMARC oder eine Signatur dieser Domain tut das.
Alles andere wird verworfen und als Warnung protokolliert. Eine Nachricht, die eine Stage erzeugt hat, statt dass sie über SMTP ankam, trägt keinen Authentifizierungsdatensatz und wird immer gemeldet.
sendmeldet an jeden Absender, authentifiziert oder nicht.
The failed recipient and diagnostic quoted in the bounce are taken from the
state left on the row by the delivery stage that routed the message here
(see BOUNCE_STAGE above). When there is no such state.bounce, because
the message failed on this host (a stage error past MAX_LIFETIME or marked
permanent, a crashed or hung worker, or a row that pepsi-failure-bouncer(1) moved here), the row is split into one row per recipient, each recipient’s
own NOTIFY/ORCPT/RET from state.dsn is honoured, and the DSN
carries a generic diagnostic chosen by state.failure_class;
state.last_error is never copied into it. The DSN replaces the message’s
state with retry_since, so the stages after this one count their
MAX_LIFETIME from when the DSN was built.
95.2.1.1.22.13. pepsi-stage-discard-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-discard löscht die Nachricht (eine Staging-/Test-Senke). Sie ignoriert NEXT_STAGE — ein Verwerfen ist immer terminal — und liest:
- DISPOSITION
(optional) Das simulierte Ergebnis:
success(Standardwert) behandelt die Nachricht als zugestellt;failurebehandelt sie als dauerhaften Zustellfehler.- BOUNCE
(boolesch, optional) Ob das Verwerfen überhaupt eine DSN ausgeben darf. Standardwert
no.- BOUNCE_STAGE
(Zeichenkette, optional) Die Stage, die die DSN erzeugt und zu der ein berichtbares Verwerfen geroutet wird (normalerweise eine pepsi-stage-bounce(1)-Stage). Ohne eine wird nichts ausgegeben und der Datensatz einfach gelöscht.
Der Erfolgspfad konsultiert außerdem das gemeinsame [pepsi] ORIGINATE_SUCCESS_DSN-Flag; eine Null-Absender-Nachricht wird nie gebounct.
95.2.1.1.22.14. pepsi-stage-anti-spam-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-anti-spam liest (neben einem NEXT_STAGE):
- BOUNCE_STAGE
(Zeichenkette, optional) Die Stage, zu der eine Nachricht geroutet wird, die bei Fristablauf noch unbezahlt ist: normalerweise eine pepsi-stage-bounce(1)-Stage (eine Ablehnungs-DSN, unter Beachtung des
NOTIFYdes Absenders) oder eine pepsi-stage-discard(1)-Stage (stilles Verwerfen). Ohne eine wird eine unbezahlte Nachricht einfach gelöscht.- BOUNCE_TARGET_STAGE
(string, optional) Where a returning bounce that carries no valid ``Pepsi-Origin`` proof is routed, that is, a message with the null sender that claims to report on mail of ours, although we cannot show that we originated that mail (see The [pepsi-origin] Section). Without one such a message takes the ordinary NEXT_STAGE path, past the payment gate: a null-sender message is never gated, since a bounce must not be bounced, so a forged bounce reaches the mailbox. pepsi-setup(1)
--wizardtherefore writesBOUNCE_TARGET_STAGE = discard-rejected, a pepsi-stage-discard(1) sink that it also emits, whenever it configures the stage (it always writes[pepsi-origin]): the forged bounce is dropped, with the verdict in the log. Point it at a quarantine or review stage instead to keep such messages for inspection: a legitimate bounce that quotes little of the original, has passed a header-stripping gateway or returns after the two-week nonce window cannot be verified either and is dropped by the sink. pepsi-setup(1) warns about a stage that leaves the option unset.- ORDER_CHOICES
(JSON, erforderlich) Das
choices-Array der Taler-v1-Bestellung, wörtlich verwendet: ein oder mehrereOrderChoice-Objekte, die die akzeptierten Zahlungen beschreiben (zum Beispiel mehrere Beträge in verschiedenen Währungen oder Token-Familien-Eingänge/-Ausgänge). Siehe die GNU-Taler-Händler-API.- PAYMENT_DEADLINE
(Dauer, optional) Wie lange die Nachricht
pausedin Erwartung der Zahlung gehalten wird, bevor sie abgelehnt wird; auch diepay_deadlineder Bestellung. Verwendet nurh/m/s-Einheiten (Kalendereinheiten wiedwerden abgelehnt). Standardwert48 h.- DELAY_DSN_AFTER
(Dauer, optional) Sendet dem Absender eine einmalige verzögerte Zustellungsstatusbenachrichtigung (RFC 3461), sobald eine noch unbezahlte Nachricht so lange gehalten wurde, ohne die Nachricht freizugeben — sie bleibt bis PAYMENT_DEADLINE pausiert. Die DSN wird nur gesendet, wenn der Absender
NOTIFY=DELAYangefordert hat und ein BOUNCE_STAGE verdrahtet ist (sie wird mitkind = delaydorthin geroutet), und nur, wenn dieser Zeitpunkt strikt vor PAYMENT_DEADLINE liegt. Verwendet nurh/m/s-Einheiten. Nicht gesetzt (der Standardwert) deaktiviert Delay-Warnungen.- SUMMARY
(Zeichenkette, optional) Menschenlesbare Bestellzusammenfassung, die dem Zahlenden angezeigt wird. Standardwert
E-mail delivery.- FULFILLMENT_MESSAGE
(Zeichenkette, optional) Nachricht, die dem Zahlenden nach einer erfolgreichen Zahlung angezeigt wird. Standardwert
Your e-mail has been queued for delivery.- BLOCK_RESPONSE_STAGE
(Zeichenkette, optional) Die Stage, bei der die Zahlungsaufforderungs-Auto-Antwort injiziert wird — üblicherweise der Kopf einer Signier-/Relay-Kette (zum Beispiel eine pepsi-stage-dkim-sign(1)-Stage). Muss eine existierende Stage referenzieren. Wenn nicht gesetzt, wird keine Antwort gesendet (die Nachricht bleibt in Erwartung der Zahlung pausiert).
- BLOCK_RESPONSE_FROM
(Zeichenkette, optional) Der
From:-Header der Auto-Antwort. Wenn nicht gesetzt, ist der Standardwert der ursprüngliche Empfänger (das geschützte Postfach).- BLOCK_RESPONSE_SUBJECT
(Zeichenkette, optional) Das
Subject:der Auto-Antwort. StandardwertPayment required to deliver your e-mail.- BLOCK_RESPONSE_SUPPRESS
(Dauer, optional) Das Zeitfenster pro Absender für die automatische Antwort: Ein Absender, dem für dasselbe geschützte Postfach (den ersten Umschlagempfänger) innerhalb dieses Zeitfensters bereits eine Zahlungsaufforderung geschickt wurde, erhält für die nächste Nachricht keine Aufforderung, und diese Nachricht wird trotzdem genauso zur Zahlung zurückgehalten. Die Aufforderung geht an einen Umschlagabsender, den niemand verifiziert hat; ohne Zeitfenster würde also eine Flut von Nachrichten mit einem gefälschten Absender zur gleichen Flut von Aufforderungen an diese Adresse. In einer Anweisung beansprucht und festgehalten (
payment_request_should_sendüberpepsi.payment_request_reply, das Muster vonvacation_should_reply), sodass nicht zwei Worker beide eine senden können; Datensätze werden entfernt, sobald sie veralten. Nur die Einheitenh/m/s(höchstens ein Jahr);0 sbeantwortet jede Nachricht. Standardwert1 h.- REQUIRE_AUTHENTICATED
(boolesch, optional) Die Zahlungsaufforderung nur an einen Absender senden, dessen Umschlagdomain SPF bestanden hat oder dessen
From:-Domain DMARC bestanden hat; die Nachricht wird so oder so bis zur Zahlung zurückgehalten. Standardwertno: Ein eindeutigesfailerhält nie eine Aufforderung, abersoftfail,neutral,noneund vorübergehende Fehler schon, sodass ein Absender bei einer Domain, die keinen der beiden Einträge veröffentlicht, erfährt, warum seine Mail zurückgehalten wird.yesschließt den einen Weg, auf dem ein gefälschter Umschlagabsender bei einer solchen Domain diesen Host eine Adresse nach Wahl des Fälschers anschreiben lassen kann. Dieselbe Option wie in[stage-<vacation>]und[stage-<list-command>].- PAYMENT_MESSAGE_DEFAULT_LANGUAGE
(Zeichenkette, optional) Die Rückfallsprache für den Nachrichtentext der Auto-Antwort, verwendet, wenn die Nachricht keine erkannte
state.languageträgt oder keine der erkannten Sprachen einepayment-request.<lang>.body-Vorlage (unter[pepsi]TEMPLATE_DIR) hat. Diese Vorlage muss existieren (pepsi-setupprüft das, sobald BLOCK_RESPONSE_STAGE gesetzt ist). Unabhängig von der Groß-/Kleinschreibung. Standardwerten.
Die Stage erfordert außerdem den gemeinsamen [pepsi-payments]-Abschnitt (das Händler-Backend und das Zugriffstoken, unten dokumentiert) und, damit der Zahlungs-Webhook pausierte Nachrichten freigeben kann, das [pepsi-httpd]-RESUME_AUTHORIZATION_TOKEN (siehe pepsi-httpd(1)).
95.2.1.1.22.15. pepsi-stage-auto-pay-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-auto-pay liest:
- MAX_TOTAL
(Betrag, erforderlich) Der höchste Betrag, den diese Stage insgesamt ausgibt, um eine ursprüngliche Nachricht zuzustellen: ein GNU-Taler-Betrag
CURRENCY:VALUE(zum BeispielEUR:5). Die Obergrenze ist kumulativ über jede für diese Nachricht zurückkehrende Zahlungsforderung (alle mit einer Pepsi-Origin-Nonce, z. B. eine Mailinglisten-Auffächerung) und gilt für eine einzige Währung: Eine Forderung in einer anderen Währung wird nicht bezahlt. Der Betreiber kann sie für ein Konto mit pepsi-settings(1) überschreiben; ein Konto kann sie nicht per E-Mail ändern: pepsi-stage-edit-settings(1) lehnt sie, MAX_TOTAL_PER_DAY und die Wallet-Auswahl ab, wie großzügig sein EDITABLE_STAGES auch ist.- MAX_TOTAL_PER_DAY
(Betrag, erforderlich, sofern MAX_TOTAL nicht null ist) Der höchste Betrag, den ein Wallet in beliebigen 24 Stunden (ein gleitendes Fenster) für Zahlungsforderungen ausgeben darf, über beliebig viele ursprüngliche Nachrichten hinweg. MAX_TOTAL liefert diese Gesamtgrenze nicht, da ein Korrespondent, der k unserer Nachrichten erhalten hat, für jede MAX_TOTAL fordern kann. Das Wallet folgt WALLET_MODE/WALLET_SCOPE: das eigene Wallet eines lokalen Benutzers, das Wallet pro Absender des gemeinsamen Kontos oder dessen eines vereinigtes Wallet (dann ist die Grenze die der Installation). Nie pro Korrespondent: Mailinglisten und Aliase machen die fordernde Partei unerkennbar. Muss in der Währung von MAX_TOTAL sein. Zusammen mit MAX_TOTAL atomar durch
auto_pay_try_spendüber das Journalpepsi.auto_pay_spenddurchgesetzt; eine Zahlung, die nicht abgewickelt werden kann, wird zurückgebucht. Ein Abschnitt mit einem MAX_TOTAL ungleich null und ohne Tagesgrenze lässt den Worker den Start verweigern (und pepsi-setup(1) die Konfiguration ablehnen): MAX_TOTAL begrenzt eine Nachricht, daher würde ein gestohlenes Submission-Passwort das Wallet sonst Nachricht für Nachricht leeren.- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin eine Nachricht weitergeleitet wird, wenn sie keine Zahlungsforderung ist, nicht nachweislich unsere ist oder nicht bezahlt wird (über Budget / Begleichungsfehler). pepsi-setup(1) lehnt eine Stage ohne eine solche oder mit einer, die keine Stage nennt, ab.
- WALLET_MODE
(``local-user`` | ``shared``, Standardwert ``shared``) Aus welchem Konto der Wallet-Helper bezahlt.
local-usersenkt die Privilegien auf das eigene lokale Login des Bounce-Empfängers (den ursprünglichen Absender) und verwendet das Standard-Wallet dieses Benutzers — der Empfänger muss auf ein erlaubtes lokales Konto auflösen (die LOCAL_DOMAINS/TARGETS/ RECIPIENT_DELIMITER-Prüfung, wie bei pepsi-stage-relay-to-maildir(1)).sharedsenkt sie auf ein einzelnes dediziertes Konto (WALLET_USER).- WALLET_USER
(Zeichenkette, Standardwert ``pepsi-wallets``) Das gemeinsame Konto, auf das der Helper in
WALLET_MODE = sharedwechselt; sein Home-Verzeichnis enthält die Wallet-Datenbank(en). Seine primäre Gruppe muss die Gruppe sein, unter der pepsi-helper-auto-pay(1) installiert ist (pepsi-wallets); der Helper lehnt jedes andere Konto ab, sodass root und nicht die Konfiguration entscheidet, unter welchem Konto das Wallet läuft.- WALLET_SCOPE
(``per-sender`` | ``unified``, Standardwert ``per-sender``) Im
shared-Modus, wie die Wallet-Datenbanken des gemeinsamen Kontos getrennt werden: eine pro Ursprungs-Absenderadresse (per-sender) oder ein einzelnes von allen geteiltes Wallet (unified— z. B. ein Unternehmen, in dem individuelle Wallets nicht sinnvoll sind).- WALLET_CLI
(ignoriert) Der Helper führt
taler-wallet-cliaus (standardmäßig/usr/bin/taler-wallet-cli) und kein anderes Programm; der Pfad wird beim Bauen von Pepsi festgelegt (make TALER_WALLET_CLI=…oder./configure --with-taler-wallet-cli=…). pepsi-setup(1) warnt, wenn die Option noch gesetzt ist.- WALLET_PAY_OPTIONS
(Zeichenkette, Standardwert keine) Zusätzliche Argumente, die dem Pay-Aufruf des Wallets angehängt werden, durch Leerraum getrennt. Das literale
noneübergibt keine zusätzlichen Optionen. (--yesund--choice-index 0werden vom Helper immer hinzugefügt, um die Zahlung zu bestätigen und die bepreiste Vertragsauswahl zu benennen.) Standardmäßig wird hier nichts benötigt — dashandle-urides Wallets wartet bereits, bis die Zahlung einen Endzustand erreicht.- HELPER
(Zeichenkette, Standardwert ``pepsi-helper-auto-pay``) Das privilegierte Wallet-Helper-Binärprogramm (ein Name auf
$PATHoder ein absoluter Pfad).
Die folgenden Optionen aktivieren und konfigurieren die Wallet-Self-Service-Rolle (eine lokal eingelieferte Nachricht an die Steueradresse bedient das eigene Wallet des Absenders per E-Mail; siehe pepsi-stage-auto-pay(1)):
- RESPONSE_STAGE
(Zeichenkette, optional) Die Stage, bei der die Self-Service-Antwort injiziert wird (sodass sie DKIM-signiert und weitergeleitet wird). Ihr Setzen aktiviert die Self-Service-Rolle; sie nicht zu setzen bedeutet, dass die Stage nur eingehende Forderungen bezahlt.
- CONTROL_LOCAL_PART
(Zeichenkette, Standardwert ``pepsi-wallet``) Der Local-Part der Wallet-Steueradresse: eine lokal erzeugte Nachricht an
<part>@<served-domain>ist eine Wallet-Steuernachricht.- RESPONSE_FROM
(Zeichenkette, optional) Das
From:der Self-Service-Antwort. Standardwert ist<{CONTROL_LOCAL_PART}@{domain}>für die adressierte bediente Domain.- RESPONSE_SUBJECT
(Zeichenkette, Standardwert ``Pepsi wallet``) Das
Subject:der Self-Service-Antwort.
Ein manuelles withdraw (Aufladung) benennt den GNU-Taler-Exchange, von dem abgehoben werden soll, in der Anfrage (Subject: withdraw CURRENCY:VALUE EXCHANGE-URL); da ein Wallet mehrwährungsfähig ist und von vielen Exchanges abheben kann, gibt es keine serverseitige Exchange-Option.
Die Stage verwendet außerdem den gemeinsamen [pepsi-origin]-Abschnitt (das Herkunftsnachweis-Geheimnis), um zu verifizieren, dass eine Forderung für Mail ist, die diese Installation tatsächlich gesendet hat; ohne ihn kann keine Forderung verifiziert und keine bezahlt werden (der Self-Service ist davon unberührt). Die gesamte Wallet-Arbeit wird vom setuid-root pepsi-helper-auto-pay(1) erledigt; das Stage-Binärprogramm wird SGID pepsi-wallets installiert, damit sein Worker es ausführen darf.
95.2.1.1.22.16. pepsi-stage-check-whitelist-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-check-whitelist liest:
- WHITELIST_NAME
(Liste, erforderlich) Die
whitelist_name-Gruppen, die in derpepsi.whitelist-Tabelle konsultiert werden — eine kommagetrennte Liste, als ein einziges= ANY(...)abgefragt, kein einzelner Name.Ein Eintrag darf eine Vorlage sein, die
{localpart}oder{login}enthält, was je Umschlagempfänger vor der Abfrage expandiert wird:{localpart}ist der um die Subadresse bereinigte, kleingeschriebene Local-Part und{login}das passwd-Login, zu dem er auflöst. So wird ein mit pepsi-whitelist(1) verwalteter Namensraum je Benutzer — die<login>/segment-Namen — ohne eine Einstellungsüberschreibung je Adresse konsultiert. Zum Beispiel:WHITELIST_NAME = correspondents, {localpart}/correspondents
konsultiert die gemeinsame Gruppe und die eigene jedes Empfängers.
- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(optional) Dieselben Lokalitätsoptionen, mit denselben Standardwerten, wie die Zustell-Stages — hier gelesen, um
{login}aufzulösen (und für{localpart}eine Subadresse abzustreifen) und um RECORD_LIST_CONFIRMATIONS auf lokale Empfänger zu beschränken.- RECORD_LIST_CONFIRMATIONS
(boolesch, optional) Jede eingehende Nachricht, die wie eine Bestätigungsanfrage einer Mailingliste für ein Abonnement aussieht (ein einziges
Message-ID:,confirmimSubject:und ein Local-Part vonFrom:/Reply-To:/Sender:, der auf-request,-confirm,-joinoder-subscribeendet), inpepsi.list_confirmationfesthalten, einmal je lokalem Umschlagempfänger, sodass pepsi-stage-auto-whitelist(1) die Liste lernen kann, wenn dieser Empfänger sie beantwortet (sein LIST_WHITELIST_NAME). Das Festhalten setzt nichts auf die Whitelist. Standardwertno.- LIST_CONFIRMATION_DAYS
(ganzzahlig, optional) Wie viele Tage eine festgehaltene Bestätigungsanfrage zählt, bevor
pepsi-queue gcsie löscht; eine spätere Antwort lehrt nichts. 1 bis 90; Standardwert7.- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin die Nachricht nach der Prüfung weiterschaltet (ob sie passte oder nicht). pepsi-setup(1) lehnt einen Abschnitt ohne eine solche Stage ab oder einen, der eine Stage nennt, die nicht existiert.
95.2.1.1.22.17. pepsi-stage-auto-whitelist-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-auto-whitelist liest:
- WHITELIST_NAME
(Zeichenkette, erforderlich) Die
whitelist_name-Gruppe, die in derpepsi.whitelist-Tabelle befüllt wird. Sie sollte mit der Gruppe übereinstimmen, die das eingehende pepsi-stage-check-whitelist(1) konsultiert. Ein einzelner wörtlicher Name in der Grammatik der Whitelist-Namen: Diese Stage expandiert keinen{login}/{localpart}-Platzhalter, sodass ein Wert, der einen enthält, abgelehnt wird. Der Betreiber darf jede Whitelist benennen, einschließlich einer, die alle lokalen Benutzer teilen; ein Wert, den ein Kontoinhaber per Mail über pepsi-stage-edit-settings(1) setzt, muss eine in seinem eigenen<login>/...-Namensraum benennen oder diejenige, die die Konfiguration des Betreibers für ihn benennt.- DKIM_REQUIRED
(boolesch, optional) Wert, der in der
dkim_required-Spalte jedes von dieser Stage eingefügten Datensatzes gespeichert wird. Standardwertyes.- DMARC_REQUIRED
(boolesch, optional) Wert, der in der Spalte
dmarc_requiredjedes Datensatzes gespeichert wird, den diese Stage einfügt: Eine Antwort passt dann nur, wenn sie DMARC bestanden hat, über eine ausgerichtete DKIM-Signatur oder einen ausgerichteten SPF-Pass (oder ein vertrauenswürdiger ARC-Versiegler für sie gebürgt hat). Vondkim_requiredimpliziert; mit DKIM_REQUIRED= noist es das, was einen Korrespondenten, dessen Domain nicht signiert, an eine authentifizierte Identität gebunden hält. Standardwertyes.- LIST_WHITELIST_NAME
(Zeichenkette, optional) Mailinglisten lernen. Eine ausgehende, lokal eingelieferte Nachricht kann eine Bestätigungsanfrage für ein Abonnement beantworten, die pepsi-stage-check-whitelist(1) für genau diesen Absender festgehalten hat (RECORD_LIST_CONFIRMATIONS): Sie ist an die Steueradresse der Anfrage gerichtet, und ihr
In-Reply-To:nennt die Anfrage. DieList-Idder Liste wird dann als ablaufenderlist-id-Datensatz in diese Whitelist aufgenommen. Der Wert ist eine Vorlage, die mit{login}/beginnen muss (zum Beispiel{login}/lists) und für den Umschlag-Absender expandiert wird, sodass eine Liste, der ein Benutzer beigetreten ist, nie für jemand anderen auf die Whitelist kommt. Dasdkim_requireddes Datensatzes ist DKIM_REQUIRED und seindmarc_requiredDMARC_REQUIRED. Nicht gesetzt (der Standard): Es werden keine Listen gelernt. Fügen Sie denselben Namen dem WHITELIST_NAME der Prüf-Stage hinzu, damit er herangezogen wird.- LIST_MAX_IDLE_DAYS
(ganzzahlig, optional) Wie viele Tage ein gelernter Listendatensatz ohne passenden Beitrag in Kraft bleibt; jeder authentifizierte Beitrag, den die Prüf-Stage mit ihm abgleicht, startet die Zählung neu. Eine Liste zu verlassen sendet kein Signal, daher stellt diese Option die Datensätze von Listen außer Dienst, die ein Benutzer verlassen hat. 1 bis 3650; Standardwert
180.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(optional) Dieselben Lokalitätsoptionen, mit denselben Standardwerten, wie pepsi-stage-check-whitelist(1). Sie expandieren
{login}in LIST_WHITELIST_NAME und werden aus dem Abschnitt des Betreibers gelesen, wenn pepsi-stage-edit-settings(1) das WHITELIST_NAME eines Kontoinhabers beurteilt, um den Login des Inhabers und damit seinen<login>/...-Namensraum aufzulösen.- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin die Nachricht weiterschaltet, nachdem die Empfänger festgehalten wurden. pepsi-setup(1) lehnt einen Abschnitt ohne eine solche Stage ab oder einen, der eine Stage nennt, die nicht existiert.
95.2.1.1.22.18. pepsi-stage-autocrypt-learn-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-autocrypt-learn liest:
- LEARN_KEYS
(boolesch, optional) Das eigene Schlüsselmaterial des Absenders, das in der Nachricht gefunden wird (S/MIME-Signiererzertifikate,
application/pgp-keys-Teile und derAutocrypt:-Header), auf deminbound-Vertrauensrang speichern, oder aufinbound-signed, wenn eine ausgerichtete DKIM-Signatur, die beim Ingress bestanden hat, es abdeckte (siehe pepsi-stage-autocrypt-learn(1)), wo es nie stillschweigend einen Schlüssel aus besserer Quelle ersetzen kann. StandardwertYES. Nur Material, das die eigene Adresse des Absenders beansprucht, wird behalten. Derselbe Schalter hält dieSMIMECapabilitiesfest, die eine S/MIME-Signatur trägt (der S/MIME-Fähigkeitsdatensatz je Peer, auf das signierende Zertifikat geschlüsselt). Es auszuschalten lässt die Stage überhaupt keinen Schlüssel und keine Fähigkeit lernen,LEARN_GOSSIPeingeschlossen; sie hält weiterhin fest, dass ein Korrespondent einen unserer Schlüssel hält (pepsi.peer_has_own_key).- LEARN_GOSSIP
(boolesch, optional) Zusätzlich die Schlüssel der anderen Empfänger aus den
Autocrypt-Gossip:-Feldern innerhalb einer verschlüsselt eingetroffenen Nachricht lernen (Autocrypt Level 1 §5.3), auf demgossip-Rang — dem unteren Ende der Leiter, unterhalb voninbound. StandardwertYES; es tut nichts, sofern nicht auchLEARN_KEYSan ist.Das macht ein verschlüsseltes Allen-Antworten an einen Korrespondenten möglich, von dem man nie direkt Mail hatte. Ein Feld wird nur verwendet, wenn es wirklich im Chiffrat war, nur wenn sein
addrin den eigenenTo:,Cc:oderReply-To:der Nachricht erscheint, nie für die eigene Adresse des Absenders und nie für eine Adresse inLOCAL_DOMAINS— niemand darf diesem Host seine eigenen Benutzer vorstellen. Ein gegossipter Schlüssel kann nie einen besser bequellten verdrängen und lässt eine Signatur nie als verifiziert zählen.Beachten Sie die Asymmetrie zur sendenden Hälfte (
[stage-encrypt] AUTOCRYPT_GOSSIP, StandardwertNO): Gossip auszugeben verteilt die Schlüssel Dritter an Korrespondenten weiter, die nicht danach gefragt haben, während es zu lesen nur den eigenen Cache dieses Hosts füllt. Ein Betreiber, der die Einführungen gespeichert, aber nie verwendet haben möchte, setzt[pepsi-keydiscovery] MIN_TRUST = harvested, statt dies auszuschalten.- LEARN_FROM_SPAM
(boolesch, optional) Ob eine Nachricht, die die Pipeline bereits als Spam bewertet hat (
state.spam = true), dennoch einen Schlüssel lehren darf. StandardwertNO, was Autocrypt Level 1 §5.3s „Nachrichten SOLLTEN ignoriert werden …, wenn der MUA die Nachricht für Spam hält“ entspricht.Es ist eine Option statt einer festen Regel, weil die Überzeugung Pepsis eigene ist: Ein Betreiber, dessen Spam-Bewertung bewusst locker ist, mag Schlüsselkontinuität der Regel vorziehen. Beachten Sie, dass das Einhalten des Standardwerts erfordert, dass die Stage nach allem platziert wird, was
state.spamsetzt — siehe pepsi-stage-autocrypt-learn(1).- ACCEPT_ROTATION
(Zeichenkette, optional) Wann die Regel „das Neueste gewinnt“ der Autocrypt-Stufe den gespeicherten
inbound-signed/inbound/gossip-Schlüssel eines Korrespondenten durch den Schlüssel ersetzen darf, den eine neuere Nachricht trägt.newest(der Standardwert) ist Autocrypt Level 1: Ein strikt neueres effektives Datum genügt, auf gleicher Sprosse.expiredverlangt zusätzlich, dass jeder gespeicherte Schlüssel für diese Adresse und dieses Protokoll widerrufen oder abgelaufen ist (nach seiner festgehaltenen Gültigkeit oder seinemexpires_at); andernfalls wird der gespeicherte Schlüssel behalten und das Angebot zurückgehalten — auditiert alskey.peer.rotate.heldund den Empfängern wie eine Rotation gemeldet. Ein Schlüssel aus einer unsignierten Nachricht ersetzt nie einen, den eine DKIM-signierte Nachricht gebracht hat, gleich was diese Option sagt; ein signierter Schlüssel, der einen unsignierten ersetzt, wird von ihr wie eine Rotation geregelt. Eine Ersetzung durch eine strikt besser eingestufte Quelle außerhalb der Stufe nicht. Jeder andere Wert ist ein Konfigurationsfehler. In jedem Fall schreibt jede Rotation einekey.peer.rotate-Audit-Zeile; siehe pepsi-stage-autocrypt-learn(1).- RESPONSE_STAGE
(Zeichenkette, optional) Die Stage, an der die Benachrichtigungen über Schlüsseländerungen eingespeist werden: Wird der Schlüssel eines Korrespondenten rotiert oder zurückgehalten, erhält jeder lokale Umschlagempfänger der auslösenden Nachricht die Vorlage
key-rotation.<lang>.bodyper Mail (Null-Absender,From: postmaster@<domain>). Normalerweise die DKIM-Signier-Stage, wieRESPONSE_STAGEvon pepsi-stage-encrypt(1). Muss eine existierende Stage benennen; pepsi-setup(1) verlangt außerdemkey-rotation.en.bodyin[pepsi] TEMPLATE_DIR. Ohne sie werden Änderungen auditiert und protokolliert, aber niemand erhält eine Mail.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(optional) Die geteilten Lokalitätsoptionen. Nur
LOCAL_DOMAINSwird herangezogen: um ein Gossip-Feld abzulehnen, das eine von diesem Host bediente Adresse benennt (eine Schlüsselsubstitution statt einer Einführung), und um auszuwählen, welche Umschlagempfänger unsere sind, denen eine Benachrichtigung über Schlüsseländerungen zu schicken ist. Standardwert ist[pepsi-ingress]ACCEPTED_DOMAINS.- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin die Nachricht weiterschaltet, nachdem die Stage gelernt hat, was sie konnte. Die Stage verbraucht nie eine Nachricht, sodass ein fehlendes NEXT_STAGE von pepsi-setup(1) abgelehnt wird und zur Laufzeit einen Fehler ergibt.
95.2.1.1.22.19. pepsi-stage-detect-language-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-detect-language liest:
- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin die Nachricht nach der Klassifizierung weiterschaltet (ob eine Sprache festgehalten wurde oder nicht). Der Worker verweigert bei einem Abschnitt ohne eine solche Stage den Start.
- LANGUAGES
(Liste, optional) Die Kandidatensprachen, als durch Leerraum/Komma getrennte ISO-639-1-Codes (unabhängig von der Groß-/Kleinschreibung); mindestens zwei verschiedene Codes sind erforderlich. Das Token
*steht für jede unterstützte Sprache (75 mit dem mitgelieferten Erkenner) und darf mit expliziten Codes kombiniert werden. Die Erkennung gibt nur jemals Sprachen aus dieser Menge zurück, sie sollte also die Sprachen abdecken, die Sie zu empfangen erwarten. Standardwert ist eine breite gängige Menge (en de fr es it pt nl pl ru tr ar zh ja).Narrow it. Every enabled language adds to the memory that each worker process uses, and, more importantly, every language that your traffic never contains still competes for probability. The stage removes non-prose (URLs, addresses, base64 blobs, DNS records) from the body before classifying, which stops a single such token from deciding the answer outright; what remains after that is a genuine contest between the candidates, and a language in which nobody writes to you can still win it on a short message. pepsi-detect-language(1) reclassifies a saved message against any candidate set, so a narrower list can be tried before it is configured.
95.2.1.1.22.20. pepsi-stage-block-language-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-block-language liest:
- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin eine Nachricht weiterschaltet, die über THRESHOLD bewertet — und, unter
ENFORCEMENT = soft, wohin auch eine markierte Nachricht weiterläuft. pepsi-setup(1) lehnt einen Abschnitt ohne eine solche Stage ab.- BOUNCE_STAGE
(Zeichenkette, erforderlich, wenn für eine Nachricht ein Bounce erzeugt werden kann) Wohin eine Nachricht geroutet wird, die auf oder unter THRESHOLD bewertet, damit eine Fehler-DSN erzeugt werden kann (typischerweise pepsi-stage-bounce(1)). Nur unter
ENFORCEMENT = hardherangezogen, wo es erforderlich ist: pepsi-setup(1) lehnt einenhard-Abschnitt ohne es ab, und der Worker verweigert bei einem solchen den Start (eine adressbezogene Überschreibung, die ohne es aufhardumschaltet, lässt die blockierte Nachricht fehlschlagen). Es lohnt sich auch untersoft, es zu setzen, sodass der Wechsel zuhardeine Ein-Wort-Änderung ist.- ENFORCEMENT
(``hard`` | ``soft``, optional) Was mit einer Nachricht geschieht, die die Richtlinie nicht besteht.
hard(der Standardwert) routet sie zu BOUNCE_STAGE, sodass sie nicht zugestellt wird.softstellt sie dennoch zu, markiert: SUBJECT_FLAG_LABEL wird an ihrenSubject:angehängt, einX-Pepsi-Detected-Languages-Header hält fest, was erkannt wurde, und die Nachricht schaltet zu NEXT_STAGE weiter.softmarkiert genau die Nachrichten, diehardgebouncet hätte, was es zu einem Trainingsmodus macht: Lassen Sie es eine Weile laufen, und die Markierungen im Postfach sind eine getreue Vorschau dessen, was die Durchsetzung abweisen würde, ohne Kosten für einen Korrespondenten, für dessen Mail die Listen noch nicht abgestimmt sind. Als gewöhnliche Stage-Option ist es je Adresse überschreibbar (pepsi-settings(1)), sodass ein Konto im Training bleiben kann, während der Rest der Installation durchsetzt.Beachten Sie, dass die
Subject:-Umschreibung die DKIM-Signatur des Absenders und das ARC-AMSdieses Servers bricht (beide übersignierenSubject), genau wie esVACATION_TAGvon pepsi-stage-vacation(1) tut. Auf einem Zweig, der in lokaler Zustellung endet, kostet das nichts, auf einem, der weiterleitet, aber schon.- SUBJECT_FLAG_LABEL
(Zeichenkette, optional) Die Markierung, die unter
ENFORCEMENT = softan denSubject:einer markierten Nachricht angehängt wird. Standardwert[!LANG]. Nur angehängt, wenn der Betreff sie nicht bereits enthält (ohne Beachtung der Groß-/Kleinschreibung), sodass eine Antwort, die ihn durch die Stage zurückzitiert, keine zweite sammelt. Ein leerer Wert wendet den Standardwert erneut an; es gibt keinen Weg, die Markierung abzuschalten, denn nichts zu markieren ist dasselbe, wie die Stage aus der Pipeline zu lassen.- WHITELIST
(Liste, optional) Sprachen, deren Wahrscheinlichkeit zur Bewertung addiert wird, als durch Leerraum/Komma getrennte ISO-639-1-Codes (unabhängig von der Groß-/Kleinschreibung) plus den optionalen Pseudo-Code
none(der auf nicht erkannte Mail passt). Leer, wenn nicht gesetzt. Ein Eintrag darf weitere Subtags tragen (de-CH); jeder Eintrag ist ein Sprach*bereich*, der per einfacher Filterung nach RFC 4647 §3.3.1 abgeglichen wird, sodassdeauch ein erkanntesde-CHtrifft, währendde-CHkein bloßesdetrifft.- BLACKLIST
(Liste, optional) Sprachen, deren Wahrscheinlichkeit von der Bewertung subtrahiert wird, gleiche Syntax wie WHITELIST. Leer, wenn nicht gesetzt. Eine Sprache darf in höchstens einer der beiden Listen erscheinen.
Mindestens eine der beiden Listen muss nicht leer sein: Sind beide leer, erhält jede Nachricht die Bewertung
0.0, was die strikte Schrankescore > THRESHOLDdann nicht besteht, sodass die Stage alle Mail mit einem Bounce versähe (oder markierte). Die Konfiguration wird zurückgewiesen statt angenommen, und diese Zurückweisung verhindert, dass „die Listen fülle ich später“ einen stillen Ausfall verursacht.- THRESHOLD
(Gleitkommazahl, optional) Die Bewertung, die eine Nachricht überschreiten muss, um weiterzuschalten. Standardwert ist
0.0.
95.2.1.1.22.21. pepsi-stage-vacation-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-vacation beantwortet Mail, die eintrifft, während der Umschlagempfänger abwesend ist. Jede Option unten ist je Adresse überschreibbar, und so ist die Funktion gedacht: Der INI-Abschnitt ist der Standardwert des Betreibers (kein Urlaub), und die Urlaubsdaten jedes Benutzers — und, wenn er will, sein eigener Nachrichtentext — kommen aus seinem pepsi.settings-Datensatz oder aus einem config_override-Geltungsbereich. Siehe pepsi-stage-vacation(1).
- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin die Nachricht weiterläuft. Sie tut es immer: Diese Stage fügt eine Antwort hinzu, sie verbraucht nie eine Nachricht. pepsi-setup(1) lehnt eine Stage ohne sie ab.
- RESPONSE_STAGE
(Zeichenkette, erforderlich) Wohin die Urlaubsnotiz als neue Nachricht mit Null-Absender injiziert wird, sodass sie signiert und weitergeleitet wird (typischerweise die DKIM-Signier-Stage). pepsi-setup(1) prüft, dass es eine existierende Stage benennt.
- VACATION_RANGES
(Liste, optional) Durch Kommas oder Leerraum getrennte
YYYY-MM-DD:YYYY-MM-DD-Spannen von Tagen, an denen der Empfänger abwesend ist. Beide Endpunkte sind inklusive ganze Tage in der Zeitzone des Servers; ein leeres Ende (2026-08-01:) ist eine offene Abwesenheit, und ein bloßes Datum ist dieser eine Tag. Leer, wenn nicht gesetzt, was die Stage für diese Adresse ausschaltet — der Standardwert und der Zustand jedes Empfängers, der nie eine Abwesenheit konfiguriert hat. Eine Spanne, deren Ende vor ihrem Anfang liegt, wird abgelehnt.- DEFAULT_LANGUAGE
(Zeichenkette, optional) Die Sprache, deren Nachricht verwendet wird, wenn keine der erkannten Sprachen des Absenders (
state.language) eine hat. Standardwerten. Mit beliebigem Trenner geschrieben:pt_brundpt-BRsind dasselbe Tag.- DEFAULT_MESSAGE_SECTION
(Zeichenkette, optional) Der Konfigurationsabschnitt, der eine Inline-Nachrichtenvorlage je Sprache enthält, als
<LANG> = <template>. Standardwertpepsi-vacation-default-message, das mit zehn Sprachen in${DATADIR}/config.dausgeliefert wird. EineMESSAGE_<LANG>-Option je Adresse dieses Abschnitts hat je Sprache Vorrang davor.- MESSAGE_<LANG>
(Zeichenkette, optional) Der eigene Benachrichtigungstext der Adresse für eine Sprache (
MESSAGE_EN,MESSAGE_DE_CH, …), eine Mustache-Vorlage, in der zwei Leerzeichen zu einem Zeilenumbruch werden. Wird nur für diese Sprache vor DEFAULT_MESSAGE_SECTION herangezogen. Als Option des eigenen Abschnitts der Stage ist es die eine Form, die ein Benutzer überpepsi.settingssetzen kann; der von DEFAULT_MESSAGE_SECTION genannte Abschnitt wird immer aus der Basiskonfiguration gelesen.- EMERGENCY_CONTACT
(Adresse, optional) Eine einzelne bloße Adresse, die der Nachrichtenvorlage als
{{EMERGENCY_CONTACT}}angeboten wird. Standardmäßig nicht gesetzt, in welchem Fall der{{#EMERGENCY_CONTACT}}-Block einer Vorlage übersprungen wird. Ein Anzeigename oder eine Adressliste wird abgelehnt.- VACATION_TAG
(Zeichenkette, optional) An den
Subject:der weitergeleiteten Nachricht angehängt, wenn eine Notiz gesendet wurde, sodass der Empfänger sehen kann, welche Mail für ihn beantwortet wurde. Standardwert[VACATION]; der Sentinel-Wertnonedeaktiviert das Markieren. Ein leerer Wert tut es nicht — der Parser liest eine leere Option als abwesend, was den Standardwert erneut anwendet. Das Anhängen ist idempotent.- SUPPRESS_DAYS
(ganzzahlig, optional) Wie lange nach der Antwort an einen Korrespondenten dieser erneut beantwortet werden darf. Standardwert
7(dervacation-Standardwert von Sieve, RFC 5230 §4.1);0beantwortet jede Nachricht. Darf3650(zehn Jahre) nicht überschreiten — der Wert wird zu einem SQL-Intervall, das vonnow()subtrahiert wird, und ein größerer schiebt das Ergebnis aus demtimestamptz-Bereich, was jede Nachricht an die Adresse fehlschlagen ließe statt der Konfiguration, die ihn gesetzt hat.- REQUIRE_ADDRESSED_TO
(boolesch, optional) Nur antworten, wenn der Empfänger in
To:,Cc:,Resent-To:oderResent-Cc:erscheint (RFC 3834 §3), sodass eine Blindkopie oder eine Rundsendung an eine abgegriffene Liste keine Antwort auslöst. Standardwertyes.- REQUIRE_AUTHENTICATED
(boolesch, optional) Nur einem Absender antworten, dessen Umschlagdomain SPF bestanden hat oder dessen
From:-Domain DMARC bestanden hat (lokal eingelieferte Mail zählt). Standardwertno: Ein eindeutigesfailwird nie beantwortet, ein unbestätigter Absender (softfail,neutral,none, ein vorübergehender Fehler) schon.yeslässt einen Korrespondenten bei einer Domain, die keinen der beiden Einträge veröffentlicht, unbeantwortet, und im Gegenzug löst ein gefälschter Absender bei einer solchen Domain keine Benachrichtigung aus. Die Pay-to-Send- und die Listenbefehls-Stage nehmen dieselbe Option; die des Secretary ist standardmäßig an. Gleich welcher Wert, ein Absender, der nicht bestanden hat, wird ohne seine eigenen Worte beantwortet: kein zitierter Betreff, und{{SENDER_NAME}}ist seine Adresse statt seinesFrom:-Anzeigenamens.- SUBJECT_PREFIX
(Zeichenkette, optional) Dem ursprünglichen Betreff vorangestellt, um den Betreff der Benachrichtigung zu bilden. Standardwert
Auto:(RFC 5230 §4.5). Eine Nachricht ohne Betreff ergibt allein das Präfix, und ein bereits mit dem Präfix versehener Betreff erhält es nicht zweimal. Das Präfix steht auch allein für eine Nachricht, die verschlüsselt ankam, und für einen Absender, der SPF oder DMARC nicht bestanden hat.
95.2.1.1.22.22. pepsi-stage-secretary-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-secretary hält Mail von Absendern zurück, die keine Whitelist kennt, und bittet sie, per Antwort zu bestätigen (Confirm-to-Send). Jede der folgenden Optionen außer NEXT_STAGE und BOUNCE_STAGE ist adressbezogen überschreibbar, sodass ein Benutzer seinen eigenen Challenge-Text oder PENALTY festlegen kann. Siehe pepsi-stage-secretary(1).
- NEXT_STAGE
(Zeichenkette, erforderlich) Wo auf der Whitelist stehende, bestätigte und nie rückgefragte Mail (ein Bounce, lokal eingelieferte Mail) weiterläuft.
- RESPONSE_STAGE
(Zeichenkette, erforderlich) Wohin die Challenge und der Bestätigungshinweis als neue Nachrichten mit Null-Absender injiziert werden (typischerweise die DKIM-Signier-Stage).
- BOUNCE_STAGE
(Zeichenkette, optional) Der Zeitüberschreitungspfad: wohin zurückgehaltene Mail geht, wenn niemand rechtzeitig bestätigt hat, die Challenge gebounct ist oder
state.spamtrueist, und wohin Mail geht, die nicht herausgefordert werden darf, wenn UNCHALLENGEABLE_STAGE nicht gesetzt ist. Ist sie nicht gesetzt, wird solche Mail gelöscht.- UNCHALLENGEABLE_STAGE
(Zeichenkette, optional) Wohin Mail geht, die nicht rückgefragt werden darf: RFC 3834 sagt, sie nicht zu beantworten, ihr SPF- oder DMARC-Urteil ist
fail, der Absender ist auch ein Empfänger, ihrFrom:ist nicht der Umschlagabsender, der Absender ist nicht authentifiziert, das Tageskontingent des Absenders ist aufgebraucht, oder WHITELIST_NAME lässt sich für die Empfänger nicht expandieren. Ist sie nicht gesetzt, nimmt solche Mail den Zeitüberschreitungspfad.- WHITELIST_NAME
(Zeichenkette, erforderlich) Die eine Whitelist, in die ein bestätigter Absender geschrieben wird; darf eine
{login}/{localpart}-Vorlage sein, die je Empfänger expandiert wird wie bei pepsi-stage-check-whitelist(1). Eine Liste von Namen wird abgelehnt. Der Betreiber darf jede Whitelist benennen; ein Wert, den ein Kontoinhaber per Mail über pepsi-stage-edit-settings(1) setzt, muss eine in seinem eigenen<login>/...-Namensraum benennen oder diejenige, die die Konfiguration des Betreibers für ihn benennt.- CONTROL_LOCAL_PART
(Zeichenkette, optional) Lokaler Teil der Antwortadresse
<CONTROL_LOCAL_PART>-<cookie>@<domain>. Standardwertsecretary; höchstens 30 ASCII-Buchstaben, Ziffern,.,_oder-, weder mit.oder-beginnend noch endend und ohne...- HOLD_TIME
(Dauer, optional) Wie lange zurückgehaltene Mail wartet. Standardwert
120 h; nur die Einheitenh,munds; muss positiv sein.- REQUIRE_AUTHENTICATED
(boolesch, optional) Nur einem Absender eine Challenge senden, dessen SPF- oder DMARC-Prüfung bestanden wurde. Standardwert
yes.- MAX_CHALLENGES_PER_SENDER
(ganzzahlig, optional) Wie viele Challenges an eine Adresse pro 24 Stunden gesendet werden dürfen, über alle Whitelists hinweg. Standardwert
5;0bedeutet keine Begrenzung.- DKIM_REQUIRED
(auto|yes|no, optional) Das
dkim_requireddes Whitelist-Datensatzes, den eine Bestätigung schreibt.auto(der Standardwert) macht es erforderlich, wenn irgendeine für die Challenge zurückgehaltene Nachricht DKIM (oder ARC mit DMARC) bestanden hat; wenn keine das tat, aber eine DMARC bestanden hat (ein ausgerichteter SPF-Pass oder die Übersteuerung durch einen vertrauenswürdigen ARC-Versiegler), erhält der Datensatz stattdessendmarc_required.noschreibt keines von beiden.- CONFIRM_NOTICE
(boolesch, optional) Einem bestätigten Absender mitteilen, dass seine Mail zugestellt wurde. Standardwert
no.- PENALTY
(Zeichenkette, optional) Was der Absender zu zahlen zusagt, falls seine Nachricht unerwünscht war; der Vorlage als
{{PENALTY}}angeboten. Standardmäßig nicht gesetzt.- SUBJECT_HINT_LENGTH
(ganzzahlig, optional) Wie viele Zeichen des Betreffs der zurückgehaltenen Nachricht die Challenge zitiert. Standardwert
8;0lässt den Hinweis weg; höchstens64.- TEMPLATE
(Zeichenkette, optional) Basisname der
<TEMPLATE>.<lang>.body-Challenge-Vorlagen unter[pepsi] TEMPLATE_DIR. Standardwertsecretary-challenge.- SUBJECT
(Zeichenkette, optional) Der Betreff der Challenge, wenn kein
SUBJECT_<LANG>zur gewählten Sprache passt. StandardwertPlease confirm your message to {{RECIPIENT}}, und solange er nicht gesetzt ist, erhält ein in einer der zehn mitgelieferten Sprachen gewählter Text stattdessen den mitgelieferten Betreff dieser Sprache; ein ausdrücklicher Wert wird für jede Sprache ohneSUBJECT_<LANG>verwendet.- DEFAULT_LANGUAGE
(Zeichenkette, optional) Die Sprache, die verwendet wird, wenn keine der erkannten Sprachen des Absenders einen Text hat. Standardwert
en. pepsi-setup(1) verlangt dafür eine Vorlage oder einMESSAGE_<LANG>.- MESSAGE_<LANG>, SUBJECT_<LANG>, CONFIRM_MESSAGE_<LANG>
(Zeichenkette, optional) Sprachspezifischer Challenge-Text, Challenge-Betreff und Bestätigungstext, die die Vorlagen nur für diese Sprache überschreiben.
- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(optional) Die gemeinsamen Lokalitätsoptionen (pepsi-stage-relay-to-maildir(1)): an welchen Domains eine Antwortadresse liegen darf und wie die Platzhalter in Whitelist-Namen expandiert werden.
LOCAL_DOMAINShat den Standardwert[pepsi-ingress] ACCEPTED_DOMAINS.
95.2.1.1.22.23. pepsi-stage-if-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-if verzweigt anhand eines Mitglieds des state-JSON der Nachricht:
- STATE_PATH
(Zeichenkette, erforderlich) Der punktgetrennte Pfad in das Nachrichten-
state, dessen Wert getestet wird (Objektschlüssel und ganzzahlige Array-Indizes, z. B.spam,auth.dkim,dsn.rcpt.0.notify).- VALUE
(Zeichenkette, erforderlich, nicht leer) Der Wert, mit dem das Mitglied bei STATE_PATH verglichen wird, nach seiner natürlichen Skalar-Textform (Zeichenkette,
true/false, Dezimalzahl odernull). Eine leere Option gilt als nicht gesetzt.- TRUE_STAGE
(Zeichenkette, erforderlich) Wohin die Nachricht weiterschaltet, wenn der Wert gleich VALUE ist. pepsi-setup(1) prüft, dass es eine existierende Stage benennt.
- FALSE_STAGE
(Zeichenkette, erforderlich) Wohin die Nachricht andernfalls weiterschaltet (der Wert weicht ab, der Pfad fehlt oder er löst auf ein Array/Objekt auf). pepsi-setup(1) prüft, dass es eine existierende Stage benennt.
95.2.1.1.22.24. pepsi-stage-milter-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-milter übergibt die Nachricht an einen bestehenden Milter-Daemon (das Mailfilter-Protokoll von sendmail/Postfix) und routet sie nach dem Urteil des Filters. Siehe pepsi-stage-milter(1), und beachten Sie insbesondere, dass der Filter nach der Warteschlange läuft, sodass ein REJECT einen Bounce kostet, wo ein MTA innerhalb der SMTP-Sitzung mit 5xx geantwortet hätte.
- SOCKET
(Zeichenkette, erforderlich) Wo der Milter-Daemon lauscht, in sendmails
S=-Grammatik (die Postfix ebenfalls annimmt):unix:/path(oder sein Synonymlocal:/path),inet:host:port,inet:port@host,inet6:[addr]:portoderinet6:port@addr. Ein bloßer Pfad ohne Schema wird abgelehnt. Pepsi verbindet sich mit diesem Socket; es startet, stoppt oder sperrt den Daemon dahinter nie ein.- MILTER_NAME
(Zeichenkette, optional) Wird dem Filter als Makro
{daemon_name}exportiert und in Log-Meldungen verwendet. Standardwert ist der eigene Name der Stage.- ACCEPT_STAGE
(Zeichenkette, optional) Wohin
SMFIR_ACCEPTdie Nachricht schickt. Standardwert ist NEXT_STAGE, was Annehmen und Fortfahren zur selben Sache macht; setzen Sie es, um am Rest einer Filterkette vorbeizuspringen, was Postfix‘ Milter-Liste nativ tut. pepsi-setup(1) prüft, dass es eine existierende Stage benennt.- REJECT_STAGE
(Zeichenkette, optional) Wohin
SMFIR_REJECTdie Nachricht schickt und wohin einzeln abgelehnte Empfänger aufgefächert werden. Standardwert ist dasBOUNCE_STAGEdes Abschnitts. Richten Sie es auf ein pepsi-stage-discard(1), um abgelehnte Mail zu verwerfen, statt sie zu bouncen. pepsi-setup(1) prüft, dass es eine existierende Stage benennt.- QUARANTINE_STAGE
(string, optional) Where
SMFIR_QUARANTINEsends the message. Unset means discard: Pepsi has no quarantine store, only a route. A quarantine request decides the routing regardless of the verdict that follows it, because a sendmail milter quarantines and then still returns an accept. pepsi-setup(1) checks that it names an existing stage.- ON_FAILURE
(``tempfail``/``accept``/``reject``/``discard``, Standardwert ``tempfail``) Was zu tun ist, wenn der Milter nicht erreicht werden kann, Zeitüberschreitungen hat oder etwas Unparsbares spricht — Postfix‘
milter_default_action, mit demselben Standardwert.tempfailpausiert die Nachricht zur Wiederholung, sodass ein ausgefallener Filter Mail verzögert, statt sie zu verlieren oder ungefiltert durchzulassen. Eine Nachricht, die nach MAX_LIFETIME noch immer zurückgestellt ist (auf diesem Weg oder durch das eigeneSMFIR_TEMPFAILdes Filters), geht an dasBOUNCE_STAGEdes Abschnitts oder bleibt, wenn es keines gibt, für pepsi-failure-bouncer(1)failed— nie an REJECT_STAGE, das Mail stillschweigend verwerfen kann.- ALLOW_ACTIONS
(Zeichenkette, Standardwert ``addhdrs chghdrs chgbody``) Die dem Filter angebotenen
SMFIF_*-Änderungsaktionen, leerraum- oder kommagetrennt:addhdrs,chghdrs,chgbody,addrcpt,delrcpt,addrcpt_par,chgfrom,quarantine; dazu die Kurzformenallundnone. Es gibt keininshdr: libmilter bindet auch das Einfügen von Headern anSMFIF_ADDHDRS.Ohne Sandbox um den Filter herum ist diese Maske das einzige Mittel, um zu begrenzen, was der Filter ändern kann, und beim Standardwert zählt das am meisten: Jeder Inhaltsfilter arbeitet darunter, während einem Filter, der den Umschlag umschreiben will, das ausdrücklich gewährt werden muss. Ein Filter, der eine nicht angebotene Aktion verlangt, wird namentlich gemeldet und nimmt den ON_FAILURE-Pfad, statt seine Änderungen stillschweigend verworfen zu bekommen, wie Postfix sie verwirft.
SMFIF_SETSYMLISTist bewusst nicht aufgeführt und braucht keine Gewährung: Es autorisiert keine Änderung an der Nachricht.- PROTOCOL_VERSION
(ganzzahlig 2–6, Standardwert 6) Die höchste angebotene Milter-Protokollversion; der Filter handelt von ihr abwärts. Postfix‘
milter_protocol.- CONNECT_TIMEOUT
(Dauer, Standardwert ``30 s``) Schranke für das Herstellen der Verbindung und das Abschließen der Optionsaushandlung — beide Hälften von „ist dieser Filter überhaupt erreichbar“. Postfix‘
milter_connect_timeout.- COMMAND_TIMEOUT
(Dauer, Standardwert ``30 s``) Schranke für die Antwort auf einen einzelnen Befehl bis zum Ende des Nachrichtentexts. Postfix‘
milter_command_timeout.- CONTENT_TIMEOUT
(Dauer, Standardwert ``300 s``) Schranke für das Urteil am Nachrichtenende, wo ein Inhaltsfilter seine eigentliche Arbeit tut. Ein
SMFIR_PROGRESSvom Filter startet die Uhr neu, aber ein Warten auf eine Antwort wird insgesamt nie über das Zehnfache seines Timeouts hinaus verlängert; ein Filter, der dann noch Fortschritt meldet, nimmt den ON_FAILURE-Pfad. Postfix‘milter_content_timeout.Jeder der drei Timeouts muss größer als null und höchstens
24 hsein.- RETRY_INITIAL / RETRY_MAX_INTERVAL / RETRY_FACTOR / MAX_LIFETIME
(Dauern / Zahl, optional) Der geteilte Wiederholungsplan für den Tempfail-Pfad, mit derselben Bedeutung wie in den Relay-Stages. Standardwerte:
300 s,1 h,2,120 h. Es gibt kein DELAY_DSN_AFTER: Eine Nachricht, die der Filter immer wieder aufschiebt, erzeugt keine „delayed“-DSN, nur den Bounce, sobald MAX_LIFETIME abgelaufen ist, und pepsi-setup(1) meldet die Option in einem Milter-Abschnitt als unbekannt.- MACROS_CONNECT / MACROS_HELO / MACROS_MAIL / MACROS_RCPT / MACROS_DATA / MACROS_EOH / MACROS_EOM
(Zeichenkette, optional) Die in jeder Protokollphase exportierten sendmail-Makros, leerraum- oder kommagetrennt. Die Standardwerte sind die von Postfix, sodass die eigene Dokumentation eines Filters unverändert gilt:
j {daemon_name} {daemon_addr} v _,{tls_version} {cipher} {cipher_bits} {cert_subject} {cert_issuer},i {auth_type} {auth_authen} {auth_author} {mail_addr} {mail_host} {mail_mailer},i {rcpt_addr} {rcpt_host} {rcpt_mailer}undifür die übrigen drei. Ein Makro, dessen Wert diese Installation nicht kennt, wird überhaupt nicht gesendet. Setzen Sie eine Liste auf den Sentinelnone, um in dieser Phase nichts zu exportieren — ein leerer Wert liest sich als abwesend und wendet den Standardwert erneut an. Ein Filter, der mitSMFIF_SETSYMLISTseine eigene Liste benennt, überschreibt diese.
95.2.1.1.22.25. pepsi-stage-quarantine-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-quarantine hält jede Nachricht zurück, die sie erreicht (paused, ohne timeout, sofern MAX_HOLD nicht gesetzt ist), bis ein Betreiber sie mit pepsi-queue quarantine release freigibt oder sie löscht. Eine von RELEASE_STAGE und NEXT_STAGE ist erforderlich. Die Optionen werden aus dieser Datei gelesen, nie aus Einstellungen pro Adresse. Siehe pepsi-stage-quarantine(1).
- RELEASE_STAGE
(Zeichenkette, optional) Wohin eine freigegebene Nachricht geht. Standardwert ist NEXT_STAGE. Für Mail, die Ingress in Quarantäne gestellt hat und die daher jede Stage vor dieser übersprungen hat, ist es normalerweise
init. Darf nicht diese Stage sein.- MAX_HOLD
(Zeitspanne, optional) Das längste Zurückhalten, zum Beispiel
14 days,2 weeksoder36 h; ein Tag zählt als 24 Stunden, und Monate und Jahre werden abgelehnt. Das Ende eines Zurückhaltens wird festgehalten, wenn es beginnt. Ohne Wert dauert ein Zurückhalten, bis die Nachricht freigegeben oder gelöscht wird, und[pepsi-queue] QUARANTINE_MAX_AGE_DAYSbegrenzt es wie bei jeder Quarantäne-Stage; mit Wert beendet die Stage ihre Zurückhaltungen selbst, undpepsi-queue gclässt sie in Ruhe.- EXPIRE_STAGE
(Zeichenkette, optional) Wohin eine Nachricht geht, wenn ihr Zurückhalten MAX_HOLD erreicht, markiert mit
failure_class = quarantine-expiredundRET=HDRSfür eine DSN. Ohne Wert wird die Nachricht gelöscht. Erfordert MAX_HOLD; darf nicht diese Stage sein.
95.2.1.1.22.26. pepsi-stage-route-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-route wählt für jeden Umschlagempfänger eine nächste Stage anhand der Domain dieses Empfängers und teilt die Nachricht auf Geschwisterdatensätze auf, wenn die Empfänger uneinig sind. Sie existiert für ein Gateway, das vor einem anderen Mailsystem sitzt (siehe das Kapitel „Microsoft Exchange als Gateway“ des Handbuchs): Die Domains hinter einem solchen Gateway sind genau die Domains, deren öffentlicher MX das Gateway ist, sodass eine von ihnen zu einem Direkt-zum-MX-Relay zu routen eine Mail-Schleife ist statt eines Zustellfehlschlags.
Die Abfragereihenfolge je Empfänger ist ROUTES, dann die Menge der verwalteten Domains, dann NEXT_STAGE.
- ROUTES
(Zeichenkette, optional) Leerraum- oder kommagetrennte
<domain-pattern>=<stage>-Paare, zuerst und in der geschriebenen Reihenfolge herangezogen. Muster werden ohne Beachtung der Groß-/Kleinschreibung abgeglichen und dürfen*enthalten, das auf eine beliebige Zeichenfolge passt; sie sind Globs, keine regulären Ausdrücke, und an beiden Enden verankert, sodass*.example.orgaufmail.example.orgpasst, aber weder aufexample.orgnoch aufmail.example.org.evil.test. Ein Wert, der wie ein regulärer Ausdruck aussieht, wird abgelehnt, statt stillschweigend auf nichts zu passen. Explizite Regeln werden vor der verwalteten Menge herangezogen, sodass eine Subdomain herausgeschnitten werden kann, ohne ihr Elternteil aus MANAGED_DOMAINS zu entfernen.- MANAGED_DOMAINS
(Zeichenkette, optional) Die Domains hinter diesem Gateway, leerraum- oder kommagetrennt,
*-Globs erlaubt. Standardwert ist[pepsi-ingress] ACCEPTED_DOMAINS, sodass die Menge nicht von dem abdriften kann, was der Ingress tatsächlich annimmt. Mindestens eine Domain muss sich aus einer der beiden Quellen ergeben.- MANAGED_STAGE
(Zeichenkette, optional) Wohin ein Empfänger an einer verwalteten Domain geht — in einer Gateway-Installation die Stage, die zum dahinterliegenden System weiterleitet. Ohne sie nehmen verwaltete Empfänger NEXT_STAGE, und pepsi-setup(1) muss dann nachweisen, dass das keine Schleife ist.
- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin jeder andere Empfänger geht. Erforderlich: Die Stage stellt nie zu, bounct nie und verwirft nie eine Nachricht, sodass jeder Empfänger irgendwohin muss.
- RECIPIENT_CHECK
(``none``, ``probe`` oder ``map``, optional) Wie pepsi-ingress(1) erfahren kann, ob eine Adresse an einer verwalteten Domain auf dem System hinter dem Gateway existiert, sodass es eine unbekannte zum
RCPT-Zeitpunkt ablehnen kann (siehe[pepsi-ingress] VERIFY_RECIPIENTS). Die Route selbst liest sie nie; sie steht hier, weil dieser Abschnitt das Backend beschreibt. Nur zusammen mit MANAGED_STAGE verwendet.none(der Standard) lässt die verwalteten Domains unverifiziert: Jede Adresse wird angenommen, und der eigene Bounce des Backends ist die Antwort.probefragt das Backend:MAIL FROM:<>,RCPT TO,RSET, ohne dass eine Nachricht gesendet wird. Nur eine5.1.x-Ablehnung (oder ein bloßes550) zählt als „kein solcher Benutzer“. Alles andere nimmt die Adresse an: ein nicht erreichbares Backend, eine Zurückstellung oder ein volles Postfach. Antworten werden zwischengespeichert, ein „ja“ eine Stunde lang und ein „nein“ fünf Minuten lang. Ein Backend, das jede Adresse annimmt und später bounct (Exchange mit ausgeschalteter Empfängerfilterung), antwortet immer „ja“; für ein solches Backend verwenden Siemap, das die gültigen Adressen aus RECIPIENT_MAP liest.- PROBE_HOST, PROBE_PORT, PROBE_TLS, PROBE_TIMEOUT
(optional; PROBE_HOST für ``probe`` erforderlich) Wohin und wie geprobt wird: der Hostname oder die Adresse des Backends, sein Port (Standard
25),opportunistic(der Standard),starttls,tlsodernone, und das Timeout je Befehl (Standard10 s). Die Probe trägt eine Adresse, nie eine Nachricht, daher akzeptiert opportunistisches TLS jedes Zertifikat, wie es die Zustellung an einen MX tut;starttlsundtlsverifizieren es.- RECIPIENT_MAP
(Pfad; für ``map`` erforderlich) Die gültigen Adressen, eine pro Zeile: eine Adresse oder
@domainfür jede Adresse an einer Domain. Alles nach dem ersten Wort wird ignoriert, sodass die Quelldatei einer Postfix-Tabellerelay_recipient_maps(alice@example.org OK) unverändert verwendet werden kann.#leitet einen Kommentar ein. Die Datei wird bei jeder Prüfung gelesen. Lässt sie sich nicht lesen, wird jede Adresse angenommen.
pepsi-setup(1) prüft, dass jedes Ziel eine existierende Stage benennt, und lehnt eine Konfiguration ab, in der eine Nachricht für eine verwaltete Domain pepsi-stage-relay-to-internet(1) erreichen könnte — indem es über NEXT_STAGE und etwaige weitere Routing-Stages vorwärtsläuft, aber bewusst nicht über BOUNCE_STAGE (ein Bounce ist eine neue Nachricht über eine bereits gescheiterte Zustellung und erreicht rechtmäßig ein Relay).
95.2.1.1.22.27. pepsi-stage-aliases-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-aliases expandiert die Umschlagempfänger einer Nachricht über eine Alias-Zuordnungsdatei, bevor sie sie weiterleitet:
- ALIASES
(string, required) The alias map file, parsed like a Postfix virtual(5) table. The value is a filesystem path taken verbatim, so unlike a path-typed option it is not
$-expanded. Each line maps a key (a full address, an@domaincatch-all, or a*wildcard such assales-*@example.org) to one or more comma/whitespace-separated target addresses;#comments and blank lines are ignored. Recipients matching a key are replaced by its targets (transitively, with a loop guard) and the result is de-duplicated; on competing wildcards the most specific match wins. The file is re-read only when its identity (modification time, size or inode) changes; a missing file is treated as an empty map, while a file that exists but cannot be read is an error and the message is retried. pepsi-setup(1) syntax-checks it at install time when present. See pepsi-stage-aliases(1).- NEXT_STAGE
(string, required) Where the (expanded) message advances. pepsi-setup(1) checks that it names an existing stage.
95.2.1.1.22.28. pepsi-stage-edit-settings-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-edit-settings liest:
- EDITABLE_STAGES
(Liste, erforderlich) Durch Leerraum/Komma getrennte Stage-Namen, deren Optionen eine Steuer-E-Mail ändern darf. Mindestens einer ist erforderlich, jeder muss eine bestehende Stage benennen (pepsi-setup(1) prüft das), und ein Nachrichtentext, der eine hier nicht aufgeführte Stage anspricht, wird abgelehnt.
- RESPONSE_STAGE
(Zeichenkette, erforderlich) Stage, bei der die Antwort injiziert wird (typischerweise der Beginn des ausgehenden Signier-/Relay-Pfads), sodass sie DKIM-signiert und zugestellt wird. Muss auf eine existierende Stage auflösen.
- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin eine Nachricht, die keine Steuernachricht ist, weitergeschaltet wird. pepsi-setup(1) lehnt einen Abschnitt ohne eine solche Stage ab.
- SUBJECT
(Zeichenkette, optional) Der genaue Betreff (unter Beachtung der Groß-/Kleinschreibung verglichen, umgebender Leerraum ignoriert), der eine Steuernachricht kennzeichnet, und der Betreff der Antwort. Standardwert
Pepsi.- CONTROL_LOCAL_PART
(Zeichenkette, optional) Local-Part der Steueradresse. Standardwert
pepsi.- RESPONSE_FROM
(Zeichenkette, optional)
From:-Header der Antwort. Standardwert<CONTROL_LOCAL_PART@domain>für die kontrollierte Domain, an die die Nachricht adressiert war.- UNRESTRICTED_UNSAFE_STAGES
(boolesch, optional) Hebt die Sicherheitsbeschränkung dessen auf, was eine Steuer-E-Mail setzen darf. Standardwert
NO.Mit dem Standardwert werden vier Dinge abgelehnt, wie freizügig EDITABLE_STAGES auch sein mag. Eine Zuweisung, die das
PROGRAMeiner Stage setzt, wird nur angenommen, wenn der Wert ein bloßerpepsi-stage-*-Befehl ohne Pfadanteil ist, sodass ein Kontoinhaber keine seiner bearbeitbaren Stages auf eine beliebige ausführbare Datei richten kann. Eine Zuweisung, dieHELPERsetzt (das Programm, das eine Zustell-Stage mit ihrem setgid-Privileg ausführt), wird abgelehnt, sofern sie es nicht nur zurücksetzt; dasselbe gilt fürSCAN_HELPER,MAILBOX_HELPERundPIN_COMMAND, die anderen Optionen, die ein auszuführendes Programm nennen. Eine Zuweisung, die eine Identitäts-Option setzt, wird rundweg abgelehnt, da es keinen sicheren Wert gibt, den man zulassen könnte. Diese Optionen sindSIGNING_DOMAIN, das die eigeneFrom:-Domain der Nachricht überschreibt und die Mail eines Kontos daher als jede Domain signieren ließe, für die dieser Host einen Schlüssel hält, sowieWALLET_MODE,WALLET_SCOPEundWALLET_USERvon Auto-Pay, die auswählen, wessen Wallet zahlt. Auch eine Ausgabengrenze,MAX_TOTALundMAX_TOTAL_PER_DAYvon Auto-Pay, wird abgelehnt, weil eine Steuernachricht durch dasselbe Submission-Passwort authentifiziert wird, dessen Diebstahl diese Grenzen eindämmen. Dies aufYESzu setzen entfernt alle vier Prüfungen. Die Option ist nach dem benannt, was sie tut: Es gibt keinen Grund, sie einzuschalten, es sei denn, Sie vertrauen jeder Adresse, deren Überschreibungen bearbeitbar sind.
95.2.1.1.22.29. pepsi-stage-vks-confirm-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-vks-confirm folgt dem Bestätigungslink in der Adressverifikationsmail eines Keyservers, sodass ein hochgeladener Schlüssel nach Adresse auffindbar wird. Sie sitzt auf dem eingehenden Pfad und schaltet alles, worauf sie nicht reagiert — nahezu alle Mail —, unangetastet weiter. Siehe pepsi-stage-vks-confirm(1) für die vollständige Liste der Bedingungen, die sie prüft, bevor sie irgendetwas abholt.
- NEXT_STAGE
(string, required) Where every message that this stage does not consume goes. Required rather than optional: a stage on the inbound path that silently dropped what it did not recognise would lose ordinary mail. pepsi-setup(1) checks that it names an existing stage.
- VKS_HOST
(Zeichenkette, optional) Der einzige Host, von dem eine Verifikationsmail kommen und auf den ein Link zeigen darf. Standardwert ist der Host von
[pepsi-keys] VKS_SERVER, und pepsi-setup(1) lehnt jeden anderen Host ab: Uploads gehen an diesen Server, sodass dessen Verifikationsmail die einzige Art ist, auf die hin zu handeln die Stage existiert. Exakt abgeglichen: Eine Subdomain eines Keyservers ist nicht der Keyserver. Die Option ist nur wegen dieses Rückfalls optional: Ohne sie und ohne einenVKS_SERVER-Host verweigert die Stage den Start, da sie die Mail eines Keyservers von der irgendeines anderen nicht unterscheiden kann.- MAX_LINKS
(ganzzahlig, optional) Wie vielen Links die Stage für eine Nachricht höchstens folgt. Standardwert
3, Minimum1(0wird abgelehnt: Um überhaupt keinen Links zu folgen, nehmen Sie die Stage aus der Pipeline). Eine echte Verifikationsmail trägt einen; die Schranke verhindert, dass eine Nachricht, die an jeder anderen Prüfung vorbeikam, zu einer beliebigen Anzahl von Anfragen wird.- DISCARD_CONFIRMED
(boolesch, optional) Ob eine Bestätigungsmail, auf die die Stage reagiert hat, gelöscht statt zugestellt wird. Standardwert
YES: Es ist Maschinenmail über eine Handlung, die Pepsi vorgenommen hat, gerichtet an ein Postfach, dessen Eigentümer nicht darum gebeten hat, und sie ist bereits abgearbeitet, wenn sie ankäme. Gelöscht wird nur eine Mail, nach der mindestens eine Identität als veröffentlicht verifiziert wurde; wenn das Folgen ihrer Links nichts verifiziert hat, wird sie trotzdem zugestellt.- REQUIRE_AUTHENTICATION
(boolesch, optional) Ob SPF oder DMARC bestanden haben muss, nicht bloß der Umschlagabsender VKS_HOST entsprechen muss. Standardwert
YES. Beachten Sie, dass ein DKIM-Bestehen dies bewusst nicht erfüllt: Es sagt, dass eine Signatur durchging, nicht wessen.
Es gibt kein BOUNCE_STAGE: Die Stage lässt eine Nachricht nie fehlschlagen.
95.2.1.1.22.30. pepsi-stage-dmarc-report-Optionen¶
Eine Stage mit PROGRAM = pepsi-stage-dmarc-report liest die DMARC-Aggregatberichte (RFC 7489 §7.2), die andere Empfänger an die rua=-Adresse der bedienten Domains senden, und speichert sie in pepsi.dmarc_report. Sie sitzt auf dem eingehenden Weg, vor den Whitelist-, Challenge- und Zahlungsschranken, und schaltet alles, was nicht an die Berichtsadresse gerichtet ist, unverändert weiter. Der globale Abschnitt [pepsi-dmarc-reports] konfiguriert Speicherung und Urteilsfenster. Siehe pepsi-stage-dmarc-report(1).
- NEXT_STAGE
(Zeichenkette, erforderlich) Wohin jede Nachricht geht, die kein Bericht ist. pepsi-setup(1) prüft, dass es eine existierende Stage benennt.
- LOCAL_PART
(Zeichenkette, optional) Der Local-Part, bei dem die Berichte ankommen, bei jeder LOCAL_DOMAINS-Domain, verglichen nach dem Abtrennen der Unteradresse. Standardwert
dmarc-reports. Die Empfängerprüfung beiRCPTnimmt ihn bei jeder bedienten Domain an, und pepsi-setup(1) nennt ihn imrua=des DMARC-Eintrags, den es vorschlägt.- DELIVER
(boolesch, optional) Die Berichtsmail zusätzlich an NEXT_STAGE weiterreichen, für eine Installation, die unter der Adresse ein Postfach führt. Standardwert
NO: Die Mail wird verbraucht (gespeichert, wenn sie ein lesbarer Bericht über eine bediente Domain ist, sonst verworfen).- MAX_REPORT_SIZE
(Größe, optional) Obergrenze für einen dekomprimierten Bericht; eine Gzip- oder Zip-Bombe endet hier. Standardwert
16M;nonewird abgelehnt.- LOCAL_DOMAINS, RECIPIENT_DELIMITER
(optional) Die bedienten Domains (Standardwert
[pepsi-ingress] ACCEPTED_DOMAINS) und das Trennzeichen für Unteradressen (Standardwert[pepsi] RECIPIENT_DELIMITER, sonst+).
Es gibt kein BOUNCE_STAGE: Die Stage erzeugt nie einen Bounce.
95.2.1.1.23. Der Abschnitt [pepsi-dispatch]¶
Optionen für pepsi-dispatch(1). Die Worker-Pool-Dimensionierung pro Stage (PARALLELISM, MAX_MESSAGES, QUEUE_LIMIT) liegt in jedem [stage-<name>]-Abschnitt oben, nicht hier. Jede Dauer unten muss größer als null und höchstens 168 h sein; pepsi-setup(1) und der Dispatcher lehnen alles andere ab.
- CONFIG_FILE
(Pfad, optional) Die Konfigurationsdatei, die gestarteten Workern über
-cübergeben wird. Setzen Sie sie auf den Pfad dieser Datei, wann immer der Dispatcher mit einem expliziten-cgestartet wird (der geladene Pfad kann sonst nicht wiederhergestellt werden); wenn nicht gesetzt, verwenden Worker die Standard-Konfigurationssuche.- POLL_INTERVAL
(Dauer, optional) Sicherheitsnetz-Herzschlag: die längste Zeit, die der Dispatcher schläft, wenn kein früherer
paused-Wiederholungsversuch, kein Worker-Abbau und kein Spawn-Cooldown fällig ist; danach sucht er erneut nach Arbeit und reiht fälligepaused-Datensätze wieder ein. Standard 30 s. Es ist eine absolute Frist, keine Ruhephase: Nachrichtenverkehr und ein kürzeres STATS_INTERVAL verschieben sie nicht, sodasspaused-Datensätze auch bei einer beschäftigten Pipeline rechtzeitig wieder eingereiht werden.- MAX_RUNTIME
(Dauer, optional) Maximale Echtzeit, die ein Worker für eine einzelne Nachricht aufwenden darf, gezählt ab dem Zeitpunkt, zu dem der Worker für sie bereit ist: Der eigene Start eines Workers wird der Nachricht nicht angerechnet und hat ein eigenes Budget (das größere von diesem Wert und 60 s; siehe pepsi-dispatch(1)). Ein Worker, der es überschreitet, wird getötet (und ersetzt), und die Nachricht erhält einen Strike: Sie wird pausiert und nach einer Minute erneut versucht (nach zwei beim zweiten Strike), und erst ihr dritter Strike setzt sie auf
timeout, außer in einerpepsi-stage-relay-to-*-Stage, wo MAX_LIFETIME entscheidet. Ein Abschnitt[stage-<name>]kann ein eigenes MAX_RUNTIME setzen, das Vorrang hat. Standardwert 300 s und 900 s für diepepsi-stage-relay-to-*-Stages, die auf andere Hosts warten; wird diese Option gesetzt, gilt der Wert auch für diese Stages.- WORKER_IDLE_TIMEOUT
(Dauer, optional) Wie lange ein untätiger Worker-Prozess behalten wird, bevor er gestoppt wird. Die Gesamtnebenläufigkeit wird pro Stage gesetzt (PARALLELISM), nicht global. Standardwert 5 s.
- STATS_INTERVAL
(Dauer, optional) Wie oft die In-Memory-Pipeline-Statistiken (von pepsi-httpd(1) unter
/metricsexportiert) in einer einzigen Transaktion in die Datenbank weggeschrieben werden. Außerdem weggeschrieben, sobald die Pipeline untätig wird (höchstens einmal pro Sekunde), und beim Herunterfahren; ein untätiger Dispatcher, der nichts Neues festzuhalten hat, schreibt nichts. Standardwert 60 s.- DB_POOL_SIZE
(Zahl, optional) Maximale Anzahl von PostgreSQL-Verbindungen im Datenbankpool des Dispatchers. Anders als ein Einzelverbindungs-Stage-Worker verarbeitet der Dispatcher die Ergebnisse vieler Worker (deren Nachrichten weiterschalten/fehlschlagen lassen) nebenläufig mit seinen eigenen Koordinator-Abfragen, daher hält er einen kleinen begrenzten Pool. Die Arbeit pro Anweisung ist kurz, sodass eine Handvoll Verbindungen starke Worker-Fluktuation aufnimmt. Standardwert ist
8; erhöhen Sie es nur, wenn dem Koordinator die Verbindungen ausgehen, und halten Sie die Summe der Pools jeder Komponente unter demmax_connectionsvon PostgreSQL.- FAIR_SCHEDULING
(boolesch, optional) Verteilt die Worker-Zeit jeder Stage fair unter den Absendern (dem authentifizierten Konto, sonst der verbindenden Adresse, eine IPv6-Adresse nach /64; siehe den Absatz über faires Scheduling zwischen Absendern in pepsi-dispatch(1)), statt strikt die ältesten zuerst zu beanspruchen, sodass der Burst eines Absenders nicht alle hinter ihm Eingereihten verzögert. Standardwert
yes;nostellt die Reihenfolge „älteste zuerst“ wieder her.- FAIR_HALF_LIFE
(Dauer, optional) Wie schnell der angesammelte Vorsprung eines Absenders an Worker-Zeit verblasst: Er halbiert sich alle FAIR_HALF_LIFE, sodass die Strafe für einen vergangenen Burst nachlässt, sobald der Absender aufhört. Standardwert 60 s.
- FAIR_FIFO_PERCENT
(Zahl, optional) Prozentsatz der beanspruchten Plätze jeder Stage, der unabhängig vom Absender für ihre ältesten wartenden Nachrichten reserviert ist. Das garantiert, dass keine Nachricht ewig wartet, gleich wie viele andere Absender weiterhin eintreffen.
1bis100;100ist „älteste zuerst“ mit zusätzlicher Buchführung (verwenden Sie dafür FAIR_SCHEDULING= no). Standardwert 10.
95.2.1.1.24. Der Abschnitt [pepsi-list]¶
Optionen für pepsi-list(1) und das Mailinglisten-Subsystem, gelesen von diesem Werkzeug, von den Listen-Stages und von pepsi-setup(1). Jede Option hat eine Voreinstellung, ein Betrieb, der keine Listen beherbergt, braucht daher überhaupt keinen Abschnitt.
Pepsis Mailinglisten-Subsystem ist eine Neuimplementierung von GNU Mailman 3; sein Datenmodell, seine REST-API, sein E-Mail-Befehlsvokabular und die Namen seiner Benachrichtigungsvorlagen sind der Entwurf des GNU-Mailman-Projekts, urheberrechtlich geschützt durch die Free Software Foundation. Siehe COPYING und vendor/PEPSI-VENDORING.md zu den von upstream übernommenen Dateien, die unter der GPL bleiben.
Die Konfiguration je Liste steht nicht hier. Listen werden zur Laufzeit von Leuten angelegt, die nicht der Betreiber sind, möglicherweise zu Tausenden; diese Datei gehört dem Betreiber und wird als Ganzes neu geladen. Die 99 Attribute je Liste liegen in der Tabelle mailing_list und werden mit pepsi-list(1) verwaltet. Was folgt, ist nur, was der Betrieb besitzt.
- SITE_OWNER
(Adresse, optional) Wohin die Benachrichtigungen einer Liste gehen, wenn die Liste keinen eigenen Verwalter hat. Ohne sie ist eine Liste ohne Verwalter für
pepsi-list checkein Fehler und keine Warnung, denn ihre zurückgehaltenen Nachrichten und Moderationsanfragen würden überhaupt niemanden erreichen.- BASE_URL
(URL, optional) Öffentliche URL, auf die die Archivlinks und die
List-*-Header zeigen, für Domains, die keine eigenebase_urlsetzen. Ohne sie kann keinList-Archive:-Header geschrieben werden. Ist sie einehttps://-URL, sind die WebAuthn-Sicherheitsschlüssel der Mitgliederseiten auch an ihren Origin gebunden (ihr Host ist ihre RP-ID); andernfalls wird Mitgliedern kein Sicherheitsschlüssel angeboten.- API_USER, API_PASS
(Zeichenkette, optional) HTTP-Basic-Zugangsdaten für die REST-API von GNU Mailman 3 – upstreams
[webservice] admin_user/admin_passunter einem Pepsi-Namen. Setzen Sie beides oder keines: eine halbe Zugangsdatenangabe authentifiziert niemanden, undpepsi-list checkmeldet eines ohne das andere als Fehler. Die API wird nur auf einem Listener mit dem FlagLIST_API = yesangeboten.- API_BASE_URL
(URL, optional) Der absolute Ursprung, aus dem die REST-API jeden
self_linkund jedesLocationbildet, das sie ausgibt, z. B.http://localhost:8001; ein abschließendes/wird entfernt. Ist er nicht gesetzt, wird der eigeneHostder Anfrage verwendet, was hinter einem Reverse-Proxy richtig ist.- API_RATE_LIMIT
(Ganzzahl, optional) Anfragen pro Minute je Quelladresse an die REST-API. Standardwert
3000, bewusst hoch, damit eine Kompatibilitäts-Testsuite nicht gedrosselt wird; ein429von dieser API stammt von diesem Begrenzer.- DEFAULT_LANGUAGE
(Zeichenkette, optional) Die Sprache, mit der eine neue Liste beginnt, und das untere Ende der Präferenzkette (
GET /<api>/system/preferences). Standardwerten.- RELEASE_STAGE
(Zeichenkette, optional) Der
[stage-<name>]-Abschnitt, der pepsi-stage-list-post(1) ausführt und bei dem eine gehaltene Nachricht, die ein Moderator annimmt, wieder in die Pipeline eintritt. Ohne ihn können gehaltene Nachrichten gelesen und verworfen, aber nicht angenommen werden, und pepsi-setup(1) warnt.pepsi-list digestspeist Digest-Ausgaben bei derselben Stage ein, undpepsi-list checkwarnt vor einer Liste mitdigests_enabled, wenn er nicht gesetzt ist.- NOTICE_STAGE
(Zeichenkette, optional) Die Stage, bei der die periodischen Durchläufe von
pepsi-list tasksihre Benachrichtigungen einspeisen: die Mitgliederbenachrichtigungen der Bounce-Durchläufe und die Benachrichtigung der Moderatoren über abgelaufene zurückgehaltene Beiträge. pepsi-setup(1) verlangt sie und prüft, dass sie eine existierende Stage benennt, sobald eine pepsi-stage-list-bounce(1)-Stage existiert: Ohne sie steigt der Warnungszähler eines Mitglieds, ohne dass das Mitglied je davon erfährt. Ohne sie bleiben auch Beiträge jenseits vonmax_days_to_holdzurückgehalten, weil niemand über das Verwerfen informiert werden könnte.- BOUNCE_PROBES
(boolesch, optional) Ob einem Mitglied, dessen Bounce-Punktestand den Schwellenwert der Liste überschreitet, eine Probe geschickt wird (wobei der Punktestand zurückgesetzt wird, solange sie aussteht, und ein Bounce der Probe das Mitglied deaktiviert), statt es sofort zu deaktivieren. Standardwert
YES(dasverp_probesdes Originals ist standardmäßig aus): Das Token der Probe ist das Einzige an einem Bounce, das niemand fälschen kann, daher ist es die letzte Prüfung, bevor die Zustellung auf Berichte hin abgeschaltet wird, die jemand anderes gesendet hat. Siehe pepsi-stage-list-bounce(1).- BOUNCE_EVENT_RETENTION
(Ganzzahl, optional) Wie lange ein verarbeitetes Bounce-Ereignis aufbewahrt wird, in Tagen. Standardwert
1.- UNSUBSCRIBE_SECRET
(string, optional) The secret key of the RFC 8058 one-click unsubscribe token, which pepsi-stage-list-deliver(1) computes and pepsi-httpd(1) verifies. Without it the
https:one-click form is not emitted and themailto:form stands alone. pepsi-setup(1) writes it tosecrets.d/pepsi-list.secret(mode 0640,pepsi-httpd:pepsi) and references it with@inline-secret@.- VERP_SECRET
(Zeichenkette) Das Geheimnis, das als Schlüssel für den Authentifizierungscode in jedem VERP-Umschlagabsender dient, den die Verteilung der Liste schreibt (
<list>-bounces+<local>=<domain>=<code>@ <host>, pepsi-stage-list-post(1)) und den pepsi-stage-list-bounce(1) prüft, bevor es einen Bounce dem genannten Mitglied anrechnet: Eine mitgliedsförmige Adresse, deren Code nicht verifiziert, wird ohne Anrechnung verworfen. Erforderlich, wo immer eine der beiden Stages konfiguriert ist — beide verweigern ohne es den Start, und pepsi-setup(1) lehnt die Konfiguration ab. Der Assistent erzeugt es, behält es über erneute Läufe hinweg und speichert es insecrets.d/pepsi-list.secretneben UNSUBSCRIBE_SECRET. Es zu rotieren macht jeden Bounce einer bereits gesendeten Kopie unverifizierbar.- TEMPLATE_FETCH_TIMEOUT, TEMPLATE_FETCH_MAX_BYTES, TEMPLATE_FETCH_ALLOW_INTERNAL
(Dauer, Ganzzahl, boolesch; optional) Grenzen für das Abrufen der
list_template-URI-Überschreibung einer Liste, die ein Listeneigentümer und nicht der Betreiber setzt: die Frist für den gesamten Abruf (Standardwert5 s), die größte akzeptierte Vorlage (Standardwert65536Bytes) und ob ein Host abgerufen werden darf, der auf eine interne Adresse auflöst (StandardwertNO; jede Adresse, auf die der Host auflöst, wird geprüft).- WEB_RATE_LIMIT, WEB_SEARCH_RATE_LIMIT
(Ganzzahl, optional) Anfragen pro Minute je Quelladresse an die öffentliche Web-Oberfläche der Listen (ein
[pepsi-httpd-listener-*]mitLISTS = yes) sowie das separate, engere Budget für deren Suchroute. Standardwerte600und30; ein Wert unter1wird auf1angehoben.- WEB_REGISTRATION
(boolesch, optional) Ob die öffentliche Web-Oberfläche der Listen jedem erlaubt, ein Listenkonto anzulegen (
/lists/register, worüber auch ein verlorenes Verifikationstoken erneut gesendet wird). StandardwertYES. MitNOantworten das Registrierungsformular und sein Handler mit404, und die Anmeldeseite bietet sie nicht an; Anmeldung, Passwortrücksetzungen und Verifikationslinks für bestehende Konten funktionieren weiter, und Konten stammen stattdessen aus dempepsi-listdes Betreibers, einem Import oder von einem Listeninhaber. Listenseiten und Archive werden in jedem Fall ausgeliefert.- MAX_MESSAGE_SIZE
(Ganzzahl, optional) Serverweite Obergrenze für die
max_message_sizeeiner Liste, in Kilobyte;0(der Standard) bedeutet keine serverweite Obergrenze. Ein darüber liegender Wert je Liste wird beschnitten, undpepsi-list checkmeldet es.- MAX_LIST_HOPS
(ganzzahlig, optional) Wie oft eine Nachricht eine Liste durchlaufen darf, bevor sie als Abonnementkreis zwischen zwei Listen behandelt und für die Moderatoren zurückgehalten statt zugestellt wird. Standardwert
5. Eine Dachliste (eine Liste, die eine andere Liste abonniert hat) ist eine unterstützte Konfiguration; diese Grenze hindert zwei Listen, die einander abonniert haben, daran, Mail zu vervielfachen. Der Zähler reist alsX-Pepsi-List-Hops:-Header und nicht im Nachrichtenzustand, weil die Mail einer Dachliste per SMTP hinausgeht und als brandneue Nachricht zurückkommt;pepsi-ingressentfernt den Header aus Mail, die nicht über einen authentifizierten oder lokalen Einlieferungsweg ankam, er kann also nicht von einem Fremden zurückgesetzt werden.- INVITE_RATE
(Ganzzahl, optional) Wie viele Umstellungseinladungen pro Stunde versandt werden. Standard
300. Die erste Handlung eines migrierenden Betriebs ist eine Massensendung an die gesamte Mitgliedschaft von einer IP ohne Reputation, der Einladungslauf ist daher ratenbegrenzt und wiederaufnehmbar und keine Schleife.- ARCHIVE_RETENTION
(Ganzzahl, optional) Standard-Aufbewahrung des Archivs in Tagen;
0(der Standard) behält alles. Je Liste überschrieben mitpepsi-list list set-ext <list> archive_retention_days <n>, wobei0das Archiv dieser Liste behält, was immer diese Option sagt. Täglich angewendet durch den Aufbewahrungs-Durchlauf vonpepsi-list tasks --once(die Unit pepsi-list-tasks.timer).- SEARCH_TRIGRAM
(off | short | full, optional) Serverweite Obergrenze dafür, wie weit der Trigramm-Index einer Liste (Teilzeichenfolgen- und Fuzzy-Suche) reichen darf. Standard
short.Eine Obergrenze, kein Standardwert: jede Liste wählt
off,shortoderfullbis zu ihr, diesen Wert zu senken verkleinert den Index also beim nächstenpepsi-archive reindexund betrifft nicht nur später angelegte Listen.shortindiziert den Betreff, den Betreff des Threads sowie Name und Adresse des Absenders;fullergänzt den Nachrichtentext und ist voraussichtlich das größte Objekt in der Datenbank.Die Trigrammsuche braucht die Erweiterung
pg_trgm, die inpostgresql-contribliegt. Ein Betrieb ohne sie installiert und läuft normal, nur mit Volltextsuche;pepsi-list checksagt, in welchem Modus der Betrieb ist.- LIST_FANOUT_BATCH
(Ganzzahl, optional) Wie viele Geschwisterdatensätze jeder Fan-out-Stapel erzeugt. Standard
256.Ein Listenbeitrag wird als ein Warteschlangendatensatz je Empfänger zugestellt, damit jede Kopie die eigene Ein-Klick-Abmelde-URI dieses Mitglieds tragen kann. Dies begrenzt, wie viele dieser Datensätze pepsi-stage-list-post(1) je Schritt erzeugt (es pausiert zwischen den Stapeln etwa eine Sekunde). Die Datensätze einer Verteilung teilen sich eine gespeicherte Kopie des Nachrichtentexts; die Kopie eines Mitglieds erhält eine eigene, wenn pepsi-stage-list-deliver(1) sie umschreibt, daher begrenzt die Stapelgröße auch, wie schnell sich diese Kopien je Mitglied ansammeln. Den Wert zu erhöhen lässt einen großen Versand schneller abfließen und kostet mehr flüchtigen Platz.
- TOMBSTONE_RETENTION
(Ganzzahl, optional) Wie lange ein Löschgrabstein aufbewahrt wird, in Tagen. Standard
90.Eine Nachricht aus dem Archiv zu löschen behält ihre
Message-IDso lange, damit ein erneutes Senden oder ein erneuter Import das Gelöschte nicht stillschweigend wieder archivieren kann.pepsi-archive purge --forgetüberspringt den Grabstein für den Fall, dass selbst neunzig Tage unerwünscht sind.- ARCHIVE_PARTITIONS
(Ganzzahl, optional) Hash-Partitionen für die Archivtabellen. Standard
32. Nur von pepsi-setup(1) gelesen und bei der Installation festgelegt.PostgreSQL kann nicht im Betrieb neu partitionieren: den Modulus zu ändern bedeutet eine neue Tabelle und eine vollständige Kopie jeder archivierten Nachricht.
pepsi-setuplegt die Partitionen einmal an und weigert sich, sie bei einem späteren Lauf stillschweigend zu ändern, undpepsi-list checkmeldet eine Konfiguration, die dem widerspricht, was auf der Platte liegt – maßgeblich ist der installierte Wert, denn die Tabellen lassen sich nicht bearbeiten und diese Datei schon. Wählen Sie einmal.
95.2.1.1.25. Der Abschnitt [pepsi-failure-bouncer]¶
Optionen für pepsi-failure-bouncer(1), das failed/timeout-Nachrichten zu einer Bounce-Stage verschiebt, damit der Absender benachrichtigt wird. Nur von diesem Werkzeug gelesen.
- BOUNCE_STAGE
(Zeichenkette, erforderlich, wenn das Werkzeug verwendet wird) Das
[stage-<name>]-Etikett, zu dem eine festhängende Nachricht verschoben (und aufpendingzurückgesetzt) wird. Normalerweise dieselbe Bounce-Stage, zu der die Pipeline dauerhafte Fehler bereits routet (z. B.bounce). Eine bereits an dieser Stage befindliche Nachricht bleibt unberührt, sodass ein Bounce, der an der Bounce-Stage fehlschlägt, nicht in eine Schleife gerät. pepsi-setup(1) prüft, dass die benannte Stage existiert. Auf jeder Installation erforderlich, diepepsi.targetausführt: dessenpepsi-failure-bouncer.timerführt das Werkzeug alle zehn Minuten aus, und ohne diese Option schlägt jeder Lauf fehl. Die ausgelieferte Konfiguration und die des Assistenten setzen sie aufbounce.- MIN_AGE = DURATION
Wie lange eine Nachricht
failed/timeoutgewesen sein muss, bevor sie verschoben wird (Standardwert1 h): das Zeitfenster, in dem ein Betreiber sie mit pepsi-queue(1) zurückholen kann, bevor ihr Absender benachrichtigt wird. Gemessen abstate.failed_at, das die Datenbank stempelt, wenn der Datensatz fehlschlägt; ein Datensatz ohne diesen Stempel wird sofort verschoben.0 sverschiebt jeden Fehlschlag unverzüglich.
95.2.1.1.26. Der Abschnitt [pepsi-queue]¶
Optionen für pepsi-queue(1). Nur von seinem Unterbefehl gc gelesen, den der stündliche pepsi-origin-gc.timer ausführt.
- QUARANTINE_MAX_AGE_DAYS = DAYS
(ganzzahlig, optional) Wie viele Tage nach ihrem Eintreffen eine Nachricht, die bei einer Quarantäne-Stage wartet (einer, die eine
QUARANTINE_STAGE-Option nennt, oder einer, die pepsi-stage-quarantine(1) ohne eigenes MAX_HOLD ausführt), als Bounce zurückgewiesen statt länger zurückgehalten wird. Standardwert14. Der Bounce geht über das BOUNCE_STAGE der Quarantäne-Stage, sonst über[pepsi-failure-bouncer] BOUNCE_STAGE, und gibt keinen Inhalt zurück: EineRET=FULL-Anforderung wird alsRET=HDRSbehandelt. Eine Nachricht, deren Inhalt aus einem S/MIME-EnvelopedData-Chiffrat (AES-CBC) stammt oder sich aus einem solchen nicht öffnen ließ, wird stattdessen gelöscht, ebenso die Kopie eines Listenbeitrags für ein Mitglied: Ob ein verändertes CBC-Chiffrat zurückgehalten wurde, hing von seinem Padding ab, daher würde ein Bounce diese Frage beantworten. Zurückgehaltene Mail liegt, solange sie zurückgehalten wird, als Klartext vor (in der Datenbank, ihrem WAL und jedem Dump), und diese Grenze bestimmt, wie lange das dauert.0hält Mail für immer zurück.
95.2.1.1.27. Der Abschnitt [pepsi-sendmail]¶
Optionen für pepsi-sendmail(1), den Sendmail-kompatiblen lokalen Submission-Client, den das Debian-Paket als /usr/sbin/sendmail installiert. Jede Option hat einen Standardwert, sodass ein Standort überhaupt keinen Abschnitt benötigt.
Der Client ist unprivilegiert und behauptet keine Identität: Er übergibt die Nachricht an einen UNIX-Domain-Ingress-Listener, der das Konto des Absenders aus den vom Kernel gemeldeten Zugangsdaten des verbindenden Prozesses ableitet (AUTH_PEERCRED, oben).
- SOCKET
(Pfad, optional) Der UNIX-Domain-Submission-Socket von
pepsi-ingress. Standardwert/run/pepsi/submission.sock.Obwohl sie im Abschnitt des Clients steht, wird diese Option von beiden Enden gelesen:
pepsi-ingressbedient diesen Socket bedingungslos und synthetisiert seinen Listener aus diesem Pfad, sodass es dafür keinen[pepsi-ingress-listener-*]-Abschnitt gibt und keine zweite Deklaration, die einen anderen Pfad benennen könnte.Unter systemd wird der Deskriptor geerbt, wenn
pepsi-ingress.socketdiesen Pfad bereits bindet (abgeglichen wird über die Adresse, an die der Deskriptor gebunden ist, nicht über einen FD_INDEX), sodass eine Änderung hier ein passendesListenStream=in der Unit braucht. Andernfalls bindet der Server den Pfad selbst, mit dem Modus0666, und verweigert den Start, wenn er es nicht kann. Dieser Modus gewährt für sich genommen nichts: Das Öffnen des Sockets vermittelt kein Recht zu senden, denn der Kernel liefert die Identität des Aufrufers, und USERNAME_MAP entscheidet, als wer er senden darf.Der Sonderwert
nonedeaktiviert die lokale Submission vollständig: Kein Socket wird bedient, und pepsi-sendmail(1) verweigert den Lauf, sodass lokale Programme auf 587/465 authentifizieren müssen. pepsi-setup(1) meldet dies einmal.- EHLO_NAME
(Zeichenkette, optional) Der in
EHLOangekündigte Name. Standardmäßig[pepsi-ingress] HOSTNAME(undlocalhost, falls das nicht gesetzt ist). Kosmetisch: Der Server authentifiziert die Gegenstelle anhand ihrer Zugangsdaten, nicht anhand dessen, was sie hier behauptet.- DEFAULT_DOMAIN
(Zeichenkette, optional) Domain, die an das Login des aufrufenden Kontos angehängt wird, um den Umschlagabsender zu bilden, wenn weder
-fnoch-rangegeben wurde, und an einen Empfänger, der ohne@angegeben wurde (rootvoncron). Standardwert ist[pepsi-ingress] HOSTNAME(undlocalhost, falls auch das nicht gesetzt ist).Setzen Sie sie, wenn die Adressen, die Ihr
USERNAME_MAPkennt, bei einer anderen Domain liegen: Der Server bildet die uid der Gegenstelle auf ein Login und dann auf eine Adresse ab, sodass eine Abweichung hiercron-Mail von einem Umschlagabsender ankommen lässt, der dem Standort nicht gehört.
95.2.1.1.28. Der Abschnitt [pepsi-whitelist]¶
Optionen für pepsi-whitelist(1), das Werkzeug, das die weiße Liste der Absender verwaltet und eine solche aus dem Postfach eines Benutzers befüllen kann (import). Wird nur von diesem Werkzeug gelesen; jede Option ist optional, sodass ein Standort, der nur add/list/remove verwendet, überhaupt keinen Abschnitt benötigt.
- LOCAL_DOMAINS
(Zeichenkette, optional) Domains, deren Absender beim Scannen eines Postfachs als eigene Mail des Benutzers zählen: Eine Nachricht, deren
From:/Sender:bei einer von ihnen liegt, ist eine, die der Benutzer gesendet hat, sodass ihre Empfänger zu Einträgen der weißen Liste werden. Durch Komma oder Leerzeichen getrennt. Standardmäßig[pepsi-ingress] ACCEPTED_DOMAINS, und es ist dieselbe Option, die pepsi-stage-relay-to-maildir(1) und pepsi-stage-dot-forward(1) verwenden.- TARGETS, RECIPIENT_DELIMITER
(Zeichenkette, optional) Wie bei den Zustell-Stages.
TARGETSbegrenzt, welche lokalen Kontenimport --all-usersbefüllt (Standardwert: der BereichUID_MIN..``UID_MAX`` aus/etc/login.defs);RECIPIENT_DELIMITERentfernt eine Subadresse, bevor eine Adresse verglichen wird.- HOSTERS_FILE
(Pfad, optional) Datei, die öffentliche E-Mail-Hoster auflistet, eine Domain pro Zeile (
#-Kommentare; ein führendes*.deckt einen Subdomain-Baum ab). Domains darin werden vonimport --auto-wildcardniemals als*@domain-Wildcard vorgeschlagen, wie viele Korrespondenten der Benutzer dort auch haben mag — „alle beigmail.com“ ist keine Menge von Personen, die der Benutzer kennt, und sie auf die weiße Liste zu setzen ließe jeden Spammer mit einem kostenlosen Konto die Anti-Spam-Schranke umgehen. Ihre einzelnen Adressen werden weiterhin importiert. Standardmäßig${DATADIR}/hosters.txt, wasmake installschreibt; verweisen Sie hier auf Ihre eigene Kopie, um die Liste zu erweitern, da die installierte bei einem Upgrade überschrieben wird.- WILDCARD_THRESHOLD
(Zahl, optional) Wie viele verschiedene Adressen bei einer Domain dazu führen, dass
import --auto-wildcardeinen einzelnen*@domain-Eintrag dafür vorschlägt. Standardwert10.- MAX_ENTRIES
(Zahl, optional) Höchstzahl der Datensätze, die ein
importhinzufügen darf. Standardwert5000. Jeder Datensatz einer weißen Liste wird gegen dasFrom:jeder eingehenden Nachricht abgeglichen, die sie konsultiert, sodass dies eine Schranke für dauerhafte Kosten pro Nachricht ist und nicht nur für die Tabellengröße.- SCAN_HELPER
(Zeichenkette, optional) Das Helper-Binärprogramm für den Postfach-Scan, auf
$PATHgesucht (bei einem setuid-Lauf auf dem festen Systempfad, der den des Aufrufers ersetzt). Standardwertpepsi-helper-mailbox-scan(siehe pepsi-helper-mailbox-scan(1)). Die Datenbank-Konfigurationsüberlagerung darf es nicht setzen.- MAILBOX
(Pfad, optional) Postfach, das gescannt wird, wenn der Benutzer keines angibt. Standardmäßig das
~/Maildirdes Benutzers, falls es existiert, sonst/var/mail/<login>.
95.2.1.1.29. Der Abschnitt [pepsi-httpd]¶
Optionen für pepsi-httpd(1). Der Server liest außerdem die bedienten Domains (ACCEPTED_DOMAINS), den MTA-STS-mx-Host (das Ingress-HOSTNAME) und die [pepsi]-MTA_STS_*-Optionen.
- MAX_CONNECTIONS
(Zahl, optional) Maximale Anzahl gleichzeitig bedienter HTTP-Verbindungen. Standardwert 256.
- MAX_CONNECTIONS_PER_IP
(Zahl, optional) Höchstzahl gleichzeitiger Verbindungen von einer Client-Adresse (einer IPv4-Adresse oder einem IPv6-
/64); eine Verbindung darüber hinaus wird sofort geschlossen. Verbindungen über einen UNIX-Socket — von einem Reverse-Proxy — tragen keine Client-Adresse und werden nicht gezählt; hinter einem Proxy gehört diese Grenze also in den Proxy. Standardwert 32;0schaltet sie ab.- DB_POOL_SIZE
(Zahl, optional) Maximale Anzahl von PostgreSQL-Verbindungen im Datenbankpool des HTTP-Servers. Der Server bearbeitet Anfragen nebenläufig, sodass er anders als die Einzelverbindungs-Stage-Worker mehr als eine verwenden kann. Standardwert ist
1; erhöhen Sie es nur, wenn die einzelne Verbindung bremst, wie schnell die Endpunkte antworten, und halten Sie die Summe der Pools jeder Komponente unter demmax_connectionsvon PostgreSQL.- RESUME_AUTHORIZATION_TOKEN
(string, optional) Bearer token guarding
POST /resume(compared in constant time); the endpoint is disabled (404) when unset. Use the Talersecret-token:form so the same value can be reused as the merchantpepsi-resumewebhook’sAuthorizationheader (see pepsi-stage-anti-spam(1) and the[pepsi-payments]section).- ADDIN
(boolesch, optional) Ob die Outlook-Add-in-Routen (
GET /addin/manifest.xml, die Verfassen- und Lese-Bereiche, ihr Skript und ihre Symbole) antworten. Standardwertno: Eine Installation, die keinem Exchange vorgeschaltet ist, hat keinen Nutzen von ihnen, und ein Manifest, das ein Gateway benennt, das niemand konfiguriert hat, würde nur zu Supportanfragen führen. Siehe die Kapitel „Microsoft Exchange as a gateway“ und „Mail client extensions“ des Handbuchs.- ADDIN_URL
(Zeichenkette, optional) Der öffentliche
https://-Ursprung, der in die Add-in-Assets eingesetzt wird. Ungesetzt (der Standardwert) leitet ihn aus demHost-Header jeder Anfrage ab. Das funktioniert sowohl, wennpepsi-httpdTLS selbst terminiert, als auch, wenn es hinter einem Reverse Proxy sitzt; im letzteren Fall sieht es schlichtes HTTP über einen UNIX-Socket und kann das öffentliche Schema nicht aus der Verbindung ableiten. Setzen Sie ihn, wenn derHost, der Pepsi erreicht, nicht das Gateway benennt. Das Schema musshttpssein, und das wird erzwungen: Outlook weigert sich, Add-in-Ressourcen über schlichtes HTTP zu laden, sodass einhttp://-Ursprung nur ein Manifest hervorbringen könnte, das beim Laden scheitert;pepsi-httpdverweigert daher mit einem solchen den Start, statt ihn auszuliefern. Die einzige Ausnahme ist ein Loopback-Host (localhost, alles unter.localhost,127.0.0.0/8oder[::1]), wo schlichteshttp://angenommen wird, damit ein Entwickler oder ein Test kein Zertifikat braucht. Der Wert wird geprüft, wann immer er gesetzt ist, gleich obADDINan ist, sodass ein falscher gemeldet wird, bevor die Funktion eingeschaltet wird.- REQUIRE_WEBAUTHN =
no|all| KIND [KIND …] (Liste, optional) Welche Arten von Konten einen WebAuthn-Sicherheitsschlüssel als zweiten Faktor verwenden müssen:
admins(Konsolenkonten),users(Endbenutzer, die sich per E-Mail anmelden,own:<address>) undmembers(Mitgliedskonten von Mailinglisten) oderall. Standardwertno. Für eine aufgeführte Art schließt ein TOTP-Code eine Anmeldung nicht mehr ab, ein Konto dieser Art ohne Schlüssel registriert einen als letzten Schritt seiner nächsten Anmeldung, und sein letzter Schlüssel kann nicht entfernt werden (der Wiederherstellungsweg des Betreibers ist das WebAuthn-Zurücksetzen der API). Ohne die Liste ist ein Schlüssel optional: Ein Konto, das einen registriert, braucht ihn von da an (oder, wo es einen hat, seinen TOTP-Code).adminsundusersbrauchen[pepsi-admin] CONSOLE_URLoderENROL_URL,memberseinehttps://-[pepsi-list] BASE_URL; pepsi-httpd(1) verweigert andernfalls den Start.
Jeder [pepsi-httpd-listener-<name>]-Abschnitt bindet einen Socket, mit denselben SERVE-(tcp/unix/systemd-) und Transportoptionen wie ein [pepsi-ingress-listener-<name>]-Abschnitt, außer dass ein tcp-Listener standardmäßig PORT 443 hat und MODE plain oder tls ist (kein STARTTLS). Ein tls-Listener kann TLS_CERT/TLS_KEY als Rückfall-Zertifikat setzen; ungesetzt trägt pepsi-setup(1) die certbot-Lineage /etc/letsencrypt/live/<HOSTNAME>-web/ ein, ein Zertifikat und Schlüssel getrennt von denen der Ingress-Listener (deren Schlüssel der TLSA-Eintrag pinnt). Er nimmt zusätzlich an:
- ADMIN =
yes|no Ob die administrative Oberfläche — die
/api/v1-API, die/ui-Administrationskonsole und die/metrics-Seite — auf diesem Listener bedient wird. Optional; Standardwertno. Auf einem Listener ohne sie antworten jene Routen mit einem schlichten404, Byte für Byte gleich dem, was jeder unbekannte Pfad bekommt, sodass das Veröffentlichen des öffentlichen Listeners nicht die Administration veröffentlicht./metricsgehört zu dieser Menge, weil Warteschlangentiefen je Stage, Absturzzähler und Stage-Namen die Pipeline beschreiben; anders als die anderen beiden verlangt es kein Credential (ein Prometheus-Scraper hat keines vorzuzeigen), sodass dieses Flag auf einem Metrik-Listener die einzige Zugriffskontrolle ist. Siehe pepsi-httpd(1).pepsi-httpd(1) weigert sich, sie auf einem markierten Listener zu bedienen, der sie im Klartext von diesem Host fortträge: Klartext-
tcpwird nur auf einer Loopback-Adresse angenommen, währendtls-Listener undunix-Sockets immer qualifizieren. Ein Klartext-SERVE = systemd-Listener qualifiziert nie: Die Unit hat entschieden, wo der geerbte Deskriptor lauscht, und der Server kann diese Adresse nicht sehen, also lehnt er den Fall, den er nicht beurteilen kann, ab, statt ihn zuzulassen. Ein markierter Listener, der die Prüfung nicht besteht, protokolliert beim Start eine Warnung und bedient nur die öffentlichen Endpunkte, und pepsi-setup(1) meldet dasselbe zur Prüfzeit.Die ausgelieferte Konfiguration markiert einen
unix-Listener, was die Gestalt ist, die überhaupt keine Zugangsdaten braucht: Ein verbindender Prozess wird überSO_PEERCREDidentifiziert. Siehe[pepsi-admin]unten.- LIST_API =
yes|no Ob die zu GNU Mailman 3 kompatible REST-API (die Routen
/3.0/und/3.1/) auf diesem Listener angeboten wird. Optional; Standardwert istno, in welchem Fall diese Routen ein schlichtes404liefern. Sie unterliegt demselben Bindungstest wie ADMIN (TLS, einunix-Socket oder Klartext-tcpauf Loopback), und ihre Zugangsdaten sind[pepsi-list] API_USER/API_PASS.- LIST_API_TESTING =
yes|no Ob diese API zusätzlich den nur für Tests gedachten Haken
/3.1/reserved/resetanbietet, der die Listen- und Archivtabellen leert. Optional; Standardwert istno, und die Option wirkt nur, wenn LIST_API auf dem Listener nutzbar ist. Nur für eine Kompatibilitäts-Testumgebung.- LISTS =
yes|no Ob die öffentliche Web-Oberfläche der Mailinglisten (Archive, Abonnementseiten) auf diesem Listener angeboten wird. Optional; Standardwert ist
no. Anders als die beiden obigen Flags ist sie dazu gedacht, aus dem offenen Internet erreichbar zu sein, daher gilt der Bindungstest für sie nicht. Ihre Ratenbegrenzungen sind[pepsi-list] WEB_RATE_LIMITundWEB_SEARCH_RATE_LIMIT.
Jeder [pepsi-httpd-cert-<name>]-Abschnitt registriert ein Zertifikat für die SNI-Auswahl: SNI (einen oder mehrere Hostnamen), TLS_CERT und TLS_KEY. Das eigene TLS_CERT/TLS_KEY eines Listeners wird Clients ausgeliefert, die kein SNI senden, und einem SNI-Namen, den kein Abschnitt aufführt, nur, wenn es für diesen Namen gültig ist; jeder andere SNI-Name lässt den Handshake scheitern.
95.2.1.1.30. Der Abschnitt [pepsi-admin]¶
Optionen für die administrative API, die pepsi-httpd(1) auf einem mit ADMIN = yes markierten Listener bedient. Jede Option hat einen Standardwert, sodass der Abschnitt vollständig weggelassen werden kann. Das Authentifizierungsmodell, die Scope-Tabelle und die Endpunktreferenz stehen im Kapitel „Die administrative API“ des Handbuchs.
Dieselben Optionen regeln die /ui-Administrationskonsole, die ein Client jener API ist und keine eigene Konfiguration einführt: Sie teilt die Sitzungs-Timeouts, die Ratenbegrenzungen, die Body-Obergrenze, die Seitengröße und die Konfigurationsschreib-Verbindung. Siehe das Kapitel „Die Administrationskonsole“ des Handbuchs.
- ADMIN_GROUP
(Zeichenkette, optional) UNIX-Gruppe, deren Mitglieder über einen UNIX-Socket-Listener lokale Administratoren sind, per
SO_PEERCREDidentifiziert.rootist es immer, mit oder ohne Gruppe. Standardwertpepsi-admin.- SESSION_IDLE
(Dauer, optional) Leerlauf-Timeout einer Browser-Sitzung, bei jeder Anfrage vorgeschoben. Standardwert
30 m.- SESSION_LIFETIME
(Dauer, optional) Harte Lebensdauer einer Browser-Sitzung, nie verlängert. Standardwert
12 h. Es gibt kein „Angemeldet bleiben“: Diese Konsole kann einen Schlüssel widerrufen und lesen, wer mit wem korrespondiert, und lokale Administratoren, die sich am häufigsten anmelden, authentifizieren perSO_PEERCREDund haben keine Sitzung, die ablaufen könnte.- EVENT_RETENTION_DAYS
(Zahl, optional) Wie lange Audit-Einträge aufbewahrt werden, in Tagen. Standardwert
90.pepsi-httpd prunewendet beide Aufbewahrungsfristen an.pepsi-log-prune.timerführt es täglich als Kontopepsi-httpdaus, die eine Datenbankrolle, dieDELETEauf den Logs besitzt, da keine Komponente, die Mail verarbeitet, sie löschen darf. Der Timer ist vom Webserver unabhängig: Die Aufbewahrung gilt, obpepsi-httpd.serviceläuft oder nicht.- MAIL_LOG_RETENTION_DAYS
(Zahl, optional) Wie lange Maillog-Datensätze aufbewahrt werden, in Tagen, wenn
[pepsi] MAIL_LOGan ist. Standardwert30.Beide Aufbewahrungen sind ganzzahlige Tage statt Dauern, weil
Section::durationüberjiff::SignedDurationparst, das nurh/m/sund darunter annimmt.- RATE_LIMIT
(Zahl, optional) Anfragen pro Minute je Quelladresse (ein UNIX-Socket-Listener teilt einen Schlüssel für den ganzen Host).
0deaktiviert die Grenze. Standardwert120.- LOGIN_RATE_LIMIT
(Zahl, optional) Anmeldeversuche pro Minute, je Konto und je Quelladresse gezählt — viele Passwörter gegen ein Konto und ein Passwort gegen viele Konten sind verschiedene Angriffe.
0deaktiviert die Grenze. Standardwert10.- LOGIN_DAILY_LIMIT
(Zahl, optional) Fehlgeschlagene Passwortanmeldungen je Konto und Tag, aus allen Quellen zusammen.
LOGIN_RATE_LIMITallein lässt immer noch 600 Rateversuche pro Stunde ein Konto erreichen; sobald ein Konto so oft gescheitert ist, lehnt die Konsole seine Passwortanmeldungen mit429ab, bis sich das Kontingent wieder auffüllt (mit dieser Anzahl pro Tag, kontinuierlich). Eine erfolgreiche Anmeldung kostet nichts, der Kontoname wird gezählt, ob ein solches Konto existiert oder nicht, und der lokale Socket und Bearer-Tokens sind keine Passwortanmeldungen, sodass ein Betreiber weiter handeln kann, während ein Konto erraten wird.0schaltet die Obergrenze ab. Standardwert100.- MAX_BODY
(Zahl, optional) Größter angenommener Anfrage-Body, in Bytes. Standardwert
1048576.- PAGE_LIMIT
(Zahl, optional) Standard-Seitengröße eines Auflistungs-Endpunkts. Ein Aufrufer darf bis zu 1000 verlangen; jede Auflistung beachtet
limitundoffsetin ihrem SQL und meldet ein exaktestotalneben der Seite, und nichts liefert eine unbegrenzte Ergebnismenge. Standardwert100; ein konfigurierter Wert außerhalb von1..``1000`` wird in diesen Bereich hineingezwungen statt zurückgewiesen.- CONFIG_DB
(PostgreSQL-Verbindungszeichenfolge, optional) Verbindung, die für Konfigurationsschreibvorgänge verwendet wird. Standardmäßig nicht gesetzt, in welchem Fall
PUT/DELETEauf/api/v1/configmit503und dem Grund antworten und jeder andere Endpunkt unberührt bleibt.pepsi.config_overridezu schreiben gehört der Datenbankrollepepsi-config, die pepsi-setup(1) gewährt und jedem Dienstkonto ausdrücklich entzieht: Eine Komponente, die Mail verarbeitet, darf die Pipeline, in der sie läuft, nicht umschreiben können. pepsi-httpd ist ein solches Konto, und die Peer-Authentifizierung richtet sich nach der effektiven uid, sodass seine eigene Verbindung nicht diese Rolle sein kann. Richten Sie dies auf eine Verbindung, die sich alspepsi-configauthentifiziert, über ein Passwort in einemsecrets.d-Fragment, das nur daspepsi-httpd-Konto lesen kann, oder über einepg_ident-Abbildung. Der Server prüft es beim Start mitSELECT current_userund lehnt eine Verbindung ab, die sich als etwas anderes authentifiziert, denn eine Grenze, an die der Code bloß glaubt, ist keine Grenze. Die Ablehnung ist nicht fatal: Sie wird protokolliert, der Konfigurationsschreibpfad bleibt aus, und das503nennt die Rolle, die die Verbindung tatsächlich erhalten hat. Ein Server, der mit einem Privileg startete, das er nicht haben sollte, wäre das schlechtere Ergebnis.Die Online-Einrichtung reiht über dieselbe Verbindung und aus demselben Grund ein: Nur
pepsi-configdarf inpepsi.setup_taskINSERT``en, und der privilegierte Applier lehnt jeden Datensatz ab, der etwas anderes sagt. Ohne ``CONFIG_DBantworten auch die Einrichtungsendpunkte mit503: Der Server kann die Fragen bedienen und eine Aufgabe beobachten, aber keine anfordern.- APPLY_SOCKET
(Pfad, optional) Der Socket, über den pepsi-httpd den privilegierten Setup-Applier weckt. Standardwert
/run/pepsi/setup-apply.sock.Nach dem Einreihen einer Einrichtungsaufgabe verbindet sich pepsi-httpd mit diesem Socket und schließt ihn. Diese Verbindung ist die ganze Nachricht: Es wird nichts darauf geschrieben und nie etwas davon gelesen, sodass sie kein Befehlskanal werden kann. Ihre einzige Wirkung ist, dass systemds Socket-Aktivierung
pepsi-setup applystartet, das seine Arbeit aus der Datenbank nimmt (wo jeder Datensatz geprüft und protokolliert ist) und sich wieder beendet, wenn es keine gibt.Pepsi verwendet einen Socket statt eines Signals oder eines Spawns, weil pepsi-httpd unprivilegiert läuft und keine Möglichkeit hat, einen root-Prozess zu starten, und sich keine verschaffen sollte. Dies ist der eine Mechanismus, der es einen privilegierten Prozess laufen lassen lässt, ohne beeinflussen zu können, was dieser Prozess tut. Ein Verbindungsfehlschlag ist kein Fehler: Die Aufgabe ist so oder so dauerhaft eingereiht, und
pepsi-setup apply --onceaus cron oder von einer Konsole nimmt sie auf.Dieser Pfad ist auch das, was
APPLIER = autosondiert; siehe unten.- APPLIER
(
auto|yes|no, optional) Ob von diesem Server aus überhaupt eine privilegierte Einrichtungsänderung geschehen kann. Standardwertauto.Die systemd-Units des Appliers sind separat paketiert (Debian pepsi-httpd-admin oder
make install INSTALL_ADMIN_UNITS=noaus den Quellen), sodass eine Installation, die von einem Terminal aus verwaltet wird, den einen Mechanismus entfernen kann, über den eine HTTP-Anfrage/etc/pepsierreicht. Ohne sie leert nichtspepsi.setup_task, und ein Insert darin bewirkt nichts, sodass die Konsole nicht weiterhin Formulare anbieten darf, deren Absendungen stillschweigend nie angewandt würden.autoZwei Dinge sondieren: dass
pepsi-setup-apply.socketals Unit-Datei dort existiert, wo systemd nach einer sucht (installiert), und dassAPPLY_SOCKETexistiert, ein Socket ist und von diesem Konto beschreibbar ist (scharf — sich mit einem UNIX-Socket zu verbinden braucht Schreibrecht). Mit dem Socket wird nie verbunden: Eine Verbindung weckt den Applier, eine solche Sonde würde also bei jedem Seitenaufbau einen root-Prozess starten. Die Sonde schlägt geschlossen fehl: Jede Ungewissheit, einschließlich eines Pfads, der nicht untersucht werden kann, und eines von einem entfernten Paket zurückgelassenen Socket-Knotens, liest sich als „kein Applier“.yesAnnehmen, dass der Applier erreichbar ist, und die Sonde überspringen. Das ist für eine Installation gedacht, die die Warteschlange auf andere Weise leert (
pepsi-setup apply --onceaus cron, eine handgeschriebene Unit, ein Host ohne systemd), wo die Sonde eine Fähigkeit verneinen würde, die es tatsächlich gibt. Es ist ein Versprechen, das der Betreiber gibt; nichts prüft es.noJede privilegierte Einrichtungsanfrage ablehnen, was auch immer installiert ist. Das macht die Konsole schreibgeschützt, ohne die Paketmenge zu ändern.
Wenn es keinen Applier gibt, bedient pepsi-httpd weiterhin das Setup-Interview, die vorgemerkten Antworten und die Aufgabenhistorie — nur lesend, mit deaktivierten Bedienelementen — und beantwortet die verändernden Endpunkte mit
503setup_applier_unavailable. Siehe pepsi-httpd(1).
Die ENROL_*-Optionen schalten die Anmeldung per E-Mail ein: Ein Endbenutzer gibt auf /ui/enrol eine Adresse ein, erhält einen Einmal-Link, und dessen Bestätigung (mit dem TOTP-zweiten-Faktor der Adresse, wenn einer eingerichtet ist, vom privilegierten Applier über eine confirm-enrolment-Aufgabe geprüft) öffnet eine Konsolensitzung, die auf own:<address> beschränkt ist. Die Registrierung braucht den Applier und CONFIG_DB; ohne sie antwortet das Adressformular, dass sie nicht verfügbar ist. Siehe pepsi-httpd(1) und das Kapitel „The administration console“ des Handbuchs.
- ENROL_STAGE
(Zeichenkette, optional) Die Stage, bei der die Link-Mail eingespeist wird, normalerweise die, über die lokale Mail zugestellt wird. Nicht gesetzt (der Standard) schaltet die Registrierung ab, und ihre Seiten antworten mit
404. pepsi-setup(1) lehnt einen Namen ohne einen[stage-<name>]-Abschnitt mitPROGRAMab und lehnt die Option ab, wenn die Vorlageenrol-link.en.bodyfehlt.- ENROL_URL
(Zeichenkette; erforderlich mit
ENROL_STAGE) Derhttps://-Origin, auf den der zugesandte Link zeigt (Schema, Host und optionaler Port, nichts danach), also wo Benutzer einenADMIN = yes-Listener erreichen, direkt oder über den TLS-Reverse-Proxy. Jede andere Form wird abgelehnt: Der Link trägt ein Zugangsmerkmal. Er wird nie aus demHostder Anfrage abgeleitet, den ein Anfragender wählen könnte.- ENROL_FROM
(Zeichenkette, optional)
From:der Link-Mail. Standardwertpostmaster@der eigenen Domain der Adresse.- ENROL_LIFETIME
(Dauer, optional) Wie lange ein Link funktioniert. Standardwert
30 m; mindestens1 m. Ein Link funktioniert einmal, nimmt höchstens fünf Übermittlungen an und wird durch den nächsten an dieselbe Adresse gesandten ersetzt.- ENROL_MAIL_PER_HOUR
(Zahl, optional) Wie viele Links pro Stunde an eine Zieladresse gesandt werden. Standardwert
3; mindestens1.- ENROL_RATE_LIMIT
(Zahl, optional) Registrierungsanfragen und Bestätigungen je Client-Adresse und Stunde, zusätzlich zu
RATE_LIMIT. Standardwert20; mindestens1.- CONSOLE_URL
(Zeichenkette, optional) Der öffentliche
https://-Origin der Konsole (Schema, Host und optionaler Port), an den WebAuthn-Sicherheitsschlüssel gebunden sind: Jede Assertion muss diesen Origin nennen, und sein Host ist die RP-ID. StandardwertENROL_URL; ist keines gesetzt, bietet die Konsole keinen Sicherheitsschlüssel an. Den Host später zu ändern, macht jeden registrierten Schlüssel unbrauchbar (ein Schlüssel signiert für die RP-ID, mit der er registriert wurde), wählen Sie also einen Namen, unter dem Benutzer die Konsole dauerhaft erreichen. Die Mitgliederseiten verwenden stattdessen[pepsi-list] BASE_URL.
95.2.1.1.31. Die Egress-Identitätsoption: PUBLIC_IP¶
- PUBLIC_IP = ADDR [ADDR …]
Durch Leerraum oder Komma getrennte Liste der öffentlichen IPv4- und/oder IPv6-Adressen, die Mail als Ihre Domains senden. Jede wird zu einem
ip4:- oderip6:-Mechanismus imv=spf1-Eintrag, den pepsi-setup(1) vorschlägt. Keine Stage liest diese Option zur Laufzeit: Sie ist rein eine Eingabe für den erzeugten SPF-Eintrag.PUBLIC_IPist eine stage-weise Option, die im[stage-<name>]-Abschnitt einer Relay-Stage gesetzt wird, und pepsi-setup(1) sammelt sie aus jeder Stage, derenPROGRAMpepsi-stage-relay-to-internet(1) oder pepsi-stage-relay-to-smarthost(1) ist (es erkennt sie amPROGRAM, niemals am Abschnittsnamen), und vereinigt die Ergebnisse. Eine Installation kann daher mehrere Relay-Stages haben, jede mit ihrem eigenenPUBLIC_IP:Bei einer pepsi-stage-relay-to-internet-Stage sind es die eigene(n) öffentliche(n) Sende-IP(s) dieses Hosts: Der Host stellt von ihnen aus direkt an die MX der Empfänger zu.
Bei einer pepsi-stage-relay-to-smarthost-Stage sind es die Egress-IP(s) des Smarthosts: Mail geht vom Smarthost aus ins Internet, sodass SPF sie autorisieren muss (viele Anbieter veröffentlichen stattdessen ein
include:, das Sie von Hand zum Eintrag hinzufügen).
Setzt keine Relay-Stage
PUBLIC_IP, ist der erzeugte Eintrag ein bloßesv=spf1 -all, und pepsi-setup(1) protokolliert eine Warnung. Dieser Eintrag sagt Empfängern, dass kein Host für Ihre Domains senden darf, und lässt Ihre eigene ausgehende Mail bei SPF durchfallen. Eine reine Empfangs-Installation (keine Relay-Stage) hat keinPUBLIC_IPund wird nicht gewarnt.Jede Adresse muss eine global routbare öffentliche IP sein: die Adresse, von der aus Empfänger die Mail eintreffen sehen. pepsi-setup(1) warnt (bei der Validierung und in der DNS-Ausgabe), wenn eine
PUBLIC_IPkeine öffentliche Adresse ist (Loopback, RFC 1918 / Unique-Local, Link-Local oder CGNAT): Verwenden Sie hinter NAT die öffentliche Ausgangs-IP des Hosts, nicht seine LAN-Adresse, sonst schlägt ausgehende Mail über diese Adressfamilie bei SPF fehl.Reverse DNS (PTR). Each pepsi-stage-relay-to-internet
PUBLIC_IP, that is, this host’s own egress IP, must also have a forward-confirmed reverse DNS record that names the stage’sSERVER_NAME: aPTRfor the address whose host name in turn resolves (viaA/AAAA) back to the same address, and which is the very name that the stage announces inEHLO. Many receiving mail servers treat a missing, non-forward-confirmed, or generic/dynamic-lookingPTRas a spam signal and reject or junk the mail, and many of them also compare theEHLOname against thePTRand refuse the session when the two name different hosts (HELO host does not match rDNS). Being inside yourACCEPTED_DOMAINSdoes not satisfy that test: a host that answers to several names can announce one and reverse-resolve to another, both of them its own, and still be refused. pepsi-setup(1) warns for everyPUBLIC_IPwhose reverse DNS is not correct in this sense, including that mismatch, and prints the remediation (see pepsi-setup(1)). Reverse DNS for aPUBLIC_IPlives in the zone of the IP’s owner (in-addr.arpa/ip6.arpa), usually your ISP or hosting provider, so unlike the forward records it is often not something that you can publish yourself. Where it cannot be changed, setSERVER_NAME(and[pepsi-ingress]HOSTNAME, the MX record and the TLS certificate) to the name that thePTRalready gives. A pepsi-stage-relay-to-smarthostPUBLIC_IPnames the smarthost’s egress IPs, whose reverse DNS the smarthost operator controls, so those are not checked.Der vereinigte Eintrag wird für jede bediente Domain identisch veröffentlicht. Das ist korrekt, aber weit gefasst; in besonderen Konstellationen, in denen verschiedene Domains von verschiedenen Hosts senden, kann ein von Hand geschriebener domainspezifischer SPF-Eintrag (der nur die eigenen Sende-IPs jener Domain auflistet) enger und dennoch korrekt sein. pepsi-setup(1) berechnet diese Gruppierung nicht automatisch und weist in seiner DNS-Ausgabe darauf hin.
95.2.1.1.32. Die [pepsi-stage-relay-to-smarthost]-MTA-Abschnitte¶
95.2.1.1.32.1. Die Smarthost-(MTA-)Abschnitte¶
Jeder [pepsi-stage-relay-to-smarthost-mta-<name>]-Abschnitt definiert einen vorgelagerten Smarthost; das Suffix <name> ist ein frei gewähltes Etikett, das in Journalen verwendet wird. Diese Abschnitte werden von jeder Smarthost-Relay-Stage geteilt. Eine Empfängerdomain wird zu dem MTA geroutet, dessen DOMAINS sie auflistet, oder zum einzelnen CATCH_ALL-MTA.
- HOST
(Zeichenkette, erforderlich) Hostname oder Adresse des Smarthosts, mit dem verbunden wird.
- PORT
(Zahl, erforderlich) TCP-Port, über den verbunden wird (z. B.
587oder465).- MODE
(optional) Transportsicherheit:
starttls(Standardwert),tls(implizites TLS) oderplain(Klartext).- TLS_VERIFY
(boolesch, optional) Ob das TLS-Zertifikat des Smarthosts gegen den Vertrauensspeicher des Systems verifiziert wird. Standardwert
yes;noakzeptiert jedes Zertifikat, was kein Schritt zur Fehlersuche ist, sondern die Verbindung jedem auf dem Weg preisgibt: Wer die Verbindung abfangen kann (ein Man in the Middle), legt ein eigenes Zertifikat vor und erhält dieAUTH-Zugangsdaten und jede weitergeleitete Nachricht. Für einen Smarthost mit privater CA nennen Sie diese CA stattdessen inTLS_CA_BUNDLE(oderTLS_CA). Mit eingeschalteter Verifikation wird eine OCSP-Antwort, die der Smarthost heftet, ausgewertet, und ein verifiziertesrevokedlehnt die Sitzung ab; kein Responder wird abgefragt.- TLS_CA
(Pfad, optional) Zusätzliche CA-Zertifikate (PEM), denen zusätzlich zum System-Store vertraut wird. Ein Zertifikat für den Namen des Smarthosts von irgendeiner Wurzel des Stores des Hosts authentifiziert ihn weiterhin;
TLS_CA_BUNDLEist die engere Wahl.- TLS_CA_BUNDLE
(Pfad, optional) Die CA-Zertifikate (PEM), die den gesamten Vertrauensspeicher für diesen Smarthost bilden: Die Systemwurzeln werden nicht herangezogen, sodass nur ein Zertifikat, das zu einem dieser Anker führt, ihn authentifiziert. Verwenden Sie es für einen Smarthost mit eigener CA oder um die eine öffentliche CA zu pinnen, die der Anbieter verwendet. Die Datei wird gelesen, wenn der Worker der Stage startet; kann sie nicht gelesen werden oder enthält sie kein Zertifikat, verweigert der Worker den Start. Es zusammen mit
TLS_CAoder mitTLS_VERIFY = nozu setzen, ist ein Konfigurationsfehler. Eine dagegen verifizierte Verbindung erhält wie beiTLS_CAkeine Certificate-Transparency-Prüfung.- TLS_CLIENT_CERT / TLS_CLIENT_KEY
(Pfad, optional; beides-oder-keines) Ein Client-Zertifikat (PEM-Kette) und sein privater Schlüssel, die dem Smarthost während des TLS-Handshakes vorgelegt werden (Mutual TLS). Bei jeder Verbindung frisch geladen. Erfordert einen verschlüsselnden
MODE(tlsoderstarttls) und gilt für PKIX,TLS_VERIFY = nound DANE gleichermaßen. Der Schlüssel ist geheim: Halten Sie ihn nur für diepepsi-token-Gruppe lesbar, unter der die Relay-Stage SGID läuft (legen Sie auf Debian Zertifikat + Schlüssel in das SGID-/var/pepsi/tls-Verzeichnis). Setzen SieAUTH = external, um die SMTP-Sitzung zusätzlich per SASLEXTERNALmit dem Zertifikat zu authentifizieren.- DANE
(optional) DANE/TLSA-(RFC 7672-)Durchsetzung gegenüber diesem Smarthost:
off,warn(ein ausdrückliches Opt-out) oderstrict(der Standardwert). Wenn der Smarthost DNSSEC-validierteTLSA-Einträge unter_<PORT>._tcp.<HOST>veröffentlicht, wird das Zertifikat gegen sie authentifiziert; ein Zertifikat, das zu einem nutzbaren Eintrag passt, braucht keineTLS_VERIFY-(PKIX-)Prüfung. Inwarnwird eine Nichtübereinstimmung protokolliert, und das Zertifikat wird dann wie ohne DANE durchTLS_VERIFYgeprüft: Mit dem StandardwertTLS_VERIFY = yeswird das Zertifikat eines Betrügers weiterhin abgelehnt. Instrictschiebt ein nutzbarer, aber nicht übereinstimmender Eintrag oder eine fehlgeschlageneTLSA-Abfrage (einschließlich Nameservern, die nicht bestimmt werden können) die Nachricht auf; unterwarnwird ein solcher Fehlschlag protokolliert, und der Hop fährt mitTLS_VERIFYfort. Wo eine Verwendung und ein Selektor sowohl unter SHA-256 als auch unter SHA-512 veröffentlicht sind, werden nur die SHA-512-Einträge abgeglichen (RFC 7671 Abschnitt 9). Wird beiMODE = plainignoriert. Erfordert einen DNSSEC-validierenden Resolver, der über einen vertrauenswürdigen Pfad erreicht wird (Pepsi vertraut dem AD-Bit der Antwort); siehe dasDNS_SERVERSder Stage.- ADDRESS_FAMILY
(optional) Welche IP-Adressfamilien verwendet werden dürfen, um diesen Smarthost zu erreichen:
any,ipv4(auchv4/v4onlygeschrieben) oderipv6(v6/v6only).Die Vorrangfolge ist: dieser Eintrag, dann der besitzende
[stage-*]-Abschnitt, dannany. Die Ebene je Eintrag ist das, was die Option nützlich macht: Ein sich fehlverhaltendes Ziel kann festgelegt werden, ohne jedes andere Ziel (einschließlich eines, das nurAAAAveröffentlicht) auf dieselbe Familie zu zwingen.Der motivierende Fall ist Microsoft Exchange Online, das Mail von einer sendenden IPv6-Adresse ohne
PTR-Eintrag ablehnt (550 5.7.1 ... S820). Ein Dual-Stack-Host bevorzugt IPv6, sodass eine Maschine mit korrektem IPv4-Reverse-DNS und nicht delegiertem IPv6-Reverse-DNS überall gut zustellt außer dort.Mit
any(dem Standardwert) wird der Hostname dem System-Resolver übergeben. Jeder andere Wert lässt Pepsi den Host selbst auflösen und jede Adresse der gewählten Familie der Reihe nach versuchen. Ein Ziel, das keine Adresse der gewählten Familie veröffentlicht, ist ein vorübergehender Fehlschlag, kein Bounce: Das ist ein Betreiberfehler, an dem es sich zu wiederholen lohnt, keiner, für den es sich lohnt, eingereihte Mail zu zerstören.- AUTH
(optional) SMTP-Authentifizierungsmechanismus:
none(Standardwert),plain,login,cram-md5,digest-md5,scram-sha-1,scram-sha-256,scram-sha-1-plus,scram-sha-256-plus,auto,external,oauth,ntlmodergssapi.plain/login/cram-md5/digest-md5/diescram-*-Familie/autoerfordern alleUSERNAMEundPASSWORD;oautherfordertUSERNAMEundTOKEN_FILE;external(SASLEXTERNAL, RFC 4422) erfordertTLS_CLIENT_CERT/TLS_CLIENT_KEYund authentifiziert sich mit diesem Zertifikat (kein Passwort gesendet), mit einem optionalenUSERNAMEals SASL-Autorisierungsidentität.cram-md5(RFC 2195) undscram-sha-1/scram-sha-256(RFC 5802 / RFC 7677) sind Challenge/Response: Das Passwort wird nie gesendet, und SCRAM authentifiziert zusätzlich den Server gegenüber Pepsi (eine fehlerhafte Server-Signatur bricht den Austausch ab und schiebt, wie jedes abgelehnteAUTH, die Nachricht auf). Die-plus-SCRAM-Varianten ergänzentls-server-end-point-Channel-Binding (RFC 5929).autowählt den stärksten vom Smarthost angekündigten Mechanismus (SCRAM-SHA-256-PLUS>SCRAM-SHA-256>SCRAM-SHA-1-PLUS>SCRAM-SHA-1>CRAM-MD5>LOGIN>PLAIN); es wählt nie das veraltetedigest-md5,ntlmodergssapi.digest-md5(RFC 2831) ist ebenfalls ein Challenge/Response mit Server-Authentifizierung (rspauth), aber veraltet (RFC 6331 überführte es in den Status „Historic“) und nur für ältere Smarthosts bereitgestellt; seine Auswahl protokolliert eine Warnung von pepsi-setup(1) und zur Laufzeit.ntlmist der De-facto-Mechanismus von Microsoft (kein RFC; nur NTLMv2, mittls-server-end-point-EPA-Channel-Binding), derUSERNAME/PASSWORD/NT_DOMAINerfordert; es ist schwach und authentifiziert den Server nicht, daher warnt pepsi-setup(1).gssapiist SASLGSSAPI/Kerberos (RFC 4752); es nimmt kein Passwort und bezieht ein Service-Ticket fürSERVICE_NAMEaus einem Credential-Cache (KRB5CCNAME). Alle werden nur über einen verschlüsselten Transport angeboten (MODE=tls/starttls);ntlmundgssapilehnenMODE = plainzur Konfigurationszeit ab.- USERNAME / PASSWORD
(Zeichenkette, erforderlich, wenn AUTH plain/login/cram-md5/digest-md5/scram-*/auto/ntlm ist) Die SMTP-AUTH-Zugangsdaten. Halten Sie
PASSWORDin einer modusbeschränkten Datei, die mit@inline-secret@zusammengeführt wird. Für diescram-*-Mechanismen werden beide mit SASLprep (RFC 4013) normalisiert.USERNAMEist auch die optionale Autorisierungsidentität fürAUTH = externalundAUTH = gssapi.- NT_DOMAIN / NT_WORKSTATION
(Zeichenkette; NT_DOMAIN erforderlich, wenn AUTH = ntlm) Die Windows-Domain des NTLM-Kontos und ein optionaler kosmetischer Client-Workstation-Name.
- SERVICE_NAME
(Zeichenkette, optional; AUTH = gssapi) Das host-basierte Kerberos-Service-Principal des Smarthosts, in der Form
service@host. Standardwert istsmtp@<HOST>.- KRB5CCNAME
(Zeichenkette, optional; AUTH = gssapi) Der für diesen Smarthost zu lesende Kerberos-Credential-Cache (z. B.
FILE:/var/pepsi/krb5/smarthost.cc), der das umgebendeKRB5CCNAMEüberschreibt. Er wird der Kerberos-Bibliothek mit der Anfrage übergeben (gss_acquire_cred_from); die Prozessumgebung wird nie verändert. Pepsi liest den Cache nur; ein externer Keytab +k5start/cron-Job muss das Ticket frisch halten, und der Cache muss vom Relay-Worker lesbar sein (die SGID-pepsi-token-Gruppe; siehe/var/pepsi/krb5). Ein fehlendes/abgelaufenes Ticket schiebt die Nachricht auf (vorübergehender Fehler), statt einen Bounce zu erzeugen.- TOKEN_FILE
(Pfad, erforderlich, wenn AUTH = oauth) Datei, die das aktuelle OAuth-2.0-Zugriffstoken enthält (von Leerraum befreit), bei jeder Zustellung neu gelesen. Der SASL-Mechanismus wird aus dem
EHLOdes Smarthosts gewählt (OAUTHBEARERbevorzugt, sonstXOAUTH2). Die Relay-Stage liest diese Datei nur; halten Sie sie mit pepsi-helper-token-refresh(1) (siehe die[pepsi-helper-token-refresh-*]-Abschnitte) oder einem gleichwertigen externen Job aktuell. Ein fehlendes/abgelaufenes/abgelehntes Token schiebt die Nachricht auf (vorübergehender Fehler), statt sie zu bouncen.- HELO_NAME
(Zeichenkette, optional) Der diesem Smarthost gegenüber in
EHLOangekündigte Name. Standardwert ist dasSERVER_NAMEder Stage. Ein ausdrücklich gesetzterHELO_NAMEhat Vorrang vor demEHLO_FROM_PTRder Stage.- DOMAINS
(Zeichenkette) Durch Leerraum/Komma getrennte Empfängerdomains, die zu diesem MTA geroutet werden (unabhängig von der Groß-/Kleinschreibung). Erforderlich, sofern nicht
CATCH_ALL = yes; eine Domain darf von höchstens einem MTA geroutet werden.- CATCH_ALL
(boolesch, optional) Ob dieser MTA jede Domain erhält, die nicht von einem
DOMAINS-Eintrag erfasst wird. Standardwertno; höchstens ein MTA darf es setzen. Ein MTA mussDOMAINSauflisten oderCATCH_ALL = yessetzen.
95.2.1.1.33. Die Abschnitte [pepsi-helper-token-refresh]¶
Diese konfigurieren pepsi-helper-token-refresh(1), den optionalen Dienst, der die OAuth-Zugriffstokens von AUTH = oauth-Smarthosts aktuell hält. Die Menge der zu pflegenden Tokens wird aus den Smarthost-MTA-Abschnitten abgeleitet: Für jeden [pepsi-stage-relay-to-smarthost-mta-<name>] mit AUTH = oauth sucht der Dienst einen passenden [pepsi-helper-token-refresh-<name>]-Abschnitt. Der Dienst ist nicht Teil von pepsi.target; aktivieren Sie ihn ausdrücklich.
Weil die zielweisen Abschnitte OAuth-Client-Secrets enthalten, halten Sie sie in einer Datei, die nur für den pepsi-helper-token-refresh-Benutzer lesbar ist, und binden Sie jeden mit der @inline-secret@-Direktive ein. Ein Leser, der die Datei nicht öffnen kann, etwa die als pepsi laufende Relay-Stage, überspringt die Direktive stillschweigend, sodass dieselbe pepsi.conf für beide parst. Siehe pepsi-helper-token-refresh(1) und das Handbuchkapitel Die Pipeline erweitern.
Der optionale Basisabschnitt [pepsi-helper-token-refresh] enthält dienstweite, nicht-geheime Optionen:
- STATE_DIR
(Pfad, optional) Privates Verzeichnis (Modus
0700) für zielweise rotierte Refresh-Tokens. Standardwert/var/pepsi/token-refresh.
Jeder [pepsi-helper-token-refresh-<name>]-Abschnitt (<name> passend zu einem OAuth-Smarthost-MTA) enthält:
- TOKEN_ENDPOINT
(Zeichenkette, erforderlich) Die URL des OAuth-2.0-Token-Endpunkts des Anbieters. Sie muss eine
https://-URL sein: Jedes andere Schema lässt die Auffrischung dieses Ziels scheitern, statt das Client-Geheimnis im Klartext zu senden. Sie ist auch, woran der Dienst einen fehlenden Geheimnisabschnitt von einem unlesbaren unterscheidet: Eine@inline-secret@-Datei, die dieses Konto nicht öffnen kann, ist schlicht nicht da, sodass ein fehlendesTOKEN_ENDPOINTdieses Ziel mit einer Warnung überspringt, statt den Dienst scheitern zu lassen. Die übrigen Optionen unten sind dann Fehler und keine Übersprünge.- GRANT
(optional)
refresh_token(der Standardwert; z. B. Google) oderclient_credentials(z. B. Microsoft 365 reine App).- CLIENT_ID / CLIENT_SECRET
(Zeichenkette, erforderlich) Die OAuth-Client-Zugangsdaten, im Request-Body gesendet.
- REFRESH_TOKEN
(Zeichenkette, erforderlich für GRANT = refresh_token) Das langlebige Refresh-Token. Ein vom Endpunkt zurückgegebener rotierter Wert wird unter
STATE_DIRpersistiert und hat dann Vorrang.- SCOPE
(Zeichenkette, erforderlich für GRANT = client_credentials; sonst optional) Der angeforderte Scope.
- REFRESH_MARGIN
(Dauer, optional) Wie lange vor dem angegebenen Ablauf eines Tokens es erneuert wird. Standardwert
5 m. Verwendet nurh/m/s-Einheiten.
95.2.1.1.34. Der Abschnitt [pepsi-payments]¶
Dieser optionale Abschnitt konfiguriert die GNU-Taler-Zahlungsintegration. Wenn er fehlt (oder MERCHANT_BACKEND_URL nicht gesetzt ist), führt pepsi-setup(1) keine Händler-Prüfungen durch und richtet keinen Webhook ein. Derselbe Abschnitt wird zur Laufzeit von pepsi-stage-anti-spam(1) gelesen, um nachrichtenweise Zahlungs-Bestellungen zu erstellen.
- MERCHANT_BACKEND_URL = URL
Basis-URL des Taler-Händler-Backends, optional einschließlich der Instanz (
…/instances/$ID). pepsi-setup(1) fragtGET /configan der Backend-Wurzel ab (ein etwaiges nachgestelltes/instances/$IDwird entfernt), um zu bestätigen, dass es eintaler-merchant-Backend ist, undGET /private/orders?limit=1an dieser URL, um das Zugriffstoken zu bestätigen. Erforderlich, um die Integration zu aktivieren.Sie muss eine
https://-URL sein oder einehttp://-URL, deren Host das Loopback-Interface ist (localhost,127.0.0.0/8,::1).MERCHANT_ACCESS_TOKENwird jeder Anfrage als Bearer-Credential angehängt, sodass ein Klartext-Backend irgendwo sonst, auch eines, das „ja nur im LAN“ ist, dieses langlebige Credential an alles weitergibt, was auf dem Pfad sitzt. Anfragen sind begrenzt (10 s zum Verbinden, 30 s insgesamt), sodass ein nicht antwortendes Backend eine Nachricht kostet und nicht die Stage: pepsi-stage-anti-spam(1) hält diese Nachricht zurück und fragt erneut bis zu ihrer Zahlungsfrist, dann stellt es sie unverifiziert zu.- MERCHANT_ACCESS_TOKEN = TOKEN
Zugriffstoken für das Händler-Backend, in der Taler-
secret-token:…-Form, alsAuthorization: Bearer-Credential gesendet. Es benötigt die Berechtigungenorders-readundwebhooks-read/webhooks-write. Erforderlich, wennMERCHANT_BACKEND_URLgesetzt ist.
Der eingerichtete pepsi-resume-Webhook feuert beim pay-Ereignis und POSTet {"message_id":"{{order_id}}"} an https://<host>/resume (den kürzesten [pepsi-httpd-cert-*]-SNI-Host), authentifiziert mit [pepsi-httpd] RESUME_AUTHORIZATION_TOKEN. Die Händler-order_id muss daher dem externen Token der Nachricht entsprechen.
95.2.1.1.35. Der Abschnitt [pepsi-vacation-default-message]¶
Die Urlaubsnotizen je Sprache, auf die pepsi-stage-vacation(1) zurückfällt, eine Option je Sprache:
[pepsi-vacation-default-message]
EN = Hello {{SENDER_NAME}}, I am away until {{VACATION_END}}.
DE = Hallo {{SENDER_NAME}}, ich bin bis {{VACATION_END}} abwesend.
Der Optionsname ist das Sprach-Tag (EN, DE, PT_BR — beliebiger Trenner), und der Wert ist eine Mustache-Vorlage. Welche Sprache verwendet wird, welche Felder expandieren und warum zwei Leerzeichen zu einem Zeilenumbruch werden, ist alles in pepsi-stage-vacation(1) dokumentiert.
Dieser Abschnitt existiert normalerweise bereits. make install liefert ihn als ${DATADIR}/config.d/vacation.conf aus, und talers Konfigurationslader parst jede Datei in ${DATADIR}/config.d vor pepsi.conf. Eine Stage, die ohne eigene Nachricht konfiguriert ist, hat also dennoch zehn Sprachen verfügbar, und ein Betreiber, der einen anderen Wortlaut will, definiert nur die Sprache neu, die ihn interessiert, in pepsi.conf: Spätere Definitionen gewinnen Option für Option, nie Abschnitt für Abschnitt, sodass das Überschreiben von EN die anderen neun bestehen lässt. Die ausgelieferte Datei zu bearbeiten funktioniert auch, aber ein Paket-Upgrade überschreibt sie.
Der Abschnittsname ist nur ein Standardwert (DEFAULT_MESSAGE_SECTION), sodass ein Betreiber, der mehrere Nachrichtenmengen will (eine förmliche für eine Support-Adresse, eine knappe für alle anderen), weitere Abschnitte definieren und verschiedene Stages, Domains oder Adressen darauf richten kann.
Ein Kontoinhaber fasst diesen Abschnitt nie an: Sein eigener Text geht in MESSAGE_<LANG> im eigenen Abschnitt der Stage, den die Einstellungsschicht tragen kann und der je Sprache gewinnt.
95.2.1.1.36. Der Abschnitt [pepsi-autoconfig]¶
Dieser optionale Abschnitt veröffentlicht die Autokonfiguration von Mailkonten (draft-ietf-mailmaint-autoconfig): das XML-Dokument, das ein Mailclient abholt, wenn er nur die Adresse des Benutzers kennt, sodass er sich selbst konfigurieren kann, statt nach acht Einstellungen zu fragen, die der Benutzer üblicherweise nicht liefern kann. Es wird von pepsi-httpd(1) unter /mail/config-v1.1.xml auf autoconfig.<domain> und unter /.well-known/autoconfig/mail/config-v1.1.xml auf der Maildomain selbst bedient.
Die Funktion ist aus, bis ein eingehender Server benannt ist. Wenn Sie den Abschnitt weglassen oder weder IMAP_HOST noch POP3_HOST setzen, antworten beide Endpunkte mit 404. Ein Client, der ein Konfigurationsdokument findet, hört auf, die Rückfallkette abzulaufen, sodass eines zu veröffentlichen, das ihm nicht sagen kann, wie er Mail liest, den Benutzer schlechter dastehen lässt, als überhaupt nichts zu veröffentlichen.
Pepsi bedient keine Postfächer (siehe pepsi-stage-relay-to-lmtp(1)), sodass die eingehende Hälfte den MDA benennen muss, mit dem die Installation kombiniert ist, typischerweise Dovecot auf demselben Host.
Zwei Dinge außerhalb dieser Datei werden ebenfalls gebraucht. Ein autoconfig.<domain>-DNS-Eintrag muss auf diesen Server auflösen, und das TLS-Zertifikat muss diesen Namen abdecken: Clients versuchen die https://autoconfig.…-URL zuerst, und ein Zertifikatsfehler dort ist eine fehlgeschlagene Abfrage. Die Zertifikatshälfte wird für Sie erledigt, wenn pepsi-setup(1) Zertifikate einrichtet: Benennt dieser Abschnitt einen eingehenden Server, so fügt es für jede bediente Domain autoconfig.<domain> zu den Namen hinzu, die es für das TLS-[pepsi-httpd-listener-*]-Zertifikat anfordert. Den DNS-Eintrag erledigt es nicht für Sie, denn er wird in Ihrer Zone veröffentlicht. Eine Installation, die den Namen nicht hinzufügen möchte, kann sich allein auf die /.well-known/-Form verlassen, um den Preis, nur von Clients gefunden zu werden, die sie versuchen.
- IMAP_HOST, POP3_HOST
(Hostname, optional) Der anzukündigende Postfachserver. Einen zu setzen aktiviert die Funktion; keinen zu setzen deaktiviert sie. Es gibt keinen Standardwert: Ein erfundener Hostname wäre schlimmer als Schweigen.
- IMAP_PORT, POP3_PORT
(Zahl, optional) Standardwerte
993und995, die Implizit-TLS-Ports.- IMAP_SOCKET, POP3_SOCKET
(``SSL`` | ``STARTTLS`` | ``plain``, optional) Transportsicherheit, im Vokabular des Drafts selbst (
SSLbedeutet implizites TLS);tlsundnonewerden als Schreibweisen vonSSLundplainangenommen. StandardwertSSL. Ein Wertplainwird abgelehnt, sofern nicht ALLOW_PLAIN_AUTOCONFIG (unten) sagt, dass er beabsichtigt ist.- ALLOW_PLAIN_AUTOCONFIG
(yes/no, Standardwert no) Bestätigen, dass ein Server, den dieser Abschnitt mit einem
*_SOCKETvonplainankündigt, ohne TLS verwendet werden soll. Ohne es lässt einplainirgendwo in diesem Abschnitt pepsi-setup(1)validatedie Konfiguration ablehnen und pepsi-httpd(1) den Start verweigern, jeweils unter Nennung der Option, des Servers und seines Ports. Ein versehentlich hineingerutschtesplainerreicht daher nie einen Client, der es ohne Nachfrage anwenden und sein Passwort und seine Mail im Klartext senden würde. Setzen Sie es in einem geschlossenen Netz (einem Postfach-Server nur über Loopback oder VPN), wo Klartext die bewusste Wahl ist, aufyes; der Klartext-Server wird dann wie verlangt veröffentlicht, und pepsi-httpd protokolliert bei jedem Start weiterhin eine Warnung dafür. Es betrifft nie einen abgeleiteten Submission-Server, der nie Klartext ist.- IMAP_AUTH, POP3_AUTH
(optional) Einer der Authentifizierungswerte des Drafts:
password-cleartext,password-encrypted,NTLM,GSSAPI,TLS-client-cert,OAuth,client-IP-address,none. Standardwertpassword-cleartext, was überSSLdie gewöhnliche Passwort-über-TLS-Anordnung ist und nicht etwas im Klartext Gesendetes. Ein unbekannter Wert ist ein Startfehler, kein stillschweigend veröffentlichter Tippfehler.- SMTP_HOST, SMTP_PORT, SMTP_SOCKET, SMTP_AUTH
(optional) Der anzukündigende Submission-Server. Lassen Sie normalerweise alle vier weg: Sie werden aus Port,
MODEund Authentifizierungsmechanismus des[pepsi-ingress-listener-*]-Abschnitts abgeleitet, der mitSUBMISSION = yesmarkiert ist, sodass das Verschieben der Submission von STARTTLS auf 587 zu implizitem TLS auf 465 das veröffentlichte Dokument von selbst aktualisiert und die beiden nicht auseinanderdriften können. Setzen Sie sie nur, wenn der öffentliche Submission-Endpunkt nicht der Listener ist, etwa hinter einem Load Balancer.SMTP_HOSTzu setzen schaltet die Ableitung vollständig ab, geben Sie also auch die übrigen an, wenn sie von587/STARTTLS/password-cleartextabweichen.SMTP_SOCKET = plainbraucht dieselbe ALLOW_PLAIN_AUTOCONFIG-Bestätigung wie die eingehenden Server.Ein Submission-Listener über UNIX-Socket oder systemd-Aktivierung wird nie angekündigt: Ein entfernter Client kann den ersten nicht verwenden, und der zweite hat keinen Port in der Konfiguration, der zu veröffentlichen wäre.
- DISPLAY_NAME, DISPLAY_SHORT_NAME
(Text, optional) Was der Client dem Benutzer zeigt. Beide fallen auf den ersten
[pepsi-ingress] ACCEPTED_DOMAINS-Eintrag zurück (denHOSTNAMEdes Ingress, wenn keine Domain konfiguriert ist).- DOCUMENTATION_URL
(URL, optional) Eine Hilfeseite für die Kontoeinstellungen, als
<documentation>-Element des Drafts veröffentlicht. Weggelassen, wenn nicht gesetzt.
[pepsi-autoconfig]
IMAP_HOST = mail.example.org
POP3_HOST = mail.example.org
DISPLAY_NAME = Example Mail
DISPLAY_SHORT_NAME = Example
# SMTP_* deliberately omitted: derived from the submission listener.
95.2.1.1.37. Der Abschnitt [pepsi-tlsrpt]¶
Dieser optionale Abschnitt konfiguriert SMTP TLS Reporting (RFC 8460). Er hat zwei unabhängige Hälften; lassen Sie den Abschnitt weg, um beide zu deaktivieren. pepsi-setup(1) liest ihn für die ankündigende Hälfte; die Sender-Hälfte wird zur Laufzeit von den Relay-Stages (Sitzungsaufzeichnung) und pepsi-tlsrpt(1) (dem täglichen Berichts-Job) gelesen.
- RUA = URI [, URI …]
Berichtsadresse(n), die im
_smtp._tls.<domain>-TXT-Eintrag angekündigt werden, den pepsi-setup(1) für jede Domain ausgibt, damit andere Absender uns ihre TLS-Ergebnisse für Mail an unsere Domains melden. Einemailto:- oderhttps:-URI oder eine kommagetrennte Liste, wörtlich gespeichert. Wenn nicht gesetzt, wird kein Eintrag veröffentlicht.- SEND_REPORTS =
yes|no Ob die Relay-Stages jede ausgehende TLS-Sitzung in
pepsi.tls_sessionfesthalten. Optional; Standardwertno. Es ist nur der Schalter für die Aufzeichnungs-Hälfte: IstRUAgesetzt, prüft pepsi-tlsrpt(1) ihn nicht, es findet schlicht keine Sitzungen zu berichten, wenn nichts sie aufzeichnet (ohneRUAund ohne diese Option gilt der Abschnitt als fehlend, undpepsi-tlsrpt reportverweigert die Ausführung).- REPORT_FROM = ADDRESS
Umschlagabsender und
From:der Berichts-E-Mails, die pepsi-tlsrpt(1) sendet. Erforderlich, um Berichte zu senden (seine Domain ist der Berichts-Einlieferer). Berichte sind kein Null-Absender (RFC 8460 §5.3: sie müssen DKIM/DMARC-alignbar sein); die Bericht-über-einen-Bericht-Schleife wird durch das injiziertestate.tlsrpt-Flag verhindert.- REPORT_STAGE = STAGE
Pipeline-Stage, bei der Berichts-E-Mails injiziert werden (sodass sie signiert und weitergeleitet werden), wie das
BLOCK_RESPONSE_STAGEvon pepsi-stage-anti-spam(1). Muss eine existierende[stage-*]referenzieren. Erforderlich, um Berichte per E-Mail (mailto:) zu versenden.- ORGANIZATION = NAME
organization-name, der in ausgegebene Berichte gesetzt wird. Optional; Standardwert ist dieREPORT_FROM-Domain.- CONTACT = ADDRESS
contact-info, die in ausgegebene Berichte gesetzt wird. Optional.- RETAIN_DAYS = DAYS
Wie viele Tage pepsi-tlsrpt prune die
pepsi.tls_session-Zähler behält. Optional; Standardwert7.pepsi-tlsrpt-prune.timerführt das Bereinigen täglich aus.
95.2.1.1.38. Der Abschnitt [pepsi-dmarc-reports]¶
Dieser optionale Abschnitt regelt die DMARC-Aggregatberichte, die pepsi-stage-dmarc-report(1) speichert. Er wird von dieser Stage gelesen (beim Start des Workers), von pepsi-queue(1) gc, pepsi-status(1), der Administrationskonsole und pepsi-setup(1) check. Jede Option hat einen Standardwert.
- RETAIN_DAYS = DAYS
Wie viele Tage ein Bericht nach dem Ende des Zeitraums, den er abdeckt, aufbewahrt wird;
pepsi-queue gc(pepsi-origin-gc.timer, stündlich) löscht ältere samt ihren Einträgen. Standardwert90, mindestens1.- WINDOW_DAYS = DAYS
Wie viele Tage zurück, gemessen am Ende des Zeitraums jedes Berichts, die Zusammenfassungen und das Urteil von
pepsi-setup checkblicken (jede Quelle ausgerichtet, also istp=rejectsicher; oder die Quellen, die es ablehnt). Standardwert7; zwischen1und RETAIN_DAYS.
95.2.1.1.39. Der Abschnitt [pepsi-telemetry-client]¶
Dieser optionale Abschnitt konfiguriert den lokalen Funktionstelemetrie-Aggregator pepsi-telemetry-client(1). Alle Optionen haben funktionierende Standardwerte; die gesamte Funktion wird durch [pepsi] SHARE_TELEMETRY oben reguliert, das aus ist, sofern der Betreiber es nicht eingeschaltet hat. Nichts hier hat eine Wirkung, bis es eingeschaltet ist. (Der zentrale Collector, pepsi-telemetry(1), liest stattdessen den separaten [pepsi-telemetry]-Abschnitt.)
- UNIXPATH = PATH
Lokaler UNIX-Socket, auf dem der Daemon auf Funktionsereignisse lauscht; die Produzenten-Programme verbinden sich mit demselben Pfad. Optional; Standardwert
/run/pepsi-telemetry/socket.- UNIXPATH_GROUP = GROUP
Gruppe, auf die der Socket
chgrp-t wird (ModusUNIXPATH_MODE), damit sich die Erzeuger verbinden können: die Benutzerpepsi(Stage-Worker, Dispatcher),pepsi-ingress,pepsi-httpdundpepsi-keydisc, die alle Mitglieder der Gruppe sind. Optional; Standardwertpepsi-telemetry.- UNIXPATH_MODE = OCTAL
Rechtebits des Sockets. Optional; Standardwert
660.- SUBMIT_INTERVAL = DURATION
Intervall zwischen Übermittlungen an den Collector (nur
h/m/s-Einheiten — siehe den Dauer-Hinweis oben). Optional; Standardwert60 s. Null ist ein Konfigurationsfehler und keine Endlosschleife.- MAX_FEATURES = N
Obergrenze für die Anzahl der im Speicher gehaltenen verschiedenen Funktionsnamen, die den Speicher gegen einen fehlerhaften lokalen Produzenten begrenzt. Optional; Standardwert
4096.
95.2.1.1.40. Gespeicherte Daten¶
Für jede angenommene Nachricht fügt pepsi-ingress(1) einen Datensatz in die pepsi.workqueue-Tabelle ein, der einen lokalen Bezeichner (workqueue_id), ein zufälliges token, den Empfangs-Zeitstempel (received_at), den Umschlagabsender (mail_from; die leere Zeichenkette für den Null-Absender <>), die Umschlagempfängerliste (rcpt_to) und die geparsten from_header- und subject-Header enthält. Die Nachricht selbst wird aufgeteilt in zwei Teilen gespeichert: eine headers-Spalte (der RFC-5322-Header-Block bis, aber nicht einschließlich des Leerzeilen-Trenners, mit vorangestelltem RFC-5321-§4.4-Trace-Received:-Header und darüber dem Authentication-Results-Header; das ARC-Set wird später von pepsi-stage-arc(1) hinzugefügt) und ein Nachrichtentext (alles nach der Leerzeile; leer für eine reine Header-Nachricht). Die Rekonstruktions-Invariante ist raw = headers || CRLF || body. Das Aufteilen der Nachricht lässt Stages, die nur die Header oder den Umschlag berühren, nur die headers-Spalte laden (und umschreiben) und nie den (potenziell großen) Nachrichtentext ziehen.
Der Nachrichtentext ist keine Spalte von pepsi.workqueue, sondern ein Datensatz einer eigenen Tabelle, pepsi.workqueue_body (body_id, body und die berechnete Größe octets), auf den der Nachrichten-Datensatz über body_id verweist. Das verhindert, dass eine Nachricht mit mehreren Empfängern einmal pro Empfänger gespeichert wird. Jeder daraus abgespaltene Datensatz verweist auf denselben Nachrichtentext-Datensatz, ob die Aufteilung von Einstellungen pro Adresse, vom einen Datensatz pro Empfänger einer Relay-Stage, vom Fan-out einer Mailingliste oder von einem Bounce oder einer DSN pro Empfänger herrührt, sodass ein Beitrag von 25 MiB an tausend Mitglieder ein Nachrichtentext von 25 MiB und tausend kleine Datensätze ist. Eine Stage, die einen Nachrichtentext umschreibt (Entschlüsselung, die Fußzeile einer Liste), speichert einen neuen Nachrichtentext-Datensatz und lässt nur ihre eigene Nachricht darauf verweisen (Copy-on-Write), sodass kein Umschreiben ein Geschwister erreichen kann. Ein Nachrichtentext wird von einem Trigger gelöscht, sobald der letzte darauf verweisende Datensatz gelöscht oder umgelenkt wird, und pepsi-dispatch(1) räumt die seltene Waise auf, die ein Wettlauf hinterlässt (pepsi.workqueue_body_gc()). header_octets ist die passende berechnete Größe von headers. Die Zulassungsprüfung der Warteschlange (MAX_QUEUE_BYTES, pepsi.queue_usage()) summiert die beiden Größenspalten auf, die auch Rollen lesen können, die die Nachricht selbst nicht lesen dürfen. Die berechneten SPF-, DKIM- und DMARC-Urteile werden im state des Datensatzes unter einem auth-Schlüssel gespeichert und die authserv_id unter state.origin; das arc-Urteil beginnt als none und wird von der ARC-Stage ausgefüllt. Der Dispatcher wird aus dieser Transaktion nicht benachrichtigt: pepsi-ingress(1) fasst Zulassungen zusammen und gibt höchstens ein Wecken je DISPATCH_WAKE_INTERVAL aus, außerhalb des Bandes und nachdem die Datensätze committet sind, mit leerer Nutzlast (siehe die Beschreibung jener Option oben). Ein LISTEN workqueue-Konsument bekommt daher keine Benachrichtigung je Nachricht und keine Nutzlast zum Parsen.
Jeder Datensatz trägt zusätzlich seinen Verarbeitungszustand für die Stage-Pipeline, die nach dem Ingress läuft: eine stage (den [stage-<stage>]-Abschnitt des aktuell für das Weiterschalten der Nachricht zuständigen Programms), einen status (eines von pending, running, paused, failed oder timeout), ein state (das mit der Nachricht mitgeführte JSON-Objekt, in pepsi.state(7) dokumentiert) und ein timeout (wann eine paused-Nachricht erneut eingereiht werden soll). Jede neue Nachricht wird explizit bei der Anfangs-Stage eingefügt — stage = init, status = pending — sodass sie bei [stage-init] in die Pipeline eintritt. Diese Spalten werden mit pepsi-queue(1) inspiziert und repariert.
pepsi.workqueue (with its bodies in pepsi.workqueue_body) is the only
queue of messages in flight; the schema has some eighty-five tables in all. The
table that every deployment uses besides the queue is pepsi.dns_address: a
cache of resolved A/AAAA addresses for recipient mail-exchanger hosts, with
per-address connect health, maintained by pepsi-stage-relay-to-internet(1). Each row records a host, one resolved address, the DNS-TTL
expires_at, a failed flag and the last_success_at time, so a working
address is preferred until its TTL elapses and a host is re-resolved once all
its cached addresses have failed or expired. It carries no message data;
pepsi-queue(1) gc deletes its expired rows. Beside it,
pepsi.mta_sts_policy holds the MTA-STS policies that the same stage has
fetched, per recipient domain, until their max_age passes, so a policy stays
enforced across worker restarts; pepsi-queue(1) gc refreshes them
before that, so a policy does not lapse for want of mail.
The rest are the feature tables, each described with the component that owns it:
the pipeline counters stage_stats and dispatch_stats
(pepsi-dispatch(1), exported by pepsi-httpd(1) at /metrics),
whitelist (pepsi-whitelist(1)), tls_session (pepsi-tlsrpt(1)), settings (pepsi-settings(1)), vacation_reply
(pepsi-stage-vacation(1)), payment_request_reply
(pepsi-stage-anti-spam(1)), secretary_challenge, secretary_sent and
secretary_answered (pepsi-stage-secretary(1)), mailbox_quota (pepsi-quota(1)),
config_override (the database configuration layer, pepsi-config(1)),
origin_nonce and auto_pay_spend (pepsi-stage-auto-pay(1)),
telemetry (pepsi-telemetry(1)), secure_message and
secure_access (pepsi-secure-link(1)), the key store
crypto_identity / peer_key / peer_has_own_key / ca_trust /
key_request / otp_key / otp_pending / smime_capability /
compromised_key / compromised_key_import / crl_cache /
ca_issuer_cache (pepsi-keys(1) and pepsi-keydisc(1)),
signed_sender (pepsi-stage-decrypt(1)), dmarc_report and
dmarc_report_record (pepsi-stage-dmarc-report(1)), ip_blocklist,
ip_blocklist_source and reputation_check (pepsi-reputation(1)),
the mailing-list tables mailing_list and list_* (pepsi-list(1))
except list_confirmation, the table of subscription confirmation requests
that outside lists send to local users (pepsi-stage-check-whitelist(1)
records them and pepsi-stage-auto-whitelist(1) matches them), the list
archive archive_* (pepsi-archive(1)), the RFC 7293 login record
login_assignment (pepsi-setup(1), The login assignment record), the
logs event_log and mail_log, the telemetry daemon’s liveness row
telemetry_client (pepsi-telemetry-client(1)), the schema record
schema_file, and the administrative surface admin_account /
admin_session / api_token / setup_task / setup_task_log /
own_enrolment / own_session / webauthn_credential /
webauthn_challenge (pepsi-httpd(1) and pepsi-setup(1)). All of
them are created by pepsi-setup(1). Apart from secure_message
(ciphertext awaiting its recipient), the list archive, whose purpose is to keep
posts, and the messages a list holds for moderation, none holds message content.
Die state-Spalte ist das mit der Nachricht vom Ingress bis zu ihrer terminalen Stage mitgeführte JSON-Objekt; sie ist der Kanal, über den Stages kommunizieren. Ingress sät darin die SMTP-Ursprungs-Herkunftsdaten der Verbindung, die eingehenden SPF/DKIM/DMARC-Urteile und etwaige RFC-3461-DSN-Parameter; spätere Stages führen ihre eigenen Urteile und Zwischendaten ein. Ihr vollständiges Layout, mit jedem Schlüssel und wer ihn schreibt und verbraucht, ist in pepsi.state(7) dokumentiert.
95.2.1.1.41. Beispiel¶
Ein vollständiger Weiterleiter: auf den drei kanonischen SMTP-Ports empfangen, beim Eintreffen per ARC versiegeln, per SRS umschreiben, direkt zum MX zustellen und Fehler bouncen (den Bounce vor der Zustellung signieren):
[pepsi]
DKIM_SELECTOR = pepsi
ARC_DOMAIN = example.org
ARC_ALGORITHM = rsa
[pepsi-postgres]
CONFIG = postgres:///pepsi
# SQL_DIR defaults to ${DATADIR}/sql; set it when running from a checkout.
[pepsi-ingress]
HOSTNAME = mail.example.org
ACCEPTED_DOMAINS = example.org example.com
MAX_MESSAGE_SIZE = 26214400
# The three canonical SMTP listeners. TLS_CERT/TLS_KEY are omitted so
# pepsi-setup auto-fills the certbot path and obtains the certificate.
# Port 25: cleartext with opportunistic STARTTLS.
[pepsi-ingress-listener-mx]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 25
MODE = starttls
MYNETWORKS = 127.0.0.0/8 ::1/128 10.0.0.0/8
# Port 465: implicit TLS (SMTPS), authenticated submission via Dovecot SASL.
[pepsi-ingress-listener-submissions]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 465
MODE = tls
SUBMISSION = yes
SASL_TYPE = dovecot
SASL_PATH = /run/dovecot/auth-client-pepsi
# Port 587: cleartext submission upgraded with STARTTLS.
[pepsi-ingress-listener-submission]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 587
MODE = starttls
SUBMISSION = yes
SASL_TYPE = dovecot
SASL_PATH = /run/dovecot/auth-client-pepsi
[pepsi-srs]
SRS_DOMAIN = srs.example.net
SECRET_FILE = /etc/pepsi/srs.secret
# init: ARC-seal the message as received, then hand to SRS.
[stage-init]
PROGRAM = pepsi-stage-arc
NEXT_STAGE = srs
[stage-srs]
PROGRAM = pepsi-stage-srs
NEXT_STAGE = deliver
# deliver: direct-to-MX; failures go to the bounce stage.
[stage-deliver]
PROGRAM = pepsi-stage-relay-to-internet
SERVER_NAME = mail.example.org
POSTMASTER = postmaster@example.org
BOUNCE_STAGE = bounce
# This host's public sending IP(s); pepsi-setup unions PUBLIC_IP from every
# relay stage into the SPF record.
PUBLIC_IP = 203.0.113.7 2001:db8::25
# bounce: build an unsigned DSN, sign it, then deliver it.
[stage-bounce]
PROGRAM = pepsi-stage-bounce
SERVER_NAME = mail.example.org
POSTMASTER = postmaster@example.org
NEXT_STAGE = bounce-sign
BOUNCE_MESSAGE = default
[stage-bounce-sign]
PROGRAM = pepsi-stage-dkim-sign
NEXT_STAGE = deliver
Um stattdessen über einen Smarthost weiterzuleiten, ersetzen Sie das PROGRAM der deliver-Stage durch pepsi-stage-relay-to-smarthost und fügen [pepsi-stage-relay-to-smarthost-mta-*]-Abschnitte hinzu, z. B.:
[pepsi-stage-relay-to-smarthost-mta-smarthost]
HOST = smtp.relay.example.net
PORT = 587
CATCH_ALL = yes
95.2.1.1.42. Dateien¶
Jede Pepsi-Komponente liest dieselbe Datei. Wenn eine Komponente ohne –config gestartet wird, wird der erste vorhandene Pfad aus der folgenden Liste verwendet:
$XDG_CONFIG_HOME/pepsi.conf$HOME/.config/pepsi.conf/etc/pepsi/pepsi.conf/etc/pepsi.conf
pepsi-setup --wizard schreibt /etc/pepsi/pepsi.conf; make install legt daneben eine Referenzdatei pepsi.conf.sample ab, die jede Option dokumentiert, selbst aber keine funktionierende Konfiguration ist.
Bevor diese Datei gelesen wird, wird jede *.conf in ${DATADIR}/config.d geparst, sodass paketierte Standardwerte an Ort und Stelle sind und pepsi.conf sie Option für Option überschreibt (ein in beiden definierter Abschnitt wird zusammengeführt, nicht ersetzt). Zwei werden ausgeliefert:
vacation.conf— die Urlaubsnotizen je Sprache; siehe Der Abschnitt [pepsi-vacation-default-message] oben.reputation.conf— die IP-Sperrlisten; siehe Die Abschnitte [pepsi-reputation-list-*] oben.
make install löscht eine etwa vorhandene thunderbird.conf aus diesem Verzeichnis, weil jede Datei dort eingelesen wird und diese ein globales CRYPTO_ALLOW_DOWNGRADE = yes setzen würde. Der unter CRYPTO_ALLOW_DOWNGRADE beschriebene S/MIME-Fähigkeitsdatensatz je Peer trifft diese Entscheidung stattdessen für jeden Korrespondenten.
Diese Dateien gehören dem Paket: Definieren Sie die gewünschten Optionen in pepsi.conf neu, statt sie zu bearbeiten, sonst verwirft ein Upgrade die Änderung.
95.2.1.1.43. Siehe auch¶
pepsi-ingress(1), pepsi-dispatch(1), pepsi-httpd(1), pepsi-setup(1), pepsi-config(1), pepsi-queue(1), pepsi-status(1), pepsi-sendmail(1), pepsi-whitelist(1), pepsi-settings(1), pepsi-tlsrpt(1), pepsi-quota(1), pepsi-failure-bouncer(1), pepsi-list(1), pepsi-keys(1), pepsi-keydisc(1), pepsi-secure-link(1), pepsi-detect-language(1), pepsi-telemetry(1), pepsi-telemetry-client(1), pepsi-helper-token-refresh(1), pepsi-helper-auto-pay(1), pepsi-helper-mailbox-scan(1), pepsi-stage-arc(1), pepsi-stage-srs(1), pepsi-stage-encrypt(1), pepsi-stage-decrypt(1), pepsi-stage-autocrypt-learn(1), pepsi-stage-secure-link(1), pepsi-stage-vks-confirm(1), pepsi-stage-dmarc-report(1), pepsi-stage-route(1), pepsi-stage-dkim-sign(1), pepsi-stage-relay-to-internet(1), pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-lmtp(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-dot-forward(1), pepsi-stage-bounce(1), pepsi-stage-discard(1), pepsi-stage-anti-spam(1), pepsi-stage-auto-pay(1), pepsi-stage-check-whitelist(1), pepsi-stage-auto-whitelist(1), pepsi-stage-detect-language(1), pepsi-stage-block-language(1), pepsi-stage-if(1), pepsi-stage-milter(1), pepsi-stage-aliases(1), pepsi-stage-vacation(1), pepsi-stage-edit-settings(1), pepsi-archive(1), pepsi-stage-list(1), pepsi-stage-list-post(1), pepsi-stage-list-deliver(1), pepsi-stage-list-command(1), pepsi-stage-list-bounce(1), pepsi.state(7), systemd.socket(5)
95.2.1.1.44. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.