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 Option WHITELIST_NAME wählt die zu befüllende whitelist_name-Gruppe.

  • Alle Umschlagempfänger: jede Adresse in rcpt_to wird in einem einzigen Round-Trip festgehalten, idempotent (ON CONFLICT (whitelist_name, match_field, whitelist_regex) DO NOTHING); die Datensätze werden mit match_field = from geschrieben.

  • Vollständig verankerte Muster: Jede Adresse wird kleingeschrieben, regex-escapt und in ^/$ eingefasst, sodass der gespeicherte whitelist_regex genau diese Adresse und nichts sonst trifft. Die Prüf-Stage wertet ihn (ohne Beachtung der Groß-/Kleinschreibung, mit dem Operator ~*) gegen die aus dem From:-Header einer Antwort geparste addr-spec aus, nicht gegen den rohen Header-Wert — sodass bob@example.com (Bob) weiterhin den Datensatz für bob@example.com trifft, während bob@example.com.evil und (bob@example.com)x@attacker.test es 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_override in jedem Geltungsbereich oder in einem mit pepsi-settings geschriebenen pepsi.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_required wird aus der Option DKIM_REQUIRED gesetzt (Standardwert yes).

    • dmarc_required wird aus der Option DMARC_REQUIRED gesetzt (Standardwert yes): Die Antwort muss DMARC bestehen, über eine ausgerichtete DKIM-Signatur oder einen ausgerichteten SPF-Pass. dkim_required schließt es ein. Mit DKIM_REQUIRED = no bindet es den Datensatz für einen Korrespondenten, dessen Domain nicht signiert, weiterhin an einen authentifizierten Absender.

    • signature_required wird genau dann auf true gesetzt, wenn der Nachrichten-State encrypted: true enthä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_NAME gesetzt (eine Vorlage, die mit {login}/ beginnt), setzt eine ausgehende Nachricht, die auf die Abonnement-Bestätigungsanfrage einer Liste antwortet, die List-Id dieser Liste im eigenen Namensraum des Absenders auf die Whitelist; pepsi-stage-check-whitelist hält solche Anfragen eingehend in pepsi.list_confirmation fest. Die Antwort muss von der Adresse kommen, an die die Anfrage zugestellt wurde, an die Steueradresse der Anfrage gehen und diese in In-Reply-To: nennen; eine Antwort auf irgendetwas anderes lehrt nichts. Der Datensatz behält dkim_required und dmarc_required, nennt keinen Versiegler und läuft nach LIST_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_to und state.encrypted, das das gespeicherte Flag signature_required setzt, sodass ein unter Verschlüsselung erreichter Korrespondent später am selben Maßstab gemessen wird. pepsi-stage-encrypt setzt state.encrypted weiter 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 state bleibt unberührt; der Nebeneffekt ist ein pepsi.whitelist-Datensatz pro Empfänger und ein gelernter list-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).