95.1.48. pepsi-sendmail

submit mail locally through the Sendmail interface

Section du manuel:

1

95.1.48.1.1. Nom

pepsi-sendmail - remettre à Pepsi un message écrit localement, en fournissant l’interface traditionnelle /usr/sbin/sendmail.

95.1.48.1.2. Synopsis

sendmail [-t] [-i] [-f SENDER] [-F NAME] [-v] [-N NOTIFY] [-R RET] [-V ENVID] [-c CONFIG] [RECIPIENT …]

mailq

newaliases

95.1.48.1.3. Description

pepsi-sendmail lit un message sur l’entrée standard et le soumet à pepsi-ingress via une socket de domaine UNIX locale. Il existe afin que les logiciels qui attendent d’un MTA qu’il fournisse /usr/sbin/sendmail puissent envoyer du courrier à travers Pepsi sans être reconfigurés : cron, mail(1), git send-email, logwatch, la fonction mail() de PHP.

Le paquet Debian l’installe sous les chemins que la Charte Debian §11.6 exige d’un agent de transport de courrier. Chacun est un lien symbolique vers le binaire unifié pepsi, qui aiguille selon le nom sous lequel il a été invoqué ; seul /usr/lib/sendmail pointe plutôt vers /usr/sbin/sendmail :

Chemin

Se comporte comme

/usr/sbin/sendmail

le client de soumission décrit ici

/usr/lib/sendmail

le même (chemin historique)

/usr/bin/mailq

sendmail -bp

/usr/bin/newaliases

sendmail -bi

/usr/sbin/rmail

le client de soumission (remise UUCP)

Une installation depuis les sources ne revendique pas ces chemins, car ils appartiennent au MTA que le système possède déjà ; passez INSTALL_MTA_LINKS=yes à make install pour les reprendre délibérément.

95.1.48.1.4. Authentification

pepsi-sendmail ne détient aucun privilège et n’affirme aucune identité. Il n’est ni setuid ni setgid, et il n’a besoin d’aucune entrée dans MYNETWORKS.

À la place, pepsi-ingress lit auprès du noyau l’identifiant d’utilisateur du processus qui se connecte (SO_PEERCRED, activé par écouteur avec AUTH_PEERCRED), le résout en un login via la base passwd, et recherche ce login dans USERNAME_MAP exactement comme il le ferait d’un nom d’utilisateur SASL arrivant sur le port de soumission. Les règles RFC 6409 §6/§8.1 s’appliquent alors inchangées : un programme local ne peut utiliser qu’un expéditeur d’enveloppe et un From: auxquels son propre compte est mappé, et un compte mappé à aucune adresse est refusé d’emblée. Chaque boîte aux lettres d’un From: à plusieurs boîtes est vérifiée, un From: qui ne s’analyse pas strictement selon la RFC 5322 ou dont le nom d’affichage nomme une autre adresse est refusé, de même qu’un message comportant plus d’un champ From:. Voir pepsi-ingress(1), Submission identity.

Deux conséquences en découlent :

  • La socket peut être accessible en écriture par tout le monde. Pouvoir l’ouvrir n’accorde rien, car cela ne détermine pas au nom de qui vous pouvez envoyer. Refusez un compte en le mappant à aucune adresse dans USERNAME_MAP, non en ajustant les permissions.

  • Rien sur le réseau n’acquiert de droits. C’est là la différence de fond avec le fait de faire confiance à l’interface loopback dans MYNETWORKS, qui authentifie une position réseau plutôt qu’un utilisateur : dans une telle configuration, n’importe quel processus local peut envoyer au nom de n’importe qui, et un message que cet hôte se relaie à lui-même y réapparaît comme une nouvelle soumission locale, ce qui peut boucler.

Comme les soumissions sont authentifiées, elles sont enregistrées avec state.local_origin positionné, de sorte que le pipeline les traite comme le courrier propre de cet hôte : il les signe en DKIM au nom du domaine de l’auteur et leur permet d’être relayées.

95.1.48.1.5. Le message

Les producteurs locaux écrivent les messages comme on écrit un fichier texte, aussi le client les met-il au propre avant que quoi que ce soit d’autre ne les regarde :

  • Chaque LF nu devient CRLF. SMTP est encadré en CRLF et pepsi-ingress l’impose (un LF nu dans DATA est refusé par 500 5.6.0 invalid line framing), cela ne peut donc pas être laissé au serveur.

  • Un champ From: est ajouté en tête lorsque le message n’en a aucun, construit à partir de -F et de l’expéditeur d’enveloppe ; un nom d’affichage contenant des caractères spéciaux au sens de la RFC 5322 est mis entre guillemets.

  • Chaque champ Bcc: est retiré, que -t ait été utilisé ou non : le laisser révélerait les destinataires en copie invisible à tous les autres figurant sur l’enveloppe.

  • Un destinataire sans @, comme le To: root de cron, est complété avec [pepsi-sendmail] DEFAULT_DOMAIN, avant que les doublons ne soient écartés (sans tenir compte de la casse), de sorte que la même adresse donnée deux fois n’est soumise qu’une fois.

