95.1.47. pepsi-greylist

greylisting milter for pepsi-ingress, Postfix and sendmail

Section du manuel:

1

95.1.47.1.1. Nom

pepsi-greylist - milter de greylisting pour pepsi-ingress, Postfix et sendmail.

95.1.47.1.2. Synopsis

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

pepsi-greylist est un milter : un filtre qu’un MTA consulte sur chaque commande SMTP. Un MTA qui l’utilise (pepsi-ingress(1), Postfix, sendmail) le consulte à chaque RCPT TO d’une session qui ne s’est pas authentifiée. La première tentative d’un expéditeur auprès d’un destinataire depuis un client inconnu reçoit la réponse 451 4.7.1 Greylisted, please try again later. Un serveur de messagerie qui suit la RFC 5321 met le message en file d’attente et réessaie ; un réessai après DELAY (5 minutes) et dans les limites de RETRY_WINDOW (48 heures) est accepté, de même que le courrier ultérieur du même client, du même expéditeur et pour le même destinataire pendant PASSED_TTL (35 jours) après sa dernière apparition. Un logiciel qui envoie chaque message une seule fois sans jamais réessayer ne passe pas.

Le prix à payer est un délai sur le premier message de chaque nouveau correspondant. Les contournements décrits ci-dessous épargnent ce délai au courrier des correspondants qu’un utilisateur connaît déjà et à celui des grands fournisseurs.

serve exécute le démon, comme le fait pepsi-greylist.service. Les autres commandes l’inspectent et le pilotent. pepsi-greylist-prune.timer exécute prune toutes les heures.

95.1.47.1.3.1. Qui est le client

Les grands fournisseurs envoient depuis des pools d’hôtes, et le réessai d’un message vient souvent d’un autre hôte que la première tentative. Le triplet n’est donc pas (adresse du client, expéditeur, destinataire) mais (identité du client, expéditeur, destinataire), et l’identité est donnée par le premier échelon de IDENTITY qui s’applique (par défaut spf ptr network) :

spf

L’enregistrement SPF du domaine de l’expéditeur d’enveloppe (le nom HELO pour l’expéditeur nul) autorise le client : l’identité est ce domaine. Tout hôte que nomme l’enregistrement SPF du domaine est alors le même client.

ptr

Le nom DNS inverse du client se résout de nouveau vers l’adresse du client (confirmé en sens direct), et le domaine organisationnel de ce nom, trouvé comme DMARC le trouve (le parcours de l’arbre des enregistrements DMARC de la RFC 9989), autorise le client par son enregistrement SPF ou le compte parmi ses hôtes MX. L’identité est ce domaine organisationnel. mail-7.out.example.net seul ne prouve rien ; example.net déclarant que l’hôte est l’un des siens, si.

network

Le réseau du client, l’adresse masquée à IPV4_MASK (24) ou IPV6_MASK (64) bits. Cet échelon s’applique toujours et constitue le dernier recours.

Lorsqu’un réessai vient d’un hôte dont l’identité propre est différente (la première tentative a été faite par un hôte que l’échelon ptr a nommé example.net, le réessai vient d’un hôte sans nom inverse), les triplets antérieurs du même expéditeur et du même destinataire sont comparés au nouveau client : un triplet spf ou ptr correspond lorsque l’enregistrement SPF ou les hôtes MX de son domaine incluent le nouveau client, un triplet network lorsque le nouveau client se trouve dans son réseau. Une correspondance compte comme réessai de ce triplet. Seul le domaine est stocké ; la vérification a lieu à l’arrivée du réessai, et sa réponse est conservée pendant DNS_CACHE_TTL.

95.1.47.1.3.2. La décision

Pour chaque destinataire, dans cet ordre :

  1. Jamais greylistés : une session qui s’est authentifiée (le MTA envoie la macro {auth_authen}), un client sur une socket UNIX ou une adresse de boucle locale, un destinataire hors de RECIPIENT_DOMAINS (lorsque l’option est définie) et un destinataire figurant dans EXEMPT_RECIPIENTS (postmaster et abuse).

  2. Règles (allow, deny) : une règle deny refuse le destinataire avec 550 5.7.1 ; une règle allow le laisse passer.

  3. Contournements, chacun avec sa propre option : l’expéditeur figure sur la whitelist du destinataire (WHITELIST_BYPASS) ; le client appartient à un gros expéditeur (BIG_SENDERS) ; SPF a réussi (SPF_BYPASS, désactivé par défaut) ; l’identité du client a franchi le greylisting assez souvent (AUTO_WHITELIST_PASSES).

  4. Le triplet, comme décrit ci-dessus.

