95.1.46. pepsi-reputation

IP reputation: blocklists for inbound mail, and this host’s own

Section du manuel:

1

95.1.46.1.1. Nom

pepsi-reputation - réputation IP : listes de blocage pour le courrier entrant, et celle de cet hôte lui-même.

95.1.46.1.2. Synopsis

pepsi-reputation [GLOBAL-OPTIONS] iplists update [–force]

pepsi-reputation [GLOBAL-OPTIONS] iplists status [–json]

pepsi-reputation [GLOBAL-OPTIONS] check [–json] [–no-store]

95.1.46.1.3. Description

pepsi-reputation tient à jour les listes de blocage IP auxquelles le courrier entrant est confronté (iplists), et vérifie si cet hôte lui-même figure sur l’une d’elles (check).

Chaque section [pepsi-reputation-list-NAME] désigne une liste. iplists update télécharge chaque liste activée en entier, en HTTPS ou par rsync, dans la table pepsi.ip_blocklist. pepsi-ingress(1) cherche le client de chaque session non authentifiée dans cette table, consigne les listes qui le nomment sous state.origin.ip_blocklist et, pour une liste avec ACTION = reject, refuse ses destinataires. pepsi-stage-if(1) peut acheminer selon la marque : vers une étape de rejet silencieux, vers le filtre de paiement pour envoyer, vers un dossier de quarantaine.

Personne n’est interrogé au sujet d’un client pendant qu’il est connecté. Une requête DNS de liste de blocage par connexion, qui est la façon dont la plupart des MTA utilisent ces listes, apprendrait à l’opérateur de la liste quels serveurs écrivent à cet hôte, et ferait attendre chaque session après un tiers. Une liste téléchargée ne coûte ni l’un ni l’autre, et la session n’attend jamais le réseau pour elle. Le prix est la couverture : les listes les plus utilisées (Spamhaus ZEN, SpamCop, Barracuda) ne sont proposées gratuitement que sous forme de requêtes DNS, et ne peuvent donc pas être utilisées ainsi.

Les listes livrées dans ${DATADIR}/config.d/reputation.conf sont :

spamhaus-drop-v4, spamhaus-drop-v6 (activées)

Spamhaus DROP, des réseaux détournés ou exploités par des opérations de spam et de logiciels malveillants. Environ 1 700 réseaux ; gratuit pour tout usage.

blocklist-de-mail (activée)

Les adresses de blocklist.de qui ont attaqué un service de messagerie au cours des dernières 48 heures. Environ 14 000 adresses, reconstruite toutes les 30 minutes.

uceprotect-1 (désactivée)

UCEPROTECT niveau 1, les adresses qui ont envoyé du spam à ses pièges au cours des 7 derniers jours, par rsync. Activez-la avec ENABLED = YES dans pepsi.conf(5) ; UCEPROTECT demande un don.

Toutes commencent avec ACTION = mark, ce qui ne change rien tant qu’aucune étape n’agit selon la marque.

95.1.46.1.3.1. Téléchargement

iplists update est ce qu’exécute pepsi-reputation-iplists.timer, toutes les heures (quelques minutes après l’heure pile, à la même minute chaque heure sur un hôte donné). Pour chaque liste activée, la commande

  1. saute la liste si son dernier téléchargement a commencé il y a moins de MIN_INTERVAL. Les opérateurs de listes ne demandent pas plus d’environ un téléchargement par heure, et UCEPROTECT bloque, et inscrit sur sa liste, un hôte qui récupère plus de quatre fichiers par heure ;

  2. la télécharge. En HTTPS, la requête porte l”ETag et le Last-Modified du dernier téléchargement, de sorte qu’une liste inchangée coûte un seul 304 Not Modified. Par rsync, la dernière copie est conservée sous CACHE_DIR, de sorte que rsync ne transfère que la différence ;

  3. lorsque le fichier est nouveau (selon SHA-256), l’analyse et remplace les entrées de la liste en une seule transaction. Une inscription expire, rien de la version précédente n’est donc conservé ;

  4. consigne le moment où la liste a été confirmée à jour pour la dernière fois.

Une liste qui ne peut être ni téléchargée ni analysée garde ses entrées et consigne l’erreur. pepsi-ingress(1) ne consulte une liste que tant que sa dernière confirmation date de moins de MAX_AGE, de sorte qu’une liste qui cesse d’être mise à jour cesse d’être utilisée. Elle est alors traitée comme inconnue, non comme « personne n’est inscrit », et l’inconnu laisse passer le courrier. Une liste désactivée, qui n’est plus configurée, ou récupérée par rsync sur un hôte dépourvu de rsync perd ses entrées à l’exécution suivante.

