7. Konfiguration¶
Alle Pepsi-Komponenten lesen eine Konfigurationsdatei im INI-Stil (das Format wird mit den GNU-Taler-Werkzeugen geteilt). Die vollständige Optionsreferenz steht in der einzigen Handbuchseite pepsi.conf(5) und in den programmweisen Kapiteln unter Programme.
7.1. Dateiformat¶
Eine Datei ist eine Folge von [SECTION]-Kopfzeilen, jeweils gefolgt von OPTION = VALUE-Zuweisungen. Abschnitts- und Optionsnamen sind unabhängig von der Groß-/Kleinschreibung (konventionell Großschreibung); # oder % beginnt einen Kommentar; ein Wert kann in doppelte Anführungszeichen gesetzt werden, um umgebende Leerzeichen zu erhalten.
Drei Direktiven fügen mehrere Dateien zu einer Konfiguration zusammen. Das ist wichtig, um Geheimnisse aus der für alle lesbaren Konfigurationsdatei herauszuhalten:
@inline@ FILEBindet eine andere Datei ein, relativ zur aktuellen.
@inline-matching@ GLOBBindet jede Datei ein, die auf ein Shell-Glob passt.
@inline-secret@ SECTION FILEFührt einen Abschnitt aus einer modusbeschränkten Datei (typischerweise Zugangsdaten) zusammen. Eine Direktive beendet den Abschnitt, in dem sie steht, schreiben Sie sie also nach dessen letzter Option; eine Option darunter gehörte zu keinem Abschnitt, und die Datei ließe sich nicht laden. Ein Fragment, das nicht gelesen werden kann, löst nur eine Warnung aus, und die Optionen, die es enthält, sehen dann ungesetzt aus.
pepsi-setup runübergibt jedes Fragment an das Dienstkonto, das es lesen soll. Ein Zugangsdatum, das stattdessen direkt inpepsi.confsteht, ist für jedes lokale Konto lesbar (Mail-Appliances speichern Geheimnisse für alle lesbar oder ungeschützt).
Pfadwertige Optionen durchlaufen eine $-Expansion aus dem [PATHS]-Abschnitt oder der Umgebung ($VAR, ${VAR}, ${VAR:-default}). Werttypen sind boolean (YES/NO), Zahl, Dauer (nur Einheiten h/m/s — siehe den Vorbehalt unten), Pfad und Unix-Modus (oktal).
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 Zeitfenster 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).
7.1.1. Mitgelieferte Standardwerte: config.d¶
Unterhalb der Datei des Betreibers gibt es noch eine Schicht. Jedes *.conf in ${DATADIR}/config.d (/usr/share/pepsi/config.d bei einer Paketinstallation) wird vor pepsi.conf geparst, sodass diese Dateien Standardwerte liefern, die pepsi.conf Option für Option überschreibt. Sie gehören zum Paket: Definieren Sie in pepsi.conf neu, was Sie wollen, statt sie zu bearbeiten, sonst verwirft ein Upgrade die Änderung.
Eine wird mitgeliefert:
vacation.confKonfiguration, die als Wortlaut statt als Wert ausgeliefert wird: die
[pepsi-vacation-default-message]-Notizen in zehn Sprachen, auf die pepsi-stage-vacation zurückfällt. WerENinpepsi.confneu definiert, lässt die anderen neun bestehen.
Keine config.d-Datei senkt die kryptografische Richtlinie für eine ganze Klasse von Korrespondenten. Welchen S/MIME-Container ein Korrespondent erhält, entscheidet je Gegenstelle der S/MIME-Fähigkeitsdatensatz (Der S/MIME-Fähigkeitsdatensatz pro Gegenstelle, Welchen S/MIME-Container ein Korrespondent erhält). Nur ein Korrespondent, von dem verzeichnet ist, dass er AuthEnvelopedData nicht lesen kann, erhält AES-256-CBC. Ein Korrespondent, der noch nie eine signierte Nachricht gesendet hat (etwa ein Thunderbird-Benutzer), wird einmalig in einem Klartextteil neben dem ersten Chiffrat gebeten, mit einer signierten Nachricht zu antworten (Was ein Korrespondent mit einem nicht gemessenen Client sieht); alternativ legt der Betreiber den Datensatz an (pepsi-keys peer capability set ADDRESS cbc).
7.3. Ingress und Listener¶
[pepsi-ingress] enthält die Richtlinie zur Nachrichtenannahme (HOSTNAME, ACCEPTED_DOMAINS, MAX_MESSAGE_SIZE, MAX_CONNECTIONS, DMARC_ENFORCE, DNS-Einstellungen). Jeder [pepsi-ingress-listener-<name>]-Abschnitt bindet einen Socket:
SERVE = tcp(mitBIND_TO/PORT),unix(mitUNIXPATH) odersystemd(Socket-Aktivierung,FD_INDEX).MODE = plain|starttls|tlswählt die Transportsicherheit;starttls/tlserfordernTLS_CERTundTLS_KEY.
Deklarieren Sie so viele Listener wie nötig — z. B. einen MX-Listener auf 25 mit opportunistischem STARTTLS und einen Submission-Listener auf 465 mit implizitem TLS.
7.4. Die Stage-Pipeline¶
Die Pipeline wird vollständig aus [stage-<name>]-Abschnitten verdrahtet. Der Stage-Name ist ein vom Betreiber gewähltes Etikett; das PROGRAM des Abschnitts wählt das Binärprogramm, und NEXT_STAGE/BOUNCE_STAGE verbinden den Graphen:
PROGRAM(erforderlich) Das Stage-Binärprogramm (auf
PATHgefunden, sofern nicht absolut). Ein Binärprogramm kann mehrere Stages bedienen: Es liest seine Optionen aus dem Abschnitt, an dem sich die Nachricht gerade befindet.NEXT_STAGE(optional) Wohin eine Nachricht bei Erfolg weiterschaltet. Eine terminale Stage ohne
NEXT_STAGEentfernt die zugestellte Nachricht.BOUNCE_STAGE(optional) Wohin eine dauerhaft fehlgeschlagene Nachricht geroutet wird, damit eine DSN entsteht; mit
ORIGINATE_SUCCESS_DSNgilt das auch für eine erfolgreich zugestellte Nachricht. Üblicherweise ist das einepepsi-stage-bounce-Stage.PARALLELISM/MAX_MESSAGES/QUEUE_LIMIT(optional) Wie der Dispatcher den Worker-Pool für diese Stage bemisst: die Obergrenze gleichzeitiger Worker-Prozesse (
PARALLELISM, Standardwert 4, bei Bedarf gestartet und im Leerlauf abgeräumt), die Anzahl der Nachrichten, die ein Worker verarbeitet, bevor er erneuert wird (MAX_MESSAGES, Standardwert 1000), und wie viele Nachrichten gleichzeitig an einen Worker weitergereicht werden (QUEUE_LIMIT, Standardwert 4). Die Stage kann alsoQUEUE_LIMIT × PARALLELISMNachrichten gleichzeitig in Bearbeitung haben, währendPARALLELISMallein die Zahl der Prozesse und Verbindungen festlegt. Siehe pepsi-dispatch.FUSION(optional) Ob ein Vorgänger diese Stage in seinem eigenen Worker-Prozess ausführen darf, anstatt den Datensatz an den Dispatcher zurückzugeben. Standard ist
YES, wennPROGRAMeine der schnellen, körperlosen Stages ist (pepsi-stage-+if,discard,auto-whitelist,block-language,check-whitelist,srs,list,edit-settings,dmarc-reportoderdefang), sonstNO;[pepsi] ALLOW_FUSION = NOschaltet die Fusion global ab.
Neue Nachrichten treten immer bei [stage-init] ein, das existieren muss. Jedes Programm liest seine eigenen Optionen aus seinem Abschnitt; diese sind je Programm unter Programme dokumentiert.
7.4.1. Reihenfolgebedingungen¶
Den Pipeline-Graphen zeichnen Sie selbst, aber sechs Reihenfolgen sind keine freie Wahl, und jede davon falsch zu setzen erzeugt Mail, die richtig aussieht. pepsi-setup warnt vor vieren davon: einer DKIM-signierenden Stage, die zu einer Encrypt-Stage führt, einer Decrypt-Stage, die zu einer ARC-Stage führt, einer Decrypt-Stage ohne nachgelagerte lokale Zustellung und einer Re-Encryption-Stage, vor der keine Decrypt-Stage liegt oder die zu einer Stage führt, die den Inhalt liest oder weiterleitet.
Die Verschlüsselung kommt vor der DKIM-Signierung. Die empfohlene ausgehende Kette ist:
submission → … → encrypt → srs → dkim-sign → relay
pepsi-stage-encrypt schreibt den Nachrichtentext um, und DKIM muss die tatsächlich übertragenen Bytes signieren. Zuerst zu signieren ergibt eine Nachricht, deren DKIM-Signatur beim Empfänger nicht verifiziert — was schlimmer ist als gar keine Signatur, denn eine kaputte Signatur ist für einen empfangenden MTA ein stärkeres negatives Signal als eine fehlende.
Alles, was den Nachrichtentext liest, kommt vor der Verschlüsselung. Die Pay-to-Send-Schranke (pepsi-stage-anti-spam) und die Spracherkennung (pepsi-stage-detect-language) wollen beide Klartext, und beide bekommen ihn, weil die Verschlüsselung auf dem ausgehenden Pfad zuletzt kommt — was der Grund für die obige Reihenfolge ist.
SRS ist für weitergeleitete Mail da und auf dem ausgehenden Relay-Ende harmlos. Es schreibt einen Absender in der Domain eines anderen um, also bei Mail, die dieser Host weiterleitet, damit SPF beim nächsten Hop besteht. Der Null-Absender und ein Absender, der bereits in der SRS-Domain liegt, bleiben unangetastet. SRS_DOMAIN ist eine eigene Domain, die mit keiner bedienten Domain ausgerichtet ist. pepsi-setup lehnt eine ausgerichtete ab, sofern [pepsi-srs] ALLOW_ALIGNED_DOMAIN es nicht erlaubt, denn sonst bestünden weitergeleitete Fälschungen einer bedienten Domain beim nächsten Hop DMARC allein über SPF (siehe Ein entfernter Absender im Bedrohungsmodell). Auf einem Relay-Ende, das weitergeleitete und eingelieferte Mail gemeinsam nutzen, wird deshalb auch die Mail unserer eigenen Benutzer umgeschrieben. Das kostet die SPF-Ausrichtung für deren Domain, aber DMARC besteht dennoch über die ausgerichtete DKIM-Signatur, die dkim-sign danach hinzufügt, in der Reihenfolge, die pepsi-setup prüft: encrypt → srs → dkim-sign → relay. Eine Kopie, die ein Alias oder ~/.forward erzeugt hat, erhält statt einer SRS-Adresse eine Weiterleitungs-Rücksendeadresse. Ein entfernter Bericht über eine solche Kopie wird über die Bounce-Stage beantwortet (die BOUNCE_STAGE der SRS-Stage, sonst eine Stage namens bounce); eine Pipeline, die nach außen weiterleitet, sollte also eine haben.
ARC kommt vor der Entschlüsselung. Die empfohlene eingehende Kette ist:
init = arc → decrypt → aliases → (anti-spam / language / …) → local delivery
Ein ARC-Set versiegelt die Nachricht so, wie sie ankam. pepsi-stage-decrypt schreibt den Nachrichtentext um. Würde zuerst entschlüsselt, beschriebe das versiegelte AMS daher Bytes, die sonst niemand je gesehen hat: eine Aussage über eine Nachricht, die es nie gab.
Die Entschlüsselung braucht nachgelagert lokale Zustellung. Entschlüsseln entwertet die DKIM-Signatur des Absenders. Das ist harmlos bei einer Nachricht, die gleich in ein Postfach auf diesem Host abgelegt wird, aber nicht bei einer, die weitergeleitet wird. Die Stage läuft daher nur für Empfänger, die dieser Host bedient, und sie teilt eine Nachricht, die Empfänger beider Art hat. pepsi-setup warnt, wenn von einer Decrypt-Stage aus kein pepsi-stage-relay-to-maildir oder pepsi-stage-relay-to-lmtp erreichbar ist, denn eine solche Stage ist entweder sinnlos oder schädlich.
Die Neuverschlüsselung kommt zuletzt, unmittelbar vor der lokalen Zustellung. pepsi-stage-reencrypt versiegelt, was die Decrypt-Stage geöffnet hat, an den eigenen Mail-Client-Schlüssel des Empfängers. Sie muss daher nach der Entschlüsselung kommen (davor ist nichts, was sie sieht, geöffnet). Sie muss außerdem nach jeder Stage kommen, die den Inhalt liest oder eine Kopie weiterleiten kann, denn diese Stages sähen sonst Chiffrat, das nur der Client des Benutzers öffnen kann (Ende-zu-Ende-Verschlüsselung: zwei Verwahrungsmodi): Spracherkennung und -sperre, die Spam-Schranke, die Whitelist-Prüfung, pepsi-stage-autocrypt-learn, der Abwesenheitsresponder, die ~/.forward-Verarbeitung und die Alias-Expansion.
Das Spiegelbild der ausgehenden Regel gilt ebenso: Alles, was den Nachrichtentext liest, kommt nach der Entschlüsselung, weshalb die Inhalts-Stages dort stehen, wo sie stehen. Das Lernen von Gegenstellen-Schlüsseln (pepsi-stage-autocrypt-learn) kommt außerdem nach dem Spam-Urteil, damit nie ein Schlüssel aus Spam gelernt wird. Beachten Sie, dass die Decrypt-Stage für jede Nachricht, die durch sie hindurchgeht, den gesamten Nachrichtentext lädt (ihr Load liegt je Stage fest, und ob eine Nachricht geschützt ist, lässt sich den Umschlagspalten nicht ansehen), sodass die Platzierung ebenso eine Leistungs- wie eine Korrektheitsfrage ist.
7.5. Durchgearbeitete Beispiele¶
Jedes Beispiel unten ist eine vollständige, minimale Pipeline für eine Aufgabe, ohne Sprachklassifizierung, ARC/DKIM-Signierung oder Spam-Filterung: nur die gemeinsamen Abschnitte, ein Listener und die Stages, die die Arbeit erledigen. Allen gemeinsam sind dieselben grundlegenden Abschnitte:
[pepsi-postgres]für die Datenbank, und[pepsi-ingress]plus ein[pepsi-ingress-listener-*]-Socket.
Die Listener setzen MODE = starttls/tls, aber kein TLS_CERT/TLS_KEY: pepsi-setup füllt die certbot-Pfade automatisch aus (siehe Installation). Setzen Sie sie explizit oder übergeben Sie --no-certbot, um das Zertifikat selbst zu verwalten.
Jede ist eine echte, in sich geschlossene Konfiguration. Um ARC, SRS, DKIM-Signierung oder Spam-Filterung hinzuzufügen, setzen Sie die entsprechenden Stages zwischen init und die Zustell-Stage, wie es die Beispiel-pepsi.conf zeigt.
7.5.1. Minimal eingehend (Relay zu einem Smarthost)¶
Ein Edge-MX, der Mail für unsere Domains annimmt und jede Nachricht an einen authentifizierten vorgelagerten Smarthost übergibt. init ist die Relay-Stage; der Smarthost authentifiziert uns, sodass hier keine SRS-Umschreibung nötig ist:
[pepsi-postgres]
CONFIG = postgres:///pepsi
[pepsi-ingress]
HOSTNAME = mail.example.org
ACCEPTED_DOMAINS = example.org
[pepsi-ingress-listener-mx]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 25
MODE = starttls
# init: relay every accepted message to the upstream smarthost. A successful
# delivery is terminal (no NEXT_STAGE).
[stage-init]
PROGRAM = pepsi-stage-relay-to-smarthost
SERVER_NAME = mail.example.org
# The upstream smarthost (one [...-mta-*] section per route; CATCH_ALL takes
# everything not matched by a DOMAINS list).
[pepsi-stage-relay-to-smarthost-mta-upstream]
HOST = smtp.relay.example.net
PORT = 587
MODE = starttls
AUTH = plain
USERNAME = relayuser
PASSWORD = changeme
CATCH_ALL = yes
7.5.2. Minimal ausgehend (Relay direkt ins Internet)¶
Ein Submission-/Relay-Host, der die Mail unserer eigenen Benutzer annimmt und sie direkt an den MX jedes Empfängers zustellt. Der Listener vertraut einem lokalen Netzwerk (MYNETWORKS), sodass diese Submissions als lokal erzeugt markiert werden und an jede Domain weiterleiten dürfen; ausgehende Mail behält ihren eigenen Umschlagabsender, daher gibt es keine SRS-Stage:
[pepsi-postgres]
CONFIG = postgres:///pepsi
[pepsi-ingress]
HOSTNAME = mail.example.org
ACCEPTED_DOMAINS = example.org
[pepsi-ingress-listener-submission]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 587
MODE = starttls
# Trust submissions from this network without authentication (use SASL_TYPE /
# TLS_AUTH_CLIENT instead for roaming users).
MYNETWORKS = 10.0.0.0/8
# init: deliver directly to each recipient's mail exchanger. Terminal.
[stage-init]
PROGRAM = pepsi-stage-relay-to-internet
SERVER_NAME = mail.example.org
# Read by pepsi-setup to build the SPF record listing our sending hosts, and
# to check each address's PTR against SERVER_NAME above. PUBLIC_IP belongs in
# the relay *stage's* section: pepsi-setup finds it by walking [stage-*] and
# keeping the sections whose PROGRAM is a relay, never by the program's own
# section name.
PUBLIC_IP = 203.0.113.7 2001:db8::25
7.5.3. Minimale lokale Zustellung (Relay zu Maildir)¶
Ein MX, der Mail für unsere Domain in das Maildir/new/ lokaler Benutzer zustellt. Jeder Empfänger ist in ACCEPTED_DOMAINS (sodass Ingress sie annimmt) und löst auf ein lokales Konto auf, daher ist kein NEXT_STAGE nötig. Fügen Sie eines hinzu (eine Smarthost- oder Bounce-Stage), falls ein Empfänger in unserer Domain kein lokales Postfach haben könnte:
[pepsi-postgres]
CONFIG = postgres:///pepsi
[pepsi-ingress]
HOSTNAME = mail.example.org
ACCEPTED_DOMAINS = example.org
[pepsi-ingress-listener-mx]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 25
MODE = starttls
# init: write each local recipient's copy into their Maildir via the setuid
# helper. Terminal for local recipients.
[stage-init]
PROGRAM = pepsi-stage-relay-to-maildir
SERVER_NAME = mail.example.org
Eine Staging-Installation, die nie das Netzwerk berührt, tauscht die Zustell-Stage gegen pepsi-stage-discard (siehe pepsi-stage-discard).
7.6. Konfiguration in der Datenbank¶
Die oben beschriebene Datei ist die Basisschicht. Darüber liest Pepsi eine Menge administratorverwalteter Überschreibungen aus der Tabelle pepsi.config_override, sodass eine laufende Installation ohne Dateibearbeitung und ohne Neustart umkonfiguriert werden kann.
Nichts davon ist standardmäßig an. Ohne Datensätze in dieser Tabelle verhält sich eine Installation genau so, wie ihre Konfigurationsdatei es sagt — es gibt keine implizite Konfiguration, die sich in der Datenbank versteckt, und jede Überschreibung zu löschen bringt das System zum Verhalten der Datei zurück.
7.6.1. Die Geltungsbereichskette¶
Fünf Schichten, die niedrigste Präzedenz zuerst:
Schicht |
Geschrieben von |
Gilt für |
|---|---|---|
die Konfigurationsdatei |
dem Betreiber, mit einem Texteditor |
alles |
|
|
alles |
|
|
Nachrichten, deren maßgebliche Adresse bei dieser Domain liegt |
|
|
Nachrichten, deren maßgebliche Adresse genau diese ist |
|
dem Kontoinhaber, per E-Mail |
Nachrichten an/von genau dieser Adresse |
Höhere Schichten überschreiben niedrigere Option für Option, nie Abschnitt für Abschnitt. Eine Option, die keine Schicht erwähnt, behält ihren Dateiwert, sodass eine Überschreibung immer eine gezielte Ergänzung ist und nicht der Ersatz eines ganzen Abschnitts.
Die „maßgebliche Adresse“ ist dieselbe, die die Einstellungsschicht je Adresse verwendet: der Absender des Umschlags bei einer lokal erzeugten Nachricht, sonst jeder Empfänger des Umschlags. Wenn die Empfänger einer Nachricht für die Stage, die gleich läuft, auf verschiedene Konfigurationen auflösen, wird die Nachricht in einen Datensatz je eigener Konfiguration aufgeteilt, genau wie bei pepsi.settings.
Die Schichten domain: und address: enthalten nur [stage-*]-Abschnitte: Eine Stage zieht sie für den Abschnitt heran, den sie gerade ausführt, und zwar pro Nachricht. Jeder andere Abschnitt wird einmal pro Prozess gelesen und sieht die Datei plus die global-Schicht; daher weigert sich pepsi-config, eine bereichsbezogene Überschreibung eines solchen Abschnitts zu speichern, und pepsi-setup run meldet jeden solchen Datensatz als Fehler.
7.6.2. Warum pepsi.settings eine eigene Tabelle ist¶
Die beiden haben verschiedene Schreibbefugnisse:
pepsi.settingswird von Kontoinhabern geschrieben, aus ihrem eigenen Postfach, über pepsi-stage-edit-settings, beschränkt auf die Stage-Abschnitte, die der Betreiber inEDITABLE_STAGESaufgeführt hat;config_overridedefiniert die Pipeline und ist nur über die Datenbankrollepepsi-configbeschreibbar.
Sie zusammenzuführen setzte benutzerbeschreibbare Datensätze in dieselbe Tabelle wie die Definition des Mailservers. Dort würde ein einziger Fehler in einer Namensraumprüfung nicht mehr nur eine Überschreibung durchsickern lassen, sondern einem Benutzer erlauben, den MTA umzukonfigurieren. PostgreSQL setzt die Trennung durch: pepsi-setup gewährt INSERT/UPDATE/DELETE auf config_override allein der Rolle pepsi-config, entzieht sie jedem Dienstkonto und verifiziert beides nach jeder Installation gegen die laufende Datenbank. Ein Stage-Worker hat die Aufgabe, feindliche Mail zu parsen; er darf die Konfiguration lesen, aber nicht ändern.
7.6.3. Was in der Konfigurationsdatei bleibt¶
Manche Abschnitte werden nie aus der Datenbank gelesen, welche Datensätze auch existieren. Eine Überschreibung, die einen davon benennt, wird zur Laufzeit ignoriert und beim Schreiben abgelehnt:
[pepsi],[pepsi-postgres],[PATHS]Werden gebraucht, um die Datenbank überhaupt erst zu finden und zu öffnen.
[pepsi]enthält außerdem die nur dem Administrator vorbehaltene kryptographische Richtlinie.[pepsi-httpd],[pepsi-httpd-listener-*],[pepsi-httpd-cert-*]Der Server, der die Konfigurationsoberfläche bedient, muss immer starten können, was auch immer die Datenbank sagt.
[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 (siehe Das Secure-Link-Ausweichportal). Könnte die Datenbank es ersetzen, könnte ein Angreifer stillschweigend dafür sorgen, dass die nächste gespeicherte Nachricht eine ist, die er öffnen kann. Das ist dieselbe Art von Angriff wie das Absenken der Kryptorichtlinie. Es aus der Datenbank herauszuhalten, verwehrt einem gestohlenen Dump außerdem jedes Offline-Raten von PINs (Offline-Raten schwacher Passwort-Hashes, Schlüssel-Passphrasen und abgeleiteter Schlüssel).[pepsi-admin]Entscheidet, wer den Server administrieren darf und wie die Administrationsoberfläche die Datenbank erreicht. Könnte die Datenbank das festlegen, wäre ein Schreibzugriff auf die Datenbank ein Weg, sich selbst die Konsole zu gewähren.
[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üssel-Verschlüsselungsschlüssel (und welcher davon neue private Schlüssel verpackt), den SRS-Schlüssel, der das Relaying an beliebige Adressen autorisiert, und den Schlüssel für Herkunftsnachweise, gegen den ein zurückkehrender Bounce oder eine Zahlungsaufforderung geprüft wird. Könnte die Datenbank einen dieser Schlüssel ersetzen, könnte ein Angreifer dafür sorgen, dass der nächste verpackte Schlüssel einer ist, den er öffnen kann, oder dass ein gefälschter Bounce weitergeleitet oder bezahlt wird. Der Rest jedes Abschnitts bleibt zusammen mit dem Schlüssel in der Datei.
[pepsi-wizard]Aus einem dritten Grund hier aufgeführt: Es ist überhaupt keine Konfiguration, sondern die Aufzeichnung des Setup-Assistenten über die Antworten, die er bekommen hat. Das Browser-Interview legt diese Antworten als Entwurfs-Datensätze in eben dieser Tabelle ab. Entwürfe sind für jeden Leser unsichtbar, aber ein von Hand geschriebener Datensatz, der kein Entwurf ist, landete sonst in der effektiven Konfiguration jedes Prozesses. Zur Laufzeit liest niemand den Abschnitt, daher lautet die sichere Antwort, dass ihn auch die Datenbank nie liefert.
Die Trennlinie lautet „vor einer Datenbankverbindung nötig, eine Sicherheitsgrenze oder die Heimat eines serverseitigen Geheimnisses“. Listener stehen bewusst auf der zweiten Seite davon: Könnte die Datenbank einen lauschenden Socket verschieben oder sein TLS-Material ändern, würde eine Datenbankkompromittierung zu einer Kompromittierung der eigenen Ports des Mailservers.
Welche Programme laufen, entscheidet ebenfalls die Datei. Optionen, die eine ausführbare Datei nennen, werden in jedem Abschnitt und auf jeder Ebene abgelehnt: HELPER (was eine Zustell-Stage, die setgid läuft, ausführt), [pepsi-whitelist] SCAN_HELPER, [pepsi] MAILBOX_HELPER und [pepsi-secure-link] PIN_COMMAND. Das PROGRAM einer Stage wird nur als bloßer pepsi-stage-*-Befehl angenommen, den der Dispatcher über seinen PATH findet. Eine Stage kann daher über die Überlagerung weiterhin hinzugefügt, entfernt oder neu verdrahtet werden, aber ein Prinzipal, der sie schreiben darf, kann die Pipeline kein ausführbares Programm seiner Wahl ausführen lassen (Befehlsinjektion und XXE in Verwaltungsoberflächen von Mail-Gateways, Mail-Appliances speichern Geheimnisse für alle lesbar oder ungeschützt).
Wichtig
Einen Submission-Port hinzuzufügen ist eine Texteditor-und-Neustart-Operation. Ebenso das Ändern des TLS-Zertifikats eines Listeners, der Datenbankverbindung oder der [pepsi]-Kryptorichtlinie. Keine administrative Oberfläche kann diese ändern, und keine sollte den Eindruck erwecken, sie könne es.
Zugangsdaten werden nie in der Datenbank gespeichert, gleich in welchem Abschnitt sie stehen. Eine Option, deren Name sie als Zugangsdatum kennzeichnet, wird von pepsi-config set und von der Administrations-API abgelehnt und ignoriert, falls dennoch ein Datensatz dafür existiert. Ein solcher Name hat unter seinen durch Unterstriche getrennten Teilen PASS, PASSWORD, PASSPHRASE, SECRET, TOKEN, CREDENTIAL(S), CLIENT_ID, PEPPER oder SYSTEM_ID (API_PASS, KEY_WRAP_SECRET, aber nicht SECRETARY); dieselbe Regel maskiert einen Wert überall, wo eine Konfiguration angezeigt wird. Die Regel erfasst auch die Datei, aus der ein Zugangsdatum gelesen wird, und den Endpunkt, an den es gesendet wird (TOKEN_FILE, TOKEN_ENDPOINT), denn eine Datenbank, die diese ändern kann, kann das Zugangsdatum umleiten. Legen Sie sie in die Datei oder in ein secrets.d-Fragment.
Ebenso wird eine domain:- oder address:-Überschreibung nur für einen [stage-*]-Abschnitt angenommen (siehe oben: nichts anderes liest diese Schichten) und für jeden anderen Abschnitt abgelehnt, statt dort gespeichert zu werden, wo nichts sie lesen wird.
Zwei weitere Optionen stehen aus einem schlichteren Grund nur in der Datei: Sie werden gelesen, um die Datenbank selbst zu öffnen, bevor es eine Überlagerung geben kann. Es sind [pepsi-ingress] DB_POOL_SIZE und [pepsi-dispatch] DB_POOL_SIZE.
7.6.4. Hot Reload, und was einen Neustart braucht¶
Jeder Schreibvorgang in die Tabelle löst eine config_changed-Benachrichtigung aus. Was dann geschieht, hängt vom Abschnitt ab:
[stage-*]— ohne Neustart angewandt.Wenn die Benachrichtigung eintrifft, tut
pepsi-dispatchzwei Dinge. Es baut seine eigene Sicht auf die Pipeline aus dem Overlay neu auf: welche Stages existieren und jeweils derenPROGRAM,PARALLELISM,MAX_MESSAGESundQUEUE_LIMIT. Und es setzt seine Stage-Worker außer Dienst, sodass ihre Nachfolger die neuen Werte lesen. Dabei wird keine Nachricht unterbrochen: Ein ausgemusterter Worker bekommt keine weitere Arbeit und beendet sich, sobald seine aktuellen Nachrichten erledigt sind. Die nächste Nachricht wird mit der neuen Konfiguration geroutet und ausgeführt; deshalb wirken das Hinzufügen, Bearbeiten und Entfernen einer Stage im laufenden Betrieb. Es gibt eine harte Kante: Wenn sich der neu geladene Graph nicht parsen lässt, fährt der Dispatcher herunter und beendet sich mitEX_CONFIG, statt nach einer Pipeline zu routen, die seine Worker nicht mehr teilen. Die mitgelieferte Unit startet ihn neu (Restart=always, mit einem Backoff bis auf einmal pro Minute), sodass er von selbst weiterläuft, sobald die Konfiguration korrigiert ist. Ein Overlay, das sich nicht lesen lässt (ein Datenbankfehler), ist etwas anderes: Der Dispatcher behält seinen aktuellen Stage-Graphen und versucht das Neuladen erneut, statt jede nur in der Datenbank definierte Stage fallen zu lassen.- Alles andere — braucht einen Neustart der Komponente, die es liest.
[pepsi-ingress],[pepsi-srs],[pepsi-tlsrpt]und die übrigen werden beim Start einmal gelesen. Der Wert wird gespeichert und wirkt, wenn dieses Programm das nächste Mal gestartet wird.pepsi-configsagt nach jedem Schreibvorgang, was zutrifft.
Eine Änderung an der Datei der Konfiguration nimmt für die Pipeline denselben Weg: pepsi-dispatch prüft alle zwei Sekunden Änderungszeit und Größe der Datei. Ändern sie sich, liest es die Datei neu ein, baut seine Stage-Tabelle neu auf und setzt seine Worker zur Ruhe, sodass eine dort geänderte Sicherheitseinstellung für die Nachrichten gilt, die wenige Sekunden später ausgegeben werden (Clients senden Mail stillschweigend unverschlüsselt). Eine Datei, die sich nicht parsen lässt, ändert nichts: Die laufende Konfiguration bleibt erhalten, und der Fehler wird protokolliert. Die eigenen Optionen von [pepsi-dispatch] und jeder Abschnitt, den die anderen Dienste lesen, erfordern weiterhin einen Neustart des jeweiligen Dienstes.
Verpasst eine Komponente eine Benachrichtigung, weil ihr Listener getrennt war, liest sie die Überlagerung erneut, sobald der Listener sich wieder verbindet. Eine verlorene Benachrichtigung kostet also Latenz, aber keine Korrektheit.
7.6.5. Geheimnisse bleiben in Dateien¶
Die Datenbank speichert nur die @inline-secret@-Referenz, nie einen Geheimniswert, sodass jedes Fragment unter secrets.d dem einzigen Leser gehört, der es braucht: Eine unprivilegierte Stage kann ihr eigenes Geheimnis lesen und sonst nichts. Verschlüsselte Werte in der Datenbank gäben jedem Leser einen Schlüssel, der alles öffnet.
7.6.6. Die Überlagerung bearbeiten¶
pepsi-config set stage-relay MAX_LIFETIME '48 h'
pepsi-config set --scope domain:example.org stage-relay DELAY_DSN_AFTER '4 h'
pepsi-config unset stage-relay MAX_LIFETIME
pepsi-config list
Jeder Schreibvorgang wird zuerst validiert: Pepsi baut die Konfiguration, die die Änderung ergäbe, und lässt den echten Parser der besitzenden Stage darüber laufen. Das ist dieselbe Prüfung, die pepsi-stage-edit-settings auf eine per E-Mail gesendete Überschreibung anwendet. Ein Wert, der ein Programm am Starten hindern würde, wird mit der eigenen Fehlermeldung dieses Programms abgelehnt, und nichts wird gespeichert.
Sollte dennoch ein fehlerhafter Datensatz in die Tabelle gelangen, hängt das Weitere davon ab, wie fehlerhaft er ist. Ein Datensatz, der sich in der Konfiguration nicht darstellen lässt (ein unbekannter Bereich, ein Nur-Datei-Abschnitt, ein fehlerhafter Name), wird laut protokolliert und übersprungen; eine Überlagerung, die sich gar nicht lesen lässt oder deren zusammengeführter Text sich nicht parsen lässt, wird protokolliert, und das Programm läuft allein mit der Konfigurationsdatei. Ein Wert, der wohlgeformt ist, aber vom Programm selbst abgelehnt wird, etwa eine nicht parsebare Dauer oder ein NEXT_STAGE, das keine Stage benennt, wird nicht übersprungen: Er ist Teil der effektiven Konfiguration, und das Programm scheitert daran genau so, wie es am selben Wert in der Datei scheitern würde. pepsi-setup run prüft auf beides (siehe Validieren).
7.6.7. Woher ein Wert stammt¶
pepsi-config dump --origin
pepsi-config dump --origin --scope address:user@example.org
annotiert jeden effektiven Wert mit der Schicht, die ihn gesetzt hat (file oder der Datenbank-Geltungsbereich), und jeden Abschnitt damit, ob eine Änderung daran live wirkt oder einen Neustart braucht.
7.6.8. Sie sichern¶
Die beiden Hälften werden absichtlich von verschiedenen Werkzeugen gesichert:
die Überschreibungen, die in der Datenbank liegen, werden von
pg_dumpzusammen mit dem übrigen Schema abgedeckt;die Konfigurationsdatei und die
secrets.d-Fragmente können nicht in der Datenbank liegen, weil sie existieren müssen, bevor es eine Datenbankverbindung gibt. Sie werden vonpepsi-config exportabgedeckt, das ein einzelnes passwortverschlüsseltes Archiv schreibt. Dessen Schlüssel wird mit gesalzenem Argon2id (Offline-Raten schwacher Passwort-Hashes, Schlüssel-Passphrasen und abgeleiteter Schlüssel) aus einem Passwort von mindestens 12 Zeichen abgeleitet, das nicht auf der Liste gängiger Passwörter steht.
Das Archiv hält Modus, Eigentümer und Gruppe jeder Datei namentlich fest, und pepsi-config import stellt sie wieder her; es lehnt ab, statt zu raten, wenn ein benanntes Konto auf der Zielmaschine nicht existiert. Ein Archiv, das die Eigentumsverhältnisse verlöre, würde entweder jeden unprivilegierten Leser kaputtmachen oder stillschweigend ein Geheimnis für alle lesbar machen.
7.7. Validieren¶
Validieren Sie eine Konfiguration immer, bevor Sie sich auf sie verlassen:
pepsi-setup -c /etc/pepsi/pepsi.conf check # against live DNS
pepsi-config -c /etc/pepsi/pepsi.conf dump # effective values
pepsi-setup run weigert sich, irgendetwas zu ändern, wenn die Konfiguration ungültig ist: Es prüft, dass [stage-init] existiert, dass jedes NEXT_STAGE/BOUNCE_STAGE auflöst, dass die PROGRAM-Konfiguration jeder Stage geparst werden kann und dass Domains und PUBLIC_IP-Werte wohlgeformt sind.
Es validiert auch die Datenbank-Überlagerung: Eine gespeicherte Überschreibung muss einen echten Bereich benennen, darf keinen Nur-Datei-Abschnitt benennen (der stillschweigend ignoriert würde), darf in einen domain:- oder address:-Bereich nichts außer einem [stage-*]-Abschnitt legen und muss einen existierenden Stage-Abschnitt benennen, entweder in der Datei oder von der Überlagerung selbst definiert, da der Dispatcher eine mit pepsi-config set hinzugefügte Stage ohne Neustart lädt. Die dabei entstehende Konfiguration muss dann weiterhin den eigenen Parser jeder betroffenen Stage zufriedenstellen: die global-Schicht über der Datei und die Kette jedes domain:/address:-Bereichs darüber, wobei jeweils die Parser der Stages laufen, die sie berührt.