95.1.40. pepsi-stage-dmarc-report¶
read the DMARC aggregate reports other receivers send about us
- Section du manuel:
1
95.1.40.1.1. Nom¶
pepsi-stage-dmarc-report - l’étape des rapports agrégés DMARC du pipeline Pepsi.
95.1.40.1.2. Synopsis¶
pepsi-stage-dmarc-report [GLOBAL-OPTIONS] worker
95.1.40.1.3. Description¶
pepsi-stage-dmarc-report est un programme d’étape exécuté par pepsi-dispatch(1) comme un worker persistant lisant les identifiants de message sur l’entrée standard.
L’enregistrement DMARC d’un domaine (RFC 7489) indique, dans rua=, où les destinataires envoient leurs rapports agrégés : une fois par jour, par organisation réceptrice, quelles adresses ont envoyé du courrier portant le domaine dans From:, combien de messages, et si DKIM et SPF ont réussi en alignement avec ce domaine. Ces rapports sont le seul moyen de savoir si p=reject refuse un expéditeur légitime, comme un service de lettres d’information ou un système de tickets : avant que cela n’arrive, et pendant que cela arrive. Cette étape les lit dans la base de données (pepsi.dmarc_report et pepsi.dmarc_report_record) ; pepsi-status(1), la console d’administration (Logs, DMARC reports) et pepsi-setup check (voir pepsi-setup(1)) en rendent compte à partir de là.
Placez-la sur le chemin entrant en amont des filtres de liste blanche, de défi et de paiement : le robot de rapports d’un destinataire n’en franchit aucun. Elle n’agit que sur le courrier adressé à LOCAL_PART dans l’un des domaines servis ; tout le reste avance intact vers NEXT_STAGE, et dans le binaire unifié cela se fait sur les seules métadonnées du message, sans charger le corps. pepsi-setup --wizard la place juste après le déchiffrement sur toute installation qui reçoit du courrier, et pepsi-setup run suggère alors un enregistrement DMARC dont le rua= est mailto:dmarc-reports@<domain>.
95.1.40.1.4. Ce qu’il advient du courrier de rapports¶
Un message adressé à l’adresse de rapports portant un rapport lisible (une pièce jointe gzip, zip ou XML brut, comme le décrit la RFC 7489 §7.2.1) concernant un domaine servi (le domaine lui-même, un sous-domaine, ou le domaine organisationnel d’un sous-domaine servi) est stocké et consommé. Un même rapport (même organisation, même identifiant de rapport, même domaine et même authentification) n’est pas stocké deux fois.
Un rapport concernant un domaine que cet hôte ne sert pas est consommé et ignoré.
Le courrier adressé à l’adresse de rapports qui n’est pas un rapport lisible est consommé et abandonné (journalisé au niveau
info). N’importe qui peut écrire à une adresserua=publiée, et faire suivre un tel courrier vers une boîte aux lettres inexistante le transformerait en rebonds vers des expéditeurs falsifiés.Avec
DELIVER = yes, le message est en outre transmis àNEXT_STAGE, pour un site qui tient une boîte aux lettres à cette adresse.Tout autre destinataire du même message garde sa copie, avec ses propres paramètres DSN ; seule l’adresse de rapports est retirée de l’enveloppe.
95.1.40.1.5. Ce que prouve un rapport¶
Un rapport ne prouve rien sur son auteur. L’étape consigne ce dont l’ingress a pu se porter garant au sujet du courrier qui le transportait : le domaine du From: lorsque DMARC a réussi, sinon le domaine de l’expéditeur d’enveloppe lorsque SPF a réussi. Un rapport qui n’a ni l’un ni l’autre est stocké comme non authentifié (journalisé au niveau warn). Seuls les rapports authentifiés comptent pour un verdict : un rapport falsifié ne peut ni faire paraître p=reject sûr ni inventer une source que la politique refuserait. dkim=pass seul n’authentifie pas un rapport ; il dit qu’une signature a été vérifiée, pas de qui. Une copie falsifiée d’un rapport ne masque jamais celle qui est authentifiée, puisque les deux sont stockées séparément.
95.1.40.1.6. Entrées hostiles¶
Un rapport est un fichier compressé venu d’Internet :
La décompression s’arrête à
MAX_REPORT_SIZE(par défaut 16 Mio) : une bombe gzip ou zip s’arrête au plafond, et une entrée zip qui déclare une taille supérieure est refusée avant d’être lue. Seule la méthode deflate est comprise.Le lecteur XML ne développe que les cinq entités prédéfinies et les références de caractères, jamais une entité qu’un document déclare, de sorte qu’un rapport à expansion d’entités (« billion laughs ») garde la taille qu’il avait à son arrivée.
Au plus 20 000 enregistrements d’un même rapport sont stockés ; les autres sont comptés (
records_dropped).
95.1.40.1.7. Configuration¶
[stage-<name>] avec PROGRAM = pepsi-stage-dmarc-report :
- NEXT_STAGE (obligatoire)
Où va chaque message qui n’est pas un rapport, c’est-à-dire presque tous. pepsi-setup(1) vérifie que la cible se résout.
- LOCAL_PART (par défaut
dmarc-reports) La partie locale à laquelle arrivent les rapports, sur chaque domaine de
LOCAL_DOMAINS, une fois la sous-adresse retirée (RECIPIENT_DELIMITER). La vérification des destinataires auRCPTl’accepte sur chaque domaine servi.- DELIVER (par défaut
no) Transmet aussi le courrier de rapports à
NEXT_STAGE.- MAX_REPORT_SIZE (par défaut
16M) Plafond d’un rapport décompressé, sous forme de taille en octets (suffixes
K/M/G).noneest refusé : le plafond est ce qui arrête une bombe.- LOCAL_DOMAINS, RECIPIENT_DELIMITER
Quels domaines sont servis (par défaut
[pepsi-ingress] ACCEPTED_DOMAINS) et le délimiteur de sous-adresse (par défaut[pepsi] RECIPIENT_DELIMITER, sinon+).
[pepsi-dmarc-reports] (lue par la vérification de démarrage de cette étape, par pepsi-status(1), gc de pepsi-queue(1), la console et pepsi-setup(1)) :
- RETAIN_DAYS (par défaut 90)
Nombre de jours pendant lesquels un rapport est conservé après la fin de la période qu’il couvre ;
pepsi-queue gcsupprime les plus anciens (avec leurs enregistrements).- WINDOW_DAYS (par défaut 7)
Nombre de jours sur lesquels remontent les synthèses et le verdict de
pepsi-setup check, comptés d’après la fin de la période de chaque rapport ; au plusRETAIN_DAYS.
Il n’y a pas de BOUNCE_STAGE : l’étape ne fait jamais rebondir. Une erreur de base de données lors du stockage d’un rapport est réessayée comme toute erreur d’étape. La configuration de base est vérifiée au démarrage du worker : une configuration défectueuse le fait refuser de démarrer (code de sortie 78).
95.1.40.1.8. Données du message¶
L’étape charge le message entier (Load::Full), mais dans le binaire unifié chaque message sans destinataire à l’adresse de rapports traverse en fusion sur ses métadonnées, de sorte que le courrier ordinaire ne charge jamais son corps ici. L’étape ne réécrit jamais un message qu’elle transmet ; un message scindé garde son state (state.dsn découpé selon les destinataires restants). Clé de télémétrie dmarc-report : un comptage par rapport stocké.
95.1.40.1.9. Commandes¶
- worker
Lit les identifiants de message sur l’entrée standard et traite chacun. Le seul mode d’exécution ; le dispatcher démarre et arrête ces workers.
95.1.40.1.10. Options globales¶
- -c FILE, –config FILE
Lire la configuration depuis FILE au lieu de parcourir les emplacements par défaut. Doit venir avant la sous-commande.
- -L LOGLEVEL, –log LOGLEVEL
Règle la verbosité de journalisation (par défaut
[pepsi] LOG, sinoninfo).- -v, –verbose
Affiche les messages de journal de toutes les sources.
- -h, –help ; -V, –version
Affiche un résumé d’utilisation / la version et quitte.
95.1.40.1.11. Code de sortie¶
- 0
Le worker s’est terminé proprement.
- 1
Une erreur s’est produite (un fichier de configuration malformé, une section d’étape non résoluble, ou une connexion à la base échouée). La raison est écrite dans le journal.
- 78
Le worker a refusé de démarrer : sa section ou
[pepsi-dmarc-reports]ne s’analyse pas.
95.1.40.1.12. Exemples¶
Lire les rapports juste après le déchiffrement
[stage-decrypt]
PROGRAM = pepsi-stage-decrypt
NEXT_STAGE = dmarc-reports
[stage-dmarc-reports]
PROGRAM = pepsi-stage-dmarc-report
NEXT_STAGE = check-whitelist
et publier, pour chaque domaine servi
_dmarc.example.org. IN TXT "v=DMARC1; p=reject; adkim=s; rua=mailto:dmarc-reports@example.org"
Traiter un message à la main
echo 4711 | pepsi-stage-dmarc-report -c /etc/pepsi/pepsi.conf worker
95.1.40.1.13. Voir aussi¶
pepsi-status(1), pepsi-setup(1), pepsi-queue(1), pepsi-httpd(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7)
RFC 7489, Domain-based Message Authentication, Reporting, and Conformance (DMARC), §7.2 (rapports agrégés) et annexe C (leur schéma XML).
95.1.40.1.14. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.