95.1.1. pepsi-ingress

receive incoming e-mail over SMTP and store it for Pepsi

Section du manuel:

1

95.1.1.1.1. Nom

pepsi-ingress - serveur SMTP qui stocke l’e-mail entrant dans PostgreSQL.

95.1.1.1.2. Synopsis

pepsi-ingress [GLOBAL-OPTIONS] serve

95.1.1.1.3. Description

pepsi-ingress est le composant de réception du courrier de Pepsi. Il exécute un serveur SMTP (un Message Transfer Agent) qui accepte l’e-mail entrant en clair, en TLS implicite et via STARTTLS. Un client peut envoyer le corps du message avec DATA ou, s’il les prend en charge, avec CHUNKING/BDAT (RFC 3030), que la réponse EHLO annonce. Il stocke chaque message accepté dans la table workqueue du schéma pepsi d’une base de données PostgreSQL, avec son enveloppe, une petite quantité de métadonnées analysées et les métadonnées d’origine SMTP de la connexion qui le remet (IP du client, nom HELO/EHLO, TLS, écouteur, DNS inverse/iprev ; voir pepsi.conf(5)). Le message est stocké scindé en une colonne headers (tout jusqu’à la ligne vide) et un corps, de sorte que les étapes en aval qui ne touchent que les en-têtes n’aient pas à charger le corps. Le corps est une ligne de sa propre table, workqueue_body, que la ligne du message référence : chaque ligne de destinataire que le pipeline scinde ensuite du message partage cette unique copie (voir pepsi.conf(5), Données stockées). Le message entre dans le pipeline d’étapes à l’étape initiale (stage = init). Une fois la ligne validée, un NOTIFY sur le canal workqueue réveille pepsi-dispatch(1). L’ingress envoie cette notification hors bande et la regroupe : il en envoie au plus une par DISPATCH_WAKE_INTERVAL (par défaut 5 ms), de sorte qu’une rafale d’admissions ne réveille le dispatcher qu’une fois. Il procède ainsi parce qu’une transaction porteuse d’une notification ne peut pas valider en groupe, ce qui sérialiserait chaque session SMTP concurrente derrière son propre fsync. Rien n’est en danger si l’une d’elles est perdue : le balayage POLL_INTERVAL du dispatcher est le filet de sécurité, le coût n’est donc que de la latence.

Le serveur accepte le courrier pour un ensemble configuré de domaines (ACCEPTED_DOMAINS), comparés sous leur forme IDNA, de sorte que l’une ou l’autre graphie d’un domaine internationalisé (U-label ou A-label) désigne le même domaine servi, comme pour la remise. Au sein de ces domaines, une partie locale n’est refusée que lorsque l’hôte peut dire que rien ne l’accepterait (voir Destinataires inconnus au RCPT) ; les destinataires en dehors des domaines configurés sont rejetés comme relayage (550) sauf si la session est authentifiée. La seule exception est un locataire Exchange Online nommé par une section [pepsi-ingress-exchange-online-*] (voir pepsi.conf(5)) : depuis ses SENDER_NETWORKS, avec un expéditeur d’enveloppe dans l’un de ses DOMAINS, un tel destinataire est accepté pour l’instant, et le message n’est relayé que s’il prouve le locataire à la fin des données ; sinon il est refusé avec 550 5.7.1. La boîte aux lettres réservée sans domaine <Postmaster> est toujours acceptée quels que soient les domaines configurés (RFC 5321 §4.5.1) et réécrite en une adresse routable, afin que le reste du pipeline (alias, remise locale, relais) l’achemine comme tout destinataire ordinaire. Cette adresse est [pepsi-ingress] POSTMASTER lorsqu’il est défini, sinon postmaster@HOSTNAME. Pour faire parvenir le courrier postmaster à une personne, soit pointez POSTMASTER vers une vraie boîte aux lettres, soit ajoutez un alias pour l’adresse réécrite dans une carte ALIASES de pepsi-stage-aliases. Un tel message est aussi validé avec state.spam = false afin que les barrières de langue et de péage à l’envoi (pepsi-stage-block-language(1), pepsi-stage-anti-spam(1)) le transmettent. Cela garde la boîte aux lettres postmaster joignable comme l’exige la RFC 5321 §4.5.1, mais ne se produit que lorsque ``<Postmaster>`` était l’unique destinataire de la transaction. Un message adressé au postmaster et à une boîte aux lettres ordinaire est validé sans ce contournement et passe les barrières comme tout autre, car autrement un spammeur pourrait exempter le courrier d’une vraie victime simplement en ajoutant à côté un RCPT <Postmaster>.

Lorsque SRS est configuré (la section partagée [pepsi-srs] ; voir pepsi-stage-srs(1)), un destinataire du domaine SRS dont la partie locale est un jeton Sender Rewriting Scheme valide est décodé en retour vers l’expéditeur d’origine et accepté pour un relais vers cet expéditeur. Cela se produit même si le domaine de l’expéditeur n’est pas un domaine que sert Pepsi, car la signature valide autorise le relais ; c’est ainsi que les rebonds vers du courrier que Pepsi a relayé retrouvent leur chemin vers les expéditeurs d’origine. Un jeton falsifié ou expiré est rejeté (550), sans dire lequel des deux il était. Comme accepter un tel destinataire autorise un relais, ce couple accepter/rejeter est un oracle en ligne sur la signature SRS ; une connexion qui présente trois destinataires SRS invalides est donc journalisée en warn et fermée avec 421, de sorte qu’une recherche de jeton valide coûte une connexion par tranche de trois essais et soit visible pour la surveillance des abus.

Une copie qu’un alias ou un ~/.forward a envoyée hors site porte à la place une adresse de retour de réexpédition (fwd+<sealed>=<tag> dans le domaine SRS ; voir pepsi-stage-srs(1)). L’ingress n’accepte un destinataire de cette forme que lorsque l’expéditeur d’enveloppe est <>, que l’adresse se vérifie sous le secret courant ou un secret de PREVIOUS_SECRET_FILE et qu’elle date de moins de [pepsi-srs] MAX_AGE_DAYS ; tout autre cas reçoit 550 5.1.1 comme une adresse SRS falsifiée et compte dans la même limite de trois. Un tel rapport voyage seul : un second destinataire à côté de lui, de l’une ou l’autre sorte, reçoit 452 4.5.3. Le rapport n’est pas remis ni relayé. À la fin des données, l’ingress journalise ses champs Reporting-MTA, Final-Recipient, Action, Status et Diagnostic-Code et stocke une ligne à l’étape de rebond. À partir de cette ligne, l’étape de rebond écrit à l’expéditeur d’origine le propre DSN de cet hôte : l’adresse que l’expéditeur a utilisée comme Final-Recipient, un diagnostic générique de la classe de statut du rapport, et les propres champs d’adressage de l’expéditeur tirés du bloc d’en-têtes renvoyé (aucun pour un message arrivé chiffré). L’étape de rebond est le BOUNCE_STAGE de l’étape exécutant pepsi-stage-srs(1), sinon une étape nommée bounce exécutant pepsi-stage-bounce(1), sinon la première étape exécutant pepsi-stage-bounce(1). Un rapport avec Action: delivered, relayed ou expanded est abandonné ; tout ce qui n’est pas un rapport d’état de remise compte comme un échec. La ligne est marquée state.forward_return. Sans étape de rebond configurée, le rapport est abandonné et le démarrage avertit à ce sujet.

La réception d’un message n’est confirmée au client (250) qu’après que le message a été validé durablement dans la base de données ; si la base de données est indisponible, le client reçoit une erreur transitoire (451) et est censé réessayer.

Comme l’exige la RFC 5321 §4.4, pepsi-ingress ajoute en tête un en-tête de trace Received: à chaque message accepté, nommant le client connecté (nom HELO/EHLO, DNS inverse et IP), ce serveur, le transport utilisé (SMTP, ESMTP, ESMTPS, ESMTPA ou ESMTPSA selon la RFC 3848 — voir Authentification ci-dessous) et l’heure de réception ; une clause for nomme le destinataire seulement pour une transaction à destinataire unique. L’en-tête est ajouté avant l’authentification de sorte que le sceau ARC (ajouté plus tard par pepsi-stage-arc(1)) le couvre.

Sur un écouteur avec RECEIVED_PRIVACY, la clause from est entièrement omise, de sorte que l’en-tête se lit Received: by <HOSTNAME> (pepsi-ingress) with ESMTPSA …. C’est la valeur par défaut pour un écouteur SUBMISSION, la socket de soumission locale comprise. L’adresse IP du soumissionnaire, son nom inverse et son nom EHLO (généralement celui de sa machine) ne sont ainsi pas révélés à chaque destinataire et à chaque archive, comme le propose draft-josefsson-email-received-privacy. Les champs User-Agent et X-Mailer du client sont retirés avec elle. La clause by que compte MAX_SELF_HOPS, le mot-clé de protocole, le commentaire TLS et la clause for sont écrits sans changement, et le journal consigne toujours le client pour le traitement des abus. RECEIVED_PRIVACY = no rétablit la clause complète sur un écouteur de soumission ; yes l’applique à un écouteur MX.

Pour une session chiffrée, le mot-clé ESMTPS à lui seul n’enregistre pas quelle version TLS ni quelle suite de chiffrement ont été négociées. Comme le recommande la RFC 8314 §4.3, pepsi-ingress ajoute donc les paramètres négociés sous forme d’un commentaire après le mot-clé with, par exemple

by mail.example.org (pepsi-ingress) with ESMTPS
    (version=TLSv1_3 cipher=TLS13_AES_128_GCM_SHA256)

Ces valeurs sont les mêmes paramètres TLS notés dans le state du message sous origin.tls (voir pepsi.state(7)) ; le commentaire comprend la version et la suite de chiffrement dans la mesure où la pile TLS les rapporte.

Un en-tête X-Pepsi-List-Hops: (le compteur de boucles des listes de diffusion) est retiré de chaque message arrivant sur une session non authentifiée, puisqu’un expéditeur pourrait sinon remettre le compteur à zéro ; la copie d’une session authentifiée est conservée. Chaque champ Bcc: et Resent-Bcc: est retiré de chaque message, qu’il ait été soumis ou qu’il vienne de l’extérieur. Selon la RFC 5322 section 3.6.3, les destinataires en copie cachée sont retirés avant l’envoi ; l’enveloppe les porte déjà. Dans le courrier soumis, un champ que le client a laissé montrerait les destinataires cachés à tous les autres. Dans le courrier venu de l’extérieur, le champ ne signifie rien pour un destinataire, tandis qu’un client de messagerie qui l’inclut dans un « Répondre à tous » enverrait la réponse à une adresse que l’utilisateur n’a jamais vue, en citant ce que Pepsi a déchiffré. Les champs sont retirés après SPF/DKIM/DMARC, de sorte qu’une signature qui les couvre est vérifiée sur les octets qui ont été signés.

Plusieurs flux SMTP sont traités en concurrence. Plusieurs écouteurs peuvent être configurés, chacun lié à son propre port TCP, sa socket de domaine UNIX, ou une socket héritée d’un parent systemd via l’activation par socket, et chacun avec son propre mode de transport. Tout le comportement est piloté par un fichier de configuration de style INI (voir pepsi.conf(5)).

Le schéma de base de données est installé par pepsi-setup(1), qui applique les migrations de chaque composant au schéma pepsi partagé ; pepsi-ingress lui-même n’a pas de commande d’initialisation de schéma.

95.1.1.1.3.1. Extensions SMTP

La réponse EHLO annonce exactement ces mots-clés, dans cet ordre

SIZE <MAX_MESSAGE_SIZE>
8BITMIME
SMTPUTF8
PIPELINING
CHUNKING
DSN
ENHANCEDSTATUSCODES
RRVS

SIZE (RFC 1870) annonce [pepsi-ingress] MAX_MESSAGE_SIZE, qui est un réglage valable pour tout le serveur plutôt que par écouteur. Un corps DATA qui le dépasse est lu jusqu’à sa fin et reçoit 552 5.3.4, de sorte que la session reste utilisable ; mais dès que MAX_MESSAGE_SIZE octets supplémentaires sont arrivés sans le marqueur de fin de données, le serveur répond 552 5.3.4 aussitôt et ferme la connexion (RFC 1870 section 6.2), comme il le fait pour un fragment BDAT trop grand à lui seul.

À la fin des données, le bloc d’en-têtes de premier niveau est lui aussi borné : plus de MAX_HEADER_FIELDS (1000 par défaut) champs, ou un champ de plus de MAX_HEADER_FIELD_SIZE (100 Kio par défaut, compté une fois déplié), reçoit 552 5.3.4 et le message n’est pas stocké, sur chaque écouteur. Le stockage de courrier situé derrière Pepsi analyse chaque champ de chaque message, et les avis Dovecot CVE-2024-23184 et CVE-2024-23185 demandent au MTA placé devant de les borner. Les blocs d’en-têtes des messages joints ne sont pas comptés ; ils restent bornés par MAX_MESSAGE_SIZE.

Les lignes d’un corps DATA doivent se terminer par CRLF : un LF nu n’importe où reçoit 500 5.6.0 et la connexion est fermée, de même qu’un point qu’un CR nu encadre en marqueur de fin de données (<CR>.<CR>, ou <CR>. / .<CR> à côté d’un CRLF). La RFC 5321 section 2.3.8 interdit les CR et LF nus dans un corps, et un destinataire qui prendrait l’un ou l’autre pour une fin de ligne verrait le message se terminer là et lirait le reste du corps comme une seconde transaction (SMTP smuggling). Les autres CR nus sont acceptés et relayés sans changement.