La transaction elle-même est le minimum dont a besoin une socket sur l’hôte : lire la salutation, EHLO, MAIL FROM (avec BODY=8BITMIME lorsque le message contient des octets 8 bits et que le serveur a annoncé 8BITMIME, et avec les paramètres -R/-V seulement s’il a annoncé DSN), un RCPT TO par destinataire (portant -N sous la même condition), DATA avec le bourrage de points de la RFC 5321 §4.5.2 appliqué, et un QUIT au mieux, afin qu’un échec à dire au revoir ne puisse pas transformer un message accepté en erreur. Il n’y a ni STARTTLS, ni SASL, ni MTA-STS : le pair est une socket du système de fichiers sur cet hôte, le transport ne peut pas être observé, et l’authentification est l’affaire du noyau.

95.1.48.1.6. Options

-t

Lire les destinataires dans les en-têtes To:, Cc: et Bcc: du message. Chaque entrée est lue comme un client de messagerie l’affiche : une virgule dans un nom d’affichage entre guillemets ou dans un commentaire ne coupe pas la liste, et le destinataire est le premier <…> hors des chaînes entre guillemets et des commentaires ("<b@example.net>" <a@example.org> désigne a@example.org). Les membres d’un groupe sont lus un par un, et un groupe sans membres, comme undisclosed-recipients:;, ne nomme personne. Une entrée qui ne peut pas être lue comme une adresse est une erreur : le programme la nomme sur la sortie d’erreur standard, n’envoie rien et se termine avec le statut 65, afin qu’aucun destinataire ne soit ignoré sans que cela se remarque. Les destinataires lus sont ajoutés à ceux donnés sur la ligne de commande (comme Postfix), et une adresse déjà présente sur la ligne de commande n’est pas répétée. Les en-têtes Bcc: sont retirés du message dans les deux cas, avec ou sans -t.

-f SENDER, -r SENDER

Définir l’expéditeur d’enveloppe. Soumis à USERNAME_MAP : le serveur rejette un expéditeur auquel le compte appelant n’a pas droit. En son absence, on utilise le login du compte appelant qualifié par [pepsi-sendmail] DEFAULT_DOMAIN (et le littéral nobody@ suivi de ce domaine si le login ne peut pas être résolu). C’est une valeur par défaut de courtoisie, non une prétention : le serveur redérive de toute façon l’identité depuis les identifiants du pair.

-F NAME

Nom d’affichage d’un en-tête From: généré lorsque le message n’en a pas. Un nom qui contient une adresse e-mail autre que celle de l’expéditeur lui-même est refusé par le serveur (550 5.6.0, code de sortie 69), puisqu’on montrerait à un lecteur une adresse que le compte n’a pas le droit d’utiliser.

-i, -oi

Ne pas traiter une ligne ne contenant qu’un point comme une fin d’entrée. Accepté par compatibilité ; l’entrée est toujours lue jusqu’à la fin de fichier.

-v

Afficher le dialogue SMTP sur la sortie d’erreur standard, et rétablir la sortie de journalisation ordinaire de Pepsi. Sans cette option, le programme ne journalise que les avertissements et les erreurs : un binaire sendmail s’exécute depuis cron et depuis des scripts qui capturent la sortie d’erreur standard et la renvoient par courrier, de sorte que le bavardage informatif habituel transformerait chaque message réussi en un second message.

-c CONFIG, –config CONFIG

Lire la configuration Pepsi depuis CONFIG au lieu de l’emplacement habituel (voir pepsi.conf(5)). C’est une extension Pepsi, qui ne fait pas partie de la grammaire sendmail ; la valeur peut être accolée (-c/etc/pepsi/pepsi.conf) ou séparée.

Sans danger à honorer bien qu’il s’agisse de l’interface de soumission locale, car le programme ne détient aucun privilège d’aucune sorte : le pointer vers une autre configuration ne change que la socket à laquelle il se connecte, et le serveur dérive toujours l’identité de l’expéditeur de l’uid de l’appelant via SO_PEERCRED. Il s’écrit -c plutôt que le -C de sendmail parce que -C désigne déjà un sendmail.cf de remplacement, ce qui est autre chose, et est refusé (voir ci-dessous).

