50. pepsi-stage-check-whitelist¶
Marquer comme non-spam le courrier des expéditeurs de confiance.
50.1. Rôle¶
pepsi-stage-check-whitelist consulte une liste blanche nommée d’expéditeurs de confiance et, lorsque l’en-tête From: du message correspond, note state.spam = false afin qu’une étape pepsi-stage-anti-spam ultérieure laisse passer le message sans paiement. Placez-la avant l’étape anti-spam. Elle ne fait qu’annoter l’état et avancer ; elle ne rejette, ne fait rebondir ni ne met jamais un message en pause. Référence : pepsi-stage-check-whitelist(1).
50.2. Fonctionnalités¶
Listes blanches en base de données : la table
pepsi.whitelistregroupe les lignes sous unwhitelist_name.WHITELIST_NAMEest une liste séparée par des virgules des groupes à consulter, et une entrée peut être un modèle contenant{localpart}ou{login}, développé pour chaque destinataire d’enveloppe. Ainsi,WHITELIST_NAME = correspondents, {localpart}/correspondentsconsulte la liste partagée de l’opérateur et la liste propre à chaque destinataire, dans l’espace de noms que pepsi-whitelist permet à cet utilisateur de gérer. Seul un destinataire d’un domaine local peut nommer une liste blanche (sinon un co-destinataire choisi par un attaquant se développerait en la liste de n’importe quel utilisateur local), et{login}exige en outre que l’adresse se résolve vers un compte passwd : placez donc l’étape après pepsi-stage-aliases lorsque vous l’utilisez. Tous les noms applicables sont vérifiés en une seule requête.Correspondance ERE POSIX : chaque
whitelist_regexest une expression régulière étendue POSIX, comparée sans tenir compte de la casse au champ que nomme lematch_fieldde la ligne. La comparaison utilise l’opérateur~*de PostgreSQL en un seul aller-retour et est annulée au bout de cinq secondes ; une correspondance annulée compte comme une absence de correspondance, de sorte qu’un motif pathologique ne peut pas immobiliser un backend de base de données. Les champs sont :from(la valeur par défaut) — l”addr-spec extraite de l’en-têteFrom:, jamais la valeur brute de l’en-tête : autrement, une adresse figurant sur liste blanche placée à l’emplacement du nom d’affichage permettrait d’usurper une correspondance. Les commentaires RFC 5322 et les CFWS sont supprimés, et unFrom:nommant plus d’une boîte aux lettres ne correspond à rien (le verdict DKIM/DMARC est calculé pour la première adresse ; faire correspondre une adresse ultérieure répondrait à deux questions portant sur deux expéditeurs).list-id— l’identifiant RFC 2919 de l’en-têteList-Id:du message. Les envois d’une liste de diffusion portent des adressesFrom:arbitraires ; aucun motiffromne peut donc exprimer « tout ce qui est passé par cette liste ».
L’expression elle-même n’est pas ancrée ; ancrez-la avec
^/$pour correspondre à une adresse entière (ce qu’écrit pepsi-stage-auto-whitelist).Une ligne dont l’expression désigne une adresse ou un identifiant de liste exact, ou toute boîte d’un domaine (les formes qu’écrivent pepsi-whitelist et pepsi-stage-auto-whitelist lorsque le texte est en ASCII), est trouvée par un index au lieu d’évaluer l’expression. Le résultat est le même ; seules les autres lignes sont évaluées une à une, de sorte que le coût de la vérification ne croît pas avec le nombre de correspondants appris.
Conditions facultatives par ligne :
dkim_required→ ne correspond que si le domaineFrom:est authentifié :state.auth.dkim = pass, ou un succès ARC que DMARC confirme également (state.auth.arc = passetstate.auth.dmarc = pass). Un succès ARC seul n’est qu’une intégrité de chaîne (une chaîne à un seul saut peut être forgée par l’expéditeur lui-même sur unFrom:falsifié), il ne satisfait donc pas la ligne à lui seul. La colonne vaut true par défaut, comme le faitpepsi-whitelist add.dmarc_required→ ne correspond que si le message a réussi DMARC à l’ingress sur l’un ou l’autre identifiant aligné, une signature DKIM alignée ou une réussite SPF alignée (state.auth.dmarc = pass), ou si un scelleur ARC de confiance l’a laissé passer malgré un échec DMARC (state.auth.arc_override). C’est le niveau qui convient à un correspondant dont le domaine ne signe pas avec DKIM ; une réussite SPF non alignée ne compte pas, et toute réussitedkim_requiredle satisfait. Lorsqu’une ligne fixe plusieurs conditions, toutes doivent être remplies.signature_required→ ne correspond que sistate.signature_verifiedvauttrue, ce que pepsi-stage-decrypt positionne pour un message dont la signature de bout en bout a été vérifiée contre une clé digne de confiance. Un verdictvalid-untrustedne le positionne délibérément pas, de sorte qu’une telle ligne est une véritable barrière « ce correspondant signe, de manière vérifiable » plutôt qu’un « quelqu’un a signé ceci ». Placez une étape de déchiffrement avant celle-ci, sinon la ligne ne correspond jamais. Une signature issue d’unEnvelopedDataS/MIME (AES-CBC) ne compte pas : qu’un texte chiffré CBC modifié se vérifie encore dépend de son remplissage, et le verdict décide si l’on demande à l’expéditeur de payer ou de confirmer (Oracles de remplissage et de format CBC contre S/MIME non authentifié).sealer_domain→ ne correspond que si le message est arrivé avec une chaîne ARC qui a validé et que l’ADMD nommé figure parmi ses scelleurs (state.auth.arc = passet le domaine dansstate.auth.arc_sealers). C’est ce qui rend une lignelist-idsûre :List-Id:est un texte non authentifié que n’importe qui peut copier, et une chaîne ARC valide ne véhicule par elle-même aucune confiance (RFC 8617 §8.4). C’est le fait de nommer le scelleur qui transforme le couple en preuve.
Lignes de liste qui expirent : une ligne
list-idapprise par pepsi-stage-auto-whitelist ne correspond que jusqu’àlast_seen + max_idle; chaque contribution authentifiée à laquelle elle correspond avancelast_seen(au plus une fois par jour), etpepsi-queue gcla supprime une fois échue.Consignation des demandes de confirmation : avec
RECORD_LIST_CONFIRMATIONS, un message qui ressemble à la demande de confirmation d’abonnement d’une liste (un seulMessage-ID:,confirmdans leSubject:, un expéditeur ou unReply-To:en-request/-confirm/-join/-subscribe) est consigné par destinataire local pendantLIST_CONFIRMATION_DAYS(7), afin que l’étape d’auto-liste blanche puisse apprendre la liste à partir de la réponse de ce destinataire. La consignation ne fait confiance à rien.Non destructif : en cas de correspondance, elle fusionne
spam: falseet avance versNEXT_STAGE; sans correspondance, elle avance inchangée. Un message sans en-têteFrom:, comme un message auquel aucun nom de liste blanche configuré ne s’applique, ne correspond à rien.
50.3. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-check-whitelist, WHITELIST_NAME (obligatoire ; la liste, séparée par des virgules, des groupes whitelist_name, littéraux ou sous forme de modèle), NEXT_STAGE (obligatoire, car l’étape transmet toujours le message), les options de localité partagées LOCAL_DOMAINS (par défaut [pepsi-ingress] ACCEPTED_DOMAINS), TARGETS et RECIPIENT_DELIMITER, qui servent à développer les substituants et à réserver les demandes de confirmation aux destinataires locaux, ainsi que RECORD_LIST_CONFIRMATIONS (par défaut no) / LIST_CONFIRMATION_DAYS (par défaut 7). Voir pepsi-stage-check-whitelist(1).
50.4. État¶
Entrées :
state.auth.dkim/state.auth.arc/state.auth.dmarc(pour les lignesdkim_required),state.auth.dmarc/state.auth.arc_override(pour les lignesdmarc_required),state.auth.arc_sealers(pour les lignessealer_domain) etstate.signature_verified(pour les lignessignature_required; écrit par pepsi-stage-decrypt). L’en-têteFrom:provient de la colonnefrom_header;List-Id:est lu dans le bloc d’en-têtes, ce qui explique pourquoi cette étape charge les en-têtes (mais jamais le corps).Sorties : en cas de correspondance,
spam: falsefusionné dansstate; sinonstateest inchangé. Effets de bord : lelast_seend’une ligne de liste apprise qui correspond est rafraîchi, et avecRECORD_LIST_CONFIRMATIONSune demande de confirmation est écrite danspepsi.list_confirmation.
50.5. Voir aussi¶
pepsi-stage-anti-spam, pepsi-stage-arc, Fonctionnalités prises en charge, pepsi-stage-check-whitelist(1). Sécurité : le courrier falsifié qu’une liste blanche ne doit pas admettre (Un expéditeur distant), la borne sur les motifs écrits par les utilisateurs (Disponibilité), pourquoi l’étape ne doit pas figurer dans EDITABLE_STAGES lorsque le filtrage est obligatoire (Les paramètres par adresse sont une frontière de confiance), et qui peut écrire dans la table (La séparation des privilèges).