Trois autres mots-clés sont conditionnels. STARTTLS (RFC 3207) est annoncé sur un écouteur disposant de matériel TLS tant que la session est encore en clair, c’est-à-dire avec MODE = starttls, puisque MODE = tls est chiffré dès le premier octet. REQUIRETLS (RFC 8689) n’est annoncé qu’une fois la session protégée par TLS (voir Exiger TLS), et AUTH PLAIN LOGIN (RFC 4954) uniquement sur une session déjà chiffrée dont l’écouteur configure un arrière-plan SASL_TYPE.

Rien d’autre n’est proposé. BINARYMIME en particulier n’est ni annoncé ni accepté (voir Contenu 8 bits et internationalisé) ; VRFY reçoit la réponse non engageante 252 et EXPN est décliné par 502, puisque le §7.3 de la RFC 5321 fait de la divulgation de l’appartenance à une liste une fuite d’information plutôt qu’un service.

Certaines lignes de commande font en réalité partie d’une requête HTTP : une ligne de requête (GET, POST ou CONNECT avec n’importe quels arguments, ou HEAD, PUT, DELETE, OPTIONS, TRACE ou PATCH se terminant par une version HTTP/) ou une ligne d’en-tête Host: ou User-Agent:. Une telle ligne reçoit une seule fois 554 5.5.0, la connexion est fermée et l’événement est journalisé. La ligne provient d’une attaque inter-protocoles, dans laquelle une page web fait envoyer par un navigateur un POST vers le port SMTP ou un proxy HTTP est invité à s’y connecter ; y répondre par un 500 ordinaire laisserait le corps de requête qui suit s’exécuter comme des commandes SMTP. Les autres lignes qui ne sont pas du tout des commandes reçoivent 500 ; la dixième d’une session reçoit 421 4.7.0 Too many unrecognized commands et la connexion est fermée (une commande connue avec un mauvais argument, 501, ne compte pas). La limite est fixe : un client de messagerie n’envoie pas dix verbes inconnus, alors qu’un autre protocole visant le port le fait.

La même attaque peut arriver à l’intérieur de TLS : un navigateur attiré dans une connexion TLS vers le port SMTP mène à bien la poignée de main avec le certificat du serveur de courrier. Un ClientHello TLS dont l’offre ALPN ne nomme que des protocoles HTTP (http/1.1, h2, h3 et leurs apparentés) est donc refusé avec une alerte no_application_protocol et journalisé. Un ClientHello sans ALPN, ou proposant smtp ou tout autre identifiant à côté des identifiants HTTP, se poursuit ; l’ingress ne sélectionne aucun protocole, puisque les clients de messagerie bâtis sur une pile TLS générique peuvent proposer n’importe quoi ou rien. Le nom de serveur que demande un client (SNI) n’est pas imposé : les MTA envoient le nom du MX, le domaine, ou rien.

95.1.1.1.3.2. Authentification

Avant qu’un message ne soit stocké, pepsi-ingress l’authentifie, afin que les destinataires en aval puissent encore voir le verdict auquel Pepsi est parvenu à la limite, même après que Pepsi a relayé le courrier et rompu l’alignement SPF et DKIM d’origine. Pour chaque message accepté, il :

  1. vérifie SPF (sur l’identité MAIL FROM, en utilisant l’IP du client connecté), DKIM et DMARC ; et

  2. ajoute en tête un en-tête Authentication-Results rapportant ces résultats, avec le [pepsi-ingress] HOSTNAME comme authserv-id, et note le texte de résultat rendu sous state.origin.ar_results.

ARC est géré séparément : l’ingress ne scelle pas le message, et le verdict de chaîne que consigne la ligne ne vient pas de l’ingress. L’étape de pipeline pepsi-stage-arc(1) vérifie toute chaîne ARC entrante et ajoute le nouvel ensemble ARC (AAR/AMS/AS) sous l’identité [pepsi] ARC_DOMAIN. Elle lit le contexte de session que l’ingress a noté dans le state de la ligne : l”authserv-id, l’IP du client, le HELO/EHLO et le fragment ar_results. Réutiliser ce fragment permet à l’étape de construire l’AAR sans réexécuter SPF/DKIM/DMARC, de sorte que les vérifications d’authentification ont lieu exactement une fois, et cela garde les clés de signature ARC hors du frontal SMTP. La seule question ARC que pose l’ingress est la dérogation décrite ci-après.

La vérification est fail-open : un échec DNS ou un message inanalysable ne rejette jamais le courrier ; il est noté comme temperror/none et accepté. Ce n’est que lorsque DMARC_ENFORCE est défini qu’un échec DMARC certain sous une politique quarantine/reject provoque un rejet 550, et seulement pour une session non authentifiée : le courrier soumis n’est signé que par une étape ultérieure, et son From: relève des règles de soumission ci-dessous. La valeur par défaut compilée de l’option est désactivée, de sorte qu’une configuration qui ne la mentionne pas continue d’accepter un tel courrier pour que le destinataire final en juge (et l’étape ARC scelle le résultat en échec). --wizard de pepsi-setup(1) écrit DMARC_ENFORCE = yes pour une nouvelle installation, tandis qu’un pepsi.conf existant garde ce qu’il indique ; pepsi-setup(1) avertit au sujet d’une configuration qui laisse l’option non définie ou désactivée alors qu’un domaine servi publie p=reject. Les verdicts SPF/DKIM/DMARC sont stockés dans l’objet state.auth de la ligne (sous spf/dkim/dmarc/arc), et l”authserv-id sous state.origin ; le verdict arc commence à none et est rempli plus tard par l’étape ARC. Les résolutions DNS ont lieu de façon synchrone dans la phase DATA, de sorte qu’un résolveur lent retarde le 250.

Les listes de diffusion et les réexpéditeurs cassent DMARC pour le courrier qu’ils relaient, et un destinataire qui l’applique perdrait ce courrier. ARC (RFC 8617) est la façon dont un tel saut transmet ce qu’il a vu lorsqu’il a pris le message, et ARC_TRUSTED_SEALERS liste les sauts dont l’opérateur accepte la parole. Un message qui échoue à DMARC sous DMARC_ENFORCE est tout de même accepté lorsque deux conditions sont remplies : il porte une chaîne ARC qui se valide (cv=pass recalculé à partir des signatures, jamais lu dans la propre étiquette cv= de la chaîne), et le d= de l”ARC-Seal d’instance la plus élevée, c’est-à-dire de l’ADMD qui a scellé en dernier, est l’un des domaines listés. Seul le dernier scelleur compte : valider une chaîne vérifie l”ARC-Message-Signature le plus récent et chaque sceau, et un sceau signe les champs ARC plutôt que le message, de sorte que le dernier scelleur est la seule ADMD dont une chaîne validée prouve qu’elle a traité ces octets. Un réexpéditeur de confiance qui scelle par-dessus une chaîne qu’un saut inconnu a commencée reste la parole de ce réexpéditeur ; un saut inconnu qui scelle par-dessus l’ensemble d’un réexpéditeur de confiance ne l’est pas. Le message accepté consigne le scelleur comme state.auth.arc_override tandis que state.auth.dmarc continue d’indiquer fail, de sorte qu’une étape ultérieure puisse distinguer les deux. La liste est vide par défaut : un scelleur inconnu ne prouve rien. La chaîne n’est vérifiée que pour un message qui serait sinon refusé, et elle l’est quoi que contienne la liste : le refus 550 est journalisé avec le dernier scelleur de la chaîne, sous la forme arc-sealer=<domain> lorsque la chaîne se valide et comme une revendication lorsqu’elle ne se valide pas. Ces lignes de journal nomment les réexpéditeurs et listes dont DMARC_ENFORCE refuse le courrier ; l’opérateur y trouve donc des candidats pour ARC_TRUSTED_SEALERS (grep arc-sealer= sur le journal de l’ingress).

Un From: nommant des boîtes aux lettres dans plusieurs domaines est confronté à la politique DMARC de chacun de ces domaines (RFC 7489 section 6.6.1), au plus 10, de façon concurrente sous la même échéance. Le message ne réussit DMARC que si chaque domaine réussit, et il constitue un échec sur lequel agit DMARC_ENFORCE si la politique de l’un des domaines le demande. Chaque domaine reçoit son propre résultat dmarc= dans Authentication-Results. Deux autres cas sont refusés sous DMARC_ENFORCE, parce que DMARC ne peut pas leur être appliqué : un message sans aucun domaine d’auteur (pas de From:, ou un From: sans adresse, comme un groupe vide) est refusé 550 5.6.0, et un message dont le From: nomme plus de 10 domaines 550 5.7.1, puisque seuls les 10 premiers ont été évalués. Les deux refus ne s’appliquent qu’aux sessions non authentifiées ; le From: d’un expéditeur authentifié relève des règles de soumission ci-dessous.

Certaines signatures qui se vérifient ne sont pourtant pas une réussite DKIM. Une signature rsa-sha1 est rapportée permerror (RFC 8301 : les vérificateurs ne doivent pas en considérer une comme valide, puisque des collisions SHA-1 peuvent être fabriquées), et une signature sous une clé dont l’enregistrement DNS porte t=y est rapportée neutral (RFC 6376 section 3.6.1 : un signataire en mode test doit être traité comme du courrier non signé). Aucune ne compte pour l’alignement DMARC ni pour state.auth.dkim = pass, qui est ce que lit le dkim_required d’une ligne de liste blanche. state.auth.dkim applique aussi le mode d’alignement DMARC du domaine du From: : sous adkim=s, seule une signature dont le d= est exactement ce domaine compte, de sorte qu’il n’indique jamais pass pour un message que DMARC a fait échouer faute de signature alignée. SPF s’arrête à deux recherches vides (termes a, mx, ptr ou exists ayant reçu NXDOMAIN ou aucun enregistrement) et renvoie permerror, comme le recommande la RFC 7208 section 4.6.4, de sorte qu’un enregistrement ne peut pas faire envoyer à chaque vérificateur dix requêtes pour des noms qui n’existent pas.

Le travail est borné, car le nombre de signatures est au choix de l’expéditeur et chacune coûte une recherche DNS et une vérification de clé publique. Au plus MAX_DKIM_SIGNATURES (par défaut 10) champs DKIM-Signature sont vérifiés. Ceux dont le d= est le domaine du From: ou un parent ou un enfant de celui-ci passent en premier, puisque ce sont les seuls que DMARC puisse utiliser ; bourrer un message de signatures ne peut donc pas évincer celle qui compte. SPF et les signatures retenues sont vérifiés en parallèle sous un même délai de VERIFY_TIMEOUT (par défaut 20 s), et DMARC sous un second, de sorte qu’un message ne retient jamais sa session en vérification plus de deux fois cette durée. Une vérification qui dépasse son délai est notée temperror pour elle seule : une signature expirée dont le domaine n’est pas aligné sur celui du From: est une signature que DMARC ignore, de sorte qu’un faussaire ne peut pas ralentir son propre DNS pour transformer un échec DMARC en quelque chose sur quoi DMARC_ENFORCE n’agit pas.

Un nom d’affichage peut revendiquer une adresse que l’expéditeur ne possède pas : From: "ceo@example.com" <mallory@example.net> est une syntaxe légale, et de nombreux clients de messagerie n’affichent que le nom. Sur le courrier d’une session non authentifiée, l’ingress cherche donc une adresse dans le texte d’affichage de chaque boîte aux lettres du From:, c’est-à-dire dans le nom placé avant l’adresse <...> et dans chaque commentaire. Il juge ce texte tel qu’un client le rend : avec les encoded-words RFC 2047 décodés, normalisé selon NFKC (de sorte que les arobases pleine chasse et petite comptent comme @), et sans les caractères invisibles et de contrôle bidirectionnel. S’il en trouve une qui n’est pas la propre adresse de la boîte aux lettres (comparaison sans tenir compte de la casse, de sorte que "bob@example.net" <bob@example.net> est accepté), le message est marqué, ni refusé ni réécrit : un champ X-Pepsi-Warning: display-name-claims-other-address est ajouté en tête, et l’adresse revendiquée est consignée comme state.auth.display_name_mismatch. Tout champ X-Pepsi-Warning écrit par l’expéditeur est d’abord retiré, de sorte que chaque champ de ce type vient de Pepsi. Les soumissions authentifiées sont au contraire refusées (voir Identité de soumission ci-dessous).

Retirer les caractères de réordonnancement est juste pour cette comparaison, mais ne tient pas compte de ce qu’ils font : un forçage droite-à-gauche affiche \u202Eelpmaxe.knab@oec comme ceo@bank.example, et des caractères de largeur nulle ou un remplisseur hangul cachent du texte ou font paraître un nom vide. Un champ From: (encoded-words décodés) portant un contrôle bidirectionnel d’incorporation, de forçage ou d’isolement, une marque directionnelle ou un caractère invisible est donc marqué avec X-Pepsi-Warning: from-has-bidi-or-invisible-characters, et le champ est remis tel que reçu. L’antiliant et l’antiliant nul de largeur nulle ainsi que les sélecteurs de variante ne comptent pas, puisque les noms persans et indiens et les émojis en ont besoin.

Un nom de fichier de pièce jointe (filename de Content-Disposition ou name de Content-Type, décodé selon RFC 2231 et RFC 2047, dans n’importe quelle partie MIME, messages joints compris) portant les mêmes caractères peut afficher une autre extension que celle du fichier (invoice<RLO>fdp.exe se lit invoiceexe.pdf) ; un tel message est marqué avec X-Pepsi-Warning: attachment-name-has-bidi-or-invisible-characters, et le nom est remis tel que reçu. Un message dont la structure MIME ne peut pas être analysée n’est pas marqué.