Les entrées plus larges qu’un /8 (IPv4) ou un /16 (IPv6) sont abandonnées : une liste qui se met soudain à inscrire autant est défectueuse ou hostile, et des listes ont déjà inscrit tout l’internet lorsque leurs opérateurs ont jeté l’éponge. Un fichier dont plus d’un dixième des lignes ne sont pas des entrées est refusé comme n’étant pas au FORMAT configuré.

Les téléchargements HTTPS vérifient le serveur au moyen des racines d’AC du système et refusent les adresses de boucle locale et privées. rsync est exécuté avec un environnement vide, l’URL après --, des délais de connexion et d’E/S et --max-size, et il est tué au bout de dix minutes.

95.1.46.1.3.2. rsync

Le programme rsync est une dépendance facultative (le paquet Debian se contente de le suggérer). Une liste dont l”URL commence par rsync:// n’est pas utilisée sur un hôte qui en est dépourvu : iplists update retire ses entrées et journalise un avertissement ; run de pepsi-setup(1) avertit à son sujet et retire aussitôt ses entrées, et l’option experte IP_BLOCKLISTS de l’assistant refuse de l’activer.

95.1.46.1.3.3. Vérification de cet hôte

Une adresse héritée d’un fournisseur de cloud peut arriver avec une mauvaise réputation, et une adresse propre se retrouve inscrite après la compromission d’un compte. pepsi-reputation-check.timer exécute check chaque jour. Cette commande interroge les listes de blocage DNS que consultent les grands destinataires au sujet des propres adresses et domaines de cet hôte, et jamais au sujet d’un correspondant. Les listes n’apprennent donc rien qu’elles n’apprennent pas déjà de chaque destinataire auquel cet hôte écrit. Elle vérifie :

  • chaque PUBLIC_IP d’une étape pepsi-stage-relay-to-internet, les adresses vers lesquelles se résout [pepsi-ingress] HOSTNAME, et CHECK_ADDRESSES, en omettant les adresses qui ne sont pas routables globalement ;

  • les [pepsi-ingress] ACCEPTED_DOMAINS.

Les réponses ne sont pas prises pour argent comptant. Selon la RFC 5782, une liste doit inscrire son entrée de test (127.0.0.2, ::ffff:7f00:2, le domaine test) et ne doit pas inscrire 127.0.0.1 ni invalid. Quand une liste échoue à ce test pour une famille d’adresses, parce qu’elle ne sert pas cette famille, refuse ce résolveur ou répond oui à tout, elle est signalée comme non vérifiée pour cette famille, jamais comme propre ou comme inscrite. Il en va de même d’une réponse dans 127.255.255.0/24, que Spamhaus renvoie pour une requête refusée : .254 signifie que la requête est passée par un résolveur public tel que 8.8.8.8, que Spamhaus ne sert pas ; utilisez un résolveur local (Pepsi en a de toute façon besoin pour DANE). Une inscription est journalisée comme avertissement, les réponses sont stockées dans pepsi.reputation_check, et pepsi-status(1) les affiche. check de pepsi-setup(1) les rapporte sous blocklists, à côté des exigences et des inscriptions des grands fournisseurs de boîtes aux lettres.

95.1.46.1.4. Commandes

iplists update [–force]

Télécharge les listes dont c’est le tour et charge les nouvelles versions. –force télécharge immédiatement chaque liste activée, en ignorant MIN_INTERVAL, les validateurs de cache et l’empreinte de la copie en cache. À utiliser avec parcimonie : les opérateurs de listes bloquent les hôtes qui téléchargent trop souvent.

iplists status [–json]

Pour chaque liste configurée : si elle est current, stale (plus ancienne que MAX_AGE, de sorte que l’ingress l’ignore), never-loaded, disabled ou no-rsync ; son ACTION ; combien d’entrées elle compte ; quand elle a été confirmée à jour pour la dernière fois ; et la dernière erreur.

check [–json] [–no-store]

Interroge les listes de blocage DNS au sujet de cet hôte, affiche chaque inscription et chaque liste qui n’a pas pu être interrogée, et remplace les réponses stockées. –no-store affiche sans stocker ; –json affiche les cibles et chaque réponse.

95.1.46.1.5. Configuration

[pepsi-reputation]
CACHE_DIR

Où rsync conserve sa copie de chaque liste (par défaut /var/lib/pepsi-reputation, le StateDirectory= de l’unité timer).

CHECK_IP_ZONES

Les listes d’adresses qu’interroge check (par défaut zen.spamhaus.org bl.spamcop.net b.barracudacentral.org psbl.surriel.com bl.mailspike.net dnsbl-1.uceprotect.net ix.dnsbl.manitu.net ; none pour aucune).

CHECK_DOMAIN_ZONES

Les listes de domaines qu’interroge check (par défaut dbl.spamhaus.org multi.surbl.org).

CHECK_ADDRESSES

D’autres adresses à vérifier, par exemple une adresse NAT que la configuration ne nomme pas.

GOOGLE_SITE_VERIFICATION

Des paires DOMAIN:TOKEN : le jeton qu’affiche Gmail Postmaster Tools lorsqu’un domaine y est ajouté. run de pepsi-setup(1) affiche l’enregistrement TXT google-site-verification=TOKEN à publier sur le domaine, et check le vérifie. Pepsi ne contacte jamais Google.

[pepsi-reputation-list-NAME], une par liste. NAME est composé de lettres minuscules, de chiffres et de -.

URL

https://… ou rsync://HOST/MODULE/FILE. Obligatoire, sauf pour les quatre listes ci-dessus, dont l”URL et le FORMAT valent par défaut les valeurs livrées.

FORMAT

ip-list (par défaut) : une entrée par ligne, comme dans les jeux de données ip4set et ip6trie de rbldnsd ou dans une simple liste d’adresses. Une entrée est une adresse, un réseau (a.b.c.d/n), une plage (a.b.c.d-e.f.g.h, ou a.b.c.d-h pour le dernier octet) ou la forme courte de rbldnsd (a.b.c pour un /24) ; ! devant une entrée l’exclut. Les commentaires, les lignes de valeur : de rbldnsd et les directives $ sont ignorés. spamhaus-drop : les lignes JSON de Spamhaus DROP.

ENABLED

Si la liste est téléchargée et consultée (par défaut YES).

ACTION

mark (par défaut) : consigne l’inscription. reject : refuse en outre les destinataires de la session avec 554 5.7.1. postmaster reste accepté, comme le demande la RFC 5321, afin qu’un expéditeur inscrit puisse joindre un humain à ce sujet.

MIN_INTERVAL

Le délai minimal entre deux téléchargements (par défaut 45 m).

MAX_AGE

Combien de temps l’ingress consulte encore la liste après sa dernière vérification réussie (par défaut 12 h).

MAX_SIZE

Le plus gros fichier accepté, en octets (par défaut 64 Mio).

95.1.46.1.5.1. Désactiver les téléchargements

ENABLED = NO désactive une seule liste. Pour arrêter tous les téléchargements, masquez le timer ; pepsi.target reste activée et fait tourner tout le reste

systemctl mask --now pepsi-reputation-iplists.timer

95.1.46.1.6. Exécution en tant que root

Lancé en tant que root, l’outil continue sous le compte de service pepsi avant de se connecter à la base de données, comme le fait pepsi-status(1). La configuration est lue avant le changement ; les téléchargements ont lieu après. Les deux unités timer s’exécutent en tant que pepsi.

95.1.46.1.7. 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. Sans cette option, c’est l’option globale [pepsi] LOG qui 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.46.1.8. Code de sortie

0

Achèvement réussi.

1

Une erreur s’est produite : une section de liste mal formée, une connexion à la base de données échouée, ou au moins une liste qui n’a pas pu être mise à jour (les autres sont tout de même mises à jour).

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.46.1.9. Exemples

Si cet hôte est inscrit quelque part, sans stocker la réponse

pepsi-reputation -c /etc/pepsi/pepsi.conf check --no-store

À quoi ressemblent les listes maintenant

pepsi-reputation -c /etc/pepsi/pepsi.conf iplists status

Refuser le courrier des adresses qu’inscrit blocklist.de, dans pepsi.conf(5)

[pepsi-reputation-list-blocklist-de-mail]
ACTION = reject

Envoyer le courrier entrant d’un client inscrit vers une étape de quarantaine au lieu de la boîte de réception, avec pepsi-stage-if(1)

[stage-blocklisted]
PROGRAM = pepsi-stage-if
STATE_PATH = origin.ip_blocklist.listed
VALUE = true
TRUE_STAGE = quarantine
FALSE_STAGE = deliver

95.1.46.1.10. Voir aussi

pepsi-ingress(1), pepsi-stage-if(1), pepsi-setup(1), pepsi-status(1), pepsi.conf(5), pepsi.state(7).