Une erreur de base de données, ou une étape DNS qui dure plus longtemps que DNS_TIMEOUT, laisse passer le destinataire : le greylisting est fail-open (il laisse passer en cas d’erreur), journalise un avertissement et compte une erreur. Le démon ne demande aucun contenu de message et ne modifie aucun message.

95.1.47.1.4. Commandes

serve

Écoute sur SOCKET et répond aux MTA qui s’y connectent. Lancé en tant que root, il lie d’abord la socket puis continue sous le compte pepsi-greylist. SIGTERM l’arrête après qu’il a écrit ses compteurs.

list [–pending | –passed | –never-retried] [–domain DOMAIN] [–ip ADDRESS] [–rcpt ADDRESS] [–limit N] [–json]

Affiche les triplets, les plus récemment vus en premier (au plus N, 50 par défaut). –pending : pas encore admis. –passed : admis. –never-retried : différé une fois et jamais réessayé. –domain : le domaine de l’identité du client ou le domaine de l’expéditeur est DOMAIN ou l’un de ses sous-domaines. –ip : la dernière adresse du client se trouve dans ADDRESS (une adresse ou un réseau), ou l’identité est un réseau qui la contient. –rcpt : le destinataire.

allow KIND VALUE [–expires DURATION] [–note TEXT]

Ne jamais greylister ce que nomme VALUE. KIND est l’un de :

ip

l’adresse du client ;

network

un réseau contenant l’adresse du client (192.0.2.0/24) ;

domain

le domaine de l’identité du client (échelon spf ou ptr) ou le domaine de l’expéditeur d’enveloppe, chacun aussi en tant que sous-domaine de VALUE. Le domaine de l’expéditeur n’est pas authentifié : une règle allow pour un domaine laisse aussi passer un falsificateur qui écrit ce domaine dans l’enveloppe. Pour un expéditeur sans enregistrement SPF, préférez une règle de réseau ;

sender

l’expéditeur d’enveloppe ;

rcpt

le destinataire.

–expires prend une durée (30 days, 12 h) ; sans elle, la règle reste en place jusqu’à unrule. Ajouter à nouveau la même règle la renouvelle. Chaque modification est consignée dans le journal d’audit.

deny KIND VALUE [–expires DURATION] [–note TEXT]

Refuse ce que nomme VALUE avec 550 5.7.1. Une règle deny l’emporte sur une règle allow ; aucune ne s’applique aux destinataires exemptés.

rules [–json]

Affiche les règles qui n’ont pas expiré, avec leur identifiant.

unrule ID

Supprime la règle ID.

prune [–json]

Supprime les triplets en attente au-delà de RETRY_WINDOW (en comptant ceux différés une fois et jamais réessayés), les triplets admis non vus depuis PASSED_TTL, les enregistrements de clients qui ne sont plus en whitelist automatique, les règles expirées et les compteurs horaires de plus de 400 jours.

stats [–hours N] [–json]

Indique si le démon répond sur sa socket, et les décomptes des N dernières heures (24 par défaut) : différés, admis au réessai, admis depuis un autre hôte (par échelon et selon la manière dont l’hôte a correspondu), jamais réessayés, connus, contournés (par raison), exemptés, refusés, et les erreurs qui ont laissé passer un destinataire.

95.1.47.1.5. Configuration

[pepsi-greylist]
SOCKET

Où le démon écoute (par défaut unix:/run/pepsi-greylist/milter.sock). inet:HOST:PORT (ou inet:PORT@HOST) écoute en TCP, pour un MTA sur un autre hôte ; ce mode n’a pas de contrôle d’accès propre, liez-le donc à une adresse que seuls les MTA atteignent, ou filtrez le port.

SOCKET_MODE

Le mode de la socket UNIX, en octal (par défaut 0660).

SOCKET_GROUP

Le groupe de la socket UNIX (par défaut pepsi-greylist, le propre groupe du démon). Un membre du groupe peut interroger le démon ; le groupe n’accorde rien d’autre. Le paquet fait de pepsi-ingress un membre. Un groupe auquel le démon n’appartient pas ne peut être défini que s’il est lancé en tant que root.

DELAY

Pendant combien de temps une première tentative est refusée (par défaut 5 min). Les durées peuvent ici s’écrire en jours et en semaines (35 days).

RETRY_WINDOW

Pendant combien de temps après la première tentative un réessai passe encore (par défaut 48 h). Doit être plus long que DELAY.

PASSED_TTL

Pendant combien de temps un triplet admis reste mémorisé après sa dernière apparition (par défaut 35 days).

AUTO_WHITELIST_PASSES

Après ce nombre de passages d’une identité de client (un réessai admis, ou un courrier ultérieur d’un triplet admis), l’identité n’est plus greylistée (5 par défaut ; 0 désactive la whitelist automatique).

AUTO_WHITELIST_TTL