-N NOTIFY, -R RET, -V ENVID

Paramètres de notification d’état de remise (DSN) RFC 3461, transmis au serveur lorsqu’il annonce l’extension DSN. Voir pepsi-stage-bounce(1).

NOTIFY vaut NEVER ou une liste, séparée par des virgules, de SUCCESS, FAILURE et DELAY, chacun au plus une fois (RFC 3461 §4.1) ; RET vaut FULL ou HDRS (§4.3). ENVID est encodé en xtext sur le fil (§4.4), et un identifiant dont la forme encodée est vide ou dépasse les 100 caractères que la grammaire autorise est refusé plutôt que tronqué. Toute autre valeur est une erreur d’utilisation plutôt qu’un 501 du serveur.

Une valeur donnée à -f, -F, -N, -R ou -V, ou un destinataire, qui contient un caractère de contrôle est refusée avec EX_USAGE. Ces valeurs sont interpolées dans les lignes de commande SMTP et dans un champ From: généré, et les commandes SMTP sont délimitées par CRLF (RFC 5321 §4.1.1) : un retour chariot ou un saut de ligne dans l’une d’elles injecterait donc une commande supplémentaire (par exemple un destinataire que l’appelant n’a jamais déclaré) ou un champ d’en-tête supplémentaire. Cela compte surtout pour un appelant qui transmet directement une entrée utilisateur, comme une application web utilisant -f.

-bm

Lire et soumettre un message. Le comportement par défaut.

-bp

Afficher la file d’attente. La file de Pepsi réside dans la base de données plutôt que dans un répertoire de spool, et la lire exige un rôle qu’un utilisateur ordinaire ne détient pas : ceci affiche donc une indication sur la sortie d’erreur standard et quitte avec 70 ; utilisez pepsi-queue(1) pour la file elle-même et pepsi-status(1) pour un résumé. Note pour la supervision : mailq « échoue » donc toujours sur une installation Pepsi saine.

-bi

Reconstruire la base d’alias. La table d’alias de Pepsi est un simple fichier texte que pepsi-stage-aliases(1) relit dès que son heure de modification change, il n’y a donc rien à reconstruire et ceci se termine avec succès sans rien faire. Il se termine avant même de chercher le fichier de configuration, parce que les scripts de mainteneur de paquet exécutent newaliases sans condition et qu’il ne doit pas échouer sur un hôte dont la configuration est illisible ou pas encore écrite.

-I

Synonyme de -bi : une opération sans effet qui réussit, comme newaliases.

-h N, -L TAG, -X FILE, -B TYPE, -p PROTOCOL, -O NAME=VALUE

Acceptées et ignorées, comme les accepte le sendmail(1) de Postfix. Elles décrivent des compteurs de sauts, de la journalisation et des décisions d’ordonnancement de remise que le pipeline prend lui-même ; chacune consomme sa valeur, qu’elle soit attachée ou séparée, afin que la valeur ne soit pas prise pour un destinataire. Seuls les indicateurs de gestion de file et de démon sont refusés, car ils donneraient une fausse idée de ce que fait le programme.

-m, -U, -n, -s, -G, -Ac, -Am, -oX, -d…

Acceptées et ignorées, ne prenant aucune valeur propre. -oX est l’orthographe d’option à l’ancienne que cron émet encore (-odi, -oem), et -d est l’indicateur de débogage de sendmail, dont le niveau lui est attaché.

-bs, -bv

Acceptées par l’analyseur mais non prises en charge : chacune affiche pourquoi sur la sortie d’erreur standard et quitte avec 70. -bs (parler SMTP sur l’entrée standard) n’a aucun objet ici ; connectez-vous directement à la socket de soumission. -bv (vérification d’adresse) ne peut recevoir de réponse sans les tables d’acheminement, et inventer une réponse serait pire que de décliner.

-bd, -bD, -q…

Refusées au moment de l’analyse. Le serveur en écoute de Pepsi est pepsi-ingress(1) et sa file d’attente est vidée en continu par pepsi-dispatch(1) ; les accepter silencieusement laisserait croire à un démon ou à un passage de file qui n’existent pas.

-C est refusée plutôt que traitée comme -c : dans la grammaire sendmail, elle désigne un sendmail.cf de remplacement, qui n’a pas d’équivalent ici, et lire discrètement une configuration Pepsi depuis un chemin destiné à autre chose serait pire que de décliner. L’orthographe Pepsi est -c/--config, documentée ci-dessus ; sans l’une ni l’autre, le fichier de configuration est localisé de la manière habituelle (voir pepsi.conf(5)).

