51. pepsi-stage-auto-whitelist¶
Hält die Empfänger ausgehender Mail fest, damit sie immer antworten können.
51.1. Rolle¶
pepsi-stage-auto-whitelist ist das schreibseitige Gegenstück zu pepsi-stage-check-whitelist. Während eine ausgehende Nachricht durchläuft, trägt es jeden Umschlagempfänger (rcpt_to) in eine benannte weiße Liste ein, sodass die Prüf-Stage den From:-Header dieser Person erkennt und ihre Antwort ohne Zahlung durchlässt, wenn sie später antwortet. Platzieren Sie es auf dem ausgehenden Pfad (z. B. vor einer Relay-Stage). Es schreibt nur Datensätze der weißen Liste und schaltet weiter — es verändert die Nachricht nie, verwirft sie nicht, erzeugt keinen Bounce und pausiert sie nicht. Referenz: pepsi-stage-auto-whitelist(1).
51.2. Funktionen¶
Gemeinsame Tabelle der weißen Liste: schreibt dieselbe
pepsi.whitelist-Tabelle, die die Prüf-Stage liest, sodass kein eigenes Schema nötig ist; die OptionWHITELIST_NAMEwählt die zu befüllendewhitelist_name-Gruppe.Alle Umschlagempfänger: jede Adresse in
rcpt_towird in einem einzigen Round-Trip festgehalten, idempotent (ON CONFLICT (whitelist_name, match_field, whitelist_regex) DO NOTHING); die Datensätze werden mitmatch_field = fromgeschrieben.Vollständig verankerte Muster: Jede Adresse wird kleingeschrieben, regex-escapt und in
^/$eingefasst, sodass der gespeichertewhitelist_regexgenau diese Adresse und nichts sonst trifft. Die Prüf-Stage wertet ihn (ohne Beachtung der Groß-/Kleinschreibung, mit dem Operator~*) gegen die aus demFrom:-Header einer Antwort geparste addr-spec aus, nicht gegen den rohen Header-Wert — sodassbob@example.com (Bob)weiterhin den Datensatz fürbob@example.comtrifft, währendbob@example.com.evilund(bob@example.com)x@attacker.testes nicht tun. Die Verankerung ist tragend: Eine Grenz-Zeichenklasse, die die Zeichen aufzählt, die eine Adresse enthalten darf, würde es einem Angreifer erlauben, ein Zeichen außerhalb davon zu finden und es beiderseits einer Whitelist-Adresse in einen eigenen Local Part zu setzen.Wessen Whitelist: Auf dem ausgehenden Pfad werden die adressbezogenen Ebenen für den Envelope-Absender nachgeschlagen. Der Betreiber darf jede beliebige Whitelist benennen, auch eine von allen lokalen Benutzern geteilte Liste: in der INI-Datei, in
pepsi.config_overridein jedem Geltungsbereich oder in einem mit pepsi-settings geschriebenenpepsi.settings-Datensatz. Ein Kontoinhaber, der die Stage per Mail bearbeiten darf (pepsi-stage-edit-settings), darf nur eine Liste in seinem eigenen Namensraum<login>/...wählen oder die des Betreibers beibehalten; alles andere würde ihm erlauben, eine geteilte oder fremde Liste mit Adressen seiner Wahl zu füllen.Bedingungen pro Datensatz:
dkim_requiredwird aus der Option DKIM_REQUIRED gesetzt (Standardwert yes).dmarc_requiredwird aus der Option DMARC_REQUIRED gesetzt (Standardwert yes): Die Antwort muss DMARC bestehen, über eine ausgerichtete DKIM-Signatur oder einen ausgerichteten SPF-Pass.dkim_requiredschließt es ein. MitDKIM_REQUIRED = nobindet es den Datensatz für einen Korrespondenten, dessen Domain nicht signiert, weiterhin an einen authentifizierten Absender.signature_requiredwird genau dann auf true gesetzt, wenn der Nachrichten-Stateencrypted: trueenthält — was pepsi-stage-encrypt setzt, wenn die Kopie eines Empfängers tatsächlich verschlüsselt wurde. Ein unter Verschlüsselung erreichter Korrespondent wird damit beim Antworten am selben Maßstab gemessen. Das funktioniert nur, wenn die Stage nach der Encrypt-Stage steht; sie ändert keinen Inhalt, darf also zwischen Encrypt und pepsi-stage-dkim-sign stehen, wohin der Einrichtungsassistent sie setzt.
Aus Bestätigungsantworten gelernte Mailinglisten: Ist
LIST_WHITELIST_NAMEgesetzt (eine Vorlage, die mit{login}/beginnt), setzt eine ausgehende Nachricht, die auf die Abonnement-Bestätigungsanfrage einer Liste antwortet, dieList-Iddieser Liste im eigenen Namensraum des Absenders auf die Whitelist; pepsi-stage-check-whitelist hält solche Anfragen eingehend inpepsi.list_confirmationfest. Die Antwort muss von der Adresse kommen, an die die Anfrage zugestellt wurde, an die Steueradresse der Anfrage gehen und diese inIn-Reply-To:nennen; eine Antwort auf irgendetwas anderes lehrt nichts. Der Datensatz behältdkim_requiredunddmarc_required, nennt keinen Versiegler und läuft nachLIST_MAX_IDLE_DAYS(180) ohne passenden Beitrag ab, da das Verlassen einer Liste kein Signal sendet.Fail-open: Eine fehlschlagende Aufzeichnung (ein Datenbankfehler, eine fehlende Berechtigung) wird protokolliert, und die Nachricht schaltet trotzdem weiter; die Whitelist ist eine Annehmlichkeit für die Antwort, kein Grund, ausgehende Mail zurückzuhalten.
51.3. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-auto-whitelist, WHITELIST_NAME (erforderlich — die eine zu befüllende whitelist_name-Gruppe, ein wörtlicher Name: Platzhalter werden nicht expandiert und abgelehnt), DKIM_REQUIRED und DMARC_REQUIRED (boolesch, Standardwert yes), LIST_WHITELIST_NAME (ungesetzt: keine Listen werden gelernt), LIST_MAX_IDLE_DAYS (Standardwert 180), die Lokalitätsoptionen, die {login} expandieren, und NEXT_STAGE (erforderlich — die Stage hält die Empfänger fest und reicht die Nachricht immer weiter). Weder die Header noch der Rumpf werden geladen, außer dem Header-Block einer Nachricht, die der Umschlag bereits als Bestätigungsantwort ausweist. Siehe pepsi-stage-auto-whitelist(1).
51.4. State¶
Eingaben: die Umschlagempfänger aus der Spalte
rcpt_toundstate.encrypted, das das gespeicherte Flagsignature_requiredsetzt, sodass ein unter Verschlüsselung erreichter Korrespondent später am selben Maßstab gemessen wird. pepsi-stage-encrypt setztstate.encryptedweiter vorn auf demselben ausgehenden Pfad, wenn die ausgehende Nachricht tatsächlich an einen Empfängerschlüssel verschlüsselt wurde.Ausgaben: keine an der Nachricht — ihr
statebleibt unberührt; der Nebeneffekt ist einpepsi.whitelist-Datensatz pro Empfänger und ein gelernterlist-id-Datensatz pro Liste, deren Bestätigungsanfrage die Nachricht beantwortet.
51.5. Siehe auch¶
pepsi-stage-check-whitelist, pepsi-stage-anti-spam, pepsi-stage-arc, Unterstützte Funktionen, pepsi-stage-auto-whitelist(1). Sicherheit: was die eigene Überschreibung eines Besitzers benennen darf (Adressbezogene Einstellungen sind eine Vertrauensgrenze) und die gefälschte Mail, die die Datensätze der Stage nicht zulassen dürfen (Ein entfernter Absender).