Pendant combien de temps une identité mise automatiquement en whitelist reste exemptée après sa dernière apparition (par défaut 35 days).

IDENTITY

L’échelle d’identité, par ordre de priorité (par défaut spf ptr network). Un échelon omis n’est pas utilisé ; network est toujours le dernier.

IPV4_MASK, IPV6_MASK

Les longueurs de préfixe de l’échelon network (24 et 64 par défaut).

DNS_TIMEOUT

La borne de chaque étape DNS d’une décision : une évaluation SPF, une consultation inverse avec sa confirmation en sens direct, une consultation MX avec les adresses des hôtes (par défaut 2 s). Une étape qui dure plus longtemps laisse passer le destinataire.

DNS_CACHE_TTL

Pendant combien de temps la réponse à « ce client est-il l’un des hôtes de ce domaine ? » est conservée (par défaut 10 min).

DNS_SERVERS

Les résolveurs à interroger, comme pour [pepsi] DNS_SERVERS, qui s’applique lorsque cette option n’est pas définie.

EXEMPT_RECIPIENTS

Destinataires jamais greylistés : des local-parts (n’importe quel domaine, sous-adresse comprise) ou des adresses complètes (par défaut postmaster abuse ; none pour aucun).

RECIPIENT_DOMAINS

Lorsque l’option est définie, seul le courrier destiné à ces domaines de destinataires est greylisté ; le courrier pour tout autre domaine passe. Non définie (par défaut), tout destinataire l’est.

WHITELIST_BYPASS

Laisse passer un expéditeur qui figure sur l’une des whitelists du destinataire (par défaut YES) : la même correspondance que fait pepsi-stage-check-whitelist(1), appliquée à l’expéditeur d’enveloppe. Une ligne qui exige DKIM ou DMARC compte lorsque SPF réussit pour le domaine de l’expéditeur. Quelles whitelists : WHITELIST_NAME.

WHITELIST_NAME

Les noms de whitelist (des modèles avec {localpart} et {login} comme pour l’étape de whitelist, LOCAL_DOMAINS, RECIPIENT_DELIMITER et TARGETS étant lus dans cette section). Non définie, ce sont les noms de toutes les étapes qui exécutent pepsi-stage-check-whitelist qui sont utilisés, de sorte qu’un expéditeur qu’un utilisateur a mis en whitelist n’est jamais retardé. Allow this sender dans la console (pepsi-httpd(1), /ui/deferred) écrit dans le premier de ces noms qui se trouve dans l’espace de noms propre de l’utilisateur (<login>/…), et n’est pas proposé lorsqu’il n’y en a aucun.

BIG_SENDERS

Laisse passer les expéditeurs des groupes [pepsi-greylist-senders-*] (par défaut YES).

SPF_BYPASS

Laisse passer tout client pour lequel SPF réussit (par défaut NO). Désactivée, une réussite SPF ne fait que choisir l’identité ; activée, c’est un contournement complet, et tout expéditeur dont le domaine publie un SPF n’est jamais retardé.

REPLY

La réponse à une première tentative (par défaut 451 4.7.1 Greylisted, please try again later). Elle doit tenir sur une ligne, avec un code 4xx et, s’il y en a un, un code d’état étendu de classe 4 : le greylisting demande un réessai (RFC 5321 section 4.5.4.1).

DB_POOL_SIZE

Nombre maximal de connexions à la base de données que garde le démon (4 par défaut).

MAX_CONNECTIONS

Connexions de MTA servies simultanément (256 par défaut). Une connexion de MTA au-delà est fermée, ce que le MTA traite comme une défaillance du milter ; avec la valeur par défaut ON_FAILURE = accept de pepsi-ingress(1), le courrier est accepté.

[pepsi-greylist-senders-NAME], une par groupe d’expéditeurs jamais greylisté. NAME se compose de lettres minuscules, de chiffres et de -. Les groupes google, microsoft, yahoo, apple et transactional (Amazon SES, SendGrid, Mailgun, Mailchimp, Postmark, SparkPost) sont livrés dans ${DATADIR}/config.d/greylist.conf ; une section de pepsi.conf du même nom les modifie option par option.

DOMAINS

Un client dont le domaine d’identité ou le nom PTR confirmé en sens direct est l’un de ceux-ci, ou un sous-domaine de l’un d’eux, passe. Le domaine de l’expéditeur d’enveloppe seul ne correspond jamais.

NETWORKS

Une adresse de client située dans l’un de ces réseaux passe.

ENABLED

Indique si le groupe s’applique (par défaut YES).

95.1.47.1.6. Utilisation depuis un MTA

Depuis pepsi-ingress(1), dans pepsi.conf(5)

[pepsi-ingress-milter-greylist]
SOCKET = unix:/run/pepsi-greylist/milter.sock