95.1.48.1.7. Configuration

[pepsi-sendmail]

SOCKET

Chemin de la socket de soumission de domaine UNIX de pepsi-ingress. Par défaut /run/pepsi/submission.sock. pepsi-ingress lit cette même option pour décider ce qu’il sert, de sorte que les deux extrémités ne peuvent pas être dirigées vers des chemins différents et qu’aucune section d’écouteur n’est nécessaire.

La valeur spéciale none désactive entièrement la soumission locale : le serveur ne lie aucune socket et ce programme refuse de s’exécuter.

EHLO_NAME

Nom annoncé dans EHLO. Par défaut [pepsi-ingress] HOSTNAME, ou localhost si celui-ci n’est pas défini. Cosmétique : le serveur authentifie le pair par ses identifiants, non par ce nom.

DEFAULT_DOMAIN

Domaine ajouté à une adresse nue, non qualifiée, comme le root que cron et les outils système remettent à sendmail sans @. Vaut par défaut [pepsi-ingress] HOSTNAME, ou localhost si celui-ci n’est pas défini.

C’est aussi le domaine de l’expéditeur d’enveloppe par défaut lorsque -f est omis (<login>@<DEFAULT_DOMAIN>). La table des identités de soumission du serveur applique le même repli à un nom d’utilisateur pour lequel elle n’a pas d’entrée, de sorte que sans USERNAME_MAP les deux s’accordent par construction. Cela ne concerne toujours que la manière dont le message est adressé : de qui il peut provenir découle de l’uid du pair via SO_PEERCRED et de la USERNAME_MAP, et régler cette option ne peut pas l’élargir.

Le côté serveur correspondant n’a besoin d’aucune configuration. pepsi-ingress sert cette socket inconditionnellement, en lisant exactement la même option SOCKET pour décider ce qu’il lie. Le client et le serveur ne peuvent donc pas être dirigés vers des chemins différents, et il n’y a aucune section d’écouteur à écrire, à maintenir en phase, ou à oublier. L’écouteur qu’il synthétise est figé, parce que rien de tout cela n’est un choix : MODE = plain, SUBMISSION = yes (les corrections d’en-têtes RFC 6409 s’appliquent donc) et AUTH_PEERCRED = yes, sur une socket de mode 0666.

Une section [pepsi-ingress-listener-*] facultative ferait au contraire dépendre la fonctionnalité de trois choses distinctes : la section doit exister, son UNIXPATH doit correspondre à SOCKET, et le serveur doit pouvoir écrire dans le répertoire d’exécution. Chacune est facile à rater, avec chaque fois le même symptôme : le courrier de cron s’arrête en silence. D’un hôte faisant tourner un MTA, on attend qu’il fournisse /usr/sbin/sendmail.

Sous systemd, le descripteur est hérité plutôt que lié, lorsque le pepsi-ingress.socket livré porte déjà un ListenStream= pour le même chemin. Ce n’est pas une affaire de privilège, puisque ce n’est pas un port privilégié, mais de disponibilité. Lié par l’unité .socket, le nœud est créé par systemd en tant que root avant le démarrage du service et reste en place pendant que le service redémarre, de sorte qu’un /usr/sbin/sendmail concurrent attend au lieu d’échouer. /run/pepsi lui-même est partagé par plusieurs services et appartient à l’entrée tmpfiles du paquet, jamais au RuntimeDirectory= d’une unité.

Le descripteur est apparié par l’adresse à laquelle il est lié, non par un FD_INDEX. Un index est une position parmi les entrées ListenStream= de l’unité : il change donc dès qu’un port est ajouté ou retiré. Ce serait une seconde déclaration à maintenir en phase avec un fichier qu’elle ne peut pas voir. Demander au noyau à quoi chaque descripteur transmis est lié n’a pas ce mode de défaillance : ajouter ou retirer un port SMTP ne renumérote rien, un hôte purement sortant qui abandonne le port 25 n’exige aucune modification, et l’unité et la configuration ne peuvent pas être en désaccord sur l’identité de cette socket. Si aucun descripteur transmis ne correspond (sans systemd, ou pour un SOCKET que l’unité ne lie pas), pepsi-ingress lie le chemin lui-même.

Si vous modifiez SOCKET, modifiez le ListenStream= de l’unité en conséquence ou supprimez-le : une entrée sur laquelle rien n’accepte est pire que pas d’entrée du tout, car l’appelant se connecte puis bloque jusqu’à l’expiration de son propre délai de lecture (deux minutes, puis EX_TEMPFAIL) au lieu d’être refusé aussitôt. pepsi-ingress journalise au démarrage un avertissement nommant chaque descripteur transmis qu’aucun écouteur n’a revendiqué.

