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 DebianDependsdepostgresqlet 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 checkindique dans quel mode le site se trouve. L’installer plus tard et relancerpepsi-setup runl’active, après quoi les archives existantes ont besoin d’unpepsi-archive reindexpour peupler la colonne que l’index lit.Le paquet Debian la place en
Recommends: unapt installpar 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
ADdu résolveur qu’on lui donne (/etc/resolv.conf,[pepsi] DNS_SERVERS, ou leDNS_SERVERSd’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 exempleunbound(apt install unbound, puisnameserver 127.0.0.1dansresolv.conf), ou systemd-resolved avecDNSSEC=yes. Là où ce n’est pas possible, nommez un résolveur validant de confiance dans[pepsi] DNS_SERVERSen 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 bitAD, 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-setupnomme 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-statusindique, 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
rustc1.95 ou ultérieur (le plancher est fixé par letaler-commonvendorisé ;./configureavertit 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~/.forwardet de wallet et des étapes qui les appellent, du relais smarthost, depepsi-quota, depepsi-whitelist, et depepsi-stage-encryptetpepsi-stage-decrypt(tous deux setuidpepsi-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) etpepsi-helper-mailbox-scan(quepepsi-whitelistexé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 entrantpepsi-dispatch— dispatcher d’étapespepsi-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 étapespepsi-setup— provisionnement/amorçagepepsi-queue— inspection/réparation de la filepepsi-status— résumé de santé du pipelinepepsi-reputation— listes de blocage IP pour le courrier entrantpepsi-sendmail— soumission locale (installé comme/usr/sbin/sendmailpar 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=DIRL’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=DIRLes 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=NAMELes 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-cryptoetpepsi-whitelist.--enable-docs/--disable-docsDé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é lorsquesphinx-build,makeinfoet Python avecdocutilssont tous présents.--enable-mta-links/--disable-mta-linksDétermine si
make installrevendique/usr/sbin/sendmailet 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 passeINSTALL_MTA_LINKS=yesparce que sonConflicts: mail-transport-agentgarantit déjà l’exclusivité.--with-taler-wallet-cli=PATHLe seul programme de portefeuille que le
pepsi-helper-auto-paysetuid 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=FEATURELa bibliothèque cryptographique sous OpenPGP (le backend de Sequoia), choisie par une fonctionnalité Cargo. Une seule est intégrée ;
FEATUREvaut l’une des valeurs suivantes :crypto-nettle(par défaut)Nettle, avec sa moitié à clé publique
hogweedet 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 donccrypto-openssl.crypto-opensslLa
libcryptod’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’écritmake build CRYPTO_BACKEND=crypto-openssl.--jobs=NLe 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 donccontrib/build-jobs.shqui 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.Nfixe le nombre à la place. Sansconfigure,CARGO_BUILD_JOBS=Ndans l’environnement ou sur la ligne de commande demakea le même effet.make -jNn’augmente pas le nombre, mais le plafonne àN, et la construction Debian prend ce plafond dansDEB_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-binConstruit le binaire de release (unifié) et l’installe dans
$(DESTDIR)$(PREFIX)/libexec/pepsi/pepsi, puis crée un lien symbolique$(DESTDIR)$(PREFIX)/binpar nom de programme plié pointant vers lui (par exemplepepsi-ingress -> ../libexec/pepsi/pepsi). Les dix-sept programmes autonomes nommés dans leSTANDALONE_BINARIESdu 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 deDATADIRà l’exécution ci-dessous n’est pas affectée.install-dataCopie les fichiers SQL de
pepsi-setup/db/vers$(DESTDIR)$(DATADIR)/sql(oùDATADIR = $(PREFIX)/share/pepsi).pepsi-setuples lit lors de l’installation du schéma ; leSQL_DIRpar défaut est${DATADIR}/sql. Installe aussicontrib/hosters.txten tant que$(DATADIR)/hosters.txt, la liste des hébergeurs publics pour lesquelspepsi-whitelist import --auto-wildcardne 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, voirpepsi-keys blocklist update.)install-templatesCopie 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_DIRdes binaires est${DATADIR}/templateset 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-configInstalle le
pepsi.conf.samplede référence sous$(DESTDIR)$(SYSCONFDIR)/pepsi/. Ne crée jamaispepsi.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 depepsi-setup --wizard(un fichier existant n’est jamais modifié).install-config-dCopie
contrib/config.d/*.confvers$(DESTDIR)$(DATADIR)/config.d. Ce sont des valeurs par défaut livrées, et non des conffiles, et elles sont analysées avantpepsi.conf— voir Configuration. Un seul est livré avec Pepsi : les textes d’avis d’absence par langue. Si ce répertoire contient unthunderbird.conf, la cible le supprime : chaque fichier qui s’y trouve est analysé, et ce fichier positionneCRYPTO_ALLOW_DOWNGRADE = yespour tous les pairs, alors que l’enregistrement de capacités S/MIME décide pair par pair.install-man/install-infoInstalle les pages de manuel roff rendues sous
$(DESTDIR)$(MANDIR)/manNetpepsi.infosous$(DESTDIR)$(INFODIR)(enregistré auprès d”install-info). AvecBUILD_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-docInstalle
README.md,NEWS,SECURITY.md,AUTHORS,COPYINGet les textes de licence deLICENSES/sous$(DESTDIR)$(DOCDIR), qui vaut par défaut$(DATAROOTDIR)/doc/pepsi.install-systemdInstalle les unités systemd de
debian/systemd/dans$(DESTDIR)$(SYSTEMDUNITDIR)(en réécrivant/usr/binet/etc/pepsivers lesBINDIR/SYSCONFDIRconfigurés) ainsi que le fragmenttmpfiles.dqui donne à/run/pepsison 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 commeRuntimeDirectory(voir Aucune unité ne peut le revendiquer comme RuntimeDirectory). Tout est livré désactivé.make install INSTALL_ADMIN_UNITS=noomet les deux unitéspepsi-setup-apply, ce qui est l’équivalent, pour une installation depuis les sources, de ne pas installer le paquetpepsi-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 checkLe 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
pepsichecklocale, les tests de contrat des helpers setuid, le script d’interopérabilité de l’authentification,cargo deny check,cargo vet --lockedet 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 benchmarksLes scripts de pipeline en conditions réelles sous
tests/, qui nécessitent un SSH sans mot de passe vers les hôtes nommés dansACCOUNTS(par défauttests/test-accounts.ini, créé à partir detests/test-accounts.ini.sample) ;integrationtestsexé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 docsLe 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 etmake docs-allconstruit toutes les langues deDOC_LANGUAGES(en de fr) ;make htmlconstruit le seul HTML de chaque langue.make dist/make distcheckConstruire l’archive de version
pepsi-$(VERSION).tar.gz(tous les fichiers suivis, y compris le sous-module vendorisé, plusconfigureet la documentation pré-construite), et la vérifier en la dépaquetant dans une arborescence propre et en y exécutantconfigure,make,make check,make installetmake uninstallcontre un préfixe jetable. L’archive est copiée depuis l’arbre de travail :make distrefuse donc de s’exécuter tant qu’un fichier suivi diffère deHEADou que le sous-module n’est pas au commit enregistré dansHEAD(les fichiers non suivis ne comptent pas) ;make dist DIST_ALLOW_DIRTY=yesconstruit 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-signSigner 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 ouDIST_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 debConstruire les paquets Debian dans
target/debian/(Paquets Debian), non signés ;make deb DEB_SIGN_KEYID=<fingerprint>signe les fichiers.changeset.buildinfoavec cette clé.make clean/make distcleancleanexécutecargo cleanet supprime la documentation rendue ;distcleansupprime en outreconfig.mk,config.statuset tout ce qu’a produitmake 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) :
Créez les comptes système, chacun
--systemavec/usr/sbin/nologin, home/var/pepsiet un groupe privé du même nom, plus les groupes de contrôle d’accès.debian/pepsi.postinstest la liste faisant foi ; cette boucle en est la transpositionfor 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-whitelistest le compte vers lequel la CLI de liste blanche est setuid,pepsi-cryptoest le seul rôle de base de données à quicrypto_identity.private_wrappedest accordé et le propriétaire du fragment de chiffrement de clés,pepsi-keydiscest le rôle le plus étroit du déploiement (il analyse du matériel de clé récupéré sur l’internet ouvert),pepsi-configest le seul rôle autorisé à écrire la surcouche de configuration, etpepsi-greylistexécute le milter de greylisting, dont la socket appartient à son groupe. Si vous omettezpepsi-crypto,install-crypto-suidse contente d’avertir, et les deux étapes cryptographiques restent non privilégiées et incapables d’ouvrir la moindre clé privée.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éedebian/pepsi.postinst: chaque compte qui s’authentifie en tant que lui-même via la socket d’authentification par pair.pepsi-telemetryen fait partie même sur un nœud qui ne sert aucune télémétrie, carpepsi-setup runlui accorde des droits sur chaque hôte, etpepsi-setupeffectue son travail en base de données en tant quepepsi-owner, qui ne peut pas créer un rôle manquantfor 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
Exécutez
make installen tant queroot(ci-dessus) afin que les bits setuid/setgid soient appliqués ; sinon appliquez-les à la main selon Binaires privilégiés ci-dessous. Chaque cibleinstall-*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é.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-telemetryetpepsi-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/secretset/etc/pepsi/secrets.davec 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 etpepsi-quota), au relais smarthost setgid, aupepsi-whitelistsetuid et aux deux étapes setuidpepsi-crypto(voir Binaires privilégiés ci-dessous) ; etcré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éespepsi(possédée parpepsi-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/libet/etc/pepsiavec 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/runun lien vers/private/var/run. Si/runn’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-ingressetpepsi-httpdlient 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-setupredé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.envn’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-adminsous 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 avecpepsi-setupdans 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.tomlnomme la version exacte derustc;rustuputilise (et installe) celle-là dans cet arbre. Une chaîne de compilation qui n’est pas gérée parrustupignore le fichier, et un autre compilateur donne un autre binaire : utilisez doncrustuppour reproduire une version ;les crates —
Cargo.lockavec--locked, que passe chaque ciblemake;les chemins —
make buildfait correspondre la copie de travail, le répertoire cible (CARGO_TARGET_DIR, outarget/dans la copie de travail) et le cache de crates (CARGO_HOME, par défaut~/.cargo) aux noms fixes/build,/targetet/cargo, chacun sous son propre chemin et son chemin canonique, pourrustc(--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 = trueretire 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_EPOCHest exporté comme date du commit et c’est ce qu’utilisent les mtimes de l’archive et les dates de la documentation ; passezSOURCE_DATE_EPOCH=<seconds>pour le remplacer dans un arbre qui n’est pas une copie de travail git ;l’archive —
make distl’écrit avectar --sort=name --mtime=@$SOURCE_DATE_EPOCH --owner=0 --group=0 --numeric-owneretgzip -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-directet@vkspar 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 quepepsi-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 :
Lisez
NEWSpour la version. Il liste les options de configuration qui ont changé, et tout ce qui doit encore être fait à la main.Faites une sauvegarde (Sauvegarde et restauration), ou au moins activez le vidage automatique décrit plus bas.
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, puispepsi-setup -c /etc/pepsi/pepsi.conf schemaetsystemctl try-restart pepsi.target.Vérifiez avec
pepsi-statusque 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 |
Une nouvelle installation : |
plus ancien que ce programme |
|
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 |
fonctions stockées d’une autre compilation |
Compilations de développement uniquement : |
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 :
Installez la nouvelle version comme ci-dessus.
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 sousKEY_DIRet affiche les nouveaux enregistrements DKIM, avec les anciens enregistrementspepsietpepsi-ed25519en commentaires à retirer.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 statuset le courrier du démon au postmaster indiquent ce qui manque encore.Retirez les anciens enregistrements
pepsi._domainkeyetpepsi-ed25519._domainkeyune 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 |
|---|---|---|
|
|
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 |
|
|
Serveur HTTP/HTTPS (politique MTA-STS, Web Key Directory, portail de lien sécurisé et, sur les écouteurs d’administration, |
|
|
L’identité de travail du pipeline. Fait signer les messages par |
|
|
Pas un service d’exécution. Possède la base de données, le schéma, les tables et les fonctions |
|
service |
Utilisé uniquement lorsqu’un smarthost utilise |
|
|
Gardien du matériel de clé privée de bout en bout. Possède |
|
|
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 |
|
services |
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. |
|
|
Le seul rôle de base de données autorisé à écrire la surcouche |
|
service |
Le milter de greylisting. Son groupe est le groupe de sa socket |
|
service |
Gardien des clés privées DKIM et ARC, fichiers en 0600 dans son répertoire personnel |
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.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 |
|---|---|---|
|
|
Setuid root pour pouvoir écrire dans la boîte aux lettres de n’importe quel utilisateur local ; verrouillé au groupe afin que seul |
|
|
Setgid afin que le worker |
|
|
Même groupe et même raison : |
|
|
Setuid root pour pouvoir exécuter le |
|
|
Setgid afin que le worker |
|
|
Setuid root pour pouvoir descendre vers le compte propriétaire du wallet (ou vers l’uid propre du destinataire) afin d’exécuter |
|
|
Setgid afin que le worker |
|
|
Setgid afin que le worker |
|
|
Setuid, et exécutable par tout le monde à dessein : tout utilisateur local peut gérer son propre espace de noms |
|
|
Setuid, et non setgid : l’authentification par pair de PostgreSQL se fonde sur l”uid effectif, et |
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 |
|---|---|---|
|
|
Home du service. |
|
|
Les clés privées DKIM et ARC ( |
|
|
Le |
|
|
La socket de signature |
|
|
La socket |
|
|
Fichiers de jeton d’accès OAuth : écrits par le rafraîchisseur, lus par le relais smarthost via le groupe |
|
|
Jetons de rafraîchissement renouvelés privés ; jamais lisibles par le groupe. |
|
|
Les identifiants de rafraîchissement de jeton |
|
|
Les fragments que |
|
|
Certificat + clé client de TLS mutuel pour le relais smarthost ( |
|
|
Cache d’identifiants Kerberos pour les smarthosts |
|
|
Les sockets de soumission locale, d’administration, HTTP et de l’applicateur de configuration. Créé par l’extrait |
|
|
Home du compte |
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 |
Les scores de bounce |
Amont ne les importe pas non plus : le |
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 |
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.2. L’ordre recommandé¶
Procédez dans cet ordre. La raison est à l’étape 4.
Importer la configuration et la liste des membres, contre l’ancien serveur en fonctionnement
pepsi-list import mailman3 --rest http://localhost:8001 \ --user restadmin --password-file /etc/mailman3/rest.pw \ --report /root/mailman-import.txt
Ou, pour un site Mailman 2.1 dont le serveur est déjà éteint
pepsi-list import mailman21 --listdir /var/lib/mailman/lists \ --report /root/mailman-import.txt
Faites d’abord un
--dry-run: il lit tout, rapporte tout et n’écrit rien.Importer les archives, liste par liste
pepsi-archive import --list announce@lists.example.org \ --rejects /root/rejected.txt /var/lib/mailman/archives/private/announce.mbox/*.mbox
Les fils sont rattachés et renumérotés automatiquement à la fin. Sinon, un import en désordre les laisserait scindés ; c’est l’erreur que cette commande est conçue pour ne pas répéter.
Vérifier.
pepsi-list check --strict, puis recouper les réglages de quelques listes avec l’ancien serveur. Par REST, les deux extrémités répondent à/3.1/lists/<id>/config: la comparaison se fait donc attribut par attribut et non à l’œil.Chauffer l’IP avec la campagne d’invitations, pendant que l’ancien serveur remet encore le courrier.
pepsi-list invite send --dry-run # the per-domain histogram pepsi-list invite send --rate 200 --limit 500 pepsi-list invite status
C’est l’étape dont le moment importe. Dire à chaque membre de choisir un mot de passe est le plus gros envoi unique que ce serveur fera jamais. Il part vers une liste d’adresses que le serveur n’a jamais validée, depuis une adresse IP sans réputation, et c’est ainsi que la réputation d’un nouveau déploiement est détruite le premier jour. Si vous le faites avant la bascule du MX, un problème de limitation ou de blocage devient visible pendant que le nouveau serveur n’achemine pas encore le courrier.
L’histogramme de la simulation est un outil de délivrabilité et non une barre de progression : un fournisseur détenant quarante pour cent d’un site migré est le fait qui décide du rythme, et il reste invisible tant que rien ne le compte. Les invitations valent quatre semaines, la campagne reprend là où elle s’est arrêtée, et personne n’est désabonné pour n’avoir pas répondu : un membre qui n’agit jamais conserve son abonnement et ne peut simplement pas se connecter jusqu’à ce qu’il utilise le lien ou en demande un autre.
Basculer le MX, et seulement ensuite arrêter l’ancien serveur.
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.