95.1.47. pepsi-greylist¶
greylisting milter for pepsi-ingress, Postfix and sendmail
- Handbuchabschnitt:
1
95.1.47.1.1. Name¶
pepsi-greylist - Greylisting-Milter für pepsi-ingress, Postfix und sendmail.
95.1.47.1.2. Übersicht¶
pepsi-greylist [GLOBAL-OPTIONS] serve
pepsi-greylist [GLOBAL-OPTIONS] list [–pending | –passed | –never-retried] [–domain DOMAIN] [–ip ADDRESS] [–rcpt ADDRESS] [–limit N] [–json]
pepsi-greylist [GLOBAL-OPTIONS] allow KIND VALUE [–expires DURATION] [–note TEXT]
pepsi-greylist [GLOBAL-OPTIONS] deny KIND VALUE [–expires DURATION] [–note TEXT]
pepsi-greylist [GLOBAL-OPTIONS] rules [–json]
pepsi-greylist [GLOBAL-OPTIONS] unrule ID
pepsi-greylist [GLOBAL-OPTIONS] prune [–json]
pepsi-greylist [GLOBAL-OPTIONS] stats [–hours N] [–json]
95.1.47.1.3. Beschreibung¶
pepsi-greylist ist ein Milter: ein Filter, den ein MTA zu jedem SMTP-Befehl befragt. Ein MTA, der ihn verwendet (pepsi-ingress(1), Postfix, sendmail), befragt ihn bei jedem RCPT TO einer Sitzung, die sich nicht authentifiziert hat. Der erste Versuch eines Absenders bei einem Empfänger von einem unbekannten Client aus wird mit 451 4.7.1 Greylisted, please try again later beantwortet. Ein Mailserver, der RFC 5321 folgt, stellt die Nachricht in seine Warteschlange und versucht es erneut; eine Wiederholung nach DELAY (5 Minuten) und innerhalb von RETRY_WINDOW (48 Stunden) wird angenommen, ebenso spätere Mail von demselben Client, Absender und Empfänger bis PASSED_TTL (35 Tage) nach dem letzten Auftreten. Software, die jede Nachricht einmal sendet und nie wiederholt, kommt nicht durch.
Der Preis ist eine Verzögerung der ersten Nachricht jedes neuen Korrespondenten. Die unten beschriebenen Umgehungen halten diese Verzögerung von Mail fern, die von Korrespondenten kommt, die ein Benutzer bereits kennt, und von den großen Anbietern.
serve führt den Daemon aus, wie es pepsi-greylist.service tut. Die anderen Befehle untersuchen und steuern ihn. pepsi-greylist-prune.timer führt stündlich prune aus.
95.1.47.1.3.1. Wer der Client ist¶
Große Anbieter senden aus Pools von Hosts, und die Wiederholung einer Nachricht kommt oft von einem anderen Host als der erste Versuch. Deshalb ist das Tripel nicht (Client-Adresse, Absender, Empfänger), sondern (Client-Identität, Absender, Empfänger), und die Identität ergibt sich aus der ersten zutreffenden Sprosse von IDENTITY (Standardwert spf ptr network):
spfDer SPF-Eintrag der Domain des Umschlagabsenders (beim Null-Absender der
HELO-Name) autorisiert den Client: Die Identität ist diese Domain. Jeder Host, den der SPF-Eintrag der Domain nennt, ist dann derselbe Client.ptrDer Reverse-DNS-Name des Clients löst zurück auf die Client-Adresse auf (vorwärtsbestätigt), und die Organisationsdomain dieses Namens, so ermittelt, wie DMARC sie ermittelt (der Baumdurchlauf über DMARC-Einträge nach RFC 9989), autorisiert den Client durch ihren SPF-Eintrag oder führt ihn als einen ihrer MX-Hosts. Die Identität ist diese Organisationsdomain.
mail-7.out.example.netallein beweist nichts; dassexample.netden Host als einen der eigenen ausweist, schon.networkDas Netz des Clients, die Adresse auf
IPV4_MASK(24) bzw.IPV6_MASK(64) Bits maskiert. Diese Sprosse trifft immer zu und ist der letzte Ausweg.
Kommt eine Wiederholung von einem Host, dessen eigene Identität eine andere ist (den ersten Versuch machte ein Host, den die ptr-Sprosse example.net nannte, die Wiederholung kommt von einem Host ohne Reverse-Namen), werden die früheren Tripel desselben Absenders und Empfängers mit dem neuen Client verglichen: Ein spf- oder ptr-Tripel passt, wenn der SPF-Eintrag oder die MX-Hosts seiner Domain den neuen Client einschließen, ein network-Tripel, wenn der neue Client in seinem Netz liegt. Ein Treffer zählt als Wiederholung dieses Tripels. Gespeichert wird nur die Domain; die Prüfung läuft, wenn die Wiederholung eintrifft, und ihr Ergebnis wird DNS_CACHE_TTL lang aufbewahrt.
95.1.47.1.3.2. Die Entscheidung¶
Für jeden Empfänger, in dieser Reihenfolge:
Nie gegreylistet: eine Sitzung, die sich authentifiziert hat (der MTA sendet das Makro
{auth_authen}), ein Client an einem UNIX-Socket oder auf einer Loopback-Adresse, ein Empfänger außerhalb vonRECIPIENT_DOMAINS(wenn gesetzt) und ein Empfänger inEXEMPT_RECIPIENTS(postmasterundabuse).Regeln (allow, deny): Eine Deny-Regel weist den Empfänger mit
550 5.7.1ab; eine Allow-Regel lässt ihn durch.Umgehungen, jede mit eigener Option: Der Absender steht auf der Whitelist des Empfängers (
WHITELIST_BYPASS); der Client gehört zu einem großen Absender (BIG_SENDERS); SPF ist bestanden (SPF_BYPASS, standardmäßig aus); die Client-Identität hat das Greylisting oft genug bestanden (AUTO_WHITELIST_PASSES).Das Tripel, wie oben beschrieben.
Ein Datenbankfehler oder ein DNS-Schritt, der länger als DNS_TIMEOUT dauert, lässt den Empfänger durch: Greylisting ist fail-open (im Fehlerfall durchlassend), protokolliert eine Warnung und zählt einen Fehler. Der Daemon verlangt keinen Nachrichteninhalt und ändert keine Nachricht.
95.1.47.1.4. Befehle¶
- serve
Lauscht auf
SOCKETund beantwortet die MTAs, die sich verbinden. Alsrootgestartet, bindet er zuerst den Socket und läuft dann als Kontopepsi-greylistweiter. SIGTERM beendet ihn, nachdem er seine Zähler geschrieben hat.- list [–pending | –passed | –never-retried] [–domain DOMAIN] [–ip ADDRESS] [–rcpt ADDRESS] [–limit N] [–json]
Zeigt Tripel, die zuletzt gesehenen zuerst (höchstens N, Standardwert 50). –pending: noch nicht bestanden. –passed: bestanden. –never-retried: einmal aufgeschoben und nicht erneut versucht. –domain: die Domain der Client-Identität oder die Domain des Absenders ist DOMAIN oder eine Subdomain davon. –ip: die letzte Client-Adresse liegt in ADDRESS (eine Adresse oder ein Netz), oder die Identität ist ein Netz, das sie enthält. –rcpt: der Empfänger.
- allow KIND VALUE [–expires DURATION] [–note TEXT]
Nie greylisten, was VALUE benennt. KIND ist eines von:
ipdie Client-Adresse;
networkein Netz, das die Client-Adresse enthält (
192.0.2.0/24);domaindie Domain der Client-Identität (Sprosse
spfoderptr) oder die Domain des Umschlagabsenders, jeweils auch als Subdomain von VALUE. Die Domain des Absenders ist nicht authentifiziert: Eine Allow-Regel für eine Domain lässt auch einen Fälscher durch, der diese Domain in den Umschlag schreibt. Für einen Absender ohne SPF-Eintrag ist eine Netz-Regel vorzuziehen;senderder Umschlagabsender;
rcptder Empfänger.
–expires nimmt eine Dauer (
30 days,12 h); ohne sie bleibt die Regel bis unrule bestehen. Wird dieselbe Regel erneut hinzugefügt, wird sie erneuert. Jede Änderung wird im Prüfprotokoll festgehalten.- deny KIND VALUE [–expires DURATION] [–note TEXT]
Weist ab, was VALUE benennt, mit
550 5.7.1. Eine Deny-Regel hat Vorrang vor einer Allow-Regel; keine von beiden gilt für die ausgenommenen Empfänger.- rules [–json]
Zeigt die nicht abgelaufenen Regeln mit ihrer ID.
- unrule ID
Entfernt die Regel ID.
- prune [–json]
Entfernt ausstehende Tripel jenseits von
RETRY_WINDOW(und zählt dabei die einmal aufgeschobenen, nie erneut versuchten), bestandene Tripel, diePASSED_TTLlang nicht gesehen wurden, Client-Einträge, die nicht mehr automatisch auf der Whitelist stehen, abgelaufene Regeln und stündliche Zähler, die älter als 400 Tage sind.- stats [–hours N] [–json]
Ob der Daemon an seinem Socket antwortet, und die Zahlen der letzten N Stunden (Standardwert 24): aufgeschoben, bei Wiederholung bestanden, von einem anderen Host bestanden (nach Sprosse und danach, wie der Host übereinstimmte), nie wiederholt, bekannt, umgangen (nach Grund), ausgenommen, abgewiesen, und die Fehler, die einen Empfänger durchließen.
95.1.47.1.5. Konfiguration¶
[pepsi-greylist]SOCKETWo der Daemon lauscht (Standardwert
unix:/run/pepsi-greylist/milter.sock).inet:HOST:PORT(oderinet:PORT@HOST) lauscht über TCP, für einen MTA auf einem anderen Host; das hat keine eigene Zugriffskontrolle, binden Sie es also an eine Adresse, die nur die MTAs erreichen, oder filtern Sie den Port.SOCKET_MODEDer Modus des UNIX-Sockets, oktal (Standardwert
0660).SOCKET_GROUPDie Gruppe des UNIX-Sockets (Standardwert
pepsi-greylist, die eigene Gruppe des Daemons). Ein Mitglied der Gruppe darf den Daemon befragen; sonst gewährt die Gruppe nichts. Das Paket machtpepsi-ingresszum Mitglied. Eine Gruppe, der der Daemon nicht angehört, lässt sich nur setzen, wenn er als root gestartet wird.DELAYWie lange ein erster Versuch abgewiesen wird (Standardwert
5 min). Dauern dürfen hier in Tagen und Wochen angegeben werden (35 days).RETRY_WINDOWWie lange nach dem ersten Versuch eine Wiederholung noch durchkommt (Standardwert
48 h). Muss länger alsDELAYsein.PASSED_TTLWie lange ein bestandenes Tripel nach seinem letzten Auftreten gespeichert bleibt (Standardwert
35 days).AUTO_WHITELIST_PASSESHat eine Client-Identität so oft bestanden (eine bestandene Wiederholung oder spätere Mail eines bestandenen Tripels), wird sie nicht mehr gegreylistet (Standardwert 5;
0schaltet die Auto-Whitelist aus).AUTO_WHITELIST_TTLWie lange eine automatisch auf die Whitelist gesetzte Identität nach ihrem letzten Auftreten ausgenommen bleibt (Standardwert
35 days).IDENTITYDie Identitätsleiter in Rangfolge (Standardwert
spf ptr network). Eine weggelassene Sprosse wird nicht verwendet;networkist immer die letzte.IPV4_MASK,IPV6_MASKDie Präfixlängen der Sprosse
network(Standardwerte 24 und 64).DNS_TIMEOUTDie Obergrenze für jeden DNS-Schritt einer Entscheidung: eine SPF-Auswertung, eine Reverse-Abfrage mit ihrer Vorwärtsbestätigung, eine MX-Abfrage mit den Adressen der Hosts (Standardwert
2 s). Ein Schritt, der länger dauert, lässt den Empfänger durch.DNS_CACHE_TTLWie lange die Antwort auf „Ist dieser Client einer der Hosts dieser Domain?“ aufbewahrt wird (Standardwert
10 min).DNS_SERVERSDie zu befragenden Resolver, wie bei
[pepsi] DNS_SERVERS, das gilt, wenn diese Option nicht gesetzt ist.EXEMPT_RECIPIENTSEmpfänger, die nie gegreylistet werden: Local-Parts (jede Domain, eine Subadresse eingeschlossen) oder ganze Adressen (Standardwert
postmaster abuse;nonefür keine).RECIPIENT_DOMAINSWenn gesetzt, wird nur Mail an diese Empfängerdomains gegreylistet; Mail an jede andere Domain kommt durch. Nicht gesetzt (Standard), wird jeder Empfänger gegreylistet.
WHITELIST_BYPASSLässt einen Absender durch, der auf einer der Whitelists des Empfängers steht (Standardwert
YES): derselbe Abgleich, den pepsi-stage-check-whitelist(1) vornimmt, gegen den Umschlagabsender. Ein Eintrag, der DKIM oder DMARC verlangt, zählt, wenn SPF für die Domain des Absenders besteht. Welche Whitelists:WHITELIST_NAME.WHITELIST_NAMEDie Whitelist-Namen (Vorlagen mit
{localpart}und{login}wie bei der Whitelist-Stage, wobeiLOCAL_DOMAINS,RECIPIENT_DELIMITERundTARGETSaus diesem Abschnitt gelesen werden). Nicht gesetzt, werden die Namen jeder Stage verwendet, diepepsi-stage-check-whitelistausführt, sodass ein Absender, den ein Benutzer auf die Whitelist gesetzt hat, nie verzögert wird. Allow this sender in der Konsole (pepsi-httpd(1),/ui/deferred) schreibt in den ersten dieser Namen, der im eigenen Namensraum des Benutzers liegt (<login>/…), und wird nicht angeboten, wenn es keinen gibt.BIG_SENDERSLässt die Absender der Gruppen
[pepsi-greylist-senders-*]durch (StandardwertYES).SPF_BYPASSLässt jeden Client durch, für den SPF besteht (Standardwert
NO). Ausgeschaltet wählt ein SPF-Pass nur die Identität; eingeschaltet ist er eine vollständige Umgehung, und jeder Absender, dessen Domain SPF veröffentlicht, wird nie verzögert.REPLYDie Antwort auf einen ersten Versuch (Standardwert
451 4.7.1 Greylisted, please try again later). Sie muss einzeilig sein, mit einem4xx-Code und, falls vorhanden, einem erweiterten Statuscode der Klasse 4: Greylisting bittet um eine Wiederholung (RFC 5321 Abschnitt 4.5.4.1).DB_POOL_SIZEDatenbankverbindungen, die der Daemon höchstens hält (Standardwert 4).
MAX_CONNECTIONSGleichzeitig bediente MTA-Verbindungen (Standardwert 256). Eine MTA-Verbindung darüber hinaus wird geschlossen, was der MTA als Milter-Fehler behandelt; mit dem Standardwert
ON_FAILURE = acceptvon pepsi-ingress(1) wird die Mail angenommen.
[pepsi-greylist-senders-NAME], einer je Gruppe von Absendern, die nie gegreylistet wird. NAME besteht aus Kleinbuchstaben, Ziffern und -. Die Gruppen google, microsoft, yahoo, apple und transactional (Amazon SES, SendGrid, Mailgun, Mailchimp, Postmark, SparkPost) werden in ${DATADIR}/config.d/greylist.conf mitgeliefert; ein gleichnamiger Abschnitt in pepsi.conf ändert sie Option für Option.
DOMAINSEin Client, dessen Identitätsdomain oder vorwärtsbestätigter PTR-Name einer dieser Namen oder eine Subdomain davon ist, kommt durch. Die Domain des Umschlagabsenders allein passt nie.
NETWORKSEine Client-Adresse in einem dieser Netze kommt durch.
ENABLEDOb die Gruppe gilt (Standardwert
YES).
95.1.47.1.6. Verwendung aus einem MTA¶
Aus pepsi-ingress(1), in pepsi.conf(5):
[pepsi-ingress-milter-greylist]
SOCKET = unix:/run/pepsi-greylist/milter.sock
[pepsi-ingress]
MILTERS = greylist
Aus Postfix, in main.cf:
smtpd_milters = unix:/run/pepsi-greylist/milter.sock
milter_default_action = accept
Postfix‘ smtpd läuft als postfix und muss in der Gruppe des Sockets sein:
adduser postfix pepsi-greylist
systemctl restart postfix
Unter Debian läuft smtpd in einem Chroot in /var/spool/postfix, wo es /run/pepsi-greylist nicht gibt. Lauschen Sie entweder über TCP (SOCKET = inet:127.0.0.1:10031 hier, smtpd_milters = inet:127.0.0.1:10031 dort), oder legen Sie den Socket in das Chroot (SOCKET = unix:/var/spool/postfix/pepsi-greylist/milter.sock und smtpd_milters = unix:/pepsi-greylist/milter.sock) und erlauben Sie der Unit mit einem Drop-in, dorthin zu schreiben:
# systemctl edit pepsi-greylist.service
[Service]
ReadWritePaths=/var/spool/postfix/pepsi-greylist
Postfix sendet das Makro {auth_authen} standardmäßig mit MAIL FROM, was seine authentifizierten Einlieferungen ausnimmt. Führen Sie den Milter nicht in non_smtpd_milters auf: Lokal eingelieferte Mail wird ohnehin nie gegreylistet.
95.1.47.1.7. Der Dienst¶
pepsi-greylist.service führt den Daemon als pepsi-greylist aus, mit dem Socket-Verzeichnis /run/pepsi-greylist (RuntimeDirectory=). Er ist nicht Teil von pepsi.target: Greylisting ist eine Wahl, und der Assistent von pepsi-setup(1) aktiviert die Unit, wenn sie getroffen wird. Von Hand:
systemctl enable --now pepsi-greylist.service
pepsi-greylist-prune.timer ist Teil von pepsi.target; auf einem Host, der nicht greylistet, findet er nichts zu bereinigen.
Die Datenbankrolle pepsi-greylist erreicht die Tabellen greylist_triplet, greylist_client, greylist_rule (zum Lesen und Bereinigen) und greylist_stats, liest whitelist und fügt an event_log an. Regeln werden über die Funktionen greylist_rule_add und greylist_rule_remove hinzugefügt und entfernt, die den Wert normalisieren; sie sind auch der einzige Weg, auf dem pepsi-httpd(1) eine Regel ändern darf. /ui/greylist in der Konsole und /api/v1/greylist in der API zeigen die Zähler, die Tripel und die Regeln und ändern die Regeln mit origin = console.
95.1.47.1.8. Ausführung als root¶
Als root gestartet, läuft die Befehlszeile als Konto pepsi-greylist weiter, bevor sie sich mit der Datenbank verbindet, und serve bindet zuvor seinen Socket. stats fragt den Socket vor dem Wechsel ab, damit root einen Socket prüfen kann, dessen Gruppe root nicht angehört.
95.1.47.1.9. Globale Optionen¶
Diese globalen Optionen stehen vor dem Unterbefehl (ein nachgestelltes Flag wird abgelehnt).
- -c FILE, –config FILE
Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen.
- -L LOGLEVEL, –log LOGLEVEL
Setzt die Log-Ausführlichkeit. LOGLEVEL ist eines von
error,warn,info,debugodertrace. Fehlt das Flag, gilt die globale Option[pepsi] LOG, und ersatzweiseinfo.- -v, –verbose
Zeigt Log-Meldungen aus allen Quellen, einschließlich Drittanbieter-Bibliotheken.
- -h, –help
Gibt eine Verwendungsübersicht aus und beendet sich.
- -V, –version
Gibt die Version aus und beendet sich.
95.1.47.1.10. Exit-Status¶
- 0
Erfolgreicher Abschluss.
- 1
Ein Fehler ist aufgetreten: ein fehlerhafter Abschnitt, ein abgelehnter Regelwert, eine unbekannte Regel-ID, eine fehlgeschlagene Datenbankverbindung.
- 78
Das Datenbankschema passt nicht zu diesem Build; führen Sie zuerst pepsi-setup(1)
schemaaus.
95.1.47.1.11. Beispiele¶
Welche Erstkontakte von example.net nie wiederholt wurden:
pepsi-greylist -c /etc/pepsi/pepsi.conf list --never-retried --domain example.net
Mail aus dem Netz eines Partners ein Jahr lang nie verzögern:
pepsi-greylist -c /etc/pepsi/pepsi.conf allow network 198.51.100.0/24 \
--expires '1 year' --note 'partner relay'
Nur die Mail an eine Domain eines geteilten Hosts greylisten, in pepsi.conf(5):
[pepsi-greylist]
RECIPIENT_DOMAINS = example.org
Die Mail der Transaktionsabsender doch greylisten:
[pepsi-greylist-senders-transactional]
ENABLED = NO
95.1.47.1.12. Siehe auch¶
pepsi-ingress(1), pepsi-stage-check-whitelist(1), pepsi-status(1), pepsi-httpd(1), pepsi-setup(1), pepsi.conf(5).