61. pepsi-stage-milter¶
Eine Nachricht durch einen sendmail-/Postfix-Milter-Mailfilter schicken.
61.1. Rolle¶
pepsi-stage-milter spricht das Milter-Protokoll, die Mailfilter-Schnittstelle, die sendmail eingeführt und Postfix übernommen hat. Die Filter, die ein Betreiber ohnehin betreibt, funktionieren deshalb hier unverändert: opendkim, rspamd, clamav-milter, spamass-milter, milter-greylist. Für jede Nachricht verbindet sich die Stage mit dem Socket des Filters, spielt die Nachricht als SMTP-Sitzung nach, wendet alle vom Filter verlangten Änderungen an und routet die Nachricht nach ihrem Urteil. Referenz: pepsi-stage-milter(1).
Die Stage ist ein Client und nichts weiter. Der Filter ist ein bestehender langlebiger Daemon mit eigenem Paket, eigener systemd-Unit und eigenem Benutzerkonto, genau wie unter sendmail und Postfix. Pepsi startet ihn nicht und sperrt ihn nicht ein, denn einen Daemon einzusperren ist Aufgabe seiner eigenen Unit, und unter Debian erledigt diese Unit das bereits. Die Stage selbst trägt daher keinerlei Privileg: kein setuid-Bit, kein setgid-Bit, keinen Helper. Dem Filter wird mit dem vertraut, was er bekommt: Er sieht die Nachricht im Klartext (eingehend, nach der Entschlüsselung) und darf ändern, was ALLOW_ACTIONS ihm gewährt (Beteiligte und wie weit jedem vertraut wird).
61.2. Nach der Warteschlange, und was das kostet¶
Warnung
Ein Milter ist als Pre-Queue-Filter konzipiert, und Pepsi führt ihn nach der Warteschlange aus. Das ist die eine Stelle, an der Pepsis Milter-Unterstützung der eines MTA nicht gleichwertig ist.
In einem MTA laufen die Callbacks innerhalb der SMTP-Sitzung, bevor der Server die Nachricht angenommen hat. Deshalb kann ein Milter einem gefälschten Absender mit 550 antworten und überhaupt keinen Bounce erzeugen. Pepsis Pipeline läuft vollständig nach dem Einreihen der Nachricht: Wenn irgendeine Stage einen Datensatz sieht, hat pepsi-ingress bereits 250 gesagt. Ein REJECT hier kostet daher einen Bounce an die Adresse, die der Umschlag nannte, und das ist bei gefälschtem Spam ein unschuldiger Dritter.
Ein von Postfix übernommener Greylisting- oder DNSBL-Milter filtert weiterhin korrekt, aber zum Preis von Backscatter. Richten Sie REJECT_STAGE auf eine pepsi-stage-discard statt auf eine pepsi-stage-bounce, wenn das ins Gewicht fällt. Filter, die nur annotieren — ein Signierer oder ein Bewerter, der einen Header für eine spätere pepsi-stage-if zum Verzweigen hinzufügt —, sind nicht betroffen.
61.3. Funktionen¶
Beide Socket-Familien:
SOCKETnimmt sendmails eigeneS=-Grammatik, die auch Postfix akzeptiert (unix:/path,inet:host:port,inet:port@host,inet6:[addr]:port), sodass ein direkt aus einer der beiden Konfigurationen kopierter Wert unverändert funktioniert.Die Sitzung wird rekonstruiert, nicht erfunden: Die Connect-, Helo- und Mail-Phasen stammen aus dem, was
pepsi-ingressunterstate.originfestgehalten hat: die Peer-Adresse und ihr PTR-Name, derHELO-Name, die TLS-Version und die Chiffre, der Listener (die lokale Adresse, exportiert als{daemon_addr}in der Standard-Connect-Makroliste von Postfixj {daemon_name} {daemon_addr} v _), dieBODY=/SMTPUTF8-Parameter und wie sich die Sitzung authentifiziert hat (die RFC-4954-Makros{auth_type}/{auth_authen}/{auth_author}/{auth_ssf}). Eine lokal injizierte Nachricht (ein Bounce, eine automatische Antwort, einepepsi-sendmail-Submission) wird als Loopback-Sitzung präsentiert, wie sendmail es für lokale Submission tut.Eine Aktions-Positivliste:
ALLOW_ACTIONSentscheidet, welche Änderungen der Filter vornehmen darf. Der Standardwert (addhdrs chgbody chghdrs) erlaubt dem Filter, Header-Felder hinzuzufügen und zu ändern und den Nachrichtentext zu ersetzen; mehr braucht ein Filter nicht, der nur den Inhalt einer Nachricht ändert. Den Umschlag umzuschreiben (Empfänger mitaddrcpt/delrcpthinzuzufügen oder zu löschen, den Absender mitchgfromzu ändern) undquarantinemüssen ausdrücklich gewährt werden.allundnonesind Kurzschreibweisen, und ein unbekannter Name ist ein Fehler statt eines stillen Leerlaufs. Da der Filter in keiner Sandbox läuft, ist diese Liste das einzige Mittel, um zu begrenzen, was ein fehlerhafter Filter ändern kann.Eine unerfüllte Anforderung wird gemeldet, nicht ignoriert: Ein Filter, der eine Aktion braucht, die nicht angeboten wurde, wird im Journal genannt, und die Nachricht nimmt den
ON_FAILURE-Pfad. Postfix verwirft eine solche Anfrage stillschweigend, und so entdeckt ein Betreiber sechs Monate später, dass ein signierender Milter nie etwas signiert hat.Die Fehlersemantik von Postfix:
ON_FAILUREspiegeltmilter_default_actionund hat denselben Standardwert (tempfail), ebenso die drei Timeouts (30 s / 30 s / 300 s), sodass ein ausgefallener Filter Mail verzögert, statt sie zu verlieren oder ungefiltert durchzulassen.Ablehnung je Empfänger fächert auf: Ein Empfänger, den der Filter in der
RCPT-Phase abweist, wird auf einen eigenen Geschwisterdatensatz beiREJECT_STAGEabgezogen, und der Rest der Nachricht läuft weiter, wobeistate.dsn.rcptauf jedem entstehenden Datensatz im Gleichschritt mitrcpt_tozerteilt wird. Ein Empfänger, den der Filter nur aufschiebt (4xx), wird auf einen Datensatz abgezogen, der an der Milter-Stage wartet und später erneut gefiltert wird, bisMAX_LIFETIME; danach wird er gebounct, nie abgewiesen.Header-Injektion ist nicht möglich: Ein Header-Wert, der einen Zeilenumbruch enthält, wird neu gefaltet, statt zu einem zweiten Feld werden zu dürfen, und ein ungültiger Feldname wird rundweg abgelehnt.
61.4. Platzierung¶
Eingehend platzieren Sie sie nach pepsi-stage-decrypt, damit der Filter Klartext sieht, und vor den Schranken für weiße Liste und Spam, damit diese auf das verzweigen können, was er markiert hat. Ausgehend platzieren Sie sie unmittelbar vor pepsi-stage-dkim-sign, damit unsere eigene Signatur seine Änderungen abdeckt.
pepsi-setup --wizard erledigt das für Sie für die Filter, die es finden kann. Es durchsucht den Host nach sieben bekannten Daemons, bestätigt jeden durch eine vollständig durchgeführte echte Optionsaushandlung mit seinem Socket und gibt eine Stage je angenommenem Filter aus. Es ordnet die Stages danach, was jeder Filter tut, setzt ALLOW_ACTIONS auf genau das, was dieser Filter während der Aushandlung verlangt hat, und routet Ablehnungen zu einer erzeugten Discard-Stage, statt sie zu bouncen. Filter, deren Aufgabe Pepsi bereits erledigt (opendkim, openarc, opendmarc, SPF-Daemons, postsrsd), werden benannt und übersprungen. Siehe den Suchlauf in pepsi-setup(1).
Ein Filter, der den Nachrichtentext umschreibt, bricht zwangsläufig den DKIM-Body-Hash des Urhebers und das ARC-AMS dieser Installation; pepsi-stage-vacation hat für seine Betreffmarkierung denselben unvermeidlichen Vorbehalt. Auf einem Zweig mit lokaler Zustellung ist das harmlos; auf einem Zweig, der die Nachricht weiterleitet, ziehen Sie einen Filter vor, der nur Header hinzufügt.
61.5. Urteile¶
|
|
|
|
|
|
|
pausiert zur Wiederholung, dann |
|
gelöscht, stillschweigend |
|
|
Ein Tempfail, der MAX_LIFETIME überdauert, ist kein Urteil über die Nachricht, daher nimmt er nie REJECT_STAGE (das Mail stillschweigend verwerfen kann): Er geht an BOUNCE_STAGE oder bleibt, wenn es keines gibt, für pepsi-failure-bouncer fehlgeschlagen.
Eine Ablehnung oder ein abgelaufener Tempfail einer Nachricht, deren Inhalt aus einem S/MIME-EnvelopedData (AES-CBC) stammt oder sich daraus nicht öffnen ließ, löscht die Nachricht stattdessen (Telemetrie decrypt-dropped): Das Urteil des Filters hängt vom Padding eines Chiffrats ab, das der Absender verändert haben kann, und ein Bounce würde diese Frage beantworten (CBC-Padding- und Format-Orakel gegen nicht authentifiziertes S/MIME). Ein bei RCPT abgelehnter Empfänger ist nicht betroffen.
Eine Quarantäne hält pepsi-stage-quarantine: Richten Sie QUARANTINE_STAGE auf eine solche Stage, und die Nachricht wartet dort, bis ein Betreiber sie freigibt oder löscht (pepsi-queue quarantine). Auf dem Weg dorthin hält die Stage state.quarantine mit dem Grund des Filters und by = milter:<MILTER_NAME> fest.
ACCEPT_STAGE existiert, weil Postfix eine Liste von Miltern anwendet, wo Akzeptieren bedeutet „die übrigen überspringen“. Ein Filter je Stage kennt so etwas nicht, sodass ohne die Option Akzeptieren und Fortfahren dasselbe wären; richten Sie sie hinter den Rest einer Kette, um die Unterscheidung wiederherzustellen.
61.6. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-milter, SOCKET (erforderlich), NEXT_STAGE (erforderlich — ``CONTINUE`` ist das Standardurteil und geht dorthin, und ``ACCEPT_STAGE`` deckt nur ``ACCEPT`` ab), die Routing-Ziele ACCEPT_STAGE/REJECT_STAGE/QUARANTINE_STAGE, BOUNCE_STAGE (worauf REJECT_STAGE zurückfällt), ON_FAILURE (standardmäßig tempfail, sonst accept, reject oder discard), ALLOW_ACTIONS, MILTER_NAME (das Makro {daemon_name}; standardmäßig das Etikett der Stage selbst), PROTOCOL_VERSION (2 bis 6, Standardwert 6), die drei Timeouts CONNECT_TIMEOUT/COMMAND_TIMEOUT/CONTENT_TIMEOUT, die gemeinsamen Wiederholungsoptionen (RETRY_INITIAL/RETRY_MAX_INTERVAL/RETRY_FACTOR/ MAX_LIFETIME; es gibt kein DELAY_DSN_AFTER, da ein Aufschub durch den Filter keine „delayed“-DSN erzeugt) und die sieben MACROS_*-Listen (MACROS_CONNECT, MACROS_HELO, MACROS_MAIL, MACROS_RCPT, MACROS_DATA, MACROS_EOH, MACROS_EOM, die jeweils standardmäßig Postfix‘ eigene Liste verwenden, mit dem Sentinel none, um in dieser Phase nichts zu exportieren; ein leerer Wert gilt als abwesend und wendet den Standardwert erneut an). pepsi-setup verlangt NEXT_STAGE und prüft, dass jedes Routing-Ziel auf eine echte Stage auflöst. Siehe pepsi-stage-milter(1).
61.7. State¶
Eingaben:
state.origin(die festgehaltene Sitzung, dem Filter nachgespielt) undstate.dsn(parallel zu jeder Empfängerumschreibung gehalten).Ausgaben:
state.miltermit dem Urteil, der Protokollversion, der verstrichenen Zeit und den angewandten Änderungen, dazu dem Antwortcode des Filters und dem Quarantänegrund, wo vorhanden. Eine unter Quarantäne gestellte, anQUARANTINE_STAGEgeleitete Nachricht trägt eine frischestate.quarantine-Anfrage (reason,by) für pepsi-stage-quarantine. Eine abgelehnte Nachricht trägt außerdemstate.bounce, mit dem SMTP-Code des Filters, dem erweiterten Status nach RFC 3463 und dem Text in eigenen Feldern. Eine aufgeschobene Nachricht (oder Empfängerkopie) trägtstate.attemptsundstate.last_error; eine abgelehnte ohne Ziel bleibt mitstate.milter_errorfehlgeschlagen liegen.
61.8. Siehe auch¶
pepsi-stage-if, pepsi-stage-discard, pepsi-stage-bounce, pepsi-stage-dkim-sign, Unterstützte Funktionen, pepsi-stage-milter(1).