Un domaine From: qui s’affiche comme l’un des ACCEPTED_DOMAINS sans en être un est marqué avec X-Pepsi-Warning: from-domain-resembles-served-domain, quelle qu’ait été l’authentification du propre domaine de l’expéditeur. Un tel domaine a le même squelette UTS #39 qu’un domaine servi, comme dans examp1e.org ou avec un e cyrillique (U+0435) à la place d’un e latin. Cet avertissement n’est qu’un champ d’en-tête : il ne place pas TAG_EXTERNAL sur l’objet (voir Marquage du courrier venu de l’extérieur), car cette étiquette signifie qu’une revendication d’un domaine servi n’a pas été prouvée.

95.1.1.1.3.3. Structure MIME ambiguë

Tout ce qui vient après l’ingress analyse à nouveau un message : le filtre derrière pepsi-stage-milter(1), le filtre de contenu de pepsi-stage-list-post(1) et le client de messagerie du destinataire. Là où sa structure MIME est malformée, les RFC 2045 et RFC 2046 laissent la lecture à l’analyseur, de sorte qu’un filtre peut analyser autre chose que ce qui est montré au lecteur (le filtre prend un champ Content-Type et le client un autre ; le filtre ne reconnaît jamais une frontière que le client récupère). MIME_ANOMALIES règle cela au DATA, sur les octets tels que reçus, de trois manières :

  • Les classes dures n’ont pas de lecture juste et sont refusées 554 5.6.0 : un boundary= vide sur un multipart, un octet NUL dans le bloc d’en-têtes d’une entité MIME quelconque, deux champs Content-Type ou deux champs Content-Transfer-Encoding différents sur une même entité, une frontière qui est ou contient un encoded-word RFC 2047, et deux copies différentes d’un champ d’en-tête de message Date, Subject, To, Reply-To ou Sender, que la RFC 5322 section 3.6 n’autorise qu’une fois : les clients de messagerie affichent l’une ou l’autre copie, et une signature DKIM qui nomme le champ une fois ne couvre que celle du bas, de sorte qu’une copie ajoutée au-dessus d’un champ signé passe DKIM alors qu’elle peut être montrée au lecteur.

  • La classe marquée est le même conflit pour Cc, que certains clients de messagerie produisent lorsque l’utilisateur ajoute une seconde ligne Cc: : le message est stocké tel que reçu et reçoit X-Pepsi-Warning: duplicate-header-cc.

  • Les classes douces sont des formes dont les normes disent déjà comment les décoder, et le message est réécrit selon cette unique lecture avant d’être stocké, de sorte que chaque analyseur ultérieur voit la même structure : un encodage de transfert qui n’est aucun des cinq encodages de la RFC 2045 (RFC 2045 section 6.4 : l’entité est application/octet-stream et ses octets sont pris tels quels) ; une espace entre le = d’un saut doux quoted-printable et la fin de ligne (section 6.7 : supprimée) ; des caractères hors de l’alphabet base64 (section 6.8 : ignorés) ; un multipart avec des délimiteurs mais sans délimiteur de fermeture (RFC 2046 section 5.1.1 : la dernière partie se termine avec l’entité englobante, de sorte que le délimiteur de fermeture est écrit) ; une ligne de délimiteur de la propre frontière d’un multipart après son délimiteur de fermeture (l’épilogue, que la section 5.1.1 dit d’ignorer, est abandonné, de sorte que la « partie » que certains lecteurs y montreraient disparaît ; un épilogue sans une telle ligne est conservé) ; un second champ Content-Type ou Content-Transfer-Encoding identique (abandonné) ; et une seconde copie identique d’un champ d’en-tête de message Date, Subject, To, Cc, Reply-To, Sender, Message-ID, In-Reply-To ou References (égale après dépliage et regroupement des espaces ; la première copie est conservée). Des champs Message-ID, In-Reply-To ou References différents sont laissés tels quels : ils orientent le regroupement en fils, non ce qu’on dit au lecteur. Seul le propre bloc d’en-têtes du message compte pour ces champs, non celui d’un message joint ou d’une partie du corps. Un second From: est refusé avant tout cela (550 5.6.0), et tout Bcc: est retiré. Une entité multipart/signed, multipart/encrypted, PGP/MIME ou S/MIME et tout ce qu’elle contient ne sont jamais réécrits, car une signature couvre les octets encodés et le texte chiffré est de toute façon opaque ; une classe dure à l’intérieur d’une telle entité refuse toutefois le message.

L’ordre est : vérifier, normaliser, sceller. SPF, DKIM et DMARC sont évalués sur les octets tels que reçus (une signature est jugée sur ce qu’elle a signé), de sorte que la propre signature DKIM du message peut ne plus se vérifier au saut suivant après la réécriture ; c’est à cela que sert le sceau ARC, et le sceau doit couvrir ce qui est stocké. Un message qui porte une chaîne ARC est donc stocké tel qu’il est arrivé et marqué state.mime_normalise ; pepsi-stage-arc(1) vérifie cette chaîne sur les octets d’origine, réécrit, et scelle le message réécrit. Un message sans chaîne, et une soumission (jamais scellée ARC), est réécrit par l’ingress lui-même. Qui a réécrit est consigné comme state.mime_normalised et les classes trouvées comme state.mime_anomalies. Avec MIME_ANOMALIES = enforce et aucune étape exécutant pepsi-stage-arc, l’ingress avertit au démarrage : un message porteur d’une chaîne garde alors ses anomalies.

MIME_ANOMALIES = log compte et journalise chaque classe et stocke le message tel que reçu ; un message comportant des copies différentes de l’un des six champs d’en-tête ci-dessus reçoit X-Pepsi-Warning: duplicate-header-<field> (le nom du champ en minuscules : duplicate-header-date, -subject, -to, -cc, -reply-to, -sender) au lieu d’être refusé. L’avertissement n’est écrit que sur le courrier des sessions non authentifiées, comme les autres valeurs X-Pepsi-Warning (voir « Marquage du courrier venu de l’extérieur » ci-dessous). Les clés de télémétrie mime-hard-anomaly et mime-soft-anomaly comptent les messages présentant une classe de chaque sorte sous l’un ou l’autre réglage, et mime-duplicate-header-mark compte les messages marqués pour un conflit d’en-tête.

Que la valeur par défaut coûte du courrier légitime a été mesuré avant qu’elle ne soit choisie : 97 891 messages reçus sur plusieurs années dans trois boîtes aux lettres de travail, dominés par le courrier de listes de diffusion, de recherche et de projets, ont été analysés avec un analyseur qui ne répare rien (un LF nu ne peut pas être mesuré dans du courrier stocké et est de toute façon refusé au DATA).

Classe

Messages

Part

Classes dures (frontière vide, NUL dans un en-tête MIME, champs dupliqués contradictoires, frontière d’encoded-word)

0

0

Classes douces, ensemble

28

0,03 %

dont : champs Content-Type ou Content-Transfer-Encoding dupliqués identiques

7

0,007 %

dont : multipart sans délimiteur de fermeture

20

0,02 %

dont : base64 avec des caractères hors de l’alphabet

1

0,001 %

dont : encodage de transfert mal orthographié ; espace après un saut doux

0

0

Pas un seul message de l’échantillon n’aurait été refusé, et la réécriture en aurait touché environ un sur 3 500, la plupart avec un délimiteur de fermeture manquant que chaque client lit déjà comme fermé. Les formes hors de ces classes (une ligne d’en-tête sans nom de champ, un échappement quoted-printable invalide, des octets 8 bits bruts dans une partie quoted-printable, un Content-Type inanalysable, un multipart dont la frontière n’apparaît jamais dans son corps) sont stockées telles que reçues ; elles représentaient environ un message sur 1 250 de l’échantillon. La classe délimiteur-après-fermeture ne fait pas partie de cette mesure.

Les classes de champs d’en-tête ont été mesurées séparément, sur 24 096 messages : le corpus public ham de SpamAssassin (4 150 messages) et 19 946 messages des archives 2024 et 2025 de onze listes de diffusion GNU, choisies parce qu’elles sont publiques et portent des en-têtes complets.

Copies d’un champ d’en-tête de message

Messages

Part

Date, Subject, To, Reply-To ou Sender différents

0

0

Cc différents

6

0,025 %

Copies identiques de l’un quelconque des neuf champs

1

0,004 %

Message-ID ou In-Reply-To différents (laissés tels quels)

2

0,008 %

Les six conflits Cc étaient des messages légitimes de deux correspondants, dont quatre écrits avec Gnus, qui conserve les lignes Cc: supplémentaires que tape un utilisateur ; c’est pourquoi le champ est marqué plutôt que refusé.

95.1.1.1.3.4. Marquage du courrier venu de l’extérieur

L’authentification est notée, non imposée (sauf sous DMARC_ENFORCE), de sorte qu’un message venu d’internet dont le From: est dans l’un des ACCEPTED_DOMAINS est remis comme celui d’un collègue, sauf si la politique DMARC de son domaine le refuse. Après les vérifications ci-dessus, pepsi-ingress marque donc, sur chaque message d’une session non authentifiée :

  • X-Pepsi-Warning: from-ambiguous — un From: qui ne peut pas être lu d’une seule façon (la lecture stricte de la barrière de soumission le refuse : une adresse en encoded-word ou de syntaxe obsolète, du texte après l’angle-addr, un second angle-addr, un groupe), ou qui nomme des boîtes aux lettres dans plus d’un domaine, quels que soient les résultats d’authentification : les clients ne s’accordent pas sur l’auteur qu’affiche un tel champ.

  • X-Pepsi-Warning: served-domain-not-authenticated — une boîte aux lettres From: dans un domaine servi, sans pass DMARC, sans pass DKIM aligné sur ce domaine, ni pass SPF dont le domaine du MAIL FROM s’aligne sur lui. Un From: nommant plusieurs domaines n’est garanti que par un pass DMARC.

  • X-Pepsi-Warning: served-sender-not-authenticated — une boîte aux lettres Sender: (n’importe quel champ Sender:) dans un domaine servi, sans signature DKIM valide ni pass SPF dont le domaine du MAIL FROM s’aligne sur lui. Un Sender: dans un autre domaine n’est pas marqué.

  • X-Pepsi-Warning: dmarc-fail-not-enforced — DMARC a donné fail et le message a quand même été accepté : DMARC_ENFORCE est désactivé, ou le domaine publie p=none. Un échec dont s’est porté garant un scelleur de ARC_TRUSTED_SEALERS n’est pas marqué.

Chacun de ces avertissements place aussi l’étiquette TAG_EXTERNAL (par défaut [external]) en tête du Subject, là où un client de messagerie l’affiche ; un message sans Subject en reçoit un contenant l’étiquette seule, et un second champ Subject est abandonné avec la réécriture. Avant que l’ingress ne décide de l’étiquette, chaque message venu de l’extérieur voit les copies de l’étiquette retirées du début de son objet, jugé tel qu’un client le rend (encoded-words RFC 2047 décodés, caractères sosies normalisés, contrôles invisibles et bidirectionnels retirés), de sorte qu’un expéditeur ne peut pas écrire l’étiquette lui-même ; le [external] documenté est retiré même lorsque TAG_EXTERNAL définit une autre étiquette. Rien d’autre dans l’objet n’est touché ; le propre préfixe [Signed contract] d’un expéditeur reste, à moins qu’une étape pepsi-stage-decrypt(1) ne le retire plus tard. Les valeurs écrites sont listées dans state.auth.warnings (voir pepsi.state(7)). EXTERNAL_SUBJECT_TAG = no laisse l’objet tel quel et écrit toujours les champs d’en-tête. Un inconnu écrivant depuis son propre domaine ne reçoit aucune marque au-delà de from-ambiguous, quels que soient ses résultats : l’étiquette dit qu’une prétention à être l’un des nôtres n’a pas été prouvée, que le lecteur peut se voir montrer un autre auteur que celui authentifié, ou que le domaine de l’expéditeur a désavoué le message, et rien de plus. La réécriture casse une signature DKIM de l’expéditeur couvrant Subject, c’est pourquoi elle a lieu après la vérification et avant le sceau ARC.

95.1.1.1.3.5. Notifications d’état de remise (DSN)

pepsi-ingress annonce l’extension DSN (RFC 3461) dans sa réponse EHLO et accepte ses paramètres : RET et ENVID sur MAIL FROM et NOTIFY et ORCPT sur RCPT TO. Leur syntaxe est validée : une valeur RET/NOTIFY invalide, un NOTIFY=NEVER combiné avec d’autres mots-clés, ou un xtext ENVID/ORCPT malformé est rejeté avec 501. Les valeurs acceptées sont stockées dans le state.dsn de la ligne (les ret/envid au niveau du message plus un tableau par destinataire de notify/orcpt). Le pipeline d’étapes les honore : les étapes de relais propagent les paramètres au saut suivant lorsqu’il annonce aussi DSN, et pepsi-stage-bounce(1) ne génère un rebond d’échec que lorsque le NOTIFY du destinataire le demande (FAILURE, la valeur par défaut en son absence), en renvoyant en écho ENVID/ORCPT dans le DSN. Chaque étape doit préserver state.dsn.

95.1.1.1.3.6. Require-Recipient-Valid-Since (RRVS)

pepsi-ingress annonce l’extension RRVS (RFC 7293) et accepte son paramètre RCPT TO, RRVS=<date-time>[;C|R] : l’expéditeur savait que le destinataire voulu possédait l’adresse à ce moment (une date-heure RFC 3339 sans fractions de seconde) et ne veut pas que le message soit remis à quiconque a obtenu l’adresse plus tard. Une valeur malformée reçoit 501 5.5.4. La lettre facultative est l”action en l’absence de prise en charge pour un relais dont le saut suivant n’annonce pas RRVS : R (par défaut) refuse le destinataire, C continue.

