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) :
spfL’enregistrement SPF du domaine de l’expéditeur d’enveloppe (le nom
HELOpour 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.ptrLe 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.netseul ne prouve rien ;example.netdéclarant que l’hôte est l’un des siens, si.networkLe réseau du client, l’adresse masquée à
IPV4_MASK(24) ouIPV6_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 :
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 deRECIPIENT_DOMAINS(lorsque l’option est définie) et un destinataire figurant dansEXEMPT_RECIPIENTS(postmasteretabuse).Règles (allow, deny) : une règle deny refuse le destinataire avec
550 5.7.1; une règle allow le laisse passer.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).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
SOCKETet répond aux MTA qui s’y connectent. Lancé en tant queroot, il lie d’abord la socket puis continue sous le comptepepsi-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 :
ipl’adresse du client ;
networkun réseau contenant l’adresse du client (
192.0.2.0/24) ;domainle domaine de l’identité du client (échelon
spfouptr) 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 ;senderl’expéditeur d’enveloppe ;
rcptle 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 depuisPASSED_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]SOCKETOù le démon écoute (par défaut
unix:/run/pepsi-greylist/milter.sock).inet:HOST:PORT(ouinet: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_MODELe mode de la socket UNIX, en octal (par défaut
0660).SOCKET_GROUPLe 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 depepsi-ingressun membre. Un groupe auquel le démon n’appartient pas ne peut être défini que s’il est lancé en tant que root.DELAYPendant 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_WINDOWPendant combien de temps après la première tentative un réessai passe encore (par défaut
48 h). Doit être plus long queDELAY.PASSED_TTLPendant combien de temps un triplet admis reste mémorisé après sa dernière apparition (par défaut
35 days).AUTO_WHITELIST_PASSESAprè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 ;
0désactive la whitelist automatique).AUTO_WHITELIST_TTLPendant combien de temps une identité mise automatiquement en whitelist reste exemptée après sa dernière apparition (par défaut
35 days).IDENTITYL’échelle d’identité, par ordre de priorité (par défaut
spf ptr network). Un échelon omis n’est pas utilisé ;networkest toujours le dernier.IPV4_MASK,IPV6_MASKLes longueurs de préfixe de l’échelon
network(24 et 64 par défaut).DNS_TIMEOUTLa 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_TTLPendant 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_SERVERSLes résolveurs à interroger, comme pour
[pepsi] DNS_SERVERS, qui s’applique lorsque cette option n’est pas définie.EXEMPT_RECIPIENTSDestinataires jamais greylistés : des local-parts (n’importe quel domaine, sous-adresse comprise) ou des adresses complètes (par défaut
postmaster abuse;nonepour aucun).RECIPIENT_DOMAINSLorsque 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_BYPASSLaisse 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_NAMELes noms de whitelist (des modèles avec
{localpart}et{login}comme pour l’étape de whitelist,LOCAL_DOMAINS,RECIPIENT_DELIMITERetTARGETSétant lus dans cette section). Non définie, ce sont les noms de toutes les étapes qui exécutentpepsi-stage-check-whitelistqui 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_SENDERSLaisse passer les expéditeurs des groupes
[pepsi-greylist-senders-*](par défautYES).SPF_BYPASSLaisse 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é.REPLYLa 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 code4xxet, 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_SIZENombre maximal de connexions à la base de données que garde le démon (4 par défaut).
MAX_CONNECTIONSConnexions 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 = acceptde 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.
DOMAINSUn 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.
NETWORKSUne adresse de client située dans l’un de ces réseaux passe.
ENABLEDIndique 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,debugoutrace. En l’absence de l’indicateur, l’option globale[pepsi] LOGs’applique, et à défautinfo.- -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
schemade 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).