4. Installation

Pepsi peut être installé de deux façons. Construire depuis les sources à partir de l’espace de travail Cargo vous donne les binaires et vous laisse créer les comptes de service, régler les bits privilégiés et disposer les répertoires d’exécution. Le paquet Debian préconstruit fait tout cela pour vous : son postinst crée les comptes, les groupes, les répertoires, les redéfinitions de binaires privilégiés et la base de données. Il ne reste alors que l’amorçage spécifique au site (éditer la configuration et exécuter pepsi-setup).

Choisissez l’onglet de la méthode que vous utilisez. Tout ce qui suit est identique pour les deux : provisionner le schéma, les clés et le DNS, exécuter les services, le modèle de privilèges et le cycle de vie du schéma.

4.1. Prérequis

  • PostgreSQL — une base de données, dans laquelle Pepsi installe l’unique schéma pepsi. Tous les composants se connectent à la même base de données. (Le paquet Debian Depends de postgresql et le tire pour vous.)

  • Le ``postgresql-contrib`` de PostgreSQL – optionnel, et seulement pour les listes de diffusion. Il porte l’extension pg_trgm, que les archives de listes emploient pour la recherche de sous-chaîne et approchée : trouver un nom d’hôte, une clé de configuration, une ligne de trace d’exécution, ou un nom que le chercheur a mal orthographié. Un dictionnaire de racinisation jette exactement cette matière : la recherche plein texte ne peut donc pas répondre du tout à ces requêtes.

    Un site sans elle s’installe et fonctionne normalement. L’extension est créée dans un bloc protégé : son absence est un avertissement et non un échec d’installation ; les archives n’ont alors que la recherche plein texte, et pepsi-list check indique dans quel mode le site se trouve. L’installer plus tard et relancer pepsi-setup run l’active, après quoi les archives existantes ont besoin d’un pepsi-archive reindex pour peupler la colonne que l’index lit.

    Le paquet Debian la place en Recommends : un apt install par défaut l’installe, et un site qui n’héberge aucune liste peut la retirer.

  • Pour un flux de courrier réel : un DNS public que vous contrôlez pour chaque domaine servi (pour publier les enregistrements DKIM, SPF et MTA-STS), et la capacité de lier le port SMTP privilégié 25 (et 465/587 pour la soumission). Un build de développement peut tourner entièrement sur des ports non privilégiés et une base de données jetable.

  • Un résolveur validant DNSSEC, idéalement le vôtre sur cet hôte. La configuration du DNS sort du cadre de Pepsi : Pepsi ne valide pas DNSSEC lui-même mais se fie au bit AD du résolveur qu’on lui donne (/etc/resolv.conf, [pepsi] DNS_SERVERS, ou le DNS_SERVERS d’une étape), et DANE ainsi que la découverte de clés conditionnée par DNSSEC reposent sur ce bit. Faites tourner votre propre résolveur récursif validant sur l’hôte, par exemple unbound (apt install unbound, puis nameserver 127.0.0.1 dans resolv.conf), ou systemd-resolved avec DNSSEC=yes. Là où ce n’est pas possible, nommez un résolveur validant de confiance dans [pepsi] DNS_SERVERS en DNS sur TLS (tls://192.0.2.53#dns.example.net) ou en DNS sur HTTPS (https://192.0.2.53/dns-query#dns.example.net) : le canal est alors authentifié par le certificat du résolveur, si bien que personne sur le chemin ne peut falsifier le bit AD, et chaque programme Pepsi l’utilise (voir pepsi.conf(5)). Un résolveur joint en DNS en clair à travers un réseau est une confiance que vous accordez à son opérateur et au chemin qui y mène ; pepsi-setup nomme chacun de ces résolveurs par son adresse IP lorsqu’il s’exécute, et ne refuse rien. Dans tous les cas, c’est l’opérateur du résolveur qui décide de ce qui compte comme validé. pepsi-status indique, dans sa section « DNSSEC resolver », si le résolveur utilisé valide ; les workers DANE journalisent un avertissement au démarrage lorsque ce n’est pas le cas.

4.2. Installer Pepsi

Construisez l’espace de travail, placez les binaires et le SQL avec make install, et créez vous-même les comptes système et les privilèges (les mêmes que ceux que le paquet créerait ; voir Utilisateurs, groupes et privilèges ci-dessous).

Prérequis supplémentaires

  • Une chaîne d’outils Rust avec rustc 1.95 ou ultérieur (le plancher est fixé par le taler-common vendorisé ; ./configure avertit en cas de version plus ancienne), plus les dépendances de construction natives des crates de cryptographie et Kerberos : pkg-config, cmake, libclang, nettle, GMP et les en-têtes de développement Kerberos (sur Debian : libclang-dev, nettle-dev, libgmp-dev, libkrb5-dev).

  • Le sous-module GNU Taler Rust intégré (vendored), récupéré avant le premier build

    git submodule update --init --recursive
    

Construction

Pepsi est un espace de travail Cargo dont le paquet racine (pepsi) possède chaque binaire sous src/bin/ ; les crates membres pepsi-* sont des bibliothèques que les binaires fins appellent. Un build de développement produit un exécutable par programme

cargo build --workspace

Un build de release lie à la place la plupart des programmes en un unique binaire multi-appel, pepsi, qui sélectionne le programme à exécuter d’après le nom sous lequel il est invoqué (argv[0]). Ceci est sélectionné par la fonctionnalité Cargo unibin (que la cible make build active pour vous) ; la fonctionnalité multibin par défaut conserve les binaires par programme utilisés pour le développement et la suite de tests

make build   # == cargo build --release --locked \
             #      --no-default-features --features unibin,crypto-nettle

Dans les deux cas, ce sont les noms par programme que vous exécutez ; la disposition de release les installe comme des liens symboliques vers l’unique binaire (voir Installation). Certains programmes ne sont pas pliés dedans et restent autonomes ; la liste faisant foi est STANDALONE_BINARIES dans le Makefile. Deux raisons y placent un programme :

  • il porte son propre bit setuid ou setgid, ce qu’un binaire partagé ne peut pas faire par programme, ou un site peut lui en donner un (pepsi-keys). C’est le cas des helpers de remise locale, de ~/.forward et de wallet et des étapes qui les appellent, du relais smarthost, de pepsi-quota, de pepsi-whitelist, et de pepsi-stage-encrypt et pepsi-stage-decrypt (tous deux setuid pepsi-crypto, afin de pouvoir atteindre le matériel de clé privée) ;

  • il est déployé ou invoqué séparément : pepsi-setup, pepsi-config, pepsi-stage-detect-language (ses modèles de langue sont volumineux ; ce binaire est lui-même multi-appel, et un second lien symbolique de $PATH, pepsi-detect-language, en exécute l’outil de diagnostic hors ligne), pepsi-telemetry (livré dans son propre paquet et tournant sur un hôte distinct) et pepsi-helper-mailbox-scan (que pepsi-whitelist exécute par son nom).

Les programmes auxquels ce chapitre fait référence sont listés ci-dessous. C’est une sélection, non un inventaire : les listes faisant foi sont FOLDED_BINARIES et STANDALONE_BINARIES dans le Makefile (BINARIES est dérivé de ces deux-là et n’est pas lui-même éditable).

  • pepsi-ingress — serveur SMTP entrant

  • pepsi-dispatch — dispatcher d’étapes

  • pepsi-stage-arc, pepsi-stage-srs, pepsi-stage-encrypt, pepsi-stage-decrypt, pepsi-stage-dkim-sign, pepsi-stage-bounce, pepsi-stage-relay-to-internet, pepsi-stage-relay-to-smarthost, pepsi-stage-discard — les étapes

  • pepsi-setup — provisionnement/amorçage

  • pepsi-queue — inspection/réparation de la file

  • pepsi-status — résumé de santé du pipeline

  • pepsi-reputation — listes de blocage IP pour le courrier entrant

  • pepsi-sendmail — soumission locale (installé comme /usr/sbin/sendmail par le paquet Debian)

Les barrières de qualité que le projet garde vertes sont

RUSTFLAGS="-D warnings" cargo build --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo fmt --all -- --check
cargo test --workspace
cargo deny check
cargo vet --locked
make docs

cargo test --workspace nécessite un PostgreSQL joignable, car la crate de cycle de vie du répartiteur lance le vrai répartiteur contre une base de données. make check est le point d’entrée qui la conditionne : il saute cette suite, au lieu d’échouer, lorsqu’aucune base de données n’est utilisable. Il exécute aussi cargo deny check et cargo vet --locked (le registre d’audit des dépendances, supply-chain/ ; voir La chaîne d’approvisionnement) ; voir Autres cibles make ci-dessous.

Installation

Un simple build ne produit que des binaires ; Pepsi livre aussi des migrations SQL et un exemple de configuration qui doivent être placés sur disque. Le Makefile enveloppe les deux. Exécutez-le en tant que root, afin qu’il puisse aussi appliquer les bits de binaire privilégié ; sinon, il imprime les chown/chmod exacts à exécuter à la main

make install PREFIX=/usr/local SYSCONFDIR=/etc DESTDIR=

Mieux encore, lancez d’abord ./configure et laissez-le résoudre les variables de répertoire dans config.mk (que le Makefile lit avant ses propres valeurs par défaut, de sorte que ce que configure a décidé l’emporte). Chaque répertoire dérive de --prefix ; nommer un préfixe et rien d’autre relocalise donc toute l’installation en dessous : binaires, SQL, valeurs par défaut de config.d et modèles de messages

./configure --prefix=/opt/pepsi     # templates at /opt/pepsi/share/pepsi/templates
make && make install

--sysconfdir est la seule exception, car un fichier de configuration doit se trouver là où le système le cherche : c’est /etc lorsqu’aucun --prefix n’a été donné (et lorsque --prefix=/usr l’a été, puisque /usr/etc n’existe sur aucun système), et $(PREFIX)/etc sinon. Passez --sysconfdir explicitement pour redéfinir dans un sens comme dans l’autre.

./configure --help énumère tout ce qu’il accepte. Outre les variables de répertoire GNU (--prefix, --exec-prefix, --bindir, --sbindir, --libexecdir, --sysconfdir, --datarootdir, --datadir, --mandir, --infodir, --docdir), il prend :

--with-templatedir=DIR

L’endroit où vont les modèles de message ; doit correspondre à [pepsi] TEMPLATE_DIR. Par défaut $(DATADIR)/templates.

--with-systemdunitdir=DIR / --with-tmpfilesdir=DIR / --with-udevrulesdir=DIR / --with-sendmail-libdir=DIR

Les fichiers d’unité, le fragment tmpfiles.d, la règle udev qui enregistre un changement de l’identifiant de génération d’une machine virtuelle (voir Machines virtuelles clonées et restaurées), et l’endroit où va le lien historique /usr/lib/sendmail.

--with-maildir-group=NAME, --with-forward-group=NAME, --with-wallet-group=NAME, --with-token-group=NAME, --with-dispatch-group=NAME, --with-crypto-user=NAME, --with-whitelist-user=NAME

Les noms, propres au site, des comptes et groupes qui conditionnent l’accès aux binaires privilégiés (voir Binaires privilégiés ci-dessous). Ils valent par défaut pepsi-maildir, pepsi-forward, pepsi-wallets, pepsi-token, pepsi, pepsi-crypto et pepsi-whitelist.

--enable-docs / --disable-docs

Détermine si les pages de manuel et le manuel info sont rendus depuis les sources ou repris pré-construits (ce que livre une archive de version). La valeur par défaut est auto : activé lorsque sphinx-build, makeinfo et Python avec docutils sont tous présents.

--enable-mta-links / --disable-mta-links

Détermine si make install revendique /usr/sbin/sendmail et le reste de l’interface Debian mail-transport-agent. Désactivé par défaut, afin qu’une installation depuis les sources ne puisse pas évincer silencieusement le MTA existant du système ; le paquet Debian passe INSTALL_MTA_LINKS=yes parce que son Conflicts: mail-transport-agent garantit déjà l’exclusivité.

--with-taler-wallet-cli=PATH

Le seul programme de portefeuille que le pepsi-helper-auto-pay setuid exécutera, fixé à la compilation (par défaut /usr/bin/taler-wallet-cli, là où les paquets GNU Taler l’installent). Il n’est jamais pris dans la ligne de commande, l’environnement ou la configuration, car l’appelant du helper est moins privilégié que chacun des comptes que le helper peut endosser.

--with-crypto-backend=FEATURE

La bibliothèque cryptographique sous OpenPGP (le backend de Sequoia), choisie par une fonctionnalité Cargo. Une seule est intégrée ; FEATURE vaut l’une des valeurs suivantes :

crypto-nettle (par défaut)

Nettle, avec sa moitié à clé publique hogweed et GMP, liées dynamiquement depuis le système (Debian : nettle-dev, libgmp-dev). Nettle ne propose aucun algorithme post-quantique. Seul Nettle 3 convient : les bindings ne se compilent pas avec Nettle 4, qui a supprimé nettle/pgp.h ; sur un système qui fournit Nettle 4 (Homebrew, par exemple), choisissez donc crypto-openssl.

crypto-openssl

La libcrypto d’OpenSSL, liée dynamiquement depuis le système (Debian : libssl-dev). C’est le backend à choisir pour un OpenPGP post-quantique : lui seul, et seulement avec OpenSSL 3.5 ou ultérieur, sait déchiffrer les messages adressés à des clés ML-KEM-768+X25519 et traiter les signatures ML-DSA-65+Ed25519 (voir Algorithmes à clé publique traditionnels cassés par les ordinateurs quantiques).

Toute autre valeur est refusée. Le choix ne concerne qu’OpenPGP : TLS, S/MIME, DKIM et ARC utilisent AWS-LC avec l’un comme l’autre backend, et aucun programme ne lie OpenSSL pour TLS (OpenPGP). Sans configure, le même choix s’écrit make build CRYPTO_BACKEND=crypto-openssl.

--jobs=N

Le nombre de tâches de compilation que cargo exécute à la fois. Livré à lui-même, cargo lance une tâche par processeur, quelle que soit la mémoire, et une machine dotée de nombreux cœurs et de peu de RAM manque alors de mémoire vers la fin de la construction. Par défaut (auto), c’est donc contrib/build-jobs.sh qui décide, juste avant chaque commande cargo. Il autorise une tâche par processeur, mais seulement autant que la mémoire libre à ce moment-là peut en contenir, et il garde une large marge pour les autres programmes et pour la croissance future de la construction. La plus grosse tâche de la construction de version demande environ 5 Go et chacune des suivantes jusqu’à 2,7 Go ; la version se construit donc avec une tâche quand 16 Go sont libres, avec deux quand 18 Go sont libres et avec quatre quand 32 Go sont libres. La construction des tests (make check) demande un peu moins par tâche. N fixe le nombre à la place. Sans configure, CARGO_BUILD_JOBS=N dans l’environnement ou sur la ligne de commande de make a le même effet. make -jN n’augmente pas le nombre, mais le plafonne à N, et la construction Debian prend ce plafond dans DEB_BUILD_OPTIONS=parallel=N.

CARGO=, INSTALL=, SPHINXBUILD=, MAKEINFO=, INSTALL_INFO=, RST2MAN= et PYTHON= sont acceptés comme arguments VAR=VALUE ou depuis l’environnement. Les options dont cette construction n’a pas l’usage (--libdir, --localstatedir, --build, --host, …) sont acceptées et ignorées, de sorte qu’un pilote d’empaquetage générique puisse appeler le script sans modification ; seul un cargo manquant est une erreur fatale.

make install effectue les étapes suivantes :

install-bin

Construit le binaire de release (unifié) et l’installe dans $(DESTDIR)$(PREFIX)/libexec/pepsi/pepsi, puis crée un lien symbolique $(DESTDIR)$(PREFIX)/bin par nom de programme plié pointant vers lui (par exemple pepsi-ingress -> ../libexec/pepsi/pepsi). Les dix-sept programmes autonomes nommés dans le STANDALONE_BINARIES du Makefile sont installés comme leurs propres exécutables $(DESTDIR)$(PREFIX)/bin. Comme chaque lien symbolique réside toujours dans $(PREFIX)/bin (sur le $PATH), la dérivation de DATADIR à l’exécution ci-dessous n’est pas affectée.

install-data

Copie les fichiers SQL de pepsi-setup/db/ vers $(DESTDIR)$(DATADIR)/sql (où DATADIR = $(PREFIX)/share/pepsi). pepsi-setup les lit lors de l’installation du schéma ; le SQL_DIR par défaut est ${DATADIR}/sql. Installe aussi contrib/hosters.txt en tant que $(DATADIR)/hosters.txt, la liste des hébergeurs publics pour lesquels pepsi-whitelist import --auto-wildcard ne propose jamais de joker. (La liste des clés connues comme compromises, contre laquelle chaque clé de pair est vérifiée, n’est pas installée : chaque déploiement la récupère dans sa base de données, voir pepsi-keys blocklist update.)

install-templates

Copie les modèles de messages (<name>.<lang>.body — la demande de paiement de l’anti-spam, les corps de rebond, les avis des listes de diffusion et les autres réponses automatiques) vers $(DESTDIR)$(TEMPLATEDIR), qui vaut par défaut $(DATADIR)/templates. La valeur par défaut [pepsi] TEMPLATE_DIR des binaires est ${DATADIR}/templates et se résout par la même dérivation à l’exécution, de sorte que les deux extrémités s’accordent sous n’importe quel préfixe sans que la configuration ne nomme de chemin.

install-config

Installe le pepsi.conf.sample de référence sous $(DESTDIR)$(SYSCONFDIR)/pepsi/. Ne crée jamais pepsi.conf : l’exemple câble des étapes facultatives qui demandent une configuration supplémentaire et n’est pas une configuration fonctionnelle ; le fichier en service provient donc de pepsi-setup --wizard (un fichier existant n’est jamais modifié).

install-config-d

Copie contrib/config.d/*.conf vers $(DESTDIR)$(DATADIR)/config.d. Ce sont des valeurs par défaut livrées, et non des conffiles, et elles sont analysées avant pepsi.conf — voir Configuration. Un seul est livré avec Pepsi : les textes d’avis d’absence par langue. Si ce répertoire contient un thunderbird.conf, la cible le supprime : chaque fichier qui s’y trouve est analysé, et ce fichier positionne CRYPTO_ALLOW_DOWNGRADE = yes pour tous les pairs, alors que l’enregistrement de capacités S/MIME décide pair par pair.

install-man / install-info

Installe les pages de manuel roff rendues sous $(DESTDIR)$(MANDIR)/manN et pepsi.info sous $(DESTDIR)$(INFODIR) (enregistré auprès d”install-info). Avec BUILD_DOCS=no — ce que règle ./configure --disable-docs, et ce qu’emploie une archive de release — des pages pré-construites sont installées au lieu d’être rendues, et chaque étape est sautée avec un message si aucune n’est présente.

install-doc

Installe README.md, NEWS, SECURITY.md, AUTHORS, COPYING et les textes de licence de LICENSES/ sous $(DESTDIR)$(DOCDIR), qui vaut par défaut $(DATAROOTDIR)/doc/pepsi.

install-systemd

Installe les unités systemd de debian/systemd/ dans $(DESTDIR)$(SYSTEMDUNITDIR) (en réécrivant /usr/bin et /etc/pepsi vers les BINDIR/SYSCONFDIR configurés) ainsi que le fragment tmpfiles.d qui donne à /run/pepsi son propriétaire et son ACL. Ce fragment est la seule source des droits de ce répertoire, puisqu’aucune unité ne peut le déclarer comme RuntimeDirectory (voir Aucune unité ne peut le revendiquer comme RuntimeDirectory). Tout est livré désactivé. make install INSTALL_ADMIN_UNITS=no omet les deux unités pepsi-setup-apply, ce qui est l’équivalent, pour une installation depuis les sources, de ne pas installer le paquet pepsi-httpd-admin.

En outre, install dépend des cibles de bits privilégiés (install-helper, install-maildir-stage, install-forward-*, install-auto-pay-*, install-smarthost-stage, install-whitelist-suid, install-crypto-suid, install-quota-tool) décrites sous Binaires privilégiés ci-dessous ; chacune imprime les chown/ chmod à exécuter à la main lorsqu’elle n’est pas exécutée en tant que root, ou lorsque le groupe dont elle a besoin n’existe pas.

Redéfinissez PREFIX, SYSCONFDIR et DESTDIR pour convenir au système cible. make uninstall supprime tout ce que make install a placé (toujours y compris les deux unités pepsi-setup-apply, quoi que dise INSTALL_ADMIN_UNITS) mais laisse en place le pepsi.conf en service.

Autres cibles make

make check

Le point d’entrée des tests qui ne nécessite aucun compte distant. Il exécute les vérifications croisées par inspection de fichiers des unités systemd, du chemin de la socket de télémétrie, des numéros de version et des deux extensions pour clients de messagerie, ainsi que les tests de l’espace de travail (moins la crate de cycle de vie du dispatcher, qui a besoin de PostgreSQL). Il exécute ensuite, au mieux, la suite de cycle de vie contre une base de données pepsicheck locale, les tests de contrat des helpers setuid, le script d’interopérabilité de l’authentification, cargo deny check, cargo vet --locked et la vérification des renvois croisés du manuel. Chacun de ces éléments est sauté plutôt qu’échoué lorsque son prérequis est absent.

make integrationtests / make benchmarks

Les scripts de pipeline en conditions réelles sous tests/, qui nécessitent un SSH sans mot de passe vers les hôtes nommés dans ACCOUNTS (par défaut tests/test-accounts.ini, créé à partir de tests/test-accounts.ini.sample) ; integrationtests exécute d’abord la barrière d’interopérabilité Thunderbird. Les benchmarks forment une cible distincte parce qu’ils chargent délibérément le MTA.

make docs

Le manuel pour la langue source. C’est un alias pour make docs-en, qui construit son HTML et son PDF, ainsi que les pages de manuel et le manuel info (tous deux dans la seule langue source). make docs-<lang> construit une autre langue et make docs-all construit toutes les langues de DOC_LANGUAGES (en de fr) ; make html construit le seul HTML de chaque langue.

make dist / make distcheck

Construire l’archive de version pepsi-$(VERSION).tar.gz (tous les fichiers suivis, y compris le sous-module vendorisé, plus configure et la documentation pré-construite), et la vérifier en la dépaquetant dans une arborescence propre et en y exécutant configure, make, make check, make install et make uninstall contre un préfixe jetable. L’archive est copiée depuis l’arbre de travail : make dist refuse donc de s’exécuter tant qu’un fichier suivi diffère de HEAD ou que le sous-module n’est pas au commit enregistré dans HEAD (les fichiers non suivis ne comptent pas) ; make dist DIST_ALLOW_DIRTY=yes construit malgré tout une archive de développement. L’archive est reproductible : entrées triées, chaque mtime égal à la date du commit (SOURCE_DATE_EPOCH), uid numérique 0, pas d’horodatage gzip.

make dist-sign

Signer une archive de version existante : une signature OpenPGP détachée en armure ASCII pepsi-$(VERSION).tar.gz.asc, avec la clé par défaut de gpg ou DIST_SIGN_KEYID, vérifiée avant que la cible ne réussisse. Voir Vérifier un téléchargement pour le côté utilisateur et Publier une version pour les clés.

make deb

Construire les paquets Debian dans target/debian/ (Paquets Debian), non signés ; make deb DEB_SIGN_KEYID=<fingerprint> signe les fichiers .changes et .buildinfo avec cette clé.

make clean / make distclean

clean exécute cargo clean et supprime la documentation rendue ; distclean supprime en outre config.mk, config.status et tout ce qu’a produit make dist.

Note

DATADIR doit correspondre à ce que les binaires calculent à l’exécution : taler-common dérive ${DATADIR} comme <install-prefix>/share/pepsi à partir de l’emplacement propre du binaire. Lors d’une exécution depuis un checkout des sources (non installé), réglez [pepsi-postgres] SQL_DIR explicitement afin que pepsi-setup trouve les migrations.

Préparer le système

Le postinst du paquet Debian effectue les étapes ci-dessous automatiquement ; sur une installation depuis les sources, vous les faites vous-même, en utilisant la même disposition de compte, groupe, mode et répertoire documentée sous Utilisateurs, groupes et privilèges et Répertoires et secrets ci-dessous. Créez les comptes et groupes avant make install (pour qu’il puisse appliquer les bits privilégiés), et les rôles de base de données avant pepsi-setup (qui installe le schéma) :

  1. Créez les comptes système, chacun --system avec /usr/sbin/nologin, home /var/pepsi et un groupe privé du même nom, plus les groupes de contrôle d’accès. debian/pepsi.postinst est la liste faisant foi ; cette boucle en est la transposition

    for u in pepsi pepsi-ingress pepsi-httpd pepsi-owner \
             pepsi-helper-token-refresh pepsi-whitelist pepsi-crypto \
             pepsi-keydisc pepsi-config pepsi-greylist; do
        addgroup --system "$u"
        adduser --system --home /var/pepsi --no-create-home \
                --ingroup "$u" --shell /usr/sbin/nologin \
                --disabled-password "$u"
    done
    for g in pepsi-maildir pepsi-forward pepsi-token pepsi-admin \
             pepsi-telemetry; do
        addgroup --system "$g"
    done
    # The shared-wallet account owns its wallet databases, so unlike the
    # service accounts it gets a real home.
    addgroup --system pepsi-wallets
    adduser --system --home /var/lib/pepsi-wallets --ingroup pepsi-wallets \
            --shell /usr/sbin/nologin --disabled-password pepsi-wallets
    install -d -o pepsi-wallets -g pepsi-wallets -m 0700 /var/lib/pepsi-wallets
    # Memberships: telemetry producers, and the SRS secret fragment.
    for u in pepsi pepsi-ingress pepsi-httpd pepsi-keydisc pepsi-greylist; do
        adduser "$u" pepsi-telemetry
    done
    adduser pepsi pepsi-ingress
    # The greylisting milter's socket belongs to group pepsi-greylist.
    adduser pepsi-ingress pepsi-greylist
    # The DKIM signing daemon: its own home holds the signing keys, and
    # membership of pepsi lets it hand its socket to the stage workers.
    addgroup --system pepsi-dkim
    adduser --system --home /var/lib/pepsi-dkim --no-create-home \
            --ingroup pepsi-dkim --shell /usr/sbin/nologin \
            --disabled-password pepsi-dkim
    adduser pepsi-dkim pepsi
    install -d -o pepsi-dkim -g pepsi-dkim -m 0700 /var/lib/pepsi-dkim
    install -d -o pepsi-dkim -g pepsi-dkim -m 0755 /var/lib/pepsi-dkim-public
    

    Chacun des cinq derniers comptes existe parce que quelque chose refuse de fonctionner sans lui : pepsi-whitelist est le compte vers lequel la CLI de liste blanche est setuid, pepsi-crypto est le seul rôle de base de données à qui crypto_identity.private_wrapped est accordé et le propriétaire du fragment de chiffrement de clés, pepsi-keydisc est le rôle le plus étroit du déploiement (il analyse du matériel de clé récupéré sur l’internet ouvert), pepsi-config est le seul rôle autorisé à écrire la surcouche de configuration, et pepsi-greylist exécute le milter de greylisting, dont la socket appartient à son groupe. Si vous omettez pepsi-crypto, install-crypto-suid se contente d’avertir, et les deux étapes cryptographiques restent non privilégiées et incapables d’ouvrir la moindre clé privée.

  2. Créez les dix rôles de connexion PostgreSQL et la base de données (authentification par pair, en tant que superutilisateur postgres). C’est le même ensemble que crée debian/pepsi.postinst : chaque compte qui s’authentifie en tant que lui-même via la socket d’authentification par pair. pepsi-telemetry en fait partie même sur un nœud qui ne sert aucune télémétrie, car pepsi-setup run lui accorde des droits sur chaque hôte, et pepsi-setup effectue son travail en base de données en tant que pepsi-owner, qui ne peut pas créer un rôle manquant

    for r in pepsi-owner pepsi pepsi-ingress pepsi-httpd \
             pepsi-whitelist pepsi-config pepsi-crypto pepsi-keydisc \
             pepsi-telemetry pepsi-greylist; do
        createuser "$r"          # createuser takes one role name at a time
    done
    createdb -O pepsi-owner pepsi
    
  3. Exécutez make install en tant que root (ci-dessus) afin que les bits setuid/setgid soient appliqués ; sinon appliquez-les à la main selon Binaires privilégiés ci-dessous. Chaque cible install-* se contente d’avertir lorsque le groupe dont elle a besoin manque. Un compte ou un groupe sauté ci-dessus laisse donc silencieusement le programme correspondant non privilégié.

  4. Créez les répertoires d’exécution avec la propriété et les modes listés sous Répertoires et secrets. Ne créez les répertoires de secrets de smarthost que si vous configurez un smarthost qui les utilise.

Le paquet est le chemin le plus simple : il livre les binaires (installés dans /usr/bin), le schéma SQL, les modèles de messages, les pages de manuel, le manuel GNU info et des unités systemd activées par socket, et son postinst provisionne tout le système pour vous.

Construire le paquet

Depuis une copie de travail (avec le sous-module vendor/taler-rust initialisé) et avec les dépendances de construction listées dans debian/control installées, exécutez

make deb

Cela copie l’arbre de travail (y compris les modifications non validées et les nouveaux fichiers que git n’ignore pas) dans target/debian/pepsi-<version>/ et y exécute dpkg-buildpackage -b -us -uc (à remplacer avec DEB_BUILD_FLAGS, par exemple DEB_BUILD_FLAGS= pour construire et signer aussi le paquet source). Cela compile la version de publication et écrit les fichiers .deb dans target/debian/ (DEB_BUILDDIR choisit un autre répertoire) : pepsi, pepsi-httpd-admin, pepsi-telemetry et pepsi-stage-detect-language. dpkg-buildpackage écrit toujours ses résultats à côté du répertoire source, ce qui explique que la construction ne s’exécute pas dans la copie de travail elle-même.

Installer le paquet

Installez le .deb avec apt afin que ses dépendances (y compris postgresql) soient tirées

apt install ./pepsi_*.deb

Lors de la configure, le postinst automatiquement :

  • crée les onze comptes de service et les six groupes de contrôle d’accès (pepsi-maildir, pepsi-forward, pepsi-token, pepsi-admin, pepsi-telemetry et pepsi-wallets), avec les appartenances entre eux ; ce sont les mêmes identités que l’installation depuis les sources crée à la main ;

  • crée les répertoires d’exécution /var/pepsi (keys, tokens, token-refresh, tls, krb5) ainsi que /etc/pepsi/secrets et /etc/pepsi/secrets.d avec la propriété et les modes documentés sous Répertoires et secrets ci-dessous ;

  • applique les bits de binaire privilégié via dpkg-statoverride : aux trois helpers setuid-root, aux programmes setgid qui peuvent les exécuter (les deux étapes de remise, l’étape de portefeuille et pepsi-quota), au relais smarthost setgid, au pepsi-whitelist setuid et aux deux étapes setuid pepsi-crypto (voir Binaires privilégiés ci-dessous) ; et

  • crée au mieux les dix rôles de connexion PostgreSQL (pepsi-owner, pepsi, pepsi-ingress, pepsi-httpd, pepsi-whitelist, pepsi-config, pepsi-crypto, pepsi-keydisc, pepsi-telemetry, pepsi-greylist) et la base de données pepsi (possédée par pepsi-owner) lorsqu’un cluster local est joignable, et imprime sinon les rôles à créer à la main.

Le service est livré désactivé : le paquet installe mais ne démarre pas Pepsi, vous laissant l’amorçage spécifique au site.

Note

pepsi est l’un des quatre paquets binaires construits depuis cette source : l’étape de détection de langue et le collecteur de télémétrie sont séparés pour des raisons de taille et de déploiement. pepsi-httpd-admin, que pepsi Recommends et qu”apt installe donc par défaut, porte l’unique mécanisme par lequel la console de navigateur peut provoquer un changement privilégié sur cet hôte. Retirer ce seul paquet est une mesure de durcissement prise en charge pour un déploiement administré depuis un terminal. Paquets Debian décrit chaque paquet et ce levier en détail.

Après l’installation du paquet

Lors de la première installation, le paquet copie une configuration provisoire dans /etc/pepsi/pepsi.conf ; les mises à niveau ultérieures ne touchent jamais ce fichier (ce n’est pas un conffile dpkg, de sorte qu’une mise à niveau ne s’interrompt jamais pour poser une question à son sujet). Éditez-le, puis exécutez l’amorçage exactement comme dans les étapes communes ci-dessous — par exemple

# 1. edit /etc/pepsi/pepsi.conf (HOSTNAME, ACCEPTED_DOMAINS, domains, TLS)
# 2. install the schema, have pepsi-dkim make the DKIM keys and
#    print the DNS records:
pepsi-setup --no-certbot run        # or:  pepsi-setup --wizard
# 3. publish the printed DNS records, then start the pipeline:
systemctl enable --now pepsi.target

Comme les unités sont activées par socket, pepsi.target démarre pepsi-ingress, pepsi-httpd, pepsi-dkim et pepsi-dispatch ensemble ; vous n’invoquez pas les sous-commandes serve à la main.

macOS n’est pas encore une cible de déploiement prise en charge : le paquet n’a encore été installé en root sur aucun système de test, et docs/ROADMAP.md liste ce qui diffère encore de Linux. Le paquet installe les programmes sous /usr/local (le /usr du volume système est en lecture seule) et la configuration dans /etc/pepsi, comme sous Linux. Au lieu d’unités systemd, il installe des tâches launchd dans /Library/LaunchDaemons (net.taler.pepsi.*), une tâche par unité, et ses scripts font ce que fait le postinst Debian.

Construire le paquet

Sur un Mac disposant des outils en ligne de commande Xcode, d’une chaîne d’outils Rust et des bibliothèques natives listées sous Depuis les sources (Nettle 3, pas 4, ou CRYPTO_BACKEND=crypto-openssl), exécutez

make macos-pkg

Cela compile la version de publication, la prépare avec l’arborescence macOS et écrit target/macos/pepsi-<version>-<arch>.pkg avec pkgbuild et productbuild d’Apple. Pour signer le paquet, indiquez dans MACOS_PKG_SIGN_IDENTITY un certificat « Developer ID Installer » de votre trousseau ; un paquet non signé s’installe avec

sudo installer -pkg pepsi-<version>-<arch>.pkg -target /

Ce que fait l’installation

  • Elle crée les mêmes comptes de service, groupes et appartenances que le paquet Debian, sous forme de comptes système masqués avec des identifiants à partir de 400.

  • Elle crée les répertoires sous /var/pepsi, /var/lib et /etc/pepsi avec les mêmes propriétaires et modes.

  • Elle positionne les mêmes bits setuid et setgid sur les programmes privilégiés.

  • Elle ajoute /run à /etc/synthetic.conf, ce qui fait de /run un lien vers /private/var/run. Si /run n’apparaît pas tout de suite, il apparaît après le prochain redémarrage.

  • Lors d’une mise à niveau, elle arrête les tâches en cours d’exécution, met à niveau le schéma de la base de données et redémarre ces mêmes tâches.

Elle ne crée ni les rôles PostgreSQL ni la base de données, car macOS n’a pas de PostgreSQL système. Créez-les comme décrit sous Depuis les sources, dans un cluster qui utilise l’authentification peer pour les connexions locales.

Après l’installation du paquet

sudo pepsi-setup --wizard
# publish the printed DNS records, then start the pipeline:
sudo /usr/local/libexec/pepsi/pepsi-launchd enable

pepsi-launchd remplace systemctl et pepsi.target. Sans nom de tâche, enable, disable, start, stop, restart et status agissent sur les tâches qu’entraîne pepsi.target ; les tâches facultatives telemetry-client et helper-token-refresh se nomment explicitement (pepsi-launchd enable telemetry-client). Chaque tâche écrit son journal dans /var/log/pepsi/<job>.log. Pour supprimer le paquet, exécutez sudo /usr/local/libexec/pepsi/pepsi-launchd uninstall. Comme apt remove, cela conserve la configuration, les comptes, la base de données et les données sous /var.

Trois choses fonctionnent autrement que sous Linux :

  • Sans activation par socket, pepsi-ingress et pepsi-httpd lient eux-mêmes leurs ports (SERVE = tcp, que l’assistant écrit sur un hôte sans systemd). Tous deux démarrent en root, lisent leurs certificats et clés TLS, puis basculent vers leurs comptes. pepsi-setup redémarre leurs tâches launchd lorsque leurs fichiers TLS changent, et le hook de déploiement certbot les redémarre après un renouvellement.

  • /etc/pepsi/postgres.env n’est lu que par les tâches qui s’exécutent en root. Donnez plutôt à chaque compte ses propres identifiants via l’espace réservé {role} dans [pepsi-postgres] CONFIG.

  • L’applicateur de configuration (pepsi-httpd-admin sous Debian) n’a pas de tâche launchd ; les pages de configuration de la console web sont donc en lecture seule ; administrez le déploiement avec pepsi-setup dans un terminal.

4.3. Vérifier un téléchargement

Les archives de version sont signées avec la clé OpenPGP du responsable de la publication : celle de Christian Grothoff ou de Florian Dold, les mêmes clés qui signent les versions de GNU Taler sur ftp.gnu.org. La signature est le fichier .asc détaché publié à côté de l’archive ; vérifiez-la avant de dépaqueter

gpg --verify pepsi-X.Y.Z.tar.gz.asc pepsi-X.Y.Z.tar.gz

gpg doit détenir la clé de signature, et la vérification vaut exactement autant que vos raisons de croire que la clé est celle du responsable de la publication. La clé de Christian Grothoff est publiée à l’adresse https://grothoff.org/christian/grothoff.asc avec l’empreinte D842 3BCB 326C 7907 0339 29C7 939E 6BE1 E29F C3CC (la même clé que nomme Signaler une vulnérabilité) ; les deux clés figurent dans le trousseau GNU, https://ftp.gnu.org/gnu/gnu-keyring.gpg, que gpg --keyring gnu-keyring.gpg --verify … utilise sans importation. Une bonne signature dit que l’archive est celle que le responsable de la publication a signée ; savoir si elle est aussi ce que produisent les sources relève de Constructions reproductibles.

Les paquets Debian de deb.taler.net sont signés avec la clé de publication de taler-systems, qui signe tous les paquets qui s’y trouvent, et apt les vérifie contre le trousseau que vous installez une fois pour toutes

wget -O /etc/apt/keyrings/taler-systems.gpg https://taler.net/taler-systems.gpg.key

désigné par signed-by= dans l’entrée des sources du dépôt. Un paquet construit depuis l’arborescence des sources avec make deb DEB_SIGN_KEYID=… porte un fichier .changes signé que vérifient dscverify et debsign --verify ; un paquet construit sans clé n’est pas signé, ce qui est le cas d’une construction locale.

4.4. Constructions reproductibles

La version de publication est reproductible : le même commit, construit avec la chaîne de compilation épinglée à partir du même Cargo.lock, donne des binaires identiques à l’octet près et la même archive, où et quand qu’il soit construit. Un binaire publié peut donc être vérifié par rapport aux sources en le reconstruisant, et c’est la seule vérification qui détecte un hôte de construction ou une machine de responsable de publication compromis. La tâche de CI 5-reproducible effectue cette vérification à chaque exécution, en construisant deux fois à partir de deux clones à des chemins différents avec des caches de crates différents (Intégration continue).

Ce que la recette épingle, et où :

  • la chaîne de compilation — rust-toolchain.toml nomme la version exacte de rustc ; rustup utilise (et installe) celle-là dans cet arbre. Une chaîne de compilation qui n’est pas gérée par rustup ignore le fichier, et un autre compilateur donne un autre binaire : utilisez donc rustup pour reproduire une version ;

  • les crates — Cargo.lock avec --locked, que passe chaque cible make ;

  • les chemins — make build fait correspondre la copie de travail, le répertoire cible (CARGO_TARGET_DIR, ou target/ dans la copie de travail) et le cache de crates (CARGO_HOME, par défaut ~/.cargo) aux noms fixes /build, /target et /cargo, chacun sous son propre chemin et son chemin canonique, pour rustc (--remap-path-prefix) et pour les compilateurs C et C++ qu’exécutent les crates natives (-ffile-prefix-map). Ainsi, ni l’emplacement de l’arbre ni celui du cache des crates n’atteignent le binaire. strip = true retire les tables de symboles. Un lien symbolique à l’intérieur du cache de crates n’est pas couvert : gardez-en une arborescence réelle ;

  • l’heure — SOURCE_DATE_EPOCH est exporté comme date du commit et c’est ce qu’utilisent les mtimes de l’archive et les dates de la documentation ; passez SOURCE_DATE_EPOCH=<seconds> pour le remplacer dans un arbre qui n’est pas une copie de travail git ;

  • l’archive — make dist l’écrit avec tar --sort=name --mtime=@$SOURCE_DATE_EPOCH --owner=0 --group=0 --numeric-owner et gzip -n.

Pour reproduire une version, extrayez son étiquette avec le sous-module, construisez, et comparez

git clone --recurse-submodules https://git.taler.net/pepsi.git
cd pepsi && git checkout vX.Y.Z
make build            # the multi-call binary and the standalone programs
make dist             # the tarball
sha256sum target/release/pepsi target/release/pepsi-setup pepsi-X.Y.Z.tar.gz

Comparez ensuite les sommes avec celles des artefacts publiés. Les binaires d’un .deb (dépaqueté avec dpkg-deb -x) sont les fichiers que produit make build, mais construits avec la chaîne de compilation de la construction du paquet. C’est le rustc propre à Debian, qui ignore rust-toolchain.toml. Reproduisez donc un paquet avec le rustc que nomme son fichier .buildinfo. Un RUSTFLAGS ou un CFLAGS différent dans l’environnement, un contenu de cache de crates différent (une crate dont la somme de contrôle diffère échoue de toute façon à --locked), ou une autre chaîne de compilation donne un autre binaire ; diffoscope montre où deux constructions diffèrent.

4.5. Migrer depuis un serveur de messagerie existant

Si cet hôte exécute déjà Postfix, Exim, Sendmail, qmail ou Stalwart, vous n’avez pas à redériver sa configuration à la main. En l’absence de pepsi.conf, pepsi-setup --wizard détecte ce qui est installé et propose de l’importer : le nom d’hôte, les domaines acceptés, le smarthost (avec les identifiants de relais lus dans le propre fichier de mots de passe de ce serveur), la méthode de remise locale, la socket SASL de soumission, la limite de taille des messages, la durée de vie en file d’attente et les chemins des certificats TLS arrivent tous comme réponses pré-remplies du questionnaire, que vous confirmez ou corrigez ensuite une par une. Les réseaux de confiance de l’ancien serveur sont au contraire listés dans le rapport de migration : Pepsi ne laisse un réseau relayer qu’au nom des adresses auxquelles [pepsi-ingress] SENDER_MAP le lie, si bien que chacun exige une liaison que vous écrivez à la main.

Pour voir ce qu’une migration produirait avant de lancer l’assistant, exécutez ce qui suit ; rien n’est écrit

pepsi-setup import

Les tables de routage sont converties elles aussi. /etc/aliases, /etc/postfix/virtual, la virtusertable de Sendmail, les fichiers .qmail-* de qmail et leurs équivalents deviennent une table d’alias Pepsi à côté de la configuration (voir pepsi-stage-aliases), les noms d’alias nus étant qualifiés dans le style que vous choisissez. Comme les clés d’alias de Pepsi doivent porter un domaine, postmaster: root devient par défaut postmaster@example.org  root@example.org pour chaque domaine accepté.

Tout ce qui n’est pas repris est écrit dans import-report.txt à côté de la configuration, réparti entre ce qui n’a pas pu être analysé, ce à quoi Pepsi n’a pas d’équivalent (header_checks, un alias qui remet à une commande), ce qui a été approché (une remise mbox devenue Maildir) et ce que l’importateur n’a pas reconnu. Un import n’interrompt jamais la configuration initiale : un fichier illisible ou une directive inconnue produit une entrée de rapport, pas un échec.

Deux choses ne sont délibérément pas migrées : le courrier en file d’attente (laissez la file de l’ancien serveur se vider avant de basculer le MX) et les clés DKIM (pepsi-setup run en génère de nouvelles et affiche les enregistrements à publier). Si l’ancien MTA occupe encore le port 25 au moment où l’assistant s’exécute, le rapport le signale ; arrêtez-le et désactivez-le avant de démarrer pepsi-ingress.

Voir pepsi-setup pour le détail par serveur, les choix de --alias-style et les options --expert qui exposent les réglages sur lesquels le questionnaire ne vous interroge pas autrement.

4.5.1. Les filtres de courrier déjà présents sur l’hôte

Indépendamment de toute migration, l’assistant parcourt l’hôte à la recherche de démons milter (clamav-milter, rspamd, spamass-milter, milter-greylist, milter-regex, mimedefang, amavisd-milter) et propose chacun de ceux qu’il trouve. En trouver un signifie trois choses successives : le paquet est installé, une socket peut être lue depuis sa propre configuration (ou son unité, ou les chemins que livre sa distribution), et une véritable négociation d’options milter aboutit face à cette socket. Rien n’est proposé sur la seule foi d’un paquet installé, et la négociation est aussi la raison pour laquelle l”ALLOW_ACTIONS généré accorde exactement ce que ce filtre demande plutôt qu’une supposition.

pepsi-ingress consulte chaque filtre retenu pendant la session SMTP, après ses propres vérifications, comme le ferait un MTA : un filtre qui refuse du courrier répond au serveur expéditeur par son propre 4xx ou 5xx, si bien que rien de ce qui a été accepté n’a à faire l’objet d’un rebond plus tard. Les filtres sont consultés dans un ordre qui dépend de ce qu’ils font : politique et greylisting, puis antivirus, puis spam, puis frameworks généralistes. Les milters qu’une importation de MTA a trouvés (smtpd_milters de Postfix, INPUT_MAIL_FILTER de sendmail) sont repris de la même manière, avec l’action en cas d’échec, les timeouts et les macros qu’utilisait l’ancien MTA. L’assistant écrit aussi [stage-quarantine], qui retient un message qu’un filtre demande à mettre en quarantaine jusqu’à ce que vous le libériez. Voir Les milters dans la session SMTP pour les sections générées et pepsi-ingress pour la façon dont la session les utilise.

Deux sortes de filtres s’exécutent au contraire comme étapes du pipeline de pepsi-stage-milter, après l’acceptation du message : un filtre qui s’appliquait au courrier soumis localement (non_smtpd_milters de Postfix) et, avec --expert, un filtre que vous placez après le déchiffrement pour qu’il voie le texte clair. Les filtres dont Pepsi fait déjà le travail (opendkim, openarc, opendmarc, les démons SPF, postsrsd) sont nommés et ignorés plutôt que proposés.

L’assistant demande aussi s’il faut faire du greylisting avec le milter de greylisting propre à Pepsi, pepsi-greylist. La réponse par défaut est non, car le greylisting retarde le premier message de chaque nouveau correspondant. pepsi-setup check négocie avec chaque milter configuré et signale celui qui ne répond pas, ou qui demande une action que son ALLOW_ACTIONS n’accorde pas.

4.6. Provisionner la base de données, les clés et le DNS

Avec un fichier de configuration en place (voir Configuration), exécutez l’outil d’amorçage une fois

pepsi-setup -c /etc/pepsi/pepsi.conf run > pepsi-dns.zone

Cela valide toute la configuration, installe le schéma pepsi, fait générer par le démon de signature pepsi-dkim les clés DKIM de chaque domaine (RSA et Ed25519, pour chaque domaine qui n’en a pas), et affiche les enregistrements DNS à publier. Ce sont les clés publiques DKIM, une politique SPF à partir des adresses PUBLIC_IP configurées, un enregistrement MTA-STS et, pour chaque écouteur TLS d’ingress, un enregistrement DANE TLSA. Cet enregistrement épingle la clé publique du certificat de courrier ; c’est pourquoi les certificats certbot sont obtenus avec --reuse-key (voir Changer la clé derrière un enregistrement TLSA). Les écouteurs de courrier et l’écouteur HTTPS de pepsi-httpd reçoivent des lignées certbot distinctes, et donc des clés distinctes : /etc/letsencrypt/live/<HOSTNAME>/ pour le courrier et /etc/letsencrypt/live/<HOSTNAME>-web/ pour le serveur web. Le serveur web ne détient donc jamais la clé qu’épingle l’enregistrement TLSA. (Une installation dont l’écouteur HTTPS utilise encore le certificat de courrier passe au sien au pepsi-setup run suivant, une fois ce certificat obtenu.) L’opération est idempotente et peut être relancée à tout moment ; mettre à niveau le schéma vers une nouvelle version relève de pepsi-setup schema (voir Mise à niveau). run --reset supprime et recrée le schéma ; cela détruit tout le courrier en file, mais conserve les clés DKIM, qui ne sont pas dans la base de données.

Publiez les enregistrements DNS imprimés, puis vérifiez ce qui est en service par rapport à ce que Pepsi attend

pepsi-setup -c /etc/pepsi/pepsi.conf check

Voir pepsi-setup pour le flux de provisionnement complet.

4.7. Configurer dans un navigateur

Tout ce qui précède peut aussi se faire depuis un navigateur, contre le même code. La voie du terminal est la plus courte sur une machine où vous avez un shell ; la voie du navigateur est là pour celles où vous n’en avez pas, et pour les opérateurs qui préfèrent voir les enregistrements DNS comme une liste rouge/verte plutôt que comme un fichier de zone.

4.7.1. La scission, et pourquoi

La configuration initiale est privilégiée : elle écrit /etc/pepsi/pepsi.conf, remet chaque fragment secrets.d à l’unique compte qui le lit, exécute certbot, crée des rôles de base de données et génère du matériel de clé — le tout en root. pepsi-httpd, qui sert l’interface, abandonne ses privilèges avant d’accepter une connexion et ne doit jamais les regagner.

Elle n’agit donc pas. Elle écrit une ligne d”intention qui dit ce qui devrait être vrai. Un programme root distinct, pepsi-setup apply, décide comment, le fait, et note ce qui s’est passé ; il est démarré à la demande et se termine dès qu’il n’a plus rien à faire. Root n’est jamais sur le réseau. Lisez « Le modèle de confiance de l’applicateur » dans :doc:`programs/pepsi-setup` avant d’activer ceci : il énonce exactement ce que l’applicateur fera et ne fera pas, y compris ce qu’il ne peut délibérément pas faire (il n’y a aucune tâche de redémarrage ou d’arrêt, et install-schema refuse reset).

4.7.2. L’activer

Les paquets Debian livrent une configuration minimale mais complète, un écouteur d’administration sur une socket UNIX, et l’unité socket de l’applicateur. Cette unité se trouve dans pepsi-httpd-admin, que pepsi Recommends et qu”apt installe donc par défaut (voir Paquets Debian). Deux commandes l’activent :

# systemctl enable --now pepsi-httpd.socket pepsi-setup-apply.socket
# pepsi-setup -c /etc/pepsi/pepsi.conf bootstrap

La deuxième imprime un jeton à usage unique et la commande curl qui le transforme en premier compte d’administrateur. Sur la machine elle-même vous pouvez l’omettre entièrement : un membre du groupe pepsi-admin (et root) est identifié par SO_PEERCRED sur /run/pepsi/admin.sock et n’a besoin d’aucun identifiant.

Un réglage de plus est nécessaire avant que quoi que ce soit de privilégié puisse être demandé : [pepsi-admin] CONFIG_DB doit nommer une connexion qui s’authentifie en tant que rôle de base de données pepsi-config. C’est la limite : seul ce rôle peut mettre en file du travail de configuration, et le compte propre de pepsi-httpd ne l’est pas, de sorte qu’une compromission de la couche web n’est pas une compromission de la définition du pipeline. Tant qu’il n’est pas défini, les points de terminaison de configuration répondent 503 et le disent.

4.7.3. Le piloter

Le questionnaire est une donnée. GET /api/v1/setup/questions renvoie les étapes ordonnées et, pour chaque question, sa forme, sa valeur par défaut, son texte d’aide et la condition sous laquelle elle est posée. C’est le même modèle que celui qu’imprime pepsi-setup questions et qui décrit l’assistant de terminal ; la suite de tests garantit qu’ils sont égaux. Les réponses sont mises en attente par PUT /api/v1/setup/answers dans des lignes de brouillon qu’aucun processus en fonctionnement ne peut voir, de sorte qu’une session interrompue ne puisse rien configurer à moitié.

POST /api/v1/setup/tasks demande ensuite la moitié privilégiée : écrire la configuration, obtenir des certificats, installer le schéma et générer des clés. GET /api/v1/setup/tasks/{id}?since=<seq> diffuse ligne par ligne ce que fait l’applicateur.

4.7.4. Ce qui exigera toujours un éditeur de texte

Certains réglages ne sont lus que depuis le fichier de configuration, et aucune interface n’y changera rien : [pepsi], [pepsi-postgres], [paths], et les sections d”écouteur HTTP(S) et d’ingress. Ils doivent fonctionner avant qu’une connexion à la base n’existe, ou bien ils constituent une limite de sécurité : si la base pouvait déplacer une socket d’écoute ou assouplir la politique cryptographique, une compromission de la base deviendrait une compromission du TLS et des ports propres du MTA.

Ainsi, ajouter un port de soumission, ou déplacer un écouteur, est une opération éditeur-de-texte-et-redémarrage. Il en va de même de tout changement que la console marque restart plutôt que hot : il n’y a aucun bouton de redémarrage, car un bouton qui redémarrerait un service à la demande remettrait les privilèges de la couche web à quiconque l’atteint.

4.7.5. Le scripter

Le même modèle de réponses pilote une installation sans surveillance

pepsi-setup --wizard --answers answers.json -c /etc/pepsi/pepsi.conf

pepsi-setup questions imprime le schéma contre lequel ce fichier est écrit. Ce n’est pas une troisième implémentation du questionnaire : il exécute le questionnaire interactif avec chaque question répondue depuis le fichier, de sorte que les branches et la validation par champ sont celles qu’un humain voit.

4.8. Exécuter les services

Ces processus de longue durée tournent en permanence (pepsi.target les démarre tous sous les unités livrées) :

  • pepsi-ingress serve — accepte le courrier (typiquement sous un gestionnaire de service, éventuellement avec l’activation par socket systemd pour les ports privilégiés).

  • pepsi-dispatch serve — exécute exactement une instance par système ; c’est le seul processus qui démarre les programmes d’étape.

  • pepsi-dkim serve — détient les clés privées DKIM et ARC et signe pour les étapes de signature ; l’unité du répartiteur l’entraîne.

  • pepsi-httpd serve — la politique MTA-STS, le Web Key Directory, le portail de lien sécurisé et, sur les écouteurs d’administration, l’API et la console.

  • pepsi-keydisc serve METHOD — une instance par méthode de découverte de clés (pepsi-keydisc@dane, @wkd-advanced, @wkd-direct et @vks par défaut), qui répond aux demandes de clés des étapes de cryptographie.

Un autre ne s’exécute que là où le greylisting est activé, depuis sa propre unité, en dehors de pepsi.target :

  • pepsi-greylist serve — le milter de greylisting que pepsi-ingress (ou un Postfix placé devant lui) consulte à RCPT.

Les timers que pepsi.target demande aussi (mise en rebond des échecs, nettoyage de la file et des journaux, actualisation et retrait des clés, rapprochement des quotas, tâches et condensés des listes de diffusion) exécutent des tâches ponctuelles ; systemctl list-timers 'pepsi-*' les liste.

Les programmes d’étape eux-mêmes sont lancés par le dispatcher comme des processus PROGRAM worker persistants qui lisent les identifiants de message sur l’entrée standard ; vous ne les exécutez pas à la main en production (pour le débogage, vous pouvez envoyer un identifiant par tube à worker, par exemple echo 42 | pepsi-stage-srs -c /etc/pepsi/pepsi.conf worker).

4.9. Mise à niveau

À partir de la première version, 0.0.0, chaque version met à niveau sur place la base de données de toute version antérieure : la file d’attente, le magasin de clés, les réglages et tout ce qu’elle contient d’autre sont conservés, et le courrier en attente dans la file est remis par la nouvelle version. Les retours à une version antérieure ne sont pas pris en charge (voir plus bas).

La procédure :

  1. Lisez NEWS pour la version. Il liste les options de configuration qui ont changé, et tout ce qui doit encore être fait à la main.

  2. Faites une sauvegarde (Sauvegarde et restauration), ou au moins activez le vidage automatique décrit plus bas.

  3. Installez la nouvelle version. Les paquets Debian font le reste : ils mettent à niveau le schéma et redémarrent les services qui tournaient. Depuis les sources : make install, puis pepsi-setup -c /etc/pepsi/pepsi.conf schema et systemctl try-restart pepsi.target.

  4. Vérifiez avec pepsi-status que la file d’attente se vide, et consultez le journal à la recherche d’avertissements (Journaux).

Une version peut aussi refuser une configuration qu’une version antérieure acceptait, lorsque l’ancien comportement était une faiblesse de sécurité (NEWS dit laquelle) ; les services ne démarrent alors pas. Exécutez pepsi-setup -c /etc/pepsi/pepsi.conf validate avant de les redémarrer : il applique les mêmes vérifications et nomme ce qu’il faut changer.

La suite de cette section explique ce qui se passe pendant l’étape 3.

Chaque programme Pepsi vérifie, lorsqu’il se connecte à la base de données, que le schéma a été construit à partir exactement des fichiers SQL avec lesquels le programme lui-même a été compilé. L’installateur enregistre le SHA-256 et la version de chaque fichier qu’il applique dans pepsi.schema_file. Un programme qui trouve autre chose (un schéma plus ancien, un plus récent, ou un construit à partir d’autres fichiers) s’arrête aussitôt avec le code de sortie 78 et un message indiquant le remède, plutôt que d’échouer sur sa première colonne manquante au milieu d’un message. Le dispatcher traite un worker d’étape qui s’arrête ainsi comme « ne peut pas encore s’exécuter », et non comme un plantage : le message qui lui avait été confié est remis dans la file, jamais mis en échec.

La mise à niveau du schéma est une étape à part

pepsi-setup -c /etc/pepsi/pepsi.conf schema

Elle installe les patchs qu’ajoute cette version, remplace les fonctions stockées et réapplique les droits des rôles. Elle ne fait rien d’autre (ni certificats, ni clés, ni DNS) et n’a donc besoin que de la section [pepsi-postgres]. Sur un collecteur de télémétrie, donnez-lui le fichier du collecteur, /etc/pepsi-telemetry/pepsi-telemetry.conf.

Les paquets Debian l’exécutent automatiquement lors de leur mise à niveau, avant le redémarrage des services ; une nouvelle installation est laissée à pepsi-setup run. Si elle échoue (la base de données est arrêtée, par exemple), le paquet s’installe quand même, un avis le signale, et les services refusent de démarrer. systemd les relance jusqu’à ce que le schéma corresponde, en espaçant les tentatives jusqu’à une par minute, sans limite de démarrage. Une fois la cause corrigée, il suffit d’exécuter la commande ci-dessus ; les services reviennent d’eux-mêmes.

Depuis les sources, après make install

pepsi-setup -c /etc/pepsi/pepsi.conf schema
systemctl try-restart pepsi.target

Ce que signifient les refus :

Le message indique

Que faire

pas de schéma pepsi

Une nouvelle installation : pepsi-setup run (ou pepsi-setup schema sur un hôte collecteur).

plus ancien que ce programme

pepsi-setup -c FILE schema.

plus récent que ce programme

Un retour à une version antérieure, qui n’est pas pris en charge. Réinstallez la version plus récente, ou restaurez la sauvegarde de la base de données prise avant la mise à niveau (ci-dessous).

construit à partir d’une autre copie d’un patch

Un patch publié ne change jamais, il s’agit donc d’un bogue ; merci de le signaler. La seule exception est une base de données construite à partir d’un instantané de développement (une copie Git entre deux versions), où le patch le plus récent est encore en cours de modification : videz-la puis recréez-la avec pepsi-setup run --reset.

fonctions stockées d’une autre compilation

Compilations de développement uniquement : pepsi-setup -c FILE schema.

4.9.1. Mise à niveau depuis 0.0.0 : les clés DKIM

La version 0.0.0 garde ses clés DKIM et ARC sous forme de fichiers sous [pepsi] KEY_DIR, lisibles par le pipeline. Les versions ultérieures les détiennent dans le démon de signature pepsi-dkim, sous son propre compte et dans son propre répertoire. Le démon ne reprend pas les fichiers de clés de 0.0.0 : il génère de nouvelles clés sous de nouveaux sélecteurs (pepsi-YYYYMM et pepsi-YYYYMM-ed25519) et signe immédiatement avec elles. Il ne signe que pour les domaines que lui transmet pepsi-setup run ; tant que ce n’est pas fait, le courrier sortant attend à l’étape de signature et est réessayé : exécutez-le donc juste après l’installation :

  1. Installez la nouvelle version comme ci-dessus.

  2. Exécutez pepsi-setup -c /etc/pepsi/pepsi.conf run. Il transmet les domaines de signature à pepsi-dkim, qui crée les clés, supprime les anciens fichiers de clés sous KEY_DIR et affiche les nouveaux enregistrements DKIM, avec les anciens enregistrements pepsi et pepsi-ed25519 en commentaires à retirer.

  3. Publiez les nouveaux enregistrements. Tant qu’ils ne sont pas publiés, les destinataires ne peuvent pas vérifier les signatures et DMARC ne repose que sur SPF ; pepsi-setup check, pepsi-dkim status et le courrier du démon au postmaster indiquent ce qui manque encore.

  4. Retirez les anciens enregistrements pepsi._domainkey et pepsi-ed25519._domainkey une fois remis le courrier signé avec les anciennes clés, au plus tard une semaine après la mise à niveau.

Dès lors, laissez /var/lib/pepsi-dkim hors des sauvegardes (Sauvegarde et restauration). La rotation reste désactivée à moins que vous ne l’activiez (Rotation des clés DKIM).

4.9.2. Retour à une version antérieure

Non pris en charge. pepsi-setup refuse d’installer le SQL d’une version plus ancienne par-dessus un schéma plus récent (code de sortie 78, rien n’est modifié), et les programmes de la version plus ancienne refusent de s’exécuter dessus. Revenir à une version plus ancienne implique de restaurer une sauvegarde de la base de données prise avant la mise à niveau, puis d’installer les paquets plus anciens. Aucune interface de Pepsi ne peut installer une version plus ancienne, si bien qu’un retour à une version vulnérable exige une action délibérée de root (voir Mises à jour de micrologiciel signées acceptées sans vérification de version).

4.9.3. Sauvegarder avant une mise à niveau du schéma

Aucune sauvegarde n’est effectuée à moins que vous ne l’activiez. Une fois activée, la sauvegarde n’est effectuée que lorsqu’une mise à niveau modifie réellement le schéma : pg_dump enregistre le schéma pepsi (avec les extensions qu’il utilise) sous pepsi-<previous version>-<UTC time>.dump, lisible par root seulement. Si le vidage échoue, le schéma n’est pas mis à niveau. Après chaque nouveau vidage, seuls les deux plus récents sont conservés dans le répertoire (pepsi-setup schema --backup-keep ; 0 les conserve tous) : un vidage contient toute la file, y compris le texte en clair du courrier déchiffré qui y attend, si bien que d’anciens vidages sont des copies de courrier qui aurait autrement quitté l’hôte depuis longtemps. Copiez un vidage ailleurs s’il doit survivre à deux mises à niveau.

Avec les paquets Debian, c’est un réglage debconf, posé seulement à la priorité low

dpkg-reconfigure -plow pepsi

Répondez oui, puis confirmez ou modifiez le répertoire (par défaut /var/backups/pepsi). Sans surveillance, ou avant la première mise à niveau

echo "pepsi pepsi/schema-backup boolean true" | debconf-set-selections
echo "pepsi pepsi/schema-backup-dir string /var/backups/pepsi" | debconf-set-selections

Sur un hôte collecteur de télémétrie, les questions appartiennent à pepsi-telemetry (pepsi-telemetry/schema-backup, pepsi-telemetry/schema-backup-dir). Lorsque les deux paquets sont installés et utilisent la même base de données, celui qui la met à niveau le premier effectue la sauvegarde.

Depuis les sources, passez le répertoire à l’étape de mise à niveau

pepsi-setup -c /etc/pepsi/pepsi.conf schema --backup-dir /var/backups/pepsi

Pour en restaurer une, arrêtez les services, recréez la base de données vide et appartenant au propriétaire du schéma, et restaurez-y la sauvegarde en tant que ce propriétaire

systemctl stop pepsi.target
sudo -u postgres dropdb pepsi
sudo -u postgres createdb -O pepsi-owner pepsi
sudo -u pepsi-owner pg_restore -d pepsi /var/backups/pepsi/pepsi-0.0.0-20261001T000000Z.dump

Installez ensuite la version dont provient la sauvegarde et redémarrez les services. Tout ce que la base de données a appris après la sauvegarde est perdu, par exemple le courrier accepté depuis et les réglages modifiés depuis. Les clés privées stockées dans le vidage sont chiffrées sous la clé de chiffrement de clés de secrets.d, qui ne se trouve pas dans la base de données : conservez ce fichier, et sauvegardez-le séparément (voir Sauvegarde et restauration). Les clés sont scellées par un AEAD, de sorte qu’un blob modifié dans un vidage ne s’ouvre jamais (voir Un chiffrement non authentifié des clés privées permet au détenteur du stockage d’altérer les clés) ; sans le fichier, elles sont perdues (voir Gestion des clés trop difficile : clients de messagerie de bout en bout sources d’erreurs ou inutilisés).

4.10. Utilisateurs, groupes et privilèges

Pepsi ne s’exécute jamais en tant que root. Les démons de longue durée peuvent être démarrés en tant que root pour pouvoir lier les ports privilégiés et lire les clés TLS réservées à root, mais chacun abandonne ses privilèges vers son propre compte de service non privilégié avant de servir la moindre connexion ; si l’abandon ne peut être complété, le processus refuse de démarrer plutôt que de risquer de s’exécuter en tant que root (voir pepsi-common::privdrop). Agir en tant qu’un autre utilisateur local, par exemple écrire dans sa boîte aux lettres, exécuter son ~/.forward ou utiliser son portefeuille, est le seul type d’opération qui nécessite plus de droits que l’utilisateur de service n’en a. Chacune de ces opérations est confinée à un helper setuid à portée étroite plutôt que confiée au pipeline en général. La séparation des privilèges décrit cette séparation en tant que mécanisme de sécurité, et Frontières de confiance les frontières qu’elle soutient.

Avec les unités systemd fournies, les démons ne sont jamais root : systemd lie les sockets privilégiées (activation par socket) et démarre chaque processus directement sous son compte de service. Restent les clés TLS, que certbot conserve lisibles par root seul. pepsi-setup les fait donc lire par systemd également, en écrivant un drop-in LoadCredential= par unité : systemd ouvre chaque certificat et chaque clé en tant que root au démarrage de l’unité, et remet au service une copie privée sous $CREDENTIALS_DIRECTORY, où le serveur regarde en premier. Relancez pepsi-setup run chaque fois que vous ajoutez, déplacez ou supprimez un certificat, afin que le drop-in soit régénéré. Voir pepsi-httpd.

La configuration par navigateur décrite ci-dessus est la seule voie par laquelle quelque chose d’autre qu’un opérateur à un terminal peut faire tourner un processus root : pepsi-httpd sonne à une socket de sonnette et systemd démarre un pepsi-setup apply root de courte durée. Cette voie est le privilège le plus facile à retirer dans Pepsi. Ses deux unités systemd forment un paquet Debian distinct, pepsi-httpd-admin, dont l’équivalent pour une installation depuis les sources est make install INSTALL_ADMIN_UNITS=no. Sans elles, rien ne vide pepsi.setup_task et aucune requête HTTP ne peut rien changer sous /etc/pepsi, tandis que pepsi-setup sur un terminal continue de fonctionner sans changement. Remettre le paquet n’agit pas sur ce qui a été demandé pendant son absence : son installation vide cette file avant que ses unités ne soient armées. Voir La scission comme levier de durcissement.

Les comptes et groupes ci-dessous sont créés automatiquement par le postinst du paquet Debian ; sur un make install vous les créez vous-même (les mêmes noms). L’accès à PostgreSQL se fait par authentification par pair via la socket locale : chaque compte de service se connecte en tant qu’un rôle de base de données du même nom, de sorte qu’aucun mot de passe n’est stocké nulle part. Une base de données distante conserve le même modèle : un rôle de connexion par compte, chacun authentifié par un certificat client ou un fichier de mot de passe qui lui est propre et que seul ce compte peut lire, nommé par rôle avec le paramètre substituable {role} dans [pepsi-postgres] CONFIG (voir CONFIG dans pepsi.conf(5)). Le fichier de configuration ne contient jamais de mot de passe.

4.10.1. Comptes de service

Ce sont des comptes système (--system, /usr/sbin/nologin, home /var/pepsi), chacun avec un groupe primaire privé du même nom. Les trois premiers sont des démons de longue durée qui abandonnent leurs privilèges vers leur compte après s’être liés ; les autres ne sont pas des démons du pipeline.

Compte

Exécute

But / accès

pepsi-ingress

pepsi-ingress

Serveur SMTP entrant. Activé par socket sous systemd (jamais root ; le matériel TLS arrive comme identifiant de service) ; démarré à la main, il lie 25/465/587 et lit les clés TLS en tant que root, puis abandonne ses privilèges. Rôle DB pepsi-ingress.

pepsi-httpd

pepsi-httpd

Serveur HTTP/HTTPS (politique MTA-STS, Web Key Directory, portail de lien sécurisé et, sur les écouteurs d’administration, /metrics, l’API et la console). Activé par socket sous systemd, exactement comme pepsi-ingress ; démarré à la main, il lie 80/443 en tant que root, puis abandonne ses privilèges. Rôle DB pepsi-httpd.

pepsi

pepsi-dispatch et chaque worker d’étape qu’il lance

L’identité de travail du pipeline. Fait signer les messages par pepsi-dkim via sa socket (groupe pepsi), mais ne peut pas lire de clé de signature. Rôle DB pepsi (possède les lignes de la file). C’est le compte qui acquiert transitoirement les identités de groupe de remise, de portefeuille et de jeton ci-dessous. Comme n’importe quelle étape peut réécrire un message après qu’ingress a vérifié son From:, une signature ne vaut que ce que vaut ce compte (Un composant compromis).

pepsi-owner

pepsi-setup (transitoirement)

Pas un service d’exécution. Possède la base de données, le schéma, les tables et les fonctions pepsi. Lorsque pepsi-setup s’exécute en tant que root, il assume temporairement cette identité (seteuid) afin que les objets qu’il crée soient possédés par le rôle pepsi-owner authentifié par pair, puis revient à root pour le travail sur le système de fichiers (génération de clés, corrections de propriété).

pepsi-helper-token-refresh

service pepsi-helper-token-refresh

Utilisé uniquement lorsqu’un smarthost utilise AUTH = oauth (le paquet Debian le crée quand même ; un make install n’en a besoin que dans ce cas). Rafraîchit les jetons d’accès OAuth et écrit les fichiers de jeton que le relais smarthost lit. N’a aucun rôle de base de données.

pepsi-crypto

pepsi-keys (transitoirement), et les étapes cryptographiques de bout en bout

Gardien du matériel de clé privée de bout en bout. Possède secrets.d/pepsi-crypto.secret, la clé de chiffrement de clés qui ouvre pepsi.crypto_identity.private_wrapped, et constitue le seul rôle de base de données à qui cette colonne est accordée ; tout autre rôle, pepsi compris, reçoit un droit au niveau colonne qui l’omet. pepsi-keys endosse cette identité le temps d’un appel à la base et la rend aussitôt. Voir Gestion des clés. Cela limite qui peut lire les clés privées ; les étapes de cryptographie qui s’exécutent sous ce compte les détiennent toujours toutes (voir Des appliances de messagerie stockent des secrets lisibles par tous ou non protégés).

pepsi-whitelist

pepsi-whitelist (transitoirement)

Compte qu’endosse la CLI de liste blanche setuid afin que les utilisateurs ordinaires puissent entretenir leurs propres listes blanches d’expéditeurs. Son rôle de base de données se voit accorder SELECT/INSERT/DELETE sur pepsi.whitelist et rien d’autre.

pepsi-keydisc

services pepsi-keydisc@<method>

Découverte de clés (WKD, DANE, VKS, LDAP). Analyse du matériel de clé récupéré sur l’Internet ouvert, de sorte que son rôle de base de données est le plus étroit du déploiement. Voir Gestion des clés.

pepsi-config

pepsi-config (tel qu’exécuté par un opérateur)

Le seul rôle de base de données autorisé à écrire la surcouche pepsi.config_override : un composant qui traite le courrier ne doit pas pouvoir réécrire le pipeline dans lequel il s’exécute.

pepsi-greylist

service pepsi-greylist et timer pepsi-greylist-prune

Le milter de greylisting. Son groupe est le groupe de sa socket /run/pepsi-greylist/milter.sock (0660) : un MTA qui en est membre peut l’interroger (pepsi-ingress en est un), et le groupe n’accorde rien d’autre. Son rôle de base de données atteint les tables greylist_*, lit whitelist et ajoute à event_log.

pepsi-dkim

service pepsi-dkim

Gardien des clés privées DKIM et ARC, fichiers en 0600 dans son répertoire personnel /var/lib/pepsi-dkim (0700). Signe pour les étapes via /run/pepsi-dkim/sign.sock, qu’il confie au groupe pepsi (dont il est membre à cette fin) ; possède secrets.d/pepsi-dkim.secret (la clé TSIG de DNS_UPDATE = rfc2136). N’a aucun rôle de base de données.

Le postinst du paquet (ou, sur une installation manuelle, vous-même) crée les dix rôles de connexion PostgreSQL avant que pepsi-setup n’installe le schéma : pepsi-owner, pepsi, pepsi-ingress, pepsi-httpd, pepsi-telemetry, plus les rôles étroits pepsi-whitelist, pepsi-config, pepsi-crypto, pepsi-keydisc et pepsi-greylist. pepsi-setup accorde ensuite à chaque rôle ce dont il a besoin.

4.10.2. Groupes contrôlant l’accès aux ressources partagées

Quatre groupes existent uniquement pour contrôler l’accès aux binaires privilégiés et aux fichiers de secrets. L’utilisateur pepsi n’est délibérément pas un membre permanent de l’un d’eux : le bit setgid sur le binaire d’étape concerné accorde au worker l’identité de groupe seulement pour la durée de vie de ce processus.

pepsi-maildir

Contrôle l’accès au helper de remise locale. pepsi-helper-maildir-writer est setuid root et mode 4750 (root:pepsi-maildir), de sorte que seul ce groupe peut l’exécuter. pepsi-stage-relay-to-maildir est setgid de ce groupe (mode 2550, pepsi:pepsi-maildir ; exécutable par le seul propriétaire, de sorte qu’aucun autre utilisateur local ne peut atteindre le bit setgid). Lorsque le worker pepsi exec l’étape, il acquiert egid=pepsi-maildir, c’est-à-dire exactement le droit de lancer le helper. Le helper fait alors un setuid vers le destinataire et écrit dans ~/Maildir/new/. Le helper est le seul code qui touche jamais à la boîte aux lettres d’un tiers.

pepsi-forward

Contrôle l’accès au helper ~/.forward, exactement dans la forme de la paire maildir ci-dessus : pepsi-helper-dot-forward est setuid root et mode 4750 (root:pepsi-forward), et pepsi-stage-dot-forward est setgid de ce groupe (mode 2550, pepsi:pepsi-forward). Nécessaire seulement si vous exécutez l’étape ~/.forward ; sans le groupe, les cibles install-forward-helper / install-forward-stage de make install se contentent d’imprimer un avertissement et laissent les binaires non privilégiés.

pepsi-wallets

Contrôle l’accès au helper de wallet de la même façon : pepsi-helper-auto-pay est 4750 root:pepsi-wallets et pepsi-stage-auto-pay est setgid de ce groupe (mode 2550, pepsi:pepsi-wallets). Un compte système du même nom possède les bases de wallets partagées sous /var/lib/pepsi-wallets lorsque WALLET_MODE = shared. Nécessaire seulement si vous exécutez l’étape auto-pay ; sinon install-auto-pay-helper / install-auto-pay-stage se dégradent en avertissement.

pepsi-token

Contrôle l’accès au matériel secret que le relais smarthost lit : fichiers de jeton OAuth, le certificat/la clé client de TLS mutuel, et le cache d’identifiants Kerberos. pepsi-stage-relay-to-smarthost est setgid de ce groupe (mode 2550, pepsi:pepsi-token) ; les répertoires contenant ces secrets sont setgid pepsi-token de sorte que les fichiers déposés dedans héritent du groupe, et le relais peut les lire sans que l’utilisateur pepsi soit membre.

4.10.3. Binaires privilégiés

Ces bits sont réglés par make install lorsqu’il est exécuté en tant que root (il imprime sinon les chown/chmod exacts à exécuter à la main), et par le paquet Debian via dpkg-statoverride, qui est la liste faisant foi (debian/pepsi.postinst) :

Binaire

Mode / propriétaire

Pourquoi

pepsi-helper-maildir-writer

4750 root:pepsi-maildir

Setuid root pour pouvoir écrire dans la boîte aux lettres de n’importe quel utilisateur local ; verrouillé au groupe afin que seul pepsi-maildir puisse l’exécuter.

pepsi-stage-relay-to-maildir

2550 pepsi:pepsi-maildir

Setgid afin que le worker pepsi puisse exécuter le helper ci-dessus. Exécutable par le propriétaire et non par tout le monde : le bit setgid est toute la barrière, aussi tout autre utilisateur local ne doit-il pas pouvoir l’atteindre. pepsi ne peut pas obtenir le droit d’exécution par le groupe (il n’en est délibérément pas membre), il l’obtient donc en possédant le fichier. pepsi-quota, pepsi-stage-dot-forward et pepsi-stage-auto-pay portent la même forme pour leurs propres groupes.

pepsi-quota

2550 pepsi:pepsi-maildir

Même groupe et même raison : measure/reconcile exécutent le helper ci-dessus, et c’est ce bit qui permet à un balayage sans surveillance de le faire sans root.

pepsi-helper-dot-forward

4750 root:pepsi-forward

Setuid root pour pouvoir exécuter le ~/.forward d’un utilisateur en tant que cet utilisateur ; verrouillé au groupe de son étape.

pepsi-stage-dot-forward

2550 pepsi:pepsi-forward

Setgid afin que le worker pepsi puisse exec le helper ci-dessus.

pepsi-helper-auto-pay

4750 root:pepsi-wallets

Setuid root pour pouvoir descendre vers le compte propriétaire du wallet (ou vers l’uid propre du destinataire) afin d’exécuter taler-wallet-cli : uniquement celui fixé à la compilation (--with-taler-wallet-cli), jamais un chemin que nomme un appelant.

pepsi-stage-auto-pay

2550 pepsi:pepsi-wallets

Setgid afin que le worker pepsi puisse exec le helper ci-dessus.

pepsi-stage-relay-to-smarthost

2550 pepsi:pepsi-token

Setgid afin que le worker pepsi puisse lire les secrets pepsi-token ; non exécutable par tous, puisque l’étape accepte -c et enverrait sinon ces secrets à n’importe quel serveur qu’un utilisateur local désignerait.

pepsi-whitelist

4755 pepsi-whitelist:pepsi-whitelist

Setuid, et exécutable par tout le monde à dessein : tout utilisateur local peut gérer son propre espace de noms <login>/…, et la règle qui l’empêche de toucher à celui d’autrui est dans le programme, non dans le mode du fichier.

pepsi-stage-encrypt, pepsi-stage-decrypt

4750 pepsi-crypto:pepsi

Setuid, et non setgid : l’authentification par pair de PostgreSQL se fonde sur l”uid effectif, et pepsi-crypto est le seul rôle à qui crypto_identity.private_wrapped est accordé. Mode 4750 avec le groupe pepsi parce que ce ne sont pas des commandes d’utilisateur — seul le compte du dispatcher et root peuvent les exécuter.

Tout autre binaire est installé non privilégié, y compris pepsi-keys, qui est autonome pour les mêmes raisons mais est livré en 0755 : un binaire capable d’ouvrir chaque clé privée d’un déploiement est une prise bien plus grosse que l’unique table de pepsi-whitelist, aussi le rendre setuid pepsi-crypto est-il une décision propre à chaque site plutôt que la valeur par défaut.

4.10.4. Répertoires et secrets

pepsi-setup et le paquet créent ce qui suit sous /var/pepsi (le home du service) et /etc/pepsi. Les répertoires setgid (2750) font hériter les nouveaux fichiers du groupe du répertoire, de sorte que le matériel jeton/TLS/Kerberos est lisible par le groupe pour le relais sans aucun chgrp par fichier.

Chemin

Propriétaire / mode

Contenu

/var/pepsi

pepsi-owner:pepsi

Home du service.

/var/lib/pepsi-dkim

pepsi-dkim 0700

Les clés privées DKIM et ARC (keys/<domain>/<selector>.key, 0600) et l’état du démon de signature. Laissé hors des sauvegardes à dessein (Sauvegarde et restauration).

/var/lib/pepsi-dkim-public

pepsi-dkim 0755

Le status.json public du démon (sélecteurs, enregistrements, modifications DNS dues) et, avec PUBLISH_RETIRED_KEYS, les clés retirées.

/run/pepsi-dkim

pepsi-dkim 0711

La socket de signature sign.sock (0660), le RuntimeDirectory propre à l’unité.

/run/pepsi-greylist

pepsi-greylist 0711

La socket milter.sock du milter de greylisting (0660, groupe pepsi-greylist), le RuntimeDirectory propre à l’unité.

/var/pepsi/tokens

pepsi-helper-token-refresh:pepsi-token 2750

Fichiers de jeton d’accès OAuth : écrits par le rafraîchisseur, lus par le relais smarthost via le groupe pepsi-token.

/var/pepsi/token-refresh

pepsi-helper-token-refresh 0700

Jetons de rafraîchissement renouvelés privés ; jamais lisibles par le groupe.

/etc/pepsi/secrets

root:pepsi-helper-token-refresh 0750

Les identifiants de rafraîchissement de jeton @inline-secret@ ; seul le rafraîchisseur peut les lire.

/etc/pepsi/secrets.d

root:root 0751

Les fragments que pepsi-setup génère : la clé SRS, les mots de passe smarthost/LMTP, les jetons marchand et de reprise, la clé de preuve d’origine et la clé de chiffrement de clés pepsi-crypto. Traversable par tous (et non lisible), de sorte que chaque service puisse atteindre l’unique fragment qu’il a le droit d’ouvrir ; les fragments eux-mêmes sont en 0640 et appartiennent à leur unique compte lecteur. pepsi-setup crée le répertoire s’il est absent. Un identifiant ajouté à la main dans pepsi.conf au lieu d’un fragment n’est pas protégé de cette façon (voir Des appliances de messagerie stockent des secrets lisibles par tous ou non protégés).

/var/pepsi/tls

root:pepsi-token 2750

Certificat + clé client de TLS mutuel pour le relais smarthost (TLS_CLIENT_CERT / TLS_CLIENT_KEY).

/var/pepsi/krb5

root:pepsi-token 2750

Cache d’identifiants Kerberos pour les smarthosts AUTH = gssapi (pointez KRB5CCNAME vers un cache FILE: ici ; un rafraîchisseur de keytab externe le remplit).

/run/pepsi

root:root 0775 + ACL

Les sockets de soumission locale, d’administration, HTTP et de l’applicateur de configuration. Créé par l’extrait tmpfiles.d, dont l’ACL accorde nommément à pepsi-ingress et pepsi-httpd l’accès en écriture.

/var/lib/pepsi-wallets

pepsi-wallets:pepsi-wallets 0700

Home du compte pepsi-wallets et bases de wallets que pepsi-helper-auto-pay crée en dessous (wallets/<key>.sqlite3, mode 0700). Uniquement avec pepsi-stage-auto-pay en WALLET_MODE = shared.

Les répertoires /var/pepsi/tokens, /var/pepsi/tls et /var/pepsi/krb5 (et le compte pepsi-helper-token-refresh) n’importent que lorsque vous configurez un smarthost avec le mécanisme AUTH correspondant ; un déploiement par défaut en direct-vers-MX ou en remise locale n’en utilise aucun.

4.11. Migrer depuis GNU Mailman

Une installation GNU Mailman existante – 2.1 ou 3 – passe sur Pepsi avec pepsi-list import et pepsi-archive import. Lisez le tableau ci-dessous avant de commencer, non après.

Les différences de comportement font un autre tableau, et il n’est pas dupliqué ici : Différences déclarées avec GNU Mailman 3 dans Listes de diffusion rassemble chaque endroit où Pepsi fait délibérément autre chose qu’amont. Ce sont le désabonnement en un clic, l’éclatement toujours par destinataire, les adresses d’expéditeur obscurcies dans les archives, la pierre tombale de suppression, les en-têtes X-Mailman-* renommés, et ce qui est simplement absent (pas de passerelle NNTP, pas d’archiveurs enfichables, pas d’API de greffons). Deux copies de ce tableau divergeraient, et la copie que l’exploitant en migration lirait par hasard serait la périmée. Cette section ne traite que de ce que l”importeur laisse derrière lui.

4.11.1. Ce qui ne passe pas, et pourquoi

Pourquoi

Les mots de passe

Ni les empreintes sha512_crypt du cœur de Mailman ni les pbkdf2_sha256 de Django dans mailman-web ne sont importées. L’importeur d’amont a le code, et il est commenté. C’est pourquoi l’importeur n’a jamais à lire la base Django, et pourquoi il n’existe nulle part dans Pepsi de vérificateur d’empreintes héritées. Les adresses vérifiées restent vérifiées, personne ne prouve donc une adresse deux fois ; les membres n’ont qu’à choisir un mot de passe, et c’est à cela que sert pepsi-list invite.

Les scores de bounce

Amont ne les importe pas non plus : le bounce_info de config.pck et les événements de rejet de Mailman 3 sont tous deux écartés, un membre migré démarre donc au score zéro sur les deux systèmes.

Les jetons en cours

Un jeton de confirmation ou de modération en attente est une promesse portant sur un flux qui n’existera plus après la bascule. Quiconque est au milieu d’un abonnement redemande.

Les « topics » (2.1)

Pas d’équivalent dans Mailman 3.

Les URI de modèles que nous refusons de récupérer

Une substitution en file: lirait le disque du serveur lui-même ; elle n’est donc pas importée. L’importeur signale chacune de ces URI au moment de l’import, plutôt que de laisser échouer des mois plus tard la première notification qui en a besoin, et la liste se rabat sur le modèle intégré.

Un réglage de Pepsi est décidé par l’import plutôt que repris : une liste que crée l’importateur reçoit hold_dmarc_failures = no, de sorte qu’elle continue de distribuer les messages qui échouent à DMARC comme le faisait GNU Mailman ; le rapport l’indique pour chaque liste. Activez-le avec pepsi-list list set-ext <list> hold_dmarc_failures yes une fois établi que les auteurs de la liste passent (Les réglages que Pepsi a inventés).

Tout ce que l’importeur n’a pas compris figure dans son rapport. Il sort avec un état non nul lorsque quelque chose a été perdu, et c’est tout l’intérêt : une migration à moitié réussie sortie avec zéro est une migration que personne ne vérifie. Rien n’est annulé, et relancer un import est sans danger : chaque écriture est clé sur l’identifiant de liste, l’adresse ou la Message-ID, une seconde passe est donc sans effet.

4.11.3. Quand notre lecteur de pickle est plus strict que le leur

pepsi-list import mailman21 lit config.pck avec son propre analyseur, qui ne construit rien : aucun module n’est cherché et aucun appelable n’est appelé, car une config.pck vient du serveur de quelqu’un d’autre et le pickle.load de Python sur une entrée non fiable équivaut à l’exécution de code arbitraire.

Le prix en est la rigueur. Le lecteur peut refuser un fichier, par exemple à cause d’un opcode qu’il n’implémente pas, d’un protocole plus récent que ce que Python 2 pouvait écrire, ou d’un entier trop large pour 64 bits. Il le dit alors et nomme l’issue de secours

python2 contrib/mm21-export.py /var/lib/mailman/lists/announce/config.pck \
    > /root/announce.json
pepsi-list import mailman21 --json /root/announce.json --list announce

Ce script tourne sur l”ancien serveur, avec le Python auquel ce serveur faisait déjà confiance, et exporte le même dictionnaire en JSON. Les deux voies passent ensuite par la même correspondance : elles ne peuvent donc pas être en désaccord sur le sens du fichier. Une migration ne doit jamais être bloquée par le fait que notre analyseur est plus strict que celui qui a écrit le fichier.

4.11.4. Des renommages d’en-têtes qu’un utilisateur remarquera

Pepsi émet X-Pepsi-List-* là où Mailman émettait X-Mailman-* ; la table de correspondance est dans Listes de diffusion. C’est le coût réel pour un utilisateur qui migre, parce que les règles procmail et Sieve sont écrites contre ces noms, et cela vaut la peine de le leur dire avant la bascule plutôt qu’après.