Pour un destinataire dans un domaine servi, l’adresse est associée à un login comme pour la vérification de quota ci-dessous (partie locale, sous-adresse retirée à [pepsi] RECIPIENT_DELIMITER, mise en minuscules ; aucune résolution d’alias) et recherchée dans le registre d’attribution des logins (pepsi.login_assignment, sur lequel pepsi-ingress ne détient que SELECT ; voir pepsi-setup(1), Le registre d’attribution des logins). Le destinataire est refusé avec 550 5.7.17 Mailbox owner has changed, quelle que soit l’action en l’absence de prise en charge, si le login a un changement de propriétaire noté après l’heure demandée, si passwd lui donne maintenant un autre uid que le registre, ou si le registre dit que le login avait disparu. Un login n’ayant eu qu’un propriétaire à la connaissance de Pepsi passe pour n’importe quelle date (RFC 7293 sections 9 et 13.2), de sorte que la réponse ne dit rien d’une adresse qui n’a jamais été recyclée ; les adresses de rôle de la RFC 2142 (postmaster, abuse, info et les autres) ne sont jamais testées. Toute incertitude (pas de registre, pas de tel login, une erreur de base de données ou de passwd) accepte le destinataire, et l’étape de remise locale reprend la demande. Un refus compte pour MAX_INVALID_RECIPIENTS, qui mesure le sondage contre lequel met en garde la RFC 7293 section 13.1.

La valeur acceptée est stockée telle quelle sous state.dsn.rcpt[i].rrvs, parallèlement à rcpt_to comme NOTIFY, de sorte que chaque scission la garde avec son destinataire et qu’une cible d’alias (une nouvelle destination) n’en hérite pas. Les étapes de relais la transmettent à un saut suivant qui annonce RRVS ; vers un saut qui ne l’annonce pas, R fait échouer le destinataire avec 5.7.19 (un DSN) et C continue avec la demande écrite comme champ d’en-tête Require-Recipient-Valid-Since:. pepsi-stage-relay-to-maildir(1) et pepsi-stage-dot-forward(1) honorent les deux formes à la remise locale.

95.1.1.1.3.7. Exiger TLS (REQUIRETLS)

pepsi-ingress met en œuvre les deux moitiés de la RFC 8689. L’extension REQUIRETLS n’est annoncée, et son paramètre MAIL FROM accepté, que sur une session protégée par TLS, par TLS implicite ou après STARTTLS. C’est la seule exigence de la RFC 8689 §2 que le côté récepteur peut voir ; que le client ait validé notre nom et notre certificat avant de le demander relève de sa propre obligation, invisible ici. Sur une session en clair, le paramètre reçoit 530 5.7.10 : annoncer l’extension promet de transporter l’exigence plus loin, et un message qui a déjà franchi un saut en clair ne peut pas recevoir cette promesse. Le paramètre ne prend pas de valeur ; REQUIRETLS=... est un paramètre inconnu (555 5.5.4). La socket de soumission locale est une socket UNIX, de sorte que pepsi-sendmail(1) ne peut pas le demander.

Un message arrivé avec le paramètre est étiqueté state.tls_required = "required" (voir pepsi.state(7)) ; chaque ligne que le pipeline en scinde ou clone hérite de l’étiquette, comme l’exige le §4.1 pour les alias. Un message arrivé sans le paramètre mais portant exactement un champ d’en-tête TLS-Required: No est étiqueté "no" : l’expéditeur d’origine demande que la politique DANE et MTA-STS du domaine destinataire soit traitée comme indicative. Deux tels champs, ou toute autre valeur, sont malformés et ne signifient rien, car les lire comme une renonciation permettrait à n’importe qui de déclasser la politique d’un destinataire avec une seule ligne. Lorsque le paramètre est présent, le champ est ignoré et laissé dans le message (§4.1). Ce que fait chaque étiquette au saut suivant est décrit dans pepsi-stage-relay-to-internet(1) et pepsi-stage-relay-to-smarthost(1) ; un rebond d’un message étiqueté est lui-même étiqueté et ne renvoie que les en-têtes (pepsi-stage-bounce(1)).

95.1.1.1.3.8. Contenu 8 bits et internationalisé

pepsi-ingress annonce 8BITMIME (RFC 6152) et SMTPUTF8 (RFC 6531) dans sa réponse EHLO, de sorte qu’un message peut porter des octets 8 bits bruts dans son corps et de l’UTF-8 dans ses en-têtes et son enveloppe. Le paramètre BODY= sur MAIL FROM est accepté et noté (state.origin.body_8bit) ; seuls 7BIT et 8BITMIME sont valides, et BINARYMIME n’est pas annoncé et est rejeté avec 501. Les étapes de relais ré-annoncent BODY=8BITMIME / SMTPUTF8 à un saut suivant qui les prend en charge, et rétrogradent le message lorsqu’il ne les prend pas en charge : un corps 8 bits vers un saut non-8BITMIME est ré-encodé en MIME vers un codage de transfert de contenu 7 bits, et les en-têtes UTF-8 vers un saut non-SMTPUTF8 sont réécrits en mots encodés RFC 2047, ou selon la RFC 2231 pour un paramètre MIME tel que le nom de fichier d’une pièce jointe (une adresse non ASCII à cet endroit ne peut pas être rétrogradée et rebondit). Un message dont le corps ne peut pas du tout être converti, parce qu’il est malformé au-delà de ce que le ré-encodeur peut réparer, rebondit plutôt que d’être envoyé en 8 bits, comme l’exige la RFC 6152 §3. Voir pepsi-stage-relay-to-internet(1).

95.1.1.1.3.9. Validation des paramètres ESMTP

pepsi-ingress valide strictement les paramètres MAIL FROM/RCPT TO. Les paramètres reconnus sont SIZE, BODY et SMTPUTF8 (et AUTH) sur MAIL FROM ainsi que les paramètres DSN et RRVS ci-dessus ; une valeur SIZE= qui n’est pas un entier non négatif est rejetée avec 501 (RFC 1870 §6.1) plutôt que silencieusement ignorée. Un paramètre que le serveur n’implémente pas est rejeté avec 555 5.5.4 (RFC 5321 §4.1.1.11) ; il n’est pas silencieusement ignoré. La seule exception est le paramètre AUTH= de la RFC 4954 sur MAIL FROM (qu’un client authentifié peut joindre car AUTH est annoncé) : il est accepté et ignoré plutôt que rejeté, et Pepsi ne propage pas l’identité affirmée plus loin.

95.1.1.1.3.10. Authentification du client

Chaque écouteur peut authentifier ses clients, marquant le courrier accepté comme d’origine locale. Une session est authentifiée lorsque l’un quelconque de quatre mécanismes par écouteur l’accepte :

  • MYNETWORKS — l’IP connectée est au sein de l’un d’une liste séparée par espaces/virgules de réseaux CIDR IPv4/IPv6 de confiance (une adresse nue est prise comme un hôte /32 ou /128). Une entrée hors du loopback doit être liée par SENDER_MAP (voir Liaisons d’expéditeur ci-dessous), sinon pepsi-ingress refuse de démarrer.

  • SASL — un backend SASL_TYPE (actuellement dovecot, via la socket auth-client SASL_PATH) accepte un échange AUTH. AUTH (mécanismes PLAIN et LOGIN) est annoncé et accepté seulement sur une session protégée par TLS (TLS implicite ou après STARTTLS) ; une tentative AUTH en clair est refusée avec 504 5.5.4 (RFC 4954 §4, qui déprécie la réponse 538 pour ce cas).

  • Certificat client TLS — le client présente un certificat qui est soit une clé épinglée (son SHA-256 du SubjectPublicKeyInfo, 64 caractères hex, est listé dans TLS_AUTH_CLIENT), soit qui se valide jusqu’à l’un des certificats de CA de TLS_AUTH_CLIENT_CA, et SENDER_MAP lie cette clé ou cette CA aux adresses au nom desquelles elle peut envoyer. Un certificat non lié n’authentifie rien. Voir Certificats clients ci-dessous.

  • AUTH_PEERCRED — sur une socket de domaine UNIX, l’uid du pair attesté par le noyau (SO_PEERCRED) est résolu en un login et fourni à la machinerie USERNAME_MAP, de sorte qu’un appelant ne peut envoyer qu’en son propre nom. Vaut ``yes`` par défaut pour un écouteur ``SERVE = unix`` (mettez AUTH_PEERCRED = no pour le désactiver) ; refusé d’emblée sur un écouteur TCP, où un pair n’a pas d’identité attestée par le noyau. C’est ce qui authentifie la socket de soumission locale qu’utilise pepsi-sendmail(1), et cela pose le mot-clé ESMTPA de la RFC 3848. Pour un écouteur SERVE = systemd, il est accepté mais jamais déduit, puisque la famille de la socket vit dans l’unité ; un avertissement est journalisé si le descripteur hérité s’avère être du TCP.

SASL_TYPE, TLS_AUTH_CLIENT et TLS_AUTH_CLIENT_CA nécessitent un écouteur TLS (MODE = tls ou starttls). Une session authentifiée est notée avec state.local_origin = true (sinon false) et est autorisée à relayer vers n’importe quel domaine, pas seulement vers les domaines servis. Une session qui porte une identité pose en outre le A de la RFC 3848 dans le mot-clé with de l’en-tête de trace : ESMTPSA sur TLS, et simplement ESMTPA pour la socket de soumission UNIX en clair, d’où provient le courrier soumis localement (pepsi-sendmail(1), cron). Un AUTH SASL porte une identité, AUTH_PEERCRED sur une socket UNIX aussi, mais ni MYNETWORKS ni un certificat client n’en portent. Filtrez sur les deux mots-clés, pas seulement sur ESMTPSA. Un certificat client non reconnu n’interrompt jamais la poignée de main ; il laisse simplement la session non authentifiée.

95.1.1.1.3.11. Certificats clients

Un écouteur sur lequel TLS_AUTH_CLIENT ou TLS_AUTH_CLIENT_CA est défini demande un certificat client pendant la poignée de main, en nommant les CA configurées comme indications, à un client qui propose TLS 1.3. TLS 1.2 envoie le certificat, et la personne ou l’appareil qu’il nomme, en clair ; un client TLS 1.2 est donc servi sans demande de certificat (journalisé en info) et peut s’authentifier avec AUTH ou pas du tout ; TLS_AUTH_CLIENT_TLS12 = yes sur l’écouteur demande le certificat sous TLS 1.2 aussi, pour un appareil qui ne parle rien de plus récent. La poignée de main n’échoue jamais sur un certificat non reconnu : la décision est prise ensuite, et un client dont le certificat n’authentifie rien peut encore faire AUTH ou, sur un écouteur MX, envoyer aux domaines servis sans authentification. Deux formes sont reconnues :

  • Une clé épinglée. TLS_AUTH_CLIENT liste le SHA-256 du SubjectPublicKeyInfo DER de clés clientes individuelles. L’empreinte épinglée est la clé : l’ingress ne consulte pas ce que dit le certificat qui l’entoure (noms, dates, usages), puisqu’un certificat autosigné ne dit que ce que son détenteur a écrit. Calculez une empreinte avec openssl x509 -in cert.pem -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256.

  • Une CA. TLS_AUTH_CLIENT_CA nomme un fichier PEM de certificats de CA (chacun doit être une CA autorisée à signer des certificats, et actuellement valide ; le fichier est vérifié lors de l’analyse de la configuration, donc aussi par pepsi-setup(1)). Un certificat présenté est reconnu lorsqu’il construit un chemin RFC 5280 vers l’une d’elles via les intermédiaires qu’envoie le client. La vérification du chemin couvre les dates de validité, basicConstraints avec pathLenConstraint, keyUsage, les contraintes de nom et de politique, la règle selon laquelle une extension critique non reconnue est un refus, et la force de la clé. pathLenConstraint s’applique aussi au propre certificat de la CA, de sorte qu’une CA qui s’est limitée à émettre des certificats d’entité finale ne puisse pas être amenée à se porter garante d’une sous-CA. La feuille doit en outre porter un extendedKeyUsage nommant id-kp-clientAuth (une extension absente ou anyExtendedKeyUsage ne suffit pas), le bit digitalSignature, et ne doit pas être elle-même une CA. Le hachage de clé d’une CA listé dans ``TLS_AUTH_CLIENT`` n’autorise rien et est journalisé : une ancre donnée par son seul hachage n’a aucune contrainte vérifiable, puisque quiconque détient une chaîne pourrait envelopper la clé publique de la CA dans un certificat de sa propre écriture, sans la longueur de chemin ni la contrainte de nom que porte le vrai.

La révocation est vérifiée par rapport aux listes que pepsi-keydisc(1) conserve dans pepsi.crl_cache. Chaque certificat du chemin qui nomme un point de distribution de CRL doit être couvert par une liste à jour signée par son émetteur, et un numéro de série listé est un refus ; un certificat qui ne nomme aucun point de distribution n’a pas de liste à consulter. Les points de distribution de chaque chemin qui atteint une CA configurée sont enregistrés auprès du récupérateur (ceux du lot de CA lui-même au démarrage), de sorte que la première connexion sous un nouvel émetteur ne trouve encore aucune liste : sur un écouteur de soumission, son MAIL FROM reçoit 451 4.7.0 (réessayez plus tard) plutôt que 530, et le client réussit dès que pepsi-keydisc a récupéré la liste, en l’espace de son cycle de cinq minutes. Contrairement au vérificateur S/MIME, qui rapporte un état de révocation inconnu et continue, cette vérification échoue en position fermée : une CA qui publie des listes que personne ne peut récupérer n’admet personne. Un déploiement qui utilise TLS_AUTH_CLIENT_CA exécute donc pepsi-keydisc.