Échouer à lier la socket est fatal : pepsi-ingress refuse de démarrer plutôt que de tourner en ne servant qu’une partie de ce qu’on lui a demandé de servir. Un serveur qui tourne avec la soumission locale silencieusement absente est précisément la défaillance que cet arrangement existe pour empêcher, et elle est invisible jusqu’à ce que du courrier se perde.

Écrire votre propre section d’écouteur pour le même chemin est pris en charge, et c’est ainsi que vous donnez à la socket des options différentes, par exemple un groupe, un mode plus strict ou l’absence d’identifiants de pair. Une section servant ce chemin remplace l’écouteur intégré plutôt que d’entrer en collision avec lui.

95.1.48.1.8. La désactiver

SOCKET = none désactive entièrement la soumission locale : pepsi-ingress ne sert aucune socket, et pepsi-sendmail refuse de s’exécuter (sortie EX_SOFTWARE, avant même de lire le message : c’est une mauvaise configuration permanente, que cron ne doit donc pas réessayer). Les programmes de l’hôte doivent alors s’authentifier sur 587 ou 465 comme n’importe quel autre client. pepsi-setup le signale une fois, car un serveur de messagerie sans chemin de soumission locale est assez inhabituel pour qu’un opérateur qui ne l’a pas voulu en soit informé.

95.1.48.1.9. Code de sortie

Les valeurs traditionnelles de sysexits.h, sur lesquelles cron et les autres appelants se fondent :

0

le message a été accepté

64

erreur d’utilisation (EX_USAGE)

65

le message était inutilisable, par exemple -t n’a trouvé aucun destinataire, ou une adresse qu’il n’a pas pu lire

66

le message n’a pas pu être lu depuis l’entrée standard

67

un destinataire a été rejeté comme inconnu — un statut RFC 3463 x.1.x, ou un 550 nu (EX_NOUSER)

69

tout autre rejet permanent par le serveur (EX_UNAVAILABLE)

70

erreur interne, par exemple la configuration n’a pas pu être analysée, ou SOCKET = none a désactivé la soumission locale (EX_SOFTWARE) ; c’est aussi le code de sortie des modes acceptés mais non pris en charge -bp/mailq, -bs et -bv, dont chacun s’explique sur la sortie d’erreur standard

75

échec temporaire — la socket était injoignable, une commande a expiré, le serveur a fermé la connexion ou a répondu du SMTP malformé, ou il a différé avec un 4xx ; l’appelant devrait réessayer plutôt que de considérer le courrier comme perdu (EX_TEMPFAIL)

77

le serveur a refusé pour des raisons de politique — un statut RFC 3463 x.7.x, typiquement un expéditeur que le compte appelant n’a pas le droit d’utiliser (EX_NOPERM)

Un rejet permanent est classé d’après le code d’état étendu placé au début de la réponse du serveur, jamais en fouillant sa prose : ainsi 550 5.1.1 unknown user (see the 5.7.1 policy page) est signalé comme un destinataire inconnu et non comme un refus de politique.

95.1.48.1.10. Fichiers

/run/pepsi/submission.sock

La socket de soumission, à moins que [pepsi-sendmail] SOCKET ne nomme un autre chemin. Les deux extrémités lisent cette même option, de sorte que le client et pepsi-ingress ne peuvent pas être en désaccord sur son emplacement.

Lorsque -c/–config n’est pas fourni, la configuration est le premier fichier existant de la liste suivante — la même liste que parcourt chaque composant Pepsi :

  • $XDG_CONFIG_HOME/pepsi.conf

  • $HOME/.config/pepsi.conf

  • /etc/pepsi/pepsi.conf

  • /etc/pepsi.conf

95.1.48.1.11. Exemples

Envoyer un message en prenant les destinataires dans ses en-têtes

printf 'To: ops@example.org\nSubject: nightly\n\nall good\n' | sendmail -t

Observer le dialogue en diagnostiquant un refus

sendmail -v -f alice@example.org bob@example.net < message.eml

95.1.48.1.12. Voir aussi

Les règles d’identité sur lesquelles repose ce programme sont décrites sous « The submission identity » dans le chapitre sécurité du manuel de Pepsi, et l’adversaire auquel elles répondent sous « A local shell user » dans son modèle de menace.

pepsi-ingress(1), pepsi-queue(1), pepsi-status(1), pepsi-stage-aliases(1), pepsi.conf(5)