95.1.43. pepsi-setup¶
provision the Pepsi database, signing keys and DNS for a deployment
- Section du manuel:
1
95.1.43.1.1. Nom¶
pepsi-setup - installer le schéma, valider la configuration, faire créer les clés DKIM et imprimer les enregistrements DNS.
95.1.43.1.2. Synopsis¶
pepsi-setup [GLOBAL-OPTIONS] [run [-r | –reset]]
pepsi-setup [GLOBAL-OPTIONS] schema [–backup-dir DIR] [–backup-keep N] [–if-installed]
pepsi-setup [GLOBAL-OPTIONS] check [–fail-on-findings]
pepsi-setup [GLOBAL-OPTIONS] validate
pepsi-setup [GLOBAL-OPTIONS] visualize
pepsi-setup –wizard [–force] [–expert SPEC] [–answers FILE] [–import MTA [–import-root DIR] | –no-import] [-c FILE]
pepsi-setup [GLOBAL-OPTIONS] questions
pepsi-setup [GLOBAL-OPTIONS] apply [–once] [–idle SECS]
pepsi-setup [GLOBAL-OPTIONS] apply –clear
pepsi-setup [GLOBAL-OPTIONS] bootstrap [–valid-for SECS] [–admin-url URL]
pepsi-setup [GLOBAL-OPTIONS] import [MTA] [–root DIR] [–out DIR] [–alias-style STYLE]
GLOBAL-OPTIONS inclut –no-certbot, –no-reverse-proxy et -y/-n pour répondre aux invites de manière non interactive (voir Options globales).
95.1.43.1.3. Description¶
pepsi-setup est l’outil de bootstrap administratif pour un déploiement Pepsi. En une seule invocation, il :
Valide la configuration. Il analyse les sections
[pepsi]et[pepsi-ingress](y compris les écouteurs) et le pipeline[stage-*]. Il vérifie qu’un[stage-init]existe, que chaqueNEXT_STAGE/BOUNCE_STAGEse résout, que la configuration de programme de chaque étape (y compris le routage de MTA amont) s’analyse, que chaque nom de domaine est bien formé et que chaque entréePUBLIC_IPest une adresse IP valide. Il avertit lorsque lePUBLIC_IPd’une étape de relais est une adresse non publique (loopback, RFC 1918 / unique-local, link-local ou CGNAT), et lorsqu’une étape de relais ne définit aucunPUBLIC_IPdu tout (l’enregistrement se dégrade alors en un simplev=spf1 -all). Une adresse non publique ne peut jamais envoyer de courrier sur Internet : la lister, avec le-allfinal, fait donc échouer SPF pour le courrier sortant de cette famille d’adresses ; derrière un NAT, utilisez l’IP de sortie publique de l’hôte, pas son adresse LAN. Il avertit au sujet de chaque entréeMYNETWORKSd’un écouteur d’ingress qui couvre plus d’un hôte (plus large que/32ou/128) et n’est pas le loopback : chaque hôte qu’elle contient peut relayer par ce serveur et envoyer au nom de n’importe quelle adresse sans s’authentifier, de sorte qu’une autorisation de réseau s’étend à chaque machine qui fait partie de ce réseau ou le rejoint plus tard. Listez des hôtes individuels, et laissez les autres clients s’authentifier par SASL ou par un certificat client TLS. Il refuse aussi l’identité réservée.invalidde remplacement livrée dans l’exemple de configuration : si l’un deHOSTNAME,ACCEPTED_DOMAINS,[pepsi] ARC_DOMAINou unSERVER_NAMEd’étape se termine encore en.invalid(par exempleexample.invalid), il s’arrête avec une erreur qui nomme les valeurs fautives, car l’exemple n’a jamais été édité ; il ne provisionne pas de clés ni de DNS pour un domaine qui ne pourra jamais recevoir de courrier. Réglez ces champs sur votre véritable domaine, ou exécutezpepsi-setup --wizard. Il avertit au sujet de chaque option définie dans une section connue que rien ne lit, en suggérant le nom d’option réel le plus proche, car une option mal orthographiée prend silencieusement sa valeur par défaut. Il avertit aussi au sujet des options renommées depuis une version antérieure (voir « Options renommées » dans pepsi.conf(5)). Les sections qu’il ne connaît pas sont laissées telles quelles. Il vérifie[pepsi-dkim](voir pepsi-dkim(1)) :RSA_BITSvaut 2048, 3072 ou 4096 ;ROTATION_LEAD_DAYSest plus court qu’unROTATION_DAYSnon nul ;RETIRE_AFTER_DAYSvaut au moins 1 et dépasse leSIGNATURE_EXPIRATION_DAYSde chaque étape pepsi-stage-dkim-sign(1) et pepsi-stage-arc(1), puisqu’une clé retirée alors que ses signatures sont encore valides fait échouer DKIM pour le courrier en transit ;NOTIFY_ADDRESSest une adresse ; etDNS_UPDATE = rfc2136s’accompagne d’unTSIG_KEY_NAME, d’unTSIG_SECRETen base64 et d’unTSIG_ALGORITHMparmihmac-sha256,hmac-sha384ouhmac-sha512. Il avertit lorsquePUBLISH_RETIRED_KEYSest activé alors qu’aucun écouteur pepsi-httpd ne sert HTTPS au public (les clés seraient écrites sans que personne ne vienne les chercher), ou lorsqu’il est activé sansROTATION_DAYS(les clés ne sont alors retirées que par unpepsi-dkim rotatemanuel). Si quoi que ce soit ne va pas, il rapporte le problème et sort avec un code non nul sans installer de schéma, générer de clé ni rien publier. (La validation n’est pas littéralement la première chose qui s’exécute. Les étapes ci-dessous qui réparent le fichier de configuration la précèdent nécessairement, puisque la validation s’exécute sur leur résultat : l’intégration au reverse-proxy, les chemins de certbot, le secret de preuve d’origine, l’identifiant de télémétrie et la sondeMAILBOX_FS_QUOTA.) Les fichiers de table de correspondance édités par l’opérateur (ci-dessous) ne font délibérément pas partie de cette étape, de sorte qu’une faute de frappe sans rapport dans une table ne peut jamais bloquer l’exécution. Si le pipeline utilise une étapepepsi-stage-detect-languagemais que ce binaire n’est pas trouvé sur le$PATH(il est livré dans son propre gros paquet, séparé du reste de Pepsi), l’exécution avertit et continue ; installezpepsi-stage-detect-languageavant de démarrer le service, sinon l’étape detect-language échouera à se lancer. Deux autres avertissements non fatals signalent des erreurs de configuration probables : une étapepepsi-stage-block-languageavec uneBLACKLISTmais uneWHITELISTvide et unTHRESHOLDnon négatif (qui génère un rebond pour tout courrier de langue neutre ; voir pepsi-stage-block-language(1)), et un cycleNEXT_STAGEnon progressif (une chaîne d’arêtesNEXT_STAGEqui boucle sur elle-même, de sorte qu’un message tournerait en rond jusqu’àMAX_LIFETIME; une ré-entrée légitime viaBOUNCE_STAGE/RESTART_STAGEn’est pas signalée). Il avertit aussi lorsqu’une entréeTARGETSadmet un uid inférieur auUID_MINde/etc/login.defssur une étape dont le helper setuid refuse de tels uid, puisqu’un destinataire retenu par cette seule entrée échoue dans le helper à chaque message. Ces étapes sont pepsi-stage-relay-to-maildir(1), pepsi-stage-dot-forward(1), et pepsi-stage-auto-pay(1) enWALLET_MODE = local-user. Il avertit lorsque[pepsi-ingress] ACCEPTED_DOMAINSest défini mais pasDMARC_ENFORCE: la valeur par défaut compilée estno, de sorte qu’une telle configuration remet le courrier qui échoue à DMARC ; unnoexplicite est laissé tel quel. Il avertit lorsqu’une section de smarthost pointe vers Exchange Online (…mail.protection.outlook.com) sans qu’aucune section[pepsi-ingress-exchange-online-*]ne nomme le locataire : le courrier que le connecteur sortant d’Exchange Online envoie par cet hôte vers d’autres domaines est alors refusé (voir pepsi.conf(5)). Il avertit au sujet d’une étape pepsi-stage-anti-spam(1) sansBOUNCE_TARGET_STAGE, qui fait passer la barrière de paiement à un message à expéditeur nul sans preuvePepsi-Originvalide (un rebond falsifié), et, avec[pepsi-origin] ENABLED = no, au sujet de chaque étape anti-spam (chaque rebond va alors à cette cible) et de chaque étape pepsi-stage-secretary(1) (chaque rebond la passe alors).Avec une étape exécutant pepsi-stage-srs(1), un
[pepsi-srs] SRS_DOMAINaligné DMARC sur un domaine servi est une erreur : une entrée deACCEPTED_DOMAINSou une autre identité d’envoi elle-même, un sous-domaine ou un parent de l’une d’elles, ou un nom partageant ses deux derniers labels avec l’une d’elles (il n’y a pas de liste des suffixes publics, de sorte que le test penche vers aligné). Le courrier réexpédié part avec son expéditeur d’enveloppe réécrit dans ce domaine, depuis les adresses de cet hôte, de sorte que SPF réussit pour lui au saut suivant ; un domaine SRS aligné laisserait un message falsifié au nom d’un domaine servi, reçu de l’extérieur et réexpédié, réussir DMARC là-bas sur la seule base de SPF.[pepsi-srs] ALLOW_ALIGNED_DOMAIN = yeschange l’erreur en avertissement pour un hôte qui ne peut pas avoir de domaine dédié. L’avertissement nomme ce qui ferme la voie :aspf=sdans l’enregistrement DMARC du domaine servi lorsque le domaine SRS en est un sous-domaine, oup=quarantine/p=rejectà cet endroit avec[pepsi-ingress] DMARC_ENFORCE = yes, de sorte qu’une falsification soit refusée à l’arrivée. check lit alors cet enregistrement DMARC (ou celui du domaine organisationnel, lorsque le domaine servi n’en a pas) et le rapporte commeSRS alignment:[ok]lorsqueaspf=sest publié et que les deux noms diffèrent, ou que la politique est contraignante et queDMARC_ENFORCEest activé,[MISMATCH]avec le remède sinon. Il avertit au sujet de chaque[pepsi-srs] PREVIOUS_SECRET_FILEmodifié pour la dernière fois il y a plus deMAX_AGE_DAYS: chaque adresse que la clé retirée a signée a expiré, de sorte que cette clé ne vérifie plus rien et peut être supprimée. Seule la date de modification du fichier est consultée, jamais son contenu. Il avertit aussi lorsqu’une étape exécute pepsi-stage-srs(1) mais qu’aucune n’exécute pepsi-stage-bounce(1) : un rapport distant concernant une copie qu’un alias ou un~/.forwarda envoyée hors site est alors abandonné par pepsi-ingress(1) et l’expéditeur n’est jamais informé.Les réglages de la cryptographie de bout en bout sont validés ici également : les options
CRYPTO_*de[pepsi]et la section de magasin de clés[pepsi-crypto](voir pepsi.conf(5)). Des combinaisons individuellement valides mais conjointement fausses sont des erreurs :CRYPTO_SMIME_SHARED_KEY = yesavec unCRYPTO_SMIME_ALGORITHMà courbes elliptiques, la valeur par défautp256comprise (plusieurs clients S/MIME rejettent une seule clé EC qui fait à la fois ECDSA et ECDH), unCRYPTO_GENERATE_RSA_BITSautre que 2048, 3072, 4096 ou 8192 (les tailles générées en temps constant) ou inférieur àCRYPTO_MIN_RSA_BITS(le déploiement générerait des clés qu’il refuse ensuite), unCRYPTO_MIN_RSA_BITSinvraisemblablement petit, unIDENTITY_VALIDITY_DAYSnon positif, et unKEY_WRAP_KEY_IDqui ne pourrait pas nommer sa propre optionKEY_WRAP_SECRET_<ID>. Une section[pepsi-crypto]qui dit quoi que ce soit mais n’a aucunKEY_WRAP_SECRETest de même une erreur, et le message nomme le fragment@inline-secret@d’où le secret aurait dû venir, avec son propriétaire et son mode : le mécanisme@inline-secret@ne fait qu”avertir pour un fragment qu’il ne peut pas lire, de sorte qu’un fragment illisible est sinon indiscernable d’une option non définie. Un secret de moins de 16 caractères est refusé, car c’est l’unique clé qui ouvre chaque clé privée stockée. Un déploiement qui ne fait pas de cryptographie de bout en bout n’en configure rien et n’en est pas importuné. Trois options valides mais qui affaiblissent ce que signifie la protection d’un message sont acceptées avec un avertissement chacune :CRYPTO_MIN_RSA_BITSinférieur à 2048,CRYPTO_ALLOW_WEAK_DIGESTS = yes(signatures SHA-1, dont les collisions permettent de substituer une signature ou un algorithme de condensé CMS) etCRYPTO_ALLOW_DOWNGRADE = yes(3DES S/MIME au déchiffrement, et le conteneur CBC S/MIME non authentifié pour chaque destinataire plutôt que seulement pour ceux dont l’enregistrement de capacités l’exige).Pour chaque étape pepsi-stage-encrypt(1), il vérifie aussi le préréglage pEp (
ENABLE_PEP) et le libre-service de clés. Il avertit lorsqueENABLE_PEPest activé mais que[pepsi-crypto] AUTO_CREATE_IDENTITY = no(un veto de site valide, mais alors aucun expéditeur ne reçoit de clé automatiquement ; écrivezENABLE_PEP = nopour le rendre explicite) ou qu’aucunKEY_WRAP_SECRETn’est configuré (aucun expéditeur ne peut recevoir de clé) ; lorsqueRESPONSE_STAGEn’est pas réglé (les utilisateurs ne sont pas prévenus lorsqu’une nouvelle clé est enregistrée pour leur adresse, et les commandes de clé par courriel adressées àpepsi-keys@<domain>sont désactivées) ; et lorsque[pepsi-ingress] USERNAME_MAPaccorde un joker, en nommant ces comptes : ils peuvent envoyer en tant que n’importe quelle adresse correspondante mais ne peuvent jamais enregistrer leur propre clé pour l’une d’elles. Il refuse unRESPONSE_STAGEne nommant aucune étape et, lorsqueRESPONSE_STAGEest réglé, unTEMPLATE_DIRdépourvu du modèle de replikey-registered.en.bodyoukeys.en.body.La configuration initiale répare aussi un fragment orphelin. Le secret et la directive
@inline-secret@qui le charge sont deux moitiés d’une même affirmation, rangées dans deux fichiers, et le fragment survit à la configuration qui le référençait. Unepepsi.confrégénérée ou écrite à la main laisse donc un déploiement oùsecrets.d/pepsi-crypto.secretest présent et correct, où rien ne le charge, et où chaque message passant par pepsi-stage-encrypt(1) échoue. Aucune des deux moitiés ne paraît fausse isolément, et réexécuter en tant querootn’aide pas : root peut lire le fragment, mais c’est la directive qui le charge. Lorsque le fragment existe et que la configuration ne le référence pas, la configuration initiale ajoute la directive et le dit. Cela ne renouvelle rien et n’écrit aucun matériel de clé ; c’est donc sûr même lorsque le secret lui-même est illisible. Ce qu’il ne peut pas récupérer est unKEY_WRAP_KEY_IDnon standard qui accompagnait le fichier perdu : l’avertissement nomme donc l’identifiant qu’il a supposé ; réglez-le à la main si la clé a été stockée sous un autre.Prépare les fichiers de table de correspondance édités par l’opérateur. À chaque exécution, il parcourt les tables de recherche configurées : le
[pepsi-ingress] USERNAME_MAPet la tableALIASESde chaque étapepepsi-stage-aliases. Un fichier qui n’existe pas est créé à partir d’un modèle de démarrage commenté (mode0644) qui documente le but du fichier et montre la syntaxe, de sorte que l’opérateur trouve un fichier auto-documenté au bon endroit. Un fichier qui existe est vérifié syntaxiquement avec le même analyseur que celui qu’utilise le composant propriétaire à l’exécution, de sorte qu’une ligne malformée (ou une faute de frappe d’adresse/de domaine) est signalée avec son numéro de ligne. Cette étape est purement indicative : une mauvaise table, ou un modèle qui ne peut être écrit, est journalisé comme un avertissement et n’abandonne jamais l’exécution (les analyseurs à l’exécution sont eux-mêmes indulgents : ils avertissent et sautent une mauvaise ligne). En mode--wizard, ceci ne s’exécute qu”après quepepsi.confa été écrit, de sorte qu’un problème de table n’empêche jamais l’assistant d’écrire la configuration.S’intègre à un serveur HTTP frontal existant. Si un autre serveur web (nginx ou Apache) écoute déjà sur les ports 80/443, pepsi-httpd ne peut lier le 443 et
certbot --standalonene peut lier le 80. Plutôt que de se battre pour les ports, pepsi-setup détecte le serveur frontal (viass), confirme qu’il ne sert pas déjà l’un des noms d’hôtemta-sts.<domain>, puis fait deux choses.D’abord, il garde
[pepsi-httpd-listener-https]activé par socket mais en HTTP en clair (SERVE = systemd,MODE = plain), en supprimant toutMODE = tls+TLS_CERT/TLS_KEYà liaison directe et les sections[pepsi-httpd-cert-*]désormais inutiles. Il dépose aussi une redéfinition depepsi-httpd.socket(/etc/systemd/system/pepsi-httpd.socket.d/10-reverse-proxy.conf) qui relieListenStreamdu443à une socket UNIX à/run/pepsi/httpd.sock(SocketGroup=le groupe du serveur frontal :www-datasur Debian,nginx/apache/httpdailleurs).Sur un hôte que systemd ne gère pas, rien ne transmet de socket à pepsi-httpd ; l’écouteur lie donc lui-même la socket UNIX :
SERVE = unix,UNIXPATH = /run/pepsi/httpd.sock,UNIXPATH_MODE = 660etUNIXPATH_GROUPle groupe du serveur frontal, là encore avecMODE = plain. pepsi-setup redémarre ensuite pepsi-httpd (sa tâche launchd sous macOS ; avec un autre système d’init, il vous demande de le faire).Lorsque le serveur frontal a disparu, ou avec
--no-reverse-proxy, pepsi-setup défait les deux : il supprime la redéfinition depepsi-httpd.socketou, sur un hôte sans systemd, remet l’écouteur enSERVE = tcpsur le port 443. Il rétablit ensuiteMODE = tlset ajoute une section[pepsi-httpd-cert-mta-sts-<domain>]pour chaque nommta-sts.<domain>qu’aucunSNIne nomme, sauf si[pepsi] MTA_STS_MODE = none. L’étape TLS qui suit renseigne leurs chemins de certificats, obtient les certificats et redémarre pepsi-httpd. Un écouteur sur une socket de votre choix n’est pas touché.Ensuite, il écrit un site reverse-proxy (
pepsi-mta-sts) dans lesites-availabledu serveur frontal et l’active danssites-enabled(conf.dpour nginx non-Debian). Le site termine le TLS pour ces noms d’hôte, envoieStrict-Transport-Security: max-age=31536000sur eux (pepsi-httpd ne l’envoie que sur ses propres écouteurs TLS ; un serveur frontal configuré à la main doit l’ajouter aussi, ce que vérifie check), désactive les tickets de session TLS et transfère les requêtes à la socket. Les tickets sont désactivés (ssl_session_tickets off/SSLSessionTickets off) parce qu’une clé de ticket que le serveur garde jusqu’à son redémarrage permettrait à quiconque l’obtient de déchiffrer chaque session enregistrée reprise avec elle, ce qui annulerait la confidentialité persistante. Le site ne définit aucune liste de suites de chiffrement : le serveur frontal appartient à l’opérateur et est partagé avec ses autres sites, de sorte que le choix des anciens clients à écarter relève de la politique de ce serveur. À la place, pepsi-setup lit les réglages TLS effectifs du serveur frontal et avertit lorsqu’ils activent encore des suites TLS 1.2 sans confidentialité persistante (échange de clés RSA statique) : quiconque obtient plus tard la clé privée du serveur peut déchiffrer les sessions enregistrées avec ces suites. Lorsque les réglages ne peuvent pas être lus, pepsi-setup le dit. Dans cette disposition, le serveur frontal termine le TLS, de sorte que les certificats (cette étape et le certificat MX SMTP de l’étape suivante) sont obtenus via le plugin authentificateur certbot de ce serveur (--nginx/--apache) plutôt que--standalone. Cette étape est sans effet lorsqu’aucun serveur frontal n’est présent, et est entièrement sautée avec--no-reverse-proxy(auquel cas pepsi-httpd lie le 443 directement). Une fois le sitepepsi-mta-stsexistant, une réexécution le régénère et ne recharge le serveur frontal que si son texte change : un nommta-sts.<domain>pour un domaine nouvellement accepté y est ajouté (sauf si le serveur frontal sert déjà ce nom ailleurs, ce qui est différé comme ci-dessous), après obtention de son certificat, et un site écrit par un pepsi-setup plus ancien reçoit ce que le site actuel envoie, commeStrict-Transport-Security. Les modifications apportées au fichier à la main sont donc écrasées. Lorsque le test de configuration du serveur frontal refuse le nouveau texte, le texte précédent est remis en place et l’étape est différée. Dans certains cas, l’intégration est différée au lieu d’interrompre l’exécution : lorsque le serveur frontal sert déjà l’un des nomsmta-sts.<domain>(un conflit que vous devez résoudre), lorsqu’il s’agit d’un serveur que pepsi-setup ne peut pas encore automatiser (Caddy, lighttpd, Apache Traffic Server ; câblez le proxy à la main ou passez--no-reverse-proxy), lorsque pepsi-setup ne s’exécute pas en tant que root, ou lorsque le certificat MTA-STS lui-même ne peut être obtenu (le site reverse-proxy référence le certificat en service, il ne peut donc être écrit tant que le certificat n’existe pas). Le résumé de fin d’exécution donne alors un message actionnable, et pepsi-httpd reste dans sa configuration à liaison directe ; dans chaque cas, réexécutezpepsi-setup runune fois la cause résolue. Le répertoire de socket/run/pepsiprovient de l’entréesystemd-tmpfilesdu paquet (aucune unité ne peut déclarerRuntimeDirectory=pepsi: systemd réattribuerait le répertoire et chaque socket qu’il contient à chaque démarrage), et pepsi-setup écrit/etc/tmpfiles.d/pepsi-reverse-proxy.conf, qui accorde à l’utilisateur du serveur frontal l’accès à ce répertoire, à côté du fichier complémentaire de la socket ; cet utilisateur doit pouvoir atteindre la socket partagée par groupe.Provisionne les certificats TLS. Pour chaque écouteur qui termine le TLS et n’a aucun
TLS_CERT/TLS_KEYdéfini, il remplit les options avec la disposition certbot standard (/etc/letsencrypt/live/<lineage>/fullchain.pemetprivkey.pem) et les écrit dans le fichier de configuration sur place (les commentaires sont préservés). Ces écouteurs sont les sockets[pepsi-ingress-listener-*]avecMODE = tls/starttls, les sockets[pepsi-httpd-listener-*]TLS, et chaque certificat SNI[pepsi-httpd-cert-*]. Le courrier et le web ont des certificats et des clés distincts, chacun étant une lignée certbot à part :la lignée courrier
<HOSTNAME>(le[pepsi-ingress] HOSTNAME), utilisée par chaque écouteur d’ingress : la clé qu’épingle l’enregistrementTLSA;la lignée web
<HOSTNAME>-web, utilisée par les sockets[pepsi-httpd-listener-*]TLS (et par une section[pepsi-httpd-cert-*]dont le premier hôteSNIestHOSTNAME) ;une lignée par autre section
[pepsi-httpd-cert-*], nommée d’après son premier hôteSNI(mta-sts.<domain>dans une configuration écrite par l’assistant).
pepsi-httpd, le plus exposé des deux serveurs, ne détient donc jamais la clé du courrier : une clé qui lui est dérobée ne correspond à aucun enregistrement
TLSApublié, de sorte qu’un expéditeur qui impose DANE la refuse pour le MX. Les écouteurs d’un même service partagent leur lignée.Une configuration dans laquelle l’écouteur HTTPS (ou une telle section de certificat) nomme encore les chemins de la lignée courrier, comme dans la disposition d’une lignée unique partagée, est scindée par l’exécution suivante : pepsi-setup obtient la lignée web et, une fois son certificat et sa clé sur disque, remplace les
TLS_CERT/TLS_KEYde cette section par ceux de la lignée web et journalise un avis. Jusque-là (--no-certbot, ou un certificat différé), la section garde le certificat partagé et continue de fonctionner, et une exécution ultérieure achève la scission. Le certificat du courrier, sa clé et son enregistrementTLSAne sont pas touchés. Un certificat que l’opérateur a configuré hors de la disposition certbot n’est jamais déplacé.Le certificat (web) de l”écouteur HTTPS couvre
HOSTNAMEetopenpgpkey.<domain>pour chaque domaine deACCEPTED_DOMAINS, parce que c’est là que la méthode avancée du Web Key Directory est récupérée (pepsi-httpd(1)). Lorsque[pepsi-autoconfig]active l’autoconfiguration du courrier, il couvre aussiautoconfig.<domain>, qui est la première URL qu’un client de messagerie essaie. Ces noms sont ajoutés au certificat propre de l’écouteur plutôt que dotés d’une section[pepsi-httpd-cert-*]à eux, puisque ce certificat est le recours servi dès que SNI ne correspond à rien ; un seul certificat couvre ainsi le cas SNI et le recours.Le certificat (courrier) des écouteurs d’ingress couvre chaque hôte MX qu’une politique MTA-STS autorise, c’est-à-dire l’ensemble
[pepsi] MTA_STS_MXsur tous les domaines servis. La raison n’a pas d’équivalent côté HTTPS. La RFC 8461 §4.1 exige que le certificat présenté par un MX corresponde au nom que l”enregistrementMXa donné à l’expéditeur, et pepsi-ingress(1) sert exactement un certificat par écouteur : il consigne le SNI du client mais ne sélectionne jamais dessus. Un hôte joignable commemx.example.orgetmail.example.netne peut donc pas répondre avec deux certificats ; il lui faut un certificat portant les deux noms. Les entréesmxà joker (*.example.net) sont sautées avec un avertissement, de sorte qu’un déploiement qui en publie une doit fournir ce certificat lui-même. HTTP-01 ne peut pas satisfaire un joker, et en passer un à certbot ferait échouer toute la requête, y compris les noms qui auraient fonctionné.Ensuite, pour chacun de ces hôtes, pepsi-setup exécute
certbot certonly --standalone(HTTP-01 sur TCP/80, enregistré sans adresse électronique) lorsque le certificat n’est pas sur le disque. Lorsqu’il y est, pepsi-setup en lit les Subject Alternative Names et relance certbot (--expand, même--cert-name) s’ils ne couvrent pas tous les noms ci-dessus. Cela importe parce que l’ensemble des noms d’un certificat n’est pas figé à la première délivrance : ajouter un domaine servi, activer l’autoconfiguration ou nommer un nouvel hôte MX l’élargissent tous. Un certificat dont les noms ne peuvent pas être lus est laissé tel quel plutôt que réémis, car « je n’ai pas pu savoir » ne doit pas dépenser une délivrance soumise à quota. Chaque nom est vérifié dans le DNS, et pas seulement le--cert-namedu certificat : certbot valide chaque-dséparément et fait échouer toute la requête si l’un d’eux est injoignable.pepsi-setup décide pour quels certificats il peut piloter certbot en comparant les
TLS_CERT/TLS_KEYconfigurés aux chemins de disposition qu’il aurait lui-même écrits pour cet hôte. Le test ne peut pas être «TLS_CERTest-il posé ? », car une première exécution réussie le pose, après quoi chaque écouteur paraîtrait configuré par l’exploitant et aucun certificat ne pourrait plus jamais être élargi. Les chemins égaux à la disposition sont ceux que pepsi-setup doit tenir à jour ; tout le reste est un certificat que l’exploitant a choisi et n’est jamais touché, et une section à moitié configurée (une seule des deux options posée) est laissée à la validation stricte, qui la signale mieux. Un certificat manquant et impossible à obtenir est différé plutôt que fatal : l’installation continue (pose le schéma, produit les clés, affiche les enregistrements DNS) et énumère chaque certificat différé dans un récapitulatif tout à la fin, avec l’étape suivante concrète et un rappel de relancerpepsi-setup runune fois l’obstacle levé. Relancer est idempotent et n’achève que ce qui manque encore. Un certificat est différé lorsque--no-certbota été passé, quecertbotn’est pas installé, que pepsi-setup ne tourne pas en root (il ne peut donc pas lier TCP/80), que le DNS de l’hôte ne résout pas vers unePUBLIC_IPconfigurée (le défi échouerait) ou quecertbotlui-même échoue (par exemple lors d’un incident passager du serveur ACME ou d’un quota ; une simple relance réessaie alors). Le cas DNS distingue un nom sans enregistrement A/AAAA d’un nom qui résout ailleurs (en rapportant les adresses trouvées face auxPUBLIC_IPconfigurées). Le fichier de certificat étant alors absent, l’enregistrement DANE/TLSA de cet hôte ne peut pas être calculé : la sortie DNS affiche donc un commentaire disant que l’enregistrement manque encore et comment le provisionner. Seule une invocation réellement inutilisable est fatale : un fichier de configuration non inscriptible, ou un chemin de configuration inconnu (lorsqu’aucun fichier de configuration n’existe à un emplacement par défaut et qu’aucun--confign’a été donné), de sorte que les chemins remplis automatiquement ne peuvent pas être conservés. Notez qu’un serveur dont l’écouteur TLS n’a toujours pas de certificat ne démarrera pas tant que le certificat n’existe pas.Donne aux serveurs accès à leur matériel de clés. Les serveurs TLS (pepsi-ingress, pepsi-httpd) s’exécutent sous des utilisateurs non privilégiés et ne peuvent pas lire l’arborescence
/etc/letsencrypt/{live,archive}, réservée à root par certbot ; un écouteur échouerait sinon à démarrer sur un simple permission denied. Trois mécanismes y répondent, appliqués à chaque exécution :Credentials de service systemd : le mécanisme principal partout où systemd exécute les serveurs. Pour chaque serveur, pepsi-setup écrit
/etc/systemd/system/<unit>.d/10-tls-credentials.confen y nommant, sous forme d’entréesLoadCredential=, chaque certificat et chaque clé que ce serveur lit. systemd ouvre alors ces fichiers en tant que root au démarrage de l’unité et transmet au service des copies privées sous$CREDENTIALS_DIRECTORY(un répertoire tmpfs propre à l’unité, lisible par ce seul service). Le chargeur TLS de Pepsi y cherche chaque chemin configuré avant de se rabattre sur la lecture du chemin lui-même, de sorte que les permissions des fichiers cessent complètement d’importer. Le drop-in est régénéré à partir de la configuration à chaque exécution et n’énumère que des fichiers qui existent, car systemd refuse de démarrer une unité dont la source de credential est absente ; relancezpepsi-setup runaprès avoir ajouté, déplacé ou supprimé un certificat. Lorsque le drop-in change, pepsi-setup recharge systemd et appliquetry-restartau serveur concerné (uniquement s’il est en cours d’exécution) afin que le nouveau matériel prenne effet.ACLs POSIX et hook de déploiement certbot : la solution de repli pour un déploiement que systemd n’exécute pas, et le moyen qui gère les renouvellements. Pour chaque certificat géré par certbot auquel la configuration fait référence, pepsi-setup accorde à ces utilisateurs de service les droits de lecture et de traversée au moyen d’ACLs POSIX (
setfacl). Il installe aussi un hook de déploiement certbot dans/etc/letsencrypt/renewal-hooks/deploy/pepsi-cert-access.shqui réapplique l’autorisation à chaque émission ou renouvellement futur et redémarre les serveurs Pepsi. Une autorisation ponctuelle n’y survivrait pas, car certbot fait tournerarchive/<host>/privkeyN.pem; les ACLs par défaut du hook font en sorte que les fichiers nouvellement créés héritent eux aussi de l’accès. C’est le redémarrage qui met réellement un certificat renouvelé en service : chaque serveur lit son matériel une seule fois au démarrage, et systemd matérialise les credentials au démarrage de l’unité. Cette moitié est au mieux : elle exige root,setfacl(le paquetacl) et un système de fichiers gérant les ACLs, et un prérequis manquant est différé avec le correctif, sans être fatal. Les certificats hors de l’arborescence de certbot (TLS_CERT/TLS_KEYdéfinis par l’opérateur) ne sont pas gérés et font seulement l’objet d’un avertissement ; accordez vous-même leurs droits de lecture.Vérification : pour tout ce qu’aucun credential ne couvre, pepsi-setup ne présume pas que l’autorisation a fonctionné. Il fait un fork, devient l’utilisateur de service et tente d’ouvrir le fichier. Un certificat toujours illisible (une ACL silencieusement ignorée par le système de fichiers, un répertoire parent réservé à root, un chemin défini par l’opérateur pour lequel personne n’a accordé de droits) est ainsi signalé comme étape différée qui nomme le fichier, l’utilisateur et l’unité exacts, au lieu de se manifester plus tard sous la forme d’un serveur qui refuse de démarrer.
launchd sous macOS — les tâches launchd démarrent pepsi-ingress et pepsi-httpd en root, et chacun lit ses certificats et clés avant de basculer vers son compte ; aucun fichier n’a donc à être lisible par un utilisateur de service et aucune ACL n’est accordée. pepsi-setup consigne les fichiers TLS que lit chaque serveur (sous
/var/lib/pepsi/launchd-tls) et redémarre la tâche d’un serveur en cours d’exécution (launchctl kickstart -k) lorsque cette liste change. Le hook de déploiement certbot est installé lui aussi ; sous macOS, il ne redémarre que les tâches que launchd a chargées.Assure la joignabilité de Dovecot. Lorsque la remise locale via LMTP ou l’authentification de soumission via Dovecot SASL est configurée, pepsi-setup sonde la socket configurée en tant qu’utilisateur du service qui s’y connectera : le
pepsidu dispatcher pour LMTP,pepsi-ingresspour SASL. Ceci détecte le cas courant d’une socket qui existe mais est injoignable : la socket partagée/run/dovecot/auth-clientde Dovecot est en0600 dovecotet ne peut être ouverte parpepsi-ingress. Si une socket est absente ou illisible et qu’un Dovecot local est présent, pepsi-setup (exécuté interactivement en tant que root) propose d’installer/etc/dovecot/conf.d/10-pepsi.conf, ununix_listenerdédié possédé par l’utilisateur du service Pepsi (mode = 0600, de sorte que les permissions de la socket partagée sont laissées intactes). Il valide ensuite la configuration fusionnée avecdoveconfet recharge Dovecot. Lorsqu’il ne le peut pas (pas root, pas de terminal où demander,doveconfrejetant le résultat, ou pas de Dovecot local), il imprime le drop-in et le diffère afin que vous puissiez le déployer à la main. LeSASL_PATHpar défaut de Pepsi est cette socket privée,/run/dovecot/auth-client-pepsi. Cette vérification s’exécute à chaquepepsi-setup run, pas seulement sous--wizard.-y/--yes-to-allinstalle le drop-in sans demander ;-n/--no-to-allsaute l’installation et se contente de l’imprimer ; l’un ou l’autre rend l’exécution entièrement non interactive.Vérifie la présence d’un autre MTA sur les ports SMTP. Pepsi est rarement le premier serveur de courrier sur un hôte : Debian tire Postfix ou Exim comme
mail-transport-agentpar défaut. Si l’un d’eux écoute encore, pepsi-ingress ne peut pas lier le port et l’échec est silencieux d’une manière particulièrement trompeuse : sous activation par socket, c’estpepsi-ingress.socketqui échoue (systemctl status pepsi-ingress.socketrapporteResult: resources), le courrier continue d’être remis par l”autre serveur en utilisant ses tables d’alias et virtuelles, et chaque changement depepsi.confsemble donc n’avoir absolument aucun effet. pepsi-setup lit la table des écouteurs du noyau (/proc/net/tcp) pour chaque port dont les sections[pepsi-ingress-listener-*]ont besoin, et nomme le processus fautif (avec son pid) lorsque le détenteur n’est nisystemdni Pepsi lui-même. Ces ports sont lePORTconfiguré pour un écouteurSERVE = tcp, et la correspondanceFD_INDEXde l’unité socket livrée (0 → 25, 1 → 465, 2 → 587) pour un écouteurSERVE = systemd. Ceci est indicatif : c’est différé vers le résumé de fin d’exécution plutôt que fatal, puisqu’un opérateur en pleine migration peut délibérément vouloir garder l’ancien MTA en service un moment de plus. Résolvez-le en arrêtant et en désactivant l’autre serveur (systemctl disable --now postfix) puis en démarrantpepsi-ingress.socket.Vérifie que le résolveur valide DNSSEC, et nomme ceux à qui il fait confiance. Dans la même phase, pepsi-setup pose au résolveur qu’utilise le composant (son
DNS_SERVERS,[pepsi] DNS_SERVERSou/etc/resolv.conf) une question dont il connaît la réponse, et cherche le bitAD. Il ne le fait que lorsque la configuration demande DANE : une étape de relais dont leDANEn’est pasoff(strictest la valeur par défaut pour les deux étapes de relais, et pour chaque section smarthost[pepsi-stage-relay-to-smarthost-mta-*]), oudanedans[pepsi-keydiscovery] SOURCES. Pepsi fait confiance à un résolveur validant plutôt que de valider DNSSEC lui-même, de sorte qu’un résolveur qui ne pose jamaisADfait que DANE et la découverte de clés fondée sur DANE ne trouvent rien du tout, silencieusement ; ce constat est différé, non fatal. Il indique ensuite à qui l’installation fait confiance : lorsque l’un de ces résolveurs n’est ni une adresse loopback ni atteint par DNS sur TLS ou HTTPS, un avis liste leurs adresses IP et l’endroit où chacun est nommé, en disant que l’opérateur leur fait confiance pour valider DNSSEC. Le bitADest un unique bit d’en-tête non authentifié, de sorte que quiconque exploite un tel résolveur, et quiconque se trouve sur le chemin qui y mène, décide de ce qui compte comme validé (un enregistrement TLSA,OPENPGPKEYouSMIMEAfalsifié compris). Rien n’est refusé à l’exécution : la mise en place du DNS sort du périmètre de Pepsi, et la configuration recommandée est un résolveur récursif validant à soi sur l’hôte (unbound, ou systemd-resolved avecDNSSEC=yes) à127.0.0.1/::1, pour lequel l’avis reste muet.checkaffiche le même avis.Installe le schéma de base de données. Chaque composant Pepsi partage une base de données (la section
[pepsi-postgres]) et l’unique schémapepsi; pepsi-setup est le seul installateur. Le schéma est une unique série de patchs (pepsi-NNNN.sql) avec unprocedures.sql, appliquée depuis[pepsi-postgres] SQL_DIR(par défaut${DATADIR}/sql). L’opération est idempotente et peut être relancée après des mises à niveau. Les autres composants n’ont pas de commande d’initialisation de schéma propre.Provisionne les rôles de connexion à la base. Chaque compte de service Pepsi reçoit un rôle de connexion PostgreSQL du même nom, authentifié sur la socket locale par authentification de pair, et les droits dont il a besoin sur le schéma
pepsi. Le rôle du pipelinepepsi(ainsi quepepsi-crypto) reçoit le schéma entier, moins les restrictions ci-dessous. En toute dernière étape, les droits des trois services qui ne sont pas le pipeline sont ramenés à ce qu’un audit de leur code indique qu’ils utilisent, et la configuration refuse de se terminer si PostgreSQL n’est pas d’accord :pepsi-ingressINSERTdanspepsi.workqueueetpepsi.workqueue_body(plusSELECTdes identifiants queworkqueue_addrenvoie et des deux colonnes de taille générées,header_octetsetoctets, que le contrôle d’admission de la file d’attente additionne),SELECTsurconfig_override,mailbox_quota,login_assignment(le test RFC 7293 auRCPT), les listes de blocage d’IP téléchargées (ip_blocklist,ip_blocklist_source) etcrl_cache(révocation des certificats clients TLS),SELECTdes colonneslist_nameetmail_hostdemailing_list(le contrôle des destinataires),INSERTsur les deux journaux en ajout seul. Il ne peut lire aucun message déjà en file d’attente.pepsi-telemetrySa propre table
pepsi.telemetry.pepsi-httpdTout ce qu’utilisent la console, le portail, le site des listes et les archives, dans les limites suivantes. Sur
pepsi.workqueue, il n’obtient que les colonnes d’enveloppe,stateet de routage, jamaisheadersni le corps, et il ne peut pas faire pointer lebody_idd’un message ailleurs. Surpepsi.workqueue_body, il n’obtient queINSERT(les formulaires web envoient du courrier) etDELETE(supprimer un message supprime le corps qu’il était seul à porter ; la clé étrangère refuse de supprimer un corps qu’un autre message référence encore), jamaisSELECTdu corps. Il n’obtient rien du tout sursettings,whitelist,vacation_reply,payment_request_reply, les tables du secrétaire,telemetry,origin_nonce,auto_pay_spend,archive_category,archive_tag,list_post_rate,mta_sts_policy,list_confirmation,crl_cache,ca_issuer_cache,smime_capability,otp_key,otp_pending,compromised_key,compromised_key_import,login_assignment,ip_blocklist,ip_blocklist_source,reputation_checknisigned_sender. Il ne peut que lire les tables de statistiques, de quotas, de DNS, de rapports TLS et de rapports DMARC, ainsi que la ligne de vie du démon de télémétrie (telemetry_client). Inversement, les tables d’identifiants (admin_account,admin_session,api_tokenet lesown_enrolmentetown_sessionde la console des utilisateurs finaux) appartiennent àpepsi-httpdseul, et les journaux d’audit et de courrier sont en ajout seul pour chaque rôle qui traite du courrier ;pepsi-httpdpeut y supprimer des lignes pour les élaguer, mais aucun rôle de service ne peut les modifier.
Les privilèges par défaut pour les tables qu’un patch ultérieur crée sont également révoqués pour
pepsi-ingressetpepsi-telemetry. Voir le « Modèle de sécurité » du manuel pour le raisonnement et sa « Suite de tests » pour la manière dont la frontière est testée.Trois autres rôles sont délibérément plus étroits encore :
pepsi-whitelistSe voit accorder
SELECT,INSERTetDELETEsurpepsi.whitelistet rien d’autre, de sorte qu’un programme que tout utilisateur local peut exécuter (pepsi-whitelist(1), installé setuid) ne puisse atteindre ni la file des messages, ni les statistiques, ni les clés de signature.pepsi-keydiscLes services de découverte de clés (pepsi-keydisc(1)), qui analysent du matériel de clé récupéré sur l’internet ouvert et sont donc le processus le plus susceptible d’être compromis ici. C’est le rôle le plus étroit du déploiement :
SELECT/INSERT/UPDATE/DELETEsurpepsi.peer_key(remplir ce cache est tout son travail, et la règle de conflit doit pouvoir remplacer une ligne),SELECT/INSERT/UPDATEsurpepsi.key_request,EXECUTEsur les fonctionskeydisc_*et les deux assistantscrypto_*qu’elles appellent,SELECT/INSERT/UPDATE/DELETEsurpepsi.crl_cache(les listes de révocation qu’il récupère ; c’est le seul rôle qui les écrit, tandis quepepsietpepsi-cryptone peuvent que les lire et qu’aucun autre rôle ne les voit), de même surpepsi.ca_issuer_cache(les certificats intermédiaires qu’il récupère),SELECTsur la liste des clés connues comme compromises (pepsi.compromised_keyetcompromised_key_import, afin qu’il refuse de stocker une clé listée) et, surpepsi.workqueue,SELECTplus unUPDATE (status, timeout)au niveau colonne.Ces deux colonnes sont la partie intéressante. Elles suffisent exactement à faire passer un message garé sur une adresse de
pausedàpending, ce que fontkeydisc_resolveetkeydisc_sweep(de simples fonctionsSECURITY INVOKER, la portée doit donc être accordée explicitement plutôt qu’héritée). Avec un droit au niveau table, ce compte pourrait réécrire les destinataires d’un message ou son corps ; avec ces deux colonnes, il ne peut que réveiller un message. Il n’a aucun accès àpepsi.crypto_identity.pepsi-cryptoLe compte qui a la garde du matériel de clé privée de bout en bout. Il reçoit les droits ordinaires du pipeline sur tout le schéma plus la colonne
pepsi.crypto_identity.private_wrapped, et c’est le seul rôle à l’avoir. C’est aussi le seul rôle qui écrit la liste des clés connues comme compromises (pepsi.compromised_key,compromised_key_import: ce que notentpepsi-keys blocklist updateetpeer screen) ;pepsietpepsi-keydiscne peuvent que la lire, et les autres rôles ne la voient pas. Un rôle qui peut l’écrire pourrait faire refuser par Pepsi la clé de n’importe quel correspondant ; les workers d’étape qui analysent du courrier hostile ne le peuvent donc pas.
Cette dernière colonne est tout l’objet de l’exercice. Immédiatement après les droits globaux, pepsi-setup révoque à chaque rôle de service ordinaire le
SELECT/INSERT/UPDATEau niveau table surpepsi.crypto_identity, et réaccordeSELECTcolonne par colonne pour chaque colonne saufprivate_wrapped. Les rôles de service ordinaires sontpepsi(le dispatcher et chaque worker d’étape),pepsi-ingress,pepsi-httpdetpepsi-telemetry.INSERTn’est pas réaccordé, etUPDATEseulement sur les colonnes qu’écrit le code du rôle : les indicateursis_primary,publishedetvks_wanted(pepsietpepsi-httpd) et les colonnes de progression auprès du serveur de clés (pepsi). Ainsi ces rôles peuvent lire et publier la moitié publique d’une identité mais ne peuvent pas la remplacer, ni son empreinte, ni l’adresse, le protocole et l’usage auxquels elle est destinée, et la compromission d’une étape sans rapport ne donne rien de plus, même avec un accès complet à la base sous ce rôle ; pepsi-setup interroge ensuite PostgreSQL et refuse de terminer si l’un d’eux peut encore écrire une autre colonne. (DELETEn’a pas de granularité par colonne dans PostgreSQL et reste entier : une étape capable de supprimer une ligne d’identité peut refuser le service, mais elle ne peut toujours pas lire une clé.) La liste des colonnes est relue depuisinformation_schemaplutôt que codée en dur, de sorte qu’une colonne ajoutée plus tard soit couverte automatiquement et que le droit ne puisse pas devenir périmé face au schéma. Comme tout le reste de cette étape, c’est idempotent et délibérément réappliqué à chaque exécution, car les droits globaux réajoutent le privilège de niveau table à chaque fois.La colonne enveloppée n’est que la moitié du modèle de garde ; la clé qui l’ouvre réside dans un fragment
secrets.d(ci-dessous). Notez également que l’authentification par pair de PostgreSQL se fonde sur l”uid effectif, non sur le gid, de sorte qu’un programme qui doit être ce rôle doit être ce compte ; c’est ce que pepsi-keys(1) arrange autour de chaque appel à la base. Voir pepsi-keys(1).Fait créer les clés de signature. Il remet l’ensemble des domaines dont Pepsi fait autorité au démon de signature,
pepsi-dkim sync-domains DOMAIN...(voir pepsi-dkim(1)). Cet ensemble est l’union de[pepsi-ingress] ACCEPTED_DOMAINS, des domaines duSERVER_NAME/POSTMASTERde chaque étape, d’unSIGNING_DOMAINexplicite, du[pepsi-srs] SRS_DOMAINd’une étape SRS, duRESPONSE_FROMfixe d’une étape de libre-service, et de[pepsi] ARC_DOMAINs’il est défini. pepsi-setup ne crée, ne lit ni ne détient jamais de clé privée : le démon crée des clés pour chaque domaine qui n’en a pas (une clé RSA de[pepsi-dkim] RSA_BITSet une clé Ed25519, selon ce que demandentDKIM_ALGORITHMSetARC_ALGORITHM), retire les clés d’un domaine qui a quitté l’ensemble, et affiche son document d’état, d’où run tire les enregistrements DKIM. Une nouvelle clé signe immédiatement, de sorte que DKIM échoue chez les destinataires tant que son enregistrement n’est pas publié. Pour chaque domaine pour lequel le démon signale un enregistrement encore à publier ou une rotation en attente du DNS, run journalise un avertissement ; une clé RSA de moins de 2048 bits dans cet état (créée sous une autre politique) fait l’objet d’un avertissement ici et d’unenote:depepsi-setup check, avecpepsi-dkim rotatecomme remède. Lorsque le démon ne peut pas être exécuté, l’étape est différée, non fatale : les enregistrements proviennent du fichier d’état qu’il a écrit en dernier, s’il en existe un, et le courrier sortant attend dans la file jusqu’à ce que le démon ait des clés pour chaque domaine.Dès que le démon répond, les fichiers de clés DKIM que la version 0.0.0 conservait sous
[pepsi] KEY_DIR(<domain>/dkim.rsa.keyet<domain>/dkim.ed25519.key) sont supprimés, chaque répertoire par domaine étant laissé vide, puisque plus rien ne signe avec eux ; leurs enregistrements (<DKIM_SELECTOR>._domainkeyet<DKIM_SELECTOR>-ed25519._domainkey) sont journalisés et affichés comme supprimables.Affiche les enregistrements DNS. Il écrit sur la sortie standard, au format de fichier de zone BIND, les enregistrements à publier pour chaque domaine : les clés publiques DKIM que pepsi-dkim(1) signale comme nécessaires dans le DNS (ses clés
next,currentetretiring, à<DKIM_SELECTOR>-YYYYMM._domainkeypour RSA et<DKIM_SELECTOR>-YYYYMM-ed25519._domainkeypour Ed25519, une valeur RSA étant découpée en chaînes entre guillemets d’au plus 255 octets), une politique SPF (v=spf1 …) bâtie à partir des adressesPUBLIC_IPde chaque étape de relais (réunies ; voir plus bas), une politique DMARC (_dmarc.<domain>TXT ; voir plus bas) et un enregistrement MTA-STS (_mta-sts.<domain>TXT, sauf siMTA_STS_MODE = none) pour que les autres expéditeurs emploient un TLS validé pour notre courrier entrant. Le fichier de politique MTA-STS lui-même est servi en HTTPS par pepsi-httpd(1) àhttps://mta-sts.<domain>/.well-known/mta-sts.txt(son ensemblemxvient de[pepsi] MTA_STS_MX, avec repli sur le[pepsi-ingress] HOSTNAME) : pepsi-setup n’affiche donc que l’enregistrement TXT_mta-stset un rappel de faire pointermta-sts.<domain>vers le serveur. L”idde l’enregistrement dérive de la politique propre à ce domaine, si bien que deux domaines aux ensemblesmxdifférents annoncent des id différents. Contrairement à tous les autres enregistrements ici, celui de MTA-STS n’est affiché que pour les[pepsi-ingress] ACCEPTED_DOMAINS. DKIM, SPF et DMARC authentifient une identité sous laquelle cette machine envoie : ils couvrent donc l’ensemble plus large ci-dessus. MTA-STS est une promesse sur le courrier entrant, et cette promesse n’est tenue que pour un domaine accepté : pepsi-httpd(1) ne répond à/.well-known/mta-sts.txtque pour ces hôtes, et le certificat (ainsi que tout site de serveur frontal) n’est obtenu que pour ces noms. Un domaine qui n’est qu’une identité d’envoi (unSERVER_NAMEde relais, uneSIGNING_DOMAINexplicite, le[pepsi-srs] SRS_DOMAIN) mais qui possède malgré tout un enregistrement TXT_mta-stspublié reçoit à la place un commentaire; DELETE:: il annonce une politique qu’aucun composant ne sert, la requête retombe donc sur ce qui répond par ailleurs à cette adresse. Lorsque[pepsi-tlsrpt] RUAest défini, un enregistrement TLSRPT est également affiché (_smtp._tls.<domain>TXT,v=TLSRPTv1; rua=…), afin que les autres expéditeurs rapportent à l’adresse annoncée leurs résultats TLS vers nos domaines (voir pepsi-tlsrpt(1)). Les longs enregistrements RSA sont automatiquement découpés en plusieurs chaînes de caractères. Enfin, pour chaque écouteur d’ingress terminant TLS, il suggère un enregistrement DANE/TLSA (RFC 7672) sous le nom d’hôte MX (_<port>._tcp.<HOSTNAME>IN TLSA 3 1 1 <hash>), où la donnée d’association est le SHA-256 duSubjectPublicKeyInfodu certificat servi. C’est la forme3 1 1(DANE-EE / SPKI / SHA-256), pour que l’enregistrement survive aux renouvellements de certificat qui réutilisent la paire de clés. Pour un certificat certbot qu’il obtient, il passe--reuse-key, et à chaque exécution il définitreuse_key = Truedans la configuration de renouvellement (/etc/letsencrypt/renewal/<name>.conf) de chaque certificat certbot qu’utilise la configuration, de sorte que certbot garde la clé au renouvellement et que l’enregistrement reste valide. (Un enregistrement déjà publié pour une clé antérieure doit tout de même être remplacé par celui affiché maintenant.) Un changement de clé délibéré est une procédure manuelle : publiez l’enregistrement de la clé suivante à côté de celui de la clé courante, attendez l’expiration du TTL, puis changez de clé et supprimez l’ancien enregistrement (le manuel de Pepsi, chapitre « Exploitation », en donne les étapes). Les enregistrements TLSA déjà publiés sont comparés au certificat que sert chaque écouteur. OutreHOSTNAME, cela couvre chaque hôte MX de chaque domaine accepté et chaque domaine accepté lui-même, pourvu que le nom se résolve vers cet hôte ; un nom qui se résout ailleurs épingle la clé d’un autre serveur et est ignoré. La comparaison se fait comme la fait un MTA expéditeur (RFC 7672 : un enregistrement DANE-EE par rapport à la feuille, un enregistrement DANE-TA par rapport à n’importe quel certificat du fichier de chaîne, avec n’importe quel sélecteur et type de correspondance) : lorsque des enregistrements sont publiés et qu”aucun ne correspond, un avertissement est journalisé et affiché dans le bloc DANE, car chaque expéditeur qui impose DANE refuse de remettre à cet hôte tant que l’enregistrement n’est pas remplacé. Une non-correspondance sous un nom qui n’est l’hôte MX d’aucun domaine accepté est signalée elle aussi, avec le conseil de supprimer l’enregistrement : les expéditeurs qui suivent la RFC 7672 n’y regardent pas, mais un expéditeur qui le fait refuse de remettre. Si un tel enregistrement n’est pas validé par DNSSEC, aucun expéditeur ne l’utilise et il n’est pas signalé. Un enregistrement DANE-TA dont l’ancre n’est pas dans le fichier de chaîne (une racine que le serveur n’envoie pas) ne peut pas être jugé et fait seulement l’objet d’une note. Chaque RRset TLSA publié est aussi demandé aux résolveurs publics ([pepsi] PUBLIC_RESOLVERS, qui valident DNSSEC) avec le bit AD demandé ; un enregistrement qu’ils renvoient sans lui est signalé comme publié mais non validé par DNSSEC, de même que le RRsetMXd’un domaine accepté lorsque des enregistrements TLSA existent pour l’hôte MX de ce domaine : un expéditeur n’utilise les enregistrements TLSA que lorsque les deux se valident (RFC 7672), de sorte qu’une zone non signée ou unDSmanquant chez le parent réduit l’épinglage à une décoration. Un résolveur qui répondSERVFAIL(c’est aussi ainsi qu’apparaît une signature bogus) ne donne aucun verdict ici. Ne les publiez que dans une zone signée par DNSSEC ; l’enregistrement du port 25 est celui qui authentifie la remise entre MTA (les ports de soumission sont signalés par une note, puisque les expéditeurs y utilisent le certificat PKIX). Aucun enregistrement TLSA n’est affiché ni vérifié pour les écouteurs HTTPS de pepsi-httpd(1) : les clients HTTPS (navigateurs, récupérateurs de politiques MTA-STS) n’utilisent pas DANE, et le certificat web a sa propre clé, de sorte que seule la clé du courrier est épinglée.Lorsque les certificats viennent de Let’s Encrypt via certbot (un chemin
/etc/letsencrypt/live/dont la configuration de renouvellement ne nomme aucun autre serveur ACME), un bloc marqué OPTIONAL, not applied suggère un enregistrement CAA (RFC 8659), en commentaire :; example.org. IN CAA 0 issue "letsencrypt.org", sous le domaine accepté dont relève chaque hôte de certificat (sinon l’hôte lui-même). Lorsque le compte certbot de la lignée peut être lu (exécution en tant que root), la valeur porte sonaccounturi(RFC 8657), de sorte que seul le compte ACME de cet hôte peut obtenir un certificat. L’enregistrement fait refuser l’émission à une CA trompée par un détournement de la validation du domaine, mais il restreint chaque certificat du domaine, pas seulement ceux de Pepsi, et c’est pourquoi il n’est jamais appliqué. Ajoutez un enregistrementissuepour chaque autre CA qu’utilise le domaine avant de le publier, et retirezaccounturisi le compte de certbot peut changer. Le bloc n’est affiché qu’avec d’autres enregistrements à publier ; il ne fait jamais apparaître à lui seul la sortie de zone. check rapporte les enregistrements CAA effectivement publiés (voir check).Un bloc marqué Subdomains (SPF, OPTIONAL, not applied) suggère, en commentaire,
; *.example.org. IN TXT "v=spf1 -all"pour chaque domaine servi dont le joker ne répond pas déjà par un enregistrement SPF. SPF est évalué pour le nom exact duMAIL FROM, de sorte que sans lui un expéditeur falsifié dans un sous-domaine inventé obtient SPFnonede chaque destinataire qui n’impose pas DMARC. Il n’est jamais appliqué, car un enregistrement TXT joker est aussi la réponse à toute autre requête TXT pour un nom inexistant situé sous le domaine, et il ne répond pas pour un nom qui existe ; check les liste (voir check). Comme le bloc CAA, il ne fait jamais apparaître à lui seul la sortie de zone.Deux autres blocs concernent la publication des clés de bout en bout (voir pepsi-keys(1)). D’abord, pour chaque domaine servi dont l’hôte
openpgpkey.<domain>ne se résout pas déjà, un rappel d’y publier un enregistrement A/AAAA : la méthode advanced du Web Key Directory, que tout client actuel essaie en premier, est récupérée depuis ce nom, qui doit donc pointer vers l’hôte pepsi-httpd(1). Un domaine qui publie déjà des clés est signalé dans la sortie et fait l’objet d’un avertissement dans le journal, car pour lui la consultation avancée échoue aujourd’hui plutôt que d’être simplement non configurée. (La méthode direct sur l’apex fonctionne sans lui : c’est donc une dégradation, non une panne.) Ensuite, un enregistrementOPENPGPKEY(RFC 7929) ouSMIMEA(RFC 8162) pour chaque identité publiée et active du magasin de clés, sous le nom de propriétaire haché de la RFC (SHA-256 de la partie locale tronqué à 28 octets, en hexadécimal ; ce n’est pas l’empreinte du Web Key Directory, qui est un SHA-1 en z-base-32 de la partie locale mise en minuscules). Ceux-ci ne sont pas comparés au DNS en service : chacun fait quelques centaines d’octets et son nom de propriétaire est une empreinte par identité, de sorte que sonder coûterait une requête par utilisateur pour des enregistrements que l’opérateur colle en bloc. Le listage s’arrête après vingt identités ; utilisezpepsi-keys dns <address>pour une identité précise. Ne publiez les enregistrements de clés que dans une zone signée par DNSSEC : dans une zone non signée, une clé vient de quiconque peut répondre pour la zone. Un commentaire supplémentaire indique ce que révèle le déni d’existence de la zone : sousNSEC, chaque adresse publiée peut être énumérée et, sousNSEC3, les parties locales courantes retrouvées, ce à quoi résiste la signature en ligne avec des enregistrements de couverture minimale (RFC 4470/7129) ; une liste d’adresses qui doit rester privée n’est publiée que par WKD.Un dernier bloc concerne l”autoconfiguration du courrier. Lorsque
[pepsi-autoconfig]est activée, l’hôteautoconfig.<domain>de chaque domaine servi qui ne se résout pas déjà est listé avec un rappel invitant à le faire pointer vers l’hôte pepsi-httpd(1). Contrairement au rappel du Web Key Directory ci-dessus, il s’agit ici de quelque chose de proche d’un échec total plutôt que d’une dégradation : un client essaiehttps://autoconfig.<domain>/mail/config-v1.1.xmlen premier, et la forme/.well-known/sur l’apex, qui n’exige aucun nouvel enregistrement, est facultative dans le brouillon, de sorte qu’un client qui ne l’essaie pas ne trouve tout simplement rien.L’enregistrement SPF est construit à partir de
PUBLIC_IP, une option par étape que pepsi-setup lit dans chaque étape de relais et réunit. Une étape de relais est reconnue par sonPROGRAM(pepsi-stage-relay-to-internet(1) ou pepsi-stage-relay-to-smarthost(1)), jamais par le nom de section. Un déploiement peut donc avoir plusieurs étapes de relais, chacune avec son proprePUBLIC_IP(une étape pepsi-stage-relay-to-internet liste les IP d’envoi propres à cet hôte ; une étape pepsi-stage-relay-to-smarthost liste les IP de sortie du smarthost, puisque le courrier quitte internet depuis là). Si une étape de relais existe mais qu’aucune ne définitPUBLIC_IP, l’enregistrement est un simplev=spf1 -all, qui interdit à tous les hôtes d’envoyer au nom de vos domaines et fait échouer SPF pour votre propre courrier sortant, et pepsi-setup journalise un avertissement. Un déploiement en réception seule (sans étape de relais) n’est pas averti. L’enregistrement unifié est suggéré à l’identique pour chaque domaine servi : correct, mais large. Dans des configurations particulières où différents domaines envoient depuis différents hôtes, un enregistrement SPF par domaine écrit à la main ne listant que les IP d’envoi propres à ce domaine est plus strict tout en restant correct ; pepsi-setup ne calcule pas ce regroupement automatiquement et imprime une note en ce sens à côté des enregistrements suggérés.Un cas SPF reçoit une note explicite dans la sortie de zone, et non un simple enregistrement suggéré : un domaine qui publie déjà deux enregistrements
v=spf1. La RFC 7208 §4.5 en fait une erreur permanente, de sorte qu”aucune politique SPF ne s’applique (le premier enregistrement ne l’emporte pas). Le remède est de les fusionner : l’enregistrement suggéré est donc imprimé avec une note indiquant que l’ajouter sans retirer les autres ne change rien. Unv=spf1 include:<old provider>résiduel est ce qu’une migration de MTA laisse le plus souvent derrière elle.Chaque terme de l’enregistrement publié est vérifié par rapport à la grammaire de la RFC 7208 §12, pas seulement les termes
ip4:/ip6:que demande pepsi-setup : les mécanismesall,include,a,mx,ptr,ip4,ip6etexistsavec leurs qualificateurs, la syntaxe d’adresse et les longueurs CIDR (/0–/32,/0–/128), les modificateursredirect=etexp=(chacun au plus une fois), les modificateursname=valueinconnus, les arguments de domaine qui se terminent par un label de premier niveau, et la syntaxe des macros. Un seul mécanisme inconnu (ipv4:,ip:,inculde:) ou terme malformé fait renvoyer aux destinataires une erreur permanente pour tout l’enregistrement, de sorte qu’aucune politique SPF ne s’applique bien que nos adresses soient listées ; check le rapporte comme[INVALID], en nommant le terme, et la réparation se fait sur place.ptrest valide mais signalé : la RFC 7208 §5.5 dit qu’il NE DEVRAIT PAS être utilisé.L’enregistrement SPF publié de chaque domaine servi est aussi compté par rapport aux limites de traitement de la RFC 7208 §4.6.4 : en suivant chaque
include:etredirect=(unredirect=seulement lorsque l’enregistrement n’a pas deall), il additionne les termes qui font une requête DNS (include,a,mx,ptr,exists,redirect) et les recherches vides parmi eux (une ciblea,mxouincludequi n’existe pas). Au-delà de 10 recherches, ou de 2 vides, les destinataires renvoient une erreur permanente : le domaine n’a pas de politique SPF utilisable, bien que l’enregistrement paraisse correct. Le décompte est le pire cas (aucun mécanisme ne correspond avant la fin), qui est le cas sous lequel un message falsifié est jugé. Un avertissement est journalisé, et check le rapporte comme[INVALID].L’enregistrement DMARC est celui que pepsi-setup ne peut pas dériver : quelle politique un domaine souhaite est une décision d’opérateur, non une conséquence de la configuration. Ce bloc porte donc sur le fait que l’enregistrement soit utilisable, et il se comporte différemment selon ce qui est déjà publié :
Rien de publié.
v=DMARC1; p=reject; adkim=sest suggéré : chaque message que Pepsi envoie pour un domaine servi porte une signature DKIM dont led=est exactement le domaine duFrom:. La politique qui arrête réellement les falsifications ne coûte donc rien à son propre courrier, même avec un alignement DKIM strict, qui empêche la signature d’un sous-domaine de parler au nom du domaine. Le commentaire à côté nomme le seul risque : un autre service qui envoie au nom du domaine (un outil de lettre d’information, un système de tickets) doit d’abord signer avec un DKIM aligné ou être listé dans SPF, etp=none(surveillance seule) est le repli en attendant ; un service qui signe en tant que sous-domaine exige de retireradkim=s. L’alignement SPF est laissé relâché, et le commentaire recommande d’ajouteraspf=sdès que chaque service envoyant au nom du domaine utilise un expéditeur d’enveloppe exactement dans ce domaine (c’est le cas de Pepsi). Lorsqu’une étape exécute pepsi-stage-dmarc-report(1) pour le domaine, la suggestion ajouterua=mailto:dmarc-reports@<domain>(sonLOCAL_PART), l’adresse à laquelle cette étape lit les rapports agrégés qui vous disent si chaque expéditeur est aligné ; check rapporte alors ce qu’ils disent. Sans une telle étape, le commentaire demande unrua=mailto:<address>et nomme l’étape.Un enregistrement valide. Rien n’est affiché, exactement comme pour les autres enregistrements, sauf si une étape lit les rapports et que le
rua=de l’enregistrement omet son adresse : l’enregistrement à publier à la place est alors affiché, celui qui est publié avec toutes ses étiquettes dans leur ordre et l’adresse ajoutée àrua=(ou une étiquetterua=ajoutée à la fin). Chaque destinationrua=/ruf=est vérifiée comme le décrit check (une destination externe sans son enregistrement d’autorisation_report._dmarc, une destination qui ne peut pas recevoir de courrier) ; un problème est affiché comme commentaire; WARNING:et journalisé. Lorsque sonp=vautquarantineourejectet que[pepsi-ingress] DMARC_ENFORCEest désactivé, un avertissement est journalisé : le domaine demande à tout autre destinataire d’agir sur un échec DMARC que cet hôte remet. Un avertissement recommande le même enregistrement avecsp=reject; np=rejectlorsque l’enregistrement laisse aux sous-domaines une politique plus faible quereject: unp=autre querejectsanssp=, ou unsp=ounp=(la politique pour les noms qui n’existent pas) explicitement plus faible. Un sous-domaine au nom duquel personne n’envoie de courrier peut refuser les falsifications tandis que le domaine lui-même est encore surveillé. check affiche le même conseil à côté de l’enregistrement.Un enregistrement que les destinataires ignoreraient. La raison est imprimée en commentaire et journalisée comme avertissement, et aucune valeur de remplacement n’est proposée. C’est délibéré : un enregistrement qui ne s’analyse pas reste une déclaration d’intention, et un enregistrement malformé doit être réparé là où il est plutôt que remplacé par l’enregistrement nu que cet outil suggérerait sinon. Corriger une faute de frappe ne devrait pas faire disparaître silencieusement le
rua, lespou lep=quarantinedélibéré d’un domaine.
La validité est jugée strictement, étiquette par étiquette, contre la RFC 7489 §6.4 plutôt qu’en cherchant des sous-chaînes, car un enregistrement DMARC échoue silencieusement : rien ne rebondit, aucun destinataire ne se plaint, et le domaine cesse simplement d’être protégé alors que tout le monde le croit protégé. En particulier, un enregistrement auquel il manque un seul
;, par exemple… p=reject; aspf=s adkim=s, reste une syntaxe de liste d’étiquettes générique parfaitement correcte (la RFC 6376 §3.2 autorise les espaces et les=à l’intérieur d’une valeur d’étiquette) : un lecteur laxiste voit donc l’étiquetteaspfavec la valeurs adkim=set l’accepte ; seule la grammaire de valeurs propre à DMARC la rejette. Là où la valeur fautive contient quelque chose ayant l’allure de l’étiquette suivante, le diagnostic le dit nommément (tags are separated by ';', and there is none before 'adkim='). Les autres cas signalés sont un second enregistrement DMARC au même nom (RFC 7489 §6.6.3 : les destinataires écartent tout l’ensemble), une étiquette répétée (RFC 6376 §3.2, où la valeur gagnante est indéfinie), une étiquettep=manquante, et une adresserua=/ruf=écrite sans son schémamailto:. Tout ce que pepsi-setup déclare valide est recoupé dans la suite de tests contre l’analyseur même qu’applique pepsi-ingress(1) au courrier entrant, de sorte qu’un enregistrement béni ici ne puisse pas être un enregistrement qu’un destinataire jette. Les vérifications ci-dessus sont délibérément plus strictes que cet analyseur, puisqu’un enregistrement peut s’analyser sans être pour autant la politique que son auteur a publiée.Avant de suggérer chaque enregistrement TXT (DKIM, SPF, DMARC, MTA-STS, TLSRPT), pepsi-setup interroge d’abord le DNS en service (au mieux) : un enregistrement déjà publié avec la valeur correcte ne contribue rien à la sortie, pas même son en-tête de section par domaine, de sorte que seuls les enregistrements qui ont véritablement besoin d’être (re)publiés sont imprimés. Le rappel
mta-sts.<domain>de publier un enregistrement A/AAAA (ou CNAME) est de même émis seulement lorsque cet hôte ne se résout pas déjà, et le bloc DANE/TLSA n’est imprimé que lorsqu’un écouteur d’ingress terminant le TLS existe. Lorsque rien n’a besoin de changer, tout le vidage de zone est supprimé et une seule lignesetup: DNS records checked and they are OKest journalisée à la place, de sorte que réexécuter sur une zone déjà configurée soit silencieux. La sonde n’est pas fatale : lorsque le DNS est injoignable (ou qu’un résolveur ne peut être construit), chaque enregistrement est traité comme un changement et imprimé. Le bloc DMARC fait exception sur ce dernier point : sans réponse du DNS il n’y a rien à comparer et aucune valeur locale sur laquelle se rabattre, il reste donc silencieux plutôt que de dire à un domaine peut-être déjà correct de publier une nouvelle politique. (Utilisez la sous-commande check pour une vérification en service des enregistrements TXT publiés.)« Déjà publié avec la valeur correcte » signifie correct sur chaque serveur de noms faisant autorité de la zone, et pas seulement dans la réponse du résolveur du système. Pour chaque enregistrement TXT, pepsi-setup détermine aussi l’ensemble
NSde la zone et interroge chaque serveur directement, sans récursion : un secondaire qui sert encore une ancienne clé, un serveur délégué qui ne sert plus la zone (une délégation boiteuse) ou un serveur qui ne répond pas du tout font que les destinataires ne voient le bon enregistrement qu’une partie du temps ; l’enregistrement est donc imprimé avec une ligne; NOTE:nommant chaque serveur en désaccord (et un avertissement est journalisé). Une mauvaise réponse du résolveur que tous les serveurs faisant autorité contredisent est signalée comme un cache périmé. Lorsqu”aucun serveur faisant autorité n’est joignable, comme sur un réseau qui ne laisse sortir que le résolveur local sur le port 53, un avertissement est journalisé une seule fois et la réponse du résolveur décide seule.Un enregistrement de sélecteur DKIM est jugé comme un vérificateur le lit (RFC 6376 §3.6.1), et non d’après son seul
p=: exactement un enregistrement de clé à ce nom,v=(s’il est présent) en premier et valantDKIM1, unk=nommant le type de clé (une clé Ed25519 sans étiquettek=échoue partout, puisque l’étiquette vautrsapar défaut), aucune restrictionh=/s=excluantsha256/email, pas det=y(mode test, sous lequel une signature ne compte pour rien) et unp=égal à la clé que pepsi-dkim(1) rapporte pour le sélecteur. Seuls les sélecteurs avec lesquels[pepsi] DKIM_ALGORITHMSsigne sont imprimés et vérifiés, plus celui dont le sceau ARC a besoin sur l”ARC_DOMAIN. Un enregistrement qui peut disparaître est affiché comme commentaire; remove:, jamais comme enregistrement ; un tel enregistrement appartient à une clé que le démon a retirée, ou à un fichier de clé 0.0.0 que run a supprimé. Lorsque le démon n’a pas encore rapporté ses clés, la zone n’a aucun enregistrement DKIM et un avertissement dit de démarrerpepsi-dkim.serviceet de regarder à nouveau. À côté de l’enregistrement Ed25519, ou dans une ligne de journal lorsque tous les enregistrements sont déjà corrects, pepsi-setup signale que Gmail, Microsoft 365 et Yahoo ne vérifient pas les signatures Ed25519 et que les rapports agrégés DMARC de Google les indiquent commefail. C’est attendu et sans conséquence, puisque la signature RSA fournit la réussite alignée dont DMARC a besoin, et la signature Ed25519 peut être supprimée avecDKIM_ALGORITHMS = rsa.Dans la même phase, pepsi-setup vérifie aussi le DNS inverse (PTR) de chaque
PUBLIC_IPde pepsi-stage-relay-to-internet, c’est-à-dire des adresses de sortie propres à cet hôte (unPUBLIC_IPde pepsi-stage-relay-to-smarthost est celui du smarthost, il est donc sauté). Chaque adresse est jugée face au nom qu’annonce l’étape propriétaire, sonSERVER_NAME(se rabattant sur leHOSTNAMEd’ingress lorsqu’une étape n’en fixe aucun), car c’est cette paire qu’un destinataire compare. UnPUBLIC_IPn’est correct que lorsque sonPTRexiste, se confirme en sens direct, et nomme exactement cet hôte ; toute autre issue est un avertissement :aucun enregistrement PTR — un fort signal de spam chez de nombreux destinataires ;
un PTR qui n’est pas confirmé en sens direct — le nom d’hôte du
PTRne se résout pas (A/AAAA) vers la même IP, de sorte que la vérification aller-retour (forward-confirmed reverse DNS, FCrDNS) qu’appliquent de nombreux MTA échoue et qu’ils traitent l’IP comme n’ayant aucunPTRdu tout ;un PTR générique / d’allure attribuée dynamiquement — un nom qui incorpore l’IP ou porte un jeton de pool résidentiel (
dynamic,dsl,pool…), ce que les destinataires pénalisent souvent ;un PTR nommant un hôte différent du nom ``EHLO`` — l’enregistrement est parfaitement bien formé et confirmé en sens direct, il nomme simplement un autre hôte. Une large famille de destinataires refuse la session d’emblée avec HELO host does not match rDNS. Cela se déclenche même lorsque le nom du ``PTR`` est l’un de vos propres
ACCEPTED_DOMAINS: une machine qui répond à plusieurs noms (disonsexample.organnoncé dans l”EHLOtandis que son adresse se résout en inverse versexample.net) passe ici toutes les autres vérifications et voit tout de même son courrier refusé ;un PTR qui n’a pas pu être résolu du tout — une zone inverse non déléguée ou un DNS injoignable. L’exactitude n’a pas pu être établie, et une adresse sans
PTRutilisable est refusée ou classée indésirable par beaucoup de destinataires : c’est donc signalé plutôt que passé sous silence.
Chaque avertissement porte une remédiation concrète. Comme le DNS inverse d’un
PUBLIC_IPréside dans la zone du propriétaire de l’IP (in-addr.arpa/ip6.arpa), le remède habituel est de demander à votre FAI ou hébergeur de régler lePTRsur le nom annoncé ; si vous exploitez vous-même la zone inverse, le message de PTR manquant imprime l’enregistrement… IN PTR …exact à publier. Pour une discordance de nom où lePTRest déjà l’un de vos propres domaines, le message propose aussi l’autre sens, puisque ce remède n’exige la coopération de personne : adopter le nom duPTRcomme identité de cet hôte ([pepsi-ingress] HOSTNAMEet leSERVER_NAMEde chaque étape, l’enregistrement MX et le certificat TLS suivant). Les deux noms doivent désigner un seul hôte ; partager un domaine ne suffit pas. La valeur par défaut de nom d’hôte de l’assistant provient de la même résolutionPTR(voir –wizard ci-dessous), de sorte qu’une configuration générée par le questionnaire s’accorde d’emblée avec le DNS inverse.Un étage de relais avec
EHLO_FROM_PTR = yes(voir pepsi.conf(5)) annonce lui-même le nomPTRconfirmé dans le sens direct de son adresse d’envoi. Pour cet étage, lePTRest donc comparé à son propre nom : la discordance de nom ne peut pas se produire, mais unPTRabsent, non confirmé ou d’apparence générique est toujours signalé. Sans nom confirmé dans le sens direct, l’étage se rabat surSERVER_NAME, et la vérification juge ce nom comme d’habitude.Le DNS tel que l’Internet le voit. Chacune des vérifications ci-dessus est faite depuis cet hôte, et de là, une zone servie depuis le propre réseau de l’hôte semble toujours saine. Derrière un NAT, une requête venant de l’intérieur pour une zone inverse dont le serveur de noms est cette machine même reçoit sa réponse du LAN, du routeur ou de l’hôte lui-même. Pendant ce temps, une requête venant de l’Internet expire sur un routeur qui redirige le port 25 mais pas le port 53, ou atteint un serveur de noms qui sert une zone plus petite que celle que son parent délègue, de sorte que les résolveurs qui minimisent leurs requêtes (RFC 9156) reçoivent
REFUSED. Les destinataires diffèrent alors chaque message avec cannot find your reverse hostname, et la vérification locale affirme que lePTRest correct.pepsi-setup pose donc de nouveau la question aux résolveurs publics nommés par
[pepsi] PUBLIC_RESOLVERS(par défaut Google, Cloudflare et Quad9, chacun en IPv4 et en IPv6 ; voir pepsi.conf(5)) : lePTRde chaquePUBLIC_IP, confirmé dans le sens direct via le même résolveur ; l’ensembleMXde chaque domaine et les enregistrements TXT que vérifie la sous-commande check ; et les adresses duHOSTNAMEde l’ingress. Tous sont interrogés, parce qu’ils diffèrent par la famille d’adresses qu’ils utilisent pour joindre un serveur de noms et par la façon dont ils parcourent une délégation, et une zone qui n’est joignable qu’en IPv6, ou boiteuse seulement pour un résolveur qui minimise, échoue pour certains d’entre eux et pas pour d’autres. Un destinataire utilise aussi l’un d’eux. Tout résolveur qui ne peut pas résoudre un nom, ne trouve aucun enregistrement ou voit une réponse différente de celle de cet hôte (DNS à horizon partagé) est un avertissement, qui nomme le résolveur et, lorsqu’il en envoie une, son erreur étendue RFC 8914 (No Reachable Authority: At delegation …). Lorsque les serveurs de noms de la zone se résolvent vers les adresses propres de cet hôte ou vers des adresses privées, l’avertissement le dit et nomme les causes habituelles : une redirection de port absente ou désactivée pour le port 53 UDP ou TCP, une règle de pare-feu IPv6, ou une zone servie qui n’est pas celle qui est déléguée. La sous-commande check les signale comme[UNREACHABLE](un enregistrement correct que l’Internet ne peut pas lire) et liste les verdictsPTRdans un groupe reverse DNS qui leur est propre.Les résolveurs injoignables depuis cet hôte sont écartés en silence (un hôte sans connectivité IPv6 perd ceux en IPv6) ; lorsqu’aucun n’est joignable, un avertissement est journalisé une fois et seule la vue locale est vérifiée.
PUBLIC_RESOLVERS = nonedésactive cette vérification.Recoupements MTA-STS. Tout le reste de ce que pepsi-setup vérifie à propos de MTA-STS est cohérent par construction : l’enregistrement TXT
_mta-stsporte uniddérivé de la politique, et la politique est dérivée de la configuration, les comparer ne peut donc que réussir. Deux choses ne sont pas dérivées de la configuration, et sousMTA_STS_MODE = enforcel’une ou l’autre, si elle est fausse, arrête silencieusement tout le courrier entrant du domaine. Les deux sont vérifiées à chaquepepsi-setup run, et rapportées par la sous-commande check et par la console web ; comme les constatsPTR, ce sont des avertissements et ils ne font jamais échouer l’exécution.L’ensemble ``mx`` de la politique face aux enregistrements MX réels. Une politique est la promesse que les expéditeurs ne peuvent se connecter qu”*aux hôtes qu’elle nomme. Un expéditeur résout le ``MX`` du domaine, trouve un hôte que la politique n’autorise pas, et refuse de remettre. Tous les expéditeurs conformes le font à la fois, et de ce côté-ci on ne voit aucun symptôme hormis du courrier qui n’arrive jamais. C’est l’échec auquel le repli ``MTA_STS_MX`` invite, car ``HOSTNAME`` est le nom de salutation ``EHLO`` et n’a pas à être un nom vers lequel un enregistrement ``MX`` pointe. L’avertissement nomme les hôtes de chaque côté et affiche l’unique ligne ``MTA_STS_MX`` qui les mettrait d’accord, qualifiée par domaine lorsque les domaines servis ont des hôtes MX différents, ainsi que l’alternative consistant à changer plutôt l’enregistrement ``MX`` et le conseil de se replier sur ``MTA_STS_MODE = testing`` jusqu’à ce qu’ils concordent. Cette vérification rapporte aussi un domaine **sans* enregistrement
MX, un MX nul (RFC 7505) sur un domaine dont nous acceptons le courrier, une cibleMXqui est unCNAME(interdit par la RFC 5321 §5.1, et les expéditeurs peuvent le refuser), une entrée de politique qui ne correspond à aucun hôteMXréel (inoffensif, mais cela élargit ce à quoi les expéditeurs se connecteront), et une entréeDOMAIN:HOSTnommant un domaine absent deACCEPTED_DOMAINS. Une telle entrée ne s’applique à aucune politique, et c’est exactement l’allure d’une faute de frappe dans l’option.Si la politique peut être récupérée.
pepsi-setupdemandehttps://mta-sts.<domain>/.well-known/mta-sts.txtet compare ce qui revient avec la politique que cette configuration définit. La comparaison est sémantique, de sorte que les fins de ligne et l’ordre des clés ne sont pas des différences. Les redirections ne sont pas suivies, car la RFC 8461 §3.3 interdit à un expéditeur de les suivre, et une politique servie seulement derrière une redirection est une politique qu’aucun expéditeur ne peut lire. Un enregistrement TXT correct devant une politique que personne ne peut récupérer n’est pas une hypothèse. Un seul socket injoignable, un serveur frontal mal configuré ou un certificat manquant suffit pour que chaque expéditeur reçoive un502à la place, tandis que chaque unité resteactiveet que rien n’est journalisé. Les expéditeurs qui avaient déjà mis une politique en cache continuent d’appliquer l”ancienne jusqu’àmax_age, de sorte que l’échec ne prend même pas fin de lui-même. Un5xxest rapporté avec le socket du serveur frontal comme chose à vérifier.Lorsque le nom publié ne peut pas être atteint depuis cette machine, parce qu’il ne résout pas encore ou parce que le réseau ne lui permet pas d’atteindre sa propre adresse publique, la requête est retentée contre cette machine par l’interface de boucle locale. Le nom publié reste dans le SNI et dans l’en-tête
Host, de sorte que le certificat est encore validé contre le nom qu’un expéditeur emploierait. Ce résultat est étiqueté comme sonde locale, car il dit ce qu’un expéditeur obtiendrait une fois quemta-sts.<domain>résoudra ici ; c’est la raison pour laquelle une erreur de configuration purement locale est tout de même signalée sur une machine dont le DNS n’est pas encore publié.
Le domaine SRS peut recevoir ses propres rebonds. Lorsqu’une étape exécute pepsi-stage-srs(1), pepsi-setup vérifie que
[pepsi-srs] SRS_DOMAINpossède un enregistrementMXou, à défaut, un enregistrementA/AAAA(le MX implicite de la RFC 5321 §5.1). Une adresse SRS est un chemin de retour : la réécriture fait de cet hôte la destination des rebonds d’un courrier qu’il n’a pas écrit, et le HMAC contenu dans l’adresse existe pour que pepsi-ingress(1) puisse décoder un rebond qui revient et le relayer à l’expéditeur d’origine. Sans l’un de ces enregistrements, cet aller-retour se termine en silence : la réexpédition fonctionne, SPF réussit au saut suivant, et chaque rebond est abandonné par le MTA qui a tenté de le renvoyer, de sorte que l’expéditeur d’origine n’apprend jamais que son message n’est pas arrivé. Un MX nul de la RFC 7505 (MX 0 .) est la même réponse énoncée délibérément, et une cibleMXqui est unCNAMEest signalée pour la même raison que partout ailleurs (RFC 5321 §5.1, RFC 2181 §10.3). L’avertissement affiche l’enregistrement à publier, en nommant un hôte vers lequel les domaines acceptés routent déjà du courrier, et propose comme alternative de retirer l’étape si rien n’est réexpédié hors site. (Un domaine accepté, qui recevrait déjà du courrier, n’est pas une alternative : il est aligné DMARC sur lui-même, voir ci-dessus.) Comme les vérifications ci-dessus, c’est un avertissement et il ne fait jamais échouer l’exécution.Cette vérification existe parce que l’omission est invisible sous tous les autres angles. Le domaine SRS est une identité d”envoi : il rejoint donc l’ensemble qui reçoit des clés DKIM et des conseils SPF et DMARC ; pepsi-setup ne suggère d’enregistrement
MXpour aucun domaine, cela relevant de la décision de routage de l’exploitant. Un exploitant qui publie tout ce qu’on lui dit de publier se retrouve donc avec deux des trois enregistrements dont le domaine a besoin, et rien nulle part ne le dit.La confirmation en sens direct n’interroge que le DNS faisant autorité et ignore délibérément le fichier local
/etc/hosts, car un hôte de courrier y liste couramment son propre nom face à127.0.1.1ou à une adresse interne au NAT, ce qui ferait sinon paraître non confirmé un nom parfaitement confirmé. Ces observations sont des avertissements de délivrabilité, non des erreurs : elles ne font jamais échouer l’exécution.Vérifie le backend de paiement (facultatif). Lorsqu’une section
[pepsi-payments]configure un backend marchand GNU Taler, pepsi-setup le vérifie via HTTP :GET /configdoit identifier un backendtaler-merchant(de sorte que l’URL est correcte) etGET /private/orders?limit=1doit renvoyer200(de sorte que leMERCHANT_ACCESS_TOKENest correct). Il s’assure ensuite qu’un webhookpepsi-resumeexiste qui fait unPOSTvers le point de terminaison/resumede pepsi-httpd chaque fois qu’une commande est payée. Il crée le webhook s’il est absent ; si un webhookpepsi-resumeexiste déjà, il journalise un avertissement lorsque sa définition diffère de celle attendue (il n’est jamais silencieusement écrasé). Le webhook cible l’hôte SNI[pepsi-httpd-cert-*]configuré le plus court via HTTPS et s’authentifie avec[pepsi-httpd] RESUME_AUTHORIZATION_TOKEN. Lorsqu’aucun backend marchand n’est configuré, cette étape est entièrement sautée.Rappelle les identifiants qui expirent hors bande. Lorsqu’un MTA smarthost utilise
AUTH = oauth, pepsi-setup valide les sections secrètes[pepsi-helper-token-refresh-<name>]correspondantes qu’il peut lire (il s’exécute en tant queroot) et imprime un rappel indiquant que ces jetons d’accès doivent être maintenus à jour, par exemple en activant pepsi-helper-token-refresh(1), qui ne fait pas partie depepsi.target. Lorsqu’un MTA utiliseAUTH = gssapi, il rappelle de même que le cache d’identifiants Kerberos doit être renouvelé hors bande (une keytab plusk5startou cron) et être lisible par le worker du dispatcher, en contrôlant la vraisemblance de tout chemin de cache qu’il peut voir. Les deux rappels vont dans le journal (sortie d’erreur standard), après la sortie de zone, de sorte qu’ils ne peuvent jamais corrompre un fichier de zone redirigé.
Tout le comportement est piloté par un fichier de configuration de style INI (voir pepsi.conf(5)). Le même fichier de configuration est partagé avec les autres outils Pepsi.
95.1.43.1.4. Privilèges et propriété¶
pepsi-setup peut être exécuté soit directement en tant que propriétaire de la base de données (par exemple su pepsi-owner -c 'pepsi-setup … run'), soit en tant que root. Lorsqu’il est exécuté en tant que root, il gère lui-même deux identités distinctes, de sorte que les objets résultants sont possédés par les bons comptes :
Les objets de base de données sont créés en tant que rôle
pepsi-owner. Avant tout travail de base de données (installation du schéma, provisionnement des rôles, validation des paramètres, vérification du backend de paiement), pepsi-setup assume l’identité effective de l’utilisateurpepsi-owner; l’authentification par pair de PostgreSQL se connecte alors en tant que le rôle du même nom, de sorte que le schémapepsi, ses tables, séquences et fonctions sont possédés parpepsi-owner. L’utilisateur/rôlepepsi-owneret la base de données elle-même doivent déjà exister (le paquet Debian les crée ; sinon créez-les à la main). Seul l’uid effectif change, de sorte que root est regagné ensuite.Le démon de signature travaille sous son propre compte.
pepsi-dkim sync-domains, exécuté par root, crée[pepsi-dkim] STATE_DIRetPUBLIC_DIRlorsqu’ils manquent et devient le comptepepsi-dkimavant de toucher à une clé, de sorte que chaque fichier de clé appartient à ce compte (mode0600dans des répertoires0700) et à aucun autre.
Lorsque pepsi-setup n’est pas exécuté en tant que root, aucun des deux changements n’a lieu : il opère entièrement en tant que l’utilisateur invoquant, qui doit donc être le propriétaire de la base de données, et pepsi-dkim sync-domains doit pouvoir écrire dans les répertoires du démon (ou joindre le démon en marche). Supprimer les fichiers de clés 0.0.0 sous KEY_DIR exige un accès en écriture à cet endroit.
Note
Le scellement ARC (effectué par pepsi-stage-arc(1) sur le courrier entrant) utilise la clé DKIM d”ARC_ALGORITHM du [pepsi] ARC_DOMAIN, de sorte qu’il n’y a ni clé ARC ni enregistrement DNS séparés : les vérificateurs ARC récupèrent la clé publique du sceau depuis le même enregistrement DKIM. Lorsque ARC_DOMAIN est défini, pepsi-setup l’inclut simplement parmi les domaines de signature qu’il remet à pepsi-dkim(1) et les domaines pour lesquels il affiche des enregistrements.
95.1.43.1.5. Assistant¶
Pour un premier déploiement, –wizard remplace l’édition à la main par un court questionnaire interactif et écrit un fichier de configuration complet et déjà validé.
Le questionnaire est présenté comme une séquence d”étapes numérotées qui regroupent les questions liées : Identité du serveur, Système de courrier existant, Remise locale, Authentification de soumission, Confiance en la boucle locale, Courrier redirigé, Sécurité du transport, Filtrage de contenu, Paywall anti-spam, Self-service de compte et Cryptographie de bout en bout (plus Options expertes sous –expert). Chaque étape est affichée comme une bannière Step X/Y avec une description d’une ligne, en couleur sur un terminal capable (réglez la variable d’environnement NO_COLOR pour la désactiver). Quelles étapes apparaissent (et donc Y) découle de la direction choisie et de la détection ou non d’un Dovecot local. Le chapitre L’assistant du manuel dessine le pipeline que produit chaque direction et liste ce que décide chaque question. Lorsque stdin est un vrai terminal, les invites sont éditables ligne à ligne avec les raccourcis clavier GNU-readline habituels (Home/End, Ctrl-Left/Ctrl-Right pour sauter des mots, Ctrl-A/ Ctrl-E/Ctrl-K/Ctrl-U/Ctrl-W, et Up/Down pour rappeler des réponses antérieures) ; un stdin redirigé (non-terminal), comme celui qu’utilisent la suite de tests et les scripts, retombe sur de simples lectures de ligne. Chaque réponse est validée au moment où elle est saisie (les noms d’hôte et les domaines doivent être pleinement qualifiés, le postmaster une adresse valide, les IP d’envoi de véritables littéraux IP, les ports numériques, le délai de paiement une durée h/m/s, et ainsi de suite), de sorte qu’une erreur est signalée à sa propre invite et corrigée sur-le-champ plutôt qu’à la seule validation finale de la configuration entière.
Il demande d’abord la direction que l’hôte sert, ce qui détermine les écouteurs SMTP (port 25 pour l’entrant, 465/587 pour le sortant) et les étapes de relais qui apparaissent : inbound (recevoir depuis Internet le courrier pour nos domaines, en le remettant localement et/ou en le relayant plus loin), outbound (envoyer les soumissions de nos propres utilisateurs directement vers Internet) ou both (la valeur par défaut ; séparer sur state.local_origin avec une étape d’acheminement). Il demande ensuite le nom d’hôte, le ou les domaines acceptés, l’adresse postmaster, la ou les IP d’envoi publiques et la chaîne de connexion à la base, proposant des valeurs par défaut sensées (le parent du nom d’hôte comme domaine). La valeur par défaut du nom d’hôte est prise du DNS inverse : l’assistant détecte les adresses publiques de cet hôte (la même détection décrite plus bas pour les IP d’envoi), consulte leurs enregistrements PTR, et propose le premier nom qui se confirme en sens direct vers l’adresse et n’a pas l’air auto-généré. Ce n’est qu’à défaut d’un tel nom qu’il se rabat sur /etc/hostname. C’est délibéré : un serveur de courrier destinataire compare le nom annoncé dans l”EHLO au PTR de l’adresse d’où vient la session et rejette lorsqu’ils divergent (HELO host does not match rDNS), tandis qu”/etc/hostname est une étiquette purement locale qu’aucun destinataire ne voit jamais. Sur un hôte qui répond à plusieurs noms, les deux diffèrent couramment, et le DNS inverse réside dans la zone du propriétaire de l’IP : c’est donc normalement la moitié qu’on ne peut pas changer. Lorsque la valeur par défaut proposée (la réponse d’une exécution antérieure, ou /etc/hostname) contredit le PTR, l’assistant le dit et nomme les deux avant de poser la question. La valeur par défaut des IP d’envoi publiques est détectée automatiquement et proposée pour confirmation : les enregistrements A/AAAA publiés du nom d’hôte, unis aux adresses d’interface globalement routables propres à l’hôte, plus l’IPv4 WAN que rapporte la passerelle UPnP locale via upnpc (miniupnpc), s’il est installé. La passerelle n’est interrogée que lorsque les autres sources ne trouvent aucune IPv4 publique (un hôte derrière un NAT avec une IPv4 privée). Seules des adresses publiques sont suggérées : une adresse privée/loopback/lien-local n’est jamais pré-remplie (derrière un NAT, la valeur détectée est l’IP de sortie publique, pas l’adresse LAN). L’opérateur la confirme ou la modifie avant que quoi que ce soit ne soit écrit.
Sur le chemin entrant, la question suivante est de savoir si un système de courrier existant, Microsoft Exchange ou Microsoft 365, se trouve derrière cet hôte. Répondre oui fait de Pepsi une passerelle transparente : il devient le MX et remet tout au point de terminaison du locataire, de sorte qu’il n’y a pas de boîtes aux lettres locales et que les questions de remise locale ci-dessous sont sautées. Il demande ensuite l’hôte et le port SMTP de ce point de terminaison (en avertissant qu’il doit s’agir du point de terminaison propre au locataire, et non du MX public du domaine, qui est cet hôte et bouclerait) ainsi que la famille d’adresses IP par laquelle l’atteindre (any/ipv4/ipv6 ; Exchange Online refuse le courrier venant d’une adresse IPv6 sans DNS inverse, ipv4 est donc l’échappatoire lorsque le DNS inverse IPv6 n’est pas délégué).
Sinon, sur le chemin entrant, il demande quelle(s) méthode(s) de remise locale utiliser : Maildir (pepsi-stage-relay-to-maildir) et/ou LMTP vers un MDA (pepsi-stage-relay-to-lmtp). Lorsque Maildir est activé, il demande aussi s’il faut honorer les fichiers ~/.forward par utilisateur (pepsi-stage-dot-forward ; la section générée ne transfère que vers des adresses, avec ALLOW_PIPE / ALLOW_FILE désactivés).
Toujours sur le chemin entrant, il demande si cet hôte doit répondre au courrier des destinataires absents (pepsi-stage-vacation, non par défaut). Répondre oui ne fait que placer l’étape dans le pipeline, après l’expansion des alias et après les barrières anti-spam, de sorte qu’un avis ne soit jamais envoyé au nom d’un alias ni en réponse à du courrier que les barrières auraient refusé. Personne ne reçoit de réponse tant qu’il n’existe pas de dates de congé, et celles-ci sont de la configuration par adresse ordinaire plutôt qu’une réponse d’assistant : un utilisateur peut fixer les siennes par e-mail, un opérateur avec pepsi-settings set <address> vacation VACATION_RANGES …, et un jour férié partagé par tous avec pepsi-config set --scope domain:<domain> stage-vacation VACATION_RANGES …. La section générée laisse donc VACATION_RANGES non défini (avec la syntaxe en commentaire) et pointe RESPONSE_STAGE vers la queue de signature partagée afin que chaque avis soit signé et relayé. Sur un hôte sans remise locale, comme un pur redirecteur ou une façade Exchange, il règle en outre VACATION_TAG = none : marquer l’objet réécrirait sinon un en-tête couvert par la signature DKIM de l’auteur et par le sceau ARC propre à cet hôte, que le saut suivant verrait échouer. Voir pepsi-stage-vacation(1).
Il demande ensuite le smarthost amont (facultatif lorsque la remise locale ou un système Exchange gère les domaines servis, requis sinon).
Deux questions décident ensuite comment le courrier quitte cet hôte avec une signature qui lui est propre. La première concerne les programmes tournant sur cet hôte, comme cron, mail(1), logwatch, git send-email ou une application web, qui sont sinon refusés avec 550 5.7.1 Relaying denied pour tout destinataire hors d’un domaine servi.
L’assistant ne demande pas s’il faut servir la socket de soumission de domaine UNIX qu’emploie /usr/sbin/sendmail. pepsi-ingress la sert toujours, en la dérivant de [pepsi-sendmail] SOCKET : aucune section d’écouteur n’est donc écrite et il n’y a rien à mal répondre. Le noyau indique à pepsi-ingress quel compte a ouvert la socket, de sorte qu’un appelant ne peut jamais envoyer qu”en son propre nom : le login passe par USERNAME_MAP exactement comme le ferait un nom d’utilisateur SASL. Voir pepsi-sendmail(1), et SOCKET = none pour la désactiver.
Ce qu’il demande bel et bien, sous forme d’une question oui/non valant non par défaut, c’est s’il faut faire en plus confiance à la boucle locale. Il ne pose cette question que sur un hôte servant les deux directions : la réponse devient MYNETWORKS sur l’écouteur MX du port 25, que seul un hôte entrant possède, et la question ne vaut d’être posée qu’à un hôte qui soumet aussi.
TRUST_LOOPBACKAjouter
MYNETWORKS = 127.0.0.0/8 ::1/128à l’écouteur du port 25 (fusionné avec tous les réseaux réglés via les options expertes, jamais dupliqué). Ceci fait confiance à une position réseau plutôt qu’à un utilisateur, de sorte que tout processus local, y compris une application web compromise, peut envoyer au nom de n’importe qui. C’est aussi ce qui permet à un message que cet hôte relaie vers lui-même (un domaine servi dont le MX public est cet hôte) de rentrer comme une nouvelle soumission et de boucler. Ne répondez oui que pour un logiciel qui insiste pour parler SMTP au port 25 et qu’on ne peut pas diriger vers la socket.
Dans les deux cas, les messages qui en résultent comptent comme originaires localement (state.local_origin) et sont donc signés en DKIM par le chemin sortant.
Sur le chemin entrant, il demande s’il faut signer en DKIM le courrier que cet hôte redirige (par défaut oui) : un alias qui se déploie hors site, un ~/.forward pointant vers un autre fournisseur, ou tout le chemin de relais pur. Ces messages partent par la queue entrante, que le [stage-dkim-sign] sortant ne touche jamais, de sorte que sans cela ils arrivent au saut suivant avec notre enveloppe SRS mais un dkim=none de notre part. Répondre oui émet une seconde étape de signature, [stage-dkim-sign-relay], entre la réécriture SRS et la destination, avec SIGNING_DOMAIN épinglé au domaine servi principal. Cet épinglage est délibéré : la signature est fail-closed, et le domaine de l’auteur appartient à quelqu’un d’autre, de sorte que dériver le domaine de signature d’un From: étranger ferait échouer chaque message redirigé faute de clé. L’identité propre de l’hôte est le nom d’hôte configuré partout, distinct des domaines de destinataires acceptés (qui délimitent SRS, MTA-STS et les adresses de rapport TLS). Cette identité couvre le domaine de scellement ARC ([pepsi] ARC_DOMAIN), chaque SERVER_NAME de relais/rebond et le certificat d’écouteur de repli.
La manière dont ces écouteurs lient leurs ports dépend de l’hôte. Lorsque le système est géré par systemd (détecté par la présence de /run/systemd/system), l’assistant écrit des écouteurs activés par socket (SERVE = systemd avec un FD_INDEX par écouteur) de sorte que les ports privilégiés soient liés par des unités .socket et hérités par le service non privilégié ; sinon il retombe sur des liaisons directes (SERVE = tcp avec BIND_TO / PORT). Les écouteurs d’ingress prennent toujours le FD_INDEX 0 pour le port 25, 1 pour le 465 et 2 pour le 587, en accord avec le pepsi-ingress.socket livré, qui liste les trois quelle que soit la direction que sert l’hôte. Avec l’activation par socket, vous devez installer les unités .socket correspondantes (un pepsi-ingress.socket listant ListenStream=25, 465 et 587 dans cet ordre, et un pepsi-httpd.socket pour le port 443) ; l’assistant imprime un rappel après l’écriture.
Deux questions de sécurité du transport suivent. Sur le chemin entrant, il demande s’il faut servir une politique MTA-STS (par défaut oui) : lorsqu’elle est activée, il règle MTA_STS_MODE = enforce et ajoute une section [pepsi-httpd-cert-*] pour l’hôte de politique mta-sts.<domain> de chaque domaine accepté (servi via HTTPS par pepsi-httpd), dont pepsi-setup provisionne le certificat via certbot comme tout autre ; vous devez pointer le DNS de chaque nom mta-sts.<domain> vers le serveur pour que la politique soit accessible. Les hôtes que la politique autorise ne sont pas demandés : ils sont lus dans les enregistrements MX en service des domaines servis et écrits sous [pepsi] MTA_STS_MX (omis lorsqu’aucun enregistrement MX n’existe encore, de sorte que la politique se rabat sur HOSTNAME ; voir Recoupements MTA-STS plus haut). Il demande ensuite s’il faut envoyer des rapports SMTP TLS (TLSRPT, RFC 8460 ; par défaut oui), ce qui émet la section [pepsi-tlsrpt].
La même étape se termine par la seule question qui ne porte pas du tout sur ce déploiement : celle de savoir s’il faut partager une télémétrie anonyme d’usage des fonctionnalités avec le projet Pepsi ([pepsi] SHARE_TELEMETRY, par défaut non). Elle relève du consentement explicite : l’invite explique donc ce qui serait envoyé avant de poser la question, à savoir un SYSTEM_ID aléatoire de 256 bits et des décomptes des fonctionnalités de Pepsi que cet hôte a exercées, jamais d’adresses, de données de message, de noms d’hôte ni d’adresses IP. Appuyer sur Entrée d’un bout à l’autre du questionnaire ne partage par conséquent rien. Répondre non désactive tout le chemin : aucun identifiant n’est généré, la configuration ne démarre jamais le démon, et un démon que l’opérateur a démarré est mis en sommeil. Voir pepsi-telemetry-client(1).
Les sections pepsi-httpd sont toujours écrites, quoi que l’on refuse par ailleurs : HTTPS sur le port 443 avec le certificat web, distinct de celui qu’utilisent les écouteurs SMTP (servant la politique MTA-STS lorsque celle-ci est activée), et la console d’administration sur /run/pepsi/admin.sock pour le groupe pepsi-admin. pepsi.target démarre le serveur et sa socket sur chaque hôte, de sorte qu’une configuration sans écouteur le laisserait échouer et redémarrer en boucle.
Un court menu de fonctionnalités suit, posé uniquement là où il s’applique à la direction choisie : s’il faut bloquer le courrier par langue détectée (et, sinon, s’il faut tout de même localiser les messages de rebond, ce qui active la détection de langue). Lorsque la détection est activée, il imprime d’abord la liste complète des codes ISO 639-1 pris en charge et demande quelles langues le détecteur doit reconnaître, acceptant * (la valeur par défaut) pour chaque langue prise en charge par le détecteur et rejetant tout code non pris en charge sur-le-champ (plutôt qu’à la seule validation finale). Seule une langue détectée peut ensuite être autorisée ou bloquée, de sorte que lorsque le blocage est activé, il demande ensuite une unique politique de langue combinée dans une syntaxe +allow/-block. Par exemple, +en +fr -ja -zh autorise l’anglais et le français tout en bloquant le japonais et le chinois, et un unique joker -* (ou +*) couvre toute autre langue détectée (ainsi +en +fr -* n’autorise que l’anglais et le français). Le littéral none peut être listé pour décider du sort du courrier non détecté. Cette unique réponse est scindée en les options WHITELIST et BLACKLIST de l’étape. Il demande ensuite s’il faut demander aux expéditeurs inconnus de confirmer par une réponse (SECRETARY, pepsi-stage-secretary(1), par défaut non), puis interroge sur le paywall anti-spam GNU Taler (qui active aussi la liste blanche de correspondants afin que les contacts connus sautent la demande de paiement). Lorsque le paywall est activé, l’assistant demande d’abord l”URL du backend marchand et la vérifie immédiatement par HTTP (GET /config doit identifier un backend taler-merchant), en relisant les devises que le backend prend en charge. Le prix doit être libellé dans l’une d’elles, donc l’URL doit être connue avant que le prix soit demandé. Il demande ensuite l”identifiant d’accès : soit un jeton d’accès prêt à l’emploi (reconnu à son préfixe secret-token: et vérifié auprès du backend) soit le mot de passe de l’instance, que l’assistant échange contre un jeton d’accès à portée limitée via POST /private/token (demandant la portée all afin que le jeton puisse aussi gérer le webhook pepsi-resume). Enfin, il demande le prix par message sous forme d’une liste de montants Taler séparés par des espaces (par exemple EUR:1 CHF:1 KUDOS:10), validés par rapport aux devises du backend ; chaque montant devient un choix dans la commande v1 générée ORDER_CHOICES, laissant le payeur choisir une devise. Lorsque le paywall et la confirmation d’envoi sont tous deux désactivés, et que l’hôte a aussi un chemin sortant, l’assistant demande à la place s’il faut simplement apprendre une liste blanche de correspondants depuis le courrier sortant.
Sur le chemin sortant, une étape de libre-service pose ensuite jusqu’à deux questions oui/non indépendantes, toutes deux valant non par défaut. La première demande si les titulaires de comptes peuvent modifier par e-mail leurs propres paramètres par adresse (pepsi-stage-edit-settings(1)) ; elle n’est posée que sur un hôte servant les deux directions, car chaque étape qu’un titulaire de compte peut modifier est une étape entrante. La seconde demande s’ils peuvent opérer par e-mail leur propre portefeuille GNU Taler (solde, rechargement et paiements de pair à pair), servi par le même pepsi-stage-auto-pay(1) qui règle les demandes de paiement entrantes.
La dernière étape, posée quelle que soit la direction choisie, est la cryptographie de bout en bout (par défaut non) : la question de savoir si cette passerelle doit chiffrer et déchiffrer le courrier elle-même (OpenPGP et S/MIME), de sorte que les utilisateurs n’aient besoin d’aucun greffon client. Répondre oui place pepsi-stage-encrypt(1) et pepsi-stage-decrypt(1) dans le pipeline ; rien n’est chiffré tant que la clé d’un destinataire n’est pas connue, et les clés proviennent de la découverte (pepsi-keydisc(1)), de pepsi-keys(1), ou du courrier que les correspondants nous envoient. Sur le chemin entrant, il demande ensuite s’il faut apprendre les clés des correspondants depuis ce courrier (Autocrypt, par défaut oui), ce qui ajoute pepsi-stage-autocrypt-learn(1), et s’il faut rechiffrer ce que la passerelle a déchiffré vers la propre clé de client de messagerie de l’utilisateur avant de le classer (REENCRYPT, par défaut oui), ce qui ajoute pepsi-stage-reencrypt(1) devant la remise locale. Sur le chemin sortant, il demande s’il faut activer le chiffrement automatique à la manière de pEp (PEP, par défaut oui) : chaque expéditeur d’un domaine servi reçoit une clé OpenPGP à son premier message, annoncée dans un en-tête Autocrypt:, et le courrier est signé à l’intérieur du chiffrement. Il énonce le coût avant de poser la question : la création anticipée de clés place dans la base de données une clé privée enveloppée pour quiconque envoie du courrier, et sa clé publique dans le Web Key Directory, qu’il utilise un jour le chiffrement ou non. Il écrit ensuite la réponse explicitement, ENABLE_PEP = yes ou ENABLE_PEP = no, dans [stage-encrypt] de pepsi.conf, où elle prend effet (aucun fichier config.d ne la définit). En cas d’acceptation, il demande s’il faut aussi joindre la clé de l’expéditeur sous forme de fichier (ATTACH_KEYS_AS_FILES, par défaut non), écrit seulement s’il est choisi. L’étape de chiffrement reçoit toujours RESPONSE_STAGE = dkim-sign, de sorte que les avis de clé enregistrée et les réponses aux commandes de clé par e-mail sont signés et relayés comme tout autre courrier sortant. Le questionnaire de configuration dans le navigateur pose les mêmes questions. Le magasin de clés, la découverte de clés et la clé de chiffrement de clés sont provisionnés par le reste de la configuration quelle que soit la réponse.
SRS est câblé automatiquement sur chaque chemin entrant, quelle que soit la destination du relais, avec un secret généré ; seul son SRS_DOMAIN est demandé, à la même étape que la question de signature du courrier réexpédié et sans valeur par défaut. Ce doit être un domaine dédié qui n’est pas aligné sur les domaines servis ; une réponse alignée n’est acceptée qu’après une seconde question, SRS_ALLOW_ALIGNED.
95.1.43.1.5.1. Filtres de courrier (milters) trouvés sur cet hôte¶
Sur un hôte qui reçoit du courrier, l’assistant le parcourt à la recherche de daemons milter et propose chacun de ceux qu’il trouve comme milter que pepsi-ingress(1) consulte pendant la session SMTP (une section [pepsi-ingress-milter-<label>], nommée dans [pepsi-ingress] MILTERS ; voir pepsi.conf(5)). Il n’en installe jamais un, et ne démarre ni ne confine le daemon : comme sous sendmail et Postfix, le filtre garde son propre paquet, son unité et son compte utilisateur, et Pepsi n’est qu’un client. Le balayage est sauté sur un hôte purement sortant, où aucune session ne reçoit de courrier de l’extérieur, et chaque filtre qu’il trouve est consulté pour le courrier arrivant aux écouteurs qui ne sont pas des écouteurs de soumission. Un filtre pour le courrier soumis se configure à la main ou, sur un hôte qui reçoit aussi, est repris d’un non_smtpd_milters importé sous forme d’étape pepsi-stage-milter(1) sur le chemin de soumission.
Sept filtres sont reconnus : milter-greylist, milter-regex, clamav-milter, spamass-milter, rspamd (à travers son worker milter rspamd_proxy), mimedefang et amavisd-milter.
Chacun est cherché en trois temps, et un filtre n’est proposé que lorsque les trois réussissent :
Installé — son binaire est sur
$PATHou dans les répertoiressbinhabituels, ou un fichier d’unité systemd existe pour lui.Écoute quelque part — une socket est lue depuis le fichier de configuration propre au filtre (le
MilterSocketdeclamav-milter.conf, lesocketdegreylist.conf, unSOCKET=ou un indicateur-pd’un fragment/etc/default, lebind_socketde Rspamd), puis depuis l”ExecStartde son unité, puis depuis les chemins que livre sa distribution.Répond — la configuration initiale mène à bien une véritable négociation d’options milter avec chaque socket candidate et prend la première qui réussit.
La poignée de main est ce qui rend l’offre digne de confiance : un paquet installé ne prouve rien d’un daemon arrêté, et une mauvaise supposition dans les listes de chemins ne coûte rien, car une socket qui ne répond pas n’est simplement jamais proposée. Elle règle aussi ce que le filtre a le droit de faire. ALLOW_ACTIONS doit accorder chaque action qu’un filtre demande, sinon la négociation échoue et le ON_FAILURE du filtre s’applique, et le filtre énonce cet ensemble pendant la négociation. La configuration initiale offre donc tout uniquement pour entendre la réponse, et écrit précisément ce qui a été demandé et rien de plus. Un filtre qui ne fait qu’inspecter se voit accorder none ; MIMEDefang se voit accorder les actions d’enveloppe exactement lorsque la politique Perl propre au site les emploie.
Les filtres acceptés sont énumérés dans [pepsi-ingress] MILTERS selon ce qu’ils font plutôt que dans l’ordre où ils ont été trouvés : politique et greylisting d’abord, puis analyse antivirus, puis évaluation du spam, puis les frameworks généralistes. Les filtres repris d’un import de MTA n’ont pas de fonction connue et viennent donc après tous ceux-ci, en conservant l’ordre relatif dans lequel ce MTA les exécutait. Le greylister propre à Pepsi, lorsque la réponse à GREYLIST est oui, passe avant tous les autres. Le libellé d’une section est le nom du filtre sans le préfixe milter- ([pepsi-ingress-milter-clamav]) ; milter-greylist garde le préfixe, parce que greylist est le libellé du greylister propre à Pepsi.
Un filtre dans la session répond lui-même au serveur expéditeur. Lorsqu’il refuse un destinataire ou un message, le client reçoit son 4xx ou son 5xx, comme sous un MTA, de sorte que rien ne doit faire l’objet d’un rebond après coup et qu’aucun backscatter ne se produit. Dès qu’un milter quelconque est consulté dans la session, l’assistant écrit aussi [stage-quarantine] (PROGRAM = pepsi-stage-quarantine, RELEASE_STAGE = init) : pepsi-ingress ne propose l’action de quarantaine à un filtre que lorsqu’une telle étape existe, et y stocke un message mis en quarantaine jusqu’à sa libération. Le message n’est passé par aucune étape lorsqu’il est stocké, de sorte qu’à sa libération il commence à la première étape du pipeline.
Avec –expert, ou lorsqu’une exécution précédente l’a choisie, la question de chaque filtre a une troisième réponse, after-decrypt. Elle place le filtre sous forme d’étape pepsi-stage-milter après [stage-decrypt] (de sorte que le filtre voit le texte en clair) et avant les étapes de whitelist, de paywall et d’Autocrypt (de sorte que celles-ci puissent brancher sur ce que le filtre a marqué). Une telle étape s’exécute après que pepsi-ingress a répondu 250 ; son courrier rejeté est donc abandonné plutôt que renvoyé en rebond : un rebond enverrait du backscatter à l’adresse que le spam falsifié a nommée. Son REJECT_STAGE pointe donc vers une [stage-discard-rejected] générée (un pepsi-stage-discard avec DISPOSITION = failure, BOUNCE = no) ; le verdict est toujours noté dans state.milter et dans le journal. Régler REJECT_STAGE = bounce rétablit la notification, et la section générée le dit. milter-greylist n’a pas une telle réponse, parce que le greylisting ne fonctionne qu’en refusant la remise pendant la session. Une étape reprise de non_smtpd_milters conserve REJECT_STAGE = bounce, puisque son expéditeur est un utilisateur local.
Les filtres dont Pepsi remplit déjà la fonction ne sont pas proposés : opendkim, openarc, opendmarc, les daemons de politique SPF et postsrsd. En exploiter un à côté de Pepsi signifie que deux composants signent ou jugent le même message. Ils ne sont pas sautés en silence : lorsqu’on en trouve un, le balayage le dit et nomme la fonctionnalité Pepsi qui le remplace, de sorte qu’un balayage n’ayant rien trouvé à proposer soit distinguable d’un balayage qui n’a pas eu lieu. La classification du spam n’est délibérément pas de cette catégorie : Pepsi a ses propres opinions sur le spam, mais ce sont des opinions différentes de celles d’un classificateur bayésien, et un opérateur peut raisonnablement vouloir les deux.
Chaque réponse est mémorisée sous sa propre clé MILTER_* (MILTER_CLAMAV, MILTER_RSPAMD, …) dans [pepsi-wizard], sous la forme yes, no ou after-decrypt. Seuls les filtres que cette exécution a réellement trouvés y sont écrits ; une réexécution rebalaie.
Après le balayage, l’assistant pose la question GREYLIST : faut-il pratiquer le greylisting avec le milter de greylisting propre à Pepsi, pepsi-greylist ? La réponse par défaut est non, parce que le greylisting retarde le premier message de chaque nouveau correspondant d’au moins cinq minutes, plus précisément d’autant que le serveur expéditeur attend avant de réessayer. Oui écrit [pepsi-ingress-milter-greylist] avec SOCKET = unix:/run/pepsi-greylist/milter.sock, ALLOW_ACTIONS = none et ON_FAILURE = accept, en première position dans [pepsi-ingress] MILTERS. run active et démarre ensuite pepsi-greylist.service (la tâche launchd sous macOS) lorsqu’une section de milter nomme la socket du greylister ; il ne désactive jamais le service.
La configuration générée est validée à travers exactement les mêmes vérifications que run avant d’être écrite, de sorte que l’assistant ne produit jamais un fichier qui échouerait plus tard à se charger. Si la validation échoue, l’assistant imprime l’erreur fautive et relance le questionnaire avec vos réponses précédentes pré-remplies comme valeurs par défaut, de sorte que vous puissiez corriger la ou les options cassées sans tout ressaisir. Les réponses du questionnaire sont enregistrées dans une section [pepsi-wizard] à la fin du fichier, et relancer –wizard les importe comme les nouvelles valeurs par défaut. Les secrets (le mot de passe du smarthost, le jeton d’accès marchand et la clé SRS générée) n’y sont pas stockés.
Parce que la configuration principale est écrite lisible par tous (mode 0644, afin que les comptes d’étape non privilégiés puissent la lire), l’assistant n’y laisse pas de secrets. Chaque secret qu’il écrirait autrement en ligne est déplacé dans un fragment restreint secrets.d/*.secret à côté de la configuration et référencé depuis celle-ci avec une directive @inline-secret@ (voir pepsi.conf(5)). Ces secrets sont le SECRET SRS, les PASSWORDs smarthost/LMTP, le MERCHANT_ACCESS_TOKEN marchand et le RESUME_AUTHORIZATION_TOKEN de pepsi-httpd. Ceux qui sont générés (la clé SRS, le jeton /resume) sont relus depuis le fragment existant et réutilisés, de sorte que relancer l’assistant ne les renouvelle jamais silencieusement (ce qui invaliderait les expéditeurs SRS déjà en transit ou le webhook de paiement déployé).
Un identifiant secret ajouté à la main dans le fichier est déplacé par run, avant qu’il ne sécurise les fragments : chaque option que l’assistant externaliserait, ainsi que [pepsi-keydiscovery] LDAP_BIND_PASSWORD (vers secrets.d/pepsi-keydisc.secret), [pepsi-list] API_PASS (vers secrets.d/pepsi-list.secret), [pepsi-dkim] TSIG_SECRET (vers secrets.d/pepsi-dkim.secret) et les CLIENT_ID, CLIENT_SECRET et REFRESH_TOKEN OAuth d’une section [pepsi-helper-token-refresh-<name>] (vers secrets.d/pepsi-helper-token-refresh.secret). La valeur est fusionnée dans le fragment, en gardant les secrets qui s’y trouvent déjà, et la ligne du fichier principal est remplacée par une directive @inline-secret@ à la fin de sa section. Une option dont le nom dit qu’il s’agit d’un mot de passe, d’un secret ou d’un jeton mais dont Pepsi ne connaît pas le lecteur (une option qu’aucun programme Pepsi ne définit) reste là où elle a été écrite, et run avertit à son sujet à chaque exécution, en nommant la section et l’option : déplacez la valeur dans un fichier que seul son lecteur peut lire et incorporez-la avec une directive @inline-secret@. Une option nommant un fichier (SECRET_FILE, TOKEN_FILE) est un chemin, non un identifiant secret, et est laissée telle quelle.
95.1.43.1.5.2. Invites de secret¶
Les secrets que vous saisissez (les mots de passe smarthost et LMTP, le jeton d’accès marchand) ne sont jamais affichés en écho ni écrits dans [pepsi-wizard]. Lors d’une réexécution, ils sont relus depuis leur fragment secrets.d, de sorte que l’invite affiche [***] et qu”Entrée conserve le secret stocké
Smarthost password [***]:
Trois réponses sont possibles :
- Entrée
Conserver ce qui est stocké. Lorsque le fragment existe mais que ce processus n’a pas le droit de le lire (il appartient au compte de service et l’assistant s’exécute sans privilèges), le fragment est laissé complètement intact et la configuration continue de pointer dessus ; le secret est préservé sans que l’assistant ne le voie jamais.
- une valeur
Remplacer le secret stocké par ce que vous avez saisi.
- Entrée deux fois
Laisser le secret non défini pour l’instant. Ceci n’est proposé que lorsque rien n’est stocké et seulement sur un terminal ; l’assistant écrit alors la configuration sans cette option, imprime la section, l’option et le fichier auxquels l’ajouter, et laisse dans le fragment une ligne commentée la nommant. Les services ne fonctionneront pas tant que vous ne l’aurez pas renseignée et exécuté
pepsi-setup run.
Pour un smarthost qui s’authentifie, l’assistant propose ensuite de vérifier les identifiants en ouvrant une session vers le relais et en s’authentifiant, exactement comme le fait une remise, mais sans le message. Un mot de passe mal saisi apparaît alors pendant que vous êtes encore là pour le corriger, plutôt que sous la forme d’un courrier qui cesse discrètement de circuler
Check these credentials against smtp.relay.example:587 now [Y/n]:
Si le relais les refuse, l’assistant propose de reprendre le mot de passe ; s’il ne peut pas être atteint du tout (pare-feu, DNS, hôte hors service), il le dit et ne vous pousse pas à retaper un mot de passe qui est peut-être parfaitement bon. La vérification est entièrement sautée lorsque stdin n’est pas un terminal : une exécution sans surveillance ne doit pas dépendre de la disponibilité du réseau.
Chaque directive est écrite après la dernière option de la section qu’elle alimente, car une directive termine sa section pour l’analyseur (voir pepsi.conf(5)). Les fragments sont sécurisés (mode et propriété) dès leur écriture et de nouveau par run ; voir la commande run ci-dessous. L’assistant recharge ensuite le fichier qu’il vient d’écrire et valide celui-ci, de sorte qu’une configuration qu’il ne peut lui-même analyser n’est jamais laissée derrière. Après l’écriture, l’assistant propose d’exécuter la configuration complète (run) immédiatement.
Si le fichier cible existe déjà et contient une section [pepsi-wizard], ses réponses sont importées comme valeurs par défaut. S’il existe sans une, l’assistant avertit qu’il ne peut importer les réponses précédentes et demande confirmation avant d’écraser ; –force écrase sans demander.
Note
Le paywall anti-spam exige que ses modèles de message (par exemple payment-request.en.body) soient installés sous [pepsi] TEMPLATE_DIR (par défaut ${DATADIR}/templates, c’est-à-dire /usr/share/pepsi/templates pour une installation avec --prefix=/usr) ; make install les y place. Comme l’assistant valide au regard de l’environnement en service, activer le paywall avant que les modèles ne soient installés rapporte une erreur claire plutôt que d’écrire une configuration qui échouerait à l’exécution.
95.1.43.1.5.3. Répondre sans terminal¶
–answers FILE exécute tout le questionnaire à partir d’un objet JSON associant un identifiant de question à une valeur, sans rien demander. Ce n’est pas une seconde implémentation de l’assistant : le même interview() s’exécute, chaque invite étant court-circuitée vers la réponse fournie (ou, à défaut, vers la valeur par défaut propre à l’assistant, exactement comme appuyer sur Entrée). La structure des branches, la validation par champ et le rendu sont donc ceux de l’interactif.
Les identifiants sont ce qu’imprime pepsi-setup questions, et ce sont les mêmes clés que la section [pepsi-wizard] générée fait circuler dans les deux sens, de sorte qu’une configuration écrite par une exécution antérieure est elle-même un fichier de réponses valide une fois cette section transformée en JSON. Les options expertes (–expert, et ce qu’une migration de MTA a trouvé) partagent cet espace de noms et sont acceptées ici aussi, validées par la même vérification qu’applique l’invite --expert. Le questionnaire du navigateur les refuse délibérément, puisqu’une option que rien ne demande n’est pas une option qu’un formulaire web devrait fixer. Un identifiant inconnu est une erreur nommant la clé plutôt qu’une ligne silencieusement abandonnée, car une réponse discrètement ignorée ressemble exactement à une réponse acceptée et sans effet.
Des secrets peuvent apparaître dans le fichier (SMARTHOST_PASSWORD, LMTP_PASSWORD, MERCHANT_ACCESS_TOKEN) ; ils sont déplacés dans des fragments secrets.d comme tout autre, de sorte que le fichier lui-même doit être traité comme un identifiant et supprimé ensuite. Un secret déjà stocké dans un fragment est reporté lorsque le fichier de réponses ne le mentionne pas, ce qui rend non destructrice une réexécution scriptée.
Exemple
cat > answers.json <<'EOF'
{
"DIRECTION": "both",
"HOSTNAME": "mx.example.com",
"DOMAINS": "example.com",
"POSTMASTER": "postmaster@example.com",
"PUBLIC_IPS": "203.0.113.7",
"LOCAL_METHODS": "maildir",
"MTA_STS": "yes"
}
EOF
pepsi-setup --wizard --answers answers.json -c /etc/pepsi/pepsi.conf
95.1.43.1.6. Migrer depuis un autre MTA¶
Personne n’installe un serveur de courrier sur une machine vide. Lorsque –wizard ne trouve aucune configuration au chemin cible, il cherche le serveur de courrier que l’hôte fait tourner aujourd’hui (Postfix, Exim, Sendmail, qmail ou Stalwart) et propose d’importer ses réglages comme valeurs par défaut des réponses du questionnaire. Si plusieurs sont configurés, il présente un menu numéroté ; –import MTA en choisit un sans demander et –no-import saute entièrement la recherche. L’autodétection est sautée lorsque stdin n’est pas un terminal, de sorte qu’une exécution scriptée de –wizard continue de produire la configuration que ses réponses décrivent plutôt qu’une configuration façonnée par ce qui traînait sur la machine.
Quel que soit le serveur importé, le domaine SRS dans lequel un postsrsd installé à côté réécrit les expéditeurs réexpédiés (SRS_DOMAIN= dans /etc/default/postsrsd, ou srs-domain dans /etc/postsrsd.conf) devient la valeur par défaut de la question SRS_DOMAIN : chaque rebond du courrier réexpédié avant la migration lui est adressé, et la question n’a pas d’autre valeur par défaut. Si ce domaine est aligné sur un domaine servi, la question explique pourquoi et en demande un autre ; une exécution sans terminal pour poser la question s’arrête avec cette explication.
Rien n’est importé silencieusement. Chaque valeur importée devient la valeur [default] de sa question, que l’opérateur confirme ou corrige, et tout ce qui n’a pas pu être repris est rassemblé dans un rapport de migration écrit à côté de la configuration sous le nom import-report.txt (également imprimé sous forme de résumé d’une ligne avant le début du questionnaire). Le rapport regroupe ses constats en quatre catégories :
FAILEDUn fichier n’a pas pu être lu ou analysé ; rien n’en a été importé.
UNSUPPORTEDCompris, mais Pepsi n’a pas d’équivalent, comme pour une table
header_checksou un alias remettant à une commande. L’entrée nomme ce que Pepsi propose à la place, lorsque quelque chose existe. Un réseau de confiance de l’ancien serveur hors du loopback est aussi rapporté ici, une entrée par réseau, plutôt que reporté dansMYNETWORKS: Pepsi ne fait confiance à un réseau que dans la mesure où[pepsi-ingress] SENDER_MAPle lie, et pepsi-ingress refuse de démarrer sur un réseau non lié ; l’opérateur ajoute donc le réseau et sa liaison à la main.APPROXIMATEDImporté avec une sémantique différente, par exemple une remise mbox devenant Maildir, un
maximal_queue_lifetimearrondi à des heures entières, un réseau loopback retiré deMYNETWORKS.UNKNOWNUne directive que l’importateur ne reconnaît pas, et qu’il n’a donc pas migrée. Signalée afin qu’un réglage non reconnu soit visible plutôt qu’invisible.
Un import ne peut jamais faire échouer l’exécution : un fichier illisible, une ligne corrompue ou une directive issue d’un fork dont personne n’a entendu parler produit un avertissement, et le reste de la configuration est tout de même importé.
95.1.43.1.6.1. Milters¶
Les milters que Postfix ou Sendmail consultait pour le courrier arrivant par SMTP sont repris comme milters que pepsi-ingress consulte pendant la session SMTP, dans le même ordre, de sorte qu’un filtre qui refusait du courrier répond toujours au serveur expéditeur. L’assistant demande une fois s’il faut les reprendre (MILTERS_ENABLED), négocie avec chacun pour savoir de quelles actions il a besoin, et écrit sa section [pepsi-ingress-milter-<label>] (voir le balayage des milters ci-dessus pour les libellés et l’ordre). Chaque option que l’ancien MTA définissait pour ses milters s’applique à chacun d’eux :
Postfix |
Pepsi |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
une étape |
INPUT_MAIL_FILTER et MAIL_FILTER de Sendmail définissent les filtres, et confINPUT_MAIL_FILTERS (que chaque INPUT_MAIL_FILTER étend) décide lesquels s’exécutent et dans quel ordre ; un filtre défini mais non listé est signalé et non repris. S= est le SOCKET, repris tel quel ; F=T devient ON_FAILURE = tempfail, F=R reject, et l’absence d’indicateur accept ; T=C:…;S:…;R:…;E:… devient CONNECT_TIMEOUT, la plus grande des valeurs S et R COMMAND_TIMEOUT, et E CONTENT_TIMEOUT. Les définitions confMILTER_MACROS_* deviennent les options MACROS_* (ENVFROM est MACROS_MAIL, ENVRCPT MACROS_RCPT).
Un milter repris ne donne lieu à aucune entrée du rapport, puisque rien n’a changé à son sujet. Les cas suivants en donnent une, en APPROXIMATED : milter_default_action = quarantine, qui retenait le message dans la file « hold » de Postfix et devient tempfail ; une liste de macros qui étend la valeur par défaut intégrée du MTA, laissée à la valeur par défaut de Pepsi pour cette phase ; un chemin de socket relatif, que Postfix résolvait dans son chroot ; et chaque filtre non_smtpd_milters. La socket de soumission locale de Pepsi est servie sans section d’écouteur, de sorte qu’il n’existe aucun endroit où nommer un milter de session pour elle, et un tel filtre devient une étape pepsi-stage-milter immédiatement avant la signature DKIM. Cette étape s’exécute après l’acceptation du message, de sorte qu’un refus devient un rebond vers l’expéditeur local.
95.1.43.1.6.2. Tables de routage¶
/etc/aliases, /etc/postfix/virtual, la virtusertable de Sendmail, les fichiers .qmail-* de qmail et leurs équivalents sont convertis en une table d’alias Pepsi (voir pepsi-stage-aliases(1)) écrite à côté de la configuration sous le nom aliases, et une table d’identité de soumission (les smtpd_sender_login_maps de Postfix et consorts) en username.map (voir USERNAME_MAP dans pepsi-ingress(1)). Un fichier existant n’est jamais écrasé : la table convertie atterrit à la place dans aliases.imported, à charge pour l’opérateur de la fusionner.
Les clés d’alias Pepsi portent un domaine (local@domain, @domain ou un glob *), alors que les clés de /etc/aliases sont de simples local-parts ; l’assistant demande donc comment les qualifier (–alias-style pour la commande import) :
per-domainUne ligne par alias et par domaine accepté — exact, et la valeur par défaut.
wildcardUne ligne par alias avec un glob de domaine (
postmaster@*) — compact, mais cela correspond aussi aux domaines ajoutés plus tard.primaryQualifier uniquement avec le premier domaine accepté ; les autres sont signalés comme non aliasés.
Les entrées que Pepsi ne peut pas exprimer sont écrites dans la table convertie sous forme de commentaires inertes # UNCONVERTED à côté d’une entrée de rapport expliquant pourquoi, de sorte que rien ne disparaisse sans laisser de trace. Ces entrées sont une remise vers une commande (|/usr/bin/…), une remise vers un fichier, ou un :include: illisible. La table générée est vérifiée avec la même vérification syntaxique stricte que run applique à une table écrite à la main.
95.1.43.1.6.3. Couverture par serveur¶
- Postfix
/etc/postfix/main.cf(avec l’interpolation$parameteret les lignes de continuation) etmaster.cf. L’identité provient demyhostname/mydomain, les domaines acceptés demydestination,virtual_alias_domains,virtual_mailbox_domainsetrelay_domains; le smarthost derelayhost, avec son transport depuissmtp_tls_security_level/smtp_tls_wrappermodeet ses identifiants depuissmtp_sasl_password_maps. La remise locale est lue depuishome_mailbox,mailbox_transport/virtual_transport(une ciblelmtp:unix:devient l’étape LMTP de Pepsi) etmail_spool_directory; le SASL de soumission depuissmtpd_sasl_type = dovecotetsmtpd_sasl_path; les services activés dansmaster.cfdécident de la direction.alias_maps/alias_databaseetvirtual_alias_mapsdeviennent la table d’alias (les entrées virtuelles l’emportent, comme dans Postfix), etsmtpd_sender_login_mapsdevientusername.map, inversé vers la forme de Pepsi indexée par login.message_size_limit,recipient_delimiter,maximal_queue_lifetime,smtp_helo_nameet les chemins de certificatsmtpd_tls_*arrivent comme options expertes ;mynetworksest rapporté, réseau par réseau, pour une liaisonSENDER_MAP(voirUNSUPPORTEDci-dessus).Signalés plutôt que migrés :
header_checks/body_checks,transport_maps, la réécriture canonique,smtpd_*_restrictions,postscreen_*,content_filter, la remise en boîte aux lettres virtuelle, les redéfinitions-opar service dansmaster.cf, et les types de table que rien ne peut lire comme du texte (regexp:,pcre:,mysql:,ldap:, …). Environ quatre-vingt-dix paramètres qui décrivent l’installation ou le réglage propres à Postfix sont ignorés silencieusement ; tout le reste est listé comme non reconnu.- Exim
Le fichier de réponses de Debian
/etc/exim4/update-exim4.conf.confest la source la plus riche et la plus fiable, et il a la priorité :dc_eximconfig_configtypedonne la direction et l’existence ou non d’un smarthost,dc_other_hostnamesles domaines,dc_smarthostle relais,dc_relay_netsles réseaux de confiance (rapportés pour une liaisonSENDER_MAP, non reportés) etdc_localdeliveryle format de boîte aux lettres. La section principale deexim4.conf.template/exim.conf/conf.d/main/*(tout ce qui précède le premierbegin) ajouteprimary_hostname,qualify_domain,domainlist local_domains,hostlist relay_from_hosts,message_size_limit,smtp_accept_maxet la pairetls_certificate. La syntaxe de liste d’Exim est traitée correctement : séparateurs doublés, redéfinitions<;,.include, références+named, et.ifdefévalué en fonction des macros réellement définies./etc/aliasesdevient la table d’alias,/etc/email-addressesla table d’identité de soumission, et/etc/exim4/passwd.clientles identifiants du smarthost.Les routers, transports, ACL, règles de réécriture, authentificateurs et règles de réessai d’Exim sont un langage de programmation, et une analyse partielle de l’un d’eux produit une migration plausible mais fausse. Ils ne sont donc pas interprétés du tout : chaque bloc
beginest signalé une fois, en nommant ce qui le remplace dans Pepsi (le graphe d’étapes pour les routers et les transports, lesMYNETWORKS/SASL d’écouteur plus les étapes de liste blanche et d’anti-spam pour les ACL, SRS et la table d’alias pour la réécriture). Deux conséquences : parce que l’échelle de réessai réside dansbegin retry,MAX_LIFETIMEn’est jamais deviné, et parce que le transport porte la politique TLS et AUTH, la sécurité de transport du smarthost est supposée plutôt que lue. Untls_certificatecontenant une expansion$est un calcul, pas un chemin, et il est signalé au lieu d’être importé.- Sendmail
/etc/mail/sendmail.mc, la source m4 qu’un administrateur édite réellement, est préférée ;sendmail.cfest utilisé lorsqu’aucun.mcn’existe, et alors seulement ses lignes lisibles de façon fiable (Djle nom canonique,DSle smart host,Cw/Fwles noms d’hôte locaux,DZla version et les optionsO). Les jeux de règles générés ne sont jamais interprétés, et le rapport le dit. Depuis le.mc:SMART_HOST(avec son préfixe de mailer, son port et ses crochets),confDOMAIN_NAME,confMAX_MESSAGE_SIZE,confTO_QUEUERETURN,confMAX_DAEMON_CHILDREN,confSERVER_CERT/confSERVER_KEY,ALIAS_FILE,DAEMON_OPTIONS(quels ports étaient servis, donc la direction) et lesFEATUREs qui comptent (use_cw_file,virtusertable,authinfo,local_lmtp,plussed_users,local_procmail,nullclient). Les tableslocal-host-names,virtusertable,aliasesetauthinfo(les identifiants du smarthost, avec le mécanisme issu de son champM:) sont lues ;postmasterest résolu à travers la chaîne d’alias vers une adresse réelle.Signalés plutôt que migrés :
MASQUERADE_ASet consorts (Pepsi réécrit plutôt les expéditeurs avec SRS),access_db,mailertable,domaintable,genericstable,LOCAL_RULE_*/LOCAL_CONFIG/HACK, les fonctionnalités DNSBL et greet-pause, les mailers locauxsmrsh/procmail, et les membres de droite devirtusertableque Pepsi ne peut exprimer (error:,%1).- qmail
Le répertoire de contrôle (
/var/qmail/control,/etc/qmailou/usr/local/etc/qmail) est énuméré, et non sondé par nom, de sorte que chaque fichier de contrôle est soit consommé, soit ignoré silencieusement comme non pertinent, soit signalé, y compris ceux issus d’un fork dont cet importateur n’a jamais entendu parler.medonne le nom d’hôte ;locals,rcpthosts,morercpthostsetvirtualdomainsles domaines ; l’attrape-tout:relay:portdanssmtproutesle smarthost (avec les identifiants lorsque la forme étendue des patchs AUTH est utilisée) ;defaultdelivery(ou l’argumentqmail-startdansrc) le format de boîte aux lettres ;databytes,queuelifetime,helohostet unservercert.pemles options expertes.La table d’alias est constituée des fichiers
.qmail-*du répertoire d’alias de qmail :.qmail-foo-bardevientfoo-bar,:se redécode en.,.qmail-defaultdevient un attrape-tout et.qmail-foo-defaultun glob. Leur contenu passe tel quel comme cibles, de sorte qu’une|command, un chemin de fichier ou un./Maildir/relatif est expliqué dans le rapport plutôt que transformé en une adresse absurde. Les fichiers~/.qmailpar utilisateur ne sont délibérément pas parcourus (coûteux et sensibles pour la vie privée ;pepsi-stage-dot-forwardest l’équivalent à l’exécution), et aucun.cdbn’est jamais ouvert ; le texteusers/assignest lu à la place.badmailfrom/badrcptto,spfbehavior,percenthack,qmqpserversettlsclientssont signalés avec leurs contreparties Pepsi.- Stalwart
config.tomlsous/opt/stalwart-mail/etc,/opt/stalwart/etc,/etc/stalwartou/etc/stalwart-mail(un répertoire de fragments.tomlest lu aussi, et les directives!includesont suivies).server.hostnameet les portsserver.listener.*donnent l’identité et la direction,queue.outbound.next-hop/queue.strategy.routeet la tableremote.*le smarthost (un sautprotocol = "lmtp"devient plutôt une remise LMTP locale),certificate.*les chemins TLS,session.data.limits.sizeet l’expiration de la file d’attente les options expertes. Undirectoryde typememory(ou un tableauprincipals) fournit des comptes : chaque adresse supplémentaire devient un alias vers l’adresse principale du compte, et les logins deviennentusername.map. Les secrets écrits sous la forme%{file:…}%sont résolus ;%{env:…}%ne peut pas l’être et est signalé.Les expressions propres à Stalwart (
[{if = …}, {else = …}]) ne sont jamais évaluées : seule une valeur simple est honorée, et tout le reste est signalé plutôt que deviné. Le cas important à connaître : les versions récentes de Stalwart conservent la configuration opérationnelle dans leur magasin de données, pas dans le TOML. Lorsque le fichier ressemble à une amorce de démarrage, le rapport le dit clairement, nomme le magasin, et vous indique d’exporter la configuration depuis l’interface d’administration de Stalwart, car il n’y a rien sur disque que Pepsi puisse lire. Les réglages IMAP, JMAP, POP3, ManageSieve, Sieve, de filtrage anti-spam et de rapport sont signalés comme non pris en charge, avec un pointeur vers l’équivalent Pepsi (ou Dovecot).
95.1.43.1.6.4. Identifiants¶
Les identifiants de relais smarthost sont lus depuis le propre fichier de mots de passe du MTA source (les smtp_sasl_password_maps de Postfix, le passwd.client d’Exim, l”authinfo de Sendmail, le TOML de Stalwart) afin que l’opérateur n’ait pas à retrouver un mot de passe qu’il ne possède peut-être plus. Le rapport nomme toujours le fichier d’où un secret a été lu. Les mots de passe importés suivent le même chemin que ceux saisis : l’assistant les sort de la configuration lisible par tous vers des fragments secrets.d/*.secret référencés avec @inline-secret@.
95.1.43.1.6.5. Ce qui n’est pas migré¶
Le courrier déjà en file d’attente dans l’ancien serveur n’est pas migré ; laissez la file se vider, ou videz-la, avant de basculer le MX. Les clés DKIM ne sont pas migrées non plus ; pepsi-dkim(1) en crée de nouvelles lorsque run lui remet les domaines, et run imprime les enregistrements DNS à publier. Si l’ancien MTA écoute encore sur le port 25 lorsque l’assistant s’exécute, le rapport le dit : pepsi-ingress ne peut pas lier le port tant qu’il n’est pas arrêté et désactivé.
95.1.43.1.7. Options expertes¶
Entre les questions que le questionnaire pose et l’ensemble complet des options de pepsi.conf(5), il existe un palier d’options Pepsi ordinaires auxquelles personne ne devrait avoir à répondre pour obtenir un serveur fonctionnel : la limite de taille des messages, le délimiteur de destinataire, les réseaux de confiance, la durée de vie en file d’attente, le sélecteur DKIM.
–expert SPEC fait poser ces questions par l’assistant, dans une dernière étape du questionnaire. SPEC est une liste, séparée par des virgules ou des espaces, de mots de groupe et/ou de noms d’options :
highLes options qu’un administrateur règle plausiblement :
MAX_MESSAGE_SIZE,MYNETWORKS,RECIPIENT_DELIMITER,MAX_LIFETIME,DMARC_ENFORCE,IP_BLOCKLISTSetMAILBOX_QUOTA(délibérément dans ce groupe plutôt que dansinsane: un site qui remet localement voudra un quota par défaut et ne devrait pas avoir à connaître le nom de l’option).insaneTout ce qui figure dans le registre, en ajoutant
HELO_NAME,TLS_CERT,TLS_KEY,DNS_TIMEOUT,MAX_CONNECTIONS,MAX_OPEN_SOCKETS,DKIM_SELECTOR,KEY_DIR,MAILBOX_OVER_QUOTAetCRYPTO_ALLOW_DOWNGRADE.- Un nom d’option
Poser la question exactement pour celle-ci, quel que soit son groupe :
--expert=MAX_MESSAGE_SIZE,RECIPIENT_DELIMITER. Se combine avec un mot de groupe :--expert=high,DKIM_SELECTOR.
all est accepté comme synonyme d”insane, et none (ou off) annule un mot de groupe donné plus tôt dans le même SPEC. Un sélecteur non reconnu est une erreur qui énumère les noms valides, et non une sélection silencieusement vide.
--expert=help imprime la liste et quitte.
Chaque option est émise dans la section qui la lit réellement et est enregistrée dans [pepsi-wizard], afin qu’une réexécution ultérieure la conserve. MYNETWORKS va sur l’écouteur du port 25 (jamais sur un écouteur de soumission), MAX_MESSAGE_SIZE sur [pepsi-ingress], et HELO_NAME sur la route du smarthost ([pepsi-stage-relay-to-smarthost-mta-smarthost]). Laisser une réponse vide supprime l’option et restaure la valeur par défaut propre à Pepsi.
IP_BLOCKLISTS nomme les listes de blocage d’IP livrées par rapport auxquelles le courrier entrant est vérifié (spamhaus-drop-v4, spamhaus-drop-v6, blocklist-de-mail, uceprotect-1 ; none pour aucune) et écrit ENABLED = yes ou no dans chaque section [pepsi-reputation-list-NAME] ; voir pepsi-reputation(1). Une liste récupérée par rsync (uceprotect-1) est refusée tant que le programme rsync n’est pas installé. Sans réponse, les valeurs par défaut livrées dans config.d s’appliquent. Indépendamment de l’assistant, pepsi-setup run avertit au sujet de toute liste rsync activée sur un hôte sans rsync et supprime ses entrées, afin que l’ingress cesse de consulter une liste qui ne peut plus être rafraîchie.
RECIPIENT_DELIMITER est celle qui mérite d’être détaillée : elle est écrite dans la section globale [pepsi] plutôt que sur les étapes de remise locale, parce que pepsi-ingress (qui n’a pas de section d’étape à lui) doit lire la même valeur pour décider à quelle boîte aux lettres se rapporte le quota d’un destinataire en sous-adressage, et parce que l’analyseur Locality propre aux étapes se rabat sur [pepsi]. MAILBOX_QUOTA, MAILBOX_OVER_QUOTA et CRYPTO_ALLOW_DOWNGRADE y atterrissent également.
–expert ne contrôle que les options qui font l’objet d’une question. Une valeur trouvée par un import de MTA est appliquée qu’elle ait été demandée ou non : si Pepsi a l’option, un réglage migré n’est jamais abandonné faute de question.
95.1.43.1.8. Commandes¶
- import [MTA] [–root DIR] [–out DIR] [–alias-style STYLE]
Signaler ce qui serait migré depuis un MTA existant, sans rien écrire. Sans MTA, celui qui est installé est détecté (et, s’il y en a plusieurs, ils sont listés et il faut en nommer un). La sortie est le même rapport de migration que celui qu’écrit –wizard, plus la table d’alias qui serait générée et les réponses de l’assistant que l’import pré-remplirait ; les secrets sont montrés sous forme de marqueur, jamais imprimés.
Cette commande n’a besoin d’aucune configuration Pepsi : elle est destinée à être exécutée avant qu’il y en ait une, pour voir ce que produirait une migration.
- –root DIR
Lire la configuration du MTA sous DIR au lieu de
/. Utile pour inspecter une sauvegarde ou le/etcd’une autre machine copié en place.- –out DIR
Écrire le rapport et les fichiers de table convertis dans DIR (un fichier existant est dévié vers
<name>.importedplutôt qu’écrasé).- –alias-style STYLE
Comment les noms d’alias nus sont qualifiés :
per-domain(par défaut),wildcardouprimary; voir Migrer depuis un autre MTA.
- run [-r | –reset]
Effectuer la configuration complète (valider, provisionner les certificats TLS, installer le schéma, faire créer les clés DKIM par pepsi-dkim, imprimer les enregistrements DNS). C’est aussi l’action par défaut lorsqu’aucune sous-commande n’est donnée. Elle provisionne aussi le secret de preuve d’origine dès lors que
[pepsi-origin]n’a niSECRETniSECRET_FILEet n’est pas désactivée parENABLED = no; la preuve d’origine est activée par défaut, la section n’a donc pas besoin d’être présente. Un secret aléatoire est écrit dans un fragmentsecrets.d/pepsi-origin.secret(possédé par le comptepepsi, mode0640) et référencé depuis la configuration principale avec une directive@inline-secret@, ce qui le garde hors de ce fichier lisible par tous ; une réexécution réutilise le fragment existant plutôt que de renouveler la clé. Cette étape est sautée, avec un avertissement, lorsque[pepsi-ingress] HOSTNAMEn’est pas défini (le nom est lié dans le MACPepsi-Origin) ou lorsque le chemin du fichier de configuration à mettre à jour est inconnu.Selon le même principe, elle génère la clé de chiffrement de clés
[pepsi-crypto]lorsqu’il n’y en a aucune, mais seulement après l’installation du schéma, et seulement lorsque la base de données confirme qu’aucune clé privée enveloppée n’existe encore. Un fragment manquant à côté de clés stockées est une clé perdue, non une nouvelle installation, et en forger une neuve rendrait silencieusement toute clé privée stockée impossible à ouvrir. Aussi bien « des clés existent » que « je n’ai pas pu vérifier » se soldent donc par un refus explicite, qui nomme la restauration du fragment comme correctif.Avant toute autre chose, run sécurise tout fragment de secret à côté de la configuration, c’est-à-dire les fichiers
secrets.d/*.secretdans lesquels –wizard externalise les secrets (voir ci-dessous). Il donne à chacun le mode0640et le remet au compte qui doit le lire :secrets.d/pepsi.secret(mots de passe smarthost/LMTP, le jeton d’accès marchand) àpepsi,secrets.d/pepsi-httpd.secret(leRESUME_AUTHORIZATION_TOKEN) àpepsi-httpd,secrets.d/pepsi-ingress.secret(leSECRETSRS) àpepsi-ingress,secrets.d/pepsi-crypto.secret(leKEY_WRAP_SECRETde[pepsi-crypto], courant et retiré) àpepsi-crypto, etsecrets.d/pepsi-secure-link.secret(le[pepsi-secure-link] PEPPER) etsecrets.d/pepsi-list.secret(les[pepsi-list] UNSUBSCRIBE_SECRET,VERP_SECRETetAPI_PASS) àpepsi-httpdavec le groupepepsi(ces deux fragments ont deux lecteurs, puisque le portail sert ce que l’étape a scellé et que le point de terminaison web vérifie le jeton de désabonnement que l’étape de remise a calculé) ;secrets.d/pepsi-keydisc.secret(leLDAP_BIND_PASSWORDLDAP) àpepsi-keydisc,secrets.d/pepsi-helper-token-refresh.secret(les identifiants du client OAuth) àpepsi-helper-token-refresh, etsecrets.d/pepsi-dkim.secret(le[pepsi-dkim] TSIG_SECRET) àpepsi-dkim. Chaque fichier nommé par[pepsi-srs] PREVIOUS_SECRET_FILE(une clé SRS retirée) reçoit le propriétaire et le mode du fichier courant. Le secret SRS appartient àpepsi-ingressparce que l’ingress décode en sens inverse les adresses de retour SRS ; l”étape SRS s’exécute en tant quepepsiet le lit à travers le groupe partagépepsi-ingress(le paquet Debian fait depepsiun membre ; une installation depuis les sources doit arranger l’équivalent). Le secret d’enveloppement de clés est celui dont la perte est irrécupérable : il ouvre chaque clé privée stockée, sauvegardez-le donc séparément de la base (voir pepsi-keys(1)).C’est la première étape afin qu’une exécution qui s’arrête plus tard (sur un certificat qui ne peut être émis, ou sur une base de données injoignable) laisse tout de même chaque secret lisible par son service. Chaque fragment est ensuite vérifié comme appartenant réellement à ce compte, et tout fragment qui ne l’est pas est listé parmi les étapes différées : un fragment illisible est autrement invisible, car le chargeur de configuration ne fait qu”avertir au sujet d’un fichier
@inline-secret@qu’il ne peut pas ouvrir, et le service démarre puis échoue plus tard avec un trompeur « … is not configured ».En dernier, run met
pepsi-telemetry-client.serviceen accord avec[pepsi] SHARE_TELEMETRY:systemctl enable --nowlorsque la télémétrie est activée. Lorsqu’elle est désactivée, l’unité est laissée dans l’état où l’opérateur l’a laissée, ni démarrée ni arrêtée : un démon en cours d’exécution est en sommeil (aucune socket, rien de soumis), et le laisser tourner est ce qui permet à la console du navigateur de proposer d’activer la télémétrie. Dans les deux cas, run envoie ensuite la notificationtelemetry_changed, de sorte qu’un démon en cours d’exécution suit aussitôt la réponse ; désactiver la télémétrie prend effet immédiatement.pepsi.targetne démarre pas cette unité : rien dans la cible ne laWants, car une unité que la cible tirerait tournerait quelle qu’ait été la réponse. L’unité est cependantPartOf=la cible et s’arrête donc avec le pipeline. Cela se produit ici, à la fin, parce que leSYSTEM_IDest généré plus tôt dans la même exécution ; avec la télémétrie activée et aucun identifiant valide, l’unité est armée malgré tout (le démon reste en sommeil et dit pourquoi) et la raison est journalisée. Tout cela se fait au mieux : un hôte sans systemd, sans unité installée ou sans root se voit indiquer à la place l’unique commandesystemctl. Voir pepsi-telemetry-client(1).- -r, –reset
Supprimer tous les objets
pepsiexistants avant de les recréer. DANGEREUX : tous les messages stockés sont irrémédiablement perdus. Les clés DKIM, que pepsi-dkim(1) conserve dans des fichiers, ne sont pas affectées. Seule une base de données construite par une version de développement à partir d’une autre copie d’un patch non publié en a jamais besoin ; le schéma d’une version plus ancienne est mis à niveau sur place (voir schema).
- schema [–backup-dir DIR] [–backup-keep N] [–if-installed]
Installer ou mettre à niveau le schéma de la base de données et réappliquer les droits des rôles, et rien d’autre : aucune validation de configuration au-delà de
[pepsi-postgres], ni certificats, ni clés, ni DNS. Cela fonctionne donc avec n’importe quel fichier de configuration qui désigne la base de données, comme/etc/pepsi/pepsi.confsur un hôte de courrier ou/etc/pepsi-telemetry/pepsi-telemetry.confsur un collecteur de télémétrie, et c’est ce qu’exécute une mise à niveau de paquet, avant le redémarrage des services.L’installateur enregistre le SHA-256 de chaque fichier SQL qu’il applique, ainsi que la version dont il provient, dans
pepsi.schema_file; chaque programme Pepsi compare cet enregistrement aux empreintes compilées en lui lorsqu’il se connecte, et refuse de s’exécuter (code de sortie 78) sur un schéma plus ancien, plus récent ou construit à partir d’autres fichiers. schema amène un schéma plus ancien au niveau de cette version. Il refuse, avant de modifier quoi que ce soit et avec le code de sortie 78, un schéma plus récent que cette version (le retour à une version antérieure n’est pas pris en charge : des fonctions stockées plus anciennes installées par-dessus un schéma plus récent le casseraient), un schéma construit à partir d’une autre copie d’un fichier de patch, et un schéma sans aucun enregistrement (construit par une version de développement antérieure à l’existence de l’enregistrement ; une telle base de données doit être vidée puis recréée avec run –reset). Il refuse aussi les fichiers SQL deSQL_DIRqui ne sont pas ceux avec lesquels ce binaire a été compilé, comme dans un répertoire périmé après une mise à niveau partielle. Les installateurs concurrents se sérialisent sur un verrou consultatif.- –backup-dir DIR
Avant qu’une mise à niveau ne modifie quoi que ce soit, enregistrer le schéma avec pg_dump(1) (format personnalisé ; les schémas
pepsiet_vet les extensions, dont l’index trigramme de l’archive a besoin) sous DIR/pepsi-OLD-VERSION-UTC-TIME.dump, mode 0600, en s’exécutant en tant que propriétaire du schéma. Effectué seulement lorsqu’il y a quelque chose à mettre à niveau. Si le vidage échoue, rien n’est mis à niveau. Pour en restaurer un, utilisez pg_restore(1) vers une base de données vide.- –backup-keep N
Après qu’un vidage a été effectué, supprimer tous les vidages de DIR sauf les N plus récents (jugés d’après l’heure figurant dans le nom ; les fichiers portant tout autre nom sont laissés tels quels). Par défaut
2: le vidage qui vient d’être effectué et le précédent, assez pour annuler la dernière mise à niveau ou l’avant-dernière.0garde tous les vidages. Un vidage contient tout ce que contient le schéma (le courrier en file d’attente, le texte en clair du courrier déchiffré encore dans la file, les clés privées enveloppées), de sorte que des vidages que personne ne restaurera sont des copies de courrier hors de la durée de vie propre de la base de données. Un vidage qui ne peut pas être supprimé est journalisé, et la mise à niveau se poursuit.- –if-installed
Ne rien faire lorsque la base de données n’a pas encore de schéma Pepsi. Une nouvelle installation se met en place avec run ; cette option est destinée aux scripts de mainteneur, qui ne doivent pas installer un schéma que personne n’a demandé.
- check
Interroge le DNS en service et rapporte, pour chaque domaine faisant autorité, si les enregistrements réellement publiés correspondent à ce que run générerait. Il vérifie les enregistrements de sélecteur DKIM (un unique enregistrement de clé bien formé, du bon type
k=, dont la clé publiquep=correspond à la clé que détient pepsi-dkim(1) ; voir Affiche les enregistrements DNS sous run), l’enregistrement SPF (l’enregistrementv=spf1liste chaquePUBLIC_IPconfiguré), l’enregistrement TXT_dmarc(exactement un, et strictement valide ; voir Affiche les enregistrements DNS sous run ci-dessus), et l’enregistrement TXT_mta-sts(présent et enregistrementv=STSv1analysable avec une étiquetteid=; la valeur de l”idest choisie par l’opérateur et n’est pas comparée, mais sa syntaxe l’est : la RFC 8461 §3.1 autorise de 1 à 32 lettres et chiffres). Chaque enregistrement est rapporté comme[ok],[MISSING],[MISMATCH],[INVALID]ou[lookup failed]; chaque ligne non-[ok]est suivie d’une ligne indentée→qui dit quoi faire et, lorsque le correctif est un enregistrement dont setup connaît la valeur (DKIM, SPF,_mta-sts, une politique DMARC manquante ou dont lerua=omet l’adresse des rapports, un enregistrement TLSA ou CAA, lev=spf1 -alld’un sous-domaine), de cet enregistrement au format de fichier de zone, prêt à coller et identique à ce qu’affiche run. Une politique DMARC malformée ne reçoit pas d’enregistrement de remplacement, pour la raison donnée plus bas. La commande ne fait aucun changement, et sans –fail-on-findings ses constats ne déterminent jamais le code de sortie : elle sort avec 0 quel que soit le nombre d’enregistrements manquants ou erronés, lisez donc sa sortie plutôt que son code de sortie. (Seule une configuration qui ne se valide pas, ou un résolveur impossible à construire, la fait sortir avec un code non nul ; elle n’a alors rien à rapporter.)–fail-on-findings la fait sortir avec 1 lorsqu’un enregistrement est
[MISSING],[MISMATCH],[INVALID]ou[UNREACHABLE]ou qu’une adresse est[LISTED], après avoir journalisé chacun de ces constats comme avertissement (ciblesetup), afin qu’il atteigne le journal avec la priorité warning. Un[lookup failed]ne compte pas, pas plus que les verdicts indicatifs ([todo],[none],[NO ACCOUNTURI],[UNVALIDATED],[UNALIGNED],[INCOMPLETE],[UNSCOPED]).pepsi-setup-check.timer, nommé parpepsi.target, exécutepepsi-setup -c /etc/pepsi/pepsi.conf check --fail-on-findingschaque jour (pepsi-setup-check.service, en tant que root sur un système de fichiers en lecture seule, puisque la validation lit les secrets de chaque service) ; un constat fait échouer l’unité, quesystemctl --failedliste alors.[INVALID]est le verdict d’un enregistrement qui est publié mais que les destinataires écartent, de sorte que le domaine est sans protection tout en paraissant configuré. Son remède diffère de celui des autres : l’enregistrement est réparé sur place plutôt que remplacé par la valeur qu’imprime run. Outre les constats DKIM décrits ci-dessous, ces vérifications le produisent dans les cas suivants : un enregistrement DMARC qui ne s’analyse pas (ou un second au même nom), plus d’un enregistrementv=spf1(la RFC 7208 §4.5 en fait une erreur permanente, de sorte qu”aucune politique SPF ne s’applique, au lieu que la première l’emporte), un enregistrementv=spf1comportant un terme hors de la grammaire de la RFC 7208 (un mécanisme inconnu tel queipv4:, une adresse ou une longueur CIDR erronée, une macro malformée ; le terme est nommé), et plus d’un enregistrementv=STSv1ou un dont l”id=sort de la syntaxe autorisée. Un enregistrementv=spf1se terminant par+allest rapporté comme[MISMATCH]: il est valide, il passe le test « mes adresses sont-elles listées ? », et il autorise chaque hôte de l’internet à envoyer au nom du domaine, anéantissant les enregistrements DKIM et DMARC publiés à côté de lui.Chaque enregistrement est vérifié deux fois : dans la réponse du résolveur du système, et auprès de chacun des serveurs de noms faisant autorité de la zone, interrogés directement (chaque adresse d’un serveur deux fois avant qu’il soit considéré comme ne répondant pas, car la perte d’un datagramme UDP est ordinaire). Un enregistrement que le résolveur renvoie correctement mais qu’un serveur de noms ne renvoie pas (un secondaire périmé, un serveur boiteux ou injoignable) est un
[MISMATCH]nommant les serveurs, avec un remède qui vise la distribution de la zone plutôt que l’enregistrement. Un enregistrement DKIM auk=erroné ou manquant, auv=mal placé, avec une restrictionh=/s=excluant ce que Pepsi signe, ou un second enregistrement de clé au même nom est[INVALID];t=yest un[MISMATCH]. Lorsque la signature Ed25519 est activée, unenote:finale explique pourquoi Google rapporte ce sélecteur commefail.Les enregistrements DKIM vérifiés sont ceux que pepsi-dkim(1) signale dans son fichier d’état comme nécessaires dans le DNS, chacun étiqueté selon le point où sa clé en est de sa vie :
DKIM (RSA)/DKIM (Ed25519)pour la clé courante,DKIM (RSA, next key)pour une clé créée en prévision d’une rotation,DKIM (RSA, retiring key)pour une clé remplacée dont les signatures peuvent encore être en transit. Unp=qui est un préfixe strict de la clé du démon, comme lorsqu’un hébergeur DNS n’a gardé que la première chaîne de 255 octets d’un long enregistrement, est un[MISMATCH]qui dit que la clé est tronquée et comment la saisir en plusieurs chaînes. Un enregistrement que le démon signale comme supprimable (une clé retirée) est une ligne indicative[todo],DKIM (retired key), dont le remède est de le supprimer. Un domaine pour lequel le démon n’a pas signalé de clés, parce que son fichier d’état n’est pas encore écrit ou parce qu’il ne signe pas pour le domaine, est[MISSING]à<DKIM_SELECTOR>._domainkey, avec pour remède de démarrerpepsi-dkim.serviceet d’exécuter run.Un enregistrement peut aussi être
[ok]et porter une note : une politique DMARCp=noneest valide, c’est le bon point de départ, et elle n’applique rien ; le rapport le dit donc plutôt que de laisser un domaine rester indéfiniment en mode surveillance.Au-delà des enregistrements TXT, il exécute les deux recoupements MTA-STS décrits sous run pour chaque domaine pour lequel une politique MTA-STS est servie : l’ensemble
mxde la politique confronté aux enregistrementsMXen service, et une récupération dehttps://mta-sts.<domain>/.well-known/mta-sts.txtcomparée à la politique configurée. Il se termine par une note donnant la ligneMTA_STS_MXqui les mettrait d’accord. Pour le[pepsi-srs] SRS_DOMAIN, il ajoute la vérification de délivrabilité décrite sous Le domaine SRS peut recevoir ses propres rebonds.Deux groupes suivent les domaines. DANE/TLSA liste chaque RRset TLSA publié sous un nom pour lequel run en suggère un, comparé au certificat servi comme décrit sous Affiche les enregistrements DNS :
[MISMATCH]lorsqu’aucun enregistrement utilisable ne correspond à la clé,[INVALID]lorsqu’aucun enregistrement n’a un usage qu’applique SMTP (DANE-TA ou DANE-EE). Les noms sous lesquels rien n’est publié ne sont pas listés, puisque publier TLSA est facultatif. Et au sein de chaque domaine, les cibles pendantes sont rapportées comme[MISSING]: un enregistrementMXnommant un hôte qui n’a pas d’enregistrementA/AAAA(ou n’existe pas) ; un enregistrementNSdu domaine nommant un serveur de noms sans adresse ; unCNAMEàmta-sts.<domain>,openpgpkey.<domain>ouautoconfig.<domain>pointant vers un nom sans adresse ; uninclude:ouredirect=SPF nommant un domaine qui ne publie aucun enregistrement SPF (ou plus d’un) ; et una:<host>oumx:<host>SPF nommant un autre hôte qui n’a pas d’adresse (pas d’enregistrementMX, respectivement). Ce sont tous des restes typiques d’une migration ou d’un contrat d’hébergement résilié. Une référence SPF pendante fait de toute la politique SPF du domaine une erreur permanente (RFC 7208), et dans tous les cas quiconque peut ultérieurement créer ou enregistrer ce nom reçoit le courrier du domaine, répond pour sa zone, sert sa politique MTA-STS ou ses clés OpenPGP, ou décide de qui peut envoyer en son nom. Un enregistrement SPF qui dépasse les limites de recherche de la RFC 7208 (voir Affiche les enregistrements DNS) est rapporté comme[INVALID]à côté d’eux. DANE/TLSA liste aussi, comme[INVALID], un RRset TLSA publié que les résolveurs publics ne marquent pas comme authentique DNSSEC, et un domaine accepté dont ils ne marquent pas ainsi le RRsetMX(étiquettesTLSA (DNSSEC)etMX (DNSSEC)). Les réponses de ces résolveurs sont distinguées par code de réponse et par Extended DNS Error de la RFC 8914. Un SERVFAIL nommant un échec DNSSEC (DNSSEC Bogus, Signature Expired, Signature Not Yet Valid, DNSKEY Missing, RRSIGs Missing, No Zone Key Bit Set, NSEC Missing) signifie que la chaîne de confiance est rompue : les résolveurs validants refusent le nom, de sorte que les expéditeurs qui sont derrière l’un d’eux ne peuvent pas le résoudre et que les expéditeurs utilisant DANE diffèrent le courrier. Un tel SERVFAIL est rapporté en nommant l’erreur, pour un RRset TLSA de ce groupe et pour le RRsetMXd’un domaine accepté, que DANE soit publié ou non, sous le domaine lui-même ; un RRset TLSA qui reçoit un SERVFAIL nu est rapporté comme « bogus or unreachable ». Une recherche qui échoue simplement n’est pas rapportée ; seule une réponse certaine l’est. run journalise les mêmes constats comme avertissements.CAA a une ligne par domaine accepté, et par hôte de certificat qui ne relève d’aucun d’eux, donnant l’ensemble d’enregistrements CAA qu’une CA consulterait pour lui (RFC 8659 : celui du nom lui-même, sinon celui de l’ancêtre le plus proche) et ce qu’il signifie pour les certificats qu’obtient run :
[none]lorsqu’aucun enregistrement ne restreint l’émission (pas de CAA, ou pas de propriétéissue), de sorte que chaque CA émet pour quiconque réussit une validation de domaine, y compris détournée ;[NO ACCOUNTURI]lorsqueletsencrypt.orgest nommé sans l”accounturiRFC 8657 du compte certbot de cet hôte ;[UNVALIDATED]lorsque l’ensemble est correct mais que les résolveurs publics ne le marquent pas comme authentique DNSSEC, de sorte qu’un attaquant qui répond aux requêtes de la CA peut le cacher ;[ok]sinon. Un ensemble qui ne permet à aucun compte Let’s Encrypt d’obtenir un certificat par HTTP-01 (seulement d’autres CA, l”accounturid’un autre compte,validationmethodssanshttp-01, une propriété critique inconnue) est un[MISMATCH], puisque le prochain renouvellement de certbot échoue ; c’est le seul constat CAA qui fait échouer le verdict du rapport. Un domaine dont les certificats ne proviennent pas de certbot ici n’est jugé que sur la présence et la validation. L’enregistrement lui-même n’est jamais publié par run, qui l’affiche comme suggestion en commentaire (voir Affiche les enregistrements DNS).DNSKEY juge les clés qui signent les zones que sert cet hôte : la zone de chaque domaine accepté, de
HOSTNAMEet du domaine SRS, trouvée via l’enregistrementSOA(le nom lui-même, ou l’ancêtre le plus proche qui en porte un), son RRsetDNSKEYétant demandé aux résolveurs publics (sinon à ceux de cet hôte). Les clés révoquées et les clés sans l’indicateur de zone sont ignorées. Une zone signée se valide quoi que valent ses clés, et quiconque détient ou factorise une clé falsifie des enregistrementsMXetTLSAvalablement signés pour la zone, de sorte que chacun de ces cas est un constat :[INVALID]pour une clé dont la RFC 8624 §3.1 dit que l’algorithme NE DOIT PAS être utilisé pour signer (RSAMD5 1, DSA 3, DSA-NSEC3-SHA1 6, ECC-GOST 12 et, depuis la RFC 9905, RSASHA1 5 et RSASHA1-NSEC3-SHA1 7) ou qu’elle qualifie de NON RECOMMANDÉ (RSASHA512 10), pour un module RSA de moins de 2048 bits, et pour une clé qui signe aussi une autre des zones vérifiées (une seule clé derrière plusieurs zones, c’est ainsi qu’un hébergeur DNS signe de la même façon la zone de chaque client) ;[LISTED]pour une clé figurant dans la liste des clés connues comme compromises (pepsi.compromised_key: la liste badkeys que tientpepsi-keys blocklist update, et les modules quepepsi-keys peer screena factorisés), recherchée par le hachage badkeys du module RSA, de la coordonnée x ECDSA ou de la clé EdDSA. Une zone saine est[ok]avec la liste de ses clés, une zone non signée[todo](la signature est facultative ; les constats DNSSEC ci-dessus disent ce que DANE perd alors). Chaque constat compte pour--fail-on-findings. Lorsque la base de données ne peut pas être lue, la comparaison avec la liste est sautée et une note le dit.subdomains liste, sous la forme
[MISSING] SPF (subdomain), chaque sous-domaine d’un domaine servi que nomme la configuration, qui existe (a une adresse ou un enregistrementMX) et qui n’a pas d’enregistrement SPF à lui. La configuration nomme l’hôteEHLOd’une étape de relais,[pepsi-ingress] HOSTNAME,mta-sts.<domain>etautoconfig.<domain>. Un enregistrement SPF joker ne répond pas pour un nom qui existe, de sorte qu’un expéditeur falsifié à ce nom obtient SPFnone. L’enregistrement dont un tel nom a besoin estv=spf1 -allou, pour un nom que Pepsi annonce dansEHLO, l’enregistrement SPF des domaines servis avec les adresses d’envoi (les destinataires vérifient le nomEHLOsur chaque rebond). Le groupe est indicatif et ne fait pas échouer le verdict du rapport.Deux groupes de délivrabilité suivent. blocklists a une ligne par adresse depuis laquelle cet hôte envoie ou reçoit du courrier (chaque
PUBLIC_IPd’une étapepepsi-stage-relay-to-internet, les adresses de[pepsi-ingress] HOSTNAME,[pepsi-reputation] CHECK_ADDRESSES) et par domaine servi :[LISTED]en nommant chaque liste de blocage DNS qui la liste,[ok]lorsque chaque liste qui a répondu la dit propre,[lookup failed]lorsqu’aucune n’a pu être interrogée (voircheckde pepsi-reputation(1) pour la façon dont la réponse d’une liste est vérifiée avant d’être crue). mailbox providers traduit les enregistrements ci-dessus en exigences que Gmail, Yahoo et Microsoft publient pour les expéditeurs ([ok]ou[INCOMPLETE]), et liste leurs inscriptions, vers lesquelles Pepsi oriente mais qu’il n’effectue jamais : Gmail Postmaster Tools ([ok]dès que[pepsi-reputation] GOOGLE_SITE_VERIFICATIONa un jeton pour chaque domaine servi, dont run affiche l’enregistrement TXTgoogle-site-verification=et que check vérifie sousGoogle verification), Microsoft SNDS et JMRP pour les adresses d’envoi, et Yahoo Sender Hub pour les domaines DKIM, chacun[todo]avec ce qu’il faut saisir et où. Seule une inscription sur une liste fait échouer le verdict global du rapport. run interroge aussi les listes de blocage, et journalise un avertissement pour chaque inscription.Un groupe DMARC reports a une ligne par domaine servi, à partir des rapports agrégés DMARC authentifiés que pepsi-stage-dmarc-report(1) a stockés pour les
[pepsi-dmarc-reports] WINDOW_DAYS(7) derniers jours :[ok]lorsque chaque source rapportée par les destinataires était alignée (DKIM ou SPF aligné sur le domaine duFrom:), de sorte quep=rejectn’en refuse aucune ;[UNALIGNED]en nommant les sources qui ne l’étaient pas (adresse, nombre de messages, domaine d’enveloppe,d=DKIM, rapporteurs), quep=rejectrefuse (un service qui envoie au nom du domaine a d’abord besoin d’un DKIM ou d’un SPF aligné ; le courrier réexpédié et les falsifications sont refusés comme prévu) ;[todo]lorsqu’aucun rapport n’est arrivé, avec lerua=à publier. Un rapport dont le courrier n’a réussi ni SPF ni DMARC ne compte pour rien. Le groupe est indicatif et ne fait jamais échouer le rapport ; il est omis lorsqu’aucune étape ne lit de rapports et qu’aucun n’est stocké. Avec une étape qui lit des rapports, un enregistrement valide dont lerua=omet l’adresse de l’étape est[MISMATCH]sur la ligne_dmarc, suivi de cet enregistrement avec l’adresse ajoutée.Au sein de chaque domaine, chaque adresse
mailto:que l’enregistrement_dmarcvalide nomme dansrua=ouruf=est vérifiée là où les rapports iraient (étiquetteDMARC report destination). Un domaine de destination hors de l’organisation du domaine de la politique doit publier un enregistrement TXTv=DMARC1à domain._report._dmarc.destination (RFC 7489 §7.1) ; sans lui, les destinataires qui vérifient ne lui envoient rien, ce qui est un[MISMATCH]. Une destination, interne ou externe, sansMXni enregistrementA/AAAA(ou avec unMXnul) est[INVALID]: c’est une adresse périmée ou mal saisie, dont les rapports (le flux de courrier du domaine et, pourruf=, des messages entiers) vont à quiconque enregistre le nom. Une recherche qui échoue n’est pas un constat. Le choix du processeur qui reçoit les rapports reste celui de l’opérateur ; une adresse dans le domaine lui-même, lue par pepsi-stage-dmarc-report(1), les garde sur cet hôte.Un groupe HSTS a une ligne par nom HTTPS sous lequel pepsi-httpd est joint, lorsqu’un écouteur httpd est configuré : chaque hôte
SNIde[pepsi-httpd-cert-*], l’hôte propre de l’écouteur, etopenpgpkey.domain,autoconfig.domain (avec[pepsi-autoconfig]activé) etmta-sts.domain (avec MTA-STS publié) pour chaque domaine accepté. Chacun est récupéré commehttps://name/avec vérification du certificat et sans suivre de redirection, et son en-têteStrict-Transport-Securityest jugé comme le ferait un navigateur (seul le premier en-tête compte) :[ok]avec unmax-agevalide d’au moins six mois (15768000 secondes),[MISMATCH]lorsque l’en-tête est absent, plus court ou malformé (pas demax-age, une directive en double). pepsi-httpd envoie un an sur ses propres écouteurs TLS, de sorte qu’un[MISMATCH]est généralement un serveur frontal terminant TLS qui ne transmet pas l’en-tête : il doit l’ajouter. Un nom qui ne répond pas est omis (l’accessibilité relève des autres vérifications).includeSubDomainsetpreloadne sont pas demandés ; ils engagent chaque hôte du domaine. run journalise les mêmes constats comme avertissements.When any end-to-end identity is published, a published keys group has one line per address (label
Served keys): what a correspondent is given by both Web Key Directory methods (openpgpkey.domain and the domain itself) and by theOPENPGPKEYandSMIMEArecords, fetched with key discovery’s hardened clients and[pepsi-keydiscovery]settings and compared with the published, active rows of the key store.[MISMATCH]means that a channel serves a fingerprint that the store does not publish for that address, for example from another web server on the apex answering the direct method, from a DNS record left over from a rotation, or as a key that somebody else placed there; it makes the report’s overall verdict fail.[INCOMPLETE]means that a stored key is not served, or that neither WKD method serves anything;[lookup failed]means that a channel could not be asked. A DNS record that was never published is not a fault. The detail names every channel and fingerprint; see pepsi-keys(1)identity list --servedfor the same per identity. The check asks from this host, once: a server that answers other askers differently is not detected.When any S/MIME trust anchor is enabled, a trust anchors group has one line per enabled anchor (label
S/MIME anchor, named by itsca_id):[ok]when the operator limited it to named mail domains (pepsi-keys(1)ca scope) or its certificate carriesnameConstraintsof its own,[UNSCOPED]when nothing limits it, so that a signature from any address chaining to that CA readsvalid.unscopedis advisory (it is not a finding for--fail-on-findings) and is also logged as a warning.Un dernier groupe, state of removed or reassigned accounts, ne concerne pas le DNS. Pepsi conserve un état indexé par une adresse ou un login, et n’en supprime rien lorsque le compte passwd disparaît : les surcharges par adresse (
pepsi.settings), les identités de bout en bout non révoquées (pepsi.crypto_identity), les listes blanches propres<login>/...d’un utilisateur et un quota de boîte aux lettres. Pour chaque adresse d’un domaine servi (les[pepsi-ingress] ACCEPTED_DOMAINSet lesLOCAL_DOMAINSde chaque étape, sous-adresse retirée à[pepsi] RECIPIENT_DELIMITER) et chaque login dont la recherche passwd dit qu’il n’existe pas de tel compte, une ligne[WARNING]nomme le login et l’état conservé pour lui. L’état peut être voulu (un alias ou une adresse de liste n’a pas de compte à soi, et un quota peut être défini avant que le compte n’existe), de sorte que rien n’est modifié : supprimez ce qui appartenait à un compte supprimé (pepsi-settings remove, pepsi-keys identity revoke, pepsi-whitelist remove, pepsi-quota remove) avant que le nom ne soit attribué de nouveau. Une recherche passwd qui échoue (un annuaire injoignable) n’est pas lue comme « pas de tel compte » : ces logins sont seulement comptés.Pepsi note aussi quand chaque login a été attribué (
pepsi.login_assignment, RFC 7293 ; voir Le registre d’attribution des logins ci-dessous), et un login qui revient sous un autre uid, ou après avoir été constaté disparu, a un nouveau propriétaire. La base de données abandonne les réglages, les listes blanches propres, le quota et les enregistrements de réponse automatique du propriétaire précédent dès que cela est remarqué, mais jamais le matériel de clé : une ligne[WARNING]supplémentaire nomme chaque identité du magasin de clés (non révoquée), chaque clé de pair en cache et chaque second facteur TOTP pour les adresses du login qui est plus ancien que le propriétaire actuel, avec la commande qui permet de s’en débarrasser (pepsi-keys identity revoke ID, pepsi-keys peer remove ID, pepsi-keys otp reset ADDRESS). Jusque-là, une identité déchiffre encore le courrier de l’adresse, qui est désormais le courrier du nouveau propriétaire, et peut permettre au nouveau propriétaire de lire celui du précédent. Les lignes se répètent à chaque exécution jusqu’à ce que la clé soit traitée. La base de données est lue sous le rôlepepsi-owner. run journalise les mêmes constats comme avertissements.- questions
Imprime le questionnaire de configuration initiale sur la sortie standard en JSON : les étapes ordonnées et, pour chaque question, son identifiant, son type (
text,bool,choice,list,secret,path,port,domain,integer,address,url), son invite, son texte d’aide, sa valeur par défaut, si elle est requise, l’option de configuration sur laquelle elle se projette lorsqu’elle se projette sur exactement une, et la condition sous laquelle elle est posée.Ce modèle décrit les deux interfaces : le questionnaire du terminal, et celui du navigateur que pepsi-httpd sert à
/api/v1/setup/questions. C’est aussi le schéma au regard duquel un fichier –answers est écrit. Il n’a besoin d’aucune configuration, puisque c’est ce que l’on lit avant d’en avoir une.- apply [–once] [–idle SECS] | apply –clear
Effectue le travail de configuration privilégié que l’interface de navigateur a demandé. À exécuter en tant que root. Voir Le modèle de confiance de l’applicateur ci-dessous avant de déployer ceci.
Sur un système Debian, les unités systemd qui exécutent ceci à la demande sont dans le paquet distinct pepsi-httpd-admin ; le retirer laisse cette sous-commande fonctionner depuis un shell root tout en la rendant inatteignable depuis la console web. Voir Retirer la capacité : le paquet pepsi-httpd-admin ci-dessous.
Il lit des lignes d”intention dans la table
pepsi.setup_task, chacune étant une demande de l’API d’administration pour quelque chose issu d’un ensemble fermé. Il vérifie que chacune peut être exécutée, l’exécute, et consigne l’issue et ses lignes de progression dans la ligne. Il n’effectue aucun autre travail et n’accepte aucune autre entrée : en particulier il ne lit jamais depuis une tâche une commande, un chemin à exécuter ou un fichier à écrire verbatim.- –once
Vide ce qui est en attente puis quitte. Ce que veut une entrée cron ou une exécution manuelle.
- –idle SECS
Sans –once, il attend sur le canal
NOTIFYdesetup_taskaprès avoir vidé, et quitte une fois SECS écoulées sans rien à faire (300 par défaut). C’est ce qui fait fonctionner l’activation par socket : pepsi-httpd se connecte à la socket de sonnette après avoir mis en file, systemd démarre cette unité, elle vide la file d’attente et s’en va. Un processus root assis en permanence sur une file d’attente de travail fournie par une couche web est exactement le privilège permanent que la conception évite.- –clear
Supprime chaque ligne de
pepsi.setup_tasksans en exécuter aucun, rapporte combien ont été retirés, et quitte. Refusé conjointement avec –once ou –idle : c’est une remise à zéro administrative, non un mode de vidage.Une tâche est une demande durable vers un processus tournant en root et rien ne la fait expirer : une file qui traîne est donc un danger plutôt qu’un arriéré. Les unités de l’applicateur forment un paquet distinct précisément pour qu’un déploiement puisse tourner sans que rien ne vide cette file, et des lignes peuvent tout de même atteindre la file dans cet état, par exemple venant d’un opérateur disposant d’un shell root. Si le paquet manquant est installé des mois plus tard, chacune d’elles s’exécute au premier coup de sonnette, dans l’ordre où elle a été demandée, contre un déploiement qui a évolué. Le consentement ne dure pas aussi longtemps : installer
pepsi-httpd-adminexécute donc ceci depuis sonpostinst.Chaque ligne disparaît, non seulement les
pending. Seule une lignependingpeut jamais s’exécuter et une lignerunningest orpheline par définition : ne supprimer que ces deux-là suffirait donc à la sûreté. Mais un « effacement » qui laisserait une console pleine de lignesdoneetrefusedn’en serait pas un, et rien n’est perdu à les retirer : chaque demande, refus, succès et échec est une entrée d’audit durable indépendante, que ceci ne touche pas. Les lignes de progressionsetup_task_logde la tâche la suivent en cascade.Une base sans schéma Pepsi n’a jamais contenu de tâche ; elle est donc rapportée comme une file d’attente vide plutôt que comme une erreur, et ceci peut être exécuté sans risque sur un hôte pas encore configuré.
Passez un
-cFILE pour les modes de vidage : l’applicateur écrit ce fichier et ses fragmentssecrets.d, et le chemin vient de sa propre ligne de commande et jamais de quoi que ce soit qu’une tâche puisse influencer. Ce n’est pas strictement obligatoire : sans-c, la recherche par défaut ordinaire décrite plus bas s’applique, et l’applicateur n’échoue que si elle ne trouve rien. Mais nommer le fichier est tout l’intérêt : la recherche par défaut consulte$XDG_CONFIG_HOMEet$HOME, ce qu’un applicateur exécuté en root n’a pas à résoudre. –clear n’exécute rien et n’a donc besoin d’aucun fichier de ce genre.- bootstrap [–valid-for SECS] [–admin-url URL]
Frapper l’identifiant à usage unique qui crée le premier compte administrateur, et l’imprimer avec la commande
curlqui l’utilise. –admin-url URL est l’URL de base de l’écouteur d’administration auquel cette commande s’adresse (par défauthttp://localhost:8080) ; elle n’affecte que l’exemple imprimé.Une installation fraîche n’a aucun compte : rien ne peut donc se connecter à la console qui en créerait un. Ceci imprime un jeton porteur détenant l’ensemble complet des portées d’administrateur, valide SECS (3600 par défaut) et accepté exactement une fois, de quoi faire un unique
POST /api/v1/accounts. Il est consommé à la présentation par une mise à jour qu’une seule demande concurrente peut gagner, de sorte qu’un jeton lu par deux personnes n’en admette qu’une.La liste des portées n’est pas un choix :
POST /api/v1/accountsrefuse de délivrer une portée que l’appelant ne détient pas lui-même, de sorte qu’un jeton ne détenant quesetup:writene pourrait pas créer un administrateur ; et, puisque le jeton est consommé avant que le gestionnaire ne refuse, la tentative le dépenserait. Lecurlimprimé demande exactement les portées avec lesquelles le jeton a été frappé, rendues depuis la même liste : les deux ne peuvent donc pas diverger.À usage unique à cause de l’endroit où il est imprimé : un jeton sur un terminal est dans un tampon de défilement et un jeton dans le journal est lisible par quiconque peut lire le journal. Seul son condensat est stocké : il ne peut donc pas être récupéré ; relancez la commande si vous le perdez. La relancer révoque aussi tout jeton d’amorçage en cours.
Un administrateur local sur l’écouteur à socket UNIX
ADMIN = yesest identifié parSO_PEERCREDet n’a besoin d’aucun identifiant : un jeton d’amorçage expiré ou perdu est donc un désagrément plutôt qu’un verrouillage.- validate
Vérifier la configuration exactement comme le fait run avant de modifier quoi que ce soit : chaque section qu’il connaît, le pipeline
[stage-*]et les vérifications de démarrage de chaque étape, ainsi que les fichiers que nomme la configuration, commeSENDER_MAP. Les avertissements sont journalisés ; un refus est journalisé et la commande sort avec le code 1. Rien n’est modifié et rien n’est demandé au réseau ni à la base de données : la commande est donc sûre après n’importe quelle modification et avant un redémarrage. La seule exception concerne les milters : validate (comme run) négocie avec chaque filtre[pepsi-ingress-milter-*]comme le fait check, et journalise un avertissement pour un filtre qui ne répond pas ou qui demande une action que sonALLOW_ACTIONSrefuse. Il avertit aussi d’une section de milter qu’aucun écouteur n’exécute, et d’un milter autorisé à modifier les en-têtes ou le corps lorsqu’aucune étape n’exécute pepsi-stage-arc(1) : Pepsi n’applique une telle modification à un message porteur d’une chaîne ARC qu’après que cette étape a vérifié la chaîne. La surcouche de la base de données (pepsi.config_override) n’est pas consultée ; run la vérifie aussi.- visualize
Imprimer le pipeline
[stage-*]configuré sur stdout sous forme d’un graphe Graphvizdot. Chaque étape est un nœud, étiqueté avec son nom de section de configuration (par exemplestage-init) et lePROGRAMqu’elle exécute avec le préfixepepsi-stage-retiré (par exemplearc). Une arête pleine suit leNEXT_STAGEde chaque étape et une arêtebouncerouge en pointillés sonBOUNCE_STAGE. La commande ne fait que lire la configuration (aucun changement de DNS, de schéma ou de système de fichiers) ; passez-la à traversdotpour rendre, par exemplepepsi-setup -c /etc/pepsi/pepsi.conf visualize | dot -Tpng -o pipeline.png
95.1.43.1.9. Le registre d’attribution des logins¶
Pepsi n’a pas de cycle de vie des comptes qui lui soit propre, puisque les logins viennent de passwd, mais la RFC 7293 (Require-Recipient-Valid-Since) demande à un destinataire de savoir quand chaque adresse a été attribuée à son propriétaire actuel. pepsi.login_assignment le conserve par login : l’uid, le moment où l’attribution actuelle a été vue pour la première fois, et si elle a succédé à une attribution antérieure. Il est construit à partir d’observations :
la remise locale note chaque login auquel elle remet, avec l’uid que passwd lui a donné : pepsi-stage-relay-to-maildir avant d’écrire, pepsi-stage-relay-to-lmtp pour chaque destinataire que le MDA a accepté et qui se résout en un login passwd (un utilisateur virtuel du MDA n’est pas noté) ;
run note chaque login existant que nomme un état conservé (réglages, identités, listes blanches, quotas), puis recherche à nouveau chaque login noté ;
pepsi-queue gc (toutes les heures,
pepsi-origin-gc.timer) répète cette dernière étape.
Un login vu pour la première fois est une première attribution, quel que soit le moment : ce qui s’est passé avant que Pepsi n’observe est inconnu, et la RFC 7293 considère une adresse qui n’a eu qu’un propriétaire depuis sa création comme possédée sans interruption. Un login vu de nouveau sous un autre uid, ou vu de nouveau après qu’une vérification l’a trouvé disparu (même sous son ancien uid), a un nouveau propriétaire. Dès que cela est remarqué, le registre repart de zéro et la base de données abandonne l’état par adresse que le propriétaire précédent a laissé :
les lignes
pepsi.settingsdes adresses du login (chaque domaine servi, sous-adresse retirée àRECIPIENT_DELIMITER) ;les listes blanches propres
<login>/...du login et leurs défis confirm-to-send en attente ;sa ligne
pepsi.mailbox_quota(une limite définie par compte appartenait au propriétaire précédent ; la valeur par défaut du site s’applique de nouveau) ;les journaux de réponses d’absence et de demandes de paiement de ses adresses.
Le matériel de clé (identités du magasin de clés, clés de pairs en cache, un second facteur TOTP) n’est pas abandonné : supprimer une clé privée est irréversible et, sous la garde passerelle, elle peut être la seule chose qui ouvre le courrier archivé du propriétaire précédent. Il est signalé par run et check jusqu’à ce que l’opérateur s’en débarrasse (voir state of removed or reassigned accounts ci-dessus). Chaque réattribution est écrite dans le journal des événements comme avertissement account.reassigned, nommant les deux uid et le nombre de lignes supprimées. L’état de liste de diffusion du login est suspendu plutôt qu’abandonné : ses adresses de liste perdent leur vérification et leur lien avec le compte de liste du propriétaire précédent, ses abonnements simples cessent de recevoir (delivery_status unknown), et les rôles de propriétaire ou de modérateur restent mais sont comptés dans l’événement (list_roles_kept, avec les listes dans list_roles_kept_lists) pour que l’opérateur les examine. L’état d’adresse non lié à un login (les alias) est hors du registre.
Un annuaire qui ne connaît soudain plus personne n’est pas cru : lorsque plus de la moitié des logins notés semblent disparus lors d’une vérification, aucun n’est marqué, de sorte qu’un nsswitch.conf cassé ou une réponse LDAP vide ne puisse pas effacer les réglages de chaque utilisateur à son retour. Une recherche qui échoue n’est jamais lue comme « disparu ».
95.1.43.1.10. Le modèle de confiance de l’applicateur¶
pepsi-setup apply est le seul composant de Pepsi qui s’exécute en root pour le compte d’une requête HTTP.
95.1.43.1.10.1. Pourquoi la console n’agit pas¶
pepsi-httpd abandonne ses privilèges avant d’accepter la moindre connexion, et ne doit jamais pouvoir les regagner : il analyse des entrées fournies par un attaquant pour vivre. Il ne peut donc pas écrire /etc/pepsi/pepsi.conf, remettre un fragment secrets.d au compte qui le lit, exécuter certbot, créer un rôle de base ni générer du matériel de clé, et la configuration initiale doit faire toutes ces choses.
Il n’essaie donc pas. Il écrit une ligne disant ce qui devrait être vrai, et l’applicateur décide du comment. Root reste entièrement hors du réseau : on l’atteint par une table de base de données, non par une socket parlant un protocole.
95.1.43.1.10.2. La liste fermée des tâches¶
Il y a dix-sept sortes de tâches et il n’y en aura pas de générale. Une sorte « commande arbitraire » serait un shell root par HTTP portant un nom de tâche.
write-configRend la configuration à partir d’un jeu de réponses (les mêmes réponses que collecte le questionnaire), la valide exactement comme le ferait
pepsi-setup run, puis écrit le fichier et ses fragments de secrets et remet chaque fragment à son compte propriétaire. Les réponses sont l’intention ; le fichier est le rendu propre de l’applicateur. Rien de ce qu’une tâche fournit n’est écrit verbatim.write-secretStocke un identifiant dans le fragment
secrets.dque son lecteur possède, en préservant chaque autre secret de ce fragment. Il refuse toute paire[section] OPTIONqui n’est pas déjà un identifiant géré par la couche des secrets ; sinon, il écrirait une option arbitraire dans un fichier appartenant à root que chaque service lit.obtain-certificateObtient les certificats TLS que demande la configuration. Les hôtes nommés restreignent ce qui est rapporté, non ce qui est tenté : laisser une tâche introduire un hôte rendrait les arguments de certbot fournis par la tâche.
install-schemaInstalle ou migre le schéma. ``reset`` est refusé : supprimer le schéma détruit chaque message en file d’attente et rend inouvrable chaque clé privée enveloppée, ce qu’un formulaire web n’a pas à pouvoir demander. Utilisez
pepsi-setup run --resetsur une console.provision-rolesCrée les rôles de connexion à la base et réapplique leurs droits.
generate-keysFaire créer par pepsi-dkim(1) les clés DKIM par domaine qui lui manquent (
pepsi-dkim sync-domains, toujours avec l’ensemble complet des domaines du déploiement, puisque cette commande remplace l’ensemble). Une tâche peut restreindre les domaines sur lesquels elle rapporte, jamais les élargir : un domaine que ce déploiement ne sert pas n’obtient pas de clé de signature. Elle échoue lorsque le démon ne signale aucune clé pour un domaine demandé.dkim-rotateDémarrer maintenant une rotation de clé DKIM pour un domaine de signature (paramètres
domainet un booléen facultatifhard) : l’applicateur exécutepepsi-dkim -c CONFIG rotate [--hard] DOMAINen tant que root, puisque le démon n’accepte de requêtes administratives que de root et de son propre compte. Le domaine doit être l’un de ceux pour lesquels ce déploiement signe. Sanshard, le démon crée les clés suivantes et bascule sur elles dès que chaque serveur faisant autorité sert leurs enregistrements ; avec, il bascule immédiatement, de sorte que le courrier est signé avec des clés que les destinataires peuvent ne pas trouver tant que leurs enregistrements ne sont pas publiés. Le résultat consignedomain,hardet la sortie de la commande,output.run-preflightExécute des sondes d’environnement en lecture seule et consigne le rapport. Lesquelles est une liste blanche (
ports,dnssec,dns-records), de sorte que « exécute un pré-vol » ne puisse pas devenir « exécute ceci ».generate-identityGénère une clé OpenPGP gérée par le serveur (une clé MTA) pour une adresse (paramètres
addresset un booléen facultatifvks, qui vaut par défaut[pepsi-keys] VKS_PUBLISHet demande un téléversement vers le serveur de clés). L’adresse doit être dans un domaine de[pepsi-ingress] ACCEPTED_DOMAINSet unKEY_WRAP_SECRETdoit être configuré. Toujours effectuée sur demande, même à côté de la propre clé de l’utilisateur ou d’une clé révoquée. L’applicateur fait le travail sous le rôlepepsi-crypto(root devient ce compte pour la connexion, comme le fait pepsi-keys(1)), car seul ce rôle peut écrire la colonne privée.register-client-keyEnregistre la propre clé publique de l’utilisateur (une clé MUA,
custody = client) pour une adresse (paramètresaddressetkey, une clé publique OpenPGP sous forme de texte, 64 Kio au plus). L’adresse doit être servie, la clé doit être un unique certificat OpenPGP avec un User ID qui nomme l’adresse, et une empreinte que l’adresse possède déjà, retirée ou non, n’est pas enregistrée de nouveau. Elle passe par l’applicateur bien qu’aucun matériel privé ne soit en jeu : une clé enregistrée comme celle de l’utilisateur devient la face publique de l’adresse et vérifie des signatures en son nom, de sorte qu’un tiers web compromis ne doit pas pouvoir en implanter une.revoke-identityRévoque une identité locale (paramètres
address,identity_idet unereasonfacultative d’une ligne, de 1024 octets au plus, enregistrée comme raison de révocation). L’identité doit appartenir àaddress. La règle de retrait est celle de pepsi-keys identity revoke : la moitié privée d’une clé de signature seule est détruite, celle d’une clé de chiffrement est conservée afin que le courrier déjà chiffré vers elle reste lisible. Une clé OpenPGP dont la moitié privée est détenue reçoit d’abord son certificat de révocation, comme avec pepsi-keys identity revoke : le Web Key Directory le sert, et pour une clé qui avait été téléversée sur un serveur de clés, il est mis en file pour pepsi-keys identity publish –retry. Le résultat consignerevocation_certificate,wkd_serves_revocation,key_server_upload_dueet, danspublished, les mêmes phrases que porte la réponse par e-mailretire. Effectuée sous le rôlepepsi-crypto, car détruire une moitié privée écrit la colonne privée (et signer le certificat la lit). Révoquer une identité déjà révoquée ne change rien et réussit ; le résultat indique ce qui s’est produit.set-identity-flagsModifier les indicateurs d’une identité locale pour le propriétaire de son adresse (paramètres
address,identity_idet au moins l’un deis_primary(trueseulement),publishedetvks_wanted, booléens). L’identité doit appartenir àaddress; un téléversement sur un serveur de clés exige une identité OpenPGP active et la publie aussi. Ce sont les changements qu’un opérateur détenantkeys:writeeffectue directement par l’API d’administration ; un propriétaire sousown:<address>les demande sous forme de cette tâche afin que le second facteur du propriétaire, que seul l’applicateur peut vérifier, les appuie. Le résultat liste les indicateurs danschanged; donner à un indicateur la valeur qu’il a déjà réussit. Audité commekey.identity.update.reset-otpSupprime le second facteur d’une adresse (paramètre
address), ce qui est aussi la manière de déverrouiller un second facteur verrouillé par dix codes erronés ; son propriétaire s’enrôle ensuite de nouveau. Exécuté sous le rôlepepsi-crypto, le seul qui dispose de droits surpepsi.otp_key. Supprimer un second facteur qui n’existe pas réussit et le signale.confirm-enrolmentVérifier le code de second facteur d’un propriétaire pour la connexion à la console par e-mail (paramètres
addresset unotpfacultatif) et ne rien changer d’autre. pepsi-httpd(1) crée une session de navigateur détenantown:<address>pour quiconque suit un lien envoyé à l’adresse, mais ne peut pas lirepepsi.otp_key; il met cette tâche en file sous la propre portée de l’adresse et n’ouvre la session que lorsque la tâche se terminedone. Une adresse sans second facteur passe.confirm-loginVérifier le code de second facteur d’un administrateur qui se connecte à la console avec un mot de passe (paramètres
loginetotp) et ne rien changer d’autre. Un compte de console doté d’un second facteur TOTP (pepsi-keys otp enroll --console LOGIN) le conserve danspepsi.otp_keysous le sujetconsole <login>, que pepsi-httpd(1) ne peut pas lire ; une fois le mot de passe vérifié, il met cette tâche en file et n’ouvre la session que lorsque la tâche se terminedone. Un code manquant, erroné, rejoué ou verrouillé la fait échouer, et un code erroné compte pour le verrouillage. C’est la seule sorte admise sans aucune portée, puisque personne n’en détient avant de se connecter ; elle doit tout de même avoir été écrite parpepsi-configcomme toute autre ligne, et le point de terminaison des tâches de l’API d’administration la refuse.identity-csrConstruire une demande de certificat PKCS#10 sur la clé existante d’une identité S/MIME (paramètres
address,identity_idet undisplay_namefacultatif d’une ligne, de 128 octets au plus, leCNdu sujet). L’identité doit appartenir àaddress, être S/MIME et détenir une moitié privée. Le nom alternatif du sujet est toujours l’adresse propre de l’identité, jamais un paramètre, de sorte qu’une tâche ne peut pas demander à une CA de certifier une autre boîte aux lettres sur cette clé. Effectuée sous le rôlepepsi-cryptoparce que la demande est signée avec la clé privée, exactement comme le fait pepsi-keys identity csr ; la demande PEM est le résultat de la tâche (csr_pem), où le demandeur la lit. Auditée commekey.identity.csr.identity-certificateInstaller le certificat qu’une CA a émis pour une identité S/MIME (paramètres
address,identity_idetcertificate, qui est en PEM ou en DER encodé en base64, 64 Kio au plus ; un lot PEM apporte son premier certificat). Refusé sauf si le certificat porte sur la propre clé de l’identité (vérifié par rapport à la clé privée ouverte), nommeaddressdans sonrfc822Name, est un certificat d’entité finale autorisantemailProtectionavec l’usage de clé dont l’objectif de l’identité a besoin, et n’a pas expiré. L’applicateur remplace alors la moitié publique, l’empreinte et l’expiration et ré-enveloppe la clé privée sous la nouvelle empreinte (les données authentifiées de l’enveloppe lient le blob à celle-ci) en un seulUPDATEgardé ; une identité qui avait expiré sur son ancien certificat redevient active. Installer le certificat déjà en place ne change rien et le dit. Effectuée sous le rôlepepsi-cryptoparce que le ré-enveloppement écrit la colonne privée. Auditée commekey.identity.certificate.
Ces huit-là agissent sur une adresse plutôt que sur le déploiement, et sont autorisées différemment (voir Les deux barrières).
Le second facteur du propriétaire. generate-identity, register-client-key, revoke-identity, set-identity-flags, confirm-enrolment, identity-csr et identity-certificate acceptent un paramètre facultatif otp (six chiffres). Lorsqu’une tâche est admise sur la seule base de own:<address>, c’est-à-dire lorsque c’est le propriétaire de l’adresse qui demande et non un opérateur détenant keys:write, l’applicateur vérifie le code par rapport au second facteur de l’adresse (voir pepsi-keys(1), otp) avant de faire quoi que ce soit : une adresse qui n’en a pas n’a besoin d’aucun code, et un code manquant, erroné, rejoué ou verrouillé fait échouer la tâche avec la raison. La tentative est enregistrée (un code erroné compte pour le verrouillage) et un code est consommé même si la tâche échoue ensuite.
95.1.43.1.10.3. Ce qui est délibérément absent¶
Il n’y a aucune tâche de redémarrage, de rechargement ou d’arrêt, et il n’y en aura pas ; c’est la même décision qui tient le contrôle de service hors de la console. Le coût est réel : un changement de configuration exigeant le redémarrage d’un composant se termine par l’opérateur le redémarrant. Là où c’est possible, les composants prennent plutôt les changements d’eux-mêmes (la notification config_changed le fait pour la surcouche de configuration en base).
95.1.43.1.10.4. Les deux barrières¶
Une tâche n’est exécutée que lorsque les deux conditions sont réunies :
ses
scopesenregistrées contiennentsetup:write, l’autorisation que l’API d’administration a établie pour le principal qui a demandé. Pour les huit sortes d’adresse (generate-identity,register-client-key,revoke-identity,set-identity-flags,reset-otp,confirm-enrolment,identity-csretidentity-certificate), la portée requise est à la placekeys:writeouown:<address>pour exactement l’adresse nommée dans les paramètres de la tâche : un utilisateur gérant sa propre clé ne configure pas le serveur, etsetup:writeseul ne suffit pas.reset-otprevient au seul opérateur et n’accepte pasown:<address>. L’adresse est prise dans les paramètres analysés, jamais dans la liste de portées, de sorte qu’un principal confiné à une adresse ne peut en nommer une autre ; etson
written_byest le rôle de basepepsi-config, ce qui prouve que la ligne a atteint la table par l’unique chemin que nous contrôlons. Cette colonne est forcée depuiscurrent_userpar un déclencheurBEFORE INSERT: c’est donc un fait sur la connexion plutôt qu’une prétention dans la charge utile, et il n’existe aucune écriture de l”INSERTqui fasse passer une valeur falsifiée.
pepsi-setup run impose la seconde moitié face à PostgreSQL à chaque exécution : seul pepsi-config peut faire un INSERT dans setup_task ; pepsi-httpd ne peut que SELECT (il met en file par la connexion [pepsi-admin] CONFIG_DB distincte) ; et aucun compte traitant du courrier ne peut toucher la table. Un worker d’étape analyse du courrier hostile pour vivre et ne doit pas pouvoir mettre du travail devant un processus root. Cela est vérifié, non affirmé : une divergence est une erreur dure nommant le rôle et le privilège.
95.1.43.1.10.5. Ce qu’il ne peut pas promettre¶
L’applicateur n’a jamais vu la requête HTTP : il ne peut donc pas réauthentifier le principal. scopes est une prétention consignée par la surface d’administration ; ce que l’applicateur vérifie, c’est que la prétention a été consignée par le seul rôle autorisé à la consigner. Une compromission de pepsi-httpd conjointement à son identifiant de base de configuration atteint donc la liste fermée de tâches ci-dessus. C’est le risque résiduel, et c’est pourquoi la liste est fermée et petite plutôt que commode.
95.1.43.1.10.6. Retirer la capacité : le paquet pepsi-httpd-admin¶
L’applicateur n’est jamais démarré que par l’activation par socket de systemd sur la sonnette que pepsi-httpd actionne. Ces deux fichiers d’unité, pepsi-setup-apply.socket et pepsi-setup-apply.service, constituent donc l’intégralité du chemin d’une requête HTTP à un changement sous /etc/pepsi, et Debian les livre dans un paquet binaire à eux, pepsi-httpd-admin.
pepsi le Recommends, de sorte qu’une installation par défaut l’ait et que la console de navigateur fonctionne comme documenté. Un opérateur qui administre ce déploiement depuis un terminal le retire
apt remove pepsi-httpd-admin
et pepsi reste installé. Une installation depuis les sources a le même levier avec make install INSTALL_ADMIN_UNITS=no.
Ce que cela retire est le mécanisme, non un bouton. Une fois les unités parties, rien ne démarre l’applicateur : une ligne setup_task est donc inerte quelle qu’ait été son arrivée. pepsi-httpd détecte la sonnette manquante et sert ses pages de configuration et de mise en place en lecture seule, refusant les mutations d’API correspondantes avec 503 setup_applier_unavailable ; voir pepsi-httpd(1), L’applicateur privilégié, et s’en passer.
pepsi-setup lui-même reste dans le paquet pepsi et n’est pas affecté. pepsi-setup run, pepsi-setup --wizard, pepsi-setup check et même pepsi-setup apply --once fonctionnent toujours : root exécutant le programme, c’est root qui agit, ce que ceci ne restreint pas. Ce que cela retire, c’est la capacité de la couche web à faire que cela arrive.
Note
Le retrait du paquet ne révoque délibérément pas le droit de base qui permet au rôle pepsi-config de faire un INSERT dans pepsi.setup_task, pour trois raisons : un script de mainteneur aurait besoin d’un cluster joignable et d’un identifiant de superutilisateur qu’il n’a pas, de sorte qu’une mesure de durcissement pourrait se muer en échec de retrait ; le droit n’est pas la frontière qui compte, car une ligne que rien ne vide est inerte et les deux barrières de l’applicateur s’appliquent de toute façon ; et une réinstallation ultérieure reviendrait avec une console cassée d’une manière dont le message d’erreur désigne la socket plutôt que le droit.
Un site qui veut la ceinture et les bretelles peut le faire à la main, et pepsi-setup run (qui réapplique les droits) le remet en place
REVOKE INSERT ON pepsi.setup_task FROM "pepsi-config";
95.1.43.1.10.7. Auditabilité¶
Chaque tâche est une ligne durable : qui a demandé, ce qui a été demandé, quand elle a commencé et fini, ce qu’elle a produit, et ce qui a mal tourné. Chaque admission, refus, succès et échec est en outre écrit au journal d’audit (setup.task.requested, setup.task.refused, setup.task.done, setup.task.failed), qui est en ajout seul pour chaque composant traitant du courrier. Les lignes de progression sont diffusées dans setup_task_log à mesure du travail, de sorte qu’une exécution de certbot ou une installation de schéma puisse être observée sans que l’applicateur retienne une connexion HTTP.
Les écritures de l’applicateur sont annoncées, de sorte que personne qui surveille une tâche n’a à interroger la base de données encore et encore. Deux triggers dans procedures.sql notifient avec l’identifiant de la tâche comme charge utile : setup_task_progress pour chaque ligne de setup_task_log, et setup_task_done lorsqu’une tâche devient done, failed ou refused, quel que soit l’auteur de cette transition : l’applicateur qui règle une tâche, ou l’applicateur qui récupère une tâche qu’un applicateur antérieur a laissée running. L’applicateur lui-même n’émet aucun pg_notify ; pepsi-httpd(1) écoute sur les deux canaux et réveille les requêtes qui attendent cette tâche (GET /api/v1/setup/tasks/{id}?wait= et la page de tâche de la console). Le canal setup_task qui réveille l’applicateur est un canal différent et n’est déclenché par aucun des deux.
95.1.43.1.11. 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 (voir FILES). pepsi-setup réécrit aussi ce fichier sur place lorsqu’il auto-remplit les chemins de certificat TLS, la socket du reverse-proxy, le secret de preuve d’origine, la référence à la clé de chiffrement de clés, l’identifiant système de télémétrie et le
[pepsi] MAILBOX_FS_QUOTAsondé. Lorsque -c est omis, il résout le même emplacement par défaut depuis lequel la configuration a été chargée, normalement/etc/pepsi/pepsi.conf, et réécrit ce fichier, de sorte qu’un simplepepsi-setup runse comporte commepepsi-setup -c /etc/pepsi/pepsi.conf run. Il ne signale le chemin comme inconnu que lorsqu’aucun fichier de configuration n’existe à un emplacement par défaut.- –no-certbot
Ne pas invoquer
certbotpour obtenir les certificats TLS manquants. La disposition de chemin certbot est tout de même remplie dans la configuration lorsque nécessaire ; un certificat alors absent est différé, non fatal : l’hôte est listé dans le résumé de fin d’exécution avec un message actionnable, et le reste de l’exécution (schéma, clés, DNS) se poursuit. Utilisez ceci lorsque les certificats sont gérés par d’autres moyens, et notez qu’une sortie réussie n’affirme donc pas que chaque certificat configuré est présent.- –no-reverse-proxy
Ne pas s’auto-intégrer à un serveur HTTP frontal existant. pepsi-httpd lie alors le port 443 directement au lieu d’être basculé vers une socket UNIX derrière un reverse proxy (voir l’étape 3 de la Description). Utilisez ceci lorsqu’aucun autre serveur web n’occupe le 80/443, ou lorsque vous câblez le reverse proxy à la main.
- -y, –yes-to-all
Supposer « oui » à chaque invite interactive que la configuration initiale peut soulever (actuellement la proposition d’installer le drop-in Dovecot, étape 4), de sorte qu’une exécution ne bloque jamais en attente d’une saisie, ce qui est utile dans les scripts et les déploiements non interactifs. Mutuellement exclusif avec -n.
- -n, –no-to-all
Supposer « non » à chaque invite interactive : la configuration initiale n’entreprend aucune action proposée et imprime à la place ce qu’il aurait fait (par exemple le drop-in Dovecot à déployer à la main), puis le diffère. Rend aussi l’exécution entièrement non interactive.
- –wizard
Exécuter l’assistant de configuration interactif (voir Assistant). La configuration est écrite dans le chemin -c, ou dans
/etc/pepsi/pepsi.conflorsqu’aucun -c n’est donné. Contrairement aux autres modes, ceci ne nécessite pas de fichier de configuration existant. Il ne prend aucune sous-commande (pepsi-setup --wizard runest refusé) : à la fin, il propose d’exécuter lui-même la configuration complète. Les options ci-dessous qui indiquent « avec –wizard » sont refusées sans lui, sauf--expert=help.- –force
Avec –wizard, écraser un fichier de configuration existant qui n’a pas de réponses
[pepsi-wizard]importables sans demander confirmation.- –expert SPEC
Avec –wizard, poser aussi les questions sur les options Pepsi plus profondes que le questionnaire décide normalement à votre place. SPEC est un groupe (
high,insane), une liste de noms d’options séparés par des virgules, ou les deux ;--expert=helples liste et quitte. Voir Options expertes.- –answers FILE
Avec –wizard, répond à chaque question depuis l’objet JSON contenu dans FILE au lieu de la poser : les clés sont les identifiants de question qu’imprime pepsi-setup questions (plus les noms d’options expertes), et une question à laquelle le fichier ne répond pas prend la valeur par défaut de l’assistant, comme le ferait un appui sur Entrée. Une clé inconnue ou une réponse de forme incorrecte est une erreur. Rien n’est lu sur l’entrée standard, et toutes les autres invites prennent aussi leur valeur par défaut, en particulier l’offre finale « Exécuter la configuration maintenant » ; exécutez donc pepsi-setup run ensuite. Voir Répondre sans terminal.
- –import MTA
Avec –wizard, importer les valeurs par défaut depuis ce MTA existant (
postfix,exim,sendmail,qmail,stalwart) au lieu de proposer un menu de ce qui a été détecté. Contrairement à l’autodétection, ceci s’applique aussi lorsqu’un fichier de configuration existe déjà, et fonctionne sur un stdin non interactif. Voir Migrer depuis un autre MTA.- –no-import
Avec –wizard, ne pas chercher du tout une configuration de MTA existante.
- –import-root DIR
Avec –wizard, lire le MTA à importer sous DIR au lieu de
/, par exemple une sauvegarde ou la configuration d’une autre machine copiée en place. C’est la même option que la sous-commande import orthographie –root.- -L LOGLEVEL, –log LOGLEVEL
Règle la verbosité de la journalisation. LOGLEVEL vaut
error,warn,info,debugoutrace(par défaut :info). Contrairement aux autres programmes de Pepsi, pepsi-setup n’honore pas[pepsi] LOGniLOG_JSON: la journalisation est mise en place avant le chargement de la configuration (et l’assistant s’exécute avant qu’il n’en existe une), passez donc -L explicitement.- -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.43.1.12. Code de sortie¶
- 0
Achèvement réussi.
- 1
Une erreur s’est produite : un fichier de configuration malformé, un nom de domaine ou une entrée
PUBLIC_IPinvalide, un fichier de configuration qui n’a pu être écrit, l’échec d’une connexion à la base de données, ou une clé qui n’a pu être écrite. La raison est écrite dans le journal.Un certificat TLS manquant qui n’a pu être obtenu ne figure pas dans cette liste : il est différé et signalé dans le résumé de fin d’exécution (étape 4), et l’exécution réussit tout de même.
- 2
La ligne de commande elle-même était erronée (une option inconnue, une option globale écrite après la sous-commande, une option propre à
--wizardsans –wizard).- 78
Le schéma de base de données ne peut pas être utilisé par cette version : schema (et run) refusent un schéma plus récent que ce programme, un schéma construit à partir d’une autre copie d’un fichier de patch, un schéma sans enregistrement d’installation, et un
SQL_DIRdont les fichiers ne sont pas ceux avec lesquels ce binaire a été construit (voir schema).
95.1.43.1.13. Fichiers¶
Lorsque –config n’est pas fourni, le premier fichier existant de la liste suivante est utilisé :
$XDG_CONFIG_HOME/pepsi.conf$HOME/.config/pepsi.conf/etc/pepsi/pepsi.conf/etc/pepsi.conf
Notez les deux derniers : chaque programme Pepsi préfère le /etc/pepsi/pepsi.conf canonique au simple /etc/pepsi.conf, parce que l’empaquetage, les unités systemd et @inline-secret@ nomment tous le sous-répertoire, et qu’une copie périmée directement dans /etc ne doit pas masquer le fichier que lisent les services en cours d’exécution. Lorsque plusieurs de ces fichiers existent, pepsi-setup consigne celui qu’il utilise et ceux qui sont ignorés.
pepsi-setup ne conserve aucune clé de signature. Les clés DKIM et ARC sont celles de pepsi-dkim(1), sous [pepsi-dkim] STATE_DIR (par défaut /var/lib/pepsi-dkim) ; check, run et la console lisent leur état public dans PUBLIC_DIR/status.json (par défaut /var/lib/pepsi-dkim-public/status.json). [pepsi] KEY_DIR (par défaut /var/pepsi/keys) est l’endroit où la version 0.0.0 conservait ses fichiers de clés DKIM, que run supprime.
À côté du fichier de configuration, –wizard écrit aliases (la table d’alias, convertie depuis les tables de routage du MTA précédent lorsqu’un import a eu lieu), username.map (la table d’identité de soumission), secrets.d/*.secret (les secrets externalisés) et, après une migration, import-report.txt. Un fichier qui existe déjà n’est jamais écrasé par un import : le contenu converti est écrit dans <name>.imported à la place.
95.1.43.1.14. Exemples¶
Amorcer un nouveau déploiement et capturer les enregistrements DNS à publier
pepsi-setup -c /etc/pepsi/pepsi.conf run > pepsi-dns.zone
Relancer après une mise à niveau qui livre de nouvelles migrations (les clés et le DNS sont inchangés sauf si un nouveau domaine a été ajouté)
pepsi-setup -c /etc/pepsi/pepsi.conf run
Valider la configuration et réinitialiser la base de données à partir de zéro
pepsi-setup -c /etc/pepsi/pepsi.conf run --reset
Après avoir publié (ou changé) le DNS, vérifier ce qui est réellement en service par rapport à ce que Pepsi attend
pepsi-setup -c /etc/pepsi/pepsi.conf check
Rendre le pipeline d’étapes en PNG pour examiner comment les messages sont acheminés
pepsi-setup -c /etc/pepsi/pepsi.conf visualize | dot -Tpng -o pipeline.png
Avant de migrer, voir ce qui serait repris du serveur de courrier que cet hôte fait tourner aujourd’hui (rien n’est écrit)
pepsi-setup import
Migrer depuis Postfix, en répondant aussi aux questions plus profondes
pepsi-setup --wizard --import postfix --expert=high
Inspecter ce que produirait une migration à partir du /etc d’une autre machine, sauvegardé sous /mnt/oldhost
pepsi-setup import postfix --root /mnt/oldhost --out /tmp/migration
95.1.43.1.15. Voir aussi¶
pepsi-config(1), pepsi.conf(5), pepsi-ingress(1), pepsi-stage-relay-to-smarthost(1), pepsi-keys(1), pepsi-keydisc(1)
95.1.43.1.16. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.