95.2.1. pepsi.conf¶
configuration file for the Pepsi pipeline
- Section du manuel:
5
95.2.1.1.1. Nom¶
pepsi.conf - fichier de configuration partagé par tous les composants Pepsi.
95.2.1.1.2. Description¶
Chaque composant Pepsi — pepsi-ingress(1), pepsi-dispatch(1), chaque programme pepsi-stage-*, pepsi-httpd(1), pepsi-queue(1), pepsi-tlsrpt(1), pepsi-setup(1) et le reste — lit le même fichier de configuration de style INI, conventionnellement pepsi.conf. Le format est partagé avec les composants GNU Taler sur lesquels Pepsi est bâti.
Comme il y a un seul fichier, chaque paramètre est documenté une fois, sous la section qui le possède. Un composant ne lit que les sections qui le concernent : les sections partagées [pepsi] et [pepsi-postgres] sont lues par tout le monde ; les sections de pipeline [stage-<name>] sont lues par le dispatcher et les programmes d’étape ; les sections spécifiques à un composant ([pepsi-ingress], [pepsi-httpd], [pepsi-dispatch], [pepsi-payments], [pepsi-tlsrpt] …) par le composant nommé.
Une option que rien ne lit est ignorée, de sorte qu’une option mal orthographiée prend silencieusement sa valeur par défaut ; pepsi-setup(1) avertit de chacune de ces options dans une section qu’il connaît, en nommant l’option réelle la plus proche.
Options renommées. Lorsqu’une version renomme une option, l’ancien nom continue de fonctionner pendant au moins une version de plus : chaque programme la lit sous le nouveau nom et journalise un avertissement qui le signale, et pepsi-setup(1) avertit également. Lorsque les deux noms sont définis, le nouveau l’emporte. NEWS liste chaque renommage.
95.2.1.1.3. Format de fichier¶
Un fichier de configuration est une suite d’en-têtes [SECTION], chacun suivi d’affectations OPTION = VALUE
[pepsi-ingress]
HOSTNAME = mail.example.org
ACCEPTED_DOMAINS = example.org example.com
Les noms de section et d’option sont insensibles à la casse et sont conventionnellement écrits en majuscules. Les lignes vides sont ignorées. Un # ou % en début de ligne introduit un commentaire. Une valeur peut être entourée de guillemets doubles pour préserver les espaces de début ou de fin.
95.2.1.1.3.1. Directives¶
- @inline@ FILE
Inclure un autre fichier de configuration, résolu relativement au fichier courant.
- @inline-matching@ GLOB
Inclure chaque fichier correspondant au glob shell GLOB.
- @inline-secret@ SECTION FILE
Fusionner la section SECTION de FILE (typiquement un fichier à mode restreint contenant des identifiants) dans la configuration. Un fichier qui ne peut pas être lu est ignoré avec un avertissement. Cela garde les secrets hors du fichier principal lisible par tous.
Une directive est une ligne de premier niveau : comme
@inline@, elle termine la section dans laquelle elle apparaît. Écrivez-la après la dernière option de la section qu’elle alimente. Une option placée en dessous d’elle n’appartient à aucune section, et le fichier entier échoue alors au chargement avecexpected section header or directive. C’est pour cette raison que pepsi-setup(1) émet toujours ses directives en dernier au sein d’une section[pepsi-srs] SRS_DOMAIN = srs.example.net MAX_AGE_DAYS = 21 @inline-secret@ pepsi-srs secrets.d/pepsi-ingress.secret
Comme un fragment illisible ne produit qu’un avertissement, une option qu’il aurait dû fournir a simplement l’air non réglée. Ce qui a besoin de la valeur signale alors le problème de permissions, typiquement sous la forme « … is not configured ». Pepsi détecte ce cas et le dit explicitement, en nommant le fragment, son propriétaire et son mode ; exécutez
pepsi-setup runen tant que root pour donner chaque fragment au compte qui doit le lire.
95.2.1.1.3.2. Substitution de valeurs¶
Les options lues comme des chemins subissent une expansion $ : $VAR et ${VAR} sont remplacés par la valeur de VAR de la section [PATHS] ou, à défaut, de l’environnement. La forme ${VAR:-default} fournit un repli. La section [PATHS] est pré-remplie avec les répertoires d’installation habituels (PREFIX, BINDIR, DATADIR et ainsi de suite).
95.2.1.1.3.3. Types de valeur¶
- booléen
YESouNO(insensible à la casse).- nombre
Un entier décimal. Quelques options documentées comme telles prennent à la place une valeur fractionnaire, et chacune le signale là où elle est décrite (les options de débit de connexion de l’ingress et le
RETRY_FACTORdes étapes de relais).- durée
Une durée telle que
5 sou2 h. Voir la mise en garde ci-dessous.- chemin
Un chemin de système de fichiers soumis à l’expansion
$comme décrit ci-dessus.- mode unix
Une permission de fichier écrite en octal, par exemple
660.
Avertissement
Les valeurs duration sont analysées par jiff::SignedDuration, qui n’accepte que les heures/minutes/secondes et en dessous. Une unité calendaire telle que 5 d ou 2 weeks ne s’analyse pas. Pour une durée d’un jour ou plus, écrivez l’équivalent en heures (120 h) ou utilisez une option entière lorsqu’il en existe une (par exemple [pepsi-srs] MAX_AGE_DAYS).
95.2.1.1.4. La surcouche en base de données¶
Ce fichier est la couche de base. Par-dessus, chaque composant lit un ensemble de redéfinitions gérées par l’administrateur dans la table pepsi.config_override du schéma partagé, de sorte qu’un déploiement puisse être reconfiguré sans éditer de fichier et, pour les sections d’étape, sans redémarrage. Sans aucune ligne dans cette table, un déploiement se comporte exactement comme ce fichier le dit ; supprimer toutes les redéfinitions le ramène à cet état.
La chaîne de portées, précédence la plus faible d’abord :
ce fichier ;
la portée de base de données
global;la portée de base de données
domain:DOMAIN ;la portée de base de données
address:ADDRESS ;la table
pepsi.settingspar adresse (pepsi-settings(1)).
Les couches supérieures redéfinissent les inférieures option par option, jamais section par section : une option qu’aucune couche ne mentionne conserve la valeur écrite ici. L’adresse à laquelle une portée domain:/address: est comparée est l’expéditeur d’enveloppe pour un message d’origine locale, sinon chaque destinataire d’enveloppe.
The last layer is a different table with a different write authority.
pepsi.settings is written by account owners themselves, by e-mail, within
the EDITABLE_STAGES allowlist; config_override defines the pipeline and
is writable only through the pepsi-config PostgreSQL role. pepsi-setup(1) grants that role INSERT/UPDATE/DELETE on the table, revokes them
from every service account, and verifies both against the live database after
each install. A stage worker parses hostile mail all day long, so it must not be
able to rewrite the configuration that defines its own stage.
95.2.1.1.4.1. Sections qui ne sont jamais lues depuis la base¶
Une redéfinition qui en nomme une est ignorée à l’exécution et refusée à l’écriture :
[pepsi],[pepsi-postgres],[PATHS]Lues avant qu’une connexion à la base ne puisse exister — et
[pepsi]détient en outre la politique cryptographique réservée à l’administrateur.[pepsi-httpd],[pepsi-httpd-listener-*],[pepsi-httpd-cert-*]Le serveur qui sert l’interface de configuration doit toujours pouvoir démarrer.
[pepsi-ingress-listener-*]Les sockets d’écoute sont liées au démarrage, souvent sous activation par socket et avant l’abandon des privilèges.
[pepsi-secure-link]Son
PEPPERest le secret côté serveur qui rend inutile une base de données volée. Une base qui pourrait le remplacer pourrait faire en sorte que le prochain message stocké soit un message qu’un attaquant peut ouvrir. Les autres options de la section restent avec lui dans le fichier.[pepsi-admin]Décide qui peut administrer le serveur et comment l’interface d’administration atteint la base de données. Si la base pouvait en décider, quiconque peut écrire dans la base pourrait s’octroyer l’accès à la console.
[pepsi-crypto],[pepsi-srs],[pepsi-origin]Chacune détient une clé côté serveur qui existe pour que la base de données seule ne suffise pas : les clés de chiffrement de clés (et laquelle d’entre elles enveloppe les nouvelles clés privées), la clé SRS qui autorise le relais vers n’importe quelle adresse, et la clé de preuve d’origine avec laquelle Pepsi vérifie un rebond ou une demande de paiement qui revient. Une base qui pourrait en remplacer une pourrait faire en sorte que la prochaine clé enveloppée soit une clé qu’un attaquant peut ouvrir, ou qu’un rebond falsifié soit relayé ou payé. Les autres options de chaque section restent avec elle dans le fichier.
[pepsi-wizard]Pas du tout de la configuration, mais le relevé par pepsi-setup(1) des réponses qui lui ont été données, que la console du navigateur dépose en brouillon dans cette même table. Rien ne le lit à l’exécution, la base de données ne le fournit donc pas non plus.
Trois règles supplémentaires s’appliquent dans toutes les autres sections :
Aucun identifiant n’est jamais stocké dans la base de données. Dans chaque section, une option est refusée à l’écriture et ignorée à l’exécution lorsque son nom la désigne comme un identifiant, c’est-à-dire lorsque ce nom contient
PASS(PASSWORD,PASSPHRASE,API_PASS),SECRET,TOKEN,CREDENTIAL,CLIENT_ID,PEPPERouSYSTEM_ID. (La même règle masque une valeur partout où une configuration est affichée.) Cela inclut le fichier d’où un identifiant est lu et le point de terminaison auquel il est envoyé (SECRET_FILE,TOKEN_FILE,TOKEN_ENDPOINT), car une base qui pourrait les définir pourrait détourner l’identifiant. Les identifiants résident dans ce fichier ou dans ses fragmentssecrets.d, chacun lisible uniquement par le compte qui en a besoin.Aucun programme n’est choisi par la base de données.
HELPER,SCAN_HELPER,MAILBOX_HELPERetPIN_COMMANDnomment un exécutable, et une étape setgid ou un outil setuid lance plusieurs d’entre eux. Dans chaque section, ces options sont refusées à l’écriture et ignorées à l’exécution. LePROGRAMd’une étape n’est accepté que sous la forme d’une commandepepsi-stage-*nue (sans composant de chemin), de sorte qu’une étape peut encore être ajoutée par la base de données mais n’exécute jamais qu’un binaire d’étape installé.Les portées
domain:etaddress:n’acceptent que des sections[stage-*]et nulle autre. Ces couches sont consultées par une étape, message par message, pour la section qu’elle exécute ; rien ne lit une autre section par domaine ou par adresse, de sorte qu’une telle redéfinition est refusée plutôt que stockée et jamais lue.
Par conséquent, pour ajouter un port de soumission ou pour changer le matériel TLS d’un écouteur, la connexion à la base ou la politique cryptographique, vous modifiez ce fichier et redémarrez ; aucune interface d’administration ne peut le faire. [pepsi-ingress] DB_POOL_SIZE et [pepsi-dispatch] DB_POOL_SIZE sont réservés au fichier pour la même raison d’amorçage : le pool doit exister avant que la surcouche ne puisse être lue.
95.2.1.1.4.2. Rechargement à chaud¶
Chaque écriture dans la table déclenche une notification config_changed.
Tout changement [stage-*] est appliqué sans redémarrage, dans les deux moitiés du pipeline : le dispatcher et les workers d’étape. À la notification, pepsi-dispatch(1) reconstruit sa propre table d’étapes à partir de la surcouche et met ses workers d’étape hors service, de sorte que les remplaçants relisent la surcouche. Une étape peut donc être ajoutée, modifiée ou supprimée pendant que le pipeline tourne, et un PROGRAM/PARALLELISM/MAX_MESSAGES/QUEUE_LIMIT modifié prend effet. Aucun message n’est interrompu : un worker ne reçoit plus de travail et son créneau est abandonné une fois que ses messages en vol ont rendu compte.
Un rechargement n’achemine jamais le courrier selon un pipeline que les workers ne partagent plus. Un graphe d’étapes rechargé qui ne s’analyse pas met fin au dispatcher (sortie EX_CONFIG, par l’arrêt ordinaire, de sorte que rien n’est laissé en plan) plutôt que de laisser la table précédente en place.
Toute autre section est lue une fois au démarrage par le composant qui la possède et exige donc le redémarrage de ce composant – y compris les options propres à [pepsi-dispatch], qui ne sont délibérément pas rechargées. pepsi-config set imprime quel cas s’applique.
Une modification de ce fichier atteint le pipeline de la même façon : pepsi-dispatch(1) vérifie la date de modification et la taille du fichier toutes les deux secondes et, lorsqu’elles changent, le relit, reconstruit sa table d’étapes et retire ses workers. Un fichier qui ne s’analyse pas n’est pas appliqué ; le dispatcher journalise l’erreur et garde la configuration qu’il a.
Un composant qui manque une notification relit la surcouche lorsque son écouteur de base se reconnecte : une notification perdue coûte donc de la latence, non de la correction.
Les secrets ne sont jamais stockés dans la base : la surcouche refuse un identifiant (voir ci-dessus), et la référence @inline-secret@ réside dans ce fichier. Chaque fragment reste la propriété de l’unique lecteur qui en a besoin.
Une valeur défectueuse dans la base ne peut empêcher aucun programme de démarrer : une surcouche illisible ou ne produisant pas une configuration utilisable est journalisée bruyamment et ce fichier est employé tel quel.
Voir pepsi-config(1) pour set/unset/list, pour dump --origin (qui annote chaque valeur effective avec la couche dont elle vient), et pour l”export/import chiffré de ce fichier et de ses fragments secrets.d.
95.2.1.1.5. La section [pepsi]¶
Paramètres d’identité et de politique transversaux partagés entre les outils Pepsi. Cette section n’est jamais lue depuis la surcouche en base.
- KEY_DIR = PATH
Répertoire qui peut contenir des fichiers de clés DKIM par domaine laissés par une installation plus ancienne (
<domain>/dkim.rsa.keyet<domain>/dkim.ed25519.key). Rien ne signe avec eux : les clés DKIM et ARC appartiennent à pepsi-dkim(1). Dès que ce démon répond,pepsi-setup runsupprime ces fichiers et liste leurs sélecteurs (<DKIM_SELECTOR>et<DKIM_SELECTOR>-ed25519) comme enregistrements pouvant être retirés du DNS. Facultatif ; par défaut/var/pepsi/keys.- DKIM_SELECTOR = NAME
Préfixe des sélecteurs DKIM que pepsi-dkim(1) donne à ses clés : chaque génération de clés d’un domaine est publiée à
<NAME>-YYYYMM._domainkey.<domain>(RSA) et<NAME>-YYYYMM-ed25519._domainkey.<domain>(Ed25519), oùYYYYMMest le mois où les clés ont été créées (avec une lettre ajoutée lorsque ce nom est pris). Facultatif ; par défautpepsi.- DKIM_ALGORITHMS = LIST
Les signatures DKIM qu’ajoute pepsi-stage-dkim-sign(1) : une liste de
rsaeted25519séparés par des espaces ou des virgules. Facultatif ; par défaut les deux. Gmail, Microsoft 365 et Yahoo ne vérifient pas les signatures Ed25519 (RFC 8463) ; ils les ignorent, et les rapports agrégés DMARC de Google indiquent le sélecteur Ed25519 commefail. C’est sans conséquence — DMARC a besoin d’une réussite alignée et la signature RSA la fournit — maisrsaseul supprime ce bruit. Omettrersaest permis et fait l’objet d’un avertissement de pepsi-setup(1) : ces destinataires ne verraient alors plus aucune signature vérifiable. pepsi-setup ne publie et ne vérifie que les sélecteurs utilisés (plus celui dont le sceau ARC a besoin lorsque ce domaine est l”ARC_DOMAIN), et pepsi-dkim(1) ne crée des clés que pour eux.- ARC_DOMAIN = DOMAIN
Domaine dont pepsi-stage-arc(1) utilise l’identité pour sceller en ARC le courrier entrant (RFC 8617). Le sceau est fait avec la clé DKIM d”
ARC_ALGORITHMde ce domaine. pepsi-setup(1) ajoute donc ce domaine aux domaines de signature qu’il remet à pepsi-dkim(1), qui crée cette clé pour lui, et aux enregistrements DNS DKIM qu’il affiche ; ARC n’a besoin d’aucun enregistrement séparé. Facultatif ; s’il n’est pas défini, les résultats d’authentification sont notés mais pas scellés.- ARC_ALGORITHM =
rsa|ed25519 Algorithme qui signe l’unique sceau ARC (ARC n’en permet qu’un par saut, contrairement à DKIM qui est par défaut signé avec les deux — voir
DKIM_ALGORITHMS). Facultatif ; par défautrsapour la plus large interopérabilité.- ORIGINATE_SUCCESS_DSN =
yes|no Whether Pepsi may originate a positive (
Action: delivered) delivery-status notification when a delivery succeeds and the sender requestedNOTIFY=SUCCESS. Optional; defaults tono— Pepsi normally emits only failure bounces. Whenyes, the delivery stages (pepsi-stage-relay-to-internet(1), pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1)) and pepsi-stage-discard(1) route a successful delivery to theirBOUNCE_STAGE(for LMTP, itsNOTIFY_STAGE) to emit the report.Elle ne régit que les rapports
SUCCESS. Les rapportsDELAYont leur propre interrupteur, par étape (leDELAY_DSN_AFTERd’une étape de remise, non réglé par défaut), et les rebondsFAILUREn’ont besoin d’aucun interrupteur – ils sont la valeur par défaut lorsque leNOTIFYd’un destinataire ne dit rien.SUCCESScommeDELAYne sont émis que lorsque leNOTIFYde l’expéditeur les a demandés nommément ; ni l’un ni l’autre n’a de valeur par défaut implicite.- MAILBOX_QUOTA = SIZE
Limite par défaut de la quantité de courrier qu’un compte local peut détenir, appliquée par pepsi-stage-relay-to-maildir(1). Un simple nombre d’octets ou un suffixe
K/M/G/Ten puissances de 1024 (2G,500M,1048576), ounone. Facultatif ; vautnonepar défaut — aucun quota. La limite d’un compte particulier se règle avec pepsi-quota(1)set, qui redéfinit ceci ; la limite propre au noyau resserre celle qui s’applique.Le quota couvre tout l’arbre Maildir++ — la boîte de réception plus chaque dossier (
.Sent,.Trash, …) — car c’est ce que l’utilisateur appelle sa boîte aux lettres, et ne compter que la boîte de réception permettrait à quiconque de garder une quantité illimitée de courrier dans un autre dossier, à un glisser-déposer de là.- MAILBOX_QUOTA_COUNT = N
Limite par défaut du nombre de messages qu’un compte peut détenir ;
0ou absent pour aucune. Un très grand nombre de très petits messages est en soi un déni de service contre une boîte aux lettres, et une limite en octets seule ne l’empêche pas.- MAILBOX_OVER_QUOTA =
defer|bounce Ce qui arrive à un destinataire dont la boîte aux lettres est pleine. Facultatif ; vaut
deferpar défaut.defergarde le message en file et le réessaie jusqu’auMAX_LIFETIMEde l’étape de remise, puis génère un rebond, ce qui laisse au compte le temps de faire de la place.bouncerefuse aussitôt avec un5.2.2de la RFC 3463, acheminant le destinataire vers leQUOTA_LIMIT_STAGEde l’étape de remise (sinon sonBOUNCE_STAGE), de sorte que l’expéditeur ne reste pas à attendre des jours. UnEDQUOTdu noyau compte comme une boîte aux lettres pleine et reçoit le même traitement. Au moment de la remise, cela ne régit que pepsi-stage-relay-to-maildir(1) ; pepsi-stage-relay-to-lmtp(1) achemine le propre refusx.2.2du MDA vers sonQUOTA_LIMIT_STAGEquoi que dise cette option.Le même choix détermine la réponse que donne pepsi-ingress(1) lorsqu’il refuse un destinataire hors quota au
RCPT:452 4.2.2pourdefer,552 5.2.2pourbounce.- MAILBOX_QUOTA_MAX_AGE = DURATION
Combien de temps une mesure de boîte aux lettres peut être crue pour un refus au moment du
RCPT. Facultatif ; vaut15 mpar défaut. Les unités sonth/m/s.pepsi-ingress(1) ne refuse un destinataire hors quota que sur une mesure plus jeune que cela, et jamais sur l’estimation d’usage courante. C’est une borne de correction, non de performance : l’estimation ne fait que croître (rien n’indique à Pepsi qu’un utilisateur supprime du courrier en IMAP), de sorte que refuser sur elle fermerait une boîte aux lettres que son propriétaire a depuis vidée. Elle resterait fermée pour de bon : chaque message étant refusé, aucune remise ne s’exécuterait pour mesurer à nouveau la boîte. Cette borne et pepsi-quota(1)
reconcilel’empêchent.- MAILBOX_QUOTA_RCPT_CHECK =
yes|no Si pepsi-ingress(1) consulte la table des quotas au moment du
RCPT. Facultatif ; vautyespar défaut. Refuser là coûte une consultation indexée et épargne un rebond : le MTA émetteur est encore en ligne, c’est donc lui qui prévient son utilisateur, et Pepsi ne produit aucun backscatter vers un expéditeur d’enveloppe qui peut fort bien être falsifié. Le désactiver déplace toute l’application au moment de la remise.- MAILBOX_HELPER = PATH
Le helper privilégié que pepsi-quota(1) exécute pour mesurer une boîte aux lettres — pour sa sous-commande
measureet son balayagereconcile. Facultatif ; vautpepsi-helper-maildir-writerpar défaut, résolu sur lePATHdu processus appelant.C’est le même binaire que celui qu’emploie l’étape de remise locale, invoqué dans son mode
measure: unMaildirest en0700, c’est donc l’unique processus qui peut devenir l’utilisateur et le lire. Ne réglez ceci que lorsque le helper n’est pas sur lePATHdepepsi-quotasous son nom — principalement une installation depuis les sources avec--prefix. Gardez-le en accord avec la propre optionHELPERde l’étape de remise dans sa section[stage-<name>](voir pepsi-stage-relay-to-maildir(1)) : les deux nomment le même programme pour deux appelants, et seule celle de l’étape est par étape. Comme toute option qui nomme un programme, elle ne peut pas être définie depuis la surcouche de la base de données.- MAILBOX_FS_QUOTA =
yes|no Si le système de fichiers hébergeant les répertoires personnels applique des quotas disque du noyau, auquel cas Pepsi consulte aussi
quotactl(2) et laisse la limite du noyau resserrer la limite effective. Facultatif ; vautnopar défaut.Normalement réglé pour vous. C’est un fait sur les montages de l’hôte, non une préférence : pepsi-setup(1) le sonde donc et consigne la réponse sans poser de question. Une valeur explicite n’est jamais écrasée. Activez-le là où cela s’applique : la comptabilité du noyau est la seule des trois couches que le titulaire du compte ne peut pas altérer (le fichier Maildir++
maildirsizeréside dans son propre répertoire), et elle compte tout ce qu’il possède sur ce système de fichiers plutôt que son seul courrier.- RECIPIENT_DELIMITER = CHARACTER |
none Le séparateur de sous-adresse valant pour tout le site (
alice+listsest le comptealice). Facultatif ; vaut+par défaut. Une section[stage-<name>]peut le redéfinir pour ses propres décisions de remise, mais préférez le régler ici. pepsi-ingress(1) emploie cette valeur pour déterminer quel quota de boîte s’applique à un destinataire, et il n’a aucune section d’étape à lire. Si une étape utilise un autre délimiteur, le courrier sous-adressé échappe donc au refus au moment duRCPT; pepsi-setup(1) avertit lorsqu’une étape le fait.Les listes de diffusion utilisent cette valeur, et elle seule, pour chaque sous-adresse qu’elles écrivent et lisent : l’expéditeur d’enveloppe VERP de chaque copie (
announce-bounces+alice=example.net=<code>@…), l’expéditeur d’une sonde de rebond, l’adresse-confirm+jeton, et le routeur de pepsi-stage-list(1) qui les reconnaît à leur retour.nonelaisse les listes sur+, puisqu’un expéditeur VERP ne peut pas s’écrire sans délimiteur.- MAX_QUEUE_ROWS = N |
none Contrôle d’admission de la file d’attente : le nombre maximal de messages (lignes de
pepsi.workqueue) que la file peut contenir avant que pepsi-ingress(1) cesse d’accepter du courrier. Facultatif ; vaut par défaut1000000;none(ou0) pour aucune limite. Une ligne correspond à un groupe de destinataires, la diffusion d’une liste de diffusion multiplie donc ce chiffre, de même qu’une étape de relais qui scinde un message en une ligne par destinataire.À la limite, pepsi-ingress(1) répond
452 4.3.1àRCPT, àDATA/au premier segmentBDAT, et après la fin des données. C’est un refus temporaire : le MTA expéditeur garde le message et réessaie, pendant que la file déjà présente se vide. pepsi-stage-list-post(1) retient une diffusion pendantQUEUE_THROTTLE_DELAYau lieu d’émettre son lot suivant. Rien de ce qui est déjà en file n’est affecté : les bounces, DSN et réponses automatiques que le pipeline émet lui-même ne sont jamais refusés.- MAX_QUEUE_BYTES = SIZE |
none Le nombre maximal d’octets que la file d’attente peut contenir : chaque bloc d’en-têtes en file plus chaque corps en file, chaque corps étant compté une seule fois quel que soit le nombre de lignes de destinataires qui le partagent (il est stocké une seule fois — voir DONNÉES STOCKÉES ci-dessous). Un nombre d’octets brut ou un suffixe
K/M/G/Tcomme pourMAILBOX_QUOTA. Facultatif ; vaut par défautnone. Après la fin des données, la vérification inclut la taille du message proposé, de sorte qu’un message trop volumineux est refusé pour ce qu’il est. Les refus sont les mêmes que pourMAX_QUEUE_ROWS.- MIN_FREE_SPACE = SIZE |
none L’espace libre qui doit rester sur le système de fichiers contenant
FREE_SPACE_PATHpour que le courrier soit accepté ; un message est refusé lorsque l’accepter en laisserait moins. Facultatif ; vaut par défaut1G;nonedésactive la sonde. Cette limite voit aussi ce qui n’est pas la file d’attente, comme le journal d’écriture anticipée, d’autres bases de données et les journaux. Cela compte, car PostgreSQL ne se dégrade pas lorsque son système de fichiers se remplit : il s’arrête, et chaque étape, la console et la socket de submission s’arrêtent avec lui. Les refus sont les mêmes que pourMAX_QUEUE_ROWS.- FREE_SPACE_PATH = PATH
L’endroit où MIN_FREE_SPACE est mesuré (
statvfs(3), l’espace disponible pour un écrivain non privilégié). Facultatif ; vaut par défaut/var/lib/postgresql, le parent des répertoires de données des clusters Debian – un répertoire de données lui-même est0700 postgres, maisstatvfsn’a besoin que d”atteindre un chemin, et son parent se trouve sur le même système de fichiers dans une disposition par défaut. Réglez-le sur le répertoire de données (ou son point de montage) lorsque PostgreSQL conserve ses données ailleurs. Lorsque la base de données est sur un autre hôte, le chemin par défaut n’existe généralement pas et la sonde est silencieusement désactivée ; un chemin défini ici qui ne peut pas être sondé est journalisé une fois, et la limite n’est alors pas appliquée.- QUEUE_CHECK_INTERVAL = DURATION
Durée pendant laquelle une mesure de la file d’attente est réutilisée. Facultatif ; vaut par défaut
10 s. Une mesure consiste en deux parcours séquentiels (la fonctionpepsi.queue_usage()), de sorte que chaque processus en effectue au plus une par intervalle et que chaqueRCPTentre-temps reçoit sa réponse à partir du chiffre en cache ; les limites sont donc approximatives, à hauteur des admissions d’un intervalle au plus. Lorsqu’une mesure échoue, Pepsi la journalise et admet le courrier : un bref problème de la base de données ne doit pas devenir une panne à part entière, et Pepsi répond toujours451lorsqu’il ne peut réellement pas stocker un message.- QUEUE_THROTTLE_DELAY = DURATION
Durée pendant laquelle pepsi-stage-list-post(1) retient une diffusion après avoir trouvé la file d’attente pleine, avant de regarder à nouveau. Facultatif ; vaut par défaut
60 s.- CT_CHECK =
warn|off Si les clients TLS vérifient la Certificate Transparency : les Signed Certificate Timestamps (SCT) incorporés dans un certificat de serveur qui se rattache aux racines du système. Cela couvre MTA-STS et la remise vérifiée au smarthost, le repli PKIX de l’étape DANE, et les récupérations WKD/VKS de la découverte de clés (y compris celles sous
[pepsi-keydiscovery] TLS_CA_BUNDLE). Un certificat réussit avec au moins deux SCT valides (trois s’il est valide plus de 180 jours) provenant de journaux de deux opérateurs différents. Facultatif ; par défautwarn.warnjournalise un avertissement pour un certificat qui ne réussit pas et se connecte malgré tout : un certificat qu’une CA a émis sans le journaliser apparaît dans le propre journal de Pepsi, mais la vérification ne peut pas arrêter le courrier. Il n’existe délibérément aucun mode qui refuse. Une connexion vérifiée par rapport àTLS_CAou auTLS_CA_BUNDLEd’un smarthost (la CA privée d’un opérateur, dont les certificats ne sont pas journalisés) n’est jamais vérifiée.offne vérifie rien.- CT_LOG_LIST = PATH
La liste des journaux Certificate Transparency par rapport auxquels les SCT sont vérifiés, au format JSON de la liste de journaux v3 de Google.
ct-logs updatede pepsi-keys(1), exécuté chaque jour parpepsi-keys-ct-logs.timer, la tient à jour. Le fichier est public et doit être lisible par chaque programme Pepsi. Sans lui, ou lorsque sonlog_list_timestampdate de plus de 70 jours, rien n’est vérifié (journalisé au niveau debug). Facultatif ; par défaut/var/lib/pepsi/ct-log-list.json.- CT_LOG_LIST_URL = URL
L’endroit d’où
pepsi-keys ct-logs updaterécupère la liste. Facultatif ; par défauthttps://www.gstatic.com/ct/log_list/v3/log_list.json. Un opérateur peut la faire pointer vers un miroir ; une liste plus ancienne que celle en place est refusée sauf si--forceest donné.- DNS_SERVERS = LIST
The resolvers for every program that makes DNS lookups and whose own section names none: the
DNS_SERVERSof pepsi-ingress(1), pepsi-stage-arc(1) and both relay stages, and the lookups that have no option of their own (DANE key discovery, pepsi-tlsrpt(1), pepsi-reputation(1)check, pepsi-setup(1), pepsi-status(1)). Optional; when unset,/etc/resolv.confis used.Les entrées sont séparées par des espaces ou des virgules, chacune étant l’une des formes suivantes :
une adresse IP (IPv4 ou IPv6) : DNS simple sur le port 53, en UDP puis en TCP lorsqu’une réponse est tronquée ;
tls://ADDRESS[:PORT]#NAME: DNS sur TLS (RFC 7858), port853par défaut ;https://ADDRESS[:PORT][/PATH]#NAME: DNS sur HTTPS (RFC 8484), unPOSTHTTP/2 vers PATH (par défaut/dns-query), port443par défaut.
Une ADDRESS IPv6 s’écrit entre crochets dans les deux formes d’URL (
tls://[2001:db8::53]#dns.example.net). L’adresse est obligatoire, de sorte qu’aucune recherche n’est nécessaire pour joindre le résolveur, et NAME l’est aussi : le certificat du résolveur doit être valide pour ce nom et se rattacher aux racines du système. Une liste contient soit des entrées simples, soit des entrées chiffrées, jamais les deux (un résolveur chiffré défaillant se rabattrait sinon sur le DNS simple), et il n’y a pas de repli sur le DNS simple lorsque les résolveurs chiffrés ne peuvent pas être joints : la recherche échoue comme échec temporaire. Une liste qui ne s’analyse pas fait refuser de démarrer aux étapes qui la lisent et échouer chaque recherche qui l’utiliserait.Une entrée chiffrée protège le chemin vers le résolveur, de sorte que Pepsi se fie au bit AD de DNSSEC d’un résolveur joint par elle, comme il le fait pour un résolveur sur le loopback (voir pepsi-stage-relay-to-internet(1), DANE). Le résolveur doit tout de même valider DNSSEC lui-même.
- DNS_TIMEOUT = DURATION
Le délai par requête DNS pour chaque programme dont la propre section ne définit pas de
DNS_TIMEOUT. Facultatif ; la valeur par défaut propre à chaque programme s’applique lorsqu’il n’est pas défini (5 spour la plupart). Comme leDNS_TIMEOUTd’une section, il ne borne une requête que là où les résolveurs proviennent d’une listeDNS_SERVERS; avec/etc/resolv.conf, c’est l”options timeout:du système qui s’applique.- MAIL_LOG =
off|summary|full Faut-il conserver une trace par message. Facultatif ; vaut
offpar défaut.Pepsi supprime la ligne d’un message lorsque le pipeline en a fini avec lui : il n’y a donc normalement aucun journal de succès par message. Un déploiement ordinaire n’accumule pas de trace de la correspondance de ses utilisateurs, et ne peut être contraint d’en produire une qu’il n’a pas.
Régler cette option change cela.
summaryécrit une lignepepsi.mail_logau moment où un message quitte le pipeline, portant l’expéditeur et les destinataires d’enveloppe, la direction (outboundpour le courrier soumis localement,inboundsinon), l’étape où il s’est arrêté, l’issue (completed/failed) et ce que le pipeline a décidé à son sujet (une liste fermée de clés destate: le verdict d’authentification, les décisions de spam et de paiement, tout détail d’échec au saut suivant, et les constats de cryptographie et de langue).fullconsigne en outre la ligneSubject:. Le contenu des messages n’est jamais enregistré, quel que soit le réglage.Avertissement
Activer ceci signifie que le déploiement conserve la trace de qui correspond avec qui. Certains déploiements ont réellement besoin de cette preuve ; assurez-vous que le vôtre en fait partie, et que la conserver est licite là où vous opérez.
Les lignes sont lisibles par
GET /api/v1/mail-logpour un principal détenantlogs:read, sont en ajout seul pour chaque composant traitant du courrier, et sont élaguées après[pepsi-admin] MAIL_LOG_RETENTION_DAYSjours. La ligne est écrite par la même instruction qui retire le message ou le marque comme échoué, de sorte qu’activer le journal ne coûte aucun aller-retour supplémentaire à la base. Voir le chapitre « L’API d’administration » du manuel.- ALLOW_FUSION =
yes|no Si la fusion d’étapes est permise. Une étape fusionne avec le successeur vers lequel elle avance lorsque ce successeur est marqué
FUSION = yes(voir l’option par étape ci-dessous), que sonPROGRAMest plié dans le même binairepepsiunifié et qu’il n’a besoin d’aucune colonne de message que le prédécesseur n’a pas déjà chargée. Le prédécesseur exécute alors le corps du successeur dans son propre processus worker. Cela évite à la fois l”UPDATEd’avancement et leSELECTde chargement du successeur, et le dispatcher reçoit une seule complétion pour toute la chaîne fusionnée. Facultatif ; par défautyes. Réglez-le surnopour forcer chaque transition d’étape à repasser par la base de données et le dispatcher (le benchmark qui mesure le coût de chaque étape fait cela, afin que chaque étape soit mesurée comme son propre worker dispatché). La fusion n’a jamais lieu dans un build par programme (multibin), où un successeur est toujours un processus séparé. Voir pepsi-dispatch(1) pour le modèle complet.- REFLECTION_HOLD_MAX
(durée, facultative) La plus longue retenue aléatoire du courrier réfléchi — un DSN écrit par pepsi-stage-bounce(1), une copie que renvoie un alias (pepsi-stage-aliases(1)) ou un
~/.forward(pepsi-stage-dot-forward(1)), la diffusion d’une liste de diffusion (pepsi-stage-list-post(1)). Chacun de ces messages est retenu, avant que l’étape suivante ne le voie, pendant une durée tirée à nouveau, uniformément, entre zéro et cette valeur : l’étape productrice le transmet à l’étatpausedavec cetimeoutau lieu depending, et le balayage de reprise des lignes en pause du dispatcher le libère. Si le courrier réfléchi partait après la latence propre et prévisible du pipeline, l’expéditeur de l’original pourrait le minuter de sorte que les réflexions de nombreux hôtes atteignent une seule victime en une seule impulsion. Étaler les réflexions de chaque hôte sur une fenêtre aléatoire aplatit cette impulsion. Par défaut30 s;0 sdésactive la retenue ; au plus10 m(unitéss/m). Les réponses automatiques (l’avis d’absence, une demande de paiement, un défi) ne sont pas retenues — elles sont limitées en débit par expéditeur à la place.- MTA_STS_MODE =
enforce|testing|none Mode de la politique MTA-STS publiée pour nos domaines.
enforceettestingamènent pepsi-setup(1) à émettre un enregistrement TXT_mta-sts.<domain>(et pepsi-httpd(1) à servir le fichier de politique correspondant) ;nonedésactive la publication MTA-STS. Facultatif ; vautenforcepar défaut. MTA_STS_MX fixe les hôtes que la politique autorise.- MTA_STS_MX = ENTRÉE[, ENTRÉE…]
Les hôtes publiés comme lignes
mx:de la politique MTA-STS, c’est-à-dire chaque MX auquel un expéditeur peut remettre (RFC 8461 §3.2 :mx« must appear at least once and may appear more than once »). Chaque ENTRÉE est soitHOSTun motif d’hôte s’appliquant à tous les domaines servis, soit
DOMAIN:HOSTun motif d’hôte s’appliquant à ce seul domaine servi.
L’ensemble
mxd’un domaine est constitué des entrées non qualifiées plus les entrées qualifiées par son propre nom ; les entrées qualifiées s’ajoutent à l’ensemble commun au lieu de le remplacer, si bien qu’un site dont les domaines partagent un MX principal l’écrit une fois et ne peut pas le perdre en qualifiant le MX de secours d’un domaine. Un motif d’hôte peut employer un joker sur le premier label seulement (*.example.net), et:est un séparateur sans ambiguïté puisqu’un nom d’hôte n’en contient pas.La politique est donc par domaine, ce dont un hôte servant plusieurs domaines a besoin : les enregistrements MX de chaque domaine nomment ses propres hôtes, et rien n’exige qu’ils concordent. La politique de chaque domaine reçoit son propre
iddans son propre enregistrement TXT_mta-sts.<domain>, les expéditeurs les mettent donc en cache indépendammentMTA_STS_MX = example.org:mx.example.org, example.net:mail.example.net
Optional. When the option is absent entirely, every domain’s policy names the
[pepsi-ingress] HOSTNAME. That fallback is a last resort, not a good default:HOSTNAMEis theEHLOgreeting name, which need not be a name that anyMXrecord points at. When it is not, anenforcepolicy tells every compliant sender not to deliver to the domain at all. So set this option to the hosts yourMXrecords actually name. The pepsi-setup(1) wizard reads them out of DNS and writes the option for you, and everypepsi-setup runre-checks the resolved set against liveMXrecords and prints the option to set when they disagree (see pepsi-setup(1), MTA-STS cross-checks).Sous le mode
enforcepar défaut, une politique qui omet un hôte dit à chaque expéditeur conforme qu’il ne doit pas y remettre : un MX de secours absent de cette liste ne reçoit donc aucun courrier pendant que le principal est en panne.Chaque hôte nommé doit en outre présenter un certificat TLS valide pour son propre nom (RFC 8461 §4.1), et pepsi-setup(1) le provisionne : les hôtes listés ici deviennent des Subject Alternative Names sur le certificat des écouteurs d’ingress, lequel est élargi via certbot à la prochaine exécution de
pepsi-setup runs’il ne les couvre pas encore. Pepsi utilise un seul certificat plutôt qu’un par hôte, parce que pepsi-ingress(1) sert un unique certificat par écouteur et ne sélectionne pas sur SNI. Une entrée à joker est l’exception : HTTP-01 ne peut pas en obtenir, ce certificat doit donc être fourni parTLS_CERT/TLS_KEY.- MTA_STS_MAX_AGE = SECONDS
Le
max_agepublié dans la politique MTA-STS (combien de temps les expéditeurs peuvent la mettre en cache). Facultatif ; par défaut604800(une semaine). Le §3.2 de la RFC 8461 le borne à1..``31557600``, et une valeur hors de cet intervalle est refusée – en particulier0, qui publierait une politique expirant immédiatement et désactiverait donc MTA-STS tout en donnant l’impression d’être configurée.- TEMPLATE_DIR = PATH
Répertoire contenant les modèles de message (
<name>.<lang>.body) développés à l’exécution — par exemple la réponse de demande de paiement de pepsi-stage-anti-spam(1) et le corpsBOUNCE_MESSAGEde pepsi-stage-bounce(1). Facultatif ; vaut par défaut${DATADIR}/templates, oùmake installplace les modèles fournis.${DATADIR}est résolu depuis le préfixe d’installation du binaire en cours d’exécution : le défaut est donc/usr/share/pepsi/templatespour une installation--prefix=/usret suit le préfixe pour tout autre ; ne réglez cette option que si les modèles résident là où le préfixe ne l’implique pas.- LOG_JSON =
yes|no Émettre les journaux sous forme de lignes JSON structurées (un objet JSON par enregistrement) sur l’erreur standard au lieu du format texte lisible par un humain par défaut, de sorte qu’un agrégateur de journaux tel que Loki puisse les ingérer sans analyse supplémentaire. S’applique à chaque binaire Pepsi sauf pepsi-setup(1), qui met en place la journalisation avant de charger une configuration. Facultatif ; par défaut
no(texte). L’option de niveau de log-L/--loget-v/--verboses’appliquent dans les deux formats.- LOG =
error|warn|info|debug|trace Niveau de log maximal par défaut pour chaque binaire Pepsi. Tous les composants chargent cette même configuration, y compris les workers d’étape que le dispatcher lance et qui ne reçoivent pas d’indicateur de journal propre en ligne de commande. Cette option est donc l’unique réglage qui abaisse ou relève la journalisation à travers tout le pipeline d’un coup ; les scripts de benchmark, par exemple, la règlent à
warnafin que la journalisation par message ne fausse pas leurs mesures. Facultatif ; par défautinfo. L’indicateur-L/--log, lorsqu’il est donné, le redéfinit pour ce seul processus. pepsi-setup(1) ignore cette option, puisqu’il met en place la journalisation avant de charger une configuration ; passez-y-L.- PUBLIC_RESOLVERS = IP … |
none Les résolveurs récursifs publics par lesquels pepsi-setup(1) revérifie, tels qu’Internet les voit, les enregistrements DNS dont dépend cet hôte : le DNS inverse de chaque
PUBLIC_IP, les enregistrementsMXet TXT de chaque domaine servi, et les adresses duHOSTNAMEd’ingress (voir Le DNS tel que l’Internet le voit dans pepsi-setup(1)). Une liste d’adresses IP séparées par des espaces ou des virgules. Facultatif ; par défaut Google (8.8.8.8,2001:4860:4860::8888), Cloudflare (1.1.1.1,2606:4700:4700::1111) et Quad9 (9.9.9.9,2620:fe::fe).nonedésactive la vérification.La vérification existe parce qu’une recherche depuis cet hôte ne peut pas savoir si une zone n’est joignable que depuis le réseau de cet hôte : un serveur de noms derrière un NAT dont le port 53 n’est pas redirigé semble sain vu de l’intérieur. Les noms que la vérification envoie à ces résolveurs sont des noms que cet hôte publie pour que n’importe qui les interroge ; réglez tout de même
nonesi vous préférez qu’aucun résolveur tiers ne soit interrogé, et vérifiez plutôt depuis une machine extérieure à votre réseau. Lu uniquement par pepsi-setup.- SHARE_TELEMETRY =
yes|no Si ce déploiement partage une télémétrie anonyme d’usage des fonctionnalités avec le projet Pepsi. Sur consentement explicite : facultatif, et vaut
nopar défaut, de sorte qu’une installation qui ne le règle jamais ne partage rien. Réglé suryes, pepsi-setup(1) engendre unSYSTEM_IDaléatoire (ci-dessous) et le daemon pepsi-telemetry-client(1) agrège les événements d’usage venus des workers d’étape et de pepsi-ingress(1) et soumet des comptes par fonctionnalité àTELEMETRY_SERVERsous cet identifiant anonyme (aucune adresse, donnée de message, nom d’hôte ou adresse IP). Laissé àno, un daemon en cours d’exécution reste en sommeil (aucune socket, rien de soumis), aucunSYSTEM_IDn’est engendré, et les appels de télémétrie en processus sont sans effet et n’ouvrent aucune socket. Une valeur inanalysable est lue commeno. Quiconque modifie cette option dans le fichier notifie le daemon (telemetry_changed) ; celui-ci relit aussi le fichier chaque minute. La console de configuration du navigateur ne peut l’activer que tant que le daemon tourne avec unSYSTEM_ID.- SYSTEM_ID = 64-HEX
Identifiant anonyme de 256 bits (64 caractères hexadécimaux) soumis avec chaque rapport de télémétrie. Engendré et écrit ici par pepsi-setup(1) seulement une fois
SHARE_TELEMETRYactivé, de sorte qu’un déploiement qui n’a pas donné son consentement n’en reçoit jamais. Requis par pepsi-telemetry-client(1). Un opérateur peut en ajouter un à la main tant que la télémétrie est désactivée, ce qui permet à la console du navigateur de proposer d’activer la télémétrie ; un enregistrement dans la console le conserve. Ne le réutilisez pas d’un déploiement à l’autre.- TELEMETRY_SERVER = HOST | URL
Le collecteur de télémétrie central. Facultatif ; par défaut
telemetry.pepsi.taler.net. pepsi-telemetry-client(1) soumet àhttps://<server>/telemetry/{usage,features}; une valeur contenant unscheme://explicite est honorée verbatim (par exemplehttp://localhost:18080pour des tests locaux).
Les options CRYPTO_* suivantes régissent la cryptographie de bout en bout des messages (OpenPGP et S/MIME) — non les clés DKIM/ARC ci-dessus. Ce sont délibérément des paramètres d”administrateur système et elles vivent dans [pepsi] plutôt que dans une section [stage-*], ce qui les place structurellement hors de portée de la couche de redéfinition par adresse (pepsi.settings ne redéfinit que les sections d’étape) et donc de pepsi-stage-edit-settings(1) : le choix des algorithmes, la permission de rétrograder, l’acceptation des condensats faibles et les tailles de clé minimales sont des décisions de sécurité à valeur par défaut sûre, non des préférences par utilisateur. Chacune est facultative ; un déploiement qui ne fait pas de cryptographie de bout en bout peut toutes les ignorer. Le magasin où vivent ces clés se configure dans [pepsi-crypto] (ci-dessous) et se gère avec pepsi-keys(1).
- CRYPTO_ALLOW_DOWNGRADE =
no|negotiate|yes Si Pepsi peut émettre un conteneur rétrogradé (
EnvelopedDataAES-256-CBC en S/MIME, SEIPDv1-avec-MDC en OpenPGP) et accepter le 3DES au déchiffrement. Facultatif ; par défautnegotiate, qui rétrograde par destinataire et seulement lorsque ce destinataire ne peut pas faire mieux. Cela compte, car une grande part du parc installé ne sait pas lire du tout un message AEAD de la RFC 9580. La lecture du SEIPDv1 et de l’AES-CBC est toujours permise et n’est pas conditionnée par cette option.Pour OpenPGP, le propre certificat du destinataire dit s’il lit SEIPDv2. Pour S/MIME, dont les certificats n’annoncent aucune capacité de chiffrement du contenu, la réponse est l”enregistrement de capacités S/MIME du destinataire : appris de l’attribut
SMIMECapabilitiesde la RFC 8551 du courrier signé du correspondant (par pepsi-stage-autocrypt-learn(1)), ou configuré avecpepsi-keys peer capability set ADDRESS aead|cbc. Sousnegotiate, seul un destinataire noté comme incapable de lire l”AuthEnvelopedDataAES-256-GCM reçoit de l”EnvelopedDataAES-256-CBC ; un destinataire sans enregistrement reçoit de l’AEAD. Thunderbird 140.12.0esr ne sait pas lireAuthEnvelopedDataet échoue silencieusement — aucune erreur, un texte en clair vide —, de sorte qu”un utilisateur de Thunderbird qui n’a jamais envoyé de message signé a besoin d’un enregistrement configuré.norefuse un destinataire noté comme incapable de lire l’AEAD (la politique de l’étape de chiffrement en l’absence de clé décide) ;yesenvoie de l”EnvelopedDataà chaque destinataire S/MIME quel que soit son enregistrement, pour un opérateur qui veut la rétrogradation globale. La mesure estpepsi-crypto/tests/thunderbird.rs; la matrice des clients figure dans le chapitre du manuel sur l’interopérabilité.yesne dégrossit pas OpenPGP : l’étape de chiffrement demande le conteneurauto, quenegotiatecommeyesrésolvent par destinataire — AEAD pour un certificat qui annonce SEIPDv2, SEIPDv1+MDC seulement pour un qui ne l’annonce pas. La différence entre les deux valeurs est le conteneur S/MIME et l’acceptation d’un message S/MIME 3DES entrant, qui n’est jamais émis sous aucun réglage. Le 3DES OpenPGP entrant est accepté sousnegotiatecomme sousyes, et refusé seulement sousno: un certificat OpenPGP énonce ses propres capacités de chiffrement, si bien quenegotiatea de quoi négocier, tandis que X.509 n’en annonce aucune et reçoit donc la règle la plus stricte. Le Blowfish OpenPGP entrant, l’autre chiffrement à blocs de 64 bits, suit exactement la règle du 3DES.pepsi-setupn’écrit pas cette option sauf si on le lui demande : la valeur par défaut par destinataire n’a besoin d’aucune ligne danspepsi.conf, de sorte qu’un réglage délibéré se fait en éditantpepsi.confà la main ou avecpepsi-setup --wizard --expert=CRYPTO_ALLOW_DOWNGRADE. Il avertit lorsque la valeur estyes.- CRYPTO_ALLOW_WEAK_DIGESTS =
yes|no Accepter les signatures SHA-1 à la vérification. Facultatif ; vaut
nopar défaut. Une signature sous un condensé faible est rapportée comme telle, jamais comptée silencieusement comme valide. Une signature ECDSA avec SHA-1 n’est vérifiée que sur P-256 ; sur P-384, elle est rapportée comme non prise en charge quelle que soit cette option. Une signature MD5 est refusée quelle que soit cette option : les collisions MD5 se calculent en quelques secondes, si bien qu’une telle signature ne dit rien de ce qui a été signé. pepsi-setup(1) avertit lorsqu’elle vautyes.- CRYPTO_MIN_RSA_BITS = BITS
Plus petit module RSA accepté à la vérification entrante et au chiffrement sortant. Pour S/MIME, il s’applique au certificat feuille et à chaque certificat intermédiaire de la chaîne, mais pas à une ancre de confiance configurée. Facultatif ; par défaut
2048. Les valeurs inférieures à1024sont refusées d’emblée. Lorsque le plancher est abaissé, une clé comprise entre lui et 2047 bits est acceptée pour vérifier une signature, avec un avertissement journalisé, et pepsi-setup(1) avertit au sujet du plancher abaissé lui-même. On ne peut toujours pas chiffrer vers une telle clé, ni signer ou déchiffrer avec elle, puisqu’AWS-LC, qui effectue chaque opération RSA, exige pour cela de 2048 à 8192 bits ; et une signature SHA-384 produite par elle est rapportée comme non prise en charge, puisqu’AWS-LC ne vérifie les clés de moins de 2048 bits qu’avec SHA-1, SHA-256 et SHA-512. Quel que soit le plancher, une clé RSA dont la clé privée se déduit de son module (l’empreinte ROCA, ou des nombres premiers assez proches pour la méthode de Fermat) est refusée comme une clé inférieure au plancher, de même qu’une clé de n’importe quel type figurant sur la liste des clés connues comme compromises (pepsi.compromised_key, voir[pepsi-keydiscovery] BADKEYS_URL).- CRYPTO_GENERATE_RSA_BITS =
2048|3072|4096|8192 Taille de module employée lorsque ce déploiement engendre une clé RSA. Facultatif ; vaut
2048par défaut. Ce sont les quatre tailles qu’AWS-LC génère, en temps constant ; toute autre valeur est refusée à la lecture de la configuration (parpepsi-setup,pepsi-keyset les étapes cryptographiques), car une clé d’une autre taille devrait provenir d’un générateur de clés qui n’est pas en temps constant. Elle ne peut être inférieure àCRYPTO_MIN_RSA_BITS, car un déploiement ne doit pas engendrer des clés qu’il refuse ensuite d’accepter. La génération de clés OpenPGP n’accepte que2048,3072ou4096. Chaque utilisation ultérieure de la clé privée (signature, déchiffrement) relève aussi d’AWS-LC.- CRYPTO_INLINE_PGP =
accept|reject Comment traiter le PGP en ligne (non MIME). Facultatif ; vaut
acceptpar défaut, car de vrais expéditeurs en émettent encore. Pepsi n’en engendre jamais.- CRYPTO_OPENPGP_ALGORITHM =
ed25519|rsa Algorithme employé lors de la génération d’une nouvelle identité OpenPGP. Facultatif ; vaut
ed25519par défaut — la génération est instantanée, ce qui compte car une identité peut devoir être créée pendant qu’un message attend.rsaemploieCRYPTO_GENERATE_RSA_BITS.- CRYPTO_SMIME_ALGORITHM =
p256|p384|rsa Algorithme employé lors de la génération d’une nouvelle identité S/MIME. Facultatif ; vaut
p256par défaut, ECDSA/ECDH sur NIST P-256 ;p384est la même chose sur P-384, etrsaest RSA àCRYPTO_GENERATE_RSA_BITS.Le choix décide de la façon dont le S/MIME entrant atteint notre clé privée, c’est pourquoi la valeur par défaut est une courbe. Le courrier destiné à une identité EC arrive sous forme d’accord de clé ECDH (
KeyAgreeRecipientInfo) et n’atteint jamais une opération de clé privée RSA sur un texte chiffré choisi par l’expéditeur ; l’accord de clé, les signatures ECDSA et la génération de clés relèvent d’AWS-LC, en temps constant, et générer l’identité prend quelques millisecondes. Le courrier destiné à une identité RSA arrive sous forme de transport de clé RSA (PKCS#1 v1.5 ou OAEP, au choix de l’expéditeur), que pepsi-stage-decrypt déballe avec le RSA en temps constant et masqué d’AWS-LC, avec le rejet implicite de la RFC 8017 et une durée minimale aléatoire ; il reste un branchement sur le verdict de décodage PKCS#1 v1.5 ou OAEP d’AWS-LC, que son interface ne permet pas d’éviter. AWS-LC accepte les clés RSA de 2048 à 8192 bits. Une identité RSA hors de cette plage ne peut ni déchiffrer ni signer, et est refusée avec un avertissement ; Pepsi n’en génère aucune, il s’agit donc en pratique d’une clé importée de moins de 2048 bits sous unCRYPTO_MIN_RSA_BITSabaissé. Les signatures RSA, ainsi que les autosignatures des certificats et des demandes que génère Pepsi, relèvent aussi d’AWS-LC.Choisissez
rsapour un site dont les clients des correspondants ne peuvent pas chiffrer vers un certificat à courbe elliptique, ou lorsque vous voulezCRYPTO_SMIME_SHARED_KEY = yes, qui n’existe qu’en RSA. Les mesures montrent qu’OpenSSL 3.5 sait chiffrer vers un tel certificat ; Thunderbird 140 n’a été mesuré qu’en lecture de texte chiffré ECDH, et Outlook et Apple Mail n’ont pas été mesurés du tout (voir le chapitre du manuel sur l’interopérabilité). L’option ne façonne que les identités nouvellement générées : une identité RSA existante, générée ou importée, continue de signer et de déchiffrer, puisque chaque recherche se résout par capacité plutôt que par algorithme, et les autres réserves sur RSA ci-dessus continuent de s’y appliquer jusqu’à ce qu’une nouvelle identité la remplace (identity generatede pepsi-keys(1) rend le nouveau matériel primaire).- CRYPTO_SMIME_SHARED_KEY =
yes|no Délivrer un seul certificat S/MIME portant à la fois
digitalSignatureetkeyEnciphermentau lieu d’un certificat de signature et d’un certificat de chiffrement distincts. Facultatif ; vautnopar défaut.Le défaut les sépare parce qu’un certificat de signature séparé peut être détruit à l’expiration ou à la révocation — rien de légitime ne resigne jamais du vieux courrier, une clé de signature retirée n’est donc qu’un risque de falsification — tandis que la moitié de déchiffrement est conservée afin que le texte chiffré archivé et en vol reste lisible. Activer ceci divise par deux le nombre de certificats qu’un opérateur achète par identité, et abandonne cette séparation : une clé partagée suit la règle du déchiffrement, de sorte que révoquer une clé de signature compromise mette aussi fin à la capacité de recevoir du nouveau courrier chiffré sur ce certificat.
L’option ne décide que de l’allure des identités nouvellement créées. Les deux formes sont prises en charge de façon permanente et peuvent coexister pour une même adresse, de sorte que chaque consultation se résolve par capacité plutôt que par forme. Combinée à un
CRYPTO_SMIME_ALGORITHMà courbes elliptiques, elle est refusée par pepsi-setup(1) : utiliser une seule clé EC à la fois pour ECDSA et ECDH est une réutilisation de clé entre algorithmes, que plusieurs clients S/MIME rejettent.
95.2.1.1.6. La section [pepsi-postgres]¶
Paramètres de connexion à la base de données partagés. Chaque composant Pepsi se connecte à la même base de données et au schéma pepsi partagé, de sorte que ces paramètres résident dans une seule section plutôt que d’être répétés par composant.
Note
Budget de connexions. Chaque processus Pepsi ouvre son propre pool de connexions. Les workers d’étape et les CLI d’opérateur font leur travail de base de données strictement en série, chacun d’eux utilise donc une seule connexion. Le dispatcher exécute jusqu’à un processus worker par créneau d’étape (la somme des PARALLELISM des étapes), de sorte que cette règle d’une connexion par worker garde l’essentiel du nombre de connexions prévisible et minimal. Les composants concurrents gardent un petit pool borné dimensionné par leur propre option DB_POOL_SIZE : le coordinateur pepsi-dispatch(1) (par défaut 8, car il traite en parallèle les résultats de nombreux workers) et les serveurs pepsi-ingress(1) et pepsi-httpd(1) (par défaut 1 chacun). Lors du réglage, assurez-vous que Σ PARALLELISM (une connexion par worker en vie) + le pool du dispatcher + les pools des deux serveurs reste en dessous du max_connections du serveur. Le QUEUE_LIMIT d’une étape n’entre pas dans ce budget : pipeliner plus de messages sur un worker augmente son nombre en vol, pas le nombre de processus workers (ou de connexions), c’est donc le réglage qu’on peut augmenter sans risque pour le débit lorsque max_connections est le facteur limitant.
- CONFIG
(chaîne, obligatoire) Chaîne de connexion ou URI PostgreSQL, par exemple
postgres:///pepsi. Le serveur règle le chemin de recherche de schéma surpepsiet utilise des transactionsREAD COMMITTED(au plus un écrivain touche jamais une ligne de file donnée, de sorte que l’isolation sérialisable est inutile).Ce fichier est lisible par tous, la chaîne ne doit donc porter aucun mot de passe ; chaque composant refuse de démarrer s’il en trouve un.
Base de données locale (la configuration canonique). Chaque composant se connecte par la socket UNIX sous le rôle qui porte le nom de son propre compte système (
pepsi,pepsi-ingress,pepsi-httpd,pepsi-crypto, …) et l’authentification peer de PostgreSQL vérifie l’uid. Aucun mot de passe n’existe nulle part, et les droits de chaque rôle dans la base de données constituent la frontière de privilèges entre les composants.Base de données distante (configuration recommandée). Gardez le même modèle : un rôle par compte, chacun avec ses propres identifiants qu’aucun autre compte ne peut lire. Lorsqu’un composant se connecte, le paramètre fictif
{role}de la chaîne de connexion est remplacé par le rôle sous lequel il se connecte, de sorte qu’une seule chaîne désigne un fichier différent pour chaque rôle. Avec des certificats clients (lepg_hba.confde la base de données utilisantcert)CONFIG = postgres://db.example.org/pepsi?sslmode=verify-full&sslcert=/etc/pepsi/postgres/{role}.crt&sslkey=/etc/pepsi/postgres/{role}.keyou avec des mots de passe, un fichier de mots de passe libpq (format
.pgpass, par exemple l’unique ligne*:*:*:*:<password>) par rôleCONFIG = postgres://db.example.org/pepsi?sslmode=verify-full&passfile=/etc/pepsi/postgres/{role}.pgpasssslmode=verify-fullvérifie le certificat du serveur par rapport au magasin de racines du système, comme toute autre connexion TLS de Pepsi (SSL_CERT_FILEetSSL_CERT_DIRremplacent le magasin), si bien qu’un certificat d’une AC locale se vérifie dès que cette AC y est installée (sous Debian : un fichier dans/usr/local/share/ca-certificatesetupdate-ca-certificates). Contrairement à libpq,sslrootcert=FICHIERajoute les certificats d’AC deFICHIERau magasin du système au lieu de le remplacer.Chaque fichier de clé ou de mot de passe appartient au compte de son rôle et a le mode
0600ou0400; un fichier de mots de passe que quelqu’un d’autre peut lire est refusé, comme libpq le refuse, et pepsi-setup run signale chaque rôle dont le compte existe sur l’hôte mais dont le fichier est absent, appartient à un autre compte ou est ouvert à d’autres. Omettez le nom d’utilisateur de la chaîne (ou écrivez-y{role}) : chaque composant fournit le sien. Comme le fichier est lu à l’ouverture de la connexion, par le compte qui l’ouvre, une étape setuid telle que pepsi-stage-encrypt lit le fichier depepsi-crypto, que le dispatcher qui l’a lancée ne peut pas lire. La chaîne elle-même ne contient alors aucun secret et reste dans ce fichier.Surcharge par l’environnement. La variable d’environnement
PEPSI_POSTGRES_CONFIG, lorsqu’elle est définie et non vide, remplace cette option et peut porter un mot de passe. Chaque unité systemd livrée la lit depuisEnvironmentFile=-/etc/pepsi/postgres.env(le-initial rend le fichier facultatif ; gardez-le propriété de root en0600, puisque systemd le lit en tant que root avant de démarrer le service). Les programmes setuid et setgid ne conservent la variable que lorsque root ou le compte dispatcherpepsiles a lancés, de sorte que les étapes atteignent la base de données du dispatcher tandis qu’un utilisateur ordinaire ne peut pas diriger un programme privilégié vers une autre. Un mot de passe qui s’y trouve est un seul mot de passe pour tous les rôles, ce qui abandonne la séparation entre les composants ; préférez les fichiers par rôle ci-dessus et utilisez la variable pour ce qui diffère d’un hôte à l’autre. Lorsqu’elle est définie,CONFIGpeut être omis ; un mot de passe dansCONFIGest refusé même dans ce cas. Un outil lancé depuis un shell (pepsi-setup run, pepsi-queue, …) a besoin de la variable exportée de la même manière, par exempleset -a; . /etc/pepsi/postgres.env; set +a.- SQL_DIR
(chemin, facultatif) Répertoire contenant les fichiers de migration SQL. Seul pepsi-setup(1) le lit, lors de l’installation du schéma ; les composants de service l’ignorent. Par défaut
${DATADIR}/sql(c.-à-d.<install-prefix>/share/pepsi/sql, oùmake installplace les fichiers). Redéfinissez-le lors d’une exécution depuis un checkout des sources.- WORKER_SYNCHRONOUS_COMMIT
(booléen, facultatif) Si la connexion de base de données d’un worker d’étape garde le
synchronous_commitde PostgreSQL activé. Vautnopar défaut.Désactivé, le
COMMITd’un worker revient avant que l’enregistrement du journal d’écriture anticipée n’ait atteint un stockage stable, ce qui permet aux écritures du pipeline de valider en groupe au lieu que chacune paie sa propre purge. Rien d’autre ne change : l’isolation, l’atomicité et la visibilité sont intactes, et un plantage ne peut jamais exposer une transaction partielle. Ce qui peut être perdu, ce sont les dernières centaines de millisecondes de durabilité — et uniquement pour les transitions d’étape, jamais pour l’admission des messages, car pepsi-ingress(1) valide toujours de façon synchrone. Un250signifie toujours que le message est sur disque.Si un plantage machine fait perdre un avancement d’étape, le message est retrouvé encore à l’étape précédente et la traverse une seconde fois. C’est exactement ce qui arrive lorsqu’un worker est tué après avoir fait son travail mais avant d’avoir validé. Réglez ceci sur
yessi une étape de votre pipeline a des effets de bord qui ne doivent pas être répétés même à travers une coupure de courant, et acceptez le coût en débit.
95.2.1.1.7. La section [pepsi-dkim]¶
Options de pepsi-dkim(1), le démon de signature qui détient les clés privées DKIM et ARC, en assure la rotation et rapporte leurs enregistrements DNS. Sa page de manuel décrit chaque option en détail ; voici les noms et les valeurs par défaut. La section est lue par le démon, par pepsi-setup(1) (validate, run, check), par les étapes de signature (SOCKET seulement) et par pepsi-status(1) et pepsi-httpd(1) (PUBLIC_DIR seulement).
- SOCKET = PATH
La socket de signature. Par défaut
/run/pepsi-dkim/sign.sock.- STATE_DIR = PATH
Les clés privées et l’état privé du démon (mode
0700, propriétairepepsi-dkim). Par défaut/var/lib/pepsi-dkim. Non sauvegardé : après une restauration, le démon crée de nouvelles clés.- PUBLIC_DIR = PATH
Le document d’état lisible par tous
status.jsonet, avecPUBLISH_RETIRED_KEYS, les clés retirées publiées. Par défaut/var/lib/pepsi-dkim-public.- RSA_BITS =
2048|3072|4096 Taille de module de chaque nouvelle clé RSA. Par défaut
2048.- ROTATION_DAYS = DAYS
Durée pendant laquelle une génération de clés signe avant que la suivante ne prenne le relais. Par défaut
0: pas de rotation automatique (pepsi-dkim rotateeffectue toujours une rotation à la demande).- ROTATION_LEAD_DAYS = DAYS
Combien de temps avant la bascule la génération suivante est créée, afin que ses enregistrements puissent être publiés. Par défaut
28; doit être plus court queROTATION_DAYS.- RETIRE_AFTER_DAYS = DAYS
Durée pendant laquelle l’enregistrement d’une clé remplacée doit rester dans le DNS avant que la clé ne soit retirée. Par défaut
14; au moins1, et doit dépasser leSIGNATURE_EXPIRATION_DAYSde chaque étape pepsi-stage-dkim-sign(1) et pepsi-stage-arc(1).- WAIT_FOR_DNS =
yes|no Si une bascule planifiée ou demandée attend que chaque serveur faisant autorité de la zone serve les enregistrements de la génération suivante. Par défaut
yes.- DNS_CHECK_INTERVAL = DURATION
Fréquence à laquelle chaque enregistrement est recherché auprès des serveurs faisant autorité. Par défaut
1 h; au moins une minute.- DNS_UPDATE =
none|rfc2136 Si le démon publie et retire lui-même ses enregistrements, par UPDATE RFC 2136 signé avec TSIG. Par défaut
none: l’opérateur les publie.- DNS_UPDATE_SERVER = HOST
Destination des mises à jour. Par défaut : le
MNAMEde l’enregistrement SOA de la zone.- DNS_UPDATE_TTL = SECONDS
TTL des enregistrements qu’ajoute le démon. Par défaut
3600.- TSIG_KEY_NAME = NAME
Nom de la clé TSIG. Obligatoire avec
DNS_UPDATE = rfc2136.- TSIG_ALGORITHM =
hmac-sha256|hmac-sha384|hmac-sha512 Par défaut
hmac-sha256.- TSIG_SECRET = BASE64
La clé TSIG. Obligatoire avec
DNS_UPDATE = rfc2136. Un secret : pepsi-setup(1) la conserve danssecrets.d/pepsi-dkim.secret, lisible par le seul comptepepsi-dkim.- PUBLISH_RETIRED_KEYS =
yes|no Publier une clé privée retirée sous
/.well-known/pepsi-dkim-retired/<domain>/<selector>.pemau lieu de la supprimer, une fois que le DNS ne sert plus ses enregistrements, afin que les anciennes signatures perdent leur valeur de preuve. Par défautno; n’a de sens qu’avec la rotation.- NOTIFY =
yes|no Écrire au postmaster, au plus une fois par jour par changement en attente, lorsqu’un enregistrement doit être ajouté ou retiré, qu’une rotation attend le DNS, ou que le serveur DNS a refusé une mise à jour. Par défaut
yes.- NOTIFY_ADDRESS = ADDRESS
Destinataire de ces avis. Par défaut
postmaster@le premier domaine servi.
95.2.1.1.8. La section [pepsi-srs]¶
Les paramètres du Sender Rewriting Scheme, partagés par pepsi-stage-srs(1) (la réécriture directe) et pepsi-ingress(1) (le décodage inverse au moment du RCPT), de sorte que le secret et le domaine correspondent dans les deux sens. Omettre la section désactive SRS : l’étape refuse de s’exécuter et l’ingress traite les destinataires d’apparence SRS comme des adresses ordinaires.
- SRS_DOMAIN
(chaîne, requise pour activer SRS) Le domaine des expéditeurs d’enveloppe réécrits. Ce doit être un domaine que vous contrôlez : son MX doit pointer vers l’ingress Pepsi (pour que les rebonds reviennent) et son SPF doit autoriser les IP d’envoi de Pepsi. pepsi-setup(1) provisionne les clés et le DNS pour lui. Il ne peut pas provisionner le MX, puisque c’est vous qui décidez où le courrier d’un domaine est routé ; il vérifie donc le MX à la place : avec une étape exécutant pepsi-stage-srs(1), un
SRS_DOMAINsans MX et sans enregistrement d’adresse est signalé à chaque exécution. Une adresse SRS est un chemin de retour, et un domaine qui ne peut pas recevoir de courrier perd chaque rebond du courrier que cet hôte réexpédie.Ce doit être un domaine dédié qui n’est aligné DMARC sur aucun domaine que sert cet hôte : ni une entrée de
ACCEPTED_DOMAINSou une autre identité d’envoi, ni un sous-domaine ou un parent de l’une d’elles, ni un nom partageant ses deux derniers labels avec l’une d’elles (Pepsi n’a pas de liste des suffixes publics, de sorte qu’il penche vers le fait de déclarer deux domaines alignés). Le courrier réexpédié part avec son expéditeur d’enveloppe réécrit dans ce domaine depuis les propres adresses de Pepsi, de sorte que SPF réussit pour lui au saut suivant. Si le domaine SRS était aligné sur un domaine servi, un message falsifié comme venant de ce domaine, reçu de l’extérieur et réexpédié, réussirait DMARC au saut suivant sur la seule base de SPF. Avec un domaine dédié, SPF réussit toujours, mais DMARC repose sur la propre signature DKIM de l’auteur. pepsi-setup(1) refuse unSRS_DOMAINaligné sauf si ALLOW_ALIGNED_DOMAIN est défini. Pour ce domaine, publiez un enregistrementMXpointant vers cet hôte et l’enregistrement SPF qu’affiche pepsi-setup(1) ; comme personne n’envoie de courrier depuis ce domaine, un enregistrement DMARC avecp=rejectest également approprié. pepsi-ingress(1) décode une partie locale SRS dans ce domaine, qu’il s’agisse ou non d’un domaine accepté.- ALLOW_ALIGNED_DOMAIN
(booléen, par défaut no) Accepter un
SRS_DOMAINaligné DMARC sur un domaine servi, avec un avertissement au lieu d’une erreur. Seulement pour un hôte qui ne peut pas avoir de domaine dédié : les falsifications réexpédiées du domaine servi aligné réussissent alors DMARC au saut suivant. Publierp=quarantineoup=rejectpour le domaine servi avec[pepsi-ingress] DMARC_ENFORCE = yesrefuse plutôt de telles falsifications à l’ingress ; pour un domaine SRS qui est un sous-domaine (ou tout nom autre que le domaine servi lui-même),aspf=sdans l’enregistrement DMARC du domaine servi empêche l’enveloppe SRS de s’aligner. L’avertissement nomme les deux, etpepsi-setup checkrapporte l’enregistrement DMARC du domaine servi comme un[MISMATCH]SRS alignmentjusqu’à ce que l’un d’eux soit en place.- SECRET_FILE / SECRET
(requis lorsque SRS_DOMAIN est défini) Le secret clé du HMAC qui signe les adresses SRS, donné comme un chemin de fichier (préféré ; stockez-le en mode 0600) ou en ligne. Les clés qui scellent les adresses de retour de réexpédition des copies réexpédiées (pepsi-stage-srs(1)) en sont dérivées sous des étiquettes propres. Il doit rester stable dans le temps, car un rebond renvoyé des jours plus tard doit encore se vérifier, et il doit être identique sur toutes les instances. Pour le remplacer, déplacez l’ancien secret vers PREVIOUS_SECRET_FILE (voir « Rotation de la clé SRS » dans le chapitre du manuel sur l’exploitation).
- PREVIOUS_SECRET_FILE
(path list, optional) One file, or several separated by whitespace, each holding a retired SRS secret. These secrets are verify only: a returning address whose signature matches one of them is accepted, nothing new is signed with them, and
MAX_AGE_DAYSstill bounds every address. A missing or empty file is an error; a file holding the current secret is ignored with a warning. Each file gets the ownership and mode of the current secret’s fragment (pepsi-ingress,0640) frompepsi-setup run, and pepsi-setup(1) warns when one was last changed more thanMAX_AGE_DAYSago: every address that it signed has expired, so it verifies nothing and can be removed.- MAX_AGE_DAYS
(entier, facultatif) Combien de jours une adresse réécrite reste valide pour les rebonds de retour (les horodatages SRS sont à granularité journalière), et pendant combien de jours pepsi-ingress(1) répond à un rapport envoyé à une adresse de retour de réexpédition. Par défaut 21, ce qui couvre les nouvelles tentatives d’un hôte distant (typiquement cinq jours) en plus du propre
MAX_LIFETIMEde cet hôte. Borné à1..``1021`` : le compteur de jours boucle après 1024 jours, si bien qu’une fenêtre égale ou supérieure ferait vérifier tous les horodatages et désactiverait complètement l’expiration.
La signature d’une adresse réécrite fait 8 caractères base32 — 40 bits — et aucune plus courte n’est jamais acceptée. Une signature falsifiée causerait de vrais dégâts : pepsi-ingress(1) traite un destinataire SRS vérifié comme une autorisation de relayer vers l’adresse décodée même lorsque son domaine n’est pas servi par ce déploiement, de sorte qu’un jeton falsifié fait de cet hôte un relais ouvert et une source de backscatter arbitraire en son nom. Il n’y a pas d’option pour accepter une signature plus étroite : elle laisserait le déploiement aussi solide que le seul MAC le plus étroit tant qu’elle serait réglée. Le plafond par connexion sur les destinataires SRS en échec (pepsi-ingress(1) coupe une connexion avec un 421 après trois) borne séparément la recherche en ligne ; aucune des deux bornes ne remplace l’autre.
95.2.1.1.9. La section [pepsi-origin]¶
Proof-of-origin keying, shared by both relay stages
(pepsi-stage-relay-to-internet(1) and pepsi-stage-relay-to-smarthost(1), which stamp the Pepsi-Origin header on outbound mail and record its
nonce) and pepsi-stage-anti-spam(1) (which verifies the header on a
returning bounce). The feature is on by default: when no secret is
configured, pepsi-setup(1) generates a random one on first run (provided
[pepsi-ingress] HOSTNAME is set). The secret is not stored inline in
this world-readable file; it is written to a secrets.d/pepsi-origin.secret
fragment beside the configuration (owned by the pepsi dispatcher account,
mode 0640) and pulled into this section with an @inline-secret@
directive. Re-running setup reuses the existing fragment rather than rotating
the key. ENABLED = no disables the feature — outbound mail is unstamped
and every bounce is then unverifiable (routed by the stage’s
BOUNCE_TARGET_STAGE, else forwarded). Removing the section does not: the
next pepsi-setup(1) run would provision a new secret.
- ENABLED
(booléen, facultatif)
YESpar défaut.NOdésactive la preuve d’origine pour chaque composant qui lit cette section, quel que soit le secret configuré, et empêche pepsi-setup(1) d’en générer un. Un fragment de secret existant est laissé en place, de sorte que la réactiver reprend avec la même clé.
L’en-tête porte la version, notre HOSTNAME (l’option [pepsi-ingress]), le compte expéditeur d’origine, un nonce de 128 bits et un horodatage, plus un HMAC-SHA256 sur l’ensemble. Chaque nonce estampillé est enregistré dans pepsi.origin_nonce pendant deux semaines ; un rebond n’est approuvé que si le MAC de son en-tête intégré se vérifie et que son nonce est encore suivi. Voir pepsi-stage-anti-spam(1).
- SECRET_FILE / SECRET
Le secret clé du HMAC, donné comme un chemin de fichier (préféré ; stockez-le en mode 0600) ou en ligne. Comme le secret SRS, il doit rester stable dans le temps, car un rebond renvoyé des jours plus tard doit encore se vérifier, et il doit être identique sur toutes les instances. Lorsqu’aucun n’est réglé, pepsi-setup(1) provisionne un
SECRETaléatoire dans un fragmentsecrets.d/pepsi-origin.secretréférencé par@inline-secret@(voir ci-dessus), le gardant hors de la configuration principale lisible par tous. La fonctionnalité nécessite[pepsi-ingress] HOSTNAME(intégré au MAC).
95.2.1.1.10. La section [pepsi-crypto]¶
Garde et cycle de vie du magasin de clés de bout en bout — les tables pepsi.crypto_identity, pepsi.peer_key et pepsi.ca_trust gérées par pepsi-keys(1). Comme les options CRYPTO_* de [pepsi] ci-dessus, ceci est réservé à l’administrateur, mais il s’agit de stockage plutôt que de force cryptographique. Omettez la section entière si le déploiement ne fait pas de cryptographie de bout en bout ; dès qu’elle dit quoi que ce soit, pepsi-setup(1) insiste sur un KEY_WRAP_SECRET utilisable, car un magasin de clés incapable de stocker des clés est une erreur de configuration plutôt qu’un choix.
Le matériel de clé privée est conservé dans la base, scellé en AES-256-GCM sous une clé de chiffrement de clés (KEK) dérivée de KEY_WRAP_SECRET. La base seule ne livre donc jamais de clé privée : un vidage, un réplicat ou une bande de sauvegarde produit du texte chiffré, et la clé qui l’ouvre est un artefact distinct gardé par les permissions de fichier. L’autre moitié de la frontière est un droit de base — crypto_identity.private_wrapped n’est accordé qu’au seul rôle pepsi-crypto ; voir pepsi-setup(1).
- KEY_WRAP_SECRET
(chaîne, requise dès que la section existe) La clé de chiffrement de clés qui enveloppe le matériel de clé privée au repos. Gardez-la hors de ce fichier lisible par tous : placez-la dans un fragment
secrets.d/pepsi-crypto.secretet référencez-la par une directive@inline-secret@, exactement comme sont traités les secrets SRS et de preuve d’origine. Chaquerunde pepsi-setup(1) réaffirme le mode0640sur ce fragment et le remet au comptepepsi-crypto. Un secret de moins de 16 caractères est refusé.Sauvegardez-la séparément de la base. Si elle est perdue, chaque clé privée stockée est perdue : les boîtes aux lettres contiennent du texte clair, si bien que le courrier de personne ne devient illisible, mais le texte chiffré en vol et archivé est perdu, chaque identité publiée est invalidée et l’organisation doit changer de clés.
- KEY_WRAP_KEY_ID
(chaîne, facultative) Identifiant de la clé de chiffrement de clés sous laquelle le nouveau matériel est enveloppé.
k1par défaut. Doit être une suite non vide de lettres ASCII, de chiffres et de tirets bas, car il fait partie du nom d’optionKEY_WRAP_SECRET_<ID>, d’où est lue une clé retirée. Chaque ligne consigne l’identifiant de la clé qui l’a scellée, de sorte qu’un renouvellement peut avancer ligne par ligne au lieu de se faire d’un seul coup.- KEY_WRAP_SECRET_<ID>
(chaîne, facultative) Une clé de chiffrement de clés retirée, conservée jusqu’à ce que chaque ligne enveloppée sous elle ait été renouvelée.
<ID>est lewrap_key_idqu’elle nomme, en majuscules (doncKEY_WRAP_SECRET_K0pour la clék0). Entre l’introduction d’une nouvelle clé et l’exécution depepsi-keys wrap rotate, le déploiement continue de fonctionner : le nouveau matériel est scellé sous la nouvelle clé tandis que l’ancien s’ouvre toujours sous celle-ci. Retirez-la une fois que le renouvellement rapporte que tout a été réenveloppé.- AUTO_CREATE_IDENTITY
(booléen, facultatif) Si une identité peut être générée automatiquement pour une adresse servie.
YESpar défaut. pepsi-stage-encrypt(1) agit en conséquence, et uniquement pour une adresse d’un domaine de[pepsi-ingress] ACCEPTED_DOMAINSqui n’a encore aucune lignecrypto_identityd’aucune sorte (une clé révoquée ou la propre clé enregistrée de l’utilisateur compte), selonCRYPTO_OPENPGP_ALGORITHM/CRYPTO_SMIME_ALGORITHMetIDENTITY_VALIDITY_DAYS. Le moment où elle prend effet dépend de l’optionENABLE_PEPde cette étape :ENABLE_PEP = yes(par défaut) : de manière anticipée, au premier message soumis localement par l’expéditeur, qu’il ait ou non demandé une protection. Chaque expéditeur d’un domaine servi finit donc par avoir une clé privée enveloppée sur ce serveur, et le WKD du déploiement en sert la moitié publique.ENABLE_PEP = no: de manière paresseuse, la première fois qu’un expéditeur local demande explicitement une protection (signer ou seulement chiffrer), ou à chaque message sousSIGN = alwaysde cette étape ; jamais du seul fait qu’une adresse est apparue dans une enveloppe, de sorte qu’un utilisateur qui n’utilise jamais la fonctionnalité n’a jamais de matériel de clé.
Cette option est le veto de l’opérateur sur les deux : elle réside dans une section réservée à l’administrateur, de sorte qu’aucune redéfinition
pepsi.settingspar adresse ne peut réactiver la création automatique. Lorsqu’elle est désactivée, chaque identité est créée sur demande – par pepsi-keys(1), la console web ou la commandegeneratepar e-mail.Comme le déclencheur est sur le chemin sortant, une adresse qui ne fait que recevoir reste sans clé et n’est jamais publiée — les tiers n’ont donc rien pour chiffrer vers elle. Provisionnez ces adresses à l’avance avec
pepsi-keys identity generate.- IDENTITY_VALIDITY_DAYS
(nombre, facultatif) Durée de vie d’une identité engendrée, en jours.
730par défaut (deux ans) ; doit être positive. Un nombre entier de jours plutôt qu’uneduration, car l’analyseur rejette les unités calendaires (voir l’avertissement en tête de cette page).pepsi-keys identity generate --daysla redéfinit pour une identité.- ENCRYPTION_ROTATION_DAYS
(nombre, facultatif) Le profil de confidentialité persistante.
0(la valeur par défaut) le désactive. Un nombre de jours positif fait remplacer parpepsi-keys identity rotate-due(exécuté chaque jour parpepsi-keys-rotate.timer) chaque clé de chiffrement que détient le serveur (custody = local) dès qu’elle atteint cet âge, et retirer l’ancienne ; la propre clé MUA d’un utilisateur n’est jamais renouvelée. Ce que cela coûte : un correspondant qui a mis l’ancienne clé en cache chiffre vers une clé retirée jusqu’à ce qu’il récupère la nouvelle (Autocrypt, WKD). Une fois la moitié privée de la clé retirée détruite (ci-dessous), le courrier qui arrive encore chiffré pour elle ne peut plus être ouvert : courrier tardif, courrier issu du cache périmé d’un correspondant, ou copie remise à nouveau depuis une sauvegarde. Voir le chapitre du manuel sur la gestion des clés.- RETIRED_PRIVATE_GRACE_DAYS
(nombre, facultatif) Avec
ENCRYPTION_ROTATION_DAYSdéfini, combien de jours une clé de déchiffrement retirée (révoquée ou expirée) détenue par le serveur garde sa moitié privée avant quepepsi-keys identity rotate-duene la détruise. Par défaut30;0la détruit à la première exécution après le retrait. Une clé vers laquelle un message de la file est encore chiffré est conservée jusqu’à ce que ce message ait quitté la file. Ignoré tant que la rotation est désactivée.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(chaîne, facultative) À quels domaines et comptes une adresse est attribuée pour décider à qui appartient une identité, que ce soit pepsi-keys(1), l’applicateur de configuration ou pepsi-stage-encrypt(1) qui la crée — les mêmes noms d’options, avec les mêmes significations et valeurs par défaut, que les options des étapes de remise locale (pepsi-stage-relay-to-maildir(1)).
LOCAL_DOMAINSvaut par défaut[pepsi-ingress] ACCEPTED_DOMAINS,TARGETSla plageUID_MIN..``UID_MAX`` de/etc/login.defsetRECIPIENT_DELIMITER+. Une adresse qui se résout vers un compte local voit ce login consigné avec son identité et peut être gérée par cet utilisateur ; une adresse qui ne s’y résout pas (une adresse de rôle, un domaine hébergé) est réservée à l’opérateur.
95.2.1.1.11. La section [pepsi-keydiscovery]¶
Comment Pepsi trouve la clé publique ou le certificat d’un correspondant — l’entrée de pepsi.peer_key, à la différence de [pepsi-crypto] ci-dessus, qui concerne la garde de notre propre matériel de clé. Lue par les services de découverte pepsi-keydisc(1), par pepsi-keys(1) (dont peer refresh --address exécute le même éventail dans un seul processus), et par toute étape qui doit garer un message sur une clé qu’elle n’a pas encore.
La section entière est facultative : sans elle, la découverte s’exécute avec l’ensemble de sources par défaut.
La découverte est asynchrone. Une étape qui a besoin d’une clé absente de son cache n’effectue aucune entrée-sortie réseau propre : elle valide son travail, met le message en pause et met une demande en file dans pepsi.key_request, et un service de découverte répond à la demande et libère chaque message garé sur cette adresse. Voir pepsi-keydisc(1) pour le côté service et pepsi.state(7) pour la clé keydisc que porte un message garé.
- SOURCES
(chaîne, facultative) Quelles méthodes de découverte ce déploiement exécute, sous forme de liste séparée par virgules ou espaces parmi
dane,wkd-advanced,wkd-direct,ldapetvks(wkdest accepté pourwkd-advanced,hkppourvks; les doublons sont ignorés). Par défautdane wkd-advanced wkd-direct vks.ldapen est délibérément absent, car il exige une fonctionnalité de compilation et reste inutile tant qu’il n’est pas configuré.Cette liste est aussi l’ensemble des méthodes que la règle d’arrêt attend, ce qui a deux conséquences. Une instance
pepsi-keydisc@<method>dont la méthode n’y figure pas refuse de démarrer ; et une méthode listée sans instance en cours fait attendre à chaque demande leTIMEOUTcomplet avant qu’elle ne se règle. Gardez la liste et les unités en cours d’exécution en accord :pepsi.targetdémarre exactement les quatre méthodes par défaut, laissez donc l’option non définie à moins de masquer ou de démarrer aussi des instances.inbound,inbound-signedetgossip(ainsi que leurs aliasharvested/autocrypt,autocrypt-signed/signedetautocrypt-gossip) sont rejetés. Apprendre une clé dans un message n’est pas un service, si bien que rien n’y répondrait jamais : cela s’exécute en ligne dans pepsi-stage-autocrypt-learn(1), à partir de matériel déjà présent dans le message. Une liste vide est refusée elle aussi ; retirez l’option pour prendre la valeur par défaut.- MIN_TRUST
(chaîne, facultative) Le plancher de confiance — une clé venue d’une source moins bien classée n’est pas employée. Nommé par sa source :
manual(aussiapiouoperator),dane,wkd-advanced(aussiwkd),wkd-direct,ldap,vks(aussihkp),inbound-signed(aussiautocrypt-signedousigned),harvested(aussiinboundouautocrypt), ougossip(aussiautocrypt-gossip,any,none). Par défautany— tout accepter.Une orthographe supplémentaire,
owner-confirmed(owner_confirmed), nomme un échelon par ce que la preuve est plutôt que par la méthode qui l’a produite : elle se résout envks, le plus faible échelon auquel quelqu’un qui pouvait prouver le contrôle de la boîte aux lettres ou du domaine a publié la clé volontairement. Elle existe afin que l’insertion d’un échelon entrevksetharvestedne puisse pas déplacer silencieusement cette ligne. C’est aussi la valeur par défaut de[stage-encrypt] GOSSIP_MIN_TRUST.L’alternative au chiffrement vers une clé en confiance au premier usage n’est pas une meilleure clé, c’est le texte clair. Relever le plancher est la façon dont un déploiement dit qu’il préférerait ne rien envoyer plutôt que d’envoyer vers une clé non authentifiée. Le classement compte encore au réglage par défaut : il tranche les conflits et il est consigné par clé.
any/nonenomment l’échelon du bas, quel qu’il soit à l’instant présent, tandis que toute autre graphie nomme un rang exact. La distinction compte pour les trois qui se ressemblent.inbound-signed(rang 7) est ce qu’un correspondant a dit de sa propre adresse dans un message que couvrait la signature DKIM de son domaine ;harvested(rang 8) est la même affirmation dans un message que rien n’a signé ; etgossip(rang 9) est la présentation d’un autre par un correspondant (Autocrypt Level 1 §5.3).MIN_TRUST = harvestedest donc le réglage intermédiaire utile : il conserve le chiffrement opportuniste mais refuse les présentations par des tiers.inbound-signedne le conserve que pour les correspondants dont le domaine signe le courrier. Les clés gossipées et non signées sont stockées dans les deux cas ; le plancher décide seulement si elles peuvent être employées.Le plancher ne s’applique pas à une adresse pour laquelle ce déploiement détient une identité. Notre propre clé n’est pas une clé découverte : elle préempte la consultation, de sorte qu’aucune ligne
peer_keypour cette adresse ne soit consultée quel que soit son rang, et qu’aucun plancher ne puisse l’exclure.own(aussilocal) est accepté comme graphie par souci de complétude — chaque rang a un nom etstate.cryptorend celui-ci — mais comme plancher il signifie « ne chiffrer que vers des adresses dont nous détenons notre propre clé », c’est-à-dire qu’aucun correspondant externe ne reçoit jamais de texte chiffré. Voir pepsi-stage-encrypt(1) et pepsi-stage-decrypt(1).- TIMEOUT
(durée, facultative) Échéance de la demande entière : combien de temps une demande peut rester en cours avant de se régler avec ce qui a été trouvé.
60 spar défaut. N’emploie que les unitésh/m/s(voir la note sur les durées ci-dessus).- INBOUND_TIMEOUT
(durée, facultative) La même échéance pour un message garé sur le chemin entrant — en attente de la clé qui vérifie une signature — valant
TIMEOUTpar défaut. Elle est distincte pour pouvoir être abaissée seule : un message garé sur le chemin entrant est du courrier que quelqu’un attend, de sorte qu’un opérateur qui remarque le retard peut la réduire à quelques secondes sans raccourcir l’échéance sortante. pepsi-setup(1) avertit au-delà de cinq minutes.- RANK_GRACE
(durée, facultative) Arbitre entre vitesse et exhaustivité. Lorsqu’une consultation réussit, chaque méthode encore en cours qui se classe mieux se voit accorder
RANK_GRACE× (de combien de rangs elle est meilleure) de temps supplémentaire ; à son expiration, la meilleure réponse en main l’emporte.5 spar défaut, donc un rang au-dessus reçoit 5 s et trois rangs au-dessus 15 s.Cette seule option couvre tout l’éventail.
0signifie que la première réponse utilisable l’emporte d’emblée. Avec la valeur par défaut, un serveur WKD lent ne peut pas retenir un message une fois qu’un serveur de clés a déjà répondu, mais une meilleure source presque aussi rapide l’emporte encore. Une valeur égale ou supérieure àTIMEOUTsignifie qu’on attend chaque méthode et que le classement s’applique intégralement (pepsi-setup(1) signale ce cas plutôt que de le traiter comme une erreur — c’est un choix légitime).- METHOD_TIMEOUT
(durée, facultative) L’échéance réseau propre à une méthode, couvrant la connexion, la poignée de main et chaque lecture.
15 spar défaut. La régler au-delà deTIMEOUTrend une méthode lente incapable de finir dans l’échéance de la demande entière, ce dont pepsi-setup(1) avertit.- CACHE_TTL
(durée, facultative) Combien de temps une clé stockée est employée avant que
pepsi-keys peer refreshne la revérifie (cela devient lerefresh_afterde la ligne) — par la méthode qui l’a trouvée, et seulement s’il s’agit d’une méthode réseau figurant encore dansSOURCES.24 hpar défaut.- NEGATIVE_TTL
(durée, facultative) Combien de temps un « cette adresse n’a pas de clé » faisant autorité est retenu.
24 hpar défaut. Tant que l’entrée est fraîche, un message pour cette adresse prend immédiatement le chemin « pas de clé » et ne se gare jamais : s’arrêter 60 s pour réapprendre une réponse connue ne fait que retarder chaque message vers ce correspondant. Le coût accepté est qu’une clé publiée il y a cinq minutes reste invisible jusqu’à ce que l’entrée vieillisse — abaissez ceci si cela compte plus que le délai. Le même intervalle cadence les recherches que pepsi-stage-encrypt(1) lance en arrière-plan pour une adresse dont la seule clé a été récoltée dans son propre courrier ou transmise par gossip : au plus une demande par adresse et parNEGATIVE_TTL, de sorte qu’une clé que le propriétaire publie plus tard est trouvée dans ce délai.- ERROR_TTL
(durée, facultative) La même chose, après qu’une méthode a échoué plutôt que répondu « il n’y a rien ici ».
1 hpar défaut : « le serveur était en panne » mérite d’être retenté plus tôt que « il n’y a pas de clé ».- MAX_RESPONSE_BYTES
(nombre, facultatif) Plafond sur un corps de réponse WKD ou VKS récupéré, appliqué pendant la diffusion plutôt qu’après, de sorte qu’un corps de 10 Mo coûte le plafond et non 10 Mo.
262144par défaut (256 Kio). Doit être supérieur à zéro.- VKS_SERVERS
(chaîne, facultative) Serveurs de clés vérifiants à interroger, dans l’ordre, sous forme de liste séparée par virgules ou espaces.
https://keys.openpgp.orgpar défaut. Chaque entrée doit être une URLhttps://, car rien ne justifie de croire une clé récupérée sur un canal non authentifié ; un/final est retiré.- TLS_CA_BUNDLE
(chemin, facultatif) Un fichier PEM de certificats de CA qui remplace le magasin de racines du système pour les récupérations HTTPS WKD et VKS — celles des services de découverte, de
pepsi-keys peer refreshetidentity publish --vks, et de pepsi-stage-vks-confirm(1). En son absence (la valeur par défaut), les racines du système sont utilisées. Un hôte WKD ou un serveur de clés dont le certificat ne se rattache pas à un certificat du fichier est refusé, comme tout hôte non fiable. LDAP et DANE ne sont pas affectés, et les récupérationshttps://de listes de révocation (CRL_FETCH) gardent les racines du système, puisqu’une CRL est authentifiée par la signature de son émetteur. Restreindre le magasin réduit l’ensemble des autorités de certification qui pourraient émettre à tort un certificat pour l’hôte WKD d’un correspondant. En contrepartie, Pepsi ne trouve plus les clés WKD des correspondants dont l’hôte WKD utilise une CA que le fichier ne contient pas. Le fichier est lu lorsqu’un récupérateur est construit : un fichier illisible ou ne contenant aucun certificat PEM fait refuser de démarrer à pepsi-keydisc(1), et n’est jamais remplacé silencieusement par les racines du système.- ALLOW_DOMAINS, DENY_DOMAINS
(chaîne, facultative) Politique de consultation par domaine de destinataire, séparée par virgules ou espaces et comparée sans distinction de casse sur la partie domaine. Un
ALLOW_DOMAINSnon vide est exclusif (seuls ces domaines sont jamais consultés) ;DENY_DOMAINSl’emporte toujours sur lui. Les deux sont vides par défaut, de sorte que tout domaine puisse être consulté. Une adresse sans@n’est jamais consultée.C’est le contrôle de confidentialité côté destinataire, et il est celui de l’opérateur. L’interrupteur par utilisateur ci-dessous est le côté expéditeur ; les deux ne sont pas interchangeables.
- LDAP_URL, LDAP_BASE, LDAP_FILTER, LDAP_ATTRIBUTE, LDAP_BIND_DN, LDAP_BIND_PASSWORD
(chaîne, facultative) L’annuaire qu’interroge
pepsi-keydisc@ldap.LDAP_URLdoit être une URLldap://ouldaps://et, avecLDAP_BASE, est requise dès queldapfigure dansSOURCES.LDAP_FILTERvaut(mail={address})par défaut et doit contenir le marqueur{address}(l’adresse est échappée selon la RFC 4515 avant substitution, de sorte qu’une partie locale contenant*ou(ne puisse devenir de la syntaxe de filtre) ;LDAP_ATTRIBUTEvautuserCertificate;binarypar défaut. UnLDAP_BIND_DNabsent signifie un bind anonyme ; unLDAP_BIND_DNprésent exige une URLldaps://, car un bind simple envoie le mot de passe verbatim et la consultation est refusée plutôt qu’effectuée en clair (la même règle que les clients LMTP et SMTP appliquent àAUTH).La prise en charge de LDAP est une fonctionnalité cargo de compilation. Sur une compilation qui en est dépourvue,
ldapdansSOURCESest rejeté par pepsi-setup(1) et l’instancepepsi-keydisc@ldaprefuse de démarrer.- CRL_FETCH
(booléen, facultatif) Si les services de découverte récupèrent dans
pepsi.crl_cacheles listes de révocation de certificats que nomment les certificats S/MIME de pairs en cache dans leurscRLDistributionPoints(http://ethttps://uniquement), pour que pepsi-stage-decrypt(1) y confronte les certificats des signataires. Par défautYES. Chaque point de distribution est récupéré à l’arrivée dunextUpdatede sa liste, mais au moins une fois par jour, de sorte que la CA apprend que cet hôte détient un certificat qu’elle a émis – jamais lequel, et jamais au moment où un message arrive (aucun répondeur OCSP n’est jamais interrogé ; ce qu’un serveur TLS agrafe n’est évalué que pour cette session). Une liste récupérée n’est stockée que si elle est à jour et pas plus ancienne que celle déjà en cache. AvecNO, rien n’est récupéré et la révocation S/MIME se lit « non vérifiée ». Voir pepsi-keydisc(1).- CRL_MAX_BYTES
(nombre, facultatif) Plafond d’une CRL récupérée, imposé pendant la lecture du flux. Par défaut
1048576(1 Mio). Une liste plus grande n’est pas stockée, et les certificats qu’elle aurait couverts restent « non vérifiés ». Doit être supérieur à zéro.- CA_ISSUERS_FETCH
(booléen, facultatif) Si les services de découverte suivent les pointeurs
caIssuers(authorityInfoAccess,http://ethttps://uniquement, jamais LDAP) des certificats S/MIME de pairs en cache, et des certificats récupérés à partir d’eux jusqu’à trois niveaux, verspepsi.ca_issuer_cache. pepsi-stage-decrypt(1) remet les certificats de CA stockés au vérificateur comme intermédiaires, de sorte qu’un correspondant qui envoie son certificat sans ses intermédiaires peut tout de même être validé jusqu’à une ancrecade pepsi-keys(1). Un certificat récupéré n’est jamais une ancre et ne nomme jamais un signataire. Par défautNO: chaque récupération dit à une CA que cet hôte correspond avec l’un de ses abonnés. Les réponses sont plafonnées à 64 Kio et récupérées à nouveau chaque semaine. Voir pepsi-keydisc(1).- BADKEYS_URL
(URL, facultative) L’endroit d’où
pepsi-keys blocklist updaterécupère la liste des clés connues comme compromises ;pepsi-keys-blocklist.timerexécute cette commande chaque jour. Par défauthttps://update.badkeys.info/v0: la liste de blocage badkeys (https://badkeys.info), qui comprend chaque clé RSA et EC que pouvait produire le bogue OpenSSL de Debian (CVE-2008-0166), les clés publiées dans des RFC, des suites de tests et de la documentation, et les clés extraites de micrologiciels et de paquets logiciels.badkeysdata.jsonsous cette URL nomme la liste courante, qui doit elle aussi se trouver sous l’URL ; elle est récupérée par TLS vérifié (les racines deTLS_CA_BUNDLElorsqu’il est défini), de façon conditionnelle, de sorte qu’une liste inchangée coûte une petite requête. Doit être enhttps://. Un miroir à vous peut être nommé à la place, et un miroir qui ne change jamais fige la liste.La liste réside dans la base de données (
pepsi.compromised_key, environ 240 Mo pour la liste de 2026 de trois millions de clés), à côté des modules quepepsi-keys peer screena factorisés. Elle ne fait que croître : une mise à jour ajoute de nouvelles entrées et n’en supprime aucune. La clé d’un correspondant qui y figure est refusée partout où une clé inférieure à[pepsi] CRYPTO_MIN_RSA_BITSl’est (pour le chiffrement, pour la vérification de signature et dans une chaîne S/MIME), et la découverte de clés, la récolte etpepsi-keys peer importne la stockent jamais. Jusqu’à la première mise à jour, seuls les constats propres du criblage s’appliquent. Pour arrêter les mises à jour,systemctl mask --now pepsi-keys-blocklist.timer(pepsi.targetredémarre un timer simplement désactivé) ;pepsi-keys blocklist dismissmet hors service les entrées erronées. Voir pepsi-keys(1).
95.2.1.1.11.1. L’interrupteur par expéditeur : [stage-encrypt] DISCOVERY¶
Une étape qui consomme le magasin de clés lit une option qui lui est propre, dans sa section [stage-<name>], de sorte qu’elle puisse être redéfinie par adresse via la couche pepsi.settings (pepsi-settings(1)) :
- DISCOVERY
(booléen, facultatif) Si un défaut de cache peut déclencher une consultation réseau.
YESpar défaut. AvecNO, les clés en cache sont toujours employées, mais un défaut va droit au chemin « pas de clé » de l’étape au lieu de garer le message, puisqu’il n’y aurait rien à attendre.
Important
Ce que signifie réellement la redéfinition par adresse. La couche de paramètres résout un message sortant sur son expéditeur d’enveloppe, de sorte qu’une redéfinition de DISCOVERY pour une adresse signifie « le courrier de cet utilisateur ne déclenche jamais de consultation » — et non « ne jamais consulter ce correspondant ». La suppression côté destinataire est celle de l’opérateur, ALLOW_DOMAINS/DENY_DOMAINS ci-dessus ; il n’existe délibérément pas de liste noire de destinataires par adresse, qui exigerait sa propre colonne et une seconde liste pour rester cohérente avec celle-ci.
DISCOVERY est lue par pepsi-stage-encrypt(1) et pepsi-stage-decrypt(1) depuis la section effective de cette étape, de sorte qu’une redéfinition pepsi.settings s’applique. Leurs autres options sont documentées sous Options de pepsi-stage-encrypt et Options de pepsi-stage-decrypt.
95.2.1.1.12. La section [pepsi-keys]¶
L’image en miroir de la section ci-dessus : comment les autres trouvent les clés de nos utilisateurs. Lue par pepsi-keys(1) et par pepsi-stage-vks-confirm(1). La section entière est facultative, et une configuration qui l’omet ne publie rien sur aucun serveur de clés.
La publication par Web Key Directory n’a besoin d’aucune option. Elle suit l’indicateur published de chaque identité (activé par défaut, effacé avec pepsi-keys identity unpublish) et est servie par pepsi-httpd(1) depuis notre propre domaine : elle prend donc effet à la requête suivante et se défait en effaçant l’indicateur. Ce que cette section configure est l’autre canal, qui ne se comporte pas du tout de même : un serveur de clés accepte une clé définitivement : on peut plus tard lui dire que la clé est révoquée, mais jamais lui dire de l’oublier.
- VKS_PUBLISH
(booléen, facultatif) Si une identité créée ou importée à la main (
pepsi-keys identity generate/import, legeneratede la console web ou de l’API, la commandegeneratepar e-mail) commence avec son téléversement vers le serveur de clés demandé (crypto_identity.vks_wanted). NO par défaut.Chaque identité enregistre si son téléversement a été demandé, et la tâche de relance (
pepsi-keys identity publish --retry) téléverse exactement les identités OpenPGP publiées et actives qui ontvks_wantedpositionné, en réessayant jusqu’à vérification. Elle n’est pas conditionnée par cette option. Deux conséquences :les clés générées automatiquement (
[stage-encrypt] ENABLE_PEP) et les clés MUA enregistrées à partir du propre courrier d’un utilisateur ne sont jamais téléversées sans demande, quoi que dise cette option – Autocrypt et le WKD propre au déploiement sont la manière dont on les trouve ;la demande explicite de téléversement d’un utilisateur (
pepsi-keys identity publish <ID> --vks, Upload to the key server dans la console web,PATCH /api/v1/identities/{id}avecvks_wanted, ou la commandepublishpar e-mail) est honorée quoi que dise cette option.
« Non téléversé » est donc un état enregistré plutôt qu’une absence, et
pepsi-keys identity showl’affiche. Un téléversement ne peut pas être retiré, c’est pourquoi la valeur par défaut pour les clés faites à la main reste une décision de l’opérateur.- VKS_SERVER
(chaîne, facultative) Le serveur de clés vers lequel vont les téléversements ;
https://uniquement, et une URL en clair est refusée plutôt que rétrogradée. Vaut par défaut la première entrée de[pepsi-keydiscovery] VKS_SERVERS, afin qu’un déploiement ayant déjà choisi un serveur de clés à lire ne le nomme pas deux fois.Un serveur, non une liste : publier la même clé auprès de plusieurs serveurs répète un acte qu’on ne peut pas annuler, et chacun d’eux doit ensuite être tenu à jour des révocations.
Son hôte est aussi le
VKS_HOSTpar défaut de pepsi-stage-vks-confirm(1) : le seul hôte dont cette étape accepte un courrier de vérification et vers lequel elle suit un lien.- VKS_MAX_ATTEMPTS
(entier, facultatif) Combien de tentatives une identité obtient avant que
pepsi-keys identity publish --retryne la laisse tranquille.5par défaut. La ligne conserve sa dernière erreur, de sorte qu’une identité abandonnée dise pourquoi.- VKS_RETRY_INTERVAL
(durée, facultative) Espacement minimal entre les tentatives pour une identité.
6 hpar défaut. Les unités calendaires sont rejetées :6 hs’analyse,1 dnon.- VKS_BATCH
(entier, facultatif) Sur combien d’identités une exécution
--retrytravaille, afin que la première exécution sur un grand déploiement n’envoie pas une seule énorme rafale de requêtes à un tiers.50par défaut.
95.2.1.1.13. La section [pepsi-mpki]¶
Lue par pepsi-keys(1) mpki, qui commande des certificats S/MIME pour les utilisateurs d’un domaine auprès d’une autorité de certification commerciale (une PKI gérée). La section est facultative et chaque option a une valeur par défaut. Elle ne contient que ce dont l’hôte a besoin pour joindre l’AC et envoyer ses avis par courrier : la participation d’un domaine, le compte d’AC et les règles qu’il utilise se règlent par domaine dans la base de données avec pepsi-keys mpki domain set, et la clé d’API du compte est un fichier à part.
- CREDENTIAL_DIR
(path, optional) The directory that holds one
mpki-DOMAIN.secretfile per managed domain, with that domain’s CA API key. Default: thesecrets.ddirectory beside the configuration file (/etc/pepsi/secrets.d).pepsi-keys mpki credential setwrites the files, with mode0640and grouppepsi-crypto.- TIMEOUT
(durée, facultative) Le délai d’une requête à l’API de l’AC. Par défaut
60 s. Une requête qui dépasse ce délai est un échec temporaire, réessayé par une passe ultérieure.- NOTIFY_STAGE
(chaîne, facultative) L’étape à laquelle les avis d’une passe sont injectés, en un courrier par domaine, à destination de l’adresse de notification du domaine (
pepsi-keys mpki domain set DOMAIN --notify ADDRESS), avec l’expéditeur nul etAuto-Submitted: auto-generated. Nommez une étape du chemin que suit le courrier sortant, par exemple l’étape qui le signe avec DKIM. Sans elle, aucun avis n’est envoyé par courrier, etpepsi-keys mpki noticesles liste quand même tous.- NOTIFY_FROM
(chaîne, facultative) L’adresse
From:d’un courrier d’avis. Par défautpostmaster@DOMAIN, pour le domaine que concernent les avis.
95.2.1.1.14. La section [pepsi-ingress]¶
Options globales régissant l’acceptation des messages, lues par pepsi-ingress(1).
- HOSTNAME
(chaîne, obligatoire) Nom d’hôte annoncé dans la salutation SMTP et la réponse
EHLO, par exemplemail.example.org.- ACCEPTED_DOMAINS
(chaîne, obligatoire) Liste séparée par espaces ou virgules de domaines pour lesquels le courrier est accepté. Les destinataires dans tout autre domaine sont rejetés comme relayage avec
550 5.7.1, sauf si la session est authentifiée (voir les sections d’écouteur). La correspondance est insensible à la casse et se fait sous la forme IDNA : un domaine internationalisé peut être écrit sous son U-label (münchen.example) ou son A-label (xn--mnchen-3ya.example), et le courrier à l’une ou l’autre graphie est accepté. Au moins un domaine doit être donné.- USERNAME_MAP
(chemin, facultatif) Fichier mappant chaque id d’authentification SASL aux adresses e-mail qu’il peut utiliser comme expéditeur d’enveloppe et identité
From:(RFC 6409 §6/§8.1). Chaque ligne non vide et non-commentaire estusername: addr…— un#commence un commentaire, la clé est le nom d’utilisateur SASL, et la valeur est la liste séparée par espaces/virgules des adresses autorisées (qui peut être vide). Un nom d’utilisateur listé avec des adresses est autorisé exactement celles-ci (la première concrète étant l’identité canonique utilisée pour la correctionSender:) ; une adresse peut être un joker*tel que*@example.org(n’importe quelle adresse au domaine) ou un*nu (n’importe quelle adresse). Un nom d’utilisateur listé sans adresses se voit refuser toute adresse (sonAUTHest refusé même si les identifiants sont valides) ; un nom d’utilisateur non listé retombe sur le défautusername@HOSTNAME. Le fichier est relu chaque fois que son heure de modification change (vérifiée à chaque authentification) ; un fichier manquant/illisible est traité comme vide. Lorsqu’il n’est pas réglé, chaque utilisateur authentifié est mappé à son défautusername@HOSTNAME. Voir pepsi-ingress(1).- SENDER_MAP
(path, optional) File naming the addresses that a
MYNETWORKSnetwork or a TLS client certificate may send as. Each non-blank, non-comment line holds a key followed by at least one address in theUSERNAME_MAPsyntax (exact, a*@example.orgwildcard, or*for any address). The key is a CIDR network or bare address, orcert:followed by the 64-hex-digit SPKI pin of a TLS_AUTH_CLIENT key or of a TLS_AUTH_CLIENT_CA certificate. An address that one key names exactly is claimed: no other key’s wildcard reaches it. AMYNETWORKSsession is bound by the most specific network containing the peer, a certificate session by the key or CA under which it was recognised; a bound session is subject to theMAIL FROM/From:checks of USERNAME_MAP (550 5.7.1), and a CA-issued certificate that names a mailbox is confined to it. A certificate that no key matches authenticates nothing, and aMYNETWORKSentry outside loopback that no single key covers whole is refused: pepsi-ingress does not start and pepsi-setup(1)validatefails, naming the entry, since every host in it could otherwise send as any address and have it signed for every served domain. A bare*binds a network to every address, as an explicit decision; loopback (127.0.0.0/8,::1) needs no binding. pepsi-ingress (at every start) andpepsi-setup validatewarn about aMYNETWORKSentry that is wider than one host and whose most specific key is a bare*: every machine in that network may send signed mail as any address of every served domain, the configuration that the EchoSpoofing campaign abused. Read once at start-up; an error in the file stops pepsi-ingress from starting. See pepsi-ingress(1), Client certificates and Sender bindings for networks and certificates.- POSTMASTER
(string, optional) Routable address to which the reserved
<Postmaster>mailbox without a domain is rewritten. RFC 5321 §4.5.1 requires<Postmaster>(with no domain) to be accepted regardless ofACCEPTED_DOMAINS; on acceptance Pepsi rewrites it to this address so that the normal pipeline (aliases, local delivery, relay) can route it. When unset it is rewritten topostmaster@HOSTNAME— add an alias for that address in apepsi-stage-aliasesALIASESmap to deliver postmaster mail to a real person, or setPOSTMASTERto that person directly. See pepsi-ingress(1).- MAX_MESSAGE_SIZE
(nombre, facultatif) Taille maximale acceptée du corps de message en octets — la taille de la charge utile
DATA. La valeur est annoncée via l’extension ESMTPSIZE; les messages la dépassant sont rejetés avec552. Par défaut26214400(25 Mio).- MAX_HEADER_FIELDS
(nombre, facultatif) Nombre maximal de champs que peut porter le bloc d’en-têtes de premier niveau d’un message ; un message qui en a davantage est refusé à la fin des données avec
552 5.3.4, sur chaque écouteur. Par défaut1000(le courrier ordinaire en porte de 20 à 150) ;0signifie illimité. Avec MAX_HEADER_FIELD_SIZE, c’est la borne que les avis Dovecot CVE-2024-23184 et CVE-2024-23185 demandent au MTA placé devant le MDA. Les blocs d’en-têtes des messages joints (partiesmessage/rfc822) ne sont pas comptés ; ils restent bornés par MAX_MESSAGE_SIZE.- MAX_HEADER_FIELD_SIZE
(nombre, facultatif) Taille maximale d’un champ d’en-tête, en octets, une fois déplié : son nom, les deux-points et sa valeur avec chaque ligne de continuation, sans compter les sauts de ligne. Un message comportant un champ plus grand est refusé à la fin des données avec
552 5.3.4. Par défaut102400(100 Kio, leheader_size_limitde Postfix ; unTo:nommant mille destinataires fait environ 40 Kio) ;0signifie illimité.- MAX_CONNECTIONS
(nombre, facultatif) Nombre maximal de connexions SMTP servies en concurrence sur tous les écouteurs. Le plafond d’admission effectif est le plus petit de celui-ci et de
MAX_OPEN_SOCKETS. Par défaut1024.- DB_POOL_SIZE
(nombre, facultatif) Nombre maximal de connexions PostgreSQL dans le pool de base de données de l’ingress. L’ingress sert de nombreuses sessions SMTP en concurrence, chacune appelant brièvement
workqueue_add, de sorte que contrairement aux workers d’étape à connexion unique, il peut en utiliser plus d’une. Par défaut1; ne le relevez que si la connexion unique limite la vitesse à laquelle l’ingress accepte le courrier, et gardez la somme du pool de chaque composant en dessous dumax_connectionsde PostgreSQL.- MAX_OPEN_SOCKETS
(nombre, facultatif) Plafond dur sur les connexions client ouvertes en concurrence, protégeant contre l’épuisement des descripteurs de fichiers. Lorsqu’il n’est pas réglé, il est dérivé du
RLIMIT_NOFILEsouple du processus moinsRESERVED_SOCKETS. 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 source (une adresse IPv4, ou un/32IPv6) dont le temps d’inactivité total est le plus grand (un421, puis fermeture).- RESERVED_SOCKETS
(nombre, facultatif) Descripteurs de fichiers retenus du budget dérivé de
RLIMIT_NOFILE(pour le pool de base de données, les écouteurs, stdio et les sockets DNS). Par défaut64. Ignoré lorsqueMAX_OPEN_SOCKETSest réglé.- CONN_RATE_PER_SECOND
(nombre, facultatif) Taux de recharge de seau à jetons limitant les nouvelles connexions acceptées par plage source, en connexions par seconde. Une connexion dépassant le débit reçoit au mieux un
421et est fermée ; la connexion n’occupe un créneau que pendant l’écriture de cette réponse, et aucun du tout (et ne reçoit pas de réponse) lorsque le plafond de descripteurs est déjà atteint. Par défaut1. Une valeur fractionnaire est acceptée (0.2vaut une connexion toutes les cinq secondes). Les connexions locales (socket UNIX) ne sont jamais limitées en débit.- CONN_RATE_BURST
(nombre, facultatif) Allocation de rafale de seau à jetons par plage source, également fractionnaire. Par défaut
1.- MAX_CONNECTIONS_PER_IP
(nombre, facultatif) Combien de connexions simultanées une plage source (une adresse IPv4, ou un
/32IPv6) peut détenir. Une connexion au-delà est refusée comme une connexion limitée en débit. Par défaut16;0désactive le plafond.- MAX_LOCAL_CONNECTIONS
(nombre, facultatif) Combien de connexions simultanées l’ensemble des pairs de socket UNIX peuvent détenir. Les connexions locales sont exemptées de la limite de débit et de l’éviction à l’échelle du serveur, cette limite empêche donc les soumissionnaires locaux d’occuper tous les créneaux. Un uid pair peut en détenir au plus la moitié (au moins une), de sorte qu’un seul compte local ne puisse pas exclure les autres ;
rootet les comptes de service n’en sont pas exemptés. Lorsque les connexions locales l’atteignent, une nouvelle connexion d’un uid qui en détient moins que l’uid le plus chargé évince la connexion la plus longtemps inactive de l’uid le plus chargé, pourvu que cette connexion n’ait envoyé aucune ligne de commande complète depuis 5 secondes ; la session évincée reçoit421 4.3.2. Des comptes de connivence ne peuvent donc pas non plus le remplir ;pepsi-sendmailécrit tout son message sans pause et n’est jamais celui qui est évincé. Par défaut32;0ne les borne que parMAX_CONNECTIONS, sans part par uid.- MAX_MESSAGES_PER_SESSION
(nombre, facultatif) Combien de transactions de courrier une session peut commencer ; le
MAILsuivant reçoit la réponse421et la session est fermée. Par défaut100;0signifie illimité.- VERIFY_RECIPIENTS
(``auto`` ou ``off``, facultatif) Si une adresse d’un domaine servi que rien sur cet hôte n’accepterait est refusée au moment du
RCPTavec550 5.1.1. Par défautauto. Le MTA émetteur prévient alors immédiatement son propre utilisateur. Si le message était accepté, il rebondirait plus tard vers son expéditeur d’enveloppe. Le spam falsifie cet expéditeur, de sorte que le rebond atteint un tiers innocent (backscatter) et vaut à cet hôte de finir sur une liste noire.Rien n’a besoin d’être listé à la main. Pour chaque domaine servi, les sources qui peuvent se porter garantes d’une adresse sont déduites des sections
[stage-*]:les comptes locaux que résout une pepsi-stage-relay-to-maildir(1) ou une pepsi-stage-dot-forward(1) pour ses
LOCAL_DOMAINS,TARGETSetRECIPIENT_DELIMITERcompris ;le MDA derrière une pepsi-stage-relay-to-lmtp(1), interrogé pour ses
LOCAL_DOMAINSavecRCPT TOet sans message ;le backend derrière une pepsi-stage-route(1), selon ce qu’indique son RECIPIENT_CHECK ;
chaque table de pepsi-stage-aliases(1), avec la correspondance propre à l’étape ;
les listes de diffusion, lorsqu’un routeur pepsi-stage-list(1) est configuré ;
postmaster@etabuse@, ainsi que les adresses de contrôle des étapes qui en traitent une (pepsi@,pepsi-keys@,pepsi-wallet@,secretary@,dmarc-reports@).
Une adresse dont l’une d’elles se porte garante est acceptée. Il en va de même de toute adresse d’un domaine qui ne peut pas être vérifié :
un alias fourre-tout couvre le domaine ;
une étape exécute un programme que Pepsi ne connaît pas ;
le domaine est acheminé vers un backend avec
RECIPIENT_CHECK = none;le domaine est relayé plus loin par une étape smarthost sans que rien ici ne détienne ses boîtes aux lettres.
Toute incertitude accepte aussi : un fichier illisible, une erreur de base de données, une sonde qui échoue ou expire. pepsi-setup run affiche le résultat pour chaque domaine.
offaccepte toute adresse d’un domaine servi. Lu au démarrage : un graphe d’étapes modifié exige un redémarrage de l’ingress, tandis que les modifications d’une table d’alias, d’une liste de destinataires ou des listes de diffusion s’appliquent immédiatement.Quoi que dise cette option, une partie locale contenant
%(le percent hack) ou!(un chemin bang) dans un domaine servi est refusée550 5.1.3à moins que l’une des sources ci-dessus ne se porte garante de l’adresse, de sorte qu’un arrière-plan qui honore encore ces formes ne reçoit jamais une route vers un tiers.- MAX_INVALID_RECIPIENTS
(nombre, facultatif) Nombre de destinataires inconnus qu’une session peut nommer. À la limite, la session est fermée avec
421, ce qui transforme une attaque par dictionnaire (collecte d’adresses valides, ou obliger le MDA à répondre essai après essai) en un flux de connexions que mesurent les limites de connexion. Par défaut10;0signifie illimité.- MAX_SELF_HOPS
(nombre, facultatif) Combien de fois un message peut déjà être passé par l’ingress de cet hôte avant d’être refusé comme boucle de routage, avec
554 5.4.6. Compté à partir des champsReceived:que l’ingress écrit lui-même (byHOSTNAME(pepsi-ingress)). Le courrier légitime revient tout au plus quelques fois : un alias vers un autre domaine servi, un~/.forward, ou un rapport destiné à l’un de nos propres utilisateurs repartent chacun par SMTP puis reviennent. Une boucle, en revanche, tournerait sinon jusqu’à la limite de sauts générique des étapes de relais, soit des dizaines de passages. Par défaut5;0désactive la vérification.- AUTH_FAILURES_PER_HOUR
(nombre, facultatif) Nombre de tentatives
AUTHéchouées qu’une plage source peut faire par heure sur l’ensemble de ses sessions (un seau à jetons). Une fois épuisé,AUTHdepuis la plage est refusé avec421sans consulter le backend SASL jusqu’à ce que le seau se remplisse. Par défaut20;0signifie illimité.- ACCOUNT_AUTH_FAILURES_PER_HOUR
(nombre, facultatif) Nombre de tentatives
AUTHéchouées qu’un compte (son identifiant d’authentification, comparé sans tenir compte de la casse) peut accumuler par heure, toutes sources confondues (un seau à jetons). Une fois le budget épuisé, unAUTHpour le compte depuis une plage source à partir de laquelle il ne s’est pas authentifié au cours des 30 derniers jours attendACCOUNT_AUTH_DELAYavant que l’arrière-plan SASL soit interrogé, et de telles tentatives sont vérifiées une à la fois, de sorte qu’un devineur réparti sur de nombreuses adresses obtient un essai par délai. Le compte n’est jamais verrouillé : son propriétaire, avec le bon mot de passe, se connecte toujours, après le délai. Une tentative qui devrait attendre plus de trois délais reçoit454 4.7.0sans être vérifiée. Par défaut10;0désactive le délai.- ACCOUNT_AUTH_DELAY
(durée, facultative) L’attente décrite sous
ACCOUNT_AUTH_FAILURES_PER_HOUR, et donc le temps minimal entre deux essais vérifiés sur un compte au-delà de son budget. Par défaut20 s;0 sdésactive le délai.- LOCAL_MESSAGES_PER_MINUTE
(nombre, facultatif) Nombre de messages qu’un uid local peut soumettre par minute sur l’ensemble de ses sessions ; l’uid est identifié par
SO_PEERCREDsur une session par socket UNIX. UnMAILau-delà du débit reçoit451 4.7.1. Par défaut60;0signifie illimité.- LOCAL_MESSAGE_BURST
(nombre, facultatif) La rafale autorisée en plus de
LOCAL_MESSAGES_PER_MINUTE. Par défaut120.- USER_RECIPIENTS_PER_HOUR
(nombre, facultatif) Nombre de destinataires auxquels un compte SASL (son identifiant d’authentification, comparé sans tenir compte de la casse) peut soumettre par heure sur l’ensemble de ses sessions ; un
RCPTau-delà du débit reçoit450 4.7.1. Seuls les destinataires acceptés comptent. Cela borne la quantité de courrier qu’un mot de passe volé peut envoyer. Par défaut500;0signifie illimité.- USER_RECIPIENT_BURST
(nombre, facultatif) La rafale autorisée en plus de
USER_RECIPIENTS_PER_HOUR. Par défaut500.- COMMAND_TIMEOUT
(durée, facultative) Durée maximale qu’une session attend pour la commande suivante (ou la continuation
AUTH, ou le début d’un corpsDATA/BDAT) avant que la connexion ne soit fermée avec421(RFC 5321 §4.5.3.2). Par défaut300 s.- TLS_HANDSHAKE_TIMEOUT
(durée, facultative) Durée maximale d’une poignée de main TLS, sur un écouteur TLS implicite et après
STARTTLS, avant que la connexion ne soit fermée (sans réponse). Distinct deCOMMAND_TIMEOUT: une poignée de main prend quelques allers-retours à un client qui fonctionne, et chacune coûte au serveur une opération de clé privée, de sorte qu’un pair qui cale ou envoie un ClientHello quelques octets à la fois ne doit pas occuper une connexion pendant tout un délai de commande. Par défaut30 s; doit être supérieur à zéro.- DATA_TIMEOUT
(durée, facultative) Durée maximale qu’une session attend pour le bloc d’octets de charge utile suivant lors de la réception d’un corps
DATA/BDATavant de fermer avec421. Par défaut180 s.- SESSION_TIMEOUT
(durée, facultative) La durée maximale d’une session, à partir de sa connexion ; au-delà, la lecture suivante — une commande, une continuation
AUTH, un bloc de corps — reçoit421 4.4.2 Session time limit exceededet la connexion est fermée, quoi que disent les délais par lecture. Chaque octet qu’envoie le client réinitialise ces délais, de sorte que sans cette limite un client pourrait garder une transaction ouverte indéfiniment au point de son choix : juste avant la fin duDATA, par exemple, chez des milliers d’hôtes à la fois, pour toutes les terminer au même instant. Par défaut30 m, bien au-delà de ce dont une session a besoin (un corps deMAX_MESSAGE_SIZEpasse encore à 15 Ko/s) ; un expéditeur de masse dont la session est coupée se reconnecte simplement.0 sdésactive l’échéance.- DMARC_ENFORCE
(booléen, facultatif) Lorsque
YES, rejeter au moment SMTP (550) un message d’une session non authentifiée dont l’évaluation DMARC échoue et dont la politique publiée estquarantineoureject; le courrier soumis n’est jamais rejeté à cause de DMARC. La valeur par défaut compilée estNO, de sorte qu’une configuration qui ne mentionne pas l’option continue d’accepter un tel courrier en notant le résultat en échec (et pepsi-stage-arc(1) le scelle) pour qu’un destinataire en aval décide ;--wizardde pepsi-setup(1) écritYESpour une nouvelle installation, et unpepsi.confexistant garde ce qu’il indique. pepsi-setup(1) avertit au sujet d’une configuration avec des domaines acceptés qui ne définit pas l’option, et d’une configuration où l’option est désactivée alors que l’enregistrement DMARC d’un domaine servi demande aux destinataires dequarantineoureject. Les autres échecs d’authentification ne rejettent jamais un message. UnFrom:nommant plusieurs domaines est évalué, et peut être rejeté, pour chacun d’eux (jusqu’à 10). AvecYES, un message d’une session non authentifiée auquel DMARC ne peut pas être appliqué est également rejeté : un message sans adresseFrom:(550 5.6.0) et un message dont leFrom:nomme plus de 10 domaines (550 5.7.1). Un message en échec est accepté à la place lorsqu’un scelleur listé dans ARC_TRUSTED_SEALERS se porte garant de sa chaîne ARC.- EXTERNAL_SUBJECT_TAG
(booléen, facultatif, par défaut ``YES``) Placer TAG_EXTERNAL en tête du
Subjectd’un message d’une session non authentifiée lorsque sonFrom:revendique un domaine servi sans réussite DMARC, DKIM alignée ou SPF alignée, lorsque sonSender:en revendique un sans réussite DKIM ou SPF alignée, lorsque sonFrom:ne peut pas être lu d’une seule façon ou nomme plusieurs domaines, ou lorsque sonfailDMARC n’a pas été suivi d’effet. Auparavant, retirer les copies de l’étiquette du début de chaque objet entrant, jugé tel qu’un client de messagerie le rend, afin qu’un expéditeur ne puisse pas écrire l’étiquette. Un message sansSubjecten reçoit un. Les champsX-Pepsi-Warning(from-ambiguous,served-domain-not-authenticated,served-sender-not-authenticated,dmarc-fail-not-enforced) etstate.auth.warningssont écrits dans tous les cas. Voir pepsi-ingress(1), Marquage du courrier venu de l’extérieur.- TAG_EXTERNAL
(chaîne, facultative, par défaut ``[external]``) L’étiquette qu’écrit EXTERNAL_SUBJECT_TAG, sans les espaces de bord. Le
[external]documenté est retiré des objets entrants même lorsque cette option vaut autre chose, puisqu’un expéditeur qui falsifie l’étiquette documentée falsifie un indicateur qu’un lecteur a pu voir ailleurs. Une valeur vide désactive l’étiquette.- ARC_TRUSTED_SEALERS
(chaîne, facultative) Domaines séparés par des espaces ou des virgules dont la chaîne ARC (RFC 8617) l’emporte sur un échec DMARC sous DMARC_ENFORCE. Indiquez les hôtes de listes de diffusion et les réexpéditeurs dont vous savez qu’ils cassent DMARC pour le courrier qu’ils relaient, et auxquels vous faites confiance pour avoir authentifié ce courrier à sa réception. Un message qui échoue à DMARC est accepté lorsque sa chaîne ARC se valide (
cv=pass, recalculé à partir des signatures, jamais lu dans la propre étiquettecv=de la chaîne) et que led=de l”ARC-Seald’instance la plus élevée figure ici (comparé en minuscules, sans point final). Ce sceau vient de l’ADMD qui a scellé en dernier, la seule dont la signature couvre le message tel que reçu. Le scelleur est consigné commestate.auth.arc_override;state.auth.dmarcindique toujoursfail. Une chaîne scellée en dernier par quelqu’un d’autre, une chaîne qui ne se valide pas, ou l’absence de chaîne laissent le rejet en place. Vide par défaut : un scelleur inconnu ne prouve rien. La chaîne de chaque message refusé sous DMARC_ENFORCE est vérifiée quoi que contienne la liste, et le refus est journalisé avec son dernier scelleur —arc-sealer=<domain>pour une chaîne qui se valide, un scelleur revendiqué pour une chaîne qui ne se valide pas —, de sorte que le journal nomme les réexpéditeurs et les listes à envisager pour cette option. Sans effet sans DMARC_ENFORCE, ce dont pepsi-ingress(1) avertit au démarrage.- MIME_ANOMALIES
(chaîne, facultative) Que faire d’un message dont la structure MIME est ambiguë, ou dont l’en-tête de message porte des copies différentes d’un champ que la RFC 5322 n’autorise qu’une fois. Une structure est ambiguë lorsque les RFC 2045/2046 laissent sa lecture à l’analyseur, de sorte qu’un filtre analyse autre chose que ce que montre le client.
enforce(la valeur par défaut) refuse les classes dures avec554 5.6.0: unboundary=vide, un NUL dans un en-tête MIME, des champsContent-TypeouContent-Transfer-Encodingdupliqués contradictoires, un encoded-word RFC 2047 comme frontière, et des champsDate,Subject,To,Reply-ToouSenderdifférents. Il marque des champsCcdifférents avecX-Pepsi-Warning: duplicate-header-cc. Il réécrit les classes douces selon l’unique lecture qu’imposent les normes : un encodage de transfert inconnu, une espace après un saut doux quoted-printable, des caractères base64 hors de l’alphabet, un délimiteur de fermeture manquant, une ligne de délimiteur de la frontière du multipart après son délimiteur de fermeture (l’épilogue, que la RFC 2046 dit d’ignorer, est abandonné), et des champs dupliqués identiques. La réécriture a lieu avant que le message ne soit stocké, jamais à l’intérieur d’une partie signée ou chiffrée, après SPF/DKIM/DMARC et avant le sceau ARC (un message portant une chaîne ARC est réécrit par pepsi-stage-arc(1) à la place, une fois qu’il a vérifié la chaîne).logcompte et journalise les classes et stocke le message tel que reçu, en marquant chaque champ d’en-tête différent parX-Pepsi-Warning: duplicate-header-<field>. Les deux notent les classes commestate.mime_anomalies. Voir pepsi-ingress(1), « Structure MIME ambiguë », pour les classes et le taux de base mesuré.- IPREV_ACTION
(``none`` ou ``reject``, facultatif) Comment l’ingress traite un client dont le DNS inverse échoue de façon certaine à se valider (
iprev=failde la RFC 8601 : son adresse a un nom PTR qui ne se résout pas à nouveau vers elle, ou aucun).none(la valeur par défaut) note le verdict dansstate.origin.iprevet dans l’en-têteReceived:seulement : un DNS inverse cassé est un indice sur le DNS de l’expéditeur, non sur son message, et de petits sites en ont un.rejectrefuse chaque destinataire saufpostmasteravec550 5.7.25(RFC 7372) sur une session non authentifiée d’un écouteur qui n’est pas un écouteur de soumission ; untemperrorou unpermerrorne refuse jamais.- DNS_SERVERS
(chaîne, facultative) Les résolveurs utilisés pour les recherches SPF/DKIM/DMARC, dans la syntaxe de
[pepsi] DNS_SERVERS(adresses simples, ou entréestls:///https://). S’il n’est pas défini,[pepsi] DNS_SERVERSs’applique, et à défaut la configuration de résolveur du système (/etc/resolv.conf).- DNS_TIMEOUT
(durée, facultative) Délai par requête pour ces recherches. Par défaut
[pepsi] DNS_TIMEOUT, sinon5 s. Comme la vérification s’exécute de façon synchrone pendant la réception duDATA, un résolveur lent retarde l’acceptation250.Elle ne s’applique que lorsqu’une liste DNS_SERVERS nomme les résolveurs (celle de cette section ou celle de
[pepsi]). Sans elle, la configuration de résolveur du système est employée en entier, délai compris : cette option n’a donc aucun effet et ce sont les lignesoptions timeout:/attempts:de/etc/resolv.confqui bornent une requête.- MAX_DKIM_SIGNATURES
(nombre, facultatif) Nombre de champs
DKIM-Signatured’un message entrant qui sont vérifiés ; ceux dont led=est le domaine duFrom:ou un parent ou un enfant de celui-ci passent en premier. Par défaut10.- VERIFY_TIMEOUT
(durée, facultative) Échéance de la vérification entrante : SPF et les signatures DKIM sélectionnées sont vérifiés en concurrence sous cette échéance, puis DMARC sous une seconde. Une vérification qui la dépasse est consignée comme
temperrorpour cette seule vérification. Par défaut20 s.- DISPATCH_WAKE_INTERVAL
(durée, facultative) Écart minimal entre deux
NOTIFYs annonçant à pepsi-dispatch(1) que du nouveau courrier est arrivé. Vaut5 mspar défaut ;0désactive le regroupement et notifie une fois par message accepté.L’ingress ne notifie pas depuis la transaction qui stocke le message. PostgreSQL détient un verrou à l’échelle de la base depuis l’instant où une transaction met une notification en file jusqu’à sa validation : les transactions notifiantes ne peuvent donc pas valider en groupe — sous charge concurrente elles se sérialisent, chacune payant sa propre purge disque. Les admissions sont donc notifiées hors bande, une fois par intervalle, après que les lignes ont été validées ; comme le dispatcher répond à tout réveil par un balayage complet de la file, une seule notification sert un nombre arbitraire de messages nouvellement acceptés.
La limite est traînante : le premier réveil après une période d’inactivité est envoyé immédiatement, de sorte qu’un message isolé n’est pas retardé du tout, et seules les notifications derrière lui sont fusionnées. L’augmenter réduit les notifications sous charge soutenue, au prix d’un peu de latence de file dans le pire cas ; il y a rarement une raison de le faire.
- MILTERS
(facultatif) Les milters consultés pendant la session SMTP, par les noms de leurs sections
[pepsi-ingress-milter-*], séparés par des espaces ou des virgules, dans l’ordre où ils sont interrogés. S’applique à chaque écouteur qui n’est pas un écouteur de soumission ; le MILTERS propre à une section d’écouteur le remplace pour cet écouteur.none(la valeur par défaut) n’en consulte aucun. Voir Les sections [pepsi-ingress-milter-*] ci-dessous et pepsi-ingress(1), Milters.
L’identité et l’algorithme de scellement ARC sont configurés dans la section partagée [pepsi] (ARC_DOMAIN et ARC_ALGORITHM) ci-dessus et utilisés par pepsi-stage-arc(1), pas par l’ingress.
95.2.1.1.15. Les sections [pepsi-ingress-listener-*]¶
Chaque section dont le nom commence par pepsi-ingress-listener- définit une socket d’écoute. Le suffixe est un nom de forme libre utilisé dans les messages de journal, par exemple [pepsi-ingress-listener-mx]. Déclarez autant d’écouteurs que nécessaire.
- SERVE
(obligatoire) Le type de socket à lier. L’un de :
tcpLier une socket TCP. Nécessite BIND_TO et PORT.
unixLier une socket de domaine UNIX. Nécessite UNIXPATH ; honore UNIXPATH_MODE et UNIXPATH_GROUP.
systemdAdopter une socket passée par un parent systemd via l’activation par socket ; voir FD_INDEX.
- BIND_TO
(chaîne) Adresse IP sur laquelle écouter lorsque
SERVE = tcp, par exemple0.0.0.0ou::. Requis pourtcp.- PORT
(nombre) Port TCP sur lequel écouter lorsque
SERVE = tcp. Requis pourtcp.- UNIXPATH
(chemin) Chemin de système de fichiers de la socket lorsque
SERVE = unix. Requis pourunix.- UNIXPATH_MODE
(mode unix, facultatif) Bits de permission de la socket de domaine UNIX, en octal. Par défaut
660.- UNIXPATH_GROUP
(chaîne, facultative) Groupe vers lequel la socket de domaine UNIX est
chgrp-ée après la liaison (le propriétaire est inchangé). Combiné avec le mode0660par défaut, cela permet à un pair spécifique d’atteindre la socket tout en restant non accessible à tous — utilisé lorsque pepsi-httpd s’exécute derrière un serveur web frontal (par exemplewww-data) qui lui fait un reverse-proxy. Le groupe doit exister ; un groupe inconnu est une erreur de démarrage.- FD_INDEX
(nombre, facultatif) Index basé sur zéro du descripteur de fichier passé par systemd à adopter lorsque
SERVE = systemd. L’index0est le premier descripteur (SD_LISTEN_FDS_START). Par défaut0.C’est une position, non un nom : elle compte les entrées
ListenStream=de l’unité.socketpropriétaire, de sorte qu’en insérer une renumérote chaque écouteur suivant tandis qu’en ajouter une à la fin n’en renumérote aucun. L’unité et ces sections sont deux moitiés d’une même affirmation et rien ne vérifie leur accord au moment de la configuration : une discordance est donc signalée là où les descripteurs se trouvent réellement — le serveur journalise un avertissement au démarrage nommant chaque index qu’aucun écouteur n’a revendiqué. Prenez cet avertissement au sérieux : une socket sur laquelle le serveur n’accepte jamais est pire qu’une socket absente, car systemd met tout de même la connexion en file et le client bloque jusqu’à l’expiration de son propre délai de lecture au lieu d’être refusé aussitôt.Un descripteur peut être une socket de domaine UNIX aussi bien qu’une socket TCP ; c’est l’unité qui décide lequel des deux, non ce fichier. Les options qui dépendent de la famille de la socket sont donc résolues une fois le descripteur en main plutôt que pendant l’analyse : AUTH_PEERCRED doit être énoncé explicitement (il ne peut être déduit comme il l’est pour
SERVE = unix), et un écouteur SUBMISSION en clair qui se révèle avoir hérité d’une socket réseau fait refuser le démarrage à pepsi-ingress(1) plutôt que de porter des identifiants en clair.- MODE
(facultatif) Sécurité du transport de l’écouteur. L’une de :
plainEn clair uniquement ;
STARTTLSn’est pas annoncé. C’est le défaut.tlsTLS implicite : la connexion est enveloppée dans TLS dès le premier octet (par exemple le port
submissions465). Nécessite TLS_CERT et TLS_KEY.starttlsEn clair pouvant être élevé avec la commande
STARTTLS. Nécessite TLS_CERT et TLS_KEY.
- TLS_CERT
(chemin) Fichier PEM contenant la chaîne de certificats serveur. Requis lorsque MODE est
tlsoustarttls— mais peut être omis, auquel cas pepsi-setup(1) remplit automatiquement le chemin certbot/etc/letsencrypt/live/<HOSTNAME>/fullchain.pemet peut obtenir le certificat (voir pepsi-setup(1) et son option –no-certbot).- TLS_KEY
(chemin) Fichier PEM contenant la clé privée pour TLS_CERT. Requis lorsque MODE est
tlsoustarttls; comme TLS_CERT, il peut être omis pour que pepsi-setup(1) le remplisse automatiquement (…/privkey.pem).- MYNETWORKS
(facultatif) Liste séparée par espaces/virgules de réseaux CIDR IPv4/IPv6 de confiance (une adresse nue est un hôte
/32ou/128). Une connexion depuis l’un de ceux-ci est authentifiée sans preuve supplémentaire, et peut relayer et envoyer au nom des adresses auxquelles SENDER_MAP de[pepsi-ingress]lie le réseau. Chaque entrée hors du loopback (127.0.0.0/8,::1) doit être couverte par une clé de réseau de SENDER_MAP, sinon pepsi-ingress refuse de démarrer etvalidatede pepsi-setup(1) échoue ; une entrée loopback est sans restriction. Vide par défaut. pepsi-setup(1) avertit au sujet d’une entrée plus large qu’un hôte unique qui n’est pas le loopback.- AUTH_PEERCRED
(facultatif, par défaut ``yes`` sur un écouteur ``SERVE = unix``, ``no`` ailleurs) Authentifier le client par les identifiants du pair de la socket UNIX rapportées par le noyau (
SO_PEERCRED) : l’identifiant d’utilisateur du processus qui se connecte est résolu en un login via la base passwd, et ce login est recherché dans USERNAME_MAP exactement comme le serait un nom d’utilisateur SASL. La session est alors authentifiée et porte une identité de soumission, de sorte que les règles de la RFC 6409 §6/§8.1 s’appliquent : un programme local ne peut utiliser qu’un expéditeur d’enveloppe et unFrom:auxquels son propre compte est associé, et un compte associé à aucune adresse est refusé.C’est le mécanisme qui sous-tend pepsi-sendmail(1) et la raison pour laquelle la socket peut sans risque être inscriptible par tous : pouvoir l’ouvrir ne décide en rien de l’identité sous laquelle vous pouvez envoyer. Contrairement à MYNETWORKS, qui fait confiance à une position réseau et laisse donc n’importe quel processus local envoyer au nom de n’importe qui, l’identité est ici fournie par le noyau et ne peut pas être falsifiée par le client.
Rejeté sur un écouteur
SERVE = tcp, où il n’y a pas d’identifiants de pair à lire. Réglez-le surnopour une socket locale non authentifiée (par exemple derrière un proxy) — mais un tel écouteur ne peut alors pas être en plus un écouteur SUBMISSION, puisque rien n’authentifierait.Avec
SERVE = systemd, elle est acceptée mais non déduite et doit donc être écrite explicitement : que le descripteur hérité soit une socket UNIX ou une socket TCP est une propriété de l’unité.socketet non de ce fichier, et lapepsi-ingress.socketlivrée passe les deux sortes. Si le descripteur se révèle être une socket TCP, l’option n’authentifie personne, carSO_PEERCREDn’y a aucun sens et chaque session reste anonyme. Cet échec est sûr mais silencieux, si bien que pepsi-ingress(1) avertit au démarrage en nommant l’écouteur.- SASL_TYPE
(facultatif) Backend SASL pour la commande
AUTH:none(par défaut) oudovecot.AUTH(mécanismesPLAINetLOGIN) n’est annoncé et accepté que sur une session protégée par TLS ; unAUTHen clair est refusé avec504 5.5.4(RFC 4954 §4 – le538de la RFC 2554 est obsolète), et unAUTHsur un écouteur sans backend avec503 5.5.1. Toute valeur autre quenonenécessite MODEtlsoustarttls.- SASL_PATH
(chemin) Chemin de la socket auth-client de Dovecot. Requis lorsque SASL_TYPE est
dovecot— il n’y a aucune valeur par défaut, et un écouteur qui demandedovecotsans elle échoue à l’analyse. Le chemin quepepsi-setuppropose,/run/dovecot/auth-client-pepsi, est un écouteur privé à Pepsi plutôt que la socketauth-clientpartagée de Dovecot : cette dernière est en0600 dovecotet inaccessible à l’utilisateur non privilégiépepsi-ingress, de sorte que la pointer vers elle donne un écouteur de soumission dont l”AUTHéchoue toujours avec une erreur de permission.pepsi-setup runsonde cette socket en tant qu’utilisateur du service et, si elle est absente ou illisible, propose d’installer un/etc/dovecot/conf.d/10-pepsi.confqui ajoute un écouteur dédié possédé parpepsi-ingress(ou l’affiche pour que vous le déployiez).- TLS_AUTH_CLIENT
(facultatif) Liste séparée par espaces/virgules de hachages SHA-256 (64 caractères hex) du
SubjectPublicKeyInfoDER de clés clientes autorisées. Lorsqu’elle est définie, l’écouteur demande un certificat client : une session est authentifiée si le hachage de la clé de la feuille présentée est listé et que SENDER_MAP de[pepsi-ingress]lie cette empreinte aux adresses au nom desquelles elle peut envoyer ; l’empreinte est la clé, et le certificat qui l’entoure n’est pas consulté. Un hachage qui nomme une CA de la chaîne présentée n’autorise rien (une CA va dans TLS_AUTH_CLIENT_CA, dont les contraintes peuvent être vérifiées). Un certificat non reconnu n’interrompt pas la poignée de main. Un certificat n’est demandé qu’à un client capable de négocier TLS 1.3 (voir TLS_AUTH_CLIENT_TLS12). Nécessite MODEtlsoustarttls. Calculez un hachage avecopenssl x509 -in cert.pem -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256.- TLS_AUTH_CLIENT_CA
(chemin, facultatif) Fichier PEM de certificats de CA dont les certificats clients authentifient. Un certificat présenté est accepté lorsqu’il construit un chemin RFC 5280 complet vers l’un d’eux (validité,
basicConstraintset longueur de chemin, y compris celle de la CA elle-même, usage de clé, contraintes de nom et de politique, force de la clé) ; lorsqu’il porte unextendedKeyUsagenommantid-kp-clientAuthet le bitdigitalSignature; lorsqu’il n’est pas révoqué et que chaque certificat du chemin qui nomme un point de distribution est couvert par une liste à jour (les listes que pepsi-keydisc(1) conserve danspepsi.crl_cache; sans liste disponible, le certificat n’est pas accepté, et un écouteur de soumission répond451 4.7.0auMAIL FROMjusqu’à ce que la liste soit récupérée) ; et lorsque SENDER_MAP de[pepsi-ingress]lie le hachage de clé de la CA (journalisé au démarrage) aux adresses au nom desquelles ses certificats peuvent envoyer. Un certificat qui nomme une boîte aux lettres est confiné à celles de ses boîtes aux lettres que la liaison permet. Chaque certificat du fichier doit être une CA actuellement valide autorisée à signer des certificats, sinon la configuration est refusée. Nécessite MODEtlsoustarttls. Voir pepsi-ingress(1), Certificats clients.- MILTERS
(facultatif) Les milters que cet écouteur consulte pendant la session SMTP, séparés par des espaces ou des virgules, dans l’ordre ;
nonen’en consulte aucun. Sans valeur, un écouteur qui n’est pas un écouteur de soumission exécute[pepsi-ingress] MILTERSet un écouteur de soumission (la socket de soumission locale comprise) n’en exécute aucun. Un nom sans section[pepsi-ingress-milter-*]empêche l’ingress de démarrer.- TLS_AUTH_CLIENT_TLS12
(booléen, facultatif, par défaut ``no``) Sur un écouteur avec TLS_AUTH_CLIENT ou TLS_AUTH_CLIENT_CA, un certificat client n’est demandé que lorsque le client propose TLS 1.3, qui chiffre le certificat ; TLS 1.2 l’envoie en clair, et avec lui la personne ou l’appareil qu’il nomme. Un client TLS 1.2 est tout de même servi, sans demande de certificat (journalisé en
info), de sorte qu’il peut s’authentifier par SASL ou pas du tout.yesdemande le certificat sous TLS 1.2 aussi, pour un appareil qui ne parle rien de plus récent.- SUBMISSION
(facultatif, par défaut ``no``) Lorsque
yes, l’écouteur est un agent de soumission de messages RFC 6409 : l’authentification devient obligatoire (unMAIL FROMnon authentifié est refusé avec530 5.7.0), et chaque message accepté reçoit les corrections de soumission — unDate:et unMessage-ID:manquants sont ajoutés. Nécessite au moins un mécanisme d’authentification (SASL_TYPE, TLS_AUTH_CLIENT, TLS_AUTH_CLIENT_CA, MYNETWORKS ou AUTH_PEERCRED) ; un écouteur de soumission qui n’en a aucun est rejeté. Laissez-le désactivé pour un écouteur MX (port 25). Un écouteur de soumission omet aussi par défaut le client soumissionnaire de l’en-tête de trace (RECEIVED_PRIVACY).Un MODE TLS est également requis, sauf sur un écouteur
SERVE = unix(ou un écouteurSERVE = systemdqui hérite d’une socket UNIX, vérifié au démarrage) : une socket de système de fichiers n’a aucun transport qu’un attaquant pourrait observer ou sur lequel il pourrait s’interposer, et son authentification vient du noyau plutôt que du réseau, de sorte qu’y exiger un certificat ne protégerait rien.- RECEIVED_PRIVACY
(facultatif, par défaut : la valeur de **SUBMISSION*)* Lorsque
yes, l’en-tête de traceReceived:écrit pour chaque message accepté sur cet écouteur ne porte aucune clausefrom, et les champs d’en-têteUser-AgentetX-Mailerdu client sont retirés. L’en-tête ne contient alors ni l’adresse IP et le nom inverse du client, ni le nom qu’il a annoncé dansEHLO, qui est généralement le nom de la machine de l’utilisateur. Chaque destinataire, et chaque archive de liste, apprendrait sinon l’adresse et le logiciel du soumissionnaire à partir d’un message qu’il a envoyé ; c’est la convention respectueuse de la vie privée de draft-josefsson-email-received-privacy, que suivent les grands fournisseurs pour la soumission. La clauseby, le mot-clé de protocole RFC 3848, les paramètres TLS, la clauseforet la date restent, de sorte que la détection de boucles (MAX_SELF_HOPS, qui compte la clauseby) et la trace du transport ne sont pas affectées, et le journal de pepsi-ingress(1) consigne toujours le client pour le traitement des abus. Activé par défaut pour un écouteur de soumission, la socket de soumission locale implicite comprise ; désactivé pour un écouteur MX, où la trace d’un pair distant est ce dont a besoin le traitement des abus au saut suivant. Définissez-le explicitement pour inverser l’un ou l’autre cas.
Une session acceptée par l’un de MYNETWORKS, AUTH_PEERCRED, SASL AUTH ou un certificat client (TLS_AUTH_CLIENT, TLS_AUTH_CLIENT_CA) est enregistrée avec state.local_origin = true (sinon false) et peut relayer vers n’importe quel domaine, pas seulement les domaines servis.
95.2.1.1.16. Les sections [pepsi-ingress-exchange-online-*]¶
Chaque section dont le nom commence par pepsi-ingress-exchange-online- nomme un locataire Microsoft 365 (Exchange Online) dont cet hôte relaie le courrier sortant, par exemple [pepsi-ingress-exchange-online-example]. Le suffixe est un nom libre, employé dans les messages de journal et enregistré dans state.exchange_tenant.
Exchange Online envoie par un connecteur sortant vers le port 25, depuis des adresses que tous les clients Microsoft 365 partagent, et ne peut pas s’authentifier auprès du smarthost. MYNETWORKS ne peut pas distinguer ce locataire d’un autre, et laisserait donc chaque client envoyer au nom des domaines servis. À la place, un client situé dans SENDER_NETWORKS dont l’expéditeur d’enveloppe est vide ou dans l’un des DOMAINS peut nommer des destinataires hors des domaines servis sur un écouteur MX (un écouteur qui n’est pas de soumission). À la fin des données, le message n’est relayé que si toutes les conditions suivantes sont remplies ; sinon il est refusé avec 550 5.7.1 :
l’en-tête porte exactement un champ
X-MS-Exchange-CrossTenant-Id, et sa valeur est TENANT_ID. Exchange Online ajoute ce champ à chaque message, en y nommant le locataire qui l’envoie, mais il conserve une copie écrite par l’expéditeur ; un message d’un autre locataire qui revendique celui-ci en a donc deux ;le message a exactement une boîte aux lettres
From:, dans l’un des DOMAINS ;une signature DKIM de ce domaine
From:a été vérifiée. Cela exige que la signature DKIM du domaine soit activée dans Microsoft 365 (les enregistrementsselector1etselector2).
Un message prouvé est dès lors traité comme une soumission (state.local_origin = true, state.origin.auth_method = exchange-online). Il ne parle pas au nom de son adresse From: : il ne peut donc ni enregistrer ni gérer de clés par e-mail. Le courrier que le locataire transfère pour un expéditeur extérieur ne porte aucune signature des domaines du locataire et n’est pas relayé. Un message dont tous les destinataires sont dans des domaines servis est du courrier entrant ordinaire et n’a besoin d’aucune preuve.
- TENANT_ID
(obligatoire) L’identifiant du locataire, tel que l’affiche le centre d’administration Microsoft Entra (huit, quatre, quatre, quatre et douze chiffres hexadécimaux).
- DOMAINS
(obligatoire) Les domaines au nom desquels le locataire peut envoyer, séparés par des espaces ou des virgules. Chacun doit faire partie de
[pepsi-ingress] ACCEPTED_DOMAINS.- SENDER_NETWORKS
(facultatif) Les réseaux d’où arrive le courrier du locataire, séparés par des espaces ou des virgules. La valeur par défaut est la liste des adresses sortantes d’Exchange Online que Microsoft publie dans l’enregistrement SPF
spf.protection.outlook.com:40.92.0.0/15,40.107.0.0/16,52.100.0.0/15,52.102.0.0/16,52.103.0.0/17,104.47.0.0/17,2a01:111:f400::/48,2a01:111:f403::/49,2a01:111:f403:8000::/51,2a01:111:f403:c000::/51et2a01:111:f403:f000::/52. La preuve repose sur cette liste : seul le courrier qui arrive réellement d’Exchange Online porte le champ de locataire qu’écrit Microsoft ; n’ajoutez donc jamais une adresse depuis laquelle quelqu’un d’autre peut envoyer.
95.2.1.1.17. Les sections [pepsi-ingress-milter-*]¶
Chaque section dont le nom commence par pepsi-ingress-milter- nomme un milter (un filtre de courrier parlant le protocole milter de sendmail/Postfix) que pepsi-ingress(1) consulte pendant la session SMTP, par exemple [pepsi-ingress-milter-greylist]. Le suffixe est le nom que liste MILTERS. Comme le milter répond alors que le client est encore connecté, son refus est la réponse SMTP : un refus 5xx est signalé par le MTA expéditeur à son propre utilisateur, et un refus 4xx est réessayé par celui-ci, et c’est ainsi que fonctionne le greylisting. Rien n’est accepté qui devrait plus tard faire l’objet d’un rebond. La façon dont la session est présentée à un milter, et ce que fait chaque verdict, sont décrits dans pepsi-ingress(1), Milters. Un milter qui s’exécute après l’acceptation du message est plutôt une étape pepsi-stage-milter (pepsi-stage-milter(1)), qui voit le message après le déchiffrement.
- SOCKET
(requis) Où le milter écoute, dans la syntaxe qu’emploient
S=de sendmail etsmtpd_miltersde Postfix :unix:/path(oulocal:/path),inet:host:port,inet:port@hostouinet6:[address]:port.- MILTER_NAME
(facultatif) La valeur de la macro
{daemon_name}; vaut par défaut le suffixe de la section.- ALLOW_ACTIONS
(facultatif) Les modifications que le milter peut faire, comme pour pepsi-stage-milter(1) :
addhdrs,chghdrs,chgbody,addrcpt,addrcpt_par,delrcpt,chgfrom,quarantine, ouall/none. La valeur par défaut estaddhdrs chghdrs chgbody quarantine: tout ce dont un filtre de contenu a besoin, et aucune modification de l’enveloppe. Un milter qui a besoin d’une action qui ne lui a pas été proposée échoue à sa négociation, ce que traite alors ON_FAILURE, et le journal nomme l’action manquante. Un destinataire qu’ajoute un milter est soumis à la règle qui s’applique à toutRCPT: une adresse d’un domaine servi que quelque chose sur cet hôte accepterait, ou n’importe quelle adresse dans une session authentifiée ; tout le reste est abandonné et journalisé, de sorte qu’un filtre ne peut pas transformer l’hôte en relais ouvert.quarantinen’est proposé que lorsqu’une étape de quarantaine existe (QUARANTINE_STAGE). Certains filtres demandent plus qu’ils n’utilisent : rspamd, par exemple, demandeaddrcpt,delrcptetquarantineen plus des actions sur les en-têtes et le corps, et il est refusé sans elles.pepsi-setupécrit ce que demande un filtre détecté.- QUARANTINE_STAGE
(facultatif) L’étape à laquelle est stocké, au lieu de
init, un message que le milter met en quarantaine. La valeur par défaut est l’unique étape exécutant pepsi-stage-quarantine(1), lorsqu’il y en a exactement une ; sans une telle étape, la quarantaine n’est pas proposée au milter. Le message notestate.quarantine.reason(le texte du milter) etstate.quarantine.by(milter:<name>).- ON_FAILURE
(facultatif, par défaut ``accept``) Ce que coûte un milter injoignable, qui dépasse son délai ou qui enfreint le protocole :
acceptne le consulte plus pour le reste de la session, et le courrier est accepté comme s’il n’était pas configuré (journalisé, et compté dans la télémétrie) ;tempfailrépond à la commande en cours et à chaqueMAILultérieur de la session par451 4.7.1;rejectleur répond par550 5.7.1.acceptsuit la position qu’adopte l’ingress partout ailleurs : un filtre planté ne doit pas arrêter tout le courrier entrant. Choisisseztempfailpour un filtre dont le verdict ne doit jamais être sauté ; les MTA expéditeurs gardent alors le courrier jusqu’au retour du filtre.- CONNECT_TIMEOUT, COMMAND_TIMEOUT, CONTENT_TIMEOUT
(durées, facultatives, par défaut ``30 s``, ``30 s`` et ``300 s``) Comme pour pepsi-stage-milter(1) : connexion et négociation, attente de la réponse à une commande, et attente du verdict de fin de message (
SMFIR_PROGRESSrelance l’attente, jusqu’à dix fois le timeout). Le client SMTP attend aussi longtemps ; la RFC 5321 lui accorde dix minutes pour la réponse à la fin des données, gardez donc CONTENT_TIMEOUT bien en dessous.- PROTOCOL_VERSION
(facultatif, par défaut ``6``) La version la plus élevée du protocole milter qui est proposée.
- MACROS_CONNECT, MACROS_HELO, MACROS_MAIL, MACROS_RCPT, MACROS_DATA, MACROS_EOH, MACROS_EOM
(facultatif) Les macros envoyées à chaque phase, par défaut les listes de Postfix (
milter_connect_macroset les autres) ;nonen’en envoie aucune à cette phase. Un milter qui demande sa propre liste avecSMFIF_SETSYMLISTreçoit celle-ci à la place. L’ingress connaîtj,_,v,i(le jeton de la ligne sous laquelle le message sera stocké),{daemon_name},{daemon_addr},{if_addr},{if_name},{client_addr},{client_port},{client_name},{client_ptr},{tls_version},{cipher},{auth_type},{auth_authen},{auth_author},{auth_ssf},{mail_addr},{mail_host},{mail_mailer},{rcpt_addr},{rcpt_host}et{rcpt_mailer}; aucune autre n’est envoyée.
95.2.1.1.18. La section [pepsi-greylist]¶
Lue par pepsi-greylist(1), le milter de greylisting, par pepsi-status(1) et par pepsi-setup(1) validate. Chaque option et sa valeur par défaut sont décrites dans pepsi-greylist(1) : SOCKET, SOCKET_MODE, SOCKET_GROUP, DELAY, RETRY_WINDOW, PASSED_TTL, AUTO_WHITELIST_PASSES, AUTO_WHITELIST_TTL, IDENTITY, IPV4_MASK, IPV6_MASK, DNS_TIMEOUT, DNS_CACHE_TTL, DNS_SERVERS, EXEMPT_RECIPIENTS, RECIPIENT_DOMAINS, WHITELIST_BYPASS, WHITELIST_NAME (avec LOCAL_DOMAINS, RECIPIENT_DELIMITER et TARGETS, tels qu’une étape de whitelist les lit), BIG_SENDERS, SPF_BYPASS, REPLY, DB_POOL_SIZE et MAX_CONNECTIONS. Les durées peuvent y être écrites en jours et en semaines.
95.2.1.1.19. Les sections [pepsi-greylist-senders-*]¶
Une section par groupe d’expéditeurs jamais soumis au greylisting, [pepsi-greylist-senders-NAME], avec DOMAINS (le domaine d’identité du client ou son nom PTR confirmé par résolution directe), NETWORKS (l’adresse du client) et ENABLED. Les groupes livrés se trouvent dans ${DATADIR}/config.d/greylist.conf ; voir pepsi-greylist(1).
95.2.1.1.20. La section [pepsi-reputation]¶
Lue par pepsi-reputation(1), qui télécharge les listes de blocage d’IP par rapport auxquelles le courrier entrant est vérifié et vérifie si cet hôte figure sur l’une d’elles, et par pepsi-setup(1).
- CACHE_DIR
(chemin, facultatif) L’endroit où rsync conserve sa copie de chaque liste rsync, afin que le téléchargement suivant ne transfère que la différence. Par défaut
/var/lib/pepsi-reputation, le répertoire d’état depepsi-reputation-iplists.service.- CHECK_IP_ZONES
(chaîne, facultative) Les listes de blocage DNS que
pepsi-reputation checkinterroge au sujet des propres adresses de cet hôte. Par défautzen.spamhaus.org bl.spamcop.net b.barracudacentral.org psbl.surriel.com bl.mailspike.net dnsbl-1.uceprotect.net ix.dnsbl.manitu.net;nonen’en interroge aucune.- CHECK_DOMAIN_ZONES
(chaîne, facultative) Les listes de blocage de domaines qu’il interroge au sujet des domaines servis. Par défaut
dbl.spamhaus.org multi.surbl.org.- CHECK_ADDRESSES
(chaîne, facultative) Adresses à vérifier en plus du
PUBLIC_IPde chaque étapepepsi-stage-relay-to-internetet des adresses de[pepsi-ingress] HOSTNAME.- GOOGLE_SITE_VERIFICATION
(chaîne, facultative) Paires
DOMAIN:TOKEN, les jetons que Gmail Postmaster Tools délivre par domaine. pepsi-setup(1) affiche chacun comme un enregistrement TXTgoogle-site-verification=TOKENpour le domaine et vérifie qu’il est publié.
95.2.1.1.21. Les sections [pepsi-reputation-list-*]¶
Une section par liste de blocage d’IP, [pepsi-reputation-list-NAME] ; NAME est fait de lettres minuscules, de chiffres et de -. pepsi-reputation iplists update télécharge chaque liste activée en entier dans la base de données ; pepsi-ingress(1) y recherche le client de chaque session non authentifiée, note les listes qui le nomment sous state.origin.ip_blocklist (voir pepsi.state(7)) et, pour une liste avec ACTION = reject, refuse les destinataires de la session. Aucun opérateur de liste n’est interrogé au sujet d’un client pendant qu’il est connecté.
${DATADIR}/config.d/reputation.conf définit spamhaus-drop-v4, spamhaus-drop-v6 et blocklist-de-mail (activées) et uceprotect-1 (rsync, désactivée), toutes avec ACTION = mark. Modifiez l’une de leurs options en nommant la section dans pepsi.conf ; la définition ultérieure l’emporte option par option.
- URL
(chaîne)
https://…, oursync://HOST/MODULE/FILE(un fichier, en ASCII imprimable). Obligatoire, sauf dans la section d’une liste livrée, où elle et FORMAT prennent par défaut les valeurs livrées, de sorte qu’une section qui ne définit queENABLEDfonctionne même là oùconfig.dn’est pas installé. Une liste rsync a besoin du programmersync, une dépendance facultative : sur un hôte qui en est dépourvu, la liste n’est pas utilisée, ses entrées sont supprimées, et pepsi-setup(1) avertit.- FORMAT
(chaîne, facultative)
ip-list(par défaut) : une entrée par ligne, comme dans les jeux de donnéesip4set/ip6triede rbldnsd ou une simple liste d’adresses – une adresse, un réseau, une plage (a.b.c.d-e.f.g.houa.b.c.d-h) ou la forme courte de rbldnsd (a.b.cpour un /24), une exclusion précédée de!.spamhaus-drop: les lignes JSON de Spamhaus DROP. Les entrées plus larges qu’un /8 (IPv4) ou un /16 (IPv6) sont abandonnées, et un fichier dont plus d’un dixième n’est pas fait d’entrées est refusé.- ENABLED
(booléen, facultatif) Si la liste est téléchargée et consultée. Par défaut
YES.- ACTION
(chaîne, facultative)
mark(par défaut) note l’inscription pour le pipeline ; pepsi-stage-if(1) peut router selonorigin.ip_blocklist.listedouorigin.ip_blocklist.lists.NAME.rejectrefuse aussi les destinataires avec554 5.7.1, sauf<postmaster>.- MIN_INTERVAL
(durée, facultative) Le temps minimal entre deux téléchargements de la liste. Par défaut
45 m. Les opérateurs de listes bloquent les hôtes qui téléchargent trop souvent (UCEPROTECT : plus de quatre fichiers par heure).- MAX_AGE
(durée, facultative) Combien de temps après sa dernière vérification réussie l’ingress consulte encore la liste. Par défaut
12 h. Une liste plus ancienne est traitée comme inconnue, ce qui admet le courrier et ne note rien.- MAX_SIZE
(entier, facultatif) Le plus grand fichier de liste accepté, en octets. Par défaut 67108864 (64 Mio).
95.2.1.1.22. Le pipeline d’étapes et les sections [stage-*]¶
Après l’ingress, un message est avancé par une chaîne de programmes d’étape. pepsi-dispatch(1) revendique une ligne pending, la met running et remet l’identifiant du message à un processus worker persistant de cette étape. Le worker est démarré comme PROGRAM [-c FILE] worker, lit les identifiants sur son entrée standard, un par ligne, et répond à chacun par une ligne de statut ; il fait son travail et fait avancer la ligne (ou la termine). Il n’y a pas d’invocation par identifiant positionnel : un PROGRAM qui est un script enveloppe doit donc transmettre ses arguments et son entrée standard. Les nouveaux messages entrent à l’étape initiale, [stage-init], qui doit exister.
Chaque section dont le nom commence par stage- décrit une étape. Le suffixe est le nom de l’étape, par exemple [stage-init]. Le nom de l’étape est un label choisi par l’opérateur, indépendant du binaire qu’elle exécute.
- PROGRAM
(chaîne, obligatoire) Le binaire d’étape à exécuter, par exemple
pepsi-stage-relay-to-smarthost. Il est localisé sur lePATHsauf s’il est donné comme un chemin absolu. Le même binaire peut servir plusieurs étapes (il lit ses options depuis la section où le message se trouve actuellement).- NEXT_STAGE
(chaîne, facultative) L’étape vers laquelle un message avance en cas de succès. En son absence, une étape terminale réussie supprime le message.
- BOUNCE_STAGE
(string, optional) The stage to which a message is routed so that a delivery-status notification is generated. For delivery stages (pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-internet(1)) and pepsi-stage-discard(1) it receives a permanently-failed (non-bounce) message for a bounce, and — when
[pepsi]ORIGINATE_SUCCESS_DSNis enabled — a successfully-delivered message for a positive report. With none, a permanently-failed message is markedfailed(delivery stages) or simply dropped (pepsi-stage-discard(1)).- PARALLELISM
(nombre, facultatif) Borne supérieure du nombre de processus workers concurrents que pepsi-dispatch(1) exécute pour cette étape. Les workers sont démarrés à la demande et arrêtés à l’inactivité, c’est donc un plafond, pas une taille de pool fixe. Chaque worker détient une connexion de base de données, de sorte que cela borne aussi la part de l’étape dans le budget de connexions (voir la note
[pepsi-postgres]ci-dessus). Par défaut 4. Le dispatcher abaisse temporairement une étape en dessous de cette valeur lorsque la base de données rapporte que sa limite de connexions est épuisée (voir pepsi-dispatch(1)).- MAX_RUNTIME
(durée, facultative) Temps réel maximal qu’un worker de cette étape peut consacrer à un seul message. Elle remplace
[pepsi-dispatch] MAX_RUNTIMEpour cette étape, afin qu’un saut lent obtienne du temps sans relâcher toutes les autres étapes. Les étapespepsi-stage-relay-to-*terminent une remise un peu plus tôt, d’un dixième de ce temps (entre 1 s et 30 s), pour garder le temps d’en stocker le résultat : les réponses déjà lues restent valables, et le reste est différé comme tout échec transitoire. pepsi-setup(1) refuse un CONNECT_TIMEOUT, COMMAND_TIMEOUT ou DATA_TIMEOUT qui ne tient pas dans ce temps, y compris s’il est laissé à sa valeur par défaut.- MAX_MESSAGES
(nombre, facultatif) Nombre de messages qu’un worker de cette étape traite avant que le dispatcher ne le retire et démarre un nouveau processus (bornant la croissance de la mémoire). Par défaut 1000.
- QUEUE_LIMIT
(number, optional) Upper bound on the number of messages pepsi-dispatch(1) pipelines to a single worker process of this stage at once. The worker still processes them strictly one at a time, but having the next ids already queued on its standard input removes a coordinator round-trip per message, so the stage’s total in-flight capacity is
QUEUE_LIMIT × PARALLELISM. Because the worker count (and thus the connection budget) is unchanged, raising this gains throughput without spending more database connections, at the cost of a little head-of-line latency (a message can wait behind a slower pipelined sibling on the same worker); lower it (e.g. to1) for a stage whose per-message work is long and uneven, such as a network relay. Default 4.- MAX_LIFETIME
(durée, facultatif) Combien de temps un message peut continuer à échouer à cette étape avant que le worker n’abandonne, compté à partir de sa mise en file (pour un DSN, à partir du moment où pepsi-stage-bounce(1) l’a construit). Cela vaut pour toute erreur que l’étape ne marque pas comme permanente, c’est-à-dire une défaillance de l’hôte plutôt que du message, comme une configuration de résolveur illisible, un helper qui ne peut être démarré ou un modèle qui ne peut être lu. Jusque-là, le message est mis en pause et réessayé, après une minute puis deux fois plus longtemps à chaque fois, jusqu’à une heure, avec l’erreur dans
state.last_error. Il est ensuite réacheminé vers le BOUNCE_STAGE de cette étape, ou mis en échec s’il n’y en a pas ou si le message est la copie d’une contribution de liste destinée à un membre (voir pepsi-dispatch(1)). Les étapes de remise et pepsi-stage-milter(1) lisent la même option pour leurs propres réessais. Par défaut120 h.- FUSION =
yes|no (facultatif) Si une étape prédécesseur peut exécuter cette étape dans son propre processus worker au lieu d’écrire la ligne
pendinget d’attendre que le dispatcher la revendique (fusion d’étapes ; voir[pepsi] ALLOW_FUSIONci-dessus et pepsi-dispatch(1)). La fusion n’a lieu que lorsqu’elle est aussi activée globalement, que le PROGRAM de cette étape est plié dans le binairepepsiunifié, et que cette étape n’a besoin d’aucune colonne de message que le prédécesseur n’a pas déjà chargée. Lorsque l’une de ces conditions ne tient pas, la fusion est refusée et l’avancement retombe sur un saut dispatché normal, ce qui est toujours sûr. Par défautnopour tout programme sauf les étapes rapides de routage et de classification sans corps, pour lesquelles la valeur par défaut estyes: pepsi-stage-if(1), pepsi-stage-discard(1), pepsi-stage-srs(1), pepsi-stage-check-whitelist(1), pepsi-stage-auto-whitelist(1), pepsi-stage-block-language(1), pepsi-stage-list(1), pepsi-stage-edit-settings(1) (qui est sans corps pour tout message qui n’est pas un message de contrôle, c’est-à-dire pratiquement tous), pepsi-stage-dmarc-report(1) (sans corps pour tout courrier qui n’est pas adressé à son adresse de rapports) et pepsi-stage-defang(1) (sans corps pour chaque destinataire qui ne l’a pas activée). Deux d’entre elles ont besoin du bloc d’en-têtes plutôt que de la seule enveloppe, si bien que chacune ne fusionne que dans un prédécesseur qui l’a déjà chargé : pepsi-stage-block-language(1), dont le cheminENFORCEMENT = softréécrit leSubject:, et pepsi-stage-check-whitelist(1), qui litList-Id:. Lister un programme ici ne fixe que la valeur par défaut de son optionFUSION; qu’une paire donnée puisse effectivement fusionner se décide par paire, à l’exécution.
Les options restantes dans une section [stage-<name>] dépendent de son PROGRAM. Les sous-sections ci-dessous documentent les options que chaque programme d’étape lit depuis sa propre section ; une section ne lit que les clés listées pour son PROGRAM plus les clés générales ci-dessus.
Certains programmes font exception et sont documentés uniquement dans leurs propres pages de manuel, car leurs ensembles d’options sont vastes et changent avec le mécanisme de remise qu’ils pilotent : pepsi-stage-relay-to-maildir(1) (dont SERVER_NAME est obligatoire — l’étape refuse de démarrer sans lui — plus HELPER, UNKNOWN_MAILBOX_STAGE, QUOTA_LIMIT_STAGE, la famille RETRY_*, MAX_LIFETIME et les options de localité LOCAL_DOMAINS, TARGETS et RECIPIENT_DELIMITER), pepsi-stage-relay-to-lmtp(1) (SOCKET ou HOST/PORT, TLS, TLS_VERIFY, TLS_CA, TLS_CLIENT_CERT/TLS_CLIENT_KEY, AUTH, USERNAME, PASSWORD, SERVER_NAME, QUOTA_LIMIT_STAGE, SIEVE_REJECT_STAGE, UNKNOWN_MAILBOX_STAGE, LOCAL_DOMAINS, NOTIFY_STAGE, les délais et la famille RETRY_* avec MAX_LIFETIME et DELAY_DSN_AFTER), pepsi-stage-dot-forward(1) (HELPER, RESTART_STAGE, ALLOW_PIPE, ALLOW_FILE et les options de localité) et les étapes de listes de diffusion pepsi-stage-list(1) (POST_STAGE, COMMAND_STAGE), pepsi-stage-list-post(1) (DELIVERY_STAGE, RESPONSE_STAGE, REMOVE_DKIM_HEADERS, SITE_HEADER_MATCH_CHAIN, SENDER_POSTS_PER_HOUR, MAX_HELD_MESSAGES), pepsi-stage-list-deliver(1), pepsi-stage-list-command(1) (RESPONSE_STAGE, MAX_COMMAND_LINES, REQUIRE_AUTHENTICATED) et pepsi-stage-list-bounce(1) (RESPONSE_STAGE), dont les options valables pour tout le site se trouvent dans [pepsi-list] ci-dessous. Tout ce que cette page dit de [stage-<name>] en général leur reste applicable. Les sections partagées sur lesquelles ces programmes s’appuient aussi sont documentées ailleurs sur cette page : [pepsi] (identité de signature), [pepsi-srs] (le moteur SRS), [pepsi-payments] (le backend marchand) et les sections smarthost [pepsi-stage-relay-to-smarthost-mta-*].
95.2.1.1.22.1. Options de pepsi-stage-arc¶
Une étape avec PROGRAM = pepsi-stage-arc lit, outre un NEXT_STAGE obligatoire, ses paramètres DNS et les paramètres de signature de l’ensemble ARC qu’elle ajoute (ceux-ci s’appliquent à l’ARC-Message-Signature ; l’ARC-Seal est toujours canonicalisé en relaxed sur un ensemble d’en-têtes fixe, conformément à la RFC 8617) :
- DNS_SERVERS
(chaîne, facultative) Résolveurs, dans la syntaxe de
[pepsi] DNS_SERVERS, pour les recherches de clés qui valident la chaîne ARC entrante (SPF, DKIM et DMARC ont été vérifiés par pepsi-ingress(1) et ne sont pas réexécutés ici). Lorsqu’il n’est pas défini,[pepsi] DNS_SERVERSs’applique, et à défaut leresolv.confdu système.- DNS_TIMEOUT
(durée, facultative) Délai DNS par requête. Par défaut
[pepsi] DNS_TIMEOUT, sinon5 s.- HEADER_CANONICALIZATION
(``relaxed`` | ``simple``, facultatif) Canonicalisation des en-têtes de l’AMS (la moitié gauche de
c=). Par défautrelaxed.- BODY_CANONICALIZATION
(``relaxed`` | ``simple``, facultatif) Canonicalisation du corps de l’AMS (la moitié droite de
c=). Par défautrelaxed. ARC prend en charge toute combinaison des deux.- SIGNATURE_EXPIRATION_DAYS
(entier, facultatif) Lorsqu’il est réglé sur un nombre positif de jours, l’AMS porte une expiration (
x=) ce nombre de jours après la signature. Non réglé (le défaut) n’émet aucune expiration. L’ARC-Seal n’a pas de balisex=dans la RFC 8617 et n’en porte jamais, quoi que dise cette option.- SIGNED_HEADERS
(chaîne, facultative) Liste séparée par espaces/virgules des en-têtes que couvre l’AMS (
h=). Doit inclureFrom. Par défaut, l’ensemble intégré d’en-têtes d’origine et MIME plusDKIM-Signature, de sorte que les signatures DKIM dont l’AAR consigne les résultats ne puissent pas être retirées ou remplacées derrière le sceau. Chaque champ saufDKIM-Signatureest listé deux fois, de sorte qu’une copie ajoutée après le sceau casse l’ensemble.DKIM-Signatureest listé une fois et signé seulement sur un message qui en porte un : nommer un champ absent dansh=le sur-signerait, et une signature DKIM ajoutée après le sceau (parpepsi-stage-dkim-signsur un message réexpédié, par exemple) casserait alors l’ensemble.
L’identité et l’algorithme de signature ARC proviennent de la section partagée [pepsi] (ARC_DOMAIN, ARC_ALGORITHM) ; la clé est détenue, et le sceau signé, par pepsi-dkim(1). Le hachage est toujours SHA-256 ; l’algorithme de signature (a=) est l’unique choix [pepsi] ARC_ALGORITHM, puisque ARC permet une signature par saut.
95.2.1.1.22.2. Options de pepsi-stage-srs¶
Une étape avec PROGRAM = pepsi-stage-srs n’a besoin que d’un NEXT_STAGE dans sa propre section [stage-<name>] ; tous ses paramètres (SRS_DOMAIN, SECRET/SECRET_FILE, MAX_AGE_DAYS, ALLOW_ALIGNED_DOMAIN) résident dans la section partagée [pepsi-srs] documentée ci-dessus, de sorte qu’ils sont identiques au décodage inverse de l’ingress.
95.2.1.1.22.3. Options de pepsi-stage-encrypt¶
Une étape avec PROGRAM = pepsi-stage-encrypt signe le courrier soumis localement au nom de l’auteur de son From: et le chiffre pour chaque destinataire. Elle lit, outre un NEXT_STAGE obligatoire et un BOUNCE_STAGE facultatif :
Avertissement
Placez cette étape avant l’étape de signature DKIM, non après : … → encrypt → srs → dkim-sign → relay. DKIM doit signer les octets réellement transmis, et cette étape réécrit le corps. Signer d’abord produit du courrier qui a l’air valide mais dont la signature ne se vérifie pas. C’est pire qu’aucune signature, car une signature cassée est un signal négatif plus fort pour un destinataire qu’une signature absente. pepsi-setup(1) avertit lorsqu’il trouve une étape de signature DKIM qui mène à celle-ci.
Le péage à l’envoi et la détection de langue lisent tous deux le corps du message et veulent toutes deux du texte clair ; sur le chemin sortant elles s’exécutent avant cette étape, ce qui explique que le chiffrement vienne en dernier.
Chaque option ci-dessous est comportementale et redéfinissable par adresse via la table pepsi.settings (pepsi-settings(1)), indexée pour le courrier sortant sur l”expéditeur d’enveloppe. La politique cryptographique — algorithmes, permission de rétrograder, tailles de clé minimales — se trouve dans les options CRYPTO_* de [pepsi] et dans [pepsi-crypto], est réservée à l’administrateur système, et n’est délibérément pas atteignable d’ici.
- ENABLE_PEP
(booléen, facultatif) Se comporter comme le projet pretty Easy privacy (pEp) : chaque expéditeur local d’un domaine servi reçoit une clé à son premier message, le courrier est chiffré chaque fois que la clé d’un destinataire est connue ou découvrable, et la clé de l’expéditeur part avec chaque message.
YESpar défaut.Un préréglage de valeurs par défaut, et non un mode contraignant : il change la valeur par défaut de
SIGNenencrypted-onlyet active la création anticipée des clés. Toute option écrite explicitement l’emporte toujours. AvecENABLE_PEP = no,SIGNvaut par défautopportunisticet les clés ne sont créées que sur demande explicite (signer ou chiffrer) ou sousSIGN = always. La création anticipée requiert en outre[pepsi-crypto] AUTO_CREATE_IDENTITY(le veto de l’opérateur, qu’aucune redéfinition par adresse n’atteint) et unKEY_WRAP_SECRET, et n’a lieu que pour une adresse d’un domaine de[pepsi-ingress] ACCEPTED_DOMAINSqui n’a aucune lignecrypto_identityd’aucune sorte. Un utilisateur peut s’en retirer avecENABLE_PEP = nodans sa propre redéfinitionpepsi.settings, là oùEDITABLE_STAGESle permet. Aucun format de transmission pEp n’est produit : pas d’en-têteX-pEp-Version, pas d’enveloppement pEp 2.x, pas de trustwords et pas de synchronisation de clés. Voir pepsi-stage-encrypt(1).- SIGN
(``no`` | ``encrypted-only`` | ``opportunistic`` | ``always``, facultatif) S’il faut signer avec la clé de l’auteur du
From:.encrypted-onlypar défaut sousENABLE_PEP, sinonopportunistic.encrypted-onlyne signe qu’un message que cette étape chiffre, à l’intérieur du texte chiffré ; le courrier en clair porte la clé de l’expéditeur mais aucune signature, de sorte qu’un destinataire qui n’utilise pas la cryptographie ne voit jamais designature.asc. Une demande explicite (X-Pepsi-Sign: yes, un mot-clé[sign]dans l’objet) signe tout de même le texte en clair.opportunisticsigne lorsque l’auteur dispose de matériel utilisable, et envoie non signé sinon.alwayssigne de la même façon et fait en outre créer une identité pour un auteur qui n’en a pas, aux mêmes conditions que la création anticipée d”ENABLE_PEP(AUTO_CREATE_IDENTITY, unKEY_WRAP_SECRET, un domaine servi, aucune identité d’aucune sorte), sauf siX-Pepsi-Sign: noa refusé la signature. Aucune de ces valeurs n’est une garantie : un auteur que ce déploiement ne sert pas voit son courrier envoyé non signé plutôt que rebondi. Un message que le client soumetteur a déjà signé ne reçoit pas de seconde signature de Pepsi, et un message que le client a déjà chiffré est laissé entièrement tel quel.- ENCRYPT
(``no`` | ``opportunistic`` | ``required``, facultatif)
opportunisticpar défaut : chiffrer vers un destinataire dont nous avons une clé utilisable, et envoyer du courrier ordinaire à celui dont nous n’en avons pas.requiredsignifie qu’un destinataire sans clé utilisable reçoit le lien sécurisé ou un rebond, jamais du texte clair.- PREFER
(``openpgp`` | ``smime``, facultatif) Le protocole à privilégier lorsqu’un correspondant a des clés utilisables des deux sur le même échelon de l’échelle de confiance. Une clé mieux classée de l’autre protocole l’emporte toujours, de sorte qu’une clé récoltée dans du courrier non signé ne l’emporte jamais sur le certificat de l’autre protocole provenant d’un annuaire, de DANE, de l’opérateur ou d’un message authentifié. Par défaut
openpgp;pgpest accepté comme synonyme.- ON_NO_KEY
(``cleartext`` | ``secure-link`` | ``bounce``, facultatif) Ce qui arrive à un destinataire sans clé utilisable. Valeur par défaut dérivée d’ENCRYPT :
cleartextpourno/opportunistic, et pourrequiredsoitsecure-link(lorsqueSECURE_LINK_STAGEest réglé) soitbounce. Le régler explicitement redéfinit cela — sauf qu’un message dont la propre demande a élevé la politique àrequiredne retombe jamais surcleartext.Prudence
ON_NO_KEY = cleartextconjugué à[pepsi] CRYPTO_ALLOW_DOWNGRADE = noenvoie du texte en clair à un correspondant qui ne sait pas lire un conteneur authentifié. C’est strictement pire que le SEIPDv1+MDC ou l”EnvelopedDataAES-256-CBC que l’option visait à éviter. L’essentiel du parc OpenPGP installé (GnuPG 2.4 et antérieurs) est dans ce cas, de même que chaque correspondant S/MIME dont l’enregistrement de capacités dit qu’il ne sait pas lireAuthEnvelopedData. pepsi-setup(1) avertit sur cette paire. Laissez l’option à sa valeur par défautnegotiate, qui rétrograde plutôt que de refuser, et seulement lorsque la propre clé du destinataire (OpenPGP) ou son enregistrement de capacités (S/MIME) montre qu’il le faut.- ON_OVERSIZE
(``cleartext`` | ``secure-link`` | ``bounce``, facultatif) Ce qui arrive à un message plus grand que
MAX_SIZE. Valeurs par défaut exactement comme pourON_NO_KEY, de sorte querequiredne devienne pas du texte clair parce qu’une pièce jointe était volumineuse.- PADDING
(booléen, facultatif) Remplir ce que chiffre cette étape jusqu’à une longueur Padmé, de sorte que la taille du texte chiffré en dise moins sur le message : un observateur n’apprend la longueur qu’à une tranche près, qui croît avec elle, pour au plus 12 % de surcoût. Dans un conteneur SEIPDv2, il s’agit d’un paquet de remplissage RFC 9580 après la signature ; SEIPDv1 et S/MIME, qui n’ont pas de remplissage qu’un lecteur ignore, portent à la place un champ d’en-tête de remplissage
Pepsi-Padding:sur l’entité MIME chiffrée. Par défautyes. Ne le désactivez que pour un lecteur dont on a mesuré qu’il traite mal l’un des deux.- MAX_SIZE
(nombre, facultatif) Le plus grand message, en octets, que cette étape chiffre.
25000000par défaut (25 Mo). Ni le constructeur CMS ni les chemins OpenPGP ne diffusent en flux, de sorte que tout le message est résident pendant son chiffrement, une fois par destinataire ; un plafond visible garde prévisible la mémoire maximale de chaque worker au lieu de laisserPARALLELISMworkers détenir chacun un message de plusieurs centaines de mégaoctets.- MIN_TRUST
(``own`` | ``manual`` | ``dane`` | ``wkd-advanced`` | ``wkd-direct`` | ``ldap`` | ``vks`` | ``owner-confirmed`` | ``inbound-signed`` | ``harvested`` | ``gossip`` | ``any``, facultatif) La source de clé la moins bien classée vers laquelle cette étape chiffre. Vaut par défaut
[pepsi-keydiscovery] MIN_TRUST, de sorte qu’un déploiement n’ait qu’un plancher à moins d’en vouloir délibérément deux. Voir La section [pepsi-keydiscovery] pour le classement, pour la raison pour laquelle le plancher par défaut accepte tout, et pour la différence entreharvestedetgossip.- SUBJECT_KEYWORDS_SIGN, SUBJECT_KEYWORDS_ENCRYPT, SUBJECT_KEYWORDS_BOTH
(liste séparée par virgules, facultative) Mots-clés qu’un expéditeur peut placer n’importe où dans le
Subjectpour demander une protection. Par défaut[sign],[encrypt]et[secure]. Comparés sans distinction de casse ; le mot-clé trouvé est retiré duSubjectsortant. Un mot-clé de chiffrement élève la politique àrequiredpour ce message — lire une demande humaine délibérée comme « essayer, et renoncer en silence » ferait de la fonctionnalité un mensonge. Ce sont des virgules, non des espaces, qui séparent la liste, car un mot-clé peut légitimement contenir une espace.- STRIP_REQUEST_HEADERS
(booléen, facultatif) Retirer chaque champ
X-Pepsi-*du message sortant.YESpar défaut. Les deux en-têtes sur lesquels cette étape agit (X-Pepsi-Sign,X-Pepsi-Encrypt) sont retirés inconditionnellement, quoi que dise cette option : un canal de commande qui survit jusque sur le fil est un canal auquel on peut ordonner au saut suivant d’obéir. Cette option ne décide que du sort des autres champsX-Pepsi-*qu’un module d’extension aurait pu ajouter.Pepsi-Originn’appartient pas à cet espace de noms et n’est jamais touché.- PROTECT_HEADERS
(booléen, facultatif) Copier les champs d’en-tête RFC 5322 (
From,Sender,To,Cc,Reply-To,Subject,Date,Message-ID,In-Reply-To,References; jamaisBcc) dans la partie protégée avec un paramètreprotected-headers="v1"(en-têtes injectés de la RFC 9788) et, sur un message chiffré, remplacer leSubjectextérieur par...(c’est ce que Thunderbird met en œuvre pour PGP/MIME) ; un message seulement signé garde sonSubjectextérieur. LeFrom:protégé est ce qui permet à pepsi-stage-decrypt(1) du côté destinataire de remarquer un message signé renvoyé sous un autre auteur, et lesTo:etCc:protégés placent les destinataires dans la signature pour un client qui ne lit pas l’attribut de destinataires propre à Pepsi. Par défautNO: l’objet d’un message chiffré se lit...dans un client qui ne sait pas regarder dans la partie protégée.- AUTOCRYPT
(booléen, facultatif) Annoncer la clé OpenPGP propre à l’auteur du
From:dans un en-têteAutocrypt:.YESpar défaut, et sur chaque message soumis localement — signé, chiffré ou en clair — car un correspondant doit apprendre la clé depuis du courrier ordinaire avant qu’il n’y ait quoi que ce soit à chiffrer.La clé est réduite à la forme minimale à cinq paquets d’Autocrypt Level 1 §2.1.1. Seul OpenPGP est annoncé (Autocrypt n’a pas de forme S/MIME), seulement pour une identité qui détient encore son matériel privé, et jamais sur un message portant déjà un champ
Autocrypt:: l’en-tête propre à un vrai client nomme la clé avec laquelle il peut déchiffrer, et un second champ fait écarter les deux par les analyseurs Level 1.prefer-encrypt=mutualn’est revendiqué que lorsque l”ENCRYPTeffectif vautrequired; voir pepsi-stage-encrypt(1).Rien n’est annoncé lorsque la face publique de l’adresse est la propre clé MUA de l’utilisateur (
custody = client), ni sur un message que le client a déjà chiffré : le client de messagerie annonce sa propre clé.Désactivez-le pour limiter la publication des clés au Web Key Directory et au DNS, ce qui est un choix défendable pour un déploiement qui ne veut pas que les clés de ses utilisateurs voyagent sur chaque message qu’ils envoient.
- ATTACH_KEYS_AS_FILES
(booléen, facultatif) Joindre aussi la clé publique de l’expéditeur sous forme d’un fichier
application/pgp-keysnomméOpenPGP_0x<long key ID>.asc, la manière classique d’OpenPGP, en plus de l’en-têteAutocrypt:.NOpar défaut, indépendamment d”ENABLE_PEP; un opérateur qui ne veut que le fichier positionne aussiAUTOCRYPT = no.Sur un message chiffré, le fichier va à l’intérieur du texte chiffré ; en clair, le message est enveloppé dans un
multipart/mixed(ou la clé est ajoutée à un existant). Il est joint jusqu’à ce que chaque destinataire détienne la clé de façon prouvée – il a renvoyé un message chiffré pour elle et signé par lui, consigné danspepsi.peer_has_own_key– et recommence pour une nouvelle clé. Jamais lorsque la face publique est la propre clé MUA de l’utilisateur, jamais sur du courrier que le client a chiffré, et pas sur du texte en clair que le client a signé.- KEYS_CONTROL_LOCAL_PART
(chaîne, facultative) Partie locale de l’adresse à laquelle un utilisateur gère ses propres clés par e-mail : un message soumis localement dont l’unique destinataire est
<KEYS_CONTROL_LOCAL_PART>@<served domain>est une commande (status,generate,register,publish [FPR],retire FPR,pin FPR,otp enroll,otp confirm CODE,otp removedans leSubject:), consommée et traitée par une réponse àRESPONSE_STAGE. Chaque commande saufstatusest refusée sous un préfixe de réponse ou de transfert (Re:,Fwd:,AW:, …).pepsi-keyspar défaut ;nonedésactive cette surface. RequiertRESPONSE_STAGE.- OTP_CONFIRM_WINDOW
(durée, facultative) Combien de temps un second facteur mis en place par e-mail (
otp enroll) attend que son propriétaire le confirme avec un code (otp confirm) avant de devenir caduc ; jusque-là, un second facteur déjà en vigueur reste en vigueur. L’en-têteExpires:de la réponse d’inscription nomme la fin de cette fenêtre. Par défaut1h.- RESPONSE_STAGE
(nom d’étape, facultatif) Où sont injectés, comme nouveaux messages à expéditeur nul, les réponses aux commandes de clés par e-mail et les avis « une nouvelle clé a été enregistrée pour votre adresse ». Normalement l’étape sortante de signature DKIM, ce qu’écrit pepsi-setup –wizard (
dkim-sign). Non défini signifie ni avis ni commandes par e-mail (le courrier de contrôle est alors transmis comme tout autre message) ; pepsi-setup(1) en avertit, refuse un nom qui n’est pas une étape, et exige les modèles de replikey-registered.en.bodyetkeys.en.bodylorsqu’elle est définie.- AUTOCRYPT_GOSSIP
(booléen, facultatif) Annoncer les clés OpenPGP des autres destinataires dans des champs
Autocrypt-Gossip:(Autocrypt Level 1 §5.3), afin que deux correspondants qui ne se sont jamais écrit puissent néanmoins se répondre en chiffré après un seul message.NOpar défaut.Désactivé par défaut parce que ce n’est pas le même genre d’acte qu”
AUTOCRYPT: celui-ci publie une clé dont le propriétaire a demandé à ce déploiement de la détenir, tandis que celui-là redistribue les clés de tiers, du matériel simplement mis en cache ici, à des correspondants qui ne les ont pas demandées.Cela ne s’applique qu’à un message que cette étape chiffre réellement, et les champs vont à l’intérieur du texte chiffré, jamais sur le bloc d’en-tête extérieur : leur objet même est de présenter les destinataires les uns aux autres sans divulguer l’ensemble des destinataires au réseau. Il n’y a donc pas de gossip sur le passage en clair, sur un message signé mais non chiffré, ni sur un conteneur S/MIME (Autocrypt est défini au-dessus d’OpenPGP et n’a pas de forme S/MIME). Un champ est émis par destinataire présenté (contrairement à
Autocrypt:, où un second champ fait écarter le message par un analyseur Level 1), etprefer-encryptn’apparaît jamais, puisqu’il énonce la politique propre à l’expéditeur alors que ce champ parle pour quelqu’un d’autre.Avertissement
Les copies cachées ne sont jamais gossipées. Les adresses annoncées sont lues dans les champs
To:etCc:analysés du message et nulle part ailleurs ; la liste des destinataires d’enveloppe n’est consultée que pour retirer une adresse de l’ensemble. Un destinataire enBccfigure sur l’enveloppe et dans aucun des deux champs, de sorte qu’aucune copie du message ne puisse porter un en-tête le nommant. C’est la propriété sur laquelle compter, car un en-tête de gossip pour un destinataire caché indiquerait à chaque autre destinataire qu’un destinataire caché existe et qui il est. Cela tient même si un champBcc:a été laissé sur le message par un client de soumission défectueux, puisque le champ n’est pas lu.La réciproque est délibérée : la copie propre d’un destinataire caché porte bel et bien du gossip sur les destinataires
To:/Cc:. Il a reçu ces champs d’en-tête comme tout le monde : cela ne divulgue donc rien qu’il ne puisse déjà lire, et c’est ce qui lui permet de répondre en chiffré.Un destinataire pour lequel ce déploiement ne détient aucune clé en cache est simplement laissé de côté : l’étape n’effectue aucune découverte de clé en son nom et ne retarde jamais un message pour aller chercher la clé d’un tiers. Un message comptant plus de 50 destinataires visibles ne reçoit aucun gossip : à cette taille c’est une diffusion plutôt qu’une conversation, chaque clé présentée est répétée dans le texte chiffré de chaque destinataire, et présenter un sous-ensemble arbitraire serait pire que n’en présenter aucun.
- GOSSIP_MIN_TRUST
(``own`` | ``manual`` | ``dane`` | ``wkd-advanced`` | ``wkd-direct`` | ``ldap`` | ``vks`` | ``owner-confirmed`` | ``inbound-signed`` | ``harvested`` | ``gossip`` | ``any``, facultatif) La source de clé de plus bas rang dont la clé peut être republiée dans un champ
Autocrypt-Gossip:. Par défautowner-confirmed— le plus faible échelon auquel quelqu’un ayant droit sur l’adresse a fait une démarche délibérée pour publier la clé.C’est un vrai resserrement par rapport à
MIN_TRUST, et délibérément : chiffrer vers une clé en confiance au premier usage est un bon échange, car l’alternative est le texte clair, mais remettre cette clé à des tiers est un autre acte. Chaque destinataire d’une clé transmise par gossip la stocke à un échelon qu’il juge sur notre parole et non sur la façon dont nous avons obtenu la clé : transmettre une supposition la transforme donc en quelque chose qui a l’air d’une connaissance.Le plancher réellement appliqué est le plus strict de celui-ci et de
MIN_TRUST: présenter à un correspondant une clé vers laquelle cette étape ne chiffrerait pas elle-même reviendrait à recommander ce qu’elle a refusé. Relever l’une ou l’autre option resserre donc le gossip, abaisser l’une ou l’autre ne peut pas le desserrer au-delà de la seconde, et un opérateur qui durcitMIN_TRUSTn’a pas à se souvenir qu’une seconde option existe.GOSSIP_MIN_TRUST = anytransmet par gossip toute clé vers laquelle il est permis de chiffrer. Sans effet siAUTOCRYPT_GOSSIPn’est pas activé.- SECURE_LINK_STAGE
(nom d’étape, facultatif) Où est envoyé un destinataire empruntant la voie
secure-link. Requis siON_NO_KEY/ON_OVERSIZEse résout ensecure-link.- DISCOVERY
(booléen, facultatif) Si un défaut de cache peut déclencher une consultation réseau ; documenté sous L’interrupteur par expéditeur : [stage-encrypt] DISCOVERY.
- DISCOVERY_TIMEOUT
(temporel, facultatif) Redéfinit
[pepsi-keydiscovery] TIMEOUTpour les messages que cette étape gare. Notez queSection::duration()rejette les unités calendaires :90 set2 hs’analysent,1 dnon.- SUBJECT_KEYWORDS_CLEAR_OK
(liste séparée par des virgules, facultative) Mots-clés par lesquels un expéditeur local accepte le texte en clair pour un destinataire dont la recherche de clé a échoué dans le DNS (voir « Échecs DNS des destinataires » dans pepsi-stage-encrypt(1)). Par défaut
[clear-ok]. Reconnus et retirés comme les autres mots-clés, honorés seulement pour le courrierstate.local_origin, et ils n’affaiblissent jamaisENCRYPT = required.- CLEAR_ON_DNS_FAILURE
(booléen, facultatif) La même acceptation sous forme de réglage permanent, normalement donnée par expéditeur via
pepsi.settings. Par défautNO: un destinataire dont le DNS du domaine ne répond pas est différé et fait l’objet d’un rebond àMAX_LIFETIME, et un destinataire dont les enregistrements de clés continuent d’échouer alors que le domaine répond va àSECURE_LINK_STAGEou fait l’objet d’un rebond, au lieu d’être envoyé en clair.- DELAY_DSN_AFTER
(durée, facultative) Tant qu’un message est différé sur un échec DNS d’un destinataire, envoyer à son expéditeur un DSN « retardé » une fois que le message a attendu aussi longtemps, mais seulement si l’expéditeur a demandé
NOTIFY=DELAYet qu’unBOUNCE_STAGEest défini. Par défaut4 h.- NOTIFY_CLEARTEXT
(``no`` | ``author``, facultatif) Si l’auteur d’un message soumis localement est informé lorsque celui-ci est parti non chiffré alors que le chiffrement était souhaité : un destinataire sans clé utilisable sous
ON_NO_KEY = cleartext, ou un message au-delà deMAX_SIZEsousON_OVERSIZE = cleartext. Avecauthor, l’étape injecte un avis par copie de ce type àRESPONSE_STAGE(expéditeur nul, à l’adresse duFrom:), nommant les destinataires et la raison ; jamais pour un message à expéditeur nul ni pour une contribution à une liste. Les destinataires sans clé d’un message partagent une copie, et donc un avis. Par défautno; normalement activé par expéditeur viapepsi.settings. Défini ici, il a besoin deRESPONSE_STAGE(le worker refuse de démarrer sans lui). Modèlescleartext-notice.<lang>.body. Indépendamment de cette option, un objet qui commence par une quasi-correspondance de l’un desSUBJECT_KEYWORDS_*(une faute d’orthographe, une lettre sosie,[encrypted]) reçoit àRESPONSE_STAGEun avertissement nommant le mot-clé auquel il ressemblait (keyword-near-miss.<lang>.body).- NOTICE_SIGNER
(adresse e-mail, facultative) L’identité qui signe chaque message que Pepsi a lui-même composé, c’est-à-dire les lignes portant
state.notice(voir pepsi.state(7)) : liens de connexion et de portail, défis du secrétaire, demandes de paiement, réponses aux commandes, avis de changement de clé et d’absence. Signé seulement, jamais chiffré, dans le premier protocole dePREFERque possède l’identité, et envoyé avecFrom:cette adresse (l’ancienFrom:devientReply-To:à moins que l’avis n’en ait défini un). Non défini (par défaut) : ces messages suivent le chemin ordinaire de l’étape, ce qui ne change rien au courrier sanslocal_origin. Lu uniquement dans le fichier de configuration, jamais viapepsi.settings. A besoin de[pepsi-crypto] KEY_WRAP_SECRET(le worker refuse de démarrer sans lui) et d’une identité créée avecidentity generatede pepsi-keys(1), dans un domaine servi afin que le Web Key Directory la publie ; sans elle, les avis attendent et sont réessayés. Généralement défini dans une section d’étape à part, vers laquelle les programmes qui émettent des avis pointent avec leurs optionsRESPONSE_STAGE,BLOCK_RESPONSE_STAGE,[pepsi-admin] ENROL_STAGEet[pepsi-secure-link] NOTIFY_STAGE; voir « Signature des propres avis de Pepsi » dans pepsi-stage-encrypt(1).
Une identité d’auteur que cette étape crée ou enregistre est attribuée à un login passwd via les options LOCAL_DOMAINS, TARGETS et RECIPIENT_DELIMITER de [pepsi-crypto], comme pepsi-keys(1) en attribue une, de sorte que la règle de propriété de La section [pepsi-crypto] ne dépend pas du programme qui a fait la clé. Une adresse qui ne se résout vers aucun compte local est un état légitime (une adresse de rôle ou un domaine hébergé), non un échec. [pepsi-crypto] AUTO_CREATE_IDENTITY décide si une identité peut être créée tout court, et la création n’est proposée que pour un auteur dans un domaine de [pepsi-ingress] ACCEPTED_DOMAINS.
Le binaire est installé setuid pepsi-crypto, mode 4750 pepsi-crypto:pepsi, parce qu’il doit être l’unique rôle de base à qui crypto_identity.private_wrapped est accordé (l’authentification par pair se fonde sur l’uid effectif), et il doit lire le fragment en 0640 qui contient la clé de chiffrement de clés et appartient au même compte. Voir pepsi-stage-encrypt(1).
95.2.1.1.22.4. Options de pepsi-stage-decrypt¶
Une étape avec PROGRAM = pepsi-stage-decrypt déchiffre le courrier adressé aux destinataires que cet hôte sert et vérifie la signature qu’il porte. Elle lit, outre un NEXT_STAGE obligatoire et un BOUNCE_STAGE facultatif :
- ENABLED
(booléen, facultatif) S’il faut faire de la cryptographie du tout.
YESpar défaut.NOretire tout de même l’espace de noms d’en-têtesX-Pepsi-*du courrier entrant : une étape désactivée ne doit pas devenir un canal pour un indicateur falsifié.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(facultatif) Quels destinataires cet hôte sert — les mêmes options, avec les mêmes valeurs par défaut, que pepsi-stage-relay-to-maildir(1) et pepsi-stage-dot-forward(1).
LOCAL_DOMAINSvaut par défaut[pepsi-ingress] ACCEPTED_DOMAINS.- REQUIRE_ACCOUNT
(booléen, facultatif) Si un destinataire local doit en outre se résoudre vers un compte passwd autorisé par
TARGETS.NOpar défaut, ce qui est la différence avec les étapes de remise : elles doivent savoir quelle boîte écrire, tandis que cette étape n’a qu’à savoir si le message est le nôtre. Un domaine hébergé dont les utilisateurs détiennent des identités cryptographiques mais aucun compte shell est un déploiement ordinaire.- ON_DECRYPT_FAILURE
(``passthrough`` | ``quarantine`` | ``bounce-if-unproblematic``, alias ``bounce``, facultatif) Que faire d’un message que cet hôte n’a pas pu ouvrir.
passthroughpar défaut : l’utilisateur détient peut-être la clé dans son propre client, et générer un rebond pour du courrier que nous n’avons simplement pas su ouvrir n’aide personne.quarantineexigeQUARANTINE_STAGE;bounce-if-unproblematicexigeBOUNCE_STAGE.bounce-if-unproblematicne génère un rebond que pour un message dont le texte chiffré en échec est protégé en intégrité (OpenPGP,AuthEnvelopedDataS/MIME, jugé d’après le texte chiffré lui-même et non son étiquette), où chaque modification échoue de la même façon, et son diagnostic ne nomme aucune raison (la raison est journalisée). Tout autre message en échec est abandonné sans trace visible pour l’expéditeur : pour un message S/MIME AES-CBC, qui n’a pas de protection d’intégrité, un DSN serait un oracle de remplissage (un attaquant qui a capturé un texte chiffré renvoie des copies modifiées et apprend de chaque DSN, ou de son absence, si le remplissage modifié était valide ; environ 2 000 messages de ce type déchiffrent un bloc de 16 octets). La valeurbounceest un alias de la forme plus longue mais sans ambiguïtébounce-if-unproblematic: le rebond n’est envoyé que pour des messages auxquels l’oracle CBC ne s’applique pas parce qu’ils ne sont pas chiffrés en CBC ; le worker et pepsi-setup(1) avertissent lorsque la graphie courte est utilisée. pepsi-stage-decrypt(1) explique ce choix.- ON_BAD_SIGNATURE
(``record`` | ``quarantine`` | ``bounce``, facultatif) Que faire d’un message dont la signature ne s’est pas vérifiée.
recordpar défaut : les listes de diffusion qui réécrivent les corps, les réexpéditeurs et les clients à la canonicalisation défectueuse produisent tous de mauvaises signatures sur du courrier parfaitement légitime. Seul le verdictinvalidcompte ici comme mauvais —valid-untrustedetunverifiablesont l’état normal du courrier d’un correspondant inconnu et ne sont jamais acheminés.bounceexigeBOUNCE_STAGE, et abandonne au lieu de générer un rebond un message dont la signature est sortie d’un conteneur S/MIMEEnvelopedData: qu’un texte chiffré CBC modifié donne un texte en clair qui paraît signé dépend de son remplissage.- ON_MISSING_SIGNATURE
(``record`` | ``tag`` | ``quarantine``, facultatif) Que faire d’un message qui arrive sans signature
valid(non signé,unverifiable,valid-untrustedoupartial) depuis une adresseFrom:dont le courrier a porté une signaturevalidpar une clé ancrée au cours des derniersMISSING_SIGNATURE_WINDOW_DAYS. L’étape note, par adresse, quand une telle signature s’est vérifiée pour la dernière fois (pepsi.signed_sender) ; unFrom:falsifié d’un correspondant qui signe toujours se remarque alors même là où DMARC n’est pas imposé. Par défautrecord: le fait va dansX-Pepsi-Crypto(usually-signed=<date>) etstate.crypto.in.usually_signed, pour les règles Sieve et les extensions de clients, et rien d’autre ne change, car un correspondant qui écrit depuis un téléphone ou un nouveau client produit exactement cette forme.tagpréfixe aussiTAG_MISSING_SIGNATUREauSubject;quarantineachemine le message versQUARANTINE_STAGE.ON_BAD_SIGNATUREtraite une signatureinvalid, et un message qui n’a pas été ouvert ici (un échec de déchiffrement, du courrier pour la propre clé client de l’utilisateur) n’est pas jugé.- MISSING_SIGNATURE_WINDOW_DAYS
(entier, facultatif) Pendant combien de jours une signature
validd’une adresse fait remarquer son courrier non signé (ON_MISSING_SIGNATURE). Par défaut90.0désactive la vérification ; les signatures sont toujours notées.- MAX_SIGNATURE_AGE_DAYS
(entier, facultatif) Combien de jours avant l’arrivée du message une signature peut avoir été faite tout en obtenant
valid. Une signature faite plus tôt, ou plus d’un jour après l’arrivée, se vérifie mais est rapportéevalid-untrusted(withheld=old-signature/future-signature) : pas d’étiquette[verified], pas destate.signature_verified. Cela attrape un message signé capturé et rejoué sous de nouveaux en-têtes extérieurs. L’heure d’arrivée est celle que cet hôte a notée, jamais leDate:écrit par l’expéditeur ; une signature sans heure de création (CMS sanssigningTime) n’est pas jugée. Par défaut7;0désactive la vérification. Un site dont le courrier est souvent remis en retard (une liste modérée, une archive réinjectée) l’augmente.- UNAUTHENTICATED_PLAINTEXT
(``text`` | ``require-signature`` | ``open``, facultatif) Ce que devient un texte en clair récupéré d’un conteneur S/MIME
EnvelopedData(AES-CBC, ou 3DES là où[pepsi] CRYPTO_ALLOW_DOWNGRADEl’admet) lorsqu’aucune signature valide à l’intérieur du conteneur ne le couvre. Un tel texte chiffré n’a pas de protection d’intégrité : quiconque en détient une copie peut réécrire son texte en clair bloc par bloc (les gadgets CBC d’EFAIL) en un HTML qui envoie le reste du texte en clair à son serveur dès qu’un client l’affiche. Par défauttext: le texte en clair est remis avec chaque partie qu’un client afficherait comme balisage (text/html,text/enriched, XHTML, y compris dans les messages joints) réétiquetéetext/plain, unmultipart/alternativeréduit à son alternative en texte simple, et leSubjectétiquetéTAG_UNAUTHENTICATEDà la place deTAG_DECRYPTED; le texte arrive, rien n’est rendu, et la mise en forme HTML d’un tel courrier est perdue.require-signaturetransmet un tel message sans l’ouvrir, toujours chiffré, au propre client de messagerie de l’utilisateur, qui voit alors le conteneur S/MIME et applique ses propres défenses contre EFAIL ; le courrier CBC non signé destiné à un utilisateur sans clé client arrive illisible. Ce n’est pas un échec de déchiffrement :ON_DECRYPT_FAILUREn’est pas consulté.openremet le texte en clair tel qu’il est sorti du conteneur, balisage compris, étiqueté de la même façon. Une signature sur le texte en clair compte quoi que vaille sa clé (validouvalid-untrusted) ; une signature autour du texte chiffré ne compte pas, puisqu’un attaquant signe à nouveau un texte chiffré réécrit avec une clé à lui. Le contenu d’un conteneur AEAD (AuthEnvelopedData, chaque conteneur OpenPGP qu’accepte Pepsi) n’est jamais concerné. Voir pepsi-stage-decrypt(1).- OPEN_ENVELOPED_DATA
(booléen, facultatif) Si l”
EnvelopedDataS/MIME (AES-CBC, 3DES) est ouvert du tout. Par défautYES: la plupart des clients S/MIME n’envoient rien d’autre.NOtransmet chacun de ces messages sans l’ouvrir au propre client de messagerie de l’utilisateur, commerequire-signaturele fait avec un message non signé, sans lui appliquer aucune clé privée : l’identifiant d’algorithme du conteneur n’est pas authentifié, de sorte que la clé de contenu d’un message AES-GCM capturé, envoyé sans la dérivation de clé de la RFC 9709, peut être resoumise sous un conteneur AES-CBC synthétique, et avec cette option désactivée elle n’est jamais appliquée à un tel conteneur. Ce n’est pas un échec de déchiffrement :ON_DECRYPT_FAILUREn’est pas consulté. Un conteneur utilisantid-alg-cek-hkdf-sha256de la RFC 9709 est séparé en clés par construction, mais reste unEnvelopedDataet est lui aussi laissé fermé. Définissez-la par adresse ou par domaine destinataire avec une surcoucheaddress:/domain:(pepsi-config(1)) pour laisser le CBC aux clients des utilisateurs dont les correspondants envoient de l”AuthEnvelopedData.- DECRYPTED_MARKUP
(``keep`` | ``text``, facultatif) Ce que devient le balisage d’un texte en clair que cette étape a déchiffré lorsque
UNAUTHENTICATED_PLAINTEXTne l’a pas déjà réduit. Par défautkeep: le texte en clair est remis tel qu’il est sorti d’un conteneur authentifié, HTML compris, et le contenu distant qu’il contient est laissé aux propres réglages du client (voir le chapitre du manuel sur les clients de messagerie).textréétiquette chaque partie de balisagetext/plainexactement comme le faitUNAUTHENTICATED_PLAINTEXT = text(sanitised=textdansX-Pepsi-Crypto), de sorte qu’aucun client ne récupère de contenu distant pour un message déchiffré, au prix de sa mise en forme ; une signature sur une partie réétiquetée ne se vérifie pas dans le client.- QUARANTINE_STAGE
(nom d’étape, facultatif) Où mène une voie
quarantine. Requis si l’une des politiques ci-dessus vautquarantine.- SUBJECT_TAGS
(booléen, facultatif) Préfixer au
Subjectles étiquettes acquises dans l’ordre d’imbrication :encrypted(signed(body))donne[decrypted][verified] …etsigned(encrypted(body))donnerait[verified][decrypted] ….YESpar défaut : pour la plupart des utilisateurs c’est le seul signal qu’ils verront jamais. Le coût est un champ visible par l’utilisateur qui se trouve muté, ce qui affecte la recherche, le fil de discussion et les objets cités dans les réponses. (Les deux formes s’ouvrent. La seconde n’acquiert[verified]que d’une signature à l’intérieur du texte chiffré : une signature extérieure couvre du texte chiffré et n’atteint jamais le verdictvalidpour lequel l’étiquette est écrite ; voir pepsi-stage-decrypt(1).)- TAG_DECRYPTED, TAG_VERIFIED, TAG_UNAUTHENTICATED
(chaîne, facultative) Le libellé des étiquettes. Par défaut
[decrypted],[verified]et[decrypted, unauthenticated];nonen’écrit aucune étiquette (une valeur vide se lit comme non définie).TAG_VERIFIEDn’est écrit que pour le verdictvalid, et l’adresse à laquelle le signataire est lié se place avant son crochet fermant ([verified: alice@example.org]; une graphie sans crochet fermant reçoit l’adresse ajoutée après un deux-points) ;TAG_UNAUTHENTICATEDremplaceTAG_DECRYPTEDsur un texte en clair provenant d’un conteneur sans protection d’intégrité qu’aucune signature ne couvre (UNAUTHENTICATED_PLAINTEXT).- TAG_VERIFIED_EXCEPT_REPLY_TO
(chaîne, facultative) Écrit à la place de
TAG_VERIFIEDlorsque la signature estvalidmais que leReply-To:extérieur a été ajouté par une liste de diffusion (List-Idprésent, pas deReply-To:signé) et que rien ne le couvre. Par défaut[verified (except reply-to)], l’adresse à l’intérieur comme ci-dessus.- TAG_BAD_SIGNATURE
(chaîne, facultative) L’étiquette du verdict
invalidpour une signature hors d’un texte chiffré. Vide par défaut : une mauvaise signature est une propriété courante du courrier légitime, si bien qu’une étiquette activée par défaut décorerait une grande partie de la boîte de réception d’un utilisateur d’une accusation.- TAG_BAD_SIGNATURE_ENCRYPTED
(chaîne, facultative) L’étiquette du verdict
invalidpour une signature à l’intérieur d’un texte chiffré. Par défaut[bad signature]: une liste de diffusion ne peut pas réécrire un corps qu’elle ne peut pas lire, de sorte que la raison pour laquelleTAG_BAD_SIGNATUREest vide par défaut ne vaut pas à l’intérieur d’un texte chiffré, et un texte chiffré rejoué se lirait sinon[decrypted]comme s’il venait de son signataire.nonela désactive (une valeur vide se lit comme non définie).- TAG_UNVERIFIED_SIGNER
(chaîne, facultative) L’étiquette d’une signature à l’intérieur d’un texte chiffré qui est saine mais pas
valid:valid-untrusted,unverifiableoupartial. Par défaut[unverified signer], pour la même raison.nonela désactive. Hors d’un texte chiffré, ces verdicts ne valent aucune étiquette.- TAG_MISSING_SIGNATURE
(chaîne, facultative) L’étiquette que
ON_MISSING_SIGNATURE = tagpréfixe à un message d’une adresse qui signe d’habitude et qui est arrivé sans signaturevalid. Par défaut[unsigned, usually signed].- STRIP_SUBJECT_TAGS
(booléen, facultatif) Retirer tout ce qui s’afficherait comme un indicateur de sécurité au début d’un
Subjectentrant avant d’y préfixer le nôtre.YESpar défaut, et de fait obligatoire : sans cela, un expéditeur externe écrit simplement[verified]lui-même. Le vocabulaire est dérivé des optionsTAG_*plus leurs valeurs par défaut intégrées, la forme d’adresse[verified: …]comprise en entier quelle que soit la longueur de l’adresse, de sorte que renommer une étiquette ne puisse rouvrir la brèche, et la comparaison se fait sur l’objet décodé avec les caractères sosies normalisés, de sorte que les encoded-words, les crochets pleine chasse, les lettres cyrilliques et les caractères de largeur nulle ne cachent pas non plus une étiquette. Tout groupe entre crochets en tête qui nomme une propriété de sécurité ([secure],(signature OK)) est retiré aussi. pepsi-stage-decrypt(1) donne la règle complète.- STRIP_SUBJECT_KEYWORDS
(liste séparée par virgules, facultative) Étiquettes d’objet entrantes supplémentaires à retirer. Des virgules plutôt que des espaces, car un mot-clé peut contenir une espace.
- ADD_RESULT_HEADER
(booléen, facultatif) Ajouter l’en-tête de résultat
X-Pepsi-Cryptoà un message qui portait une protection.YESpar défaut. Sa grammaire est documentée dans pepsi-stage-decrypt(1). Chaque champX-Pepsi-*est d’abord retiré du courrier entrant, inconditionnellement et quoi que dise cette option — c’est ce retrait qui rend l’en-tête crédible.- ISOLATE_ENCRYPTED
(booléen, facultatif) Lorsqu’un message porte du texte chiffré à côté d’autre contenu, faire de sa première unité chiffrée le message lui-même et déplacer toutes les autres parties dans une pièce jointe inerte (
application/octet-stream, dispositionattachment), avant tout déchiffrement. Par défautYES. Cela évite l’exfiltration directe EFAIL, tant par cette étape que par le client d’un destinataire qui déchiffre lui-même le message. Les textes chiffrés déplacés sont eux aussi ouverts en pièces jointes ; à côté d’un texte en clair signé, seuls ceux signés par la même clé sont conservés, et à côté d’un conteneur PGP/MIME ou S/MIME qui n’est pas ouvert, les parties déplacées sont abandonnées (voir pepsi-stage-decrypt(1)). Le désactiver remet le message tel qu’il est arrivé.- ISOLATE_SIGNED
(booléen, facultatif) Lorsqu’un message sans texte chiffré porte du contenu signé à côté de contenu non signé, le réduire à ses unités signées. Par défaut
YES. Un verdict de signature s’applique alors à tout ce que voit l’utilisateur. Le désactiver conserve les pieds de page de listes de diffusion ajoutés hors d’une signature, au prix qu’un texte d’inconnu placé à côté d’une partie valablement signée parvienne à l’utilisateur sous la même étiquette[verified].- MAX_LAYERS
(entier, facultatif) Combien de couches chiffrées imbriquées sont déballées.
4par défaut. Un message qui en compte davantage est remis avec le reste non ouvert.- TRUST_ANCHOR_TTL
(temporel, facultatif) Combien de temps un processus worker réutilise les ancres
ca_trustqu’il a lues en dernier.5 mpar défaut. Une ancre ajoutée ou désactivée prend effet dans cette fenêtre ; redémarrez les workers pour l’appliquer aussitôt. Les unités calendaires sont rejetées (5 met2 hs’analysent,1 dnon).- DISCOVERY
(booléen, facultatif) Si un défaut de cache peut déclencher une consultation réseau ; documenté sous L’interrupteur par expéditeur : [stage-encrypt] DISCOVERY. Lue depuis cette section par le même lecteur, de sorte que les deux étapes cryptographiques ne puissent pas être en désaccord sur son nom ou sur sa valeur par défaut.
- DISCOVERY_TIMEOUT
(temporel, facultatif) Redéfinit
[pepsi-keydiscovery] INBOUND_TIMEOUTpour les messages que cette étape gare.
[pepsi] CRYPTO_ALLOW_DOWNGRADE ne conditionne pas ce sens. Le SEIPDv1+MDC OpenPGP et l”EnvelopedData CMS AES-CBC sont lisibles quoi que dise la politique d’émission (OPEN_ENVELOPED_DATA ci-dessus est le propre interrupteur de cette étape) : les refuser en entrée rendrait cet hôte incapable de recevoir du courrier de la majeure partie du monde sans protéger personne. Seuls le 3DES (avec le Blowfish OpenPGP à côté) et les condensés de signature faibles sont conditionnés en entrée, et chaque refus produit son propre verdict. UNAUTHENTICATED_PLAINTEXT décide de ce qu’un texte en clair issu d’un tel conteneur peut faire une fois lu.
Le binaire est installé setuid pepsi-crypto, mode 4750 pepsi-crypto:pepsi, exactement pour les raisons données plus haut pour pepsi-stage-encrypt(1). Voir pepsi-stage-decrypt(1).
95.2.1.1.22.5. Options de pepsi-stage-reencrypt¶
Une étape avec PROGRAM = pepsi-stage-reencrypt prend un message que l’étape de déchiffrement a ouvert et, avant la remise locale, le scelle pour la clé du propre client de messagerie (MUA) du destinataire. Elle n’agit que sur les lignes dont state.crypto.in indique que le message est arrivé chiffré et a été déchiffré. NEXT_STAGE est obligatoire.
- ON_NO_CLIENT_KEY
(chaîne, facultative) Ce qui arrive à un destinataire local sans clé MUA utilisable :
plaintext(par défaut) classe le texte en clair ;bouncerefuse le message via BOUNCE_STAGE avec un DSN5.7.5qui ne porte que les champs d’en-tête d’adressage et aucun corps (RET=HDRSest forcé). Un message que l’étape de déchiffrement a ouvert depuis un conteneur S/MIMEEnvelopedData(sans protection d’intégrité) est abandonné à la place : le rebond ne partirait que parce que le texte chiffré s’est ouvert, ce qui, pour un texte chiffré AES-CBC modifié, dit si son remplissage était valide.pepsi-setuprefusebouncesans BOUNCE_STAGE. Les surcharges par destinataire viapepsi.settingss’appliquent.- PROTECT_HEADERS
(booléen, facultatif) Copie les champs RFC 5322 à l’intérieur du texte chiffré et remplace le
Subjectextérieur par.... Par défautNO, comme pour l’étape de chiffrement : la copie est destinée à la boîte aux lettres, dont le serveur liste et recherche par l’objet extérieur.- ENABLED
(booléen, facultatif) Désactivée, l’étape laisse passer tous les messages. Par défaut
YES.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER, REQUIRE_ACCOUNT
Quels destinataires sont servis ici, comme pour Options de pepsi-stage-decrypt. Les autres destinataires ne sont ni scellés ni refusés.
Le conteneur suit [pepsi] CRYPTO_ALLOW_DOWNGRADE et l’enregistrement de capacités S/MIME par pair comme pour le chiffrement sortant. Le binaire est non privilégié et intégré au binaire multi-appel pepsi : il scelle vers des clés publiques et ne lit que les colonnes publiques de pepsi.crypto_identity. Voir pepsi-stage-reencrypt(1).
95.2.1.1.22.6. Options de pepsi-stage-defang¶
Une étape avec PROGRAM = pepsi-stage-defang retire les références distantes (images, feuilles de style, polices, cadres, url(), @import) des parties HTML et CSS d’un message hors de toute signature, en gardant les liens, les parties cid: et les images data: en ligne, et marque un message modifié avec X-Pepsi-Warning: remote-content-defanged. NEXT_STAGE est obligatoire.
- DEFANG
(chaîne, facultative)
onouoff(par défautoff). Destinée à être définie par adresse viapepsi.settings; tant qu’elle est désactivée, l’étape transmet le message sans y toucher. Voir pepsi-stage-defang(1).
95.2.1.1.22.7. La section [pepsi-secure-link]¶
Le portail de repli à lien sécurisé : où est conservé un message qui n’a pas pu être chiffré, et comment le destinataire est admis. Lue par trois programmes — l’étape qui stocke un message (pepsi-stage-secure-link), le serveur qui le sert (pepsi-httpd(1)) et l’interface d’opérateur (pepsi-secure-link(1)) — ce qui explique qu’elle soit une section globale plutôt que des options recopiées dans une section [stage-*].
Cet emplacement est aussi une décision sur qui peut modifier ces valeurs. Ce n’est pas une section [stage-<name>] : elle est donc hors de portée de pepsi.settings et de pepsi-stage-edit-settings(1) — un correspondant ne peut pas s’envoyer par courrier une expiration plus longue, un code PIN plus court ou un verrouillage désactivé. Le seul réglage véritablement comportemental est [stage-encrypt] ON_NO_KEY, qui décide si un message impossible à chiffrer va au portail ; cette option, elle, est redéfinissable par adresse.
- BASE_URL
(chaîne) Origine publique à laquelle le portail est joignable, par exemple
https://secure.example.org. La régler (avecPEPPER) active la fonctionnalité ; le lien envoyé à un destinataire est<BASE_URL>/secure/<token>. Rien ici ne dit où le portail est monté — un écouteur et un nom d’hôte à lui, ou l’un partagé avec l’API et le Web Key Directory, sont tous deux pris en charge.- PEPPER
(chaîne) Le secret côté serveur mêlé à chaque dérivation de clé de contenu. Écrit par pepsi-setup(1) dans
secrets.d/pepsi-secure-link.secretet référencé par@inline-secret@; l’étape (qui s’exécute en tant quepepsi) et le portail le lisent tous deux, il est donc installé en mode0640appartenant àpepsi-httpd:pepsi. Sans lui, le portail est désactivé — il n’existe aucun mode où un message serait stocké en clair. Le perdre ou le changer rend chaque message stocké illisible, ce qui est la propriété même qui rend une base dérobée sans valeur.- EXPIRY_DAYS
(entier, facultatif) Combien de temps un message stocké vit.
7par défaut. Un nombre entier de jours plutôt qu’une durée, car les valeursdurationrejettent les unités calendaires.- PIN_LENGTH
(entier, facultatif) Nombre de caractères d’un code PIN engendré, tirés d’un alphabet de 31 symboles sans ambiguïté (pas de
0/O, pas de1/I/L). Par défaut et au minimum10(environ 49 bits). Un code PIN plus court est refusé : le code PIN est l’unique secret qu’un attaquant détenant à la fois la base et le poivre doit encore trouver, et comme les codes PIN sont engendrés, un code plus long ne coûte rien.- MAX_ATTEMPTS, LOCKOUT
(entier / temporel, facultatif) Nombre de codes PIN erronés avant que le jeton ne se verrouille (
10par défaut) et première fenêtre de verrouillage (15 mpar défaut). La fenêtre double à chaque verrouillage supplémentaire, plafonnée à 64 fois la base.- SESSION_LIFETIME
(temporel, facultatif) Combien de temps dure la session du portail après un code PIN correct.
30 mpar défaut.- RATE_LIMIT
(entier, facultatif) Requêtes par minute et par adresse de pair sur l’ensemble des routes du portail.
30par défaut ;0désactive le limiteur.- NOTIFY_STAGE
(chaîne) Obligatoire. Où sont injectés le courrier de lien, le courrier de code PIN et les accusés de lecture : une étape du chemin sortant, puisque ce sont des messages que le déploiement crée.
- REPLY_STAGE
(chaîne, facultative) Où est injectée une réponse composée dans le portail. Non définie, cela désactive la réponse. Pointez-la vers le chemin entrant : une réponse de portail est écrite par une partie externe, elle est donc injectée sans
state.local_originet ne doit pas être signée en DKIM comme l’un de vos domaines (pepsi-setup(1) avertit si elle se résout vers une étape de signature).- SEND_RECEIPT
(booléen, facultatif) Dire une fois à l’expéditeur que le message a été lu.
yespar défaut. L’accusé rapporte qui et quand, jamais quoi — il n’a rien à citer.- PIN_DELIVERY
(``sender`` | ``command`` | ``none``, facultatif) Comment le second facteur atteint le destinataire.
senderpar défaut : le code PIN est envoyé à l”expéditeur, qui le relaie par téléphone ou par message texte.commandexécutePIN_COMMAND.noneplace le code PIN dans le lien lui-même et est strictement plus faible — la boîte aux lettres devient le seul facteur.- PIN_COMMAND
(chaîne, facultative) Le programme à exécuter ; un chemin de système de fichiers pris tel quel, qui, contrairement à une option de type chemin, n’est donc pas développé par
$. Requis parPIN_DELIVERY = command. Exécuté sous la forme PIN_COMMAND--RECIPIENT, avec le code PIN sur l’entrée standard (une ligne de commande est lisible par tous via/proc). Le--vient en premier parce que l’adresse du destinataire est choisie par l’expéditeur et que sa partie locale peut commencer par-: un programme qui analyse des options s’arrête là et prend l’adresse comme opérande, et un programme qui ne le fait pas trouve l’adresse dans son second argument. Sur un code de sortie non nul, rien n’est stocké et le message est réessayé (jusqu’auMAX_LIFETIMEde l’étape, puis fait l’objet d’un rebond) plutôt que de laisser un lien que personne ne peut ouvrir. Il en va de même lorsque la commande dure plus de 30 secondes ; elle est alors tuée, car un client de passerelle SMS qui se bloque sur une adresse injoignable retiendrait sinon un worker d’étape pour toujours, puisque la ligne resterunninget que rien ne la revendique à nouveau.- MAX_REPLY_SIZE, MAX_REPLY_FILES, MAX_REPLIES
(entier, facultatif) Plafonds sur une réponse de portail : octets au total (
25000000par défaut, en accord avec[stage-encrypt] MAX_SIZE), fichiers par réponse (10par défaut) et réponses par message stocké (20par défaut). Le plafond de taille est appliqué pendant la diffusion du corps, de sorte qu’un client qui déclare mal sonContent-Lengthn’y gagne rien.- ACCESS_LOG_ROWS
(entier, facultatif) Lignes de journal d’accès conservées par message.
100par défaut. Le journal est supprimé avec le message.- NOTIFY_FROM
(chaîne, facultative) L’en-tête
From:des trois notifications que le portail origine (le lien, le code PIN et l’accusé de lecture). Non réglée — le cas par défaut — chacune porte leFrom:de l’expéditeur original et se lit donc comme venant de la personne qui a réellement écrit ; c’est juste pour les courriers de lien et de PIN, et discutable pour l’accusé de lecture, qui est un message automatique à expéditeur nul prétendant alors venir de l’adresse même de l’expéditeur. Réglez-la pour mettre une seule boîte aux lettres neutre et estampillée sur les trois. Elle est écrite verbatim dans l’en-tête : donnez donc une valeur RFC 5322 complète (Example Ltd <secure@example.com>). L’expéditeur d”enveloppe est inchangé dans les deux cas.- ORGANIZATION, BRAND_COLOR, LOGO_FILE
(chaîne / chaîne / chemin, facultatif) Apparence.
BRAND_COLORdoit être#rgbou#rrggbb— elle est interpolée dans la feuille de style de la page, du texte arbitraire est donc refusé plutôt qu’échappé.LOGO_FILEest un PNG, JPEG, GIF ou WebP local, intégré comme URIdata:(le SVG est refusé : il peut porter du script). Une URL de logo n’est délibérément pas une option — laContent-Security-Policydu portail interdit le contenu distant, ce qui empêche aussi un CDN d’apprendre qui a lu quoi.
95.2.1.1.22.8. Options de pepsi-stage-secure-link¶
Une étape avec PROGRAM = pepsi-stage-secure-link ne prend aucune option qui lui soit propre : tout est dans [pepsi-secure-link] ci-dessus. Elle n’a pas de NEXT_STAGE (elle est terminale — le message quitte la file et sa notification est un nouveau message injecté à NOTIFY_STAGE).
95.2.1.1.22.9. Options de pepsi-stage-dkim-sign¶
Une étape avec PROGRAM = pepsi-stage-dkim-sign lit, outre un NEXT_STAGE obligatoire et un BOUNCE_STAGE facultatif (où un message pour un domaine sans clés ici, ou sans From: utilisable, est signalé ; sans lui, un tel message est mis en échec) :
- HEADER_CANONICALIZATION, BODY_CANONICALIZATION
(``relaxed`` | ``simple``, facultatif) Les deux moitiés de la canonicalisation
c=. Les deux valentrelaxedpar défaut et peuvent être réglées indépendamment ; les quatre combinaisons sont valides à la fois pour la signature DKIM et le scellement ARC.- SIGNATURE_EXPIRATION_DAYS
(entier, facultatif) Les signatures portent une expiration (
x=) ce nombre de jours après la signature. Par défaut7: une copie rejouée du message, ou une copie signée avec une clé volée, cesse de se vérifier une semaine après la signature, ce qui dépasse encore le calendrier de nouvelles tentatives de tout destinataire.0n’émet aucune expiration.- SIGNED_HEADERS
(chaîne, facultative) Liste séparée par espaces/virgules des en-têtes que couvrent les signatures (
h=). Doit inclureFrom. Par défaut, l’ensemble intégré d’en-têtes d’origine et MIME plusList-UnsubscribeetList-Unsubscribe-Post, que la RFC 8058 exige qu’une signature DKIM couvre avant qu’un destinataire puisse proposer le désabonnement en un clic. Chaque champ est listé deux fois dans la valeur par défaut, de sorte que chacun est sur-signé : une copie de l’un d’eux ajoutée plus tard casse la signature.- SIGNING_DOMAIN
(chaîne, facultative) Forcer le domaine de signature (
d=). Lorsqu’il n’est pas défini, le domaine est pris dans la première boîte aux lettres de l’en-têteFrom:de chaque message, lu strictement : un champ qui ne s’analyse pas en entier comme une mailbox-list RFC 5322 ne donne aucun domaine, et le message est refusé plutôt que signé (voir pepsi-stage-dkim-sign(1)). UnSIGNING_DOMAINfixe est une identité d’envoi, de sorte que pepsi-setup(1) provisionne ses clés et son DNS.
Les clés sont détenues, et les signatures faites, par pepsi-dkim(1), dont les sélecteurs commencent par [pepsi] DKIM_SELECTOR ; [pepsi] DKIM_ALGORITHMS choisit les algorithmes. Le hachage est toujours SHA-256 ; une signature RSA (rsa-sha256) et une Ed25519 (ed25519-sha256) sont émises, ou seulement celles que nomme [pepsi] DKIM_ALGORITHMS.
95.2.1.1.22.10. Options de pepsi-stage-relay-to-internet¶
Une étape avec PROGRAM = pepsi-stage-relay-to-internet lit (un NEXT_STAGE et un BOUNCE_STAGE sont les clés générales ci-dessus) :
- SERVER_NAME
(chaîne, obligatoire) Notre propre nom d’hôte, annoncé dans
EHLOet écrit dans l’en-tête de traceReceived:, par exemplemail.example.org.- EHLO_FROM_PTR
(booléen, facultatif, par défaut no) Avec
yes, l’étage prend le nom qu’il annonce dansEHLOdans le DNS inverse de l’adresse locale de chaque connexion. Il demande l’enregistrementPTRde cette adresse et annonce le premier nom qui est un nom d’hôte et qui renvoie à la même adresse (DNS inverse confirmé dans le sens direct). S’il n’existe aucun nom de ce type, ou si la requête échoue, il annonce SERVER_NAME, comme sans l’option. Des destinataires comme Gmail et Microsoft comparent le nomEHLOauPTRde l’adresse qui se connecte, et un SERVER_NAME fixe ne peut concorder qu’avec un seulPTR. L’option est destinée à un hôte dont les adresses portent des noms choisis par le propriétaire de l’adresse, à un hôte qui a plusieurs adresses, et à une adresse IPv4 et une adresse IPv6 de noms différents. Chaque adresse est recherchée une fois par heure (après un échec, de nouveau au bout de cinq minutes), via DNS_SERVERS. SERVER_NAME reste le nom inscrit dans l’en-têteReceived:.- POSTMASTER
(chaîne, facultative) Adresse qui reçoit un double rebond — un rebond (expéditeur nul) qui est lui-même non remettable. La ligne reste dans la file jusqu’à ce qu’une copie y soit remise : elle est réessayée tant que la copie est différée, et marquée
failedlorsque la copie est refusée ou que MAX_LIFETIME est épuisé. En son absence, de tels doubles rebonds sont abandonnés.- PUBLIC_IP
(chaîne, facultative) Les adresses publiques depuis lesquelles ce relais émet, lues par pepsi-setup(1) pour construire l’enregistrement SPF (et, pour cette étape, pour vérifier le DNS inverse). Cette option des étapes de relais est documentée sous L’option d’identité de sortie : PUBLIC_IP ci-dessous.
- CONNECT_TIMEOUT / COMMAND_TIMEOUT / DATA_TIMEOUT
(durée, facultative) Timeouts par connexion pour, respectivement, l’établissement de la connexion TCP, une commande/réponse SMTP, et le transfert
DATA. Par défaut300 s/300 s/600 s.- RETRY_INITIAL / RETRY_MAX_INTERVAL / RETRY_FACTOR
(durée / durée / nombre, facultatif) Calendrier de backoff exponentiel entre les tentatives de remise d’un message échouant transitoirement : la première attente, le plafond de l’attente, et le multiplicateur appliqué à chaque tentative. Par défaut
300 s/2 h/2.- MAX_LIFETIME
(durée, facultative) Combien de temps un message peut rester dans le pipeline avant qu’un échec transitoire ne devienne permanent (il est alors rebondi ou marqué en échec). Par défaut
5 dde temps réel, mais la valeur doit être écrite avec les unitésh/m/s— l’analyseur de durée rejette l’unité calendaired(écrivez donc120 h, pas5 d).- DELAY_DSN_AFTER
(durée, facultative) Lorsqu’il est réglé, un DSN
Action: delayedà usage unique est envoyé à l’expéditeur une fois qu’un message encore non remis a été en file au moins aussi longtemps et que l’expéditeur a demandéNOTIFY=DELAY. Doit utiliser les unitésh/m/s. Non réglé (le défaut) désactive les avertissements de délai.- MAX_HOP_COUNT
(nombre, facultatif) Nombre maximal d’en-têtes
Received:tolérés avant que le message ne soit traité comme une boucle de courrier et marqué en échec permanent. Par défaut30.- DNS_SERVERS
(chaîne, facultative) Résolveurs, dans la syntaxe de
[pepsi] DNS_SERVERS, pour les recherchesMX, d’adresse et DANE. Lorsqu’il n’est pas défini,[pepsi] DNS_SERVERSs’applique, et à défaut leresolv.confdu système.- DNS_TIMEOUT
(durée, facultative) Délai DNS par requête. Par défaut
[pepsi] DNS_TIMEOUT, sinon5 s.- MTA_STS
(booléen, facultatif) S’il faut découvrir et appliquer les politiques MTA-STS du domaine destinataire (RFC 8461). Par défaut
yes.- MTA_STS_TIMEOUT
(durée, facultative) Timeout pour récupérer un fichier de politique MTA-STS via HTTPS. Par défaut
10 s.- ADDRESS_FAMILY
(facultatif) Quelles familles d’adresses IP employer pour se connecter aux serveurs de courrier :
any(défaut),ipv4(aussi orthographiév4/v4only) ouipv6(v6/v6only). La valeur configurée est intersectée avec ce que l’hôte local sait réellement router, de sorte qu’épingler une famille pour laquelle l’hôte n’a aucune route ne laisse rien à joindre. pepsi-stage-relay-to-smarthost(1) a la même option, réglable en outre par entrée de MTA.- DANE
(facultatif) Application DANE/TLSA (RFC 7672) pour le MX de destination :
off(pas de recherchesTLSA),warn(une renonciation explicite : valider mais, en cas de non-concordance, journaliser et remettre par TLS avec la vérification de certificat non validée qui s’applique sans DANE) oustrict(la valeur par défaut, comme l’exige la RFC 7672 section 2.2 : un enregistrement utilisable mais non concordant, ou une rechercheTLSAou de sécuritéMXéchouée, diffère la remise — de sorte qu’un hôte dont le résolveur ne peut pas répondre aux requêtesTLSAa besoin dewarnouoff). Nécessite un résolveur validant DNSSEC (Pepsi fait confiance au bit AD de la réponse ; voir DNS_SERVERS ; un worker démarré avec DANE activé avertit lorsque ce résolveur n’est ni une adresse loopback ni atteint partls://ouhttps://) ; les enregistrementsTLSAutilisables ont priorité sur MTA-STS, sauf quewarnne remplace jamais la validation PKIX d’une politique MTA-STSenforce. Lorsqu’un même usage et un même sélecteur sont publiés à la fois en SHA-256 et en SHA-512, seuls les enregistrements SHA-512 sont comparés (RFC 7671 section 9). Dans l’un ou l’autre mode, un RRsetTLSAsûr rendSTARTTLSobligatoire pour ce MX (RFC 7672 section 2.2) : un hôte qui ne le propose pas fait différer le message.
95.2.1.1.22.11. Options de pepsi-stage-relay-to-smarthost¶
Une étape avec PROGRAM = pepsi-stage-relay-to-smarthost lit les options opérationnelles ci-dessous ; les smarthosts amont eux-mêmes sont définis une seule fois dans les sections partagées [pepsi-stage-relay-to-smarthost-mta-*] (voir Les sections smarthost (MTA) ci-dessous). Un NEXT_STAGE et un BOUNCE_STAGE sont les clés générales ci-dessus.
- SERVER_NAME
(chaîne, obligatoire) Notre propre nom d’hôte, annoncé dans
EHLO(sauf si un MTA le redéfinit avecHELO_NAME) et écrit dans l’en-têteReceived:.- EHLO_FROM_PTR
(booléen, facultatif, par défaut no) Comme pour pepsi-stage-relay-to-internet : chaque connexion annonce le nom
PTRconfirmé dans le sens direct de son adresse locale, et SERVER_NAME s’il n’y en a pas. Une section MTA qui définit son propreHELO_NAMEgarde ce nom, parce que l’opérateur l’a choisi pour ce smarthost.- CONNECT_TIMEOUT / COMMAND_TIMEOUT / DATA_TIMEOUT
(durée, facultative) Timeouts par connexion pour le connect TCP, une commande/réponse SMTP et le transfert
DATA. Par défaut300 s/300 s/600 s.- RETRY_INITIAL / RETRY_MAX_INTERVAL / RETRY_FACTOR
(durée / durée / nombre, facultatif) Calendrier de backoff exponentiel entre les tentatives de relais. Par défaut
300 s/2 h/2.- MAX_LIFETIME
(durée, facultative) Combien de temps un message peut rester dans le pipeline avant qu’un échec transitoire ne devienne permanent. Par défaut
5 dde temps réel, mais écrivez-le avec les unitésh/m/s— l’analyseur rejette l’unité calendaired.- DELAY_DSN_AFTER
(durée, facultative) Lorsqu’il est réglé, un DSN
Action: delayedà usage unique est envoyé une fois qu’un message encore non remis a été en file au moins aussi longtemps et que l’expéditeur a demandéNOTIFY=DELAY. Doit utiliser les unitésh/m/s. Non réglé le désactive.- MAX_HOP_COUNT
(nombre, facultatif) Nombre maximal d’en-têtes
Received:avant que le message ne soit traité comme une boucle et marqué en échec permanent. Par défaut30.- POSTMASTER
(chaîne, facultative) Adresse qui reçoit un double rebond, comme pour pepsi-stage-relay-to-internet(1) ci-dessus. La copie a l’expéditeur nul et suit la route du domaine de l’adresse : l’une des sections
[pepsi-stage-relay-to-smarthost-mta-*]doit donc servir ce domaine.- ADDRESS_FAMILY
(facultatif) La famille d’adresses dont hérite chaque entrée MTA à moins que sa propre section
[pepsi-stage-relay-to-smarthost-mta-*]ne la redéfinisse :any(par défaut),ipv4(aussiv4/v4only) ouipv6(v6/v6only). Même option, mêmes orthographes, que celle de pepsi-stage-relay-to-internet(1) ci-dessus.- PUBLIC_IP
(chaîne, facultative) Les adresses publiques depuis lesquelles ce relais émet, lues par pepsi-setup(1) pour construire l’enregistrement SPF. Cette option des étapes de relais est documentée sous L’option d’identité de sortie : PUBLIC_IP ci-dessous.
- DNS_SERVERS
(chaîne, facultative) Résolveurs, dans la syntaxe de
[pepsi] DNS_SERVERS, pour les recherchesTLSADANE. Lorsqu’il n’est pas défini,[pepsi] DNS_SERVERSs’applique, et à défaut leresolv.confdu système.Consultés pour chaque entrée MTA chiffrante dont le
DANEn’est pasoff(la valeur par défaut eststrict) ; le résolveur doit valider DNSSEC, et un worker démarré avec DANE activé avertit lorsqu’il n’est ni une adresse loopback ni atteint partls://ouhttps://.- DNS_TIMEOUT
(durée, facultative) Délai par requête pour les recherches
TLSADANE. Par défaut[pepsi] DNS_TIMEOUT, sinon5 s.
95.2.1.1.22.12. Options de l’étape de rebond¶
Une section [stage-<name>] avec PROGRAM = pepsi-stage-bounce lit en outre, depuis sa propre section :
- SERVER_NAME
(chaîne, obligatoire) Nom d’hôte utilisé dans les champs
From:etReporting-MTAdu rebond généré et dans son domaine deMessage-ID, par exemplemail.example.org.- POSTMASTER
(chaîne, facultative) Adresse
From:des rebonds générés (Mail Delivery Subsystem <POSTMASTER>) et l’identité de signature DKIM — le rebond est signé en tant que domaine de cette adresse, dont pepsi-setup(1) provisionne les clés. Par défautpostmaster@<SERVER_NAME>.- NEXT_STAGE
(chaîne, requise pour cette étape) L’étape vers laquelle le rebond réécrit avance. Comme le rebond est laissé non signé, c’est normalement une étape pepsi-stage-dkim-sign(1) (qui le signe en tant que domaine du postmaster), qui à son tour pointe vers une étape de remise telle que pepsi-stage-relay-to-internet(1).
- BOUNCE_MESSAGE
(chaîne, facultative) Nom du modèle qui rend la partie lisible par un humain (
text/plain) du rebond. Le fichier de modèle estbounce-<NAME>.<lang>.bodysous leTEMPLATE_DIRde[pepsi]; c’est un modèle Mustache.<lang>suit lestate.languagedu message (la langue détectée dans le message d’origine, dont l’expéditeur reçoit le rebond) dans son ordreq, avec repli surbounce-<NAME>.en.body, qui doit exister. Lorsque l’option n’est pas réglée, ou lorsque le rendu échoue, un avis intégré en anglais est utilisé à la place, de sorte qu’un rebond est toujours produit. Trois familles de modèles sont installées parmake install:bounce-default,bounce-language(la politique de langue de pepsi-stage-block-language(1)) etbounce-payment(la barrière impayée de pepsi-stage-anti-spam(1)).Tout le
statedu message, sauf ce qu’ont noté les étapes cryptographiques entrantes (state.crypto,state.encrypted,state.signature_verified), est passé au modèle comme contexte de rendu, augmenté des variables de commoditéserver_name,postmaster,bounce_to,failed_recipient,diagnostic,actionet des booléensfailed/delayed/delivered. En particulier, l’étape de remise enregistre un détail structuré du saut suivant sousstate.bounce—remote_mta,smtp_code,enhanced_status,phaseetreply_text— de sorte que le modèle puisse énoncer précisément pourquoi le MTA suivant a refusé le message. Lorsqu’unstate.bounce.enhanced_status(RFC 3463) est présent, il est aussi utilisé pour le champStatus:lisible par machine du DSN.- RET_FULL_MAX_SIZE
(entier, facultatif) Le plus grand message original, en octets, qu’un rebond
RET=FULLrenvoie en entier. Par défaut262144(256 Kio) ;0supprime la limite.La RFC 3461 §6.2 dit que le message complet « DEVRAIT être renvoyé » lorsque l’expéditeur a posé
RET=FULLsur leMAIL FROM, et permet explicitement de ne renvoyer que les en-têtes lorsque le message « dépasse une certaine taille définie par l’implémentation » — la limite fait donc partie du comportement conforme, elle n’y échappe pas. Sans elle, un message de 40 Mo en échec deviendrait un rebond de 40 Mo envoyé à un expéditeur qui passe déjà une mauvaise journée. Au-dessus de la limite, le DSN se rabat surtext/rfc822-headers, exactement comme le fait un rebondRET=HDRS(ou sansRET), et le repli est journalisé.Le corps n’est extrait de la base que pour un message dont l’expéditeur l’a demandé et qui reste sous la limite ; un rebond ordinaire ne charge toujours que le bloc d’en-têtes.
Un message arrivé chiffré n’est jamais renvoyé en entier, quoi que dise
RET: le DSN ne cite que ses champsFrom,Sender,To,Cc,DateetMessage-ID. Voir pepsi-stage-bounce(1).- BOUNCE_UNAUTHENTICATED
(``drop`` ou ``send``, facultatif) Que faire d’un rapport adressé à un expéditeur d’enveloppe que le message entrant n’a pas authentifié. Par défaut
drop.Le spam falsifie son expéditeur d’enveloppe, si bien qu’un rebond le concernant part vers un tiers innocent. C’est le backscatter : les destinataires se plaignent, et l’IP de cet hôte finit sur des listes noires. Avec
drop, un rapport n’est envoyé que lorsque :le message provient de l’un de nos propres utilisateurs (
state.local_origin) ;SPF a réussi pour le domaine de l’expéditeur d’enveloppe ; ou
une signature DKIM alignée a réussi pour un domaine
From:qui est le domaine de l’expéditeur d’enveloppe, ou un parent ou enfant de celui-ci ; ouune erreur DNS temporaire a interrompu une vérification qui aurait pu établir l’un de ces points, et ni SPF ni DMARC n’ont franchement échoué. Seule compte une erreur concernant le propre domaine de l’expéditeur d’enveloppe : SPF se terminant par
temperrorou, avec unFrom:de ce domaine, DMARC ou une signature de ce domaine dans le même cas.
Tout le reste est abandonné et journalisé comme avertissement. Un message créé par une étape, plutôt qu’arrivé par SMTP, ne porte aucun enregistrement d’authentification et fait toujours l’objet d’un rapport.
sendenvoie un rapport à chaque expéditeur, authentifié ou non.
The failed recipient and diagnostic quoted in the bounce are taken from the
state left on the row by the delivery stage that routed the message here
(see BOUNCE_STAGE above). When there is no such state.bounce, because
the message failed on this host (a stage error past MAX_LIFETIME or marked
permanent, a crashed or hung worker, or a row that pepsi-failure-bouncer(1) moved here), the row is split into one row per recipient, each recipient’s
own NOTIFY/ORCPT/RET from state.dsn is honoured, and the DSN
carries a generic diagnostic chosen by state.failure_class;
state.last_error is never copied into it. The DSN replaces the message’s
state with retry_since, so the stages after this one count their
MAX_LIFETIME from when the DSN was built.
95.2.1.1.22.13. Options de pepsi-stage-discard¶
Une étape avec PROGRAM = pepsi-stage-discard supprime le message (un puits de staging / test). Elle ignore NEXT_STAGE — un rejet est toujours terminal — et lit :
- DISPOSITION
(facultatif) L’issue simulée :
success(défaut) traite le message comme remis ;failurele traite comme un échec de remise permanent.- BOUNCE
(booléen, facultatif) Si le rejet peut émettre un DSN du tout. Par défaut
no.- BOUNCE_STAGE
(chaîne, facultative) L’étape qui génère le DSN, vers laquelle un rejet rapportable est acheminé (normalement une étape pepsi-stage-bounce(1)). En son absence, rien n’est émis et la ligne est simplement supprimée.
Le chemin de succès consulte aussi l’indicateur partagé [pepsi] ORIGINATE_SUCCESS_DSN ; un message à expéditeur nul ne rebondit jamais.
95.2.1.1.22.14. Options de pepsi-stage-anti-spam¶
Une étape avec PROGRAM = pepsi-stage-anti-spam lit (outre un NEXT_STAGE) :
- BOUNCE_STAGE
(chaîne, facultative) L’étape vers laquelle est acheminé un message encore impayé à l’échéance : normalement une étape pepsi-stage-bounce(1) (un DSN de rejet, honorant le
NOTIFYde l’expéditeur) ou une étape pepsi-stage-discard(1) (abandon silencieux). En son absence, un message non payé est simplement supprimé.- BOUNCE_TARGET_STAGE
(string, optional) Where a returning bounce that carries no valid ``Pepsi-Origin`` proof is routed, that is, a message with the null sender that claims to report on mail of ours, although we cannot show that we originated that mail (see The [pepsi-origin] Section). Without one such a message takes the ordinary NEXT_STAGE path, past the payment gate: a null-sender message is never gated, since a bounce must not be bounced, so a forged bounce reaches the mailbox. pepsi-setup(1)
--wizardtherefore writesBOUNCE_TARGET_STAGE = discard-rejected, a pepsi-stage-discard(1) sink that it also emits, whenever it configures the stage (it always writes[pepsi-origin]): the forged bounce is dropped, with the verdict in the log. Point it at a quarantine or review stage instead to keep such messages for inspection: a legitimate bounce that quotes little of the original, has passed a header-stripping gateway or returns after the two-week nonce window cannot be verified either and is dropped by the sink. pepsi-setup(1) warns about a stage that leaves the option unset.- ORDER_CHOICES
(JSON, obligatoire) Le tableau
choicesd’une commande Taler v1, utilisé verbatim : un ou plusieurs objetsOrderChoicedécrivant les paiements acceptés (par exemple plusieurs montants dans différentes devises, ou des entrées/sorties de famille de jetons). Voir l’API marchand GNU Taler.- PAYMENT_DEADLINE
(durée, facultative) Combien de temps le message est retenu
pauseden attente de paiement avant d’être rejeté ; aussi lepay_deadlinede la commande. Utilise les unitésh/m/suniquement (les unités calendaires telles quedsont rejetées). Par défaut48 h.- DELAY_DSN_AFTER
(durée, facultative) Envoyer à l’expéditeur une notification d’état de remise différée (RFC 3461) à usage unique une fois qu’un message encore impayé a été retenu aussi longtemps, sans libérer le message — il reste en pause jusqu’à PAYMENT_DEADLINE. Le DSN n’est envoyé que lorsque l’expéditeur a demandé
NOTIFY=DELAYet qu’un BOUNCE_STAGE est câblé (il y est acheminé aveckind = delay), et seulement lorsque ce moment tombe strictement avant PAYMENT_DEADLINE. Utilise les unitésh/m/suniquement. Non réglé (le défaut) désactive les avertissements de délai.- SUMMARY
(chaîne, facultative) Résumé de commande lisible par un humain montré au payeur. Par défaut
E-mail delivery.- FULFILLMENT_MESSAGE
(chaîne, facultative) Message montré au payeur après un paiement réussi. Par défaut
Your e-mail has been queued for delivery.- BLOCK_RESPONSE_STAGE
(chaîne, facultative) L’étape à laquelle la réponse automatique de demande de paiement est injectée — habituellement la tête d’une chaîne de signature/relais (par exemple une étape pepsi-stage-dkim-sign(1)). Doit référencer une étape existante. Lorsqu’il n’est pas réglé, aucune réponse n’est envoyée (le message est tout de même en pause en attente de paiement).
- BLOCK_RESPONSE_FROM
(chaîne, facultative) L’en-tête
From:de la réponse automatique. Lorsqu’il n’est pas réglé, par défaut le destinataire original (la boîte aux lettres protégée).- BLOCK_RESPONSE_SUBJECT
(chaîne, facultative) Le
Subject:de la réponse automatique. Par défautPayment required to deliver your e-mail.- BLOCK_RESPONSE_SUPPRESS
(durée, facultative) La fenêtre par expéditeur de la réponse automatique : un expéditeur à qui une demande de paiement a déjà été envoyée pour la même boîte protégée (le premier destinataire d’enveloppe) dans cette fenêtre n’en reçoit aucune pour le message suivant, qui reste néanmoins retenu dans l’attente du paiement. La demande part vers un expéditeur d’enveloppe que personne n’a vérifié, de sorte que sans fenêtre, un flot de messages portant un même expéditeur falsifié devient le même flot de demandes à cette adresse. Revendiqué et consigné en une seule instruction (
payment_request_should_sendsurpepsi.payment_request_reply, le schéma devacation_should_reply), de sorte que deux workers ne peuvent pas tous deux en envoyer une ; les lignes sont élaguées à mesure qu’elles vieillissent. Unitésh/m/suniquement (plafonné à un an) ;0 srépond à chaque message. Par défaut1 h.- REQUIRE_AUTHENTICATED
(booléen, facultatif) N’envoyer la demande de paiement qu’à un expéditeur dont le domaine d’enveloppe a réussi SPF ou dont le domaine du
From:a réussi DMARC ; le message est retenu en attente de paiement dans les deux cas. Par défautno: unfailcertain ne reçoit jamais de demande, maissoftfail,neutral,noneet les erreurs temporaires en reçoivent une, de sorte qu’un expéditeur dans un domaine qui ne publie aucun des deux enregistrements apprend pourquoi son courrier est retenu.yesferme la seule façon dont un expéditeur d’enveloppe falsifié dans un tel domaine peut faire écrire cet hôte à une adresse choisie par le falsificateur. Même option que dans[stage-<vacation>]et[stage-<list-command>].- PAYMENT_MESSAGE_DEFAULT_LANGUAGE
(chaîne, facultative) La langue de repli pour le corps de la réponse automatique, utilisée lorsque le message ne porte aucune
state.languagedétectée ou qu’aucune des langues détectées n’a de modèlepayment-request.<lang>.body(sous[pepsi]TEMPLATE_DIR). Ce modèle doit exister (pepsi-setuple vérifie chaque fois que BLOCK_RESPONSE_STAGE est défini). Insensible à la casse. Par défauten.
L’étape nécessite aussi la section partagée [pepsi-payments] (le backend marchand et le jeton d’accès, documentés ci-dessous) et, pour que le webhook de paiement libère les messages en pause, le RESUME_AUTHORIZATION_TOKEN de [pepsi-httpd] (voir pepsi-httpd(1)).
95.2.1.1.22.15. Options de pepsi-stage-auto-pay¶
Une étape avec PROGRAM = pepsi-stage-auto-pay lit :
- MAX_TOTAL
(montant, obligatoire) Le montant maximal que cette étape dépense, au total, pour remettre un message original : un montant GNU Taler
CURRENCY:VALUE(par exempleEUR:5). Le plafond est cumulatif sur chaque demande de paiement revenant pour ce message (toutes partageant un nonce Pepsi-Origin, par exemple la diffusion d’une liste de diffusion) et monodevise : une demande dans toute autre devise n’est pas payée. L’opérateur peut le redéfinir pour un compte avec pepsi-settings(1) ; un compte ne peut pas le modifier par e-mail : pepsi-stage-edit-settings(1) refuse cette option, MAX_TOTAL_PER_DAY et la sélection du wallet, si permissif que soit son EDITABLE_STAGES.- MAX_TOTAL_PER_DAY
(montant, obligatoire sauf si MAX_TOTAL vaut zéro) Le montant maximal qu’un wallet peut dépenser en demandes de paiement sur toute période de 24 heures (une fenêtre glissante), quel que soit le nombre de messages originaux. MAX_TOTAL ne fournit pas ce plafond global, puisqu’un correspondant qui a reçu k de nos messages peut exiger MAX_TOTAL pour chacun. Le wallet suit WALLET_MODE/WALLET_SCOPE : le propre wallet d’un utilisateur local, le wallet par expéditeur du compte partagé, ou son wallet unifié unique (la limite est alors celle du déploiement). Jamais par correspondant : les listes de diffusion et les alias rendent la partie qui exige le paiement impossible à connaître. Doit être dans la devise de MAX_TOTAL. Appliqué atomiquement avec MAX_TOTAL par
auto_pay_try_spendsur le registrepepsi.auto_pay_spend; un paiement qui échoue à se régler est recrédité. Une section avec un MAX_TOTAL non nul et sans limite quotidienne fait refuser de démarrer au worker (et refuser la configuration à pepsi-setup(1)) : MAX_TOTAL borne un message, de sorte qu’un mot de passe de soumission volé viderait sinon le wallet un message à la fois.- NEXT_STAGE
(chaîne, obligatoire) Où un message est transféré lorsqu’il n’est pas une demande de paiement, n’est pas prouvablement nôtre, ou n’est pas payé (hors budget / échec de règlement). pepsi-setup(1) refuse une étape qui n’en a pas, ou dont la valeur ne nomme aucune étape.
- WALLET_MODE
(``local-user`` | ``shared``, par défaut ``shared``) Quel compte le helper de wallet utilise pour payer.
local-userabandonne ses privilèges vers le propre login local du destinataire du rebond (l’expéditeur original) et utilise le wallet par défaut de cet utilisateur — le destinataire doit se résoudre en un compte local permis (le test LOCAL_DOMAINS/TARGETS/RECIPIENT_DELIMITER, comme pour pepsi-stage-relay-to-maildir(1)).sharedabandonne ses privilèges vers un unique compte dédié (WALLET_USER).- WALLET_USER
(chaîne, par défaut ``pepsi-wallets``) Le compte partagé vers lequel le helper abandonne ses privilèges en
WALLET_MODE = shared; son répertoire personnel contient la ou les bases de données de wallet. Son groupe principal doit être le groupe sous lequel pepsi-helper-auto-pay(1) est installé (pepsi-wallets) ; le helper refuse tout autre compte, de sorte que c’est root, et non la configuration, qui décide sous quel compte le wallet s’exécute.- WALLET_SCOPE
(``per-sender`` | ``unified``, par défaut ``per-sender``) En mode
shared, comment les bases de données de wallet du compte partagé sont séparées : une par adresse d’expéditeur original (per-sender), ou un unique wallet partagé par tous (unified— par exemple une entreprise où des wallets individuels n’ont pas de sens).- WALLET_CLI
(ignorée) Le helper exécute
taler-wallet-cli(par défaut/usr/bin/taler-wallet-cli) et aucun autre programme ; le chemin est fixé à la construction de Pepsi (make TALER_WALLET_CLI=…ou./configure --with-taler-wallet-cli=…). pepsi-setup(1) avertit lorsque l’option est encore définie.- WALLET_PAY_OPTIONS
(chaîne, par défaut aucune) Arguments supplémentaires ajoutés à l’invocation de paiement du wallet, séparés par des espaces. Le littéral
nonene passe aucune option supplémentaire. (--yeset--choice-index 0sont toujours ajoutés par le helper pour confirmer le paiement et nommer le choix du contrat qui a été tarifé.) Rien n’est nécessaire ici par défaut — lehandle-uridu wallet attend déjà que le paiement atteigne un état terminal.- HELPER
(chaîne, par défaut ``pepsi-helper-auto-pay``) Le binaire de helper de wallet privilégié (un nom sur le
$PATHou un chemin absolu).
Les options suivantes activent et configurent le rôle de self-service de wallet (un message soumis localement à l’adresse de contrôle opère le wallet propre à l’expéditeur par e-mail ; voir pepsi-stage-auto-pay(1)) :
- RESPONSE_STAGE
(chaîne, facultative) L’étape à laquelle la réponse self-service est injectée (de sorte qu’elle soit signée en DKIM et relayée). La régler active le rôle self-service ; la laisser non réglée signifie que l’étape ne paie que les demandes entrantes.
- CONTROL_LOCAL_PART
(chaîne, par défaut ``pepsi-wallet``) La partie locale de l’adresse de contrôle du wallet : un message d’origine locale vers
<part>@<served-domain>est un message de contrôle de wallet.- RESPONSE_FROM
(chaîne, facultative) Le
From:de la réponse self-service. Par défaut<{CONTROL_LOCAL_PART}@{domain}>pour le domaine servi adressé.- RESPONSE_SUBJECT
(chaîne, par défaut ``Pepsi wallet``) Le
Subject:de la réponse self-service.
Un withdraw (rechargement) manuel nomme l’exchange GNU Taler depuis lequel retirer dans la requête (Subject: withdraw CURRENCY:VALUE EXCHANGE-URL) ; parce qu’un wallet est multi-devise et peut retirer depuis plusieurs exchanges, il n’y a pas d’option d’exchange côté serveur.
L’étape utilise aussi la section partagée [pepsi-origin] (le secret de preuve d’origine) pour vérifier qu’une demande concerne un courrier que ce déploiement a réellement envoyé ; sans elle, aucune demande ne peut être vérifiée et aucune n’est payée (le self-service n’est pas affecté). Tout le travail de wallet est effectué par le pepsi-helper-auto-pay(1) setuid-root ; le binaire de l’étape est installé SGID pepsi-wallets afin que son worker puisse l’exec.
95.2.1.1.22.16. Options de pepsi-stage-check-whitelist¶
Une étape avec PROGRAM = pepsi-stage-check-whitelist lit :
- WHITELIST_NAME
(liste, obligatoire) Les groupes
whitelist_nameà consulter dans la tablepepsi.whitelist— une liste séparée par des virgules, interrogée en un seul= ANY(...), et non un nom unique.Une entrée peut être un modèle contenant
{localpart}ou{login}, développé par destinataire d’enveloppe avant la requête :{localpart}est la partie locale dépouillée de sa sous-adresse et mise en minuscules, et{login}le login passwd auquel elle se résout. C’est ainsi qu’un espace de noms par utilisateur géré avec pepsi-whitelist(1) — les noms<login>/segment— est consulté sans redéfinition de paramètres par adresse. Par exempleWHITELIST_NAME = correspondents, {localpart}/correspondents
consulte le groupe partagé et celui propre à chaque destinataire.
- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(facultatif) Les mêmes options de localité, avec les mêmes valeurs par défaut, que les étapes de remise — lues ici pour résoudre
{login}(et pour retirer une sous-adresse pour{localpart}), et pour limiter RECORD_LIST_CONFIRMATIONS aux destinataires locaux.- RECORD_LIST_CONFIRMATIONS
(booléen, facultatif) Noter chaque message entrant qui ressemble à une demande de confirmation d’abonnement d’une liste de diffusion (un unique
Message-ID:,confirmdans leSubject:, et une partie localeFrom:/Reply-To:/Sender:se terminant par-request,-confirm,-joinou-subscribe) danspepsi.list_confirmation, une fois par destinataire d’enveloppe local, afin que pepsi-stage-auto-whitelist(1) puisse apprendre la liste lorsque ce destinataire y répond (son LIST_WHITELIST_NAME). Noter n’ajoute rien à une liste blanche. Par défautno.- LIST_CONFIRMATION_DAYS
(entier, facultatif) Pendant combien de jours une demande de confirmation notée compte avant que
pepsi-queue gcne la supprime ; une réponse ultérieure n’apprend rien. De 1 à 90 ; par défaut7.- NEXT_STAGE
(chaîne, obligatoire) Où le message avance après la vérification (qu’il ait correspondu ou non). pepsi-setup(1) rejette une section qui n’en a pas, ou dont la valeur nomme une étape inexistante.
95.2.1.1.22.17. Options de pepsi-stage-auto-whitelist¶
Une étape avec PROGRAM = pepsi-stage-auto-whitelist lit :
- WHITELIST_NAME
(chaîne, obligatoire) Le groupe
whitelist_nameà peupler dans la tablepepsi.whitelist. Il devrait correspondre au groupe que la pepsi-stage-check-whitelist(1) entrante consulte. Un unique nom littéral dans la grammaire des noms de liste blanche : cette étape ne développe aucun marqueur{login}/{localpart}, de sorte qu’une valeur en contenant un est refusée. L’opérateur peut nommer n’importe quelle liste blanche, y compris une liste partagée par tous les utilisateurs locaux ; une valeur qu’un titulaire de compte définit par courrier via pepsi-stage-edit-settings(1) doit en nommer une de son propre espace de noms<login>/..., ou celle que la configuration de l’opérateur nomme pour lui.- DKIM_REQUIRED
(booléen, facultatif) Valeur stockée dans la colonne
dkim_requiredde chaque ligne que cette étape insère. Par défautyes.- DMARC_REQUIRED
(booléen, facultatif) Valeur stockée dans la colonne
dmarc_requiredde chaque ligne qu’insère cette étape : une réponse ne correspond alors que si elle a réussi DMARC, sur une signature DKIM alignée ou une réussite SPF alignée (ou si un scelleur ARC de confiance s’en est porté garant). Impliqué pardkim_required; avec DKIM_REQUIRED= no, c’est ce qui garde un correspondant dont le domaine ne signe pas lié à une identité authentifiée. Par défautyes.- LIST_WHITELIST_NAME
(chaîne, facultative) Apprendre les listes de diffusion. Un message sortant soumis localement peut répondre à une demande de confirmation d’abonnement que pepsi-stage-check-whitelist(1) a notée (RECORD_LIST_CONFIRMATIONS) pour ce même expéditeur : il est adressé à l’adresse de contrôle de la demande, et son
In-Reply-To:nomme la demande. LeList-Idde la liste est alors inscrit dans cette liste blanche comme lignelist-idà expiration. La valeur est un modèle qui doit commencer par{login}/(par exemple{login}/lists), développé pour l”expéditeur d’enveloppe, de sorte qu’une liste qu’un utilisateur a rejointe n’est jamais inscrite pour quelqu’un d’autre. Ledkim_requiredde la ligne est DKIM_REQUIRED et sondmarc_requiredDMARC_REQUIRED. Non défini (par défaut) : aucune liste n’est apprise. Ajoutez le même nom au WHITELIST_NAME de l’étape de vérification pour qu’il soit consulté.- LIST_MAX_IDLE_DAYS
(entier, facultatif) Pendant combien de jours une ligne de liste apprise reste en vigueur sans contribution correspondante ; chaque contribution authentifiée à laquelle l’étape de vérification la fait correspondre relance le décompte. Quitter une liste n’envoie aucun signal, cette option retire donc les lignes des listes qu’un utilisateur a quittées. De 1 à 3650 ; par défaut
180.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(facultatif) Les mêmes options de localité, avec les mêmes valeurs par défaut, que pepsi-stage-check-whitelist(1). Elles développent
{login}dans LIST_WHITELIST_NAME, et sont lues dans la section de l’opérateur lorsque pepsi-stage-edit-settings(1) juge le WHITELIST_NAME d’un titulaire de compte, pour résoudre le login du titulaire et donc son espace de noms<login>/....- NEXT_STAGE
(chaîne, obligatoire) Où le message avance après que les destinataires sont enregistrés. pepsi-setup(1) rejette une section qui n’en a pas, ou dont la valeur nomme une étape inexistante.
95.2.1.1.22.18. Options de pepsi-stage-autocrypt-learn¶
Une étape avec PROGRAM = pepsi-stage-autocrypt-learn lit :
- LEARN_KEYS
(booléen, facultatif) Stocker le matériel de clé propre à l’expéditeur trouvé dans le message (certificats de signataire S/MIME, parties
application/pgp-keyset en-têteAutocrypt:) au rang de confianceinbound, ouinbound-signedlorsqu’une signature DKIM alignée ayant réussi à l’ingress le couvrait (voir pepsi-stage-autocrypt-learn(1)), où il ne pourra jamais remplacer silencieusement une clé de meilleure source.YESpar défaut. Seul le matériel revendiquant l’adresse propre à l’expéditeur est conservé. Le même interrupteur note lesSMIMECapabilitiesque porte une signature S/MIME (l’enregistrement de capacités S/MIME par pair, indexé par le certificat de signature). Le désactiver fait que l’étape n’apprend plus aucune clé ni aucune capacité,LEARN_GOSSIPcompris ; elle note toujours qu’un correspondant détient l’une de nos clés (pepsi.peer_has_own_key).- LEARN_GOSSIP
(booléen, facultatif) Apprendre en outre les clés des autres destinataires depuis les champs
Autocrypt-Gossip:situés à l’intérieur d’un message arrivé chiffré (Autocrypt Level 1 §5.3), au ranggossip— le bas de l’échelle, sousinbound.YESpar défaut ; sans effet à moins queLEARN_KEYSne soit également activé.Cela rend possible une réponse à tous chiffrée vers un correspondant dont on n’a jamais reçu de courrier direct. Un champ n’est employé que s’il était véritablement à l’intérieur du texte chiffré, seulement si son
addrapparaît dans lesTo:,Cc:ouReply-To:propres au message, jamais pour l’adresse de l’expéditeur lui-même, et jamais pour une adresse deLOCAL_DOMAINS— personne ne peut présenter à cet hôte ses propres utilisateurs. Une clé gossipée ne peut jamais déloger une clé de meilleure source et ne fait jamais compter une signature comme vérifiée.Notez l’asymétrie avec la moitié émettrice (
[stage-encrypt] AUTOCRYPT_GOSSIP,NOpar défaut) : émettre du gossip redistribue les clés de tiers à des correspondants qui ne les ont pas demandées, tandis que le lire ne fait que remplir le cache propre à cet hôte. Un opérateur qui veut que les présentations soient stockées mais jamais employées règle[pepsi-keydiscovery] MIN_TRUST = harvestedplutôt que de désactiver ceci.- LEARN_FROM_SPAM
(booléen, facultatif) Si un message que le pipeline a déjà noté comme spam (
state.spam = true) peut tout de même enseigner une clé.NOpar défaut, ce qui est le « les messages DEVRAIENT être ignorés … lorsque le MUA croit que le message est du spam » d’Autocrypt Level 1 §5.3.C’est une option plutôt qu’une règle fixe parce que la croyance est celle de Pepsi : un opérateur dont la notation de spam est délibérément lâche peut préférer la continuité des clés à la règle. Notez qu’honorer le défaut exige que l’étape soit placée après ce qui règle
state.spam— voir pepsi-stage-autocrypt-learn(1).- ACCEPT_ROTATION
(chaîne, facultative) Quand la règle « le plus récent l’emporte » du niveau Autocrypt peut remplacer la clé
inbound-signed/inbound/gossipstockée d’un correspondant par la clé que porte un message plus récent.newest(la valeur par défaut) correspond à Autocrypt Level 1 : une date effective strictement plus récente suffit, à échelon égal.expiredexige en outre que chaque clé stockée pour cette adresse et ce protocole soit révoquée ou expirée (d’après sa validité consignée ou sonexpires_at) ; sinon la clé stockée est conservée et l’offre est retenue — auditée commekey.peer.rotate.heldet signalée aux destinataires comme une rotation. Une clé issue d’un message non signé ne remplace jamais une clé qu’a apportée un message signé DKIM, quoi que dise cette option ; une clé signée qui remplace une clé non signée est régie par elle comme une rotation. Un remplacement par une source strictement mieux classée extérieure à ce niveau ne l’est pas. Toute autre valeur est une erreur de configuration. Dans tous les cas, chaque rotation écrit une ligne d’auditkey.peer.rotate; voir pepsi-stage-autocrypt-learn(1).- RESPONSE_STAGE
(chaîne, facultative) L’étape à laquelle les avis de changement de clé sont injectés : lorsque la clé d’un correspondant fait l’objet d’une rotation ou est retenue, chaque destinataire d’enveloppe local du message qui en est la cause reçoit par courrier le modèle
key-rotation.<lang>.body(expéditeur nul,From: postmaster@<domain>). Normalement l’étape de signature DKIM, comme leRESPONSE_STAGEde pepsi-stage-encrypt(1). Doit nommer une étape existante ; pepsi-setup(1) exige aussikey-rotation.en.bodydans[pepsi] TEMPLATE_DIR. En son absence, les changements sont audités et journalisés mais personne ne reçoit de courrier.- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(facultatif) Les options de localité partagées. Seul
LOCAL_DOMAINSest consulté : pour refuser un champ de gossip nommant une adresse que cet hôte sert (une substitution de clé plutôt qu’une présentation), et pour choisir quels destinataires d’enveloppe sont les nôtres, à qui envoyer un avis de changement de clé. Vaut par défaut[pepsi-ingress]ACCEPTED_DOMAINS.- NEXT_STAGE
(chaîne, obligatoire) Où le message avance une fois que l’étape a appris ce qu’elle pouvait. L’étape ne consomme jamais un message : un NEXT_STAGE manquant est donc refusé par pepsi-setup(1) et produit une erreur à l’exécution.
95.2.1.1.22.19. Options de pepsi-stage-detect-language¶
Une étape avec PROGRAM = pepsi-stage-detect-language lit :
- NEXT_STAGE
(chaîne, obligatoire) Où le message avance après la classification (qu’une langue ait été enregistrée ou non). Le worker refuse de démarrer sur une section qui n’en a pas.
- LANGUAGES
(liste, facultative) Les langues candidates, sous forme de codes ISO 639-1 séparés par espaces ou virgules (sans distinction de casse) ; au moins deux codes distincts sont requis. Le jeton
*représente toute langue prise en charge (75 avec le détecteur fourni) et peut être combiné à des codes explicites. La détection ne renvoie jamais que des langues de cet ensemble : il devrait donc couvrir les langues que vous attendez de recevoir. Par défaut un large ensemble courant (en de fr es it pt nl pl ru tr ar zh ja).Narrow it. Every enabled language adds to the memory that each worker process uses, and, more importantly, every language that your traffic never contains still competes for probability. The stage removes non-prose (URLs, addresses, base64 blobs, DNS records) from the body before classifying, which stops a single such token from deciding the answer outright; what remains after that is a genuine contest between the candidates, and a language in which nobody writes to you can still win it on a short message. pepsi-detect-language(1) reclassifies a saved message against any candidate set, so a narrower list can be tried before it is configured.
95.2.1.1.22.20. Options de pepsi-stage-block-language¶
Une étape avec PROGRAM = pepsi-stage-block-language lit :
- NEXT_STAGE
(chaîne, obligatoire) Où avance un message notant au-dessus de THRESHOLD — et, sous
ENFORCEMENT = soft, où continue aussi un message signalé. pepsi-setup(1) refuse une section qui n’en a pas.- BOUNCE_STAGE
(chaîne, requise lorsqu’un message peut faire l’objet d’un rebond) Où est acheminé un message notant au niveau ou en dessous de THRESHOLD afin qu’un DSN d’échec puisse être engendré (typiquement pepsi-stage-bounce(1)). Consultée seulement sous
ENFORCEMENT = hard, où elle est requise : pepsi-setup(1) refuse une sectionhardqui n’en a pas, et le worker refuse de démarrer dessus (une surcharge par adresse qui passe àhardsans elle fait échouer le message bloqué). Elle vaut la peine d’être définie même soussoft, afin que passer àhardsoit une modification d’un seul mot.- ENFORCEMENT
(``hard`` | ``soft``, facultatif) Ce qui arrive à un message qui échoue à la politique.
hard(le défaut) l’achemine vers BOUNCE_STAGE, de sorte qu’il ne soit pas remis.softle remet tout de même, marqué : SUBJECT_FLAG_LABEL est ajouté à sonSubject:, un en-têteX-Pepsi-Detected-Languagesconsigne ce qui a été détecté, et le message avance vers NEXT_STAGE.softmarque exactement les messages quehardaurait fait rebondir, ce qui en fait un mode d’entraînement : exécutez-le un moment et les marques dans la boîte aux lettres sont un aperçu fidèle de ce que l’application refuserait, sans coût pour un correspondant dont le courrier n’a pas encore servi à régler les listes. Étant une option d’étape ordinaire, elle est redéfinissable par adresse (pepsi-settings(1)), de sorte qu’un compte puisse rester à l’entraînement tandis que le reste du déploiement applique.Notez que la réécriture du
Subject:casse la signature DKIM de l’expéditeur et l”AMSARC de ce serveur (tous deux sur-signentSubject), exactement comme le fait leVACATION_TAGde pepsi-stage-vacation(1). Cela ne coûte rien sur une branche qui se termine par une remise locale, mais coûte sur une branche qui relaie plus loin.- SUBJECT_FLAG_LABEL
(chaîne, facultative) La marque ajoutée au
Subject:d’un message signalé sousENFORCEMENT = soft.[!LANG]par défaut. Ajoutée seulement lorsque l’objet ne la contient pas déjà (sans distinction de casse), de sorte qu’une réponse qui la recite à travers l’étape n’en accumule pas une seconde. Une valeur vide réapplique le défaut ; il n’y a aucun moyen de désactiver la marque, puisque ne rien signaler revient à laisser l’étape hors du pipeline.- WHITELIST
(liste, facultative) Langues dont la probabilité est ajoutée au score, sous forme de codes ISO 639-1 séparés par espaces/virgules (insensible à la casse) plus le pseudo-code facultatif
none(correspondant au courrier non détecté). Vide lorsqu’il n’est pas réglé. Une entrée peut porter d’autres sous-étiquettes (de-CH) ; chaque entrée est une plage de langue comparée par le filtrage de base de la RFC 4647 §3.3.1, de sorte quedecorresponde aussi à unde-CHdétecté tandis quede-CHne corresponde pas à undenu.- BLACKLIST
(liste, facultative) Langues dont la probabilité est soustraite du score, même syntaxe que WHITELIST. Vide lorsqu’il n’est pas réglé. Une langue peut apparaître sur au plus une des deux listes.
Au moins une des deux listes doit être non vide : les deux étant vides, chaque message obtient le score
0.0, que la barrière strictescore > THRESHOLDfait alors échouer, si bien que l’étape rebondirait (ou marquerait) tout le courrier. La configuration est refusée plutôt qu’acceptée, et ce refus empêche « je remplirai les listes plus tard » de provoquer une panne silencieuse.- THRESHOLD
(flottant, facultatif) Le score qu’un message doit dépasser pour avancer. Par défaut
0.0.
95.2.1.1.22.21. Options de pepsi-stage-vacation¶
Une étape avec PROGRAM = pepsi-stage-vacation répond au courrier qui arrive pendant que le destinataire d’enveloppe est absent. Chaque option ci-dessous est redéfinissable par adresse, et c’est ainsi que la fonctionnalité est censée être employée : la section INI est le défaut de l’opérateur (pas de congé), et les dates de congé de chaque utilisateur — et, s’il le souhaite, son propre texte de message — viennent de sa ligne pepsi.settings ou d’une portée config_override. Voir pepsi-stage-vacation(1).
- NEXT_STAGE
(chaîne, obligatoire) Où le message continue. Il continue toujours : cette étape ajoute une réponse, elle ne consomme jamais un message. pepsi-setup(1) rejette une étape qui en est dépourvue.
- RESPONSE_STAGE
(chaîne, obligatoire) Où l’avis d’absence est injecté comme nouveau message à expéditeur nul, afin qu’il soit signé et relayé (typiquement l’étape de signature DKIM). pepsi-setup(1) vérifie qu’elle nomme une étape existante.
- VACATION_RANGES
(liste, facultative) Intervalles
YYYY-MM-DD:YYYY-MM-DDséparés par des virgules ou des espaces, indiquant les jours d’absence du destinataire. Les deux bornes sont des jours entiers inclus dans le fuseau horaire du serveur ; une fin vide (2026-08-01:) est un congé à durée indéterminée et une date seule est ce jour unique. Vide lorsqu’elle n’est pas définie, ce qui désactive l’étape pour cette adresse — le défaut, et l’état de tout destinataire qui n’a jamais configuré de congé. Un intervalle dont la fin précède le début est rejeté.- DEFAULT_LANGUAGE
(chaîne, facultative) La langue dont le message est employé lorsqu’aucune des langues détectées de l’expéditeur (
state.language) n’en a un.enpar défaut. Écrite avec l’un ou l’autre séparateur :pt_bretpt-BRsont la même étiquette.- DEFAULT_MESSAGE_SECTION
(chaîne, facultative) La section de configuration contenant un modèle de message en ligne par langue, sous la forme
<LANG> = <template>. Vaut par défautpepsi-vacation-default-message, livrée dans${DATADIR}/config.davec dix langues. Une optionMESSAGE_<LANG>par adresse de cette section-ci prime sur elle, langue par langue.- MESSAGE_<LANG>
(chaîne, facultative) Le texte d’avis propre à l’adresse pour une langue (
MESSAGE_EN,MESSAGE_DE_CH, …), un modèle Mustache dans lequel deux espaces deviennent un saut de ligne. Consulté avant DEFAULT_MESSAGE_SECTION pour cette seule langue. Comme c’est une option de la propre section de l’étape, c’est la seule forme qu’un utilisateur peut définir viapepsi.settings; la section nommée par DEFAULT_MESSAGE_SECTION est toujours lue dans la configuration de base.- EMERGENCY_CONTACT
(adresse, facultative) Une unique adresse nue offerte au modèle de message sous le nom
{{EMERGENCY_CONTACT}}. Non définie par défaut, auquel cas le bloc{{#EMERGENCY_CONTACT}}d’un modèle est sauté. Un nom affiché ou une liste d’adresses est rejeté.- VACATION_TAG
(chaîne, facultative) Ajouté au
Subject:du message redirigé lorsqu’un avis a été envoyé, afin que le destinataire puisse voir quel courrier a reçu une réponse à sa place.[VACATION]par défaut ; la valeur sentinellenonedésactive le marquage. Une valeur vide ne le fait pas — l’analyseur lit une option vide comme absente, ce qui réapplique le défaut. L’ajout est idempotent.- SUPPRESS_DAYS
(entier, facultatif) Combien de temps après avoir répondu à un correspondant celui-ci peut recevoir une nouvelle réponse.
7par défaut (le défaut devacationen Sieve, RFC 5230 §4.1) ;0répond à chaque message. Ne doit pas dépasser3650(dix ans) — la valeur devient un intervalle SQL soustrait denow(), et une valeur plus grande place le résultat hors de la plagetimestamptz, ce qui ferait échouer chaque message vers l’adresse plutôt que la configuration qui l’a réglée.- REQUIRE_ADDRESSED_TO
(booléen, facultatif) Ne répondre que lorsque le destinataire apparaît dans
To:,Cc:,Resent-To:ouResent-Cc:(RFC 3834 §3), de sorte qu’une copie cachée ou un envoi en masse à une liste ramassée n’attire aucune réponse.yespar défaut.- REQUIRE_AUTHENTICATED
(booléen, facultatif) Ne répondre qu’à un expéditeur dont le domaine d’enveloppe a réussi SPF ou dont le domaine du
From:a réussi DMARC (le courrier soumis localement compte). Par défautno: unfailcertain ne reçoit jamais de réponse, un expéditeur non confirmé (softfail,neutral,none, une erreur temporaire) en reçoit toujours une.yeslaisse sans réponse un correspondant dans un domaine qui ne publie aucun des deux enregistrements, et en retour un expéditeur falsifié dans un tel domaine n’attire aucun avis. Les étapes de péage à l’envoi et de commandes de liste prennent la même option ; celle du secrétaire est activée par défaut. Quelle que soit sa valeur, un expéditeur qui n’a pas réussi reçoit une réponse sans ses propres mots : pas d’objet cité, et{{SENDER_NAME}}est son adresse plutôt que le nom d’affichage de sonFrom:.- SUBJECT_PREFIX
(chaîne, facultative) Préfixé à l’objet original pour former l’objet de l’avis.
Auto:par défaut (RFC 5230 §4.5). Un message sans objet donne le seul préfixe, et un objet déjà préfixé ne l’est pas deux fois. Le préfixe figure aussi seul pour un message arrivé chiffré et pour un expéditeur qui n’a réussi ni SPF ni DMARC.
95.2.1.1.22.22. Options de pepsi-stage-secretary¶
Une étape avec PROGRAM = pepsi-stage-secretary retient le courrier des expéditeurs qu’aucune liste blanche ne connaît et leur demande de confirmer en répondant (confirmation à l’envoi). Chaque option ci-dessous sauf NEXT_STAGE et BOUNCE_STAGE est redéfinissable par adresse, de sorte qu’un utilisateur peut définir son propre texte de défi ou sa PENALTY. Voir pepsi-stage-secretary(1).
- NEXT_STAGE
(chaîne, obligatoire) Où se poursuit le courrier en liste blanche, confirmé ou jamais soumis à un défi (un rebond, du courrier soumis localement).
- RESPONSE_STAGE
(chaîne, obligatoire) Où le défi et l’avis de confirmation sont injectés comme nouveaux messages à expéditeur nul (typiquement l’étape de signature DKIM).
- BOUNCE_STAGE
(chaîne, facultative) Le chemin d’expiration : où va le courrier retenu lorsque personne n’a confirmé à temps, que le défi a fait l’objet d’un rebond, ou que
state.spamvauttrue, et où va le courrier qui ne doit pas être soumis au défi lorsque UNCHALLENGEABLE_STAGE n’est pas défini. Lorsqu’elle n’est pas définie, un tel courrier est supprimé.- UNCHALLENGEABLE_STAGE
(chaîne, facultative) Où va le courrier qui ne doit pas être soumis à un défi : la RFC 3834 dit de ne pas y répondre, son verdict SPF ou DMARC est
fail, l’expéditeur est aussi un destinataire, sonFrom:n’est pas l’expéditeur d’enveloppe, l’expéditeur n’est pas authentifié, le plafond quotidien de l’expéditeur est épuisé, ou WHITELIST_NAME ne se développe pas pour les destinataires. Lorsqu’elle n’est pas définie, un tel courrier prend le chemin d’expiration.- WHITELIST_NAME
(chaîne, obligatoire) L’unique liste blanche dans laquelle un expéditeur confirmé est écrit ; peut être un modèle
{login}/{localpart}, développé par destinataire comme le fait pepsi-stage-check-whitelist(1). Une liste de noms est rejetée. L’opérateur peut nommer n’importe quelle liste blanche ; une valeur qu’un titulaire de compte définit par courrier via pepsi-stage-edit-settings(1) doit en nommer une de son propre espace de noms<login>/..., ou celle que la configuration de l’opérateur nomme pour lui.- CONTROL_LOCAL_PART
(chaîne, facultative) Partie locale de l’adresse de réponse
<CONTROL_LOCAL_PART>-<cookie>@<domain>.secretarypar défaut ; au plus 30 lettres ASCII, chiffres,.,_ou-, sans commencer ni finir par.ou-et sans...- HOLD_TIME
(durée, facultative) Combien de temps le courrier retenu attend.
120 hpar défaut ; unitésh,metsuniquement ; doit être positive.- REQUIRE_AUTHENTICATED
(booléen, facultatif) Ne soumettre à un défi qu’un expéditeur dont SPF ou DMARC a réussi.
yespar défaut.- MAX_CHALLENGES_PER_SENDER
(entier, facultatif) Nombre de défis qu’une adresse peut recevoir par période de 24 heures, toutes listes blanches confondues.
5par défaut ;0signifie aucune limite.- DKIM_REQUIRED
(auto|yes|no, facultatif) Le
dkim_requiredde la ligne de liste blanche qu’écrit une confirmation.auto(le défaut) le rend obligatoire lorsqu’un message retenu pour le défi a réussi DKIM (ou ARC avec DMARC) ; lorsqu’aucun ne l’a fait mais que l’un a réussi DMARC (une réussite SPF alignée, ou la dérogation d’un scelleur ARC de confiance), la ligne reçoitdmarc_requiredà la place.non’écrit ni l’un ni l’autre.- CONFIRM_NOTICE
(booléen, facultatif) Indiquer à un expéditeur confirmé que son courrier a été remis.
nopar défaut.- PENALTY
(chaîne, facultative) Ce que l’expéditeur accepte de payer si son message n’était pas sollicité, proposé au modèle sous la forme
{{PENALTY}}. Non définie par défaut.- SUBJECT_HINT_LENGTH
(entier, facultatif) Nombre de caractères de l’objet du message retenu que cite le défi.
8par défaut ;0omet l’indice ; au plus64.- TEMPLATE
(chaîne, facultative) Nom de base des modèles de défi
<TEMPLATE>.<lang>.bodysous[pepsi] TEMPLATE_DIR.secretary-challengepar défaut.- SUBJECT
(chaîne, facultative) L’objet du défi lorsqu’aucun
SUBJECT_<LANG>ne correspond à la langue choisie.Please confirm your message to {{RECIPIENT}}par défaut, et tant qu’il n’est pas défini, un texte choisi dans l’une des dix langues livrées reçoit à la place l’objet livré pour cette langue ; une valeur explicite est utilisée pour chaque langue dépourvue deSUBJECT_<LANG>.- DEFAULT_LANGUAGE
(chaîne, facultative) Langue utilisée lorsqu’aucune des langues détectées de l’expéditeur n’a de texte.
enpar défaut. pepsi-setup(1) exige un modèle ou unMESSAGE_<LANG>pour elle.- MESSAGE_<LANG>, SUBJECT_<LANG>, CONFIRM_MESSAGE_<LANG>
(chaîne, facultative) Texte du défi, objet du défi et texte de confirmation par langue, redéfinissant les modèles pour cette langue seulement.
- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER
(facultatif) Les options de localité partagées (pepsi-stage-relay-to-maildir(1)) : dans quels domaines une adresse de réponse peut se trouver, et comment se développent les marqueurs de nom de liste blanche.
LOCAL_DOMAINSvaut par défaut[pepsi-ingress] ACCEPTED_DOMAINS.
95.2.1.1.22.23. Options de pepsi-stage-if¶
Une étape avec PROGRAM = pepsi-stage-if branche sur un membre du JSON state du message :
- STATE_PATH
(chaîne, obligatoire) Le chemin séparé par des points dans le
statedu message dont la valeur est testée (noms de membres d’objet et indices entiers de tableau, par exemplespam,auth.dkim,dsn.rcpt.0.notify).- VALUE
(chaîne, obligatoire, non vide) La valeur à laquelle le membre à STATE_PATH est comparé, par sa forme textuelle scalaire naturelle (chaîne,
true/false, nombre décimal, ounull). Une option vide est lue comme non réglée.- TRUE_STAGE
(chaîne, obligatoire) Où le message avance lorsque la valeur est égale à VALUE. pepsi-setup(1) vérifie qu’elle nomme une étape existante.
- FALSE_STAGE
(chaîne, obligatoire) Où le message avance sinon (la valeur diffère, le chemin est absent, ou il se résout en un tableau/objet). pepsi-setup(1) vérifie qu’elle nomme une étape existante.
95.2.1.1.22.24. Options de pepsi-stage-milter¶
Une étape avec PROGRAM = pepsi-stage-milter remet le message à un daemon milter existant (le protocole de filtrage de courrier de sendmail/Postfix) et l’achemine selon le verdict du filtre. Voir pepsi-stage-milter(1), et notez en particulier que le filtre s’exécute après la mise en file, de sorte qu’un REJECT coûte un rebond là où un MTA aurait répondu 5xx à l’intérieur de la session SMTP.
- SOCKET
(chaîne, obligatoire) Où le daemon milter écoute, dans la grammaire
S=de sendmail (que Postfix accepte aussi) :unix:/path(ou son synonymelocal:/path),inet:host:port,inet:port@host,inet6:[addr]:portouinet6:port@addr. Un chemin nu sans schéma est rejeté. Pepsi se connecte à cette socket ; il ne démarre, n’arrête ni ne confine jamais le daemon derrière elle.- MILTER_NAME
(chaîne, facultative) Exportée au filtre comme macro
{daemon_name}et employée dans les messages de journal. Vaut par défaut le nom propre de l’étape.- ACCEPT_STAGE
(chaîne, facultative) Où
SMFIR_ACCEPTenvoie le message. Vaut par défaut NEXT_STAGE, ce qui fait d’accepter et de continuer la même chose ; réglez-la pour sauter par-dessus le reste d’une chaîne de filtres, ce que la liste de milters de Postfix fait nativement. pepsi-setup(1) vérifie qu’elle nomme une étape existante.- REJECT_STAGE
(chaîne, facultatif) Où
SMFIR_REJECTenvoie le message, et vers où les destinataires rejetés individuellement sont répartis. Vaut par défaut leBOUNCE_STAGEde la section. Pointez-la vers une pepsi-stage-discard(1) pour abandonner le courrier rejeté au lieu de le faire rebondir. pepsi-setup(1) vérifie qu’elle nomme une étape existante.- QUARANTINE_STAGE
(string, optional) Where
SMFIR_QUARANTINEsends the message. Unset means discard: Pepsi has no quarantine store, only a route. A quarantine request decides the routing regardless of the verdict that follows it, because a sendmail milter quarantines and then still returns an accept. pepsi-setup(1) checks that it names an existing stage.- ON_FAILURE
(``tempfail``/``accept``/``reject``/``discard``, par défaut ``tempfail``) Que faire lorsque le milter ne peut être joint, expire ou parle quelque chose d’inanalysable — le
milter_default_actionde Postfix, avec la même valeur par défaut.tempfailmet le message en pause pour réessai, de sorte qu’un filtre arrêté retarde le courrier plutôt que de le perdre ou de le laisser passer non filtré. Un message encore différé après MAX_LIFETIME (par ce chemin ou par le propreSMFIR_TEMPFAILdu filtre) va vers leBOUNCE_STAGEde la section, ou est laisséfailedpour pepsi-failure-bouncer(1) s’il n’y en a pas — jamais vers REJECT_STAGE, qui peut abandonner du courrier silencieusement.- ALLOW_ACTIONS
(chaîne, ``addhdrs chghdrs chgbody`` par défaut) Les actions de modification
SMFIF_*offertes au filtre, séparées par espaces ou virgules :addhdrs,chghdrs,chgbody,addrcpt,delrcpt,addrcpt_par,chgfrom,quarantine; plus les raccourcisalletnone. Il n’y a pas d”inshdr: libmilter conditionne aussi l”insertion d’en-têtes àSMFIF_ADDHDRS.Sans bac à sable autour du filtre, ce masque est le seul moyen de limiter ce que le filtre peut modifier, et c’est avec la valeur par défaut que cela compte le plus : chaque filtre de contenu fonctionne avec, tandis qu’un filtre qui veut réécrire l”enveloppe doit se le voir accorder explicitement. Un filtre exigeant une action qui n’a pas été offerte est signalé nommément et prend le chemin ON_FAILURE, plutôt que de voir ses modifications abandonnées en silence comme Postfix les abandonne.
SMFIF_SETSYMLISTn’est délibérément pas listé et n’a besoin d’aucune autorisation : il n’autorise aucune modification du message.- PROTOCOL_VERSION
(entier 2–6, 6 par défaut) La version la plus élevée du protocole milter offerte ; le filtre négocie à la baisse depuis elle. Le
milter_protocolde Postfix.- CONNECT_TIMEOUT
(durée, ``30 s`` par défaut) Borne sur l’établissement de la connexion et l’achèvement de la négociation d’options — les deux moitiés de « ce filtre est-il joignable du tout ». Le
milter_connect_timeoutde Postfix.- COMMAND_TIMEOUT
(durée, ``30 s`` par défaut) Borne sur la réponse à une seule commande jusqu’à la fin du corps. Le
milter_command_timeoutde Postfix.- CONTENT_TIMEOUT
(durée, ``300 s`` par défaut) Borne sur le verdict de fin de message, là où un filtre de contenu fait son vrai travail. Un
SMFIR_PROGRESSdu filtre remet le chronomètre à zéro, mais une attente de réponse n’est jamais prolongée au-delà de dix fois son délai au total ; un filtre qui signale encore une progression prend alors le chemin ON_FAILURE. Lemilter_content_timeoutde Postfix.Chacun des trois timeouts doit être supérieur à zéro et au plus égal à
24 h.- RETRY_INITIAL / RETRY_MAX_INTERVAL / RETRY_FACTOR / MAX_LIFETIME
(durées / nombre, facultatif) Le calendrier de reprise partagé pour le chemin d’échec temporaire, avec la même signification que dans les étapes de relais. Par défaut :
300 s,1 h,2,120 h. Il n’y a pas de DELAY_DSN_AFTER : un message que le filtre continue de différer ne produit aucun DSN « retardé », seulement le rebond une fois MAX_LIFETIME écoulé, et pepsi-setup(1) signale l’option comme inconnue dans une section milter.- MACROS_CONNECT / MACROS_HELO / MACROS_MAIL / MACROS_RCPT / MACROS_DATA / MACROS_EOH / MACROS_EOM
(chaîne, facultative) Les macros sendmail exportées à chaque phase du protocole, séparées par espaces ou virgules. Les valeurs par défaut sont celles de Postfix, de sorte que la documentation propre à un filtre s’applique inchangée :
j {daemon_name} {daemon_addr} v _,{tls_version} {cipher} {cipher_bits} {cert_subject} {cert_issuer},i {auth_type} {auth_authen} {auth_author} {mail_addr} {mail_host} {mail_mailer},i {rcpt_addr} {rcpt_host} {rcpt_mailer}, etipour les trois restantes. Une macro dont ce déploiement ne connaît pas la valeur n’est pas envoyée du tout. Réglez une liste sur la sentinellenonepour n’exporter rien à cette phase — une valeur vide se lit comme absente et réapplique le défaut. Un filtre qui nomme sa propre liste avecSMFIF_SETSYMLISTredéfinit celles-ci.
95.2.1.1.22.25. Options de pepsi-stage-quarantine¶
Une étape avec PROGRAM = pepsi-stage-quarantine retient chaque message qui lui parvient (paused, sans timeout sauf si MAX_HOLD est défini) jusqu’à ce qu’un opérateur le libère avec pepsi-queue quarantine release ou le supprime. L’une de RELEASE_STAGE et NEXT_STAGE est requise. Les options sont lues depuis ce fichier, jamais depuis les paramètres par adresse. Voir pepsi-stage-quarantine(1).
- RELEASE_STAGE
(chaîne, facultative) Où va un message libéré. Vaut par défaut NEXT_STAGE. Pour le courrier que l’ingress a mis en quarantaine, qui a sauté toutes les étapes précédant celle-ci, c’est normalement
init. Ne doit pas être cette étape.- MAX_HOLD
(intervalle, facultatif) La rétention la plus longue, par exemple
14 days,2 weeksou36 h; un jour compte pour 24 heures, et les mois et les années sont refusés. La fin d’une rétention est notée au début de celle-ci. Sans valeur, une rétention dure jusqu’à ce que le message soit libéré ou supprimé, et[pepsi-queue] QUARANTINE_MAX_AGE_DAYSla borne comme à toute étape de quarantaine ; avec une valeur, l’étape met fin elle-même à ses rétentions etpepsi-queue gcla laisse tranquille.- EXPIRE_STAGE
(chaîne, facultative) Où va un message lorsque sa rétention atteint MAX_HOLD, marqué
failure_class = quarantine-expiredavecRET=HDRSpour une DSN. Sans valeur, le message est supprimé. Nécessite MAX_HOLD ; ne doit pas être cette étape.
95.2.1.1.22.26. Options de pepsi-stage-route¶
Une étape avec PROGRAM = pepsi-stage-route choisit une étape suivante pour chaque destinataire d’enveloppe d’après le domaine de ce destinataire, scindant le message sur des lignes sœurs lorsque les destinataires divergent. Elle existe pour une passerelle placée devant un autre système de courrier (voir le chapitre « Microsoft Exchange comme passerelle » du manuel) : les domaines derrière une telle passerelle sont exactement les domaines dont le MX public est la passerelle, de sorte qu’acheminer l’un d’eux vers un relais direct-au-MX soit une boucle de courrier plutôt qu’un échec de remise.
L’ordre de consultation par destinataire est ROUTES, puis l’ensemble des domaines gérés, puis NEXT_STAGE.
- ROUTES
(chaîne, facultative) Paires
<domain-pattern>=<stage>séparées par espaces ou virgules, consultées en premier et dans l’ordre écrit. Les motifs sont comparés sans distinction de casse et peuvent contenir*, qui correspond à toute suite de caractères ; ce sont des globs, non des expressions régulières, ancrés aux deux extrémités, de sorte que*.example.orgcorresponde àmail.example.orgmais ni àexample.orgni àmail.example.org.evil.test. Une valeur qui ressemble à une expression régulière est rejetée plutôt que de ne correspondre silencieusement à rien. Les règles explicites sont consultées avant l’ensemble géré, de sorte qu’un sous-domaine puisse être découpé sans retirer son parent de MANAGED_DOMAINS.- MANAGED_DOMAINS
(chaîne, facultative) Les domaines derrière cette passerelle, séparés par espaces ou virgules, globs
*autorisés. Vaut par défaut[pepsi-ingress] ACCEPTED_DOMAINS, de sorte que l’ensemble ne puisse pas dériver de ce que l’ingress accepte réellement. Au moins un domaine doit se résoudre, depuis l’une ou l’autre source.- MANAGED_STAGE
(chaîne, facultative) Où va un destinataire d’un domaine géré — dans un déploiement de passerelle, l’étape qui relaie vers le système situé derrière. Sans elle, les destinataires gérés prennent NEXT_STAGE, et pepsi-setup(1) doit alors prouver que ce n’est pas une boucle.
- NEXT_STAGE
(chaîne, obligatoire) Où va tout autre destinataire. Obligatoire : l’étape ne remet, ne fait rebondir ni n’abandonne jamais un message, chaque destinataire doit donc avoir un endroit où aller.
- RECIPIENT_CHECK
(``none``, ``probe`` ou ``map``, facultatif) Comment pepsi-ingress(1) peut savoir si une adresse d’un domaine géré existe sur le système derrière la passerelle, afin de pouvoir refuser une adresse inconnue au moment du
RCPT(voir[pepsi-ingress] VERIFY_RECIPIENTS). La route elle-même ne la lit jamais ; elle est définie ici parce que cette section décrit le backend. Utilisée uniquement avec MANAGED_STAGE.none(la valeur par défaut) laisse les domaines gérés non vérifiés : chaque adresse est acceptée, et le rebond propre au backend fait office de réponse.probeinterroge le backend :MAIL FROM:<>,RCPT TO,RSET, sans qu’aucun message soit envoyé. Seul un refus5.1.x(ou un simple550) compte comme « utilisateur inexistant ». Tout le reste accepte l’adresse : un backend injoignable, un report ou une boîte aux lettres pleine. Les réponses sont mises en cache, un « oui » pour une heure et un « non » pour cinq minutes. Un backend qui accepte toute adresse et rebondit plus tard (Exchange avec le filtrage des destinataires désactivé) répond toujours « oui » ; pour un tel backend, utilisezmap, qui lit les adresses valides depuis RECIPIENT_MAP.- PROBE_HOST, PROBE_PORT, PROBE_TLS, PROBE_TIMEOUT
(facultatif ; PROBE_HOST obligatoire pour ``probe``) Où et comment sonder : le nom d’hôte ou l’adresse du backend, son port (par défaut
25),opportunistic(la valeur par défaut),starttls,tlsounone, et le délai d’expiration par commande (par défaut10 s). La sonde porte une adresse, jamais un message, si bien que le TLS opportuniste accepte n’importe quel certificat, comme la remise à un MX ;starttlsettlsle vérifient.- RECIPIENT_MAP
(chemin ; obligatoire pour ``map``) Les adresses valides, une par ligne : une adresse, ou
@domainpour toute adresse d’un domaine. Tout ce qui suit le premier mot est ignoré, de sorte que le fichier source d’une table Postfixrelay_recipient_maps(alice@example.org OK) peut être utilisé tel quel.#commence un commentaire. Le fichier est lu à chaque vérification. S’il ne peut pas être lu, toute adresse est acceptée.
pepsi-setup(1) vérifie que chaque cible nomme une étape existante et refuse une configuration dans laquelle un message destiné à un domaine géré pourrait atteindre pepsi-stage-relay-to-internet(1) — en avançant à travers NEXT_STAGE et toute autre étape d’acheminement, mais délibérément pas à travers BOUNCE_STAGE (un rebond est un nouveau message au sujet d’une remise déjà échouée, et atteint légitimement un relais).
95.2.1.1.22.27. Options de pepsi-stage-aliases¶
Une étape avec PROGRAM = pepsi-stage-aliases développe les destinataires d’enveloppe d’un message à travers un fichier de mappage d’alias avant de le transférer :
- ALIASES
(string, required) The alias map file, parsed like a Postfix virtual(5) table. The value is a filesystem path taken verbatim, so unlike a path-typed option it is not
$-expanded. Each line maps a key (a full address, an@domaincatch-all, or a*wildcard such assales-*@example.org) to one or more comma/whitespace-separated target addresses;#comments and blank lines are ignored. Recipients matching a key are replaced by its targets (transitively, with a loop guard) and the result is de-duplicated; on competing wildcards the most specific match wins. The file is re-read only when its identity (modification time, size or inode) changes; a missing file is treated as an empty map, while a file that exists but cannot be read is an error and the message is retried. pepsi-setup(1) syntax-checks it at install time when present. See pepsi-stage-aliases(1).- NEXT_STAGE
(string, required) Where the (expanded) message advances. pepsi-setup(1) checks that it names an existing stage.
95.2.1.1.22.28. Options de pepsi-stage-edit-settings¶
Une étape avec PROGRAM = pepsi-stage-edit-settings lit :
- EDITABLE_STAGES
(liste, obligatoire) Noms d’étapes séparés par espaces/virgules dont un e-mail de contrôle peut changer les options. Au moins un est obligatoire, chacun doit nommer une étape existante (pepsi-setup(1) le vérifie), et un corps adressant toute étape non listée ici est refusé.
- RESPONSE_STAGE
(chaîne, obligatoire) Étape à laquelle la réponse est injectée (typiquement le début du chemin sortant de signature/relais), de sorte qu’elle soit signée en DKIM et remise. Doit se résoudre en une étape existante.
- NEXT_STAGE
(chaîne, obligatoire) Où avance un message qui n’est pas de contrôle. pepsi-setup(1) refuse une section qui n’en a pas.
- SUBJECT
(chaîne, facultative) L’objet exact (comparé en tenant compte de la casse, en ignorant les espaces qui l’entourent) qui marque un message de contrôle, et l’objet de la réponse. Par défaut
Pepsi.- CONTROL_LOCAL_PART
(chaîne, facultative) Partie locale de l’adresse de contrôle. Par défaut
pepsi.- RESPONSE_FROM
(chaîne, facultative) En-tête
From:de la réponse. Par défaut<CONTROL_LOCAL_PART@domain>pour le domaine contrôlé auquel le message était adressé.- UNRESTRICTED_UNSAFE_STAGES
(booléen, facultatif) Lever la restriction de sûreté sur ce qu’un e-mail de contrôle peut régler. Par défaut
NO.Avec la valeur par défaut, quatre choses sont refusées, si permissif que soit EDITABLE_STAGES. Une affectation qui définit le
PROGRAMd’une étape n’est acceptée que si la valeur est une commandepepsi-stage-*nue sans composant de chemin, de sorte qu’un titulaire de compte ne peut pas faire pointer l’une de ses étapes modifiables vers un exécutable arbitraire. Une affectation qui définitHELPER(le programme qu’une étape de remise exécute avec son privilège setgid) est refusée sauf si elle ne fait que le supprimer ; il en va de même pourSCAN_HELPER,MAILBOX_HELPERetPIN_COMMAND, les autres options qui nomment un programme à exécuter. Une affectation qui définit une option d”identité est refusée d’emblée, faute de valeur sûre à autoriser. Ces options sontSIGNING_DOMAIN, qui redéfinit le domaine duFrom:propre au message et ferait donc signer le courrier d’un compte au nom de n’importe quel domaine dont cet hôte détient une clé, et lesWALLET_MODE,WALLET_SCOPEetWALLET_USERd’auto-pay, qui choisissent quel wallet paie. Une limite de dépense, lesMAX_TOTALetMAX_TOTAL_PER_DAYd’auto-pay, est refusée elle aussi, car un message de contrôle est authentifié par le même mot de passe de soumission dont ces limites bornent le vol. Régler ceci àYESsupprime les quatre contrôles. L’option porte le nom de ce qu’elle fait : il n’y a aucune raison de l’activer à moins de faire confiance à chaque adresse dont les redéfinitions sont modifiables.
95.2.1.1.22.29. Options de pepsi-stage-vks-confirm¶
Une étape avec PROGRAM = pepsi-stage-vks-confirm suit le lien de confirmation du courrier de vérification d’adresse d’un serveur de clés, de sorte qu’une clé téléversée devienne trouvable par adresse. Elle siège sur le chemin entrant et fait avancer intact tout ce sur quoi elle n’agit pas — c’est-à-dire presque tout le courrier. Voir pepsi-stage-vks-confirm(1) pour la liste complète des conditions qu’elle vérifie avant de récupérer quoi que ce soit.
- NEXT_STAGE
(string, required) Where every message that this stage does not consume goes. Required rather than optional: a stage on the inbound path that silently dropped what it did not recognise would lose ordinary mail. pepsi-setup(1) checks that it names an existing stage.
- VKS_HOST
(chaîne, facultative) Le seul hôte dont un courrier de vérification peut venir et vers lequel un lien peut pointer. Vaut par défaut l’hôte de
[pepsi-keys] VKS_SERVER, et pepsi-setup(1) refuse tout autre hôte : les téléversements vont vers ce serveur, si bien que son courrier de vérification est le seul sur lequel l’étape existe pour agir. Comparé exactement : un sous-domaine d’un serveur de clés n’est pas le serveur de clés. L’option n’est facultative que grâce à ce repli : sans elle ni hôteVKS_SERVER, l’étape refuse de démarrer, car elle n’a aucun moyen de distinguer le courrier d’un serveur de clés de celui de quiconque.- MAX_LINKS
(entier, facultatif) Combien de liens l’étape suit au plus pour un message.
3par défaut, minimum1(0est refusé : pour ne suivre aucun lien, retirez l’étape du pipeline). Un véritable courrier de vérification en porte un ; la borne empêche qu’un message ayant franchi toutes les autres vérifications ne devienne un nombre arbitraire de requêtes.- DISCARD_CONFIRMED
(booléen, facultatif) Si un courrier de confirmation sur lequel l’étape a agi est supprimé plutôt que remis.
YESpar défaut : c’est du courrier de machine au sujet d’une action que Pepsi a entreprise, adressé à une boîte dont le propriétaire ne l’a pas demandé, et il a déjà été traité au moment où il arriverait. Seul un courrier après lequel au moins une identité a été vérifiée comme publiée est supprimé ; lorsque suivre ses liens n’a rien vérifié, il est remis malgré tout.- REQUIRE_AUTHENTICATION
(booléen, facultatif) Si SPF ou DMARC doit avoir réussi, et pas seulement l’expéditeur d’enveloppe correspondre à VKS_HOST.
YESpar défaut. Notez qu’une réussite DKIM ne satisfait délibérément pas ceci : elle dit qu’une signature s’est vérifiée, non de qui elle est.
Il n’y a pas de BOUNCE_STAGE : l’étape ne fait jamais échouer un message.
95.2.1.1.22.30. Options de pepsi-stage-dmarc-report¶
Une étape avec PROGRAM = pepsi-stage-dmarc-report lit les rapports agrégés DMARC (RFC 7489 §7.2) que d’autres destinataires envoient à l’adresse rua= des domaines servis, et les stocke dans pepsi.dmarc_report. Elle se situe sur le chemin entrant, avant les barrières de liste blanche, de défi et de paiement, et fait avancer sans y toucher tout ce qui n’est pas adressé à l’adresse des rapports. La section globale [pepsi-dmarc-reports] configure le stockage et la fenêtre de verdict. Voir pepsi-stage-dmarc-report(1).
- NEXT_STAGE
(chaîne, obligatoire) Où va chaque message qui n’est pas un rapport. pepsi-setup(1) vérifie qu’elle nomme une étape existante.
- LOCAL_PART
(chaîne, facultative) La partie locale à laquelle arrivent les rapports, sur chaque domaine de LOCAL_DOMAINS, comparée après retrait de la sous-adresse. Par défaut
dmarc-reports. La vérification des destinataires auRCPTl’accepte dans chaque domaine servi, et pepsi-setup(1) la nomme dans lerua=de l’enregistrement DMARC qu’il suggère.- DELIVER
(booléen, facultatif) Transmettre aussi le courrier de rapport à NEXT_STAGE, pour un site qui garde une boîte aux lettres à cette adresse. Par défaut
NO: le courrier est consommé (stocké lorsqu’il s’agit d’un rapport lisible concernant un domaine servi, abandonné sinon).- MAX_REPORT_SIZE
(taille, facultative) Plafond d’un rapport décompressé ; une bombe gzip ou zip s’arrête là. Par défaut
16M;noneest refusé.- LOCAL_DOMAINS, RECIPIENT_DELIMITER
(facultatif) Les domaines servis (par défaut
[pepsi-ingress] ACCEPTED_DOMAINS) et le délimiteur de sous-adresse (par défaut[pepsi] RECIPIENT_DELIMITER, sinon+).
Il n’y a pas de BOUNCE_STAGE : l’étape ne génère jamais de rebond.
95.2.1.1.23. La section [pepsi-dispatch]¶
Options pour pepsi-dispatch(1). Le dimensionnement du pool de workers par étape (PARALLELISM, MAX_MESSAGES, QUEUE_LIMIT) réside dans chaque section [stage-<name>] ci-dessus, pas ici. Chaque durée ci-dessous doit être supérieure à zéro et au plus égale à 168 h ; pepsi-setup(1) et le dispatcher refusent toute autre valeur.
- CONFIG_FILE
(chemin, facultatif) Le fichier de configuration passé aux workers lancés via
-c. Réglez-le sur le chemin de ce fichier chaque fois que le dispatcher est démarré avec un-cexplicite (le chemin chargé ne peut être récupéré sinon) ; s’il n’est pas réglé, les workers utilisent la recherche de configuration par défaut.- POLL_INTERVAL
(durée, optionnel) Battement de cœur de sécurité : la durée maximale pendant laquelle le dispatcher dort lorsqu’aucune nouvelle tentative
paused, aucun recyclage de worker et aucun délai de démarrage plus proche n’est dû ; il recherche alors du travail et remet en file les enregistrementspausedéchus. Par défaut 30 s. C’est une échéance absolue, non une période de calme : le trafic de messages, et un STATS_INTERVAL plus court, ne la repoussent pas, de sorte que les enregistrementspausedsont remis en file à temps même sur un pipeline chargé.- MAX_RUNTIME
(durée, facultative) Temps réel maximal qu’un worker peut consacrer à un seul message, compté à partir du moment où le worker est prêt à le traiter : le propre démarrage d’un worker n’est pas imputé au message, et dispose d’un budget à lui (le plus grand de cette valeur et de 60 s ; voir pepsi-dispatch(1)). Un worker qui le dépasse est tué (et remplacé) et le message reçoit un avertissement : il est mis en pause et réessayé après une minute (deux après le second avertissement), et seul son troisième avertissement le passe à
timeout, sauf dans une étapepepsi-stage-relay-to-*, où c’est MAX_LIFETIME qui décide. Une section[stage-<name>]peut définir son propre MAX_RUNTIME, qui l’emporte. Par défaut 300 s, et 900 s pour les étapespepsi-stage-relay-to-*, qui attendent d’autres hôtes ; définir cette option applique la valeur à ces étapes aussi.- WORKER_IDLE_TIMEOUT
(durée, facultative) Combien de temps un processus worker inactif est conservé avant d’être arrêté. La concurrence totale est réglée par étape (PARALLELISM), pas globalement. Par défaut 5 s.
- STATS_INTERVAL
(durée, facultative) À quelle fréquence les statistiques de pipeline en mémoire (exportées par pepsi-httpd(1) à
/metrics) sont vidées dans la base de données, en une seule transaction. Aussi vidées dès que le pipeline devient inactif (au plus une fois par seconde) et à l’arrêt ; un dispatcher inactif sans rien de nouveau à consigner n’écrit rien. Par défaut 60 s.- DB_POOL_SIZE
(nombre, facultatif) Nombre maximal de connexions PostgreSQL dans le pool de base de données du dispatcher. Contrairement à un worker d’étape à connexion unique, le dispatcher traite les résultats de nombreux workers (faisant avancer/échouer leurs messages) en concurrence avec ses propres requêtes de coordinateur, il garde donc un petit pool borné. Le travail par instruction est bref, de sorte qu’une poignée de connexions absorbe un fort renouvellement de workers. Par défaut
8; ne le relevez que si le coordinateur manque de connexions, et gardez la somme du pool de chaque composant en dessous dumax_connectionsde PostgreSQL.- FAIR_SCHEDULING
(booléen, facultatif) Partage équitablement le temps de worker de chaque étape entre les expéditeurs (le compte authentifié, sinon l’adresse qui se connecte, une adresse IPv6 étant prise par /64 ; voir « Ordonnancement équitable entre expéditeurs » dans pepsi-dispatch(1)) au lieu de revendiquer strictement les plus anciens d’abord, de sorte que la rafale d’un expéditeur ne retarde pas tous ceux qui sont en file derrière elle. Par défaut
yes;norétablit l’ordre du plus ancien d’abord.- FAIR_HALF_LIFE
(durée, facultative) La vitesse à laquelle l’avance accumulée d’un expéditeur en temps de worker s’estompe : elle est divisée par deux toutes les FAIR_HALF_LIFE, de sorte que la pénalité d’une rafale passée se dissipe une fois que l’expéditeur s’arrête. Par défaut 60 s.
- FAIR_FIFO_PERCENT
(nombre, facultatif) Pourcentage des créneaux revendiqués de chaque étape réservés à ses messages en attente les plus anciens, quel que soit l’expéditeur. Cela garantit qu’aucun message n’attend indéfiniment, quel que soit le nombre d’autres expéditeurs qui continuent d’arriver. De
1à100;100revient au plus ancien d’abord avec une comptabilité supplémentaire (utilisez FAIR_SCHEDULING= nopour cela). Par défaut 10.
95.2.1.1.24. La section [pepsi-list]¶
Options pour pepsi-list(1) et le sous-système de listes de diffusion, lues par cet outil, par les étapes de liste et par pepsi-setup(1). Chaque option a une valeur par défaut : un site qui n’héberge aucune liste n’a donc besoin d’aucune section.
Le sous-système de listes de diffusion de Pepsi est une réimplémentation de GNU Mailman 3 ; son modèle de données, son API REST, son vocabulaire de commandes par e-mail et les noms de ses modèles de notification sont la conception du projet GNU Mailman, dont la Free Software Foundation détient les droits. Voir COPYING et vendor/PEPSI-VENDORING.md pour les fichiers repris d’amont, qui demeurent sous la GPL.
La configuration par liste n’est pas ici. Les listes sont créées à l’exécution par des personnes qui ne sont pas l’exploitant, potentiellement par milliers ; ce fichier appartient à l’exploitant et est rechargé d’un bloc. Les 99 attributs par liste résident dans la table mailing_list et se gèrent avec pepsi-list(1). Ce qui suit n’est que ce que le site possède.
- SITE_OWNER
(adresse, facultatif) Où vont les notifications d’une liste lorsque la liste n’a pas de propriétaire à elle. Sans elle, une liste sans propriétaire est une erreur pour
pepsi-list checket non un avertissement, car ses messages retenus et ses demandes de modération n’atteindraient absolument personne.- BASE_URL
(URL, facultatif) URL publique vers laquelle pointent les liens d’archives et les en-têtes
List-*, pour les domaines qui ne définissent pas leur proprebase_url. Sans elle, aucun en-têteList-Archive:ne peut être écrit. Lorsqu’il s’agit d’une URLhttps://, les clés de sécurité WebAuthn des pages de membres sont aussi liées à son origine (son hôte est leur identifiant de RP) ; sinon, aucune clé de sécurité n’est proposée aux membres.- API_USER, API_PASS
(chaîne, facultatif) Identifiants HTTP Basic de l’API REST de GNU Mailman 3 – les
[webservice] admin_user/admin_passd’amont sous un nom Pepsi. Posez les deux ou aucun : la moitié d’un identifiant n’authentifie personne, etpepsi-list checksignale l’un sans l’autre comme une erreur. L’API n’est servie que sur un écouteur marquéLIST_API = yes.- API_BASE_URL
(URL, facultative) L’origine absolue à partir de laquelle l’API REST construit chaque
self_linket chaqueLocationqu’elle émet, par exemplehttp://localhost:8001; un/final est retiré. Lorsqu’elle n’est pas définie, leHostde la requête elle-même est utilisé, ce qui est correct derrière un proxy inverse.- API_RATE_LIMIT
(entier, facultatif) Requêtes par minute et par adresse source sur l’API REST.
3000par défaut, délibérément élevé afin qu’une suite de compatibilité ne soit pas bridée ; un429de cette API provient de ce limiteur.- DEFAULT_LANGUAGE
(chaîne, facultative) La langue dans laquelle démarre une nouvelle liste, et le bas de la chaîne de préférences (
GET /<api>/system/preferences).enpar défaut.- RELEASE_STAGE
(chaîne, facultative) La section
[stage-<name>]qui exécute pepsi-stage-list-post(1), où l”acceptation d’un message retenu par un modérateur réintègre le pipeline. Sans elle, les messages retenus peuvent être lus et rejetés mais pas acceptés, et pepsi-setup(1) avertit.pepsi-list digestinjecte les numéros de condensés à la même étape, etpepsi-list checkavertit au sujet d’une liste avecdigests_enabledlorsqu’elle n’est pas définie.- NOTICE_STAGE
(chaîne, facultative) L’étape à laquelle les balayages périodiques de
pepsi-list tasksinjectent leurs avis : les avis aux membres des balayages de rebonds et l’avis aux modérateurs sur les contributions retenues expirées. pepsi-setup(1) l’exige, et vérifie qu’elle nomme une étape existante, dès qu’une étape pepsi-stage-list-bounce(1) existe : sans elle, le compteur d’avertissements d’un membre augmente sans que le membre en soit jamais informé. Sans elle, les contributions retenues au-delà demax_days_to_holdrestent aussi retenues, car personne ne pourrait être informé de leur rejet.- BOUNCE_PROBES
(booléen, facultatif) Si un membre dont le score de rebonds franchit le seuil de la liste reçoit une sonde (le score étant remis à zéro tant qu’elle est en attente, et un rebond de la sonde désactivant le membre) plutôt que d’être désactivé aussitôt.
YESpar défaut (leverp_probesamont est désactivé par défaut) : le jeton de la sonde est la seule chose d’un rebond que personne ne peut falsifier, c’est donc la vérification finale avant que la remise ne soit désactivée sur la foi de rapports envoyés par quelqu’un d’autre. Voir pepsi-stage-list-bounce(1).- BOUNCE_EVENT_RETENTION
(entier, facultatif) Combien de temps un événement de rebond traité est conservé, en jours.
1par défaut.- UNSUBSCRIBE_SECRET
(string, optional) The secret key of the RFC 8058 one-click unsubscribe token, which pepsi-stage-list-deliver(1) computes and pepsi-httpd(1) verifies. Without it the
https:one-click form is not emitted and themailto:form stands alone. pepsi-setup(1) writes it tosecrets.d/pepsi-list.secret(mode 0640,pepsi-httpd:pepsi) and references it with@inline-secret@.- VERP_SECRET
(chaîne) Le secret clé du code d’authentification présent dans chaque expéditeur d’enveloppe VERP qu’écrit la diffusion de liste (
<list>-bounces+<local>=<domain>=<code>@ <host>, pepsi-stage-list-post(1)) et que pepsi-stage-list-bounce(1) vérifie avant de compter un rebond contre le membre nommé : une adresse à la forme de membre dont le code ne se vérifie pas est abandonnée sans être comptée. Obligatoire partout où l’une ou l’autre étape est configurée — les deux refusent de démarrer sans lui, et pepsi-setup(1) refuse la configuration. L’assistant le génère, le conserve d’une exécution à l’autre et le stocke danssecrets.d/pepsi-list.secretà côté de UNSUBSCRIBE_SECRET. Le renouveler rend invérifiable chaque rebond d’une copie déjà envoyée.- TEMPLATE_FETCH_TIMEOUT, TEMPLATE_FETCH_MAX_BYTES, TEMPLATE_FETCH_ALLOW_INTERNAL
(durée, entier, booléen ; facultatifs) Limites sur la récupération de l’URI
list_templatequi redéfinit le modèle d’une liste, que définit un propriétaire de liste plutôt que l’opérateur : l’échéance de la récupération complète (5 spar défaut), le plus grand modèle accepté (65536octets par défaut), et si un hôte qui se résout vers une adresse interne peut être récupéré (NOpar défaut ; chaque adresse vers laquelle l’hôte se résout est vérifiée).- WEB_RATE_LIMIT, WEB_SEARCH_RATE_LIMIT
(entier, facultatif) Requêtes par minute et par adresse source sur l’interface web publique des listes (un
[pepsi-httpd-listener-*]avecLISTS = yes), et le budget distinct, plus serré, de sa route de recherche.600et30par défaut ; une valeur inférieure à1est relevée à1.- WEB_REGISTRATION
(booléen, facultatif) Si l’interface web publique des listes permet à n’importe qui de créer un compte de liste (
/lists/register, qui sert aussi à renvoyer un jeton de vérification perdu). Par défautYES. AvecNO, le formulaire d’inscription et son gestionnaire répondent404et la page de connexion ne les propose pas ; la connexion, les réinitialisations de mot de passe et les liens de vérification des comptes existants continuent de fonctionner, et les comptes proviennent à la place dupepsi-listde l’opérateur, d’une importation ou d’un propriétaire de liste. Les pages de listes et les archives sont servies dans tous les cas.- MAX_MESSAGE_SIZE
(entier, facultatif) Plafond du site sur la
max_message_sized’une liste, en kilo-octets ;0(le défaut) signifie aucun plafond de site. Une valeur par liste supérieure est bornée, etpepsi-list checkle signale.- MAX_LIST_HOPS
(entier, facultatif) Combien de fois un message peut traverser une liste avant d’être traité comme un cycle d’abonnements entre deux listes et retenu pour les modérateurs au lieu d’être remis. Vaut
5par défaut. Une liste chapeau (une liste abonnée à une autre liste) est une configuration prise en charge ; cette limite empêche deux listes abonnées l’une à l’autre d’amplifier le courrier. Le compteur voyage dans un en-têteX-Pepsi-List-Hops:et non dans l’état du message, parce que le courrier d’une liste chapeau part par SMTP et revient comme un message tout neuf ;pepsi-ingressretire l’en-tête du courrier qui n’est pas arrivé par un chemin de soumission authentifié ou local, il ne peut donc pas être remis à zéro par un inconnu.- INVITE_RATE
(entier, facultatif) Nombre d’invitations de bascule envoyées par heure. Vaut
300par défaut. Le premier acte d’un site en migration est un envoi de masse à tout son effectif depuis une IP sans réputation : la campagne d’invitations est donc limitée en débit et reprenable, et non une boucle.- ARCHIVE_RETENTION
(entier, facultatif) Conservation par défaut des archives, en jours ;
0(le défaut) garde tout. Surchargé par liste avecpepsi-list list set-ext <list> archive_retention_days <n>, où0garde l’archive de cette liste quoi que dise cette option. Appliqué chaque jour par le balayage de conservation depepsi-list tasks --once(l’unité pepsi-list-tasks.timer).- SEARCH_TRIGRAM
(off | short | full, facultatif) Plafond du site sur la portée de l’index de recherche par trigrammes (sous-chaîne et approchée) d’une liste. Vaut
shortpar défaut.Un plafond, non un défaut : chaque liste choisit
off,shortoufulljusqu’à lui, de sorte qu’abaisser cette valeur réduit l’index à la prochainepepsi-archive reindexau lieu de ne toucher que les listes créées ensuite.shortindexe l’objet, l’objet du fil et le nom et l’adresse de l’expéditeur ;fully ajoute le corps du message et sera probablement le plus gros objet de la base.La recherche par trigrammes exige l’extension
pg_trgm, livrée danspostgresql-contrib. Un site sans elle s’installe et fonctionne normalement avec la seule recherche plein texte ;pepsi-list checkindique dans quel mode le site se trouve.- LIST_FANOUT_BATCH
(entier, facultatif) Nombre d’enregistrements frères que crée chaque lot d’éclatement. Vaut
256par défaut.Un message de liste est remis sous la forme d’une ligne de file par destinataire, afin que chaque copie puisse porter l’URI de désabonnement en un clic propre à ce membre. Ceci borne combien de ces lignes pepsi-stage-list-post(1) crée par étape (il marque une pause d’environ une seconde entre les lots). Les lignes d’une diffusion partagent une copie stockée du corps ; la copie d’un membre reçoit la sienne lorsque pepsi-stage-list-deliver(1) la réécrit, de sorte que la taille du lot borne aussi la vitesse à laquelle s’accumulent ces copies par membre. L’augmenter fait s’écouler un gros envoi plus vite et coûte plus d’espace transitoire.
- TOMBSTONE_RETENTION
(entier, facultatif) Combien de temps une pierre tombale de suppression est conservée, en jours. Vaut
90par défaut.Supprimer un message des archives conserve sa
Message-IDpendant ce temps, afin qu’un réenvoi ou un import rejoué ne puisse pas réarchiver en silence ce qui a été supprimé.pepsi-archive purge --forgetsaute la pierre tombale pour le cas où même quatre-vingt-dix jours seraient de trop.- ARCHIVE_PARTITIONS
(entier, facultatif) Partitions de hachage des tables d’archives. Vaut
32par défaut. Lu uniquement par pepsi-setup(1), et fixé à l’installation.PostgreSQL ne sait pas repartitionner à chaud : changer le module implique une nouvelle table et une copie complète de chaque message archivé.
pepsi-setupcrée les partitions une fois et refuse de les changer en silence lors d’une exécution ultérieure, etpepsi-list checksignale une configuration qui contredit ce qui est sur le disque – la valeur installée fait autorité, car les tables ne peuvent pas être modifiées et ce fichier si. Choisissez une fois.
95.2.1.1.25. La section [pepsi-failure-bouncer]¶
Options pour pepsi-failure-bouncer(1), qui déplace les messages failed/timeout vers une étape de rebond afin que l’expéditeur soit notifié. Lu seulement par cet outil.
- BOUNCE_STAGE
(chaîne, requise lorsque l’outil est utilisé) Le label
[stage-<name>]vers lequel un message bloqué est déplacé (et réinitialisé àpending). Normalement la même étape de rebond vers laquelle le pipeline achemine déjà les échecs permanents (par exemplebounce). Un message déjà à cette étape est laissé intact, de sorte qu’un rebond qui échoue à l’étape de rebond ne boucle pas. pepsi-setup(1) vérifie que l’étape nommée existe. Nécessaire sur tout déploiement qui exécutepepsi.target: sonpepsi-failure-bouncer.timerlance l’outil toutes les dix minutes, et chaque exécution échoue sans cette option. La configuration livrée et celle de l’assistant la fixent àbounce.- MIN_AGE = DURATION
Depuis combien de temps un message doit être
failed/timeoutavant d’être déplacé (par défaut1 h) : la fenêtre pendant laquelle un opérateur peut le remettre en place avec pepsi-queue(1) avant que son expéditeur ne soit informé. Mesuré à partir destate.failed_at, que la base de données appose lorsque la ligne échoue ; une ligne sans cet horodatage est déplacée immédiatement.0 sdéplace chaque échec sur-le-champ.
95.2.1.1.26. La section [pepsi-queue]¶
Options de pepsi-queue(1). Lues uniquement par sa sous-commande gc, qu’exécute toutes les heures pepsi-origin-gc.timer.
- QUARANTINE_MAX_AGE_DAYS = DAYS
(entier, facultatif) Combien de jours après son arrivée un message en attente dans une étape de quarantaine (une étape que nomme une option
QUARANTINE_STAGE, ou une étape qui exécute pepsi-stage-quarantine(1) sans MAX_HOLD propre) fait l’objet d’un rebond au lieu d’être retenu plus longtemps. Par défaut14. Le rebond passe par le BOUNCE_STAGE de l’étape de quarantaine, sinon par[pepsi-failure-bouncer] BOUNCE_STAGE, et ne renvoie aucun contenu : une demandeRET=FULLest traitée commeRET=HDRS. Un message dont le contenu est sorti d’un texte chiffré S/MIMEEnvelopedData(AES-CBC), ou n’a pas pu en être ouvert, est supprimé à la place, de même que la copie d’une contribution de liste destinée à un membre : que l’on ait retenu un texte chiffré CBC modifié dépendait de son remplissage, de sorte qu’un rebond répondrait à cette question. Le courrier retenu est stocké en clair pendant sa rétention (dans la base de données, son WAL et chaque vidage), et cette limite borne la durée de cet état.0retient le courrier indéfiniment.
95.2.1.1.27. La section [pepsi-sendmail]¶
Options pour pepsi-sendmail(1), le client de soumission locale compatible Sendmail que le paquet Debian installe comme /usr/sbin/sendmail. Chaque option a une valeur par défaut, un site n’a donc besoin d’aucune section.
Le client est non privilégié et n’affirme aucune identité : il remet le message à un écouteur d’ingress de domaine UNIX, qui dérive le compte de l’expéditeur des identifiants du processus appelant rapportés par le noyau (AUTH_PEERCRED, ci-dessus).
- SOCKET
(chemin, facultatif) La socket de soumission de domaine UNIX de
pepsi-ingress./run/pepsi/submission.sockpar défaut.Bien qu’elle vive dans la section du client, cette option est lue par les deux extrémités :
pepsi-ingresssert cette socket inconditionnellement et synthétise son écouteur depuis ce chemin, de sorte qu’il n’y ait pour elle aucune section[pepsi-ingress-listener-*]ni seconde déclaration qui pourrait nommer un autre chemin.Sous systemd, le descripteur est hérité lorsque
pepsi-ingress.socketlie déjà ce chemin (l’appariement se fait par l’adresse à laquelle le descripteur est lié, non par un FD_INDEX), de sorte qu’un changement ici exige unListenStream=correspondant dans l’unité. Sinon le serveur lie le chemin lui-même, en mode0666, et refuse de démarrer s’il ne le peut pas. Ce mode n’accorde rien en lui-même : ouvrir la socket ne confère aucun droit d’envoyer, car le noyau fournit l’identité de l’appelant et USERNAME_MAP décide de ce qu’elle peut envoyer comme adresse.La valeur spéciale
nonedésactive entièrement la soumission locale : aucune socket n’est servie et pepsi-sendmail(1) refuse de s’exécuter, de sorte que les programmes locaux doivent s’authentifier sur 587/465. pepsi-setup(1) le signale une fois.- EHLO_NAME
(chaîne, facultative) Nom annoncé dans
EHLO. Par défaut[pepsi-ingress] HOSTNAME(etlocalhostsi celui-ci n’est pas défini). Cosmétique : le serveur authentifie le pair par ses identifiants, pas par ce qu’il prétend ici.- DEFAULT_DOMAIN
(chaîne, facultative) Domaine ajouté au login du compte appelant pour former l’expéditeur d’enveloppe lorsque ni
-fni-rn’a été donné, et à un destinataire donné sans@(lerootdecron). Vaut par défaut[pepsi-ingress] HOSTNAME(etlocalhostsi même celui-ci n’est pas défini).Réglez-le lorsque les adresses que votre
USERNAME_MAPreconnaît sont dans un autre domaine : le serveur associe l’uid du pair à un login puis à une adresse, de sorte qu’un désaccord ici fait arriver le courrier decrondepuis un expéditeur d’enveloppe que le site ne possède pas.
95.2.1.1.28. La section [pepsi-whitelist]¶
Options pour pepsi-whitelist(1), l’outil qui gère la liste blanche d’expéditeurs et sait en semer une depuis la boîte aux lettres d’un utilisateur (import). Lues uniquement par cet outil ; toutes les options sont facultatives, un site qui n’utilise que add/list/remove n’a donc besoin d’aucune section.
- LOCAL_DOMAINS
(chaîne, facultative) Domaines dont les expéditeurs comptent comme le courrier propre à l’utilisateur lorsqu’une boîte aux lettres est parcourue : un message dont le
From:/Sender:est chez l’un d’eux est un message que l’utilisateur a envoyé, ses destinataires deviennent donc des entrées de liste blanche. Séparés par des virgules ou des espaces. Par défaut[pepsi-ingress] ACCEPTED_DOMAINS; c’est la même option que celle qu’utilisent pepsi-stage-relay-to-maildir(1) et pepsi-stage-dot-forward(1).- TARGETS, RECIPIENT_DELIMITER
(chaîne, facultative) Comme pour les étapes de remise.
TARGETSborne les comptes locaux qu”import --all-userssème (par défaut : la plageUID_MIN..``UID_MAX`` de/etc/login.defs) ;RECIPIENT_DELIMITERretire une sous-adresse avant qu’une adresse ne soit comparée.- HOSTERS_FILE
(chemin, facultatif) Fichier listant les hébergeurs e-mail publics, un domaine par ligne (
#pour les commentaires ; un*.en tête couvre une arborescence de sous-domaines). Les domaines qui y figurent ne sont jamais proposés comme joker*@domainparimport --auto-wildcard, quel que soit le nombre de correspondants que l’utilisateur y a — « tout le monde chezgmail.com» n’est pas un ensemble de personnes que l’utilisateur connaît, et le mettre en liste blanche permettrait à tout spammeur disposant d’un compte gratuit de contourner la barrière anti-spam. Leurs adresses individuelles sont malgré tout importées. Par défaut${DATADIR}/hosters.txt, qu’écritmake install; faites pointer ceci vers votre propre copie pour étendre la liste, car celle installée est écrasée lors d’une mise à niveau.- WILDCARD_THRESHOLD
(nombre, facultatif) Combien d’adresses distinctes chez un même domaine amènent
import --auto-wildcardà proposer une unique entrée*@domainpour lui. Par défaut10.- MAX_ENTRIES
(nombre, facultatif) Nombre maximal de lignes qu’un
importpeut ajouter. Par défaut5000. Chaque ligne d’une liste blanche est comparée auFrom:de chaque message entrant qui la consulte ; c’est donc une borne sur un coût permanent par message, et pas seulement sur la taille de la table.- SCAN_HELPER
(chaîne, facultative) Le binaire helper de parcours de boîte aux lettres, localisé sur le
$PATH(pour une exécution setuid, le chemin système fixe qui remplace celui de l’appelant). Par défautpepsi-helper-mailbox-scan(voir pepsi-helper-mailbox-scan(1)). La surcouche de configuration de la base de données ne peut pas la définir.- MAILBOX
(chemin, facultatif) Boîte aux lettres à parcourir lorsque l’utilisateur n’en nomme aucune. Par défaut le
~/Maildirde l’utilisateur s’il existe, sinon/var/mail/<login>.
95.2.1.1.29. La section [pepsi-httpd]¶
Options pour pepsi-httpd(1). Le serveur lit aussi les domaines servis (ACCEPTED_DOMAINS), l’hôte mx de MTA-STS (le HOSTNAME de l’ingress) et les options MTA_STS_* de [pepsi].
- MAX_CONNECTIONS
(nombre, facultatif) Nombre maximal de connexions HTTP servies en concurrence. Par défaut 256.
- MAX_CONNECTIONS_PER_IP
(nombre, facultatif) Nombre maximal de connexions simultanées depuis une même adresse cliente (une adresse IPv4 ou un
/64IPv6) ; une connexion au-delà est fermée aussitôt. Les connexions par socket UNIX — depuis un proxy inverse — ne portent aucune adresse cliente et ne sont pas comptées, de sorte que derrière un proxy cette limite relève du proxy. Par défaut 32 ;0la désactive.- DB_POOL_SIZE
(nombre, facultatif) Nombre maximal de connexions PostgreSQL dans le pool de base de données du serveur HTTP. Le serveur gère les requêtes en concurrence, de sorte que contrairement aux workers d’étape à connexion unique, il peut en utiliser plus d’une. Par défaut
1; ne le relevez que si la connexion unique limite la vitesse de réponse des points de terminaison, et gardez la somme du pool de chaque composant en dessous dumax_connectionsde PostgreSQL.- RESUME_AUTHORIZATION_TOKEN
(string, optional) Bearer token guarding
POST /resume(compared in constant time); the endpoint is disabled (404) when unset. Use the Talersecret-token:form so the same value can be reused as the merchantpepsi-resumewebhook’sAuthorizationheader (see pepsi-stage-anti-spam(1) and the[pepsi-payments]section).- ADDIN
(booléen, facultatif) Si les routes du module complémentaire Outlook (
GET /addin/manifest.xml, les volets de composition et de lecture, leur script et leurs icônes) répondent.nopar défaut : un déploiement qui ne se place pas devant un Exchange n’en a aucun usage, et un manifeste nommant une passerelle que personne n’a configurée ne ferait qu’entraîner des demandes d’assistance. Voir les chapitres « Microsoft Exchange comme passerelle » et « Extensions pour clients de messagerie » du manuel.- ADDIN_URL
(chaîne, facultative) L’origine
https://publique substituée dans les ressources du module d’extension. Non définie (le défaut), elle est dérivée de l’en-têteHostde chaque requête. Cela fonctionne aussi bien lorsquepepsi-httpdtermine le TLS lui-même que lorsqu’il se trouve derrière un proxy inverse ; dans ce dernier cas il voit du HTTP simple sur une socket UNIX et ne peut pas déduire le schéma public de la connexion. Réglez-la lorsque leHostqui atteint Pepsi ne nomme pas la passerelle. Le schéma doit êtrehttps, et cela est imposé : Outlook refuse de charger les ressources d’un module d’extension en HTTP simple, de sorte qu’une originehttp://ne pourrait produire qu’un manifeste qui échoue au chargement, etpepsi-httpdrefuse donc de démarrer avec une telle origine plutôt que de la servir. La seule exception est un hôte de boucle locale (localhost, tout ce qui est sous.localhost,127.0.0.0/8ou[::1]), où lehttp://simple est accepté afin qu’un développeur ou un test n’ait besoin d’aucun certificat. La valeur est vérifiée dès qu’elle est définie, queADDINsoit activé ou non, de sorte qu’une valeur erronée est signalée avant que la fonctionnalité ne soit activée.- REQUIRE_WEBAUTHN =
no|all| KIND [KIND …] (liste, facultative) Les sortes de comptes qui doivent utiliser une clé de sécurité WebAuthn comme second facteur :
admins(comptes de console),users(utilisateurs finaux qui se connectent par e-mail,own:<address>) etmembers(comptes de membres de listes de diffusion), ouall. Par défautno. Pour une sorte listée, un code TOTP ne suffit plus à achever une connexion, un compte de cette sorte sans clé en enregistre une comme dernière étape de sa prochaine connexion, et sa dernière clé ne peut pas être supprimée (le recours de l’opérateur est la réinitialisation WebAuthn de l’API). Sans la liste, une clé est facultative : un compte qui en enregistre une en a besoin (ou, s’il en a un, de son code TOTP) à partir de ce moment.adminsetusersont besoin de[pepsi-admin] CONSOLE_URLouENROL_URL,membersd’un[pepsi-list] BASE_URLenhttps://; pepsi-httpd(1) refuse de démarrer sinon.
Chaque section [pepsi-httpd-listener-<name>] lie une socket, avec les mêmes options SERVE (tcp/unix/systemd) et de transport qu’une section [pepsi-ingress-listener-<name>], sauf qu’un écouteur tcp a par défaut le PORT 443 et que MODE vaut plain ou tls (pas de STARTTLS). Un écouteur tls peut définir TLS_CERT/TLS_KEY comme certificat de repli ; s’ils ne sont pas définis, pepsi-setup(1) y inscrit la lignée certbot /etc/letsencrypt/live/<HOSTNAME>-web/, un certificat et une clé distincts de ceux des écouteurs d’ingress (dont l’enregistrement TLSA épingle la clé). Elle accepte en outre :
- ADMIN =
yes|no Si la surface d’administration — l’API
/api/v1, la console d’administration/uiet la page/metrics— est servie sur cet écouteur. Facultatif ; vautnopar défaut. Sur un écouteur qui ne l’a pas, ces routes répondent un simple404, identique octet pour octet à ce que reçoit n’importe quel chemin inconnu, de sorte que publier l’écouteur public ne publie pas l’administration./metricsfait partie de cet ensemble parce que les profondeurs de file par étape, les compteurs de plantage et les noms d’étape décrivent le pipeline ; contrairement aux deux autres, elle ne prend aucun identifiant (un collecteur Prometheus n’en a aucun à présenter), de sorte que sur un écouteur de métriques cet indicateur est le seul contrôle d’accès. Voir pepsi-httpd(1).pepsi-httpd(1) refuse de les servir sur un écouteur marqué qui les emporterait en clair hors de cet hôte : le
tcpen clair n’est accepté que sur une adresse de boucle locale, tandis que les écouteurstlset les socketsunixconviennent toujours. Un écouteurSERVE = systemden clair ne convient jamais : c’est l’unité qui a décidé où écoute le descripteur hérité, et le serveur ne peut pas voir cette adresse ; il refuse donc le cas qu’il ne peut pas juger plutôt que de l’autoriser. Un écouteur marqué qui échoue au test journalise un avertissement au démarrage et ne sert que les points de terminaison publics, et pepsi-setup(1) rapporte la même chose au moment de la validation.La configuration livrée marque un écouteur
unix, qui est la forme n’exigeant aucun identifiant : un processus qui se connecte est identifié parSO_PEERCRED. Voir[pepsi-admin]ci-dessous.- LIST_API =
yes|no Si l’API REST compatible GNU Mailman 3 (les routes
/3.0/et/3.1/) est servie sur cet écouteur. Facultatif ;nopar défaut, auquel cas ces routes répondent un simple404. Elle est soumise au même test de liaison qu”ADMIN (TLS, une socketunix, outcpen clair sur la boucle locale), et son identifiant est[pepsi-list] API_USER/API_PASS.- LIST_API_TESTING =
yes|no Si cette API offre en outre le point d’accroche
/3.1/reserved/reset, réservé aux tests, qui vide les tables des listes et des archives. Facultatif ;nopar défaut, et sans effet à moins que LIST_API soit utilisable sur l’écouteur. Uniquement pour un banc d’essai de compatibilité.- LISTS =
yes|no Si l’interface web publique des listes de diffusion (archives, pages d’abonnement) est servie sur cet écouteur. Facultatif ;
nopar défaut. Contrairement aux deux indicateurs ci-dessus, elle est destinée à être joignable depuis l’internet ouvert, de sorte que le test de liaison ne s’y applique pas. Ses limites de débit sont[pepsi-list] WEB_RATE_LIMITetWEB_SEARCH_RATE_LIMIT.
Chaque section [pepsi-httpd-cert-<name>] enregistre un certificat pour la sélection SNI : SNI (un ou plusieurs noms d’hôte), TLS_CERT et TLS_KEY. Les TLS_CERT/TLS_KEY propres d’un écouteur sont servis aux clients qui n’envoient pas de SNI, et à un nom SNI qu’aucune section ne liste seulement s’ils sont valides pour ce nom ; tout autre nom SNI fait échouer la poignée de main.
95.2.1.1.30. La section [pepsi-admin]¶
Options pour l’API d’administration servie par pepsi-httpd(1) sur un écouteur marqué ADMIN = yes. Chaque option a une valeur par défaut, la section peut donc être omise entièrement. Le modèle d’authentification, le tableau des portées et la référence des points de terminaison sont dans le chapitre « L’API d’administration » du manuel.
Les mêmes options régissent la console d’administration /ui, qui est un client de cette API et n’introduit aucune configuration propre : elle partage les délais de session, les limitations de débit, le plafond de corps, la taille de page et la connexion d’écriture de configuration. Voir le chapitre « La console d’administration » du manuel.
- ADMIN_GROUP
(chaîne, facultative) Groupe UNIX dont les membres sont administrateurs locaux sur un écouteur à socket UNIX, identifiés par
SO_PEERCRED.rootl’est toujours, groupe ou pas.pepsi-adminpar défaut.- SESSION_IDLE
(durée, facultative) Délai d’inactivité d’une session de navigateur, repoussé à chaque requête.
30 mpar défaut.- SESSION_LIFETIME
(durée, facultative) Durée de vie dure d’une session de navigateur, jamais prolongée.
12 hpar défaut. Il n’y a pas de « se souvenir de moi » : cette console peut révoquer une clé et lire qui correspond avec qui, et les administrateurs locaux, qui se connectent le plus souvent, s’authentifient parSO_PEERCREDet n’ont aucune session à expirer.- EVENT_RETENTION_DAYS
(nombre, facultatif) Durée de conservation des enregistrements d’audit, en jours. Par défaut
90.pepsi-httpd pruneapplique les deux durées de conservation.pepsi-log-prune.timerl’exécute chaque jour sous le comptepepsi-httpd, le seul rôle de base de données détenantDELETEsur les journaux, puisqu’aucun composant qui traite du courrier ne doit pouvoir les effacer. Le timer est indépendant du serveur web : la conservation s’applique quepepsi-httpd.servicetourne ou non.- MAIL_LOG_RETENTION_DAYS
(nombre, facultatif) Combien de temps les enregistrements du journal de courrier sont conservés, en jours, lorsque
[pepsi] MAIL_LOGest activé.30par défaut.Les deux rétentions sont des entiers de jours plutôt que des durées, car
Section::durationanalyse viajiff::SignedDuration, qui n’accepte queh/m/set en dessous.- RATE_LIMIT
(nombre, facultatif) Requêtes par minute et par adresse source (un écouteur à socket UNIX partage une seule clé pour tout l’hôte).
0désactive la limite.120par défaut.- LOGIN_RATE_LIMIT
(nombre, facultatif) Tentatives de connexion par minute, comptées par compte et par adresse source — beaucoup de mots de passe contre un compte et un mot de passe contre beaucoup de comptes sont des attaques différentes.
0désactive la limite.10par défaut.- LOGIN_DAILY_LIMIT
(nombre, facultatif) Connexions par mot de passe échouées par compte et par jour, toutes sources confondues.
LOGIN_RATE_LIMITseul laisse encore 600 essais par heure atteindre un compte ; dès qu’un compte a échoué ce nombre de fois, la console refuse ses connexions par mot de passe avec429jusqu’à ce que l’allocation se recharge (à raison de ce nombre par jour, en continu). Une connexion réussie ne coûte rien, le nom de compte est compté qu’un tel compte existe ou non, et la socket locale et les jetons porteurs ne sont pas des connexions par mot de passe, de sorte qu’un opérateur peut encore agir pendant qu’on cherche à deviner un compte.0désactive le plafond. Par défaut100.- MAX_BODY
(nombre, facultatif) Plus grand corps de requête accepté, en octets.
1048576par défaut.- PAGE_LIMIT
(nombre, facultatif) Taille de page par défaut d’un point de terminaison de listage. Un appelant peut en demander jusqu’à 1000 ; chaque listage honore
limitetoffsetdans son SQL et rapporte untotalexact à côté de la page, et rien ne renvoie un ensemble de résultats non borné.100par défaut ; une valeur configurée hors de1..``1000`` est ramenée dans cet intervalle plutôt que rejetée.- CONFIG_DB
(chaîne de connexion PostgreSQL, facultative) Connexion employée pour les écritures de configuration. Non définie par défaut, auquel cas
PUT/DELETEsur/api/v1/configrépondent503avec la raison et tout autre point de terminaison n’est pas affecté.Écrire
pepsi.config_overrideappartient au rôle de basepepsi-config, que pepsi-setup(1) accorde et révoque explicitement à chaque compte de service : un composant qui traite du courrier ne doit pas pouvoir réécrire le pipeline dans lequel il s’exécute. pepsi-httpd est un tel compte, et l’authentification par pair se fonde sur l’uid effectif : sa propre connexion ne peut donc pas être ce rôle. Pointez ceci vers une connexion qui s’authentifie commepepsi-config, au moyen d’un mot de passe dans un fragmentsecrets.dlisible par le seul comptepepsi-httpd, ou d’une correspondancepg_ident. Le serveur vérifie avecSELECT current_userau démarrage et refuse une connexion qui s’authentifie comme autre chose, car une frontière à laquelle le code se contente de croire n’est pas une frontière. Le refus n’est pas fatal : il est journalisé, le chemin d’écriture de la configuration reste désactivé, et le503nomme le rôle que la connexion a réellement obtenu. Un serveur démarré avec un privilège qu’il n’était pas censé avoir serait la pire issue.La configuration en ligne met en file par la même connexion et pour la même raison : seul
pepsi-configpeut faire unINSERTdanspepsi.setup_task, et l’applicateur privilégié refuse toute ligne disant autre chose. SansCONFIG_DB, les points de terminaison de configuration répondent503eux aussi : le serveur peut servir les questions et observer une tâche, mais ne peut pas en demander une.- APPLY_SOCKET
(chemin, facultatif) La socket par laquelle pepsi-httpd réveille l’applicateur de configuration privilégié.
/run/pepsi/setup-apply.sockpar défaut.Après avoir mis une tâche de configuration en file, pepsi-httpd se connecte à cette socket et la referme. Cette connexion est tout le message : rien n’y est écrit et rien n’en est jamais lu, elle ne peut donc pas devenir un canal de commande. Son seul effet est que l’activation par socket de systemd démarre
pepsi-setup apply, qui prend son travail dans la base (où chaque ligne est validée et auditée) et ressort quand il n’y en a plus.Pepsi utilise une socket plutôt qu’un signal ou un lancement, parce que pepsi-httpd s’exécute sans privilèges, n’a aucun moyen de démarrer un processus root et ne devrait pas en acquérir un. C’est l’unique mécanisme qui lui permet de faire s’exécuter un processus privilégié sans pouvoir influencer ce que ce processus fait. Un échec de connexion n’est pas une erreur : la tâche est durablement mise en file dans les deux cas, et
pepsi-setup apply --oncedepuis cron ou une console la reprend.Ce chemin est aussi ce que sonde
APPLIER = auto; voir ci-dessous.- APPLIER
(
auto|yes|no, facultatif) Si un changement de configuration privilégié peut avoir lieu depuis ce serveur, tout court.autopar défaut.Les unités systemd de l’applicateur sont empaquetées séparément (le paquet Debian pepsi-httpd-admin, ou
make install INSTALL_ADMIN_UNITS=nodepuis les sources), afin qu’un déploiement administré depuis un terminal puisse retirer l’unique mécanisme par lequel une requête HTTP atteint/etc/pepsi. Sans elles, rien ne videpepsi.setup_tasket une insertion dedans n’a aucun effet ; la console ne doit donc pas continuer de proposer des formulaires dont les envois ne seraient silencieusement jamais appliqués.autoSonder deux choses : que
pepsi-setup-apply.socketexiste comme fichier d’unité là où systemd en cherche un (installé), et qu”APPLY_SOCKETexiste, soit une socket et soit inscriptible par ce compte (armé — se connecter à une socket UNIX exige le droit d’écriture). La socket n’est jamais connectée : une connexion réveille l’applicateur, si bien qu’une telle sonde démarrerait un processus root à chaque rendu de page. La sonde échoue en fermeture : toute incertitude, y compris un chemin qui ne peut être examiné et un nœud de socket laissé par un paquet retiré, se lit comme « pas d’applicateur ».yesSupposer que l’applicateur est joignable et sauter la sonde. C’est pour un déploiement qui vide la file autrement (
pepsi-setup apply --oncedepuis cron, une unité écrite à la main, un hôte sans systemd), là où la sonde nierait une capacité qui existe. C’est une promesse que fait l’opérateur ; rien ne la vérifie.noRefuser chaque demande de configuration privilégiée, quel que soit ce qui est installé. Cela met la console en lecture seule sans changer l’ensemble des paquets.
Lorsqu’il n’y a pas d’applicateur, pepsi-httpd sert toujours le questionnaire de configuration, les réponses en attente et l’historique des tâches — en lecture seule, contrôles désactivés — et répond aux points de terminaison mutants
503setup_applier_unavailable. Voir pepsi-httpd(1).
Les options ENROL_* activent la connexion par e-mail : un utilisateur final saisit une adresse sur /ui/enrol, reçoit un lien à usage unique, et le confirmer (avec le second facteur TOTP de l’adresse lorsqu’il en a été inscrit un, vérifié par l’applicateur privilégié via une tâche confirm-enrolment) ouvre une session de console confinée à own:<address>. L’inscription a besoin de l’applicateur et de CONFIG_DB ; sans eux, le formulaire d’adresse répond qu’il n’est pas disponible. Voir pepsi-httpd(1) et le chapitre « La console d’administration » du manuel.
- ENROL_STAGE
(chaîne, facultative) L’étape à laquelle le courrier du lien est injecté, normalement celle par laquelle est remis le courrier local. Non définie (par défaut), elle désactive l’inscription, et ses pages répondent
404. pepsi-setup(1) refuse un nom sans section[stage-<name>]portant unPROGRAM, et refuse l’option lorsque le modèleenrol-link.en.bodymanque.- ENROL_URL
(chaîne ; obligatoire avec
ENROL_STAGE) L’originehttps://vers laquelle pointe le lien envoyé (schéma, hôte et port facultatif, rien après), c’est-à-dire l’endroit où les utilisateurs atteignent un écouteurADMIN = yes, directement ou via le reverse proxy TLS. Toute autre forme est refusée : le lien porte un identifiant secret. Elle n’est jamais dérivée duHostde la requête, qu’un demandeur pourrait choisir.- ENROL_FROM
(chaîne, facultative)
From:du courrier du lien. Par défautpostmaster@le propre domaine de l’adresse.- ENROL_LIFETIME
(durée, facultative) Durée pendant laquelle un lien fonctionne. Par défaut
30 m; au moins1 m. Un lien fonctionne une seule fois, accepte au plus cinq soumissions, et est remplacé par le suivant envoyé à la même adresse.- ENROL_MAIL_PER_HOUR
(nombre, facultatif) Nombre de liens envoyés à une même adresse cible par heure. Par défaut
3; au moins1.- ENROL_RATE_LIMIT
(nombre, facultatif) Demandes et confirmations d’inscription par adresse de client et par heure, en plus de
RATE_LIMIT. Par défaut20; au moins1.- CONSOLE_URL
(chaîne, facultative) L’origine publique
https://de la console (schéma, hôte et port facultatif), à laquelle sont liées les clés de sécurité WebAuthn : chaque assertion doit nommer cette origine, et son hôte est l’identifiant de RP. Par défautENROL_URL; si aucun des deux n’est défini, la console ne propose aucune clé de sécurité. Changer l’hôte plus tard rend inutilisable chaque clé enregistrée (une clé signe pour l’identifiant de RP sous lequel elle a été enregistrée) ; choisissez donc un nom sous lequel les utilisateurs continueront d’atteindre la console. Les pages de membres utilisent[pepsi-list] BASE_URLà la place.
95.2.1.1.31. L’option d’identité de sortie : PUBLIC_IP¶
- PUBLIC_IP = ADDR [ADDR …]
Liste séparée par espaces ou virgules des adresses IPv4 et/ou IPv6 publiques qui envoient du courrier au nom de vos domaines. Chacune devient un mécanisme
ip4:ouip6:dans l’enregistrementv=spf1que pepsi-setup(1) suggère. Aucune étape ne lit cette option à l’exécution : c’est purement une entrée pour l’enregistrement SPF généré.PUBLIC_IPest une option par-étape définie dans la section[stage-<name>]d’une étape de relais, et pepsi-setup(1) la collecte depuis chaque étape dont lePROGRAMest pepsi-stage-relay-to-internet(1) ou pepsi-stage-relay-to-smarthost(1) (il les détecte parPROGRAM, jamais par le nom de section) et fait l’union des résultats. Un déploiement peut donc avoir plusieurs étapes de relais, chacune portant son proprePUBLIC_IP:Sur une étape pepsi-stage-relay-to-internet, ce sont la ou les IP publiques d’envoi de cet hôte : l’hôte remet directement au MX des destinataires depuis celles-ci.
Sur une étape pepsi-stage-relay-to-smarthost, ce sont la ou les IP de sortie du smarthost : le courrier quitte internet depuis le smarthost, donc SPF doit l’autoriser (beaucoup de fournisseurs publient à la place un
include:que vous ajoutez à l’enregistrement à la main).
Si aucune étape de relais ne définit
PUBLIC_IP, l’enregistrement généré est un simplev=spf1 -all, et pepsi-setup(1) journalise un avertissement. Cet enregistrement indique aux destinataires qu”aucun hôte ne peut envoyer pour vos domaines, et il fait échouer SPF pour votre propre courrier sortant. Un déploiement en réception seule (sans étape de relais) n’a pas dePUBLIC_IPet n’est pas averti.Chaque adresse doit être une IP publique routable mondialement : l’adresse depuis laquelle les destinataires voient le courrier arriver. pepsi-setup(1) avertit (à la validation et dans la sortie DNS) si un
PUBLIC_IPest une adresse non publique (loopback, RFC 1918 / unique-local, link-local, ou CGNAT) : derrière un NAT, utilisez l’IP de sortie publique de l’hôte, pas son adresse LAN, sinon le courrier sortant sur cette famille d’adresses échouera au SPF.Reverse DNS (PTR). Each pepsi-stage-relay-to-internet
PUBLIC_IP, that is, this host’s own egress IP, must also have a forward-confirmed reverse DNS record that names the stage’sSERVER_NAME: aPTRfor the address whose host name in turn resolves (viaA/AAAA) back to the same address, and which is the very name that the stage announces inEHLO. Many receiving mail servers treat a missing, non-forward-confirmed, or generic/dynamic-lookingPTRas a spam signal and reject or junk the mail, and many of them also compare theEHLOname against thePTRand refuse the session when the two name different hosts (HELO host does not match rDNS). Being inside yourACCEPTED_DOMAINSdoes not satisfy that test: a host that answers to several names can announce one and reverse-resolve to another, both of them its own, and still be refused. pepsi-setup(1) warns for everyPUBLIC_IPwhose reverse DNS is not correct in this sense, including that mismatch, and prints the remediation (see pepsi-setup(1)). Reverse DNS for aPUBLIC_IPlives in the zone of the IP’s owner (in-addr.arpa/ip6.arpa), usually your ISP or hosting provider, so unlike the forward records it is often not something that you can publish yourself. Where it cannot be changed, setSERVER_NAME(and[pepsi-ingress]HOSTNAME, the MX record and the TLS certificate) to the name that thePTRalready gives. A pepsi-stage-relay-to-smarthostPUBLIC_IPnames the smarthost’s egress IPs, whose reverse DNS the smarthost operator controls, so those are not checked.L’enregistrement unifié est publié à l’identique pour chaque domaine servi. C’est correct mais large ; dans des configurations particulières où différents domaines envoient depuis différents hôtes, un enregistrement SPF par domaine écrit à la main (ne listant que les IP d’envoi propres à ce domaine) peut être plus strict tout en restant correct. pepsi-setup(1) ne calcule pas ce regroupement automatiquement et le signale dans sa sortie DNS.
95.2.1.1.32. Les sections MTA [pepsi-stage-relay-to-smarthost]¶
95.2.1.1.32.1. Les sections smarthost (MTA)¶
Chaque section [pepsi-stage-relay-to-smarthost-mta-<name>] définit un smarthost amont ; le suffixe <name> est un label de forme libre utilisé dans les journaux. Ces sections sont partagées par chaque étape de relais vers smarthost. Un domaine de destinataire est acheminé vers le MTA dont le DOMAINS le liste, ou vers l’unique MTA CATCH_ALL.
- HOST
(chaîne, obligatoire) Nom d’hôte ou adresse du smarthost auquel se connecter.
- PORT
(nombre, obligatoire) Port TCP sur lequel se connecter (par exemple
587ou465).- MODE
(facultatif) Sécurité du transport :
starttls(par défaut),tls(TLS implicite) ouplain(en clair).- TLS_VERIFY
(booléen, facultatif) Si le certificat TLS du smarthost est vérifié par rapport au magasin de confiance du système. Par défaut
yes;noaccepte n’importe quel certificat, ce qui n’est pas une étape de dépannage mais expose la connexion à quiconque se trouve sur le chemin : quiconque peut intercepter la connexion (un intermédiaire) présente un certificat à lui et reçoit les identifiantsAUTHet chaque message relayé. Pour un smarthost doté d’une CA privée, nommez plutôt cette CA dansTLS_CA_BUNDLE(ouTLS_CA). Avec la vérification activée, une réponse OCSP que le smarthost agrafe est évaluée et unrevokedvérifié refuse la session ; aucun répondeur n’est interrogé.- TLS_CA
(chemin, facultatif) Certificats de CA supplémentaires (PEM) à approuver en plus du magasin du système. Un certificat pour le nom du smarthost émis par n’importe quelle racine du magasin de l’hôte l’authentifie toujours ;
TLS_CA_BUNDLEest le choix le plus restreint.- TLS_CA_BUNDLE
(chemin, facultatif) Les certificats de CA (PEM) qui forment l”intégralité du magasin de confiance pour ce smarthost : les racines du système ne sont pas consultées, de sorte que seul un certificat qui se rattache à l’une de ces ancres l’authentifie. Utilisez-le pour un smarthost doté de sa propre CA, ou pour épingler l’unique CA publique qu’utilise le fournisseur. Le fichier est lu au démarrage du worker de l’étape ; si le fichier est illisible ou ne contient aucun certificat, le worker refuse de démarrer. Le définir avec
TLS_CA, ou avecTLS_VERIFY = no, est une erreur de configuration. Une connexion vérifiée par rapport à lui ne fait pas l’objet de la vérification Certificate Transparency, comme pourTLS_CA.- TLS_CLIENT_CERT / TLS_CLIENT_KEY
(chemin, facultatif ; les deux ou aucun) Un certificat client (chaîne PEM) et sa clé privée à présenter au smarthost pendant la poignée de main TLS (TLS mutuel). Chargés à neuf à chaque connexion. Nécessite un
MODEchiffrant (tlsoustarttls) et s’applique à PKIX,TLS_VERIFY = noet DANE indifféremment. La clé est secrète : gardez-la lisible seulement par le groupepepsi-tokensous lequel l’étape de relais s’exécute SGID (sur Debian, placez le certificat + la clé dans le répertoire SGID/var/pepsi/tls). RéglezAUTH = externalpour aussi authentifier la session SMTP avec le certificat via SASLEXTERNAL.- DANE
(facultatif) Application DANE/TLSA (RFC 7672) vers ce smarthost :
off,warn(une renonciation explicite) oustrict(la valeur par défaut). Lorsque le smarthost publie des enregistrementsTLSAvalidés par DNSSEC à_<PORT>._tcp.<HOST>, le certificat est authentifié par rapport à eux ; un certificat qui correspond à un enregistrement utilisable n’a besoin d’aucune vérificationTLS_VERIFY(PKIX). Enwarn, une non-concordance est journalisée et le certificat est alors vérifié comme sans DANE, parTLS_VERIFY: avec la valeur par défautTLS_VERIFY = yes, le certificat d’un imposteur est toujours refusé. Enstrict, un enregistrement utilisable mais non concordant, ou une rechercheTLSAéchouée (y compris des serveurs de noms impossibles à déterminer), diffère le message ; souswarn, un tel échec est journalisé et le saut se poursuit avecTLS_VERIFY. Lorsqu’un même usage et un même sélecteur sont publiés à la fois en SHA-256 et en SHA-512, seuls les enregistrements SHA-512 sont comparés (RFC 7671 section 9). Ignoré lorsqueMODE = plain. Nécessite un résolveur validant DNSSEC atteint par un chemin de confiance (Pepsi fait confiance au bit AD de la réponse) ; voir leDNS_SERVERSde l’étape.- ADDRESS_FAMILY
(facultatif) Quelles familles d’adresses IP peuvent être employées pour joindre ce smarthost :
any,ipv4(aussi orthographiév4/v4only) ouipv6(v6/v6only).La précédence est : cette entrée, puis la section
[stage-*]propriétaire, puisany. Le niveau par entrée est ce qui rend l’option utile : une destination qui se comporte mal peut être épinglée sans forcer toutes les autres (y compris une qui ne publie que desAAAA) sur la même famille.Le cas qui motive cela est Microsoft Exchange Online, qui rejette le courrier venu d’une adresse IPv6 émettrice sans enregistrement
PTR(550 5.7.1 ... S820). Un hôte à double pile préfère l’IPv6 : une machine au DNS inverse IPv4 correct et au DNS inverse IPv6 non délégué remet donc correctement partout sauf là.Avec
any(le défaut), le nom d’hôte est remis au résolveur du système. Toute autre valeur fait résoudre l’hôte par Pepsi lui-même et essayer tour à tour chaque adresse de la famille choisie. Une destination qui ne publie aucune adresse de la famille choisie est un échec transitoire, non un rebond : c’est une erreur d’opérateur qu’il vaut la peine de retenter, non une pour laquelle il vaudrait la peine de détruire du courrier en file.- AUTH
(facultatif) Mécanisme d’authentification SMTP :
none(par défaut),plain,login,cram-md5,digest-md5,scram-sha-1,scram-sha-256,scram-sha-1-plus,scram-sha-256-plus,auto,external,oauth,ntlmougssapi.plain/login/cram-md5/digest-md5/la famillescram-*/autonécessitent tousUSERNAMEetPASSWORD;oauthnécessiteUSERNAMEetTOKEN_FILE;external(SASLEXTERNAL, RFC 4422) nécessiteTLS_CLIENT_CERT/TLS_CLIENT_KEYet s’authentifie par ce certificat (aucun mot de passe envoyé), avec unUSERNAMEfacultatif comme identité d’autorisation SASL.cram-md5(RFC 2195) etscram-sha-1/scram-sha-256(RFC 5802 / RFC 7677) sont des défi/réponse : le mot de passe n’est jamais envoyé, et SCRAM authentifie en outre le serveur auprès de Pepsi (une mauvaise signature de serveur interrompt l’échange et, comme toutAUTHrejeté, diffère le message). Les variantes SCRAM-plusajoutent la liaison de canaltls-server-end-point(RFC 5929).autochoisit le mécanisme le plus fort que le smarthost annonce (SCRAM-SHA-256-PLUS>SCRAM-SHA-256>SCRAM-SHA-1-PLUS>SCRAM-SHA-1>CRAM-MD5>LOGIN>PLAIN) ; il ne sélectionne jamais ledigest-md5déprécié,ntlmougssapi.digest-md5(RFC 2831) est aussi un défi/réponse avec authentification du serveur (rspauth) mais est déprécié (la RFC 6331 l’a passé au statut Historic) et fourni seulement pour les smarthosts hérités ; le sélectionner journalise un avertissement depuis pepsi-setup(1) et à l’exécution.ntlmest le mécanisme Microsoft de facto (sans RFC ; NTLMv2 uniquement, avec liaison de canal EPAtls-server-end-point) nécessitantUSERNAME/PASSWORD/NT_DOMAIN; il est faible et n’authentifie pas le serveur, de sorte que pepsi-setup(1) avertit.gssapiest SASLGSSAPI/Kerberos (RFC 4752) ; il ne prend aucun mot de passe, obtenant un ticket de service pourSERVICE_NAMEdepuis un cache d’identifiants (KRB5CCNAME). Tous ne sont offerts que sur un transport chiffré (MODE=tls/starttls) ;ntlmetgssapirejettentMODE = plainau moment de la configuration.- USERNAME / PASSWORD
(chaîne, requise lorsque AUTH est plain/login/cram-md5/digest-md5/scram-*/auto/ntlm) Les identifiants SMTP-AUTH. Gardez
PASSWORDdans un fichier à mode restreint fusionné avec@inline-secret@. Pour les mécanismesscram-*, les deux sont normalisés avec SASLprep (RFC 4013).USERNAMEest aussi l’identité d’autorisation facultative pourAUTH = externaletAUTH = gssapi.- NT_DOMAIN / NT_WORKSTATION
(chaîne ; NT_DOMAIN requis lorsque AUTH = ntlm) Le domaine Windows du compte NTLM, et un nom de poste de travail client cosmétique facultatif.
- SERVICE_NAME
(chaîne, facultative ; AUTH = gssapi) Le principal de service Kerberos basé sur l’hôte du smarthost, sous la forme
service@host. Par défautsmtp@<HOST>.- KRB5CCNAME
(chaîne, facultative ; AUTH = gssapi) Le cache d’identifiants Kerberos à lire pour ce smarthost (par exemple
FILE:/var/pepsi/krb5/smarthost.cc), redéfinissant leKRB5CCNAMEambiant. Il est remis à la bibliothèque Kerberos avec la requête (gss_acquire_cred_from) ; l’environnement du processus n’est jamais modifié. Pepsi ne fait que lire le cache ; un keytab externe + un jobk5start/crondoit garder le ticket à jour, et le cache doit être lisible par le worker de relais (le groupe SGIDpepsi-token; voir/var/pepsi/krb5). Un ticket manquant/expiré diffère le message (échec transitoire) plutôt que de générer un rebond.- TOKEN_FILE
(chemin, requis lorsque AUTH = oauth) Fichier contenant le jeton d’accès OAuth 2.0 courant (débarrassé des espaces), relu à chaque remise. Le mécanisme SASL est choisi à partir de l”
EHLOdu smarthost (OAUTHBEARERpréféré, sinonXOAUTH2). L’étape de relais ne fait que lire ce fichier ; gardez-le à jour avec pepsi-helper-token-refresh(1) (voir les sections[pepsi-helper-token-refresh-*]) ou tout job externe équivalent. Un jeton manquant/expiré/rejeté diffère le message (échec transitoire) plutôt que de le faire rebondir.- HELO_NAME
(chaîne, facultative) Nom annoncé dans
EHLOà ce smarthost. Par défaut leSERVER_NAMEde l’étape. UnHELO_NAMEexplicite l’emporte sur leEHLO_FROM_PTRde l’étage.- DOMAINS
(chaîne) Domaines de destinataires séparés par espaces/virgules acheminés vers ce MTA (insensible à la casse). Requis sauf si
CATCH_ALL = yes; un domaine peut être acheminé par au plus un MTA.- CATCH_ALL
(booléen, facultatif) Si ce MTA reçoit chaque domaine non apparié par une entrée
DOMAINS. Par défautno; au plus un MTA peut le régler. Un MTA doit listerDOMAINSou réglerCATCH_ALL = yes.
95.2.1.1.33. Les sections [pepsi-helper-token-refresh]¶
Celles-ci configurent pepsi-helper-token-refresh(1), le service facultatif qui garde à jour les jetons d’accès OAuth des smarthosts AUTH = oauth. L’ensemble de jetons à maintenir est dérivé des sections MTA smarthost : pour chaque [pepsi-stage-relay-to-smarthost-mta-<name>] avec AUTH = oauth, le service cherche une section [pepsi-helper-token-refresh-<name>] correspondante. Le service ne fait pas partie de pepsi.target ; activez-le explicitement.
Comme les sections par cible contiennent les secrets client OAuth, gardez-les dans un fichier lisible seulement par l’utilisateur pepsi-helper-token-refresh et incluez chacune avec la directive @inline-secret@. Un lecteur qui ne peut pas ouvrir le fichier, comme l’étape de relais exécutée en tant que pepsi, saute silencieusement la directive, de sorte que le même pepsi.conf s’analyse pour les deux. Voir pepsi-helper-token-refresh(1) et le chapitre Étendre le pipeline du manuel.
La section de base facultative [pepsi-helper-token-refresh] contient des options non secrètes à l’échelle du service :
- STATE_DIR
(chemin, facultatif) Répertoire privé (mode
0700) pour les jetons de rafraîchissement renouvelés par cible. Par défaut/var/pepsi/token-refresh.
Chaque section [pepsi-helper-token-refresh-<name>] (<name> correspondant à un MTA smarthost OAuth) contient :
- TOKEN_ENDPOINT
(chaîne, obligatoire) L’URL du point de terminaison de jeton OAuth 2.0 du fournisseur. Ce doit être une URL
https://: tout autre schéma fait échouer le rafraîchissement de cette cible plutôt que d’envoyer le secret client en clair. C’est aussi ainsi que le service distingue une section de secret manquante d’une section illisible : un fichier@inline-secret@que ce compte ne peut pas ouvrir n’est tout simplement pas là, de sorte qu’unTOKEN_ENDPOINTabsent fait sauter cette cible avec un avertissement au lieu de faire échouer le service. Les options restantes ci-dessous sont alors des erreurs, non des sauts.- GRANT
(facultatif)
refresh_token(le défaut ; par exemple Google) ouclient_credentials(par exemple Microsoft 365 application seule).- CLIENT_ID / CLIENT_SECRET
(chaîne, obligatoire) Les identifiants client OAuth, envoyés dans le corps de la requête.
- REFRESH_TOKEN
(chaîne, requise pour GRANT = refresh_token) Le jeton de rafraîchissement à longue durée de vie. Une valeur renouvelée renvoyée par le point de terminaison est persistée sous
STATE_DIRet a alors priorité.- SCOPE
(chaîne, requise pour GRANT = client_credentials ; facultative sinon) Le scope demandé.
- REFRESH_MARGIN
(durée, facultative) Combien de temps avant l’expiration déclarée d’un jeton le rafraîchir. Par défaut
5 m. Utilise les unitésh/m/suniquement.
95.2.1.1.34. La section [pepsi-payments]¶
Cette section facultative configure l’intégration de paiement GNU Taler. Lorsqu’elle est absente (ou que MERCHANT_BACKEND_URL n’est pas réglé), pepsi-setup(1) n’effectue aucune vérification marchand et aucun webhook n’est provisionné. La même section est lue à l’exécution par pepsi-stage-anti-spam(1) pour créer des commandes de paiement par message.
- MERCHANT_BACKEND_URL = URL
URL de base du backend marchand Taler, incluant facultativement l’instance (
…/instances/$ID). pepsi-setup(1) demandeGET /configà la racine du backend (tout/instances/$IDfinal est retiré) pour confirmer que c’est un backendtaler-merchant, etGET /private/orders?limit=1à cette URL pour confirmer le jeton d’accès. Requis pour activer l’intégration.Ce doit être une URL
https://, ou une URLhttp://dont l’hôte est l’interface de bouclage (localhost,127.0.0.0/8,::1).MERCHANT_ACCESS_TOKENest attaché à chaque requête comme identifiant porteur : un backend en clair ailleurs, y compris un backend qui « n’est que sur le LAN », remet donc cet identifiant de longue durée à tout ce qui se trouve sur le chemin. Les requêtes sont bornées (10 s pour se connecter, 30 s au total), de sorte qu’un backend qui ne répond pas coûte un message, et non l’étape : pepsi-stage-anti-spam(1) retient ce message et redemande jusqu’à son échéance de paiement, puis le remet sans vérification.- MERCHANT_ACCESS_TOKEN = TOKEN
Jeton d’accès pour le backend marchand, sous la forme Taler
secret-token:…, envoyé comme un identifiantAuthorization: Bearer. Il a besoin des permissionsorders-readetwebhooks-read/webhooks-write. Requis lorsqueMERCHANT_BACKEND_URLest réglé.
Le webhook pepsi-resume provisionné se déclenche sur l’événement pay et fait un POST de {"message_id":"{{order_id}}"} vers https://<host>/resume (l’hôte SNI [pepsi-httpd-cert-*] le plus court), authentifié avec [pepsi-httpd] RESUME_AUTHORIZATION_TOKEN. L”order_id du marchand doit donc être égal au jeton externe du message.
95.2.1.1.35. La section [pepsi-vacation-default-message]¶
Les avis d’absence par langue sur lesquels pepsi-stage-vacation(1) se rabat, une option par langue
[pepsi-vacation-default-message]
EN = Hello {{SENDER_NAME}}, I am away until {{VACATION_END}}.
DE = Hallo {{SENDER_NAME}}, ich bin bis {{VACATION_END}} abwesend.
Le nom de l’option est l’étiquette de langue (EN, DE, PT_BR — l’un ou l’autre séparateur), et la valeur est un modèle Mustache. Quelle langue est employée, quels champs se développent, et pourquoi deux espaces deviennent un saut de ligne sont tous documentés dans pepsi-stage-vacation(1).
Cette section existe normalement déjà. make install la livre comme ${DATADIR}/config.d/vacation.conf, et le chargeur de configuration de taler analyse chaque fichier de ${DATADIR}/config.d avant pepsi.conf. Une étape configurée sans message à elle dispose donc tout de même de dix langues, et un opérateur qui veut une autre formulation redéfinit dans pepsi.conf la seule langue qui l’intéresse : les définitions ultérieures l’emportent option par option, jamais section par section, de sorte que redéfinir EN laisse les neuf autres en place. Éditer le fichier livré fonctionne aussi, mais une mise à niveau du paquet écrase la modification.
Le nom de la section n’est qu’un défaut (DEFAULT_MESSAGE_SECTION), de sorte qu’un opérateur voulant plusieurs jeux de messages (un formel pour une adresse d’assistance, un laconique pour tout le monde) puisse définir d’autres sections et y pointer différentes étapes, domaines ou adresses.
Un titulaire de compte ne touche jamais à cette section : son propre texte va dans MESSAGE_<LANG> de la section propre à l’étape, que la couche de paramètres peut porter et qui l’emporte langue par langue.
95.2.1.1.36. La section [pepsi-autoconfig]¶
Cette section facultative publie l”autoconfiguration des comptes de courrier (draft-ietf-mailmaint-autoconfig) : le document XML qu’un client de messagerie récupère, ne connaissant que l’adresse de l’utilisateur, afin de se configurer lui-même au lieu de demander huit paramètres que l’utilisateur ne peut généralement pas fournir. Il est servi par pepsi-httpd(1) à /mail/config-v1.1.xml sur autoconfig.<domain>, et à /.well-known/autoconfig/mail/config-v1.1.xml sur le domaine de courrier lui-même.
La fonctionnalité est désactivée tant qu’aucun serveur entrant n’est nommé. Si vous omettez la section, ou ne réglez ni IMAP_HOST ni POP3_HOST, les deux points de terminaison répondent 404. Un client qui trouve un document de configuration cesse de parcourir la chaîne de repli, de sorte qu’en publier un incapable de lui dire comment lire le courrier laisse l’utilisateur en plus mauvaise posture que de n’en publier aucun.
Pepsi ne sert pas de boîtes aux lettres (voir pepsi-stage-relay-to-lmtp(1)) : la moitié entrante doit donc nommer le MDA auquel le déploiement est associé, typiquement Dovecot sur le même hôte.
Deux choses extérieures à ce fichier sont également nécessaires. Un enregistrement DNS autoconfig.<domain> doit se résoudre vers ce serveur, et le certificat TLS doit couvrir ce nom : les clients essaient d’abord l’URL https://autoconfig.…, et une erreur de certificat là est une consultation échouée. La moitié « certificat » est prise en charge pour vous lorsque pepsi-setup(1) provisionne les certificats : cette section nommant un serveur entrant, il ajoute autoconfig.<domain>, pour chaque domaine servi, aux noms qu’il demande pour le certificat du [pepsi-httpd-listener-*] TLS. L’enregistrement DNS, lui, n’est pas pris en charge pour vous, puisqu’il est publié dans votre zone. Un déploiement peu disposé à ajouter le nom peut se reposer sur la seule forme /.well-known/, au prix de n’être trouvé que par les clients qui l’essaient.
- IMAP_HOST, POP3_HOST
(nom d’hôte, facultatif) Le serveur de boîtes aux lettres à annoncer. Régler l’un ou l’autre active la fonctionnalité ; n’en régler aucun la désactive. Il n’y a pas de valeur par défaut : un nom d’hôte inventé serait pire que le silence.
- IMAP_PORT, POP3_PORT
(nombre, facultatif) Par défaut
993et995, les ports à TLS implicite.- IMAP_SOCKET, POP3_SOCKET
(``SSL`` | ``STARTTLS`` | ``plain``, facultatif) Sécurité du transport, dans le vocabulaire propre au draft (
SSLsignifie TLS implicite) ;tlsetnonesont acceptés comme orthographes deSSLetplain.SSLpar défaut. Une valeurplainest refusée sauf si ALLOW_PLAIN_AUTOCONFIG (ci-dessous) indique qu’elle est voulue.- ALLOW_PLAIN_AUTOCONFIG
(yes/no, par défaut no) Reconnaître qu’un serveur que cette section annonce avec un
*_SOCKETvalantplainest destiné à être utilisé sans TLS. Sans cela, unplainn’importe où dans cette section fait refuser la configuration àvalidatede pepsi-setup(1) et refuser de démarrer à pepsi-httpd(1), chacun nommant l’option, le serveur et son port. Unplainglissé par erreur n’atteint donc jamais un client, qui l’appliquerait sans demander et enverrait son mot de passe et son courrier en clair. Définissez-la àyessur un réseau fermé (un serveur de boîtes aux lettres en loopback ou accessible seulement par VPN) où le texte en clair est le choix délibéré ; le serveur en clair est alors publié comme demandé, et pepsi-httpd journalise toujours un avertissement à son sujet à chaque démarrage. Elle n’affecte jamais un serveur de soumission dérivé, qui n’est jamais en clair.- IMAP_AUTH, POP3_AUTH
(facultatif) L’une des valeurs d’authentification du draft :
password-cleartext,password-encrypted,NTLM,GSSAPI,TLS-client-cert,OAuth,client-IP-address,none.password-cleartextpar défaut, ce qui surSSLest l’arrangement ordinaire du mot de passe sur TLS plutôt que quoi que ce soit envoyé en clair. Une valeur non reconnue est une erreur de démarrage, non une faute de frappe publiée en silence.- SMTP_HOST, SMTP_PORT, SMTP_SOCKET, SMTP_AUTH
(facultatif) Le serveur de soumission à annoncer. Omettez normalement les quatre : ils sont dérivés du port, du
MODEet du mécanisme d’authentification de la section[pepsi-ingress-listener-*]marquéeSUBMISSION = yes, de sorte que déplacer la soumission du STARTTLS sur 587 vers le TLS implicite sur 465 mette à jour le document publié tout seul, et que les deux ne puissent pas diverger. Ne les définissez que lorsque le point de terminaison public de soumission n’est pas l’écouteur, par exemple derrière un répartiteur de charge. DéfinirSMTP_HOSTdésactive entièrement la dérivation : donnez donc aussi les autres s’ils diffèrent de587/STARTTLS/password-cleartext.SMTP_SOCKET = plainexige la même reconnaissance ALLOW_PLAIN_AUTOCONFIG que les serveurs entrants.Un écouteur de soumission sur socket UNIX ou activé par systemd n’est jamais annoncé : un client distant ne peut pas employer le premier, et le second n’a aucun port dans la configuration à publier.
- DISPLAY_NAME, DISPLAY_SHORT_NAME
(texte, facultatif) Ce que le client montre à l’utilisateur. Les deux valent par défaut la première entrée de
[pepsi-ingress] ACCEPTED_DOMAINS(leHOSTNAMEde l’ingress lorsqu’aucun domaine n’est configuré).- DOCUMENTATION_URL
(URL, facultative) Une page d’aide pour les paramètres du compte, publiée comme élément
<documentation>du draft. Omise lorsqu’elle n’est pas définie.
[pepsi-autoconfig]
IMAP_HOST = mail.example.org
POP3_HOST = mail.example.org
DISPLAY_NAME = Example Mail
DISPLAY_SHORT_NAME = Example
# SMTP_* deliberately omitted: derived from the submission listener.
95.2.1.1.37. La section [pepsi-tlsrpt]¶
Cette section facultative configure le SMTP TLS Reporting (RFC 8460). Elle a deux moitiés indépendantes ; omettez la section pour désactiver les deux. pepsi-setup(1) la lit pour la moitié d’annonce ; la moitié émettrice est lue à l’exécution par les étapes de relais (enregistrement de session) et pepsi-tlsrpt(1) (le job de rapport quotidien).
- RUA = URI [, URI …]
Adresse(s) de rapport annoncée(s) dans l’enregistrement TXT
_smtp._tls.<domain>que pepsi-setup(1) émet pour chaque domaine, afin que d’autres expéditeurs nous rapportent leurs résultats TLS pour le courrier destiné à nos domaines. Une URImailto:ouhttps:, ou une liste séparée par virgules, stockée verbatim. Lorsqu’elle n’est pas réglée, aucun enregistrement n’est publié.- SEND_REPORTS =
yes|no Si les étapes de relais enregistrent chaque session TLS sortante dans
pepsi.tls_session. Facultatif ; par défautno. C’est l’interrupteur de la seule moitié enregistrement : lorsqueRUAest défini, pepsi-tlsrpt(1) ne le teste pas, il ne trouve simplement aucune session à rapporter lorsque rien ne les enregistre (sansRUAni cette option, la section compte comme absente etpepsi-tlsrpt reportrefuse de s’exécuter).- REPORT_FROM = ADDRESS
Expéditeur d’enveloppe et
From:des e-mails de rapport que pepsi-tlsrpt(1) envoie. Requis pour envoyer des rapports (son domaine est le soumetteur du rapport). Les rapports ne sont pas à expéditeur nul (RFC 8460 §5.3 : ils doivent être alignables DKIM/DMARC) ; la boucle rapport-sur-rapport est empêchée par l’indicateurstate.tlsrptinjecté.- REPORT_STAGE = STAGE
Les e-mails de rapport de l’étape de pipeline sont injectés à (de sorte qu’ils soient signés et relayés), comme le
BLOCK_RESPONSE_STAGEde pepsi-stage-anti-spam(1). Doit référencer une[stage-*]existante. Requis pour envoyer les rapports par e-mail (mailto:).- ORGANIZATION = NAME
organization-nameplacé dans les rapports émis. Facultatif ; par défaut le domaine deREPORT_FROM.- CONTACT = ADDRESS
contact-infoplacé dans les rapports émis. Facultatif.- RETAIN_DAYS = DAYS
Combien de jours pepsi-tlsrpt prune conserve les compteurs
pepsi.tls_session. Facultatif ; par défaut7.pepsi-tlsrpt-prune.timerexécute l’élagage quotidiennement.
95.2.1.1.38. La section [pepsi-dmarc-reports]¶
Cette section facultative régit les rapports agrégés DMARC que stocke pepsi-stage-dmarc-report(1). Elle est lue par cette étape (au démarrage du worker), par gc de pepsi-queue(1), par pepsi-status(1), par la console d’administration et par check de pepsi-setup(1). Chaque option a une valeur par défaut.
- RETAIN_DAYS = DAYS
Combien de jours un rapport est conservé après la fin de la période qu’il couvre ;
pepsi-queue gc(pepsi-origin-gc.timer, toutes les heures) supprime les plus anciens avec leurs enregistrements. Par défaut90, au moins1.- WINDOW_DAYS = DAYS
Combien de jours en arrière, d’après la fin de la période de chaque rapport, portent les résumés et le verdict de
pepsi-setup check(chaque source alignée, de sorte quep=rejectest sûr ; ou les sources qu’il refuse). Par défaut7; entre1et RETAIN_DAYS.
95.2.1.1.39. La section [pepsi-telemetry-client]¶
Cette section facultative configure l’agrégateur local de télémétrie de fonctionnalités, pepsi-telemetry-client(1). Toutes les options ont des valeurs par défaut fonctionnelles ; toute la fonctionnalité est conditionnée par [pepsi] SHARE_TELEMETRY ci-dessus, désactivé à moins que l’opérateur ne l’ait activé. Rien ici n’a d’effet tant qu’il n’est pas activé. (Le collecteur central, pepsi-telemetry(1), lit à la place la section séparée [pepsi-telemetry].)
- UNIXPATH = PATH
Socket UNIX locale sur laquelle le daemon écoute les événements de fonctionnalités ; les programmes producteurs se connectent au même chemin. Facultatif ; par défaut
/run/pepsi-telemetry/socket.- UNIXPATH_GROUP = GROUP
Groupe vers lequel la socket est
chgrp-ée (modeUNIXPATH_MODE), afin que les producteurs puissent se connecter : les utilisateurspepsi(workers d’étape, dispatcher),pepsi-ingress,pepsi-httpdetpepsi-keydisc, qui en sont tous membres. Facultatif ; par défautpepsi-telemetry.- UNIXPATH_MODE = OCTAL
Bits de permission de la socket. Facultatif ; par défaut
660.- SUBMIT_INTERVAL = DURATION
Intervalle entre les soumissions au collecteur (unités
h/m/suniquement — voir la note sur la durée ci-dessus). Facultatif ; par défaut60 s. Zéro est une erreur de configuration, non une boucle active.- MAX_FEATURES = N
Plafond du nombre de noms de fonctionnalités distincts tenus en mémoire, bornant la mémoire contre un producteur local au comportement défaillant. Facultatif ; par défaut
4096.
95.2.1.1.40. Données stockées¶
Pour chaque message accepté, pepsi-ingress(1) insère une ligne dans la table pepsi.workqueue contenant un identifiant local (workqueue_id), un token aléatoire, l’horodatage de réception (received_at), l’expéditeur d’enveloppe (mail_from ; la chaîne vide pour l’expéditeur nul <>), la liste des destinataires d’enveloppe (rcpt_to), et les en-têtes from_header et subject analysés. Le message lui-même est stocké scindé en deux : une colonne headers (le bloc d’en-têtes RFC 5322 jusqu’au séparateur de ligne vide non inclus, avec l’en-tête de trace Received: du §4.4 de la RFC 5321 et, au-dessus de lui, l’en-tête Authentication-Results ajoutés en tête ; l’ensemble ARC est ajouté plus tard par pepsi-stage-arc(1)) et un corps (tout ce qui suit la ligne vide ; vide pour un message à en-têtes seuls). L’invariant de reconstruction est raw = headers || CRLF || body. Scinder le message permet aux étapes qui ne touchent que les en-têtes ou l’enveloppe de charger (et réécrire) seulement la colonne headers et de ne jamais tirer le corps (potentiellement volumineux).
Le corps n’est pas une colonne de pepsi.workqueue mais une ligne de sa propre table, pepsi.workqueue_body (body_id, body, et la taille générée octets), que la ligne du message référence par body_id. Cela évite qu’un message à plusieurs destinataires soit stocké une fois par destinataire. Chaque ligne qui en est scindée référence la même ligne de corps, que la scission vienne de paramètres par adresse, de la ligne par destinataire d’une étape de relais, de la diffusion d’une liste de diffusion, ou d’un bounce ou d’un DSN par destinataire, de sorte qu’une contribution de 25 Mio à mille membres représente un corps de 25 Mio et mille petites lignes. Une étape qui réécrit un corps (déchiffrement, pied de page d’une liste) stocke une nouvelle ligne de corps et ne redirige que son propre message (copie sur écriture), de sorte qu’aucune réécriture ne peut atteindre une ligne sœur. Un corps est supprimé par un trigger dès que la dernière ligne qui le référence est supprimée ou redirigée, et pepsi-dispatch(1) balaie l’orphelin rare qu’une course laisse derrière elle (pepsi.workqueue_body_gc()). header_octets est la taille générée correspondante de headers. La vérification d’admission de la file d’attente (MAX_QUEUE_BYTES, pepsi.queue_usage()) somme les deux colonnes de taille, que des rôles qui ne peuvent pas lire le message lui-même peuvent tout de même lire. Les verdicts SPF, DKIM et DMARC calculés sont stockés dans le state de la ligne sous une clé auth, et l”authserv_id sous state.origin ; le verdict arc commence à none et est rempli par l’étape ARC. Le dispatcher n’est pas notifié depuis cette transaction : pepsi-ingress(1) regroupe les admissions et émet au plus un réveil par DISPATCH_WAKE_INTERVAL, hors bande et après la validation des lignes, avec une charge utile vide (voir la description de cette option ci-dessus). Un consommateur LISTEN workqueue ne reçoit donc aucune notification par message ni aucune charge utile à analyser.
Chaque ligne porte en outre son état de traitement pour le pipeline d’étapes qui s’exécute après l’ingress : un stage (la section [stage-<stage>] du programme actuellement responsable de faire avancer le message), un status (l’un de pending, running, paused, failed ou timeout), un state (l’objet JSON transporté avec le message, documenté dans pepsi.state(7)), et un timeout (quand un message paused devrait être remis en file). Chaque nouveau message est inséré explicitement à l’étape initiale — stage = init, status = pending — de sorte qu’il entre dans le pipeline à [stage-init]. Ces colonnes sont inspectées et réparées avec pepsi-queue(1).
pepsi.workqueue (with its bodies in pepsi.workqueue_body) is the only
queue of messages in flight; the schema has some eighty-five tables in all. The
table that every deployment uses besides the queue is pepsi.dns_address: a
cache of resolved A/AAAA addresses for recipient mail-exchanger hosts, with
per-address connect health, maintained by pepsi-stage-relay-to-internet(1). Each row records a host, one resolved address, the DNS-TTL
expires_at, a failed flag and the last_success_at time, so a working
address is preferred until its TTL elapses and a host is re-resolved once all
its cached addresses have failed or expired. It carries no message data;
pepsi-queue(1) gc deletes its expired rows. Beside it,
pepsi.mta_sts_policy holds the MTA-STS policies that the same stage has
fetched, per recipient domain, until their max_age passes, so a policy stays
enforced across worker restarts; pepsi-queue(1) gc refreshes them
before that, so a policy does not lapse for want of mail.
The rest are the feature tables, each described with the component that owns it:
the pipeline counters stage_stats and dispatch_stats
(pepsi-dispatch(1), exported by pepsi-httpd(1) at /metrics),
whitelist (pepsi-whitelist(1)), tls_session (pepsi-tlsrpt(1)), settings (pepsi-settings(1)), vacation_reply
(pepsi-stage-vacation(1)), payment_request_reply
(pepsi-stage-anti-spam(1)), secretary_challenge, secretary_sent and
secretary_answered (pepsi-stage-secretary(1)), mailbox_quota (pepsi-quota(1)),
config_override (the database configuration layer, pepsi-config(1)),
origin_nonce and auto_pay_spend (pepsi-stage-auto-pay(1)),
telemetry (pepsi-telemetry(1)), secure_message and
secure_access (pepsi-secure-link(1)), the key store
crypto_identity / peer_key / peer_has_own_key / ca_trust /
key_request / otp_key / otp_pending / smime_capability /
compromised_key / compromised_key_import / crl_cache /
ca_issuer_cache (pepsi-keys(1) and pepsi-keydisc(1)),
signed_sender (pepsi-stage-decrypt(1)), dmarc_report and
dmarc_report_record (pepsi-stage-dmarc-report(1)), ip_blocklist,
ip_blocklist_source and reputation_check (pepsi-reputation(1)),
the mailing-list tables mailing_list and list_* (pepsi-list(1))
except list_confirmation, the table of subscription confirmation requests
that outside lists send to local users (pepsi-stage-check-whitelist(1)
records them and pepsi-stage-auto-whitelist(1) matches them), the list
archive archive_* (pepsi-archive(1)), the RFC 7293 login record
login_assignment (pepsi-setup(1), The login assignment record), the
logs event_log and mail_log, the telemetry daemon’s liveness row
telemetry_client (pepsi-telemetry-client(1)), the schema record
schema_file, and the administrative surface admin_account /
admin_session / api_token / setup_task / setup_task_log /
own_enrolment / own_session / webauthn_credential /
webauthn_challenge (pepsi-httpd(1) and pepsi-setup(1)). All of
them are created by pepsi-setup(1). Apart from secure_message
(ciphertext awaiting its recipient), the list archive, whose purpose is to keep
posts, and the messages a list holds for moderation, none holds message content.
La colonne state est l’objet JSON transporté avec le message depuis l’ingress jusqu’à son étape terminale ; c’est le canal par lequel les étapes communiquent. L’ingress la sème avec la provenance d’origine SMTP de la connexion, les verdicts SPF/DKIM/DMARC entrants et tout paramètre DSN RFC 3461 ; les étapes ultérieures y fusionnent leurs propres verdicts et données de travail. Sa disposition complète, avec chaque clé et qui l’écrit et la consomme, est documentée dans pepsi.state(7).
95.2.1.1.41. Exemple¶
Un redirecteur complet : recevoir sur les trois ports SMTP canoniques, sceller en ARC à l’arrivée, réécrire en SRS, remettre en direct vers le MX, et faire rebondir les échecs (en signant le rebond avant la remise)
[pepsi]
DKIM_SELECTOR = pepsi
ARC_DOMAIN = example.org
ARC_ALGORITHM = rsa
[pepsi-postgres]
CONFIG = postgres:///pepsi
# SQL_DIR defaults to ${DATADIR}/sql; set it when running from a checkout.
[pepsi-ingress]
HOSTNAME = mail.example.org
ACCEPTED_DOMAINS = example.org example.com
MAX_MESSAGE_SIZE = 26214400
# The three canonical SMTP listeners. TLS_CERT/TLS_KEY are omitted so
# pepsi-setup auto-fills the certbot path and obtains the certificate.
# Port 25: cleartext with opportunistic STARTTLS.
[pepsi-ingress-listener-mx]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 25
MODE = starttls
MYNETWORKS = 127.0.0.0/8 ::1/128 10.0.0.0/8
# Port 465: implicit TLS (SMTPS), authenticated submission via Dovecot SASL.
[pepsi-ingress-listener-submissions]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 465
MODE = tls
SUBMISSION = yes
SASL_TYPE = dovecot
SASL_PATH = /run/dovecot/auth-client-pepsi
# Port 587: cleartext submission upgraded with STARTTLS.
[pepsi-ingress-listener-submission]
SERVE = tcp
BIND_TO = 0.0.0.0
PORT = 587
MODE = starttls
SUBMISSION = yes
SASL_TYPE = dovecot
SASL_PATH = /run/dovecot/auth-client-pepsi
[pepsi-srs]
SRS_DOMAIN = srs.example.net
SECRET_FILE = /etc/pepsi/srs.secret
# init: ARC-seal the message as received, then hand to SRS.
[stage-init]
PROGRAM = pepsi-stage-arc
NEXT_STAGE = srs
[stage-srs]
PROGRAM = pepsi-stage-srs
NEXT_STAGE = deliver
# deliver: direct-to-MX; failures go to the bounce stage.
[stage-deliver]
PROGRAM = pepsi-stage-relay-to-internet
SERVER_NAME = mail.example.org
POSTMASTER = postmaster@example.org
BOUNCE_STAGE = bounce
# This host's public sending IP(s); pepsi-setup unions PUBLIC_IP from every
# relay stage into the SPF record.
PUBLIC_IP = 203.0.113.7 2001:db8::25
# bounce: build an unsigned DSN, sign it, then deliver it.
[stage-bounce]
PROGRAM = pepsi-stage-bounce
SERVER_NAME = mail.example.org
POSTMASTER = postmaster@example.org
NEXT_STAGE = bounce-sign
BOUNCE_MESSAGE = default
[stage-bounce-sign]
PROGRAM = pepsi-stage-dkim-sign
NEXT_STAGE = deliver
Pour relayer via un smarthost à la place, remplacez le PROGRAM de l’étape deliver par pepsi-stage-relay-to-smarthost et ajoutez des sections [pepsi-stage-relay-to-smarthost-mta-*], par exemple
[pepsi-stage-relay-to-smarthost-mta-smarthost]
HOST = smtp.relay.example.net
PORT = 587
CATCH_ALL = yes
95.2.1.1.42. Fichiers¶
Chaque composant Pepsi lit le même fichier. Lorsqu’un composant est démarré sans –config, le premier chemin existant de la liste suivante est utilisé :
$XDG_CONFIG_HOME/pepsi.conf$HOME/.config/pepsi.conf/etc/pepsi/pepsi.conf/etc/pepsi.conf
pepsi-setup --wizard écrit /etc/pepsi/pepsi.conf ; make install place à côté un pepsi.conf.sample de référence, qui documente chaque option mais n’est pas lui-même une configuration fonctionnelle.
Avant que ce fichier ne soit lu, chaque *.conf de ${DATADIR}/config.d est analysé, de sorte que les valeurs par défaut empaquetées soient en place et que pepsi.conf les redéfinisse option par option (une section définie dans les deux est fusionnée, non remplacée). Deux sont livrés :
vacation.conf— les avis d’absence par langue ; voir La section [pepsi-vacation-default-message] ci-dessus.reputation.conf— les listes de blocage d’IP ; voir Les sections [pepsi-reputation-list-*] ci-dessus.
make install supprime tout thunderbird.conf de ce répertoire, parce que chaque fichier qui s’y trouve est lu et que celui-ci définirait un CRYPTO_ALLOW_DOWNGRADE = yes global. L’enregistrement de capacités S/MIME par pair décrit sous CRYPTO_ALLOW_DOWNGRADE prend cette décision pour chaque correspondant à la place.
Ces fichiers appartiennent au paquet : redéfinissez dans pepsi.conf les options que vous voulez plutôt que de les éditer, sinon une mise à niveau écartera la modification.
95.2.1.1.43. Voir aussi¶
pepsi-ingress(1), pepsi-dispatch(1), pepsi-httpd(1), pepsi-setup(1), pepsi-config(1), pepsi-queue(1), pepsi-status(1), pepsi-sendmail(1), pepsi-whitelist(1), pepsi-settings(1), pepsi-tlsrpt(1), pepsi-quota(1), pepsi-failure-bouncer(1), pepsi-list(1), pepsi-keys(1), pepsi-keydisc(1), pepsi-secure-link(1), pepsi-detect-language(1), pepsi-telemetry(1), pepsi-telemetry-client(1), pepsi-helper-token-refresh(1), pepsi-helper-auto-pay(1), pepsi-helper-mailbox-scan(1), pepsi-stage-arc(1), pepsi-stage-srs(1), pepsi-stage-encrypt(1), pepsi-stage-decrypt(1), pepsi-stage-autocrypt-learn(1), pepsi-stage-secure-link(1), pepsi-stage-vks-confirm(1), pepsi-stage-dmarc-report(1), pepsi-stage-route(1), pepsi-stage-dkim-sign(1), pepsi-stage-relay-to-internet(1), pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-lmtp(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-dot-forward(1), pepsi-stage-bounce(1), pepsi-stage-discard(1), pepsi-stage-anti-spam(1), pepsi-stage-auto-pay(1), pepsi-stage-check-whitelist(1), pepsi-stage-auto-whitelist(1), pepsi-stage-detect-language(1), pepsi-stage-block-language(1), pepsi-stage-if(1), pepsi-stage-milter(1), pepsi-stage-aliases(1), pepsi-stage-vacation(1), pepsi-stage-edit-settings(1), pepsi-archive(1), pepsi-stage-list(1), pepsi-stage-list-post(1), pepsi-stage-list-deliver(1), pepsi-stage-list-command(1), pepsi-stage-list-bounce(1), pepsi.state(7), systemd.socket(5)
95.2.1.1.44. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.