86. pepsi-tlsrpt¶
Compiler et envoyer les rapports quotidiens SMTP TLS Reporting (RFC 8460).
86.1. Rôle¶
pepsi-tlsrpt est le côté expéditeur du SMTP TLS Reporting (RFC 8460). Lorsque [pepsi-tlsrpt] SEND_REPORTS est activé (il est désactivé par défaut), les étapes de relais notent l’issue de chaque session TLS sortante, succès ou échec classifié, dans la table de compteurs agrégés pepsi.tls_session. Une remise en clair ne compte que lorsque MTA-STS ou DANE exigeait TLS, en tant que starttls-not-supported. Une session que DANE = warn a laissée passer bien que le certificat ne corresponde à aucun enregistrement TLSA compte comme tlsa-invalid. Une politique MTA-STS annoncée qui n’a pas pu être récupérée au premier contact compte comme sts-policy-fetch-error ou sts-webpki-invalid et est signalée sans hôte MX.
Exécuté une fois par jour depuis cron, cet outil compile les compteurs d’une journée en un rapport agrégé par domaine de politique, recherche l’adresse de rapport rua du _smtp._tls de ce domaine et y envoie le rapport JSON compressé en gzip, vers au plus les cinq premières cibles que liste l’enregistrement. Il envoie le rapport par e-mail (mailto:, injecté dans le pipeline à REPORT_STAGE afin d’être signé et relayé) ou par POST HTTPS (https:). Il se connecte via [pepsi-postgres] et est configuré par [pepsi-tlsrpt]. Ce n’est pas une étape. Étant une tâche cron, il démarre normalement en tant que root, auquel cas il poursuit sous le compte de service pepsi avant de se connecter, de sorte que l’entrée de crontab n’a pas besoin de sudo -u pepsi. Référence : pepsi-tlsrpt(1).
Le volet d’annonce (publier notre propre enregistrement _smtp._tls à partir de [pepsi-tlsrpt] RUA) est géré par pepsi-setup.
86.2. Fonctionnalités¶
report — compiler et expédier les rapports de la journée (par défaut : hier, UTC).
--datesélectionne un autre jour UTC ;--dry-runimprime le JSON de chaque rapport et conserve les compteurs. Les compteurs d’un domaine rapporté pour ce jour sont supprimés, de sorte que les réexécutions sont idempotentes.prune — supprimer les compteurs plus anciens que la fenêtre de rétention (
[pepsi-tlsrpt] RETAIN_DAYS, par défaut 7 ;--older-thanla redéfinit), balayant les jours qui n’ont jamais été rapportés (par exemple un domaine n’annonçant aucunrua).pepsi-tlsrpt-prune.timerl’exécute chaque jour, que des rapports soient envoyés ou non.
Un message de rapport porte state.tlsrpt = true ; l’enregistreur de sessions du relais ignore de tels messages, de sorte qu’un rapport qui rencontre lui-même une erreur TLS n’engendre jamais un rapport sur un rapport. Il est envoyé depuis REPORT_FROM, et non depuis l’expéditeur nul, parce que la RFC 8460 §5.3 demande qu’un rapport puisse être aligné sous DKIM et DMARC.
86.3. Sécurité¶
Les deux formes de rua proviennent d’un enregistrement DNS que publie le domaine sur lequel porte le rapport ; toutes deux sont donc traitées comme des entrées hostiles. Une cible mailto: doit être un unique addr-spec local@domain simple (pas d’injection d’en-tête ni de destinataire dans le message de rapport). Une cible https: reçoit le POST par le client HTTPS de la découverte de clés avec les racines d’AC du système : chaque adresse vers laquelle se résout le nom d’hôte doit être publique (aucune cible de boucle locale, RFC 1918, CGNAT ou lien-local à l’intérieur du réseau du serveur de messagerie), les redirections ne sont pas suivies, la réponse est plafonnée à 64 Kio et la requête à 30 s — voir « Key-discovery SSRF » dans Modèle de sécurité et Un expéditeur distant. Seules les cinq premières cibles d’un domaine sont utilisées, de sorte qu’un enregistrement nommant des centaines d’adresses de tiers ne peut pas transformer chaque serveur émetteur de rapports en expéditeur à leur intention. La conservation des compteurs figure dans le tableau de disponibilité (Disponibilité).
86.4. Configuration¶
[pepsi-tlsrpt] : SEND_REPORTS (par défaut no — détermine si les étapes de relais notent seulement les sessions), RUA (l’adresse de rapport que nous annonçons, et que pepsi-setup transforme en l’enregistrement TXT _smtp._tls), REPORT_FROM (obligatoire pour envoyer) et REPORT_STAGE (où un rapport mailto: est injecté), les ORGANIZATION et CONTACT facultatifs affichés dans le rapport, et RETAIN_DAYS (par défaut 7). Voir pepsi.conf(5).
86.5. Voir aussi¶
pepsi-setup, pepsi-stage-relay-to-internet, pepsi-stage-relay-to-smarthost, Architecture, pepsi-tlsrpt(1), pepsi.conf(5).