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):

spf

Der 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.

ptr

Der 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.net allein beweist nichts; dass example.net den Host als einen der eigenen ausweist, schon.

network

Das 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:

  1. 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 von RECIPIENT_DOMAINS (wenn gesetzt) und ein Empfänger in EXEMPT_RECIPIENTS (postmaster und abuse).

  2. Regeln (allow, deny): Eine Deny-Regel weist den Empfänger mit 550 5.7.1 ab; eine Allow-Regel lässt ihn durch.

  3. 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).

  4. 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 SOCKET und beantwortet die MTAs, die sich verbinden. Als root gestartet, bindet er zuerst den Socket und läuft dann als Konto pepsi-greylist weiter. 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:

ip

die Client-Adresse;

network

ein Netz, das die Client-Adresse enthält (192.0.2.0/24);

domain

die Domain der Client-Identität (Sprosse spf oder ptr) 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;

sender

der Umschlagabsender;

rcpt

der 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, die PASSED_TTL lang 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]
SOCKET

Wo der Daemon lauscht (Standardwert unix:/run/pepsi-greylist/milter.sock). inet:HOST:PORT (oder inet: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_MODE

Der Modus des UNIX-Sockets, oktal (Standardwert 0660).

SOCKET_GROUP

Die 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 macht pepsi-ingress zum Mitglied. Eine Gruppe, der der Daemon nicht angehört, lässt sich nur setzen, wenn er als root gestartet wird.

DELAY

Wie lange ein erster Versuch abgewiesen wird (Standardwert 5 min). Dauern dürfen hier in Tagen und Wochen angegeben werden (35 days).

RETRY_WINDOW

Wie lange nach dem ersten Versuch eine Wiederholung noch durchkommt (Standardwert 48 h). Muss länger als DELAY sein.

PASSED_TTL

Wie lange ein bestandenes Tripel nach seinem letzten Auftreten gespeichert bleibt (Standardwert 35 days).

AUTO_WHITELIST_PASSES

Hat eine Client-Identität so oft bestanden (eine bestandene Wiederholung oder spätere Mail eines bestandenen Tripels), wird sie nicht mehr gegreylistet (Standardwert 5; 0 schaltet die Auto-Whitelist aus).

AUTO_WHITELIST_TTL

Wie lange eine automatisch auf die Whitelist gesetzte Identität nach ihrem letzten Auftreten ausgenommen bleibt (Standardwert 35 days).

IDENTITY

Die Identitätsleiter in Rangfolge (Standardwert spf ptr network). Eine weggelassene Sprosse wird nicht verwendet; network ist immer die letzte.

IPV4_MASK, IPV6_MASK

Die Präfixlängen der Sprosse network (Standardwerte 24 und 64).

DNS_TIMEOUT

Die 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_TTL

Wie lange die Antwort auf „Ist dieser Client einer der Hosts dieser Domain?“ aufbewahrt wird (Standardwert 10 min).

DNS_SERVERS

Die zu befragenden Resolver, wie bei [pepsi] DNS_SERVERS, das gilt, wenn diese Option nicht gesetzt ist.

EXEMPT_RECIPIENTS

Empfänger, die nie gegreylistet werden: Local-Parts (jede Domain, eine Subadresse eingeschlossen) oder ganze Adressen (Standardwert postmaster abuse; none für keine).

RECIPIENT_DOMAINS

Wenn 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_BYPASS

Lä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_NAME

Die Whitelist-Namen (Vorlagen mit {localpart} und {login} wie bei der Whitelist-Stage, wobei LOCAL_DOMAINS, RECIPIENT_DELIMITER und TARGETS aus diesem Abschnitt gelesen werden). Nicht gesetzt, werden die Namen jeder Stage verwendet, die pepsi-stage-check-whitelist ausfü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_SENDERS

Lässt die Absender der Gruppen [pepsi-greylist-senders-*] durch (Standardwert YES).

SPF_BYPASS

Lä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.

REPLY

Die Antwort auf einen ersten Versuch (Standardwert 451 4.7.1 Greylisted, please try again later). Sie muss einzeilig sein, mit einem 4xx-Code und, falls vorhanden, einem erweiterten Statuscode der Klasse 4: Greylisting bittet um eine Wiederholung (RFC 5321 Abschnitt 4.5.4.1).

DB_POOL_SIZE

Datenbankverbindungen, die der Daemon höchstens hält (Standardwert 4).

MAX_CONNECTIONS

Gleichzeitig 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 = accept von 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.

DOMAINS

Ein 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.

NETWORKS

Eine Client-Adresse in einem dieser Netze kommt durch.

ENABLED

Ob 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, debug oder trace. Fehlt das Flag, gilt die globale Option [pepsi] LOG, und ersatzweise info.

-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) schema aus.

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).