[pepsi-ingress]
MILTERS = greylist

Depuis Postfix, dans main.cf

smtpd_milters = unix:/run/pepsi-greylist/milter.sock
milter_default_action = accept

Le smtpd de Postfix s’exécute en tant que postfix et doit appartenir au groupe de la socket

adduser postfix pepsi-greylist
systemctl restart postfix

Sous Debian, smtpd s’exécute dans un chroot sous /var/spool/postfix, où /run/pepsi-greylist n’existe pas. Écoutez soit en TCP (SOCKET = inet:127.0.0.1:10031 ici, smtpd_milters = inet:127.0.0.1:10031 là-bas), soit placez la socket dans le chroot (SOCKET = unix:/var/spool/postfix/pepsi-greylist/milter.sock, et smtpd_milters = unix:/pepsi-greylist/milter.sock) et laissez l’unité y écrire grâce à un drop-in

# systemctl edit pepsi-greylist.service
[Service]
ReadWritePaths=/var/spool/postfix/pepsi-greylist

Postfix envoie par défaut la macro {auth_authen} avec MAIL FROM, ce qui exempte ses soumissions authentifiées. Ne mettez pas le milter dans non_smtpd_milters : le courrier soumis localement n’est de toute façon jamais greylisté.

95.1.47.1.7. Le service

pepsi-greylist.service exécute le démon en tant que pepsi-greylist, avec le répertoire de socket /run/pepsi-greylist (RuntimeDirectory=). Il ne fait pas partie de pepsi.target : le greylisting est un choix, et l’assistant de pepsi-setup(1) active l’unité lorsque ce choix est fait. À la main

systemctl enable --now pepsi-greylist.service

pepsi-greylist-prune.timer fait partie de pepsi.target ; sur un hôte qui ne pratique pas le greylisting, il ne trouve rien à élaguer.

Le rôle de base de données pepsi-greylist atteint les tables greylist_triplet, greylist_client, greylist_rule (pour lire et élaguer) et greylist_stats, lit whitelist et ajoute à event_log. Les règles sont ajoutées et supprimées par les fonctions greylist_rule_add et greylist_rule_remove, qui normalisent la valeur ; elles sont aussi le seul moyen par lequel pepsi-httpd(1) peut modifier une règle. /ui/greylist dans la console et /api/v1/greylist dans l’API affichent les compteurs, les triplets et les règles, et modifient les règles avec origin = console.

95.1.47.1.8. Exécution en tant que root

Lancée en tant que root, la ligne de commande continue sous le compte pepsi-greylist avant de se connecter à la base de données, et serve lie d’abord sa socket. stats interroge la socket avant le changement, afin que root puisse sonder une socket appartenant à un groupe dont il n’est pas membre.

95.1.47.1.9. Options globales

Ces options globales précèdent la sous-commande (un indicateur placé à la fin est rejeté).

-c FILE, –config FILE

Lit la configuration depuis FILE au lieu de parcourir les emplacements par défaut.

-L LOGLEVEL, –log LOGLEVEL

Règle la verbosité de journalisation. LOGLEVEL est l’un de error, warn, info, debug ou trace. En l’absence de l’indicateur, l’option globale [pepsi] LOG s’applique, et à défaut info.

-v, –verbose

Affiche les messages de journal de toutes les sources, y compris les bibliothèques tierces.

-h, –help

Affiche un résumé d’utilisation et quitte.

-V, –version

Affiche la version et quitte.

95.1.47.1.10. Code de sortie

0

Achèvement réussi.

1

Une erreur s’est produite : une section mal formée, une valeur de règle refusée, un identifiant de règle inconnu, une connexion à la base de données en échec.

78

Le schéma de la base de données ne correspond pas à cette version ; exécutez d’abord schema de pepsi-setup(1).

95.1.47.1.11. Exemples

Quels premiers contacts depuis example.net n’ont jamais été réessayés

pepsi-greylist -c /etc/pepsi/pepsi.conf list --never-retried --domain example.net

Ne jamais retarder, pendant un an, le courrier provenant du réseau d’un partenaire

pepsi-greylist -c /etc/pepsi/pepsi.conf allow network 198.51.100.0/24 \
    --expires '1 year' --note 'partner relay'

Ne greylister que le courrier destiné à un seul domaine d’un hôte partagé, dans pepsi.conf(5)

[pepsi-greylist]
RECIPIENT_DOMAINS = example.org

Greylister malgré tout le courrier des expéditeurs transactionnels

[pepsi-greylist-senders-transactional]
ENABLED = NO

95.1.47.1.12. Voir aussi

pepsi-ingress(1), pepsi-stage-check-whitelist(1), pepsi-status(1), pepsi-httpd(1), pepsi-setup(1), pepsi.conf(5).