Ce que vaut un certificat est décidé par SENDER_MAP (Liaisons d’expéditeur ci-dessous) : la clé cert:<pin> nomme les adresses au nom desquelles la session peut envoyer, l’empreinte étant celle de la clé épinglée ou celle de la CA que le chemin a atteinte. Un certificat que la carte ne lie pas n’authentifie rien : la session reste non authentifiée, et le refus est journalisé avec la clé à ajouter. validate de pepsi-setup(1) (et donc run) refuse une configuration comportant une empreinte ou une CA que la carte ne lie pas, de sorte qu’une installation ne puisse pas porter une entrée d’écouteur qui n’admet personne ; pepsi-ingress lui-même démarre et avertit, afin qu’une telle entrée n’arrête pas un système en marche. Un certificat émis par une CA qui nomme des boîtes aux lettres (un rfc822Name dans son nom alternatif du sujet, ou à défaut l”emailAddress du sujet) ne peut envoyer qu’au nom de celles de ses boîtes aux lettres que la liaison permet : avec cert:<CA pin> *, chaque certificat sous la CA envoie au nom de sa propre boîte aux lettres et de rien d’autre, et un certificat n’authentifie rien si la liaison ne permet aucune de ses boîtes aux lettres. Un certificat qui ne nomme aucune boîte aux lettres reçoit l’ensemble de l’autorisation de la CA. Une clé épinglée est la déclaration de l’opérateur et n’est pas confinée par les noms de son certificat.

Une session par certificat est notée avec state.origin.auth_method = client-cert ; son From: n’est jamais lié (state.origin.from_bound reste false), puisqu’un certificat n’identifie aucun compte qui pourrait parler au nom d’une adresse.

95.1.1.1.3.12. Soumission de messages (RFC 6409)

Un écouteur portant SUBMISSION = yes est traité comme un Message Submission Agent (RFC 6409) plutôt que comme un MX :

  • L’authentification est obligatoire. Un MAIL FROM non authentifié est refusé avec 530 5.7.0 Authentication required ; le client doit d’abord satisfaire l’un des mécanismes d”Authentification du client ci-dessus. L’indicateur exige donc au moins un mécanisme configuré (SASL_TYPE, TLS_AUTH_CLIENT, TLS_AUTH_CLIENT_CA, MYNETWORKS ou AUTH_PEERCRED) ; un écouteur de soumission qui n’en a aucun est une erreur de configuration, refusée à l’analyse du fichier, et donc à la fois par pepsi-setup(1) et par le serveur lui-même au démarrage. Il exige aussi un MODE protégé par TLS (tls ou starttls), sauf sur une socket locale, c’est-à-dire SERVE = unix ou un écouteur SERVE = systemd qui en hérite une, là où il n’y a pas de réseau à protéger. La socket de soumission locale livrée est exactement cela : MODE = plain avec SUBMISSION = yes et AUTH_PEERCRED. La règle n’est que différée, pas abandonnée : si un écouteur de soumission en clair s’avère, au moment de la liaison, avoir hérité d’une socket réseau, pepsi-ingress refuse de démarrer.

  • Des corrections de soumission sont appliquées à chaque message accepté : un en-tête Date: manquant est ajouté (§8.2) et un Message-ID: manquant est généré sous la forme <random@HOSTNAME> (§8.3). Les en-têtes déjà présents sont laissés intacts, et les corrections s’exécutent avant que l’en-tête de trace Received: ne soit ajouté en tête, de sorte que les champs ajoutés soient couverts par le sceau ARC et la signature DKIM en aval.

  • Le soumissionnaire est omis de l’en-tête de trace (RECEIVED_PRIVACY, activé par défaut pour un écouteur de soumission) : pas de clause from, ni de User-Agent/X-Mailer. Voir L’en-tête de trace Received ci-dessus.

L’indicateur n’a aucun effet sur un écouteur MX ; laissez-le désactivé (la valeur par défaut) pour le port 25.

95.1.1.1.3.13. Identité de soumission (RFC 6409 §6 / §8.1)

Une session qui porte un nom d’utilisateur est liée à l’ensemble des adresses e-mail que ce nom d’utilisateur a le droit d’utiliser. Deux des quatre mécanismes ci-dessus en portent un : un échange SASL AUTH (l”authcid) et AUTH_PEERCRED sur une socket UNIX (le login auquel se résout l’uid rapporté par le noyau). Les deux sont soumis à tout ce que dit la présente section. MYNETWORKS ne l’est pas, parce qu’il authentifie une adresse plutôt qu’un compte, sauf si SENDER_MAP le lie (voir Liaisons d’expéditeur ci-dessous) ; les deux vérifications ci-dessous s’y appliquent alors aussi. Un certificat client TLS est toujours lié : il n’authentifie que ce à quoi SENDER_MAP le lie, de sorte que les deux vérifications s’y appliquent toujours.

Par défaut, le nom d’utilisateur alice est mappé à l’unique adresse alice@HOSTNAME (le domaine [pepsi-ingress] HOSTNAME) ; le fichier facultatif USERNAME_MAP redéfinit ce mappage. Chaque ligne non vide et non commentée est

username: addr1@example.org addr2@example.org

un # commence un commentaire, la clé est le nom d’utilisateur SASL (avant le premier :), et la valeur est la liste séparée par espaces/virgules des adresses autorisées, qui peut être vide. Les noms d’utilisateur sont mis en correspondance sans tenir compte de la casse et les adresses sont mises en minuscules. Le fichier est relu chaque fois que son heure de modification change (vérifiée à chaque authentification), de sorte que les modifications prennent effet sans redémarrage ; un fichier manquant ou illisible est traité comme vide (chaque utilisateur retombe sur la valeur par défaut).

Une adresse autorisée peut utiliser un joker * (un glob * mis en correspondance avec l’adresse candidate), de sorte que alice: *@example.org permet à alice d’utiliser n’importe quelle adresse à example.org et un * nu permet n’importe quelle adresse tout court. Une entrée joker ne nomme aucune identité canonique unique, elle est donc sautée pour la correction Sender: ci-dessous (la première adresse concrète, sans joker, est l’identité canonique, le cas échéant). pepsi-setup vérifie la syntaxe d’un USERNAME_MAP configuré au moment de l’installation (voir pepsi-setup(1)). Le joker est un glob, pas une expression régulière : écrivez *@example.org, jamais .*@example.org (un point littéral suivi d’un glob, qui ne correspond à rien, si bien que l’utilisateur se verrait refuser toutes les adresses que l’entrée devait lui accorder). Setup rejette un tel motif et nomme le glob que vous vouliez.

Le mappage a trois issues pour un nom d’utilisateur :

  • listé avec des adresses — exactement ces adresses (et motifs joker) sont autorisées ; la première concrète (sans joker) est l”identité canonique utilisée pour la correction Sender: ;

  • listé sans adresse — l’utilisateur est refusé : même si SASL a accepté les identifiants, la commande AUTH est refusée par 535 5.7.8 et la session reste non authentifiée. Sur une session par identifiants de pair il n’y a aucune commande à refuser, si bien que la session ne s’authentifie tout simplement jamais, et, sur un écouteur de soumission, son premier MAIL FROM reçoit alors 530 5.7.0. C’est ainsi qu’un compte système (www-data, par exemple) est exclu de toute soumission ;

  • non listé (ou aucun USERNAME_MAP configuré) — la valeur par défaut username@HOSTNAME.

Étant donné cet ensemble, deux vérifications s’exécutent sur une telle soumission :

  • Identité d’enveloppe et d’en-tête (§6). L’expéditeur d’enveloppe MAIL FROM et l’adresse From: du message doivent chacun être l’une des adresses autorisées, sinon le message est refusé avec 550 5.7.1 (au MAIL FROM et à la fin du DATA respectivement). L’expéditeur nul <> en est exempté ; un message sans From:, ou qui ne peut pas être lu sans ambiguïté (ci-dessous), est refusé avec 550 5.6.0. La RFC 5322 §3.6.2 fait de From: une liste de boîtes aux lettres, de sorte qu’une valeur peut légalement nommer plusieurs boîtes aux lettres, et chacune d’elles doit être une adresse autorisée, pas seulement l’une. Vérifier une seule boîte aux lettres ne serait pas une vérification du tout, car les lecteurs de courrier affichent la première tandis qu’une boîte permise pourrait se trouver n’importe où dans la liste. Chaque boîte aux lettres est lue comme la lit un client de messagerie : les chaînes entre guillemets et les commentaires RFC 5322 sont sautés pendant la recherche de l’adresse <...>, et les commentaires sont retirés de l’adresse. Ainsi ceo@example.com (<alice@example.org>) est vérifié comme ceo@example.com, l’adresse qu’affiche chaque client, et non comme l’adresse du commentaire. Chaque boîte aux lettres doit aussi s’analyser strictement comme une boîte aux lettres RFC 5322, car les formes qui ne le font pas sont celles que les clients de messagerie résolvent différemment (CERT/CC VU#517845) : du texte autre que des commentaires et des espaces après l’adresse <...> (<alice@example.org>:<ceo@example.com>), une seconde adresse <...>, un nom d’affichage qui n’est pas une phrase (ceo@example.com <alice@example.org>), la syntaxe de groupe, une route source et un encoded-word RFC 2047 (=?...?=) à l’intérieur de l’adresse sont tous refusés avec 550 5.6.0 plutôt que lus comme leur premier <...>. Un encoded-word dans le nom d’affichage est légal et accepté. Enfin, un nom d’affichage (ou un commentaire) qui nomme une adresse autre que celle de sa propre boîte aux lettres est refusé avec 550 5.6.0 : "ceo@example.com" <alice@example.org> montrerait au lecteur une adresse qu’Alice ne peut pas utiliser. Le texte est jugé tel que rendu, comme décrit sous Authentification ci-dessus (encoded-words décodés, signes @ sosies normalisés). Un nom qui contient la propre adresse de la boîte aux lettres est permis, quelle que soit la casse, comme dans "alice@example.org" <alice@example.org>. La réécriture « via » d’une liste de diffusion a lieu plus tard, dans les étapes de liste, et n’est pas concernée.

  • Correction du Sender (§8.1). Le champ Sender: appartient au MSA, non au client : une adresse qu’un client y place n’est soumise à aucune vérification d’identité sur aucun chemin, et Pepsi la signerait ensuite en DKIM comme une affirmation sur l’auteur de l’envoi. Ainsi, chaque fois que le compte possède une identité canonique, un Sender: existant est remplacé ou retiré, ce que le §8.1 permet explicitement (« The MSA MAY add or replace the “Sender” field »).

    Lorsque l’adresse From: est une adresse autorisée qui diffère de l’identité canonique, ou qu’elle nomme plus d’une boîte aux lettres, un en-tête Sender: nommant l’identité canonique est ajouté en tête. Dans le cas à plusieurs boîtes aux lettres, la RFC 5322 §3.6.2 exige la présence d’un Sender:, et c’est le §8.1 qui permet au MSA de le fournir. Lorsque From: est une boîte aux lettres unique nommant l’identité canonique, un Sender: est redondant avec elle (§3.6.2 : « SHOULD NOT be used if it is redundant with the “From:” field ») et il est retiré à la place.

    Un utilisateur à qui seuls des motifs joker ont été accordés n’a pas d’identité canonique unique à affirmer : aucune des deux règles ne s’applique alors, et un Sender: existant est laissé tel quel, car il n’existe aucune identité par rapport à laquelle on pourrait prouver qu’il est faux. Comme les autres corrections, cela se produit avant l’en-tête de trace, de sorte que le résultat est couvert par le sceau ARC et la signature DKIM.

Ces vérifications s’appliquent à toute session qui porte un nom d’utilisateur, qu’il provienne d’un AUTH SASL ou d”AUTH_PEERCRED, et à toute session que SENDER_MAP lie. Une session MYNETWORKS que la carte ne lie pas n’a aucune autorisation par rapport à laquelle vérifier.

95.1.1.1.3.14. Liaisons d’expéditeur pour réseaux et certificats

Un pair MYNETWORKS hors du loopback et un certificat client TLS n’authentifient rien tant qu’ils ne sont pas liés ; un pair loopback peut envoyer au nom de n’importe quelle adresse, puisque le loopback est cet hôte. Le fichier SENDER_MAP de [pepsi-ingress] nomme les adresses qu’un réseau ou un certificat peut utiliser. Chaque ligne non vide et non commentée est une clé suivie de ses adresses autorisées

# network or certificate      allowed senders
192.0.2.10                     alerts@example.org
2001:db8:1::/64                *@example.org
cert:<64 hex digits>           backup@example.org *@example.net
cert:<64 hex digits of a CA>   *

Une clé de réseau est un réseau CIDR ou une adresse nue (un hôte /32 ou /128) ; une clé de certificat est cert: suivi du hachage SHA-256 SPKI d’une clé cliente épinglée, exactement tel qu’écrit dans TLS_AUTH_CLIENT, ou d’un certificat de CA de TLS_AUTH_CLIENT_CA (pepsi-ingress journalise la clé de chaque CA au démarrage). Les adresses utilisent la syntaxe de USERNAME_MAP (une adresse exacte, un joker *@domain ou un * nu pour toutes les adresses), et chaque clé doit en lister au moins une.

Une entrée concrète l’emporte sur un joker, d’une clé à l’autre. Une adresse qu’une clé nomme exactement est réservée : un joker sous n’importe quelle autre clé ne l’atteint pas. Dans l’exemple, un certificat sous la CA peut envoyer au nom de n’importe quelle adresse sauf backup@example.org, que seule la clé de sauvegarde épinglée peut utiliser, et alerts@example.org, que seul l’hôte d’alertes peut utiliser. C’est ce qui permet à une seule ligne cert:<CA> * de servir toute une organisation : chaque certificat est confiné à sa propre boîte aux lettres (Certificats clients ci-dessus), et les adresses qui appartiennent à des systèmes particuliers sont listées une fois, sous la clé qui les possède.

Une session MYNETWORKS est liée par la clé de réseau la plus spécifique qui contient l’adresse du pair. Une session par certificat est liée par la clé sous laquelle le certificat a été reconnu, et cette clé décide avant le réseau (un certificat identifie une clé, un réseau seulement une adresse). Une session liée passe par les vérifications MAIL FROM et From: de la section précédente, avec les mêmes réponses (550 5.7.1, 550 5.6.0) et la même correction de Sender: ; son state.origin.from_bound reste false, parce qu’un réseau ou un certificat n’identifie aucun compte qui pourrait parler au nom d’une adresse. Un certificat qu’aucune clé ne reconnaît est refusé. pepsi-ingress refuse de démarrer avec une entrée MYNETWORKS hors du loopback qu’aucune clé unique ne couvre entièrement : sinon chaque hôte qu’elle contient pourrait envoyer au nom de n’importe quelle adresse, sans authentification, et faire signer DKIM son courrier pour chaque domaine servi. C’est la forme d’un relais qui admet la plage de sortie partagée d’un fournisseur cloud. La clé peut être plus large que l’entrée (192.0.2.0/24 couvre 192.0.2.10), et un * nu garde le comportement sans restriction comme décision explicite. Un tel * pour un réseau plus large qu’un hôte donne lieu à un avertissement à chaque démarrage (et par pepsi-setup validate) : chaque machine qui est ou rejoint plus tard ce réseau peut envoyer du courrier signé au nom de n’importe quelle adresse de chaque domaine servi, la configuration dont a abusé la campagne EchoSpoofing. Une entrée loopback (127.0.0.0/8, ::1, sous n’importe quelle graphie) n’a besoin d’aucune liaison et garde le comportement sans restriction, ce sur quoi repose le TRUST_LOOPBACK de l’assistant.

Contrairement à USERNAME_MAP, le fichier est lu une seule fois au démarrage (redémarrez pour appliquer une modification), et pepsi-ingress refuse de démarrer sur toute erreur qu’il contient : un fichier illisible, une clé malformée, une clé listée deux fois, une clé sans adresse ou une adresse invalide. Une ligne ignorée laisserait le réseau qu’elle devait lier libre d’envoyer au nom de n’importe qui. pepsi-setup(1) vérifie le fichier, avertit au sujet des clés que ni MYNETWORKS, ni TLS_AUTH_CLIENT, ni TLS_AUTH_CLIENT_CA d’aucun écouteur ne peut reconnaître, et refuse une empreinte, une CA ou un réseau hors loopback que le fichier ne lie pas.

Outre la vérification de la section 6, ingress enregistre comment le From: a été autorisé, sous state.origin.from_bound : true exactement lorsque From: nomme une seule boîte aux lettres qui a correspondu à une entrée concrète (sans joker) des adresses autorisées du compte, ou au username@HOSTNAME par défaut ; false sinon, et toujours false pour une session sans nom d’utilisateur. Avoir le droit d’envoyer en tant qu’une adresse suffit pour envoyer ; y être lié est ce qui permet à une soumission de parler en son nom. pepsi-stage-encrypt(1) n’enregistre la clé qu’annonce le client de messagerie d’un utilisateur, ou n’exécute une commande de clé par courriel, que pour un From: lié (ou un relais MYNETWORKS/par certificat client) : une autorisation *@example.org permet à un compte d’envoyer au nom de ses collègues, et ne doit pas lui permettre d’implanter une clé pour eux. pepsi-setup(1) avertit au sujet des comptes qui détiennent des autorisations à joker.

95.1.1.1.3.15. Socket de soumission locale

Un écouteur n’est jamais configuré : la socket de soumission locale à laquelle se connecte pepsi-sendmail(1), et à travers lui /usr/sbin/sendmail, cron et tout ce qui poste du courrier localement. pepsi-ingress la sert inconditionnellement, parce que fournir ce chemin est une propriété du fait d’être un serveur de courrier plutôt qu’une fonctionnalité à activer. Ce n’est pas une section d’écouteur facultative, car cela ferait dépendre le service de l’accord de trois choses distinctes (l’existence de la section, la correspondance de son UNIXPATH avec la socket du client, et le fait que le répertoire d’exécution soit accessible en écriture), chacune facile à manquer avec le même symptôme silencieux : le courrier local disparaît.

Le chemin est [pepsi-sendmail] SOCKET (par défaut /run/pepsi/submission.sock), lu depuis cette unique option par les deux extrémités, de sorte que le client et le serveur ne peuvent pas nommer des sockets différentes. Tout le reste est fixé, parce que rien de tout cela n’est un choix : l’écouteur s’appelle local-submission dans le journal, et il est MODE = plain avec SUBMISSION = yes et AUTH_PEERCRED. Lorsqu’elle est liée ici plutôt qu’héritée de pepsi-ingress.socket, elle est créée en mode 0666 ; ce mode permissif n’accorde rien, car ouvrir la socket ne confère aucune autorité : le noyau fournit l’uid de l’appelant, et USERNAME_MAP décide des adresses au nom desquelles il peut envoyer.

Une section [pepsi-ingress-listener-*] explicite qui sert le même chemin l’emporte et rien n’est synthétisé à côté d’elle : un opérateur qui y veut d’autres options (un mode plus strict, un UNIXPATH_GROUP, pas d’identifiants de pair) en écrit donc une. Ne pas réussir à la lier est fatal, comme pour tout autre écouteur : un serveur qui tourne avec seulement une partie de ce qu’on lui a demandé de servir est précisément la défaillance que cet agencement doit supprimer. La seule façon de la désactiver est SOCKET = none, ce qui fait aussi refuser pepsi-sendmail(1) de s’exécuter ; avec cette sentinelle définie et aucune section d’écouteur du tout, le serveur n’écouterait rien et refuse de démarrer.

95.1.1.1.3.16. Quota de boîte aux lettres au RCPT

Lorsqu’un destinataire est sur l’un des domaines servis, pepsi-ingress peut le refuser dans la session SMTP parce que la boîte aux lettres est connue pour être pleine — 452 4.2.2 ou 552 5.2.2 selon [pepsi] MAILBOX_OVER_QUOTA. Refuser ici plutôt qu’accepter puis rebondir plus tard garde le MTA émetteur en ligne, de sorte que c’est lui qui prévient son utilisateur, et Pepsi ne génère aucun backscatter vers un expéditeur d’enveloppe qui peut fort bien être falsifié.

Quatre propriétés rendent cela sûr à faire à partir d’une ligne de base de données.

Aucune résolution. La partie locale du destinataire est mise en minuscules, débarrassée de toute sous-adresse au [pepsi] RECIPIENT_DELIMITER, puis comparée exactement à un login passwd. Les alias, les fichiers ~/.forward et la base passwd elle-même relèvent de l’étape de remise ; pepsi-ingress n’en devine aucun, de sorte qu’une adresse qui n’est pas écrite comme un login ne correspond simplement à rien et est acceptée.

Aucune mesure. pepsi-ingress ne peut pas lire un Maildir en 0700, et ne doit jamais acquérir le groupe pepsi-maildir qui lui permettrait de lancer le helper qui le peut. Il lit des chiffres écrits par quelqu’un d’autre, et ne détient que SELECT sur la table.

Seule une mesure fraîche compte. L’estimation d’occupation courante n’est délibérément pas consultée : elle surcompte, et refuser sur elle fermerait une boîte aux lettres que son propriétaire a depuis vidée. La boîte resterait fermée pour de bon, puisque, tout message étant refusé, aucune remise ne s’exécuterait jamais pour la mesurer à nouveau. Une mesure plus ancienne que [pepsi] MAILBOX_QUOTA_MAX_AGE accepte le message et laisse le chemin de remise y jeter un œil neuf ; le reconcile de pepsi-quota(1) maintient mesurés les comptes à leur limite.

Toute incertitude accepte. Aucune ligne, aucune mesure ou une erreur de base de données : tous ces cas signifient accepter, conformément au reste du traitement entrant.

La boîte aux lettres sans domaine <Postmaster> est acceptée quoi qu’il arrive, car la RFC 5321 §4.5.1 exige qu’elle reste joignable.

Mettez [pepsi] MAILBOX_QUOTA_RCPT_CHECK = no pour sauter entièrement la consultation et laisser toute l’application au moment de la remise.

95.1.1.1.3.17. Destinataires inconnus au RCPT

Un destinataire d’un domaine servi que rien sur cet hôte n’accepterait est refusé dans la session SMTP avec 550 5.1.1, pour la même raison qu’une boîte aux lettres pleine : le MTA émetteur prévient son propre utilisateur, au lieu que Pepsi fasse rebondir le message plus tard vers un expéditeur d’enveloppe que le spam falsifie (backscatter, le moyen le plus rapide de finir sur une liste noire). [pepsi-ingress] VERIFY_RECIPIENTS (par défaut auto) le contrôle.

pepsi-ingress n’exécute pas le pipeline pour le savoir. Il demande si quelque chose qui peut rendre une adresse réelle s’en porte garant :

  • un compte local, résolu exactement comme le résolvent les étapes Maildir et ~/.forward ;

  • un alias, reconnu par le code même de l’étape d’alias ;

  • une liste de diffusion ;

  • postmaster@, abuse@ et l’adresse de contrôle de toute étape qui en traite une ;

  • le MDA derrière une étape LMTP, ou le backend derrière une route de passerelle, interrogé avec MAIL FROM:<> et RCPT TO et sans message.

Lesquelles de ces sources s’appliquent à quel domaine servi est déduit des sections [stage-*] au démarrage ; pepsi-setup run affiche le résultat. Un domaine n’est refusé-si-inconnu que lorsque chaque chemin que peut prendre son courrier dispose de quelque chose qui peut répondre. Un alias fourre-tout, une étape exécutant un programme que Pepsi ne connaît pas, ou un backend que personne ne peut interroger laisse le domaine ouvert. Une partie locale est comparée comme la remise la compare (NFC et pliage de casse Unicode, de sorte que ÄBC@, äbc@ et aU+0308bc@ sont une seule boîte aux lettres), aussi bien aux adresses de service qu’aux entrées des listes de destinataires.

Toute incertitude accepte : une table d’alias ou une liste de destinataires illisible, une erreur de base de données, une sonde qui échoue, expire ou est refusée pour toute autre raison que « pas de telle boîte aux lettres », ou plus de 16 sondes en cours. Une adresse n’est refusée que lorsque chaque source applicable a dit non. Le traitement des boîtes aux lettres inconnues par le pipeline lui-même reste derrière, pour les cas que ce contrôle laisse passer.

Une partie locale comportant % (le percent hack, user%other.example@) ou ! (un chemin UUCP, other!user@) dans un domaine servi est refusée 550 5.1.3 à moins qu’une source ci-dessus ne se porte garante de l’adresse : un domaine qui n’est pas vérifié, ou dont les sources n’ont pas pu répondre, la transmettrait à un arrière-plan qui peut encore honorer ces formes et remettre à un tiers. Une source qui dit non donne le 550 5.1.1 ordinaire. Il n’y a pas d’option ; vérifiez les destinataires d’un domaine dont les adresses ont besoin de tels caractères.

Un « oui » d’une sonde est mis en cache une heure et un « non » cinq minutes, de sorte qu’une nouvelle boîte aux lettres est joignable en quelques minutes. Après MAX_INVALID_RECIPIENTS (par défaut 10) destinataires inconnus, une session est fermée avec 421. Une attaque par dictionnaire coûte alors des connexions, que les limites de connexion mesurent, plutôt qu’une consultation par essai.

VRFY répond toujours 252 pour chaque adresse : RCPT indique déjà à un expéditeur si une adresse existe, comme sur tout MTA, et un second moyen, moins coûteux, de le demander ne servirait qu’à la collecte d’adresses.

95.1.1.1.3.18. Listes de blocage d’IP

Pour une session non authentifiée venant du réseau, l’ingress recherche l’adresse du client une seule fois, en une requête indexée, dans les listes de blocage d’IP que pepsi-reputation(1) a téléchargées ([pepsi-reputation-list-*], pepsi.conf(5)). Seules les listes confirmées à jour dans leur MAX_AGE sont consultées. Personne hors de l’hôte n’est interrogé : une requête de liste de blocage DNS par connexion dirait à l’opérateur de la liste quels serveurs envoient du courrier à cet hôte.

Les listes nommant le client sont notées sous state.origin.ip_blocklist (pepsi.state(7)), où pepsi-stage-if(1) peut router selon elles. Une liste avec ACTION = reject fait aussi refuser par l’ingress les destinataires de la session avec 554 5.7.1 … client host [ADDRESS] is listed by NAME, sauf <postmaster>, que la RFC 5321 garde joignable et par lequel un expéditeur listé peut atteindre un humain.

Une recherche qui échoue ou dure plus de deux secondes, et un déploiement où aucune liste n’est à jour, ne consultent rien : le courrier est accepté et rien n’est noté, de sorte qu”« inconnu » ne se lit jamais comme « propre ».

95.1.1.1.3.19. DNS inverse

Le DNS inverse du client est validé une fois par session (iprev de la RFC 8601 : un nom PTR qui se résout à nouveau vers l’adresse) et noté comme state.origin.iprev et dans l’en-tête Received:. Avec IPREV_ACTION = reject, un fail certain refuse les destinataires d’une session non authentifiée avec 550 5.7.25 Reverse DNS validation failed (RFC 7372), sauf <postmaster>, sur tout écouteur qui n’est pas un écouteur de soumission. Un temperror ou un permerror ne refuse jamais. La valeur par défaut, none, ne fait que noter : un DNS inverse cassé est un indice sur le DNS d’un expéditeur, non sur son message, et de petits sites en ont un.

95.1.1.1.3.20. Milters

Un milter est un filtre de courrier qui parle le protocole de filtrage de sendmail/Postfix : un analyseur de spam ou de virus, un daemon de politique, un greylister. Les milters qu’exécute un écouteur ([pepsi-ingress] MILTERS, ou le MILTERS propre à l’écouteur ; chacun configuré dans une section [pepsi-ingress-milter-*], pepsi.conf(5)) sont consultés pendant la session SMTP, de sorte que leur refus est la réponse que reçoit le client. Un 5xx est signalé par le MTA expéditeur à son utilisateur ; un 4xx est réessayé, et c’est ainsi que fonctionne le greylisting (pepsi-greylist(1) est le milter de greylisting livré avec Pepsi). Rien n’est accepté qui devrait plus tard faire l’objet d’un rebond vers un expéditeur peut-être falsifié. Par défaut, seuls les écouteurs qui ne sont pas des écouteurs de soumission exécutent des milters.

L’ingress ouvre une connexion vers chaque milter lorsque le client salue pour la première fois, et la garde pour toute la session. Le milter est informé de la connexion et de HELO/EHLO, de chaque MAIL (avec ses paramètres ESMTP), de chaque destinataire que Pepsi lui-même a accepté (avec NOTIFY/ORCPT/RRVS), de DATA (ou du premier bloc BDAT) et, à la fin des données, du bloc d’en-têtes, du corps et de la fin du message. Les vérifications propres à Pepsi passent toujours en premier : un milter n’est jamais interrogé sur un destinataire ou un message que Pepsi refuse de toute façon, et ce qu’on lui montre à la fin est le message tel que Pepsi le stockerait, avec le champ Authentication-Results de Pepsi et les éventuels champs X-Pepsi-Warning déjà ajoutés, de sorte qu’un filtre peut s’appuyer sur ces verdicts. Un milter qui l’a demandé (SMFIP_RCPT_REJ) est aussi informé des destinataires que Pepsi a refusés, avec la réponse de Pepsi. Un message refusé ou abandonné (RSET) est clos par SMFIC_ABORT avant le MAIL suivant. Les macros (i nomme le jeton de la ligne que deviendra le message) sont énumérées dans pepsi.conf(5).

Les milters sont interrogés dans l’ordre de la liste, et chacun voit le message tel que les précédents l’ont laissé. Ce que fait un verdict :

  • REJECT et TEMPFAIL (ou un code de réponse de leur classe) refusent le destinataire lorsqu’ils sont donnés à RCPT, et la transaction ou le message lorsqu’ils sont donnés à MAIL, à DATA, aux en-têtes, au corps ou à la fin du message. Le texte de réponse propre au milter est transmis lorsqu’il s’agit d’une réponse 4xx/5xx bien formée de la classe du verdict (plusieurs lignes permises) ; tout autre texte est remplacé par 451 4.7.1 … ou 550 5.7.1 …, de sorte qu’un filtre ne peut mettre sur le fil ni une acceptation ni une seconde ligne de réponse falsifiée.

  • Un refus à la connexion ou à HELO n’est pas signifié à ce moment-là : chaque MAIL ultérieur de la session le reçoit, comme avec smtpd_delay_reject de Postfix.

  • ACCEPT met fin à la participation de ce milter au message (ou, lorsqu’il est donné à la connexion ou à HELO, à la session) ; les autres milters sont toujours interrogés, comme sous Postfix. OpenDKIM, souvent le premier milter, répond ACCEPT, et le filtre antispam qui le suit doit tout de même voir le message.

  • DISCARD accepte le message avec 250 et ne stocke rien.

  • À la fin du message, un milter peut modifier des champs d’en-tête et le corps et, lorsque ALLOW_ACTIONS l’accorde, les destinataires et l’expéditeur d’enveloppe. Un destinataire qu’il ajoute doit être un destinataire que l’ingress aurait accepté de ce client ; un message dont il supprime tous les destinataires est accepté et non stocké. SMFIR_QUARANTINE stocke le message à l’étape de quarantaine (pepsi-stage-quarantine(1)) au lieu de init.

Les modifications du contenu d’un message qui porte une chaîne ARC sont appliquées aussi, mais la chaîne doit toujours être vérifiée sur les octets que ses scelleurs ont signés : le message tel que reçu est alors conservé à côté du message modifié (workqueue.arc_original_body_id, state.arc_original), et pepsi-stage-arc(1) vérifie la chaîne sur celui-ci et scelle le message stocké. L’ingress avertit au démarrage lorsqu’un milter peut modifier les messages et qu’aucune étape n’exécute pepsi-stage-arc(1).

Ce qu’a fait chaque milter est noté dans state.ingress_milter (son nom, son verdict et les modifications qu’il a faites ; pepsi.state(7)), et chaque refus est journalisé avec le nom et la réponse du milter. Un milter injoignable, qui dépasse son délai ou qui enfreint le protocole est traité comme le dit son ON_FAILURE. Par défaut (accept), il n’est plus consulté de la session et le courrier est accepté : un filtre planté ne doit pas arrêter tout le courrier entrant.

95.1.1.1.3.21. Contrôle d’admission dans la file d’attente

pepsi-ingress cesse d’accepter du courrier tant que la file d’attente, ou le disque qui la porte, atteint une limite fixée dans [pepsi] (voir pepsi.conf(5)) :

  • MAX_QUEUE_ROWS — messages en file (par défaut un million de lignes de destinataire) ;

  • MAX_QUEUE_BYTES — blocs d’en-têtes en file plus corps distincts (par défaut illimité) ;

  • MIN_FREE_SPACE — espace libre sur le système de fichiers de FREE_SPACE_PATH (par défaut 1 Gio sur /var/lib/postgresql).

La réponse est 452 4.3.1 Insufficient system storage, un refus temporaire, donnée à RCPT, à DATA (ou au premier bloc BDAT, dont les octets sont tout de même lus afin que la session reste cadrée) et une fois encore après la fin des données, lorsque la taille propre du message est connue et qu’un message isolé qui franchirait MAX_QUEUE_BYTES ou MIN_FREE_SPACE est refusé à lui seul. Le MTA expéditeur conserve le message et réessaie pendant que la file déjà présente s’écoule ; le bridage se lève de lui-même. La submission locale est traitée de la même façon, et pepsi-sendmail(1) transforme le 452 en EX_TEMPFAIL, de sorte que cron réessaie.

La vérification est peu coûteuse : la file est mesurée (la fonction pepsi.queue_usage(), deux parcours séquentiels) au plus une fois par QUEUE_CHECK_INTERVAL (par défaut 10 s) pour l’ensemble du serveur, et chaque commande dans l’intervalle reçoit sa réponse d’après ce chiffre. pepsi-ingress n’a besoin pour cela d’aucun accès au courrier en file, seulement aux colonnes de taille générées header_octets et workqueue_body.octets. Toute incertitude admet : une mesure échouée, ou un chemin de sonde qui n’existe pas (une base de données sur un autre hôte), laisse passer le courrier.

95.1.1.1.3.22. Protection contre l’engorgement

Plusieurs mécanismes empêchent un flot de connexions d’épuiser le serveur, y compris des clients qui complètent la poignée de main TCP puis deviennent silencieux sans jamais fermer. Ils opèrent sur une plage source : une seule adresse IPv4 (un /32), ou le préfixe /32 d’une adresse IPv6. Les connexions locales (socket UNIX) forment à elles seules une plage, exemptée de la limite de débit et de l’éviction à l’échelle du serveur et bornée à la place par son propre plafond : un soumissionnaire local est un utilisateur de cette machine, et pepsi-sendmail ne doit pas être éconduit parce qu’un hôte distant est occupé.

  • Délais par commande (RFC 5321 §4.5.3.2). Une session qui n’envoie pas sa commande suivante dans COMMAND_TIMEOUT (par défaut 300 s), ou le bloc suivant d’un corps DATA/BDAT dans DATA_TIMEOUT (par défaut 180 s), est fermée avec un 421.

  • Délai de poignée de main TLS. Une poignée de main TLS, sur un écouteur TLS implicite avant le message d’accueil ou après STARTTLS, doit se terminer dans TLS_HANDSHAKE_TIMEOUT (par défaut 30 s) ; sinon la connexion est fermée sans réponse (il n’y a aucun canal par lequel en envoyer une). Une poignée de main représente quelques allers-retours pour un client qui fonctionne, tandis que le serveur dépense une opération de clé privée et un état de connexion pour chacune ; un pair qui ouvre des connexions et cale ou distille son ClientHello occupe donc une place pendant cette durée plutôt que pendant tout un COMMAND_TIMEOUT.

  • Échéance de session. Chaque octet qu’envoie un client réinitialise les délais par lecture, de sorte qu’ils ne mettent jamais fin à une session qui continue de distiller ; SESSION_TIMEOUT (par défaut 30 m, 0 s désactive) borne toute la session dès sa connexion. Au-delà, la lecture suivante (une commande, une continuation AUTH, un bloc de corps) reçoit 421 4.4.2 Session time limit exceeded et la connexion est fermée. C’est ce qui empêche un client de garer des milliers de transactions juste avant la fin du DATA, chez cet hôte et d’autres, pour les terminer en un instant.

  • Plafond de connexions avec éviction. Le serveur admet au plus min(MAX_CONNECTIONS, MAX_OPEN_SOCKETS) connexions concurrentes. MAX_OPEN_SOCKETS protège contre l’épuisement des descripteurs de fichiers ; lorsqu’il n’est pas défini, il est dérivé du RLIMIT_NOFILE souple moins RESERVED_SOCKETS (par défaut 64, retenus pour le pool de base de données, les écouteurs, stdio et les sockets DNS). Lorsque le plafond est atteint et qu’une nouvelle connexion arrive, le serveur fait de la place en fermant la connexion la plus longtemps inactive dans la plage dont le temps d’inactivité total est le plus grand (un 421, puis fermeture), de sorte que la source la plus gourmande perde d’abord son créneau le plus inactif. « Inactif » est le temps qu’une connexion passe bloquée à attendre une entrée du client, entre les commandes ou entre les blocs d’un corps DATA/BDAT, mais pas le temps passé à traiter. Un client qui distille son corps octet par octet compte donc comme inactif et peut être évincé à tout moment du transfert ; chaque octet qu’il envoie réinitialise DATA_TIMEOUT, de sorte que le délai seul ne mettrait pas fin à une telle connexion.

  • Plafond par plage. Une plage source peut détenir au plus MAX_CONNECTIONS_PER_IP (par défaut 16) connexions à la fois, et l’ensemble des connexions locales au plus MAX_LOCAL_CONNECTIONS (par défaut 32). La limite de débit ci-dessous ne borne pas à elle seule la concurrence : une connexion par seconde, chacune maintenue occupée, remplit n’importe quel plafond en quelques minutes, et l’éviction ne récupère que les connexions inactives. Sans le plafond local, un seul utilisateur local pourrait occuper tous les créneaux et affamer le SMTP distant. Au sein du plafond local, un uid pair (tel que le rapporte SO_PEERCRED) peut détenir au plus la moitié de MAX_LOCAL_CONNECTIONS (au moins une), de sorte qu’un seul compte local ne puisse pas prendre tous les créneaux locaux et faire échouer le pepsi-sendmail des autres utilisateurs, celui de cron compris ; root et les comptes de service n’en sont pas exemptés. Deux comptes ou plus agissant ensemble pourraient encore remplir le plafond local à eux tous ; lorsqu’il est plein, une nouvelle connexion locale d’un uid qui détient moins de connexions locales que l’uid le plus chargé évince donc la connexion la plus longtemps inactive de cet uid, pourvu qu’elle n’ait envoyé aucune ligne de commande complète depuis 5 secondes ; la session évincée reçoit 421 4.3.2. pepsi-sendmail lit tout son message avant de se connecter et ne fait jamais de pause aussi longue, de sorte qu’un client local légitime n’est pas celui qui est évincé, tandis que des connexions maintenues ouvertes ne peuvent pas garder le plafond plein. Une nouvelle connexion de l’uid le plus chargé lui-même est refusée. Une connexion au-delà de l’un de ces plafonds est refusée comme une connexion limitée en débit. 0 désactive l’un ou l’autre plafond (et, pour la plage locale, la part par uid et l’éviction avec lui).

En outre, les nouvelles connexions acceptées sont limitées en débit par plage source par un seau à jetons : un taux de recharge CONN_RATE_PER_SECOND (par défaut 1) avec une rafale CONN_RATE_BURST (par défaut 1). Une connexion dépassant le débit reçoit un 421 au mieux puis est fermée, en occupant un créneau pendant la durée de cette écriture. C’est délibéré : ainsi, un flot de connexions limitées en débit ne peut pas engendrer un nombre illimité de tâches de rejet retenant chacune un descripteur hors de MAX_OPEN_SOCKETS. Lorsque la limite de débit se déclenche alors que le plafond de descripteurs est déjà atteint, aucun créneau n’est pris et la connexion est fermée sans aucune réponse, puisque l’écriture du 421 consommerait elle-même le descripteur que le serveur cherche à préserver. (Sur un écouteur en TLS implicite, le 421 de refus est de même omis, puisqu’aucun texte en clair ne peut précéder la poignée de main ; la connexion est simplement fermée.)

Au sein d’une session et d’une session à l’autre :

  • Messages par session. Une session peut démarrer au plus MAX_MESSAGES_PER_SESSION (par défaut 100) transactions de courrier (RSET ne remet pas le compte à zéro) ; le MAIL suivant reçoit 421 et la connexion est fermée, de sorte qu’un expéditeur ayant davantage à remettre se reconnecte, et la limite de débit mesure ces reconnexions.

  • Destinataires par transaction. Au plus 1000 RCPT TO sont acceptés dans une transaction (la RFC 5321 §4.5.3.1.8 en demande au moins 100) ; chaque suivant reçoit 452 4.5.3 et le client l’envoie dans une transaction ultérieure.

  • Boucles de routage. Un message qui est déjà passé MAX_SELF_HOPS fois (par défaut 5) par l’ingress de cet hôte est refusé en fin de données avec 554 5.4.6. Le compte provient des champs Received: que l’ingress écrit lui-même. Le refus transforme une boucle, dans laquelle une adresse de notre propre domaine est relayée encore et encore vers notre propre MX, en un seul rebond par l’étape qui a tenté de la relayer.

  • Plus d’un champ From:. Un message dont le bloc d’en-têtes porte deux champs From: ou plus est refusé à la fin des données avec 550 5.6.0, sur chaque écouteur. La RFC 5322 §3.6 en autorise un ; avec deux, les clients de messagerie ne s’accordent pas sur celui qu’ils affichent, tandis que l’alignement DMARC, la vérification d’identité de soumission et la liaison de signature lisent tous le premier, de sorte qu’un expéditeur pourrait faire vérifier une adresse et en faire afficher une autre.

  • Devinette de mots de passe. Trois tentatives AUTH échouées ferment une session. D’une session à l’autre, une plage source peut échouer AUTH au plus AUTH_FAILURES_PER_HOUR (par défaut 20) fois, dans un seau à jetons se rechargeant à ce rythme ; une fois celui-ci épuisé, chaque AUTH supplémentaire venant de la plage reçoit 421 et la connexion est fermée sans que le backend SASL soit interrogé, jusqu’à ce que le seau se recharge.

  • Devinette de mot de passe par compte. Un devineur réparti sur de nombreuses adresses reste sous chaque budget par plage ; les échecs sont donc aussi comptés par compte (son identifiant d’authentification, comparé sans tenir compte de la casse), toutes sources confondues : ACCOUNT_AUTH_FAILURES_PER_HOUR (par défaut 10). Une fois qu’un compte les a accumulés, un AUTH pour lui attend ACCOUNT_AUTH_DELAY (par défaut 20 s) avant que l’arrière-plan SASL soit interrogé, et de telles tentatives sont vérifiées une à la fois, de sorte que le compte n’est pas deviné plus vite qu’une fois par délai, quel que soit le nombre de connexions qui portent les essais. Une tentative qui attendrait plus de trois délais reçoit 454 4.7.0 sans être vérifiée. Le compte n’est jamais verrouillé, car un verrouillage permettrait à quiconque connaît un nom de compte d’en exclure son propriétaire. Une plage source qui s’est authentifiée sous ce compte au cours des 30 derniers jours n’est pas retardée du tout.

  • Débit de submission locale. Une session sur socket UNIX authentifiée par AUTH_PEERCRED est limitée par uid, sur l’ensemble de ses sessions, à LOCAL_MESSAGES_PER_MINUTE (par défaut 60) messages avec une rafale de LOCAL_MESSAGE_BURST (par défaut 120). Un MAIL au-delà du débit reçoit 451 4.7.1, que pepsi-sendmail(1) transforme en EX_TEMPFAIL.

  • Destinataires par compte. Une session authentifiée par AUTH SASL est limitée par identifiant d’authentification (comparé sans tenir compte de la casse), sur l’ensemble de ses sessions, à USER_RECIPIENTS_PER_HOUR (par défaut 500) destinataires acceptés avec une rafale de USER_RECIPIENT_BURST (par défaut 500). Un RCPT au-delà du débit reçoit 450 4.7.1, de sorte que le client garde le destinataire et réessaie plus tard. C’est ce qui borne un mot de passe volé : le voleur peut se connecter de n’importe où, mais chaque message est imputé au compte. Seuls les destinataires acceptés comptent, et <postmaster> n’est jamais refusé. Les sessions authentifiées par MYNETWORKS ou par un certificat client ne sont pas comptabilisées ici.

0 désactive n’importe lequel des cinq. Les compteurs inter-sessions résident dans la mémoire du serveur, de sorte qu’un redémarrage les oublie.

95.1.1.1.3.23. Abandon de privilèges

Les ports SMTP (25/465/587) sont privilégiés, de sorte que pepsi-ingress est souvent démarré en tant que root. Il ne sert cependant pas en tant que root : une fois chaque écouteur configuré lié (et tout matériel de clé TLS lu), le processus abandonne ses privilèges vers le compte de service pepsi-ingress non privilégié, abandonnant les groupes supplémentaires et basculant vers le gid et l’uid de ce compte avant d’accepter la moindre connexion. Le seul groupe supplémentaire qu’il conserve est celui d’une socket de milter : pour chaque milter joint par une socket UNIX, le groupe propriétaire de la socket, lorsque le compte pepsi-ingress en est membre dans /etc/group. C’est ainsi que l’on accorde l’accès à la socket d’un milter (adduser pepsi-ingress clamav, par exemple) ; le paquet Debian rend le compte membre de pepsi-greylist. Une socket qui n’existe pas au démarrage de l’ingress n’est pas prise en compte ; il faut donc démarrer le milter en premier. Le compte doit par conséquent exister avant que le serveur ne soit démarré en tant que root ; créez-le (par exemple useradd --system --no-create-home --shell /usr/sbin/nologin pepsi-ingress) dans le cadre de l’installation.

Si l’abandon ne peut être complété en s’exécutant en tant que root — le plus souvent parce que le compte pepsi-ingress n’existe pas — le serveur journalise une erreur et quitte sans servir, plutôt que de risquer de s’exécuter en tant que root. Lorsqu’il est démarré par un utilisateur non root, aucun changement de privilège n’est effectué (le serveur s’exécute simplement en tant que l’utilisateur invoquant) ; il ne s’exécutera jamais en tant que root.

95.1.1.1.3.24. Matériel de clés TLS

Les TLS_CERT/TLS_KEY de chaque écouteur MODE = tls/starttls sont lus une seule fois, au démarrage, avant l’abandon de privilèges ci-dessus.

Sous systemd, l’unit s’exécute dès le départ sous l’utilisateur non privilégié pepsi-ingress et ne détient jamais root ; elle ne peut donc pas ouvrir /etc/letsencrypt/{live,archive}, réservé à root par certbot. pepsi-setup(1) écrit par conséquent un drop-in /etc/systemd/system/pepsi-ingress.service.d/10-tls-credentials.conf comportant une entrée LoadCredential= par fichier : systemd les ouvre en tant que root au démarrage de l’unit et remet au service des copies privées sous $CREDENTIALS_DIRECTORY, que pepsi-ingress consulte avant de se rabattre sur la lecture du chemin configuré lui-même. Relancez pepsi-setup run après avoir ajouté, déplacé ou supprimé un certificat, afin que le drop-in soit régénéré. Comme les credentials sont matérialisés au démarrage de l’unit, un certificat renouvelé n’est servi qu’après un redémarrage ; le hook de déploiement certbot qu’installe pepsi-setup effectue ce redémarrage. Démarré directement (en tant que root, avec abandon des privilèges après la liaison des sockets), le serveur lit les fichiers lui-même et aucun credential n’intervient. Voir pepsi-httpd(1), qui décrit ce mécanisme en détail.

Contrairement à pepsi-httpd, qui sert de nombreux certificats et ignore celui qu’il ne parvient pas à charger, un écouteur n’en a ici qu’un seul : s’il est illisible, il n’y a rien sur quoi se rabattre, et le serveur sort plutôt que de n’offrir silencieusement aucun TLS sur un port que la configuration déclare chiffré.

95.1.1.1.4. Commandes

serve

Lier chaque socket [pepsi-ingress-listener-*] configurée et servir les connexions SMTP jusqu’à interruption. Nécessite que le schéma ait été installé avec pepsi-setup(1).

95.1.1.1.5. 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 FICHIERS).

-L LOGLEVEL, –log LOGLEVEL

Règle la verbosité de journalisation. LOGLEVEL est l’un de error, warn, info, debug ou trace (par défaut : [pepsi] LOG, sinon info).

-v, –verbose

Affiche les messages de journal de toutes les sources, y compris les bibliothèques tierces qui sont filtrées par défaut.

-h, –help

Affiche un résumé d’utilisation et quitte.

-V, –version

Affiche la version et quitte.

95.1.1.1.6. Signaux

SIGINT

Amorce l’arrêt : le processus cesse de servir et sort avec 0. Les sessions encore en cours ne sont pas drainées, et n’ont pas à l’être : un message n’est confirmé à son client (250) qu’une fois validé, de sorte qu’une session interrompue a soit son message en sécurité dans la file d’attente, soit n’a jamais reçu d’assurance du contraire, et le MTA expéditeur réessaie.

SIGTERM

Non capturé : la disposition par défaut met fin au processus, ce qui est sûr pour la même raison. C’est ce qu’envoie systemctl stop pepsi-ingress.

95.1.1.1.7. Code de sortie

0

Achèvement réussi (y compris un arrêt propre de serve).

1

Une erreur s’est produite, par exemple un fichier de configuration malformé, l’échec d’une connexion à la base de données, ou un écouteur qui n’a pas pu être lié. La raison est écrite dans le journal.

78

Le schéma de base de données installé ne correspond pas à ce binaire (non installé, plus ancien, plus récent ou modifié) ; exécutez pepsi-setup(1) de la même version.

95.1.1.1.8. Environnement

XDG_CONFIG_HOME, HOME

Utilisé pour localiser le fichier de configuration par défaut lorsque –config n’est pas fourni (voir FICHIERS).

LISTEN_FDS, LISTEN_PID, LISTEN_FDS_FIRST_FD

Honoré pour l’activation par socket de systemd. Un écouteur configuré avec SERVE = systemd adopte le descripteur de fichier transmis par systemd à l’index donné par son option FD_INDEX. LISTEN_FDS_FIRST_FD donne le numéro du premier descripteur transmis et vaut 3 par défaut (SD_LISTEN_FDS_START) ; il est lu au bénéfice des superviseurs autres que systemd qui le définissent. LISTEN_FDNAMES n’est pas consulté : un FileDescriptorName= nomme les descripteurs de toute une unité .socket plutôt qu’un seul ListenStream=, il ne pourrait donc pas distinguer ces écouteurs entre eux. La socket de soumission locale est trouvée autrement, par son adresse liée — voir ci-dessous.

Le pepsi-ingress.socket livré en transmet quatre : les ports 25, 465 et 587, que les sections d’écouteur revendiquent par FD_INDEX 0, 1 et 2, et la socket de soumission locale /run/pepsi/submission.sock, revendiquée autrement (voir ci-dessous). Lier cette socket UNIX dans l’unité plutôt que dans le serveur est délibéré : systemd la crée en tant que root avant le démarrage du service, de sorte que le pepsi-ingress non privilégié n’a jamais besoin de créer quoi que ce soit dans /run/pepsi, un répertoire que partagent plusieurs services et qu’aucune unité ne déclare comme son RuntimeDirectory= (l’entrée tmpfiles du paquet le crée).

La socket de soumission locale n’a aucun FD_INDEX et aucune section d’écouteur. pepsi-ingress la sert inconditionnellement (depuis [pepsi-sendmail] SOCKET) et trouve le descripteur en demandant au noyau laquelle des sockets transmises est liée à ce chemin. Un index serait une position parmi les entrées ListenStream= de l’unité et se décalerait donc dès qu’un port SMTP est ajouté ou retiré ; l’adresse liée ne peut se désynchroniser de rien. Si aucun descripteur transmis ne correspond, le serveur lie le chemin lui-même. C’est ce qui se passe hors systemd, et c’est pourquoi l’échec de la liaison y est fatal.

Tout autre descripteur transmis doit être revendiqué par une section d’écouteur. Celui qui ne l’est pas est signalé par un avertissement au démarrage nommant son index, car systemd continue d’y accepter des connexions auxquelles rien ne répondra jamais. Un client bloque alors jusqu’à l’expiration de son propre délai de lecture (deux minutes, pour pepsi-sendmail(1)) au lieu d’être refusé aussitôt : dans les deux cas le message est ajourné, mais le blocage fait caler l’appelant à chaque message. Si vous supprimez une section d’écouteur, supprimez aussi son ListenStream= de l’unité.

JOURNAL_STREAM

Lorsqu’elle est définie (c.-à-d. lors d’une exécution sous systemd), les horodatages sont émis en UTC sans décalage de fuseau horaire local.

95.1.1.1.9. 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

Chaque composant Pepsi partage le même fichier de configuration, c’est donc la même liste que chacun parcourt.

95.1.1.1.10. Exemples

Installer le schéma (une fois, avec pepsi-setup) et commencer à servir

pepsi-setup   -c /etc/pepsi/pepsi.conf
pepsi-ingress -c /etc/pepsi/pepsi.conf serve

Vérifier pour quels domaines le courrier est accepté (avec pepsi-config(1))

pepsi-config -c /etc/pepsi/pepsi.conf get pepsi-ingress ACCEPTED_DOMAINS

Imprimer la configuration fusionnée avec les annotations de source

pepsi-config -c /etc/pepsi/pepsi.conf dump --diagnostics

95.1.1.1.11. Voir aussi

Les garanties que soutiennent ces mécanismes figurent dans le modèle de menace du manuel de Pepsi (« Un expéditeur distant », « Un utilisateur shell local », « Ce que signifie un indicateur de sécurité », « Disponibilité ») ; les mécanismes sont décrits sous « La séparation des privilèges », « L’identité de soumission », « Destinataires inconnus et backscatter », « Un identifiant de connexion qui change de propriétaire » et « Limites de ressources » dans son chapitre sur la sécurité.

pepsi-config(1), pepsi.conf(5), pepsi-setup(1), pepsi-dispatch(1), pepsi-sendmail(1), pepsi.state(7), systemd.socket(5)

95.1.1.1.12. Bogues

Signalez les bogues au gestionnaire de tickets de Pepsi.