4. Installation

Pepsi kann auf zwei Arten installiert werden. Das Bauen aus dem Quellcode aus dem Cargo-Workspace liefert Ihnen die Binärprogramme und überlässt es Ihnen, die Dienstkonten anzulegen, die Privilegien-Bits zu setzen und die Laufzeitverzeichnisse einzurichten. Das vorgefertigte Debian-Paket erledigt all das für Sie: Sein postinst legt die Konten, Gruppen, Verzeichnisse, Overrides für privilegierte Binärprogramme und die Datenbank an. Dann bleibt nur noch der standortspezifische Bootstrap zu tun (die Konfiguration bearbeiten und pepsi-setup ausführen).

Wählen Sie den Tab für die Methode, die Sie verwenden. Alles danach ist für beide gleich: die Einrichtung von Schema, Schlüsseln und DNS, der Betrieb der Dienste, das Privilegienmodell und der Schema-Lebenszyklus.

4.1. Voraussetzungen

  • PostgreSQL — eine Datenbank, in die Pepsi das einzige pepsi-Schema installiert. Alle Komponenten verbinden sich mit derselben Datenbank. (Das Debian-Paket hat postgresql als Depends und zieht es für Sie mit herein.)

  • PostgreSQLs postgresql-contrib – optional und nur für Mailinglisten. Es bringt die Erweiterung pg_trgm mit, die das Mailinglisten-Archiv für die Teilzeichenfolgen- und Fuzzy-Suche benutzt: einen Hostnamen, einen Konfigurationsschlüssel, eine Zeile aus einem Traceback oder einen Namen zu finden, den der Suchende falsch geschrieben hat. Ein Stammform-Wörterbuch wirft genau dieses Material weg, die Volltextsuche kann diese Anfragen daher überhaupt nicht beantworten.

    Ein Server ohne es installiert und läuft normal. Die Erweiterung wird in einem abgesicherten Block erzeugt, ihr Fehlen ist daher eine Warnung und keine gescheiterte Installation; das Archiv hat dann nur Volltextsuche, und pepsi-list check sagt, in welchem Modus der Server ist. Es später zu installieren und pepsi-setup run erneut auszuführen schaltet es ein, danach braucht das bestehende Archiv ein pepsi-archive reindex, um die Spalte zu füllen, die der Index liest.

    Das Debian-Paket führt es unter Recommends, ein voreingestelltes apt install zieht es also mit, und ein Server, der keine Listen betreibt, kann es entfernen.

  • Für echten Mail-Verkehr: öffentliches DNS, das Sie für jede bediente Domain kontrollieren (um DKIM-, SPF- und MTA-STS-Einträge zu veröffentlichen), und die Fähigkeit, den privilegierten SMTP-Port 25 (und 465/587 für Submission) zu binden. Ein Entwicklungs-Build kann vollständig auf unprivilegierten Ports und einer Wegwerf-Datenbank laufen.

  • Ein DNSSEC-validierender Resolver, idealerweise Ihr eigener auf diesem Host. Die DNS-Einrichtung liegt außerhalb des Aufgabenbereichs von Pepsi: Pepsi validiert DNSSEC nicht selbst, sondern vertraut dem AD-Bit des Resolvers, der ihm angegeben ist (/etc/resolv.conf, [pepsi] DNS_SERVERS oder DNS_SERVERS einer Stage), und DANE sowie die DNSSEC-abhängige Schlüsselentdeckung beruhen auf diesem Bit. Betreiben Sie Ihren eigenen validierenden rekursiven Resolver auf dem Host, zum Beispiel unbound (apt install unbound, dann nameserver 127.0.0.1 in resolv.conf) oder systemd-resolved mit DNSSEC=yes. Wo das nicht möglich ist, geben Sie in [pepsi] DNS_SERVERS einen validierenden Resolver, dem Sie vertrauen, als DNS over TLS (tls://192.0.2.53#dns.example.net) oder DNS over HTTPS (https://192.0.2.53/dns-query#dns.example.net) an: Der Kanal wird dann durch das Zertifikat des Resolvers authentifiziert, sodass niemand auf dem Weg das AD-Bit fälschen kann, und jedes Pepsi-Programm nutzt ihn (siehe pepsi.conf(5)). Ein Resolver, der über einfaches DNS über ein Netzwerk erreicht wird, ist ein Vertrauen, das Sie seinem Betreiber und dem Weg dorthin entgegenbringen; pepsi-setup nennt bei jedem Lauf jeden solchen Resolver mit seiner IP-Adresse und verweigert nichts. In jedem Fall entscheidet der Betreiber des Resolvers, was als validiert gilt. pepsi-status zeigt in seinem Abschnitt „DNSSEC resolver“, ob der verwendete Resolver validiert; die DANE-Worker protokollieren beim Start eine Warnung, wenn er es nicht tut.

4.2. Pepsi installieren

Bauen Sie den Workspace, platzieren Sie die Binärprogramme und das SQL mit make install und legen Sie die Systemkonten und Privilegien selbst an (dieselben, die das Paket anlegen würde; siehe Benutzer, Gruppen und Privilegien unten).

Zusätzliche Voraussetzungen

  • Eine Rust-Toolchain mit rustc 1.95 oder neuer (die Untergrenze legt das mitgelieferte taler-common fest; ./configure warnt bei einer älteren), dazu die nativen Build-Abhängigkeiten der Krypto- und Kerberos-Crates: pkg-config, cmake, libclang, nettle, GMP und die Kerberos-Entwicklungsheader (unter Debian: libclang-dev, nettle-dev, libgmp-dev, libkrb5-dev).

  • Das mitgelieferte GNU-Taler-Rust-Submodul, das vor dem ersten Build geholt wird:

    git submodule update --init --recursive
    

Bauen

Pepsi ist ein Cargo-Workspace, dessen Root-Paket (pepsi) jedes Binärprogramm unter src/bin/ besitzt; die pepsi-*-Member-Crates sind Bibliotheken, die die dünnen Binärprogramme aufrufen. Ein Entwicklungs-Build erzeugt eine ausführbare Datei pro Programm:

cargo build --workspace

Ein Release-Build hingegen verlinkt die meisten Programme zu einem einzigen Multi-Call-Binärprogramm pepsi, das das auszuführende Programm anhand des Namens auswählt, unter dem es aufgerufen wird (argv[0]). Dies wird durch das Cargo-Feature unibin ausgewählt (das das make build-Ziel für Sie aktiviert); das Standard-Feature multibin behält die programmweisen Binärprogramme bei, die für Entwicklung und Testsuite verwendet werden:

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

So oder so führen Sie die programmweisen Namen aus; das Release-Layout installiert sie als Symlinks auf das eine Binärprogramm (siehe Installieren). Einige Programme werden nicht eingefaltet und bleiben eigenständig; die maßgebliche Liste ist STANDALONE_BINARIES im Makefile. Zwei Gründe bringen ein Programm dorthin:

  • es trägt sein eigenes setuid- oder setgid-Bit, was ein gemeinsames Binärprogramm nicht je Programm kann, oder eine Site kann ihm eines geben (pepsi-keys). Das betrifft die Helper für lokale Zustellung, ~/.forward und Wallet und ihre aufrufenden Stages, das Smarthost-Relay, pepsi-quota, pepsi-whitelist sowie pepsi-stage-encrypt und pepsi-stage-decrypt (beide setuid pepsi-crypto, damit sie das private Schlüsselmaterial erreichen können);

  • es wird separat ausgerollt oder aufgerufen: pepsi-setup, pepsi-config, pepsi-stage-detect-language (dessen Sprachmodelle groß sind; dieses Binärprogramm ist selbst multi-call, und ein zweiter $PATH-Symlink, pepsi-detect-language, führt das Offline-Diagnosewerkzeug daraus aus), pepsi-telemetry (das in einem eigenen Paket ausgeliefert wird und auf einem separaten Host läuft) und pepsi-helper-mailbox-scan (das pepsi-whitelist über seinen Namen ausführt).

Die Programme, auf die sich dieses Kapitel bezieht, sind unten aufgeführt. Dies ist eine Auswahl, kein Inventar: Die maßgeblichen Listen sind FOLDED_BINARIES und STANDALONE_BINARIES im Makefile (BINARIES wird aus diesen beiden abgeleitet und ist selbst nicht bearbeitbar).

  • pepsi-ingress — eingehender SMTP-Server

  • pepsi-dispatch — Stage-Dispatcher

  • 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 — die Stages

  • pepsi-setup — Einrichtung/Bootstrap

  • pepsi-queue — Inspektion/Reparatur der Warteschlange

  • pepsi-status — Gesundheitszusammenfassung der Pipeline

  • pepsi-reputation — IP-Sperrlisten für eingehende Mail

  • pepsi-sendmail — lokale Submission (vom Debian-Paket als /usr/sbin/sendmail installiert)

Die Qualitätsschranken, die das Projekt grün hält, sind:

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 benötigt ein erreichbares PostgreSQL, weil die Crate für den Dispatcher-Lebenszyklus den echten Dispatcher gegen eine Datenbank startet. make check ist der Einstiegspunkt, der das absichert: Er überspringt diese Suite, statt fehlzuschlagen, wenn keine Datenbank nutzbar ist. Er führt außerdem cargo deny check und cargo vet --locked aus (den Prüfnachweis der Abhängigkeiten, supply-chain/; siehe Die Lieferkette); siehe Weitere make-Ziele unten.

Installieren

Ein bloßer Build erzeugt nur Binärprogramme; Pepsi liefert außerdem SQL-Migrationen und eine Beispielkonfiguration, die auf der Platte abgelegt werden müssen. Das Makefile umschließt beides. Führen Sie es als root aus, damit es auch die Privilegien-Bits der Binärprogramme setzen kann; andernfalls gibt es die genauen chown/chmod aus, die Sie von Hand ausführen müssen:

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

Besser noch: Führen Sie zuerst ./configure aus und lassen Sie es die Verzeichnisvariablen in config.mk auflösen (das das Makefile vor seinen eigenen Standardwerten liest, sodass gilt, was configure entschieden hat). Jedes Verzeichnis leitet sich von --prefix ab. Geben Sie also nur ein Präfix an, verschiebt das die gesamte Installation darunter: Binärprogramme, SQL, config.d-Standardwerte und Nachrichtenvorlagen:

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

--sysconfdir ist die eine Ausnahme, denn eine Konfigurationsdatei muss dort liegen, wo das System sie sucht: Es ist /etc, wenn kein --prefix angegeben wurde (und auch, wenn --prefix=/usr angegeben wurde, da /usr/etc auf keinem System existiert), und sonst $(PREFIX)/etc. Geben Sie --sysconfdir ausdrücklich an, um es in beide Richtungen zu überschreiben.

./configure --help listet alles auf, was es akzeptiert. Neben den GNU-Verzeichnisvariablen (--prefix, --exec-prefix, --bindir, --sbindir, --libexecdir, --sysconfdir, --datarootdir, --datadir, --mandir, --infodir, --docdir) nimmt es entgegen:

--with-templatedir=DIR

Wohin die Nachrichtenvorlagen kommen; muss mit [pepsi] TEMPLATE_DIR übereinstimmen. Standardwert ist $(DATADIR)/templates.

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

Die Unit-Dateien, das tmpfiles.d-Schnipsel, die udev-Regel, die eine Änderung der Generation-ID einer virtuellen Maschine festhält (siehe Geklonte und wiederhergestellte virtuelle Maschinen), und der Ort, an den der überkommene Link /usr/lib/sendmail kommt.

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

Die lokalen Namen der Konten und Gruppen, die die privilegierten Binärprogramme absichern (siehe Privilegierte Binärprogramme unten). Standardwerte sind pepsi-maildir, pepsi-forward, pepsi-wallets, pepsi-token, pepsi, pepsi-crypto und pepsi-whitelist.

--enable-docs / --disable-docs

Ob die Man-Pages und das Info-Handbuch aus den Quellen gerendert oder vorgebaut übernommen werden (was ein Release-Tarball mitliefert). Standardwert ist auto: an, wenn sphinx-build, makeinfo und Python mit docutils allesamt vorhanden sind.

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

Ob make install /usr/sbin/sendmail und den Rest der Debian-Schnittstelle für Mail-Transport-Agents beansprucht. Standardmäßig aus, sodass eine Quellinstallation den vorhandenen MTA des Systems nicht stillschweigend verdrängen kann; das Debian-Paket übergibt INSTALL_MTA_LINKS=yes, weil sein Conflicts: mail-transport-agent die Ausschließlichkeit bereits garantiert.

--with-taler-wallet-cli=PATH

Das einzige Wallet-Programm, das der setuid-Helfer pepsi-helper-auto-pay ausführt, beim Bauen festgelegt (Standard /usr/bin/taler-wallet-cli, wo die GNU-Taler-Pakete es installieren). Es wird nie aus der Befehlszeile, der Umgebung oder der Konfiguration übernommen, weil der Aufrufer des Helfers weniger privilegiert ist als jedes Konto, zu dem der Helfer werden kann.

--with-crypto-backend=FEATURE

Die Kryptobibliothek hinter OpenPGP (Sequoias Backend), ausgewählt per Cargo-Feature. Genau eine wird eingebaut; FEATURE ist eines von:

crypto-nettle (der Standard)

Nettle mit seiner Public-Key-Hälfte hogweed und GMP, dynamisch aus dem System gelinkt (Debian: nettle-dev, libgmp-dev). Nettle hat keine Post-Quanten-Algorithmen. Es muss Nettle 3 sein: Die Bindings lassen sich nicht gegen Nettle 4 bauen, das nettle/pgp.h entfernt hat; auf einem System, das Nettle 4 mitbringt (etwa Homebrew), wählen Sie daher crypto-openssl.

crypto-openssl

OpenSSLs libcrypto, dynamisch aus dem System gelinkt (Debian: libssl-dev). Dies ist das Backend für Post-Quanten-OpenPGP: Nur es, und nur mit OpenSSL 3.5 oder neuer, kann Nachrichten an ML-KEM-768+X25519-Schlüssel entschlüsseln und ML-DSA-65+Ed25519-Signaturen verarbeiten (siehe Herkömmliche Public-Key-Algorithmen werden von Quantencomputern gebrochen).

Jeder andere Wert wird abgelehnt. Die Wahl betrifft nur OpenPGP: TLS, S/MIME, DKIM und ARC verwenden mit beiden Backends AWS-LC, und kein Programm linkt OpenSSL für TLS (OpenPGP). Ohne configure lautet dieselbe Wahl make build CRYPTO_BACKEND=crypto-openssl.

--jobs=N

Wie viele Compiler-Jobs Cargo gleichzeitig ausführt. Von sich aus startet Cargo einen Job pro CPU, unabhängig vom Speicher, und einer Maschine mit vielen Kernen und wenig RAM geht dann gegen Ende des Builds der Speicher aus. Daher entscheidet standardmäßig (auto) contrib/build-jobs.sh unmittelbar vor jedem Cargo-Befehl. Das Skript erlaubt einen Job pro CPU, aber nur so viele, wie der in diesem Moment freie Speicher fassen kann, und lässt einen großzügigen Spielraum für andere Programme und für künftiges Wachstum des Builds. Der größte Job des Release-Builds braucht etwa 5 GB und jeder weitere bis zu 2,7 GB; der Release-Build läuft daher mit einem Job, wenn 16 GB frei sind, mit zwei bei 18 GB und mit vier bei 32 GB freiem Speicher. Der Test-Build (make check) braucht pro Job etwas weniger. N legt die Zahl stattdessen fest. Ohne configure bewirkt CARGO_BUILD_JOBS=N in der Umgebung oder auf der make-Befehlszeile dasselbe. make -jN erhöht die Zahl nicht, begrenzt sie aber auf N, und der Debian-Build übernimmt diese Grenze aus DEB_BUILD_OPTIONS=parallel=N.

CARGO=, INSTALL=, SPHINXBUILD=, MAKEINFO=, INSTALL_INFO=, RST2MAN= und PYTHON= werden als VAR=VALUE-Argumente oder aus der Umgebung akzeptiert. Optionen, für die dieser Build keine Verwendung hat (--libdir, --localstatedir, --build, --host, …), werden akzeptiert und ignoriert, sodass ein generischer Paketierungstreiber das Skript unverändert aufrufen kann; nur ein fehlendes cargo ist ein harter Fehler.

make install führt die folgenden Schritte aus:

install-bin

Baut das (vereinheitlichte) Release-Binärprogramm und installiert es nach $(DESTDIR)$(PREFIX)/libexec/pepsi/pepsi, erstellt dann einen $(DESTDIR)$(PREFIX)/bin-Symlink pro eingefaltetem Programmnamen, der darauf zeigt (z. B. pepsi-ingress -> ../libexec/pepsi/pepsi). Die siebzehn eigenständigen Programme, die in STANDALONE_BINARIES im Makefile genannt sind, werden als eigene ausführbare Dateien in $(DESTDIR)$(PREFIX)/bin installiert. Weil jeder Symlink weiterhin in $(PREFIX)/bin (auf $PATH) liegt, ist die Laufzeit-Herleitung von DATADIR unten davon unberührt.

install-data

Kopiert die SQL-Dateien von pepsi-setup/db/ nach $(DESTDIR)$(DATADIR)/sql (wobei DATADIR = $(PREFIX)/share/pepsi). pepsi-setup liest diese beim Installieren des Schemas; der Standardwert von SQL_DIR ist ${DATADIR}/sql. Installiert außerdem contrib/hosters.txt als $(DATADIR)/hosters.txt, die Liste öffentlicher Hoster, für die pepsi-whitelist import --auto-wildcard nie einen Platzhalter vorschlägt. (Die Liste bekanntermaßen kompromittierter Schlüssel, gegen die jeder Peer-Schlüssel geprüft wird, wird nicht installiert: Jede Installation lädt sie in ihre Datenbank, siehe pepsi-keys blocklist update.)

install-templates

Kopiert die Nachrichtenvorlagen (<name>.<lang>.body — die Zahlungsaufforderung des Anti-Spam, die Bounce-Nachrichtentexte, die Mailinglisten-Hinweise und die übrigen automatischen Antworten) nach $(DESTDIR)$(TEMPLATEDIR), das standardmäßig $(DATADIR)/templates ist. Der Standardwert [pepsi] TEMPLATE_DIR der Binärprogramme ist ${DATADIR}/templates und wird über dieselbe Laufzeitableitung aufgelöst, sodass beide Enden unter jedem Präfix übereinstimmen, ohne dass die Konfiguration einen Pfad nennt.

install-config

Installiert die Referenzdatei pepsi.conf.sample unter $(DESTDIR)$(SYSCONFDIR)/pepsi/. Sie legt nie eine pepsi.conf an: Die Vorlage bindet optionale Stages ein, die weitere Einrichtung brauchen, und ist keine funktionierende Konfiguration; die produktive Datei kommt daher von pepsi-setup --wizard (eine vorhandene wird nie angefasst).

install-config-d

Kopiert contrib/config.d/*.conf nach $(DESTDIR)$(DATADIR)/config.d. Dies sind paketierte Standardwerte, keine conffiles, und sie werden vor pepsi.conf geparst — siehe Konfiguration. Eine wird mit Pepsi ausgeliefert: die Texte der Abwesenheitsnotiz je Sprache. Liegt in diesem Verzeichnis eine thunderbird.conf, löscht das Ziel sie: Jede Datei dort wird geparst, und diese Datei setzt CRYPTO_ALLOW_DOWNGRADE = yes für jeden Peer, während der S/MIME-Fähigkeitseintrag je Peer entscheidet.

install-man / install-info

Installiert die gerenderten roff-Handbuchseiten unter $(DESTDIR)$(MANDIR)/manN und pepsi.info unter $(DESTDIR)$(INFODIR) (mit install-info registriert). Mit BUILD_DOCS=no — was ./configure --disable-docs setzt und was ein Release-Tarball verwendet — werden vorgefertigte Seiten installiert, statt sie zu rendern, und jeder Schritt wird mit einer Meldung übersprungen, wenn keine vorhanden sind.

install-doc

Installiert README.md, NEWS, SECURITY.md, AUTHORS, COPYING und die Lizenztexte aus LICENSES/ unter $(DESTDIR)$(DOCDIR), standardmäßig $(DATAROOTDIR)/doc/pepsi.

install-systemd

Installiert die systemd-Units aus debian/systemd/ in $(DESTDIR)$(SYSTEMDUNITDIR) (wobei /usr/bin und /etc/pepsi auf die konfigurierten BINDIR/SYSCONFDIR umgeschrieben werden) sowie das tmpfiles.d-Bruchstück, das /run/pepsi seinen Eigentümer und seine ACL gibt. Dieses Bruchstück ist die einzige Quelle der Rechte dieses Verzeichnisses, denn keine Unit darf es als RuntimeDirectory deklarieren (siehe Keine Unit darf es als RuntimeDirectory beanspruchen). Alles wird deaktiviert ausgeliefert. make install INSTALL_ADMIN_UNITS=no lässt die beiden pepsi-setup-apply-Units weg, was dem Nichtinstallieren des Pakets pepsi-httpd-admin bei einer Quellinstallation entspricht.

Zusätzlich hängt install von den Zielen für die Privilegien-Bits ab (install-helper, install-maildir-stage, install-forward-*, install-auto-pay-*, install-smarthost-stage, install-whitelist-suid, install-crypto-suid, install-quota-tool), die unten unter Privilegierte Binärprogramme beschrieben sind; jedes gibt das von Hand auszuführende chown/ chmod aus, wenn es nicht als Root läuft oder wenn die Gruppe, die es braucht, nicht existiert.

Überschreiben Sie PREFIX, SYSCONFDIR und DESTDIR passend zum Zielsystem. make uninstall entfernt alles, was make install abgelegt hat (immer einschließlich beider pepsi-setup-apply-Units, unabhängig von INSTALL_ADMIN_UNITS), lässt aber die aktive pepsi.conf an Ort und Stelle.

Weitere make-Ziele

make check

Der Test-Einstiegspunkt, der keine entfernten Konten benötigt. Er führt die Datei-Gegenprüfungen der systemd-Units, des Telemetrie-Socket-Pfads, der Versionsnummern und der beiden Mail-Client-Erweiterungen aus, dazu die Workspace-Tests (ohne die Crate für den Dispatcher-Lebenszyklus, die PostgreSQL benötigt). Danach führt er nach bestem Bemühen die Lebenszyklus-Suite gegen eine lokale pepsicheck-Datenbank aus, die Vertragstests der setuid-Helfer, das Skript zur Authentifizierungs-Interoperabilität, cargo deny check, cargo vet --locked und die Querverweisprüfung des Handbuchs. Jeder dieser Schritte wird übersprungen statt als Fehler gewertet, wenn seine Voraussetzung fehlt.

make integrationtests / make benchmarks

Die Live-Pipeline-Skripte unter tests/, die passwortloses SSH zu den in ACCOUNTS genannten Hosts benötigen (Standardwert tests/test-accounts.ini, angelegt aus tests/test-accounts.ini.sample); integrationtests führt zuerst die Thunderbird-Interoperabilitätsschranke aus. Die Benchmarks sind ein eigenes Ziel, weil sie den MTA absichtlich belasten.

make docs

Das Handbuch für die Quellsprache. Es ist ein Alias für make docs-en, das dessen HTML und dessen PDF baut, dazu die Man-Pages und das Info-Handbuch (beide nur in der Quellsprache). make docs-<lang> baut eine andere Sprache und make docs-all baut jede Sprache in DOC_LANGUAGES (en de fr); make html baut allein das HTML jeder Sprache.

make dist / make distcheck

Bauen den Release-Tarball pepsi-$(VERSION).tar.gz (jede versionierte Datei einschließlich des mitgelieferten Submoduls, dazu configure und vorgebaute Dokumentation) und prüfen ihn, indem sie ihn in einen sauberen Baum entpacken und configure, make, make check, make install und make uninstall gegen ein Wegwerf-Präfix ausführen. Der Tarball wird aus dem Arbeitsbaum kopiert; deshalb verweigert make dist die Arbeit, solange eine versionierte Datei von HEAD abweicht oder das Submodul nicht auf dem in HEAD verzeichneten Commit steht (unversionierte Dateien zählen nicht); make dist DIST_ALLOW_DIRTY=yes baut trotzdem einen Entwicklungs-Tarball. Der Tarball ist reproduzierbar: Einträge sortiert, jede mtime das Datum des Commits (SOURCE_DATE_EPOCH), numerische uid 0, kein gzip-Zeitstempel.

make dist-sign

Signiert einen vorhandenen Release-Tarball: eine abgetrennte, ASCII-armierte OpenPGP-Signatur pepsi-$(VERSION).tar.gz.asc mit dem Standardschlüssel von gpg oder DIST_SIGN_KEYID, die geprüft wird, bevor das Ziel erfolgreich endet. Siehe Einen Download prüfen für die Seite der Benutzer und Ein Release erstellen für die Schlüssel.

make deb

Baut die Debian-Pakete nach target/debian/ (Debian-Pakete), unsigniert; make deb DEB_SIGN_KEYID=<fingerprint> signiert die Dateien .changes und .buildinfo mit diesem Schlüssel.

make clean / make distclean

clean führt cargo clean aus und entfernt die gerenderte Dokumentation; distclean entfernt zusätzlich config.mk, config.status und alles, was make dist erzeugt hat.

Bemerkung

DATADIR muss mit dem übereinstimmen, was die Binärprogramme zur Laufzeit berechnen: taler-common leitet ${DATADIR} als <install-prefix>/share/pepsi aus dem Speicherort des Binärprogramms selbst ab. Wenn Sie aus einem Quellcode-Checkout (nicht installiert) ausführen, setzen Sie [pepsi-postgres] SQL_DIR explizit, damit pepsi-setup die Migrationen findet.

Das System vorbereiten

Das postinst des Debian-Pakets führt die folgenden Schritte automatisch aus; bei einer Quellcode-Installation führen Sie sie selbst aus und verwenden dabei das gleiche Konto-, Gruppen-, Modus- und Verzeichnis-Layout, das unten unter Benutzer, Gruppen und Privilegien und Verzeichnisse und Geheimnisse dokumentiert ist. Legen Sie die Konten und Gruppen vor make install an (damit es die Privilegien-Bits setzen kann) und die Datenbankrollen vor pepsi-setup (das das Schema installiert):

  1. Legen Sie die Systemkonten an, jedes --system mit /usr/sbin/nologin und Home /var/pepsi und einer privaten Gruppe gleichen Namens, dazu die absichernden Gruppen. debian/pepsi.postinst ist die maßgebliche Liste; diese Schleife ist genau sie, übersetzt:

    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
    

    Jedes der letzten fünf Konten existiert, weil etwas ohne es nicht arbeiten will: pepsi-whitelist ist das Konto, auf das das CLI für weiße Listen setuid ist, pepsi-crypto ist die einzige Datenbankrolle, der crypto_identity.private_wrapped gewährt ist, und der Eigentümer des Fragments mit dem Schlüsselverschlüsselungsschlüssel, pepsi-keydisc ist die engste Rolle der Installation (sie parst Schlüsselmaterial, das aus dem offenen Internet geholt wurde), pepsi-config ist die einzige Rolle, die die Konfigurationsüberlagerung schreiben darf, und pepsi-greylist führt den Greylisting-Milter aus, dessen Socket seine Gruppe gehört. Wenn Sie pepsi-crypto auslassen, warnt install-crypto-suid lediglich, und die beiden Krypto-Stages bleiben unprivilegiert und können keinen einzigen privaten Schlüssel öffnen.

  2. Legen Sie die zehn PostgreSQL-Login-Rollen und die Datenbank an (Peer-Authentifizierung, als postgres-Superuser). Das ist dieselbe Menge, die debian/pepsi.postinst anlegt: jedes Konto, das sich über den Peer-Authentifizierungs-Socket als es selbst authentifiziert. pepsi-telemetry gehört auch auf einem Knoten dazu, der keine Telemetrie bedient. Denn pepsi-setup run vergibt ihm auf jedem Host Rechte, und pepsi-setup erledigt seine Datenbankarbeit als pepsi-owner, das eine fehlende Rolle nicht anlegen kann:

    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. Führen Sie make install als root aus (siehe oben), damit die setuid/setgid-Bits gesetzt werden; andernfalls setzen Sie sie von Hand gemäß Privilegierte Binärprogramme unten. Jedes install-*-Ziel warnt nur, wenn die Gruppe fehlt, die es braucht. Ein oben ausgelassenes Konto oder eine ausgelassene Gruppe lässt das entsprechende Programm also stillschweigend unprivilegiert.

  4. Legen Sie die Laufzeitverzeichnisse mit den unter Verzeichnisse und Geheimnisse aufgeführten Eigentümern und Modi an. Legen Sie die Smarthost-Geheimnis-Verzeichnisse nur an, wenn Sie einen Smarthost konfigurieren, der sie nutzt.

Das Paket ist der einfachere Weg: Es liefert die Binärprogramme (installiert nach /usr/bin), das SQL-Schema, die Nachrichtenvorlagen, die Handbuchseiten, das GNU-Info-Handbuch und socket-aktivierte systemd-Units, und sein postinst richtet das gesamte System für Sie ein.

Das Paket bauen

Führen Sie in einem Checkout (mit initialisiertem Submodul vendor/taler-rust) und mit den in debian/control aufgeführten Build-Abhängigkeiten installiert Folgendes aus:

make deb

Das kopiert den Arbeitsbaum (einschließlich nicht committeter Änderungen und neuer Dateien, die git nicht ignoriert) nach target/debian/pepsi-<version>/ und führt dort dpkg-buildpackage -b -us -uc aus (überschreibbar mit DEB_BUILD_FLAGS, z. B. DEB_BUILD_FLAGS=, um auch das Quellpaket zu bauen und zu signieren). Dabei wird der Release-Build kompiliert, und die .deb-Dateien werden nach target/debian/ geschrieben (DEB_BUILDDIR wählt ein anderes Verzeichnis): pepsi, pepsi-httpd-admin, pepsi-telemetry und pepsi-stage-detect-language. dpkg-buildpackage schreibt seine Ergebnisse immer neben das Quellverzeichnis; deshalb läuft der Build nicht im Checkout selbst.

Das Paket installieren

Installieren Sie das .deb mit apt, damit seine Abhängigkeiten (einschließlich postgresql) mit hereingezogen werden:

apt install ./pepsi_*.deb

Bei configure führt das postinst automatisch:

  • legt die elf Dienstkonten und die sechs absichernden Gruppen an (pepsi-maildir, pepsi-forward, pepsi-token, pepsi-admin, pepsi-telemetry und pepsi-wallets), samt den Mitgliedschaften zwischen ihnen; das sind dieselben Identitäten, die die Quellcode-Installation von Hand erstellt;

  • legt die /var/pepsi-Laufzeitverzeichnisse (keys, tokens, token-refresh, tls, krb5) sowie /etc/pepsi/secrets und /etc/pepsi/secrets.d mit den unter Verzeichnisse und Geheimnisse unten dokumentierten Eigentümern und Modi an;

  • setzt die Privilegien-Bits der Binärprogramme über dpkg-statoverride: bei den drei setuid-root-Helfern, bei den setgid-Programmen, die sie ausführen dürfen (die beiden Zustell-Stages, die Wallet-Stage und pepsi-quota), beim setgid-Smarthost-Relay, beim setuid pepsi-whitelist und bei den beiden setuid-pepsi-crypto-Stages (siehe Privilegierte Binärprogramme unten); und

  • legt nach bestem Bemühen die zehn PostgreSQL-Login-Rollen (pepsi-owner, pepsi, pepsi-ingress, pepsi-httpd, pepsi-whitelist, pepsi-config, pepsi-crypto, pepsi-keydisc, pepsi-telemetry, pepsi-greylist) und die pepsi-Datenbank (im Besitz von pepsi-owner) an, wenn ein lokaler Cluster erreichbar ist, und gibt andernfalls die von Hand anzulegenden Rollen aus.

Der Dienst wird deaktiviert ausgeliefert: Das Paket installiert Pepsi, startet es aber nicht, und überlässt Ihnen den standortspezifischen Bootstrap.

Bemerkung

pepsi ist eines von vier Binärpaketen, die aus dieser Quelle gebaut werden: Die Spracherkennungs-Stage und der Telemetrie-Collector sind aus Größen- und Installationsgründen abgetrennt. pepsi-httpd-admin, das pepsi Recommends und das apt daher standardmäßig installiert, trägt den einzigen Mechanismus, mit dem die Browser-Konsole auf diesem Host eine privilegierte Änderung bewirken kann. Dieses eine Paket zu entfernen ist ein unterstützter Härtungsschritt für eine Installation, die vom Terminal aus verwaltet wird. Debian-Pakete beschreibt jedes Paket und diesen Hebel vollständig.

Nachdem das Paket installiert ist

Bei der Erstinstallation kopiert das Paket eine Platzhalter-Konfiguration nach /etc/pepsi/pepsi.conf; spätere Upgrades rühren diese Datei nie an (sie ist keine dpkg-Conffile, sodass ein Upgrade nie anhält, um danach zu fragen). Bearbeiten Sie sie und führen Sie dann den Bootstrap genau wie in den gemeinsamen Schritten unten aus — zum Beispiel:

# 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

Da die Units socket-aktiviert sind, fährt pepsi.target pepsi-ingress, pepsi-httpd, pepsi-dkim und pepsi-dispatch gemeinsam hoch; Sie rufen die serve-Unterbefehle nicht von Hand auf.

macOS ist noch kein unterstütztes Einsatzziel: Das Paket wurde noch auf keinem Testsystem als root installiert, und docs/ROADMAP.md führt auf, was sich noch von Linux unterscheidet. Das Paket installiert die Programme unter /usr/local (/usr auf dem Systemvolume ist schreibgeschützt) und die Konfiguration wie unter Linux in /etc/pepsi. Statt systemd-Units installiert es launchd-Jobs in /Library/LaunchDaemons (net.taler.pepsi.*), einen Job pro Unit, und seine Skripte tun, was das Debian-postinst tut.

Das Paket bauen

Führen Sie auf einem Mac mit den Xcode-Kommandozeilenwerkzeugen, einer Rust-Toolchain und den unter Aus dem Quellcode aufgeführten nativen Bibliotheken (Nettle 3, nicht 4, oder CRYPTO_BACKEND=crypto-openssl) aus:

make macos-pkg

Das kompiliert den Release-Build, stellt ihn mit dem macOS-Layout bereit und schreibt mit Apples pkgbuild und productbuild die Datei target/macos/pepsi-<version>-<arch>.pkg. Um das Paket zu signieren, nennen Sie in MACOS_PKG_SIGN_IDENTITY ein „Developer ID Installer“-Zertifikat aus Ihrem Schlüsselbund; ein unsigniertes Paket installieren Sie mit:

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

Was die Installation tut

  • Sie legt dieselben Dienstkonten, Gruppen und Mitgliedschaften an wie das Debian-Paket, als versteckte Systemkonten mit IDs ab 400.

  • Sie legt die Verzeichnisse unter /var/pepsi, /var/lib und /etc/pepsi mit denselben Eigentümern und Modi an.

  • Sie setzt dieselben setuid- und setgid-Bits auf den privilegierten Programmen.

  • Sie trägt /run in /etc/synthetic.conf ein, wodurch /run ein Link auf /private/var/run wird. Erscheint /run nicht sofort, erscheint es nach dem nächsten Neustart.

  • Bei einem Upgrade hält sie die laufenden Jobs an, aktualisiert das Datenbankschema und startet dieselben Jobs wieder.

Die PostgreSQL-Rollen und die Datenbank legt sie nicht an, denn macOS hat kein System-PostgreSQL. Legen Sie sie wie unter Aus dem Quellcode beschrieben an, in einem Cluster, der für lokale Verbindungen peer-Authentifizierung verwendet.

Nachdem das Paket installiert ist

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

pepsi-launchd tritt an die Stelle von systemctl und pepsi.target. Ohne Jobnamen wirken enable, disable, start, stop, restart und status auf die Jobs, die pepsi.target einbezieht; die optionalen Jobs telemetry-client und helper-token-refresh werden ausdrücklich genannt (pepsi-launchd enable telemetry-client). Jeder Job schreibt sein Protokoll nach /var/log/pepsi/<job>.log. Um das Paket zu entfernen, führen Sie sudo /usr/local/libexec/pepsi/pepsi-launchd uninstall aus. Wie apt remove behält das die Konfiguration, die Konten, die Datenbank und die Daten unter /var.

Drei Dinge funktionieren anders als unter Linux:

  • Ohne Socket-Aktivierung binden pepsi-ingress und pepsi-httpd ihre Ports selbst (SERVE = tcp, was der Assistent auf einem Host ohne systemd schreibt). Beide starten als root, lesen ihre TLS-Zertifikate und -Schlüssel und wechseln dann in ihre Konten. pepsi-setup startet ihre launchd-Jobs neu, wenn sich ihre TLS-Dateien ändern, und der certbot-Deploy-Hook startet sie nach einer Erneuerung neu.

  • /etc/pepsi/postgres.env wird nur von den Jobs gelesen, die als root laufen. Geben Sie stattdessen jedem Konto über den Platzhalter {role} in [pepsi-postgres] CONFIG eigene Zugangsdaten.

  • Der Setup-Applier (pepsi-httpd-admin unter Debian) hat keinen launchd-Job, daher sind die Konfigurationsseiten der Browser-Konsole schreibgeschützt; verwalten Sie die Installation mit pepsi-setup in einem Terminal.

4.3. Einen Download prüfen

Release-Tarballs sind mit dem OpenPGP-Schlüssel des Release-Managers signiert: dem von Christian Grothoff oder Florian Dold, denselben Schlüsseln, die auch die Releases von GNU Taler auf ftp.gnu.org signieren. Die Signatur ist die abgetrennte .asc-Datei, die neben dem Tarball veröffentlicht ist; prüfen Sie sie vor dem Entpacken:

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

gpg muss den Signierschlüssel besitzen, und die Prüfung ist genau so viel wert wie Ihr Grund zu glauben, dass der Schlüssel dem Release-Manager gehört. Christian Grothoffs Schlüssel ist unter https://grothoff.org/christian/grothoff.asc mit dem Fingerabdruck D842 3BCB 326C 7907 0339 29C7 939E 6BE1 E29F C3CC veröffentlicht (derselbe Schlüssel, den Eine Schwachstelle melden nennt); beide Schlüssel sind im GNU-Schlüsselbund https://ftp.gnu.org/gnu/gnu-keyring.gpg enthalten, den gpg --keyring gnu-keyring.gpg --verify … ohne Import verwendet. Eine gültige Signatur besagt, dass der Tarball derjenige ist, den der Release-Manager signiert hat; ob er auch dem entspricht, was die Quellen erzeugen, behandelt Reproduzierbare Builds.

Debian-Pakete auf deb.taler.net sind mit dem Release-Schlüssel von taler-systems signiert, der jedes Paket dort signiert, und apt prüft sie gegen den Schlüsselbund, den Sie einmal installieren:

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

der durch signed-by= im Quelleneintrag des Repositorys benannt wird. Ein aus dem Quellbaum mit make deb DEB_SIGN_KEYID=… gebautes Paket enthält eine signierte .changes-Datei, die dscverify und debsign --verify prüfen; ein ohne Schlüssel gebautes Paket ist unsigniert, wie es ein lokaler Build ist.

4.4. Reproduzierbare Builds

Der Release-Build ist reproduzierbar: Derselbe Commit, mit der festgelegten Toolchain aus derselben Cargo.lock gebaut, ergibt byte-identische Binärdateien und denselben Tarball, wo und wann auch immer er gebaut wird. Eine veröffentlichte Binärdatei lässt sich daher durch Neubauen gegen die Quellen prüfen, und das ist die eine Prüfung, die einen kompromittierten Build-Host oder Rechner des Release-Managers aufdeckt. Der CI-Job 5-reproducible führt diese Prüfung bei jedem Lauf durch und baut zweimal aus zwei Klonen unter verschiedenen Pfaden mit verschiedenen Crate-Caches (Kontinuierliche Integration).

Was das Rezept festlegt, und wo:

  • die Toolchain — rust-toolchain.toml nennt die genaue rustc-Version; rustup verwendet (und installiert) in diesem Baum genau diese. Eine nicht von rustup verwaltete Toolchain ignoriert die Datei, und ein anderer Compiler ergibt eine andere Binärdatei; verwenden Sie daher rustup, um ein Release zu reproduzieren;

  • die Crates — Cargo.lock mit --locked, das jedes make-Ziel übergibt;

  • die Pfade — make build bildet den Checkout, das Zielverzeichnis (CARGO_TARGET_DIR oder target/ im Checkout) und den Crate-Cache (CARGO_HOME, Standard ~/.cargo) auf die festen Namen /build, /target und /cargo ab, jeweils unter seinem eigenen und seinem kanonischen Pfad, für rustc (--remap-path-prefix) und für die C- und C++-Compiler, die die nativen Crates aufrufen (-ffile-prefix-map). So gelangt weder der Ort des Baums noch der des Crate-Caches in die Binärdatei. strip = true entfernt die Symboltabellen. Ein symbolischer Link innerhalb des Crate-Caches ist nicht abgedeckt: Halten Sie ihn als echten Baum;

  • die Zeit — SOURCE_DATE_EPOCH wird als Datum des Commits exportiert und ist das, was die mtimes des Tarballs und die Datumsangaben der Dokumentation verwenden; übergeben Sie SOURCE_DATE_EPOCH=<seconds>, um es in einem Baum zu überschreiben, der kein git-Checkout ist;

  • der Tarball — make dist schreibt ihn mit tar --sort=name --mtime=@$SOURCE_DATE_EPOCH --owner=0 --group=0 --numeric-owner und gzip -n.

Um ein Release zu reproduzieren, checken Sie sein Tag mit dem Submodul aus, bauen und vergleichen:

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

Vergleichen Sie dann die Prüfsummen mit denen der veröffentlichten Artefakte. Die Binärdateien in einem .deb (entpackt mit dpkg-deb -x) sind die Dateien, die make build erzeugt, aber gebaut mit der Toolchain des Paketbaus. Das ist Debians eigenes rustc, das rust-toolchain.toml ignoriert. Reproduzieren Sie ein Paket daher mit dem rustc, das seine .buildinfo-Datei nennt. Andere RUSTFLAGS oder CFLAGS in der Umgebung, ein anderer Inhalt des Crate-Caches (ein Crate mit abweichender Prüfsumme scheitert ohnehin an --locked) oder eine andere Toolchain ergeben eine andere Binärdatei; diffoscope zeigt, wo sich zwei Builds unterscheiden.

4.5. Migration von einem vorhandenen Mailserver

Wenn auf diesem Host bereits Postfix, Exim, Sendmail, qmail oder Stalwart läuft, müssen Sie dessen Konfiguration nicht von Hand neu herleiten. Ist keine pepsi.conf vorhanden, erkennt pepsi-setup --wizard, was installiert ist, und bietet an, es zu importieren: Hostname, akzeptierte Domains, Smarthost (mit den aus der Passwortdatei jenes Servers gelesenen Relay-Zugangsdaten), Zustellmethode für lokale Mail, Submission-SASL-Socket, Nachrichtengrößenbeschränkung, Warteschlangen-Lebensdauer und TLS-Zertifikatspfade kommen alle als vorbelegte Antworten des Interviews an, die Sie dann eine nach der anderen bestätigen oder korrigieren. Die vertrauenswürdigen Netze des alten Servers werden stattdessen im Migrationsbericht aufgeführt: Pepsi lässt ein Netz nur als die Adressen relayen, an die [pepsi-ingress] SENDER_MAP es bindet; jedes braucht also eine Bindung, die Sie von Hand schreiben.

Um zu sehen, was eine Migration ergäbe, bevor Sie den Assistenten starten, führen Sie Folgendes aus; es schreibt nichts:

pepsi-setup import

Routing-Tabellen werden ebenfalls konvertiert. /etc/aliases, /etc/postfix/virtual, Sendmails virtusertable, qmails .qmail-*-Dateien und ihre Entsprechungen werden zu einer Pepsi-Alias-Map neben der Konfiguration (siehe pepsi-stage-aliases), wobei bloße Alias-Namen in dem von Ihnen gewählten Stil qualifiziert werden. Da Pepsi-Alias-Schlüssel eine Domain tragen müssen, wird postmaster: root standardmäßig für jede akzeptierte Domain zu postmaster@example.org  root@example.org.

Alles, was nicht übernommen wird, wird neben der Konfiguration in import-report.txt geschrieben, aufgeteilt danach, was sich nicht parsen ließ, wofür Pepsi keine Entsprechung hat (header_checks, ein Alias, der an einen Befehl zustellt), was angenähert wurde (mbox-Zustellung, die zu Maildir wird) und was der Importer nicht erkannt hat. Ein Import bricht das Setup nie ab: Eine nicht lesbare Datei oder eine unbekannte Direktive erzeugt einen Berichtseintrag, keinen Fehler.

Zwei Dinge werden bewusst nicht migriert: eingereihte Mail (lassen Sie die Warteschlange des alten Servers leerlaufen, bevor Sie den MX umstellen) und DKIM-Schlüssel (pepsi-setup run erzeugt frische und gibt die zu veröffentlichenden Einträge aus). Wenn der alte MTA beim Lauf des Assistenten noch Port 25 hält, sagt der Bericht das; halten Sie ihn an und deaktivieren Sie ihn, bevor Sie pepsi-ingress starten.

Siehe pepsi-setup für die Details pro Server, die --alias-style-Auswahlmöglichkeiten und die --expert-Optionen, die die Einstellungen zugänglich machen, nach denen das Interview sonst nicht fragt.

4.5.1. Mailfilter, die bereits auf dem Host laufen

Unabhängig von jeder Migration durchsucht der Assistent den Host nach Milter-Daemons (clamav-milter, rspamd, spamass-milter, milter-greylist, milter-regex, mimedefang, amavisd-milter) und bietet jeden gefundenen an. Einen zu finden bedeutet der Reihe nach dreierlei: Das Paket ist installiert, ein Socket lässt sich aus seiner eigenen Konfiguration lesen (oder aus seiner Unit oder den Pfaden, die seine Distribution mitliefert), und eine echte Milter-Optionsaushandlung mit diesem Socket kommt zustande. Nichts wird allein aufgrund eines installierten Pakets angeboten, und die Aushandlung ist auch der Grund, weshalb das erzeugte ALLOW_ACTIONS genau das gewährt, was dieser Filter verlangt, statt einer Vermutung.

pepsi-ingress befragt jeden übernommenen Filter während der SMTP-Sitzung, nach seinen eigenen Prüfungen, wie es ein MTA tun würde: Ein Filter, der Mail ablehnt, antwortet dem sendenden Server mit seinem eigenen 4xx oder 5xx, sodass nichts, was angenommen wurde, später gebounct werden muss. Die Filter werden in einer Reihenfolge befragt, die davon abhängt, was sie tun: Richtlinien und Greylisting, dann Viren, dann Spam, dann Allzweck-Frameworks. Milter, die ein MTA-Import gefunden hat (Postfix smtpd_milters, sendmail INPUT_MAIL_FILTER), werden auf dieselbe Weise übernommen, mit der Fehleraktion, den Timeouts und den Makros, die der alte MTA verwendet hat. Der Assistent schreibt außerdem [stage-quarantine], das eine Nachricht, die ein Filter in Quarantäne stellen will, zurückhält, bis Sie sie freigeben. Siehe Milter in der SMTP-Sitzung für die erzeugten Abschnitte und pepsi-ingress dafür, wie die Sitzung sie verwendet.

Zwei Arten von Filtern laufen stattdessen als Pipeline-Stages von pepsi-stage-milter, nachdem die Nachricht angenommen wurde: ein Filter, der auf lokal eingelieferte Mail angewandt wurde (Postfix non_smtpd_milters), und, mit --expert, ein Filter, den Sie hinter die Entschlüsselung setzen, damit er Klartext sieht. Filter, deren Aufgabe Pepsi bereits erledigt (opendkim, openarc, opendmarc, SPF-Daemons, postsrsd), werden genannt und übersprungen, statt angeboten zu werden.

Der Assistent fragt außerdem, ob mit Pepsis eigenem Greylisting-Milter pepsi-greylist gegreylistet werden soll. Die Antwort ist standardmäßig nein, weil Greylisting die erste Nachricht jedes neuen Korrespondenzpartners verzögert. pepsi-setup check handelt mit jedem konfigurierten Milter aus und meldet einen, der nicht antwortet oder der eine Aktion verlangt, die sein ALLOW_ACTIONS nicht gewährt.

4.6. Datenbank, Schlüssel und DNS einrichten

Wenn eine Konfigurationsdatei vorhanden ist (siehe Konfiguration), führen Sie das Bootstrap-Werkzeug einmal aus:

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

Dies validiert die gesamte Konfiguration, installiert das pepsi-Schema, lässt den Signier-Daemon pepsi-dkim die DKIM-Schlüssel für jede Domain erzeugen (RSA und Ed25519, für jede Domain, die noch keine hat) und gibt die zu veröffentlichenden DNS-Einträge aus. Das sind die öffentlichen DKIM-Schlüssel, eine SPF-Richtlinie aus den konfigurierten PUBLIC_IP-Adressen, ein MTA-STS-Eintrag und für jeden TLS-Ingress-Listener ein DANE-TLSA-Eintrag. Dieser Eintrag legt den öffentlichen Schlüssel des Mail-Zertifikats fest; deshalb werden certbot-Zertifikate mit --reuse-key bezogen (siehe Den Schlüssel hinter einem TLSA-Eintrag wechseln). Die Mail-Listener und der HTTPS-Listener von pepsi-httpd erhalten getrennte certbot-Lineages und damit getrennte Schlüssel: /etc/letsencrypt/live/<HOSTNAME>/ für Mail und /etc/letsencrypt/live/<HOSTNAME>-web/ für den Webserver. Der Webserver besitzt daher nie den Schlüssel, den der TLSA-Eintrag festlegt. (Eine Installation, deren HTTPS-Listener noch das Mail-Zertifikat verwendet, wird beim nächsten pepsi-setup run auf ein eigenes umgestellt, sobald dieses Zertifikat bezogen wurde.) Der Vorgang ist idempotent und kann jederzeit wiederholt werden; das Aktualisieren des Schemas auf ein neues Release erledigt pepsi-setup schema (siehe Upgrade). run --reset löscht das Schema und legt es neu an; dabei wird alle Mail in der Warteschlange vernichtet, die DKIM-Schlüssel aber, die nicht in der Datenbank liegen, bleiben erhalten.

Veröffentlichen Sie die ausgegebenen DNS-Einträge und verifizieren Sie dann das Veröffentlichte gegen das, was Pepsi erwartet:

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

Siehe pepsi-setup für den vollständigen Einrichtungsablauf.

4.7. Im Browser einrichten

Alles Obige lässt sich auch von einem Browser aus erledigen, gegen denselben Code. Der Terminalweg ist der kürzeste Weg auf einer Maschine, auf der Sie eine Shell haben; der Browserweg ist für die, auf denen Sie keine haben, und für Betreiber, die die DNS-Einträge lieber als rot/grüne Checkliste sehen als als Zonendatei.

4.7.1. Die Trennung, und warum

Das Setup ist privilegiert: Es schreibt /etc/pepsi/pepsi.conf, übergibt jedes secrets.d-Fragment dem einzigen Konto, das es liest, führt certbot aus, legt Datenbankrollen an und erzeugt Schlüsselmaterial — alles als root. pepsi-httpd, das die Oberfläche bedient, gibt seine Privilegien ab, bevor es eine Verbindung annimmt, und darf sie nie zurückerlangen.

Es handelt also nicht. Es schreibt einen Absichts-Datensatz, der sagt, was wahr sein soll. Ein separates root-Programm, pepsi-setup apply, entscheidet wie, tut es und hält fest, was geschehen ist; es wird auf Anforderung gestartet und beendet sich wieder, wenn es nichts zu tun hat. Root ist nie im Netz. Lesen Sie „Das Vertrauensmodell des Appliers“ in :doc:`programs/pepsi-setup`, bevor Sie das aktivieren: Dort steht genau, was der Applier tun und nicht tun wird, einschließlich der Dinge, die er bewusst nicht tun kann (es gibt keine Neustart- oder Abschaltaufgabe, und install-schema lehnt reset ab).

4.7.2. Es aktivieren

Die Debian-Pakete liefern eine minimale, aber vollständige Konfiguration, einen administrativen Listener auf einem UNIX-Socket und die Socket-Unit des Appliers. Die Socket-Unit liegt in pepsi-httpd-admin, das pepsi Recommends und das apt daher standardmäßig installiert (siehe Debian-Pakete). Zwei Befehle schalten sie ein:

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

Der zweite gibt ein Einmal-Token und den curl-Befehl aus, der daraus das erste Administratorkonto macht. Auf der Maschine selbst können Sie ihn ganz überspringen: Ein Mitglied der Gruppe pepsi-admin (und root) wird über SO_PEERCRED auf /run/pepsi/admin.sock identifiziert und braucht überhaupt kein Credential.

Eine weitere Einstellung ist nötig, bevor überhaupt etwas Privilegiertes angefordert werden kann: [pepsi-admin] CONFIG_DB muss eine Verbindung benennen, die sich als Datenbankrolle pepsi-config authentifiziert. Das ist die Grenze: Nur diese Rolle darf Setup-Arbeit in die Warteschlange stellen, und das eigene Konto von pepsi-httpd ist es nicht, sodass eine Kompromittierung der Web-Schicht keine Kompromittierung der Pipeline-Definition ist. Solange sie nicht gesetzt ist, antworten die Setup-Endpunkte mit 503 und sagen es.

4.7.3. Es bedienen

Das Interview ist Daten. GET /api/v1/setup/questions liefert die geordneten Schritte und, für jede Frage, ihre Form, ihren Standardwert, ihren Hilfetext und die Bedingung, unter der sie gestellt wird. Das ist dasselbe Modell, das pepsi-setup questions ausgibt und das den Terminal-Assistenten beschreibt; die Testsuite sichert zu, dass beide gleich sind. Antworten werden mit PUT /api/v1/setup/answers in Entwurfsdatensätze vorbereitet, die kein laufender Prozess sehen kann, sodass eine unterbrochene Sitzung nichts halb konfigurieren kann.

POST /api/v1/setup/tasks fordert dann die privilegierte Hälfte an: die Konfiguration schreiben, Zertifikate beschaffen, das Schema installieren und Schlüssel erzeugen. GET /api/v1/setup/tasks/{id}?since=<seq> streamt Zeile für Zeile, was der Applier tut.

4.7.4. Was immer einen Texteditor brauchen wird

Manche Einstellungen werden ausschließlich aus der Konfigurationsdatei gelesen, und daran wird keine Oberfläche etwas ändern: [pepsi], [pepsi-postgres], [paths] sowie die Listener-Abschnitte für HTTP(S) und Ingress. Sie müssen funktionieren, bevor eine Datenbankverbindung existiert, oder sie sind eine Sicherheitsgrenze: Könnte die Datenbank einen lauschenden Socket verschieben oder die Kryptorichtlinie lockern, würde eine Datenbankkompromittierung zu einer Kompromittierung des eigenen TLS und der Ports des MTA.

Also: Einen Submission-Port hinzuzufügen oder einen Listener zu verschieben ist eine Texteditor-und-Neustart-Operation. Ebenso jede Änderung, die die Konsole als restart statt als hot kennzeichnet: Es gibt keinen Neustartknopf, denn ein Knopf, der einen Dienst auf Anforderung neu startet, gäbe die Privilegien der Web-Schicht an jeden weiter, der sie erreicht.

4.7.5. Es skripten

Dasselbe Antwortmodell treibt eine unbeaufsichtigte Installation:

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

pepsi-setup questions gibt das Schema aus, gegen das diese Datei geschrieben wird. Das ist keine dritte Implementierung des Interviews: Es führt das interaktive aus, mit jeder Frage aus der Datei beantwortet, sodass die Verzweigungen und die Validierung je Feld dieselben sind, die ein Mensch sieht.

4.8. Die Dienste betreiben

Diese langlebigen Prozesse laufen dauerhaft (pepsi.target startet sie alle unter den mitgelieferten Units):

  • pepsi-ingress serve — nimmt Mail an (typischerweise unter einem Dienstmanager, optional mit systemd-Socket-Aktivierung für die privilegierten Ports).

  • pepsi-dispatch serve — läuft mit genau einer Instanz pro System; es ist der einzige Prozess, der Stage-Programme startet.

  • pepsi-dkim serve — hält die privaten DKIM- und ARC-Schlüssel und signiert für die Signier-Stages; die Unit des Dispatchers zieht ihn mit hoch.

  • pepsi-httpd serve — die MTA-STS-Policy, das Web Key Directory, das Secure-Link-Portal und, auf administrativen Listenern, die API und die Konsole.

  • pepsi-keydisc serve METHOD — eine Instanz je Methode der Schlüsselsuche (standardmäßig pepsi-keydisc@dane, @wkd-advanced, @wkd-direct und @vks), die die Schlüsselanfragen der Krypto-Stages beantwortet.

Ein weiterer läuft nur dort, wo Greylisting eingeschaltet ist, aus seiner eigenen Unit außerhalb von pepsi.target:

  • pepsi-greylist serve — der Greylisting-Milter, den pepsi-ingress (oder ein vorgeschalteter Postfix) bei RCPT befragt.

Die Timer, die pepsi.target ebenfalls anfordert (Bounces für fehlgeschlagene Nachrichten, Garbage Collection von Warteschlange und Protokollen, Auffrischen und Ausmustern von Schlüsseln, Quota-Abgleich, die Aufgaben und Digests der Mailinglisten), führen einmalige Jobs aus; systemctl list-timers 'pepsi-*' listet sie auf.

Die Stage-Programme selbst werden vom Dispatcher als persistente PROGRAM worker-Prozesse gestartet, die Nachrichten-IDs von der Standardeingabe lesen; im Produktivbetrieb führen Sie sie nicht von Hand aus (zum Debuggen können Sie eine ID an worker weiterleiten, z. B. echo 42 | pepsi-stage-srs -c /etc/pepsi/pepsi.conf worker).

4.9. Upgrade

Ab dem ersten Release, 0.0.0, aktualisiert jedes Release die Datenbank jedes früheren Releases an Ort und Stelle: Die Warteschlange, der Schlüsselspeicher, die Einstellungen und alles andere darin bleiben erhalten, und in der Warteschlange wartende Mail wird vom neuen Release zugestellt. Downgrades werden nicht unterstützt (siehe unten).

Das Vorgehen:

  1. Lesen Sie NEWS zu dem Release. Es führt geänderte Konfigurationsoptionen auf und alles andere, was von Hand zu erledigen ist.

  2. Legen Sie eine Sicherung an (Sicherung und Wiederherstellung), oder aktivieren Sie zumindest den unten beschriebenen automatischen Dump.

  3. Installieren Sie das neue Release. Die Debian-Pakete erledigen den Rest: Sie aktualisieren das Schema und starten die Dienste neu, die liefen. Aus den Quellen: make install, dann pepsi-setup -c /etc/pepsi/pepsi.conf schema und systemctl try-restart pepsi.target.

  4. Prüfen Sie mit pepsi-status, dass sich die Warteschlange leert, und sehen Sie im Journal nach Warnungen (Logs).

Ein Release kann auch eine Konfiguration ablehnen, die ein früheres angenommen hat, wenn das frühere Verhalten eine Sicherheitsschwäche war (NEWS sagt, welche); die Dienste starten dann nicht. Führen Sie pepsi-setup -c /etc/pepsi/pepsi.conf validate aus, bevor Sie sie neu starten: Es wendet dieselben Prüfungen an und nennt, was zu ändern ist.

Der Rest dieses Abschnitts erklärt, was in Schritt 3 geschieht.

Jedes Pepsi-Programm prüft beim Verbinden mit der Datenbank, dass das Schema aus genau den SQL-Dateien gebaut wurde, mit denen das Programm selbst gebaut wurde. Der Installer hält SHA-256 und Release jeder angewendeten Datei in pepsi.schema_file fest. Ein Programm, das etwas anderes vorfindet (ein älteres Schema, ein neueres oder eines aus anderen Dateien), hält sofort mit Exit-Status 78 und einer Meldung an, die die Abhilfe nennt, statt mitten in einer Nachricht an der ersten fehlenden Spalte zu scheitern. Der Dispatcher behandelt einen Stage-Worker, der auf diese Weise anhält, als „kann noch nicht laufen“, nicht als Absturz: Die Nachricht, die ihm übergeben wurde, kommt zurück in die Warteschlange und wird nie auf failed gesetzt.

Das Upgrade des Schemas ist ein eigener Schritt:

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

Er installiert die Patches, die dieses Release hinzufügt, ersetzt die gespeicherten Funktionen und wendet die Rollenrechte erneut an. Sonst tut er nichts (keine Zertifikate, Schlüssel oder DNS), braucht also nur den Abschnitt [pepsi-postgres]. Auf einem Telemetrie-Collector übergeben Sie ihm die Datei des Collectors, /etc/pepsi-telemetry/pepsi-telemetry.conf.

Debian-Pakete führen ihn bei ihrer Aktualisierung automatisch aus, bevor die Dienste neu gestartet werden; eine Neuinstallation bleibt pepsi-setup run überlassen. Schlägt er fehl (etwa weil die Datenbank nicht läuft), wird das Paket trotzdem installiert, ein Hinweis meldet dies, und die Dienste verweigern den Start. systemd versucht sie erneut, bis das Schema passt, mit zunehmendem Abstand bis zu einmal pro Minute und ohne Startlimit. Ist die Ursache behoben, genügt es, den obigen Befehl auszuführen; die Dienste kommen von selbst wieder.

Aus den Quellen, nach make install:

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

Was die Zurückweisungen bedeuten:

Die Meldung sagt

Was zu tun ist

kein pepsi-Schema

Eine Neuinstallation: pepsi-setup run (oder pepsi-setup schema auf einem Collector-Host).

älter als dieses Programm

pepsi-setup -c FILE schema.

neuer als dieses Programm

Ein Downgrade, der nicht unterstützt wird. Installieren Sie das neuere Release wieder, oder stellen Sie die vor dem Upgrade angelegte Datenbanksicherung wieder her (siehe unten).

aus einer anderen Fassung eines Patches gebaut

Ein veröffentlichter Patch ändert sich nie, dies ist also ein Fehler; bitte melden Sie ihn. Die einzige Ausnahme ist eine Datenbank, die aus einem Entwicklungsstand gebaut wurde (einem Git-Checkout zwischen Releases), bei dem der neueste Patch noch bearbeitet wird: Leeren Sie sie und erstellen Sie sie mit pepsi-setup run --reset neu.

gespeicherte Funktionen aus einem anderen Build

Nur bei Entwicklungs-Builds: pepsi-setup -c FILE schema.

4.9.1. Upgrade von 0.0.0: die DKIM-Schlüssel

Release 0.0.0 hält seine DKIM- und ARC-Schlüssel als Dateien unter [pepsi] KEY_DIR, lesbar für die Pipeline. Spätere Releases halten sie im Signier-Daemon pepsi-dkim, unter dessen eigenem Konto und in dessen eigenem Verzeichnis. Der Daemon übernimmt die Schlüsseldateien von 0.0.0 nicht: Er erzeugt neue Schlüssel unter neuen Selektoren (pepsi-YYYYMM und pepsi-YYYYMM-ed25519) und signiert sofort damit. Er signiert nur für die Domains, die pepsi-setup run ihm übergibt; bis das geschehen ist, wartet ausgehende Mail an der Signier-Stage und wird erneut versucht, führen Sie es daher direkt nach der Installation aus:

  1. Installieren Sie das neue Release wie oben beschrieben.

  2. Führen Sie pepsi-setup -c /etc/pepsi/pepsi.conf run aus. Es übergibt die Signier-Domains an pepsi-dkim, das die Schlüssel erzeugt, die alten Schlüsseldateien unter KEY_DIR löscht und die neuen DKIM-Einträge ausgibt, mit den alten Einträgen pepsi und pepsi-ed25519 als zu entfernende Kommentare.

  3. Veröffentlichen Sie die neuen Einträge. Bis sie veröffentlicht sind, können Empfänger die Signaturen nicht prüfen, und DMARC stützt sich allein auf SPF; pepsi-setup check, pepsi-dkim status und die Mail des Daemons an den Postmaster sagen, was noch fehlt.

  4. Entfernen Sie die alten Einträge pepsi._domainkey und pepsi-ed25519._domainkey, sobald mit den alten Schlüsseln signierte Mail zugestellt ist, spätestens eine Woche nach dem Upgrade.

Nehmen Sie /var/lib/pepsi-dkim von da an von Sicherungen aus (Sicherung und Wiederherstellung). Die Rotation bleibt aus, solange Sie sie nicht einschalten (DKIM-Schlüssel rotieren).

4.9.2. Downgrades

Nicht unterstützt. pepsi-setup weigert sich, das SQL eines älteren Releases über ein neueres Schema zu installieren (Exit-Status 78, nichts geändert), und die Programme des älteren Releases verweigern darauf den Betrieb. Zurück zu einem älteren Release geht es nur, indem Sie eine vor dem Upgrade angelegte Datenbanksicherung wiederherstellen und danach die älteren Pakete installieren. Keine Schnittstelle von Pepsi kann ein älteres Release installieren; ein Rückschritt auf eine verwundbare Version erfordert daher, dass root bewusst handelt (siehe Signierte Firmware-Updates ohne Versionsprüfung akzeptiert).

4.9.3. Sicherung vor einem Schema-Upgrade

Eine Sicherung wird nur angelegt, wenn Sie sie aktivieren. Ist sie aktiviert, wird sie nur angelegt, wenn ein Upgrade das Schema tatsächlich ändert: pg_dump sichert das pepsi-Schema (mit den Erweiterungen, die es verwendet) als pepsi-<previous version>-<UTC time>.dump, nur für root lesbar. Schlägt der Dump fehl, wird das Schema nicht aktualisiert. Nach jedem neuen Dump werden im Verzeichnis nur die beiden neuesten behalten (pepsi-setup schema --backup-keep; 0 behält alle): Ein Dump enthält die gesamte Warteschlange einschließlich des Klartexts entschlüsselter Mail, die darin wartet; alte Dumps sind also Kopien von Mail, die den Host sonst längst verlassen hätte. Kopieren Sie einen Dump an einen anderen Ort, wenn er zwei Upgrades überdauern muss.

Bei den Debian-Paketen ist es eine debconf-Einstellung, die nur mit Priorität low abgefragt wird:

dpkg-reconfigure -plow pepsi

Antworten Sie mit yes und bestätigen oder ändern Sie das Verzeichnis (Vorgabe /var/backups/pepsi). Unbeaufsichtigt oder vor dem ersten Upgrade:

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

Auf einem Telemetrie-Collector-Host gehören die Fragen zu pepsi-telemetry (pepsi-telemetry/schema-backup, pepsi-telemetry/schema-backup-dir). Sind beide Pakete installiert und verwenden dieselbe Datenbank, legt dasjenige die Sicherung an, das sie zuerst aktualisiert.

Aus den Quellen übergeben Sie das Verzeichnis dem Upgrade-Schritt:

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

Um eine Sicherung wiederherzustellen, stoppen Sie die Dienste, legen die Datenbank leer und im Besitz des Schemaeigentümers neu an und stellen die Sicherung als dieser Eigentümer darin wieder her:

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

Installieren Sie danach das Release, aus dem die Sicherung stammt, und starten Sie die Dienste wieder. Alles, was die Datenbank nach der Sicherung erfahren hat, geht verloren, etwa seitdem angenommene Mail und seitdem geänderte Einstellungen. Die gespeicherten privaten Schlüssel im Dump sind unter dem Schlüsselverschlüsselungsschlüssel in secrets.d verschlüsselt, der nicht in der Datenbank liegt: Bewahren Sie diese Datei auf und sichern Sie sie separat (siehe Sicherung und Wiederherstellung). Die Schlüssel sind mit einem AEAD versiegelt, sodass sich ein veränderter Blob in einem Dump nie öffnen lässt (siehe Nicht authentifizierte Verschlüsselung privater Schlüssel lässt den Speicherinhaber Schlüssel verstümmeln); ohne die Datei sind sie verloren (siehe Schlüsselverwaltung zu schwer: Ende-zu-Ende-Mail-Clients fehleranfällig oder ungenutzt).

4.10. Benutzer, Gruppen und Privilegien

Pepsi läuft niemals als root. Die langlebigen Daemons dürfen als Root gestartet werden, damit sie privilegierte Ports binden und nur für Root lesbare TLS-Schlüssel lesen können, aber jeder gibt seine Privilegien an sein eigenes unprivilegiertes Dienstkonto ab, bevor er auch nur eine Verbindung bedient; kann die Abgabe nicht abgeschlossen werden, verweigert der Prozess den Start, statt zu riskieren, als Root zu laufen (siehe pepsi-common::privdrop). Als ein anderer lokaler Benutzer zu handeln, etwa in dessen Postfach zu schreiben, dessen ~/.forward auszuführen oder dessen Wallet zu benutzen, ist die eine Art von Operation, die mehr Rechte braucht, als das Dienstkonto hat. Jede solche Operation ist auf einen eng begrenzten setuid-Helper beschränkt, statt der Pipeline als Ganzes überlassen zu werden. Die Privilegientrennung beschreibt die Aufteilung als Sicherheitsmechanismus und Vertrauensgrenzen die Grenzen, die sie aufrechterhält.

Unter den mitgelieferten systemd-Units laufen die Daemons überhaupt nie als root: systemd bindet die privilegierten Sockets (Socket-Aktivierung) und startet jeden Prozess direkt unter seinem Dienstkonto. Bleiben die TLS-Schlüssel, die certbot nur für root lesbar hält. pepsi-setup lässt daher auch diese von systemd lesen, indem es pro Unit ein LoadCredential=-Drop-in schreibt: systemd öffnet jedes Zertifikat und jeden Schlüssel als root, wenn es die Unit startet, und übergibt dem Dienst eine private Kopie unter $CREDENTIALS_DIRECTORY, wo der Server zuerst nachsieht. Führen Sie pepsi-setup run erneut aus, wann immer Sie ein Zertifikat hinzufügen, verschieben oder entfernen, damit das Drop-in neu erzeugt wird. Siehe pepsi-httpd.

Die oben beschriebene Browser-Einrichtung ist der eine Weg, auf dem etwas anderes als ein Betreiber an einem Terminal einen root-Prozess laufen lassen kann: pepsi-httpd betätigt einen Türklingel-Socket, und systemd startet ein kurzlebiges root-pepsi-setup apply. Dieser Weg ist das am leichtesten zu entziehende Privileg in Pepsi. Seine beiden systemd-Units sind ein eigenes Debian-Paket, pepsi-httpd-admin, dessen Entsprechung bei einer Quellinstallation make install INSTALL_ADMIN_UNITS=no ist. Ohne sie leert nichts pepsi.setup_task, und keine HTTP-Anfrage kann etwas unterhalb von /etc/pepsi ändern, während pepsi-setup auf einem Terminal unverändert weiterarbeitet. Das Paket wieder einzuspielen wirkt nicht auf das, was in seiner Abwesenheit angefordert wurde: Seine Installation leert diese Warteschlange, bevor seine Units scharfgestellt werden. Siehe Die Aufteilung als Härtungshebel.

Die folgenden Konten und Gruppen werden automatisch durch das postinst des Debian-Pakets angelegt; bei einem make install legen Sie sie selbst an (dieselben Namen). Der PostgreSQL-Zugriff erfolgt per Peer-Authentifizierung über den lokalen Socket: Jedes Dienstkonto meldet sich als gleichnamige Datenbankrolle an, sodass nirgends Passwörter gespeichert werden. Eine entfernte Datenbank behält dasselbe Modell bei: eine Login-Rolle je Konto, jede authentifiziert durch ein eigenes Client-Zertifikat oder eine eigene Passwortdatei, die nur dieses Konto lesen kann und die je Rolle mit dem Platzhalter {role} in [pepsi-postgres] CONFIG benannt wird (siehe CONFIG in pepsi.conf(5)). Die Konfigurationsdatei enthält nie ein Passwort.

4.10.1. Dienstkonten

Dies sind Systemkonten (--system, /usr/sbin/nologin, Home /var/pepsi), jedes mit einer privaten primären Gruppe gleichen Namens. Die ersten drei sind langlebige Daemons, die nach dem Binden auf ihr Konto wechseln; die übrigen sind keine Daemons in der Pipeline.

Konto

Läuft als

Zweck / Zugriff

pepsi-ingress

pepsi-ingress

Eingehender SMTP-Server. Unter systemd socket-aktiviert (nie root; das TLS-Material kommt als Dienst-Credential); von Hand gestartet bindet er 25/465/587 und liest die TLS-Schlüssel als root und gibt die Rechte dann ab. DB-Rolle pepsi-ingress.

pepsi-httpd

pepsi-httpd

HTTP/HTTPS-Server (MTA-STS-Policy, Web Key Directory, Secure-Link-Portal und, auf administrativen Listenern, /metrics, die API und die Konsole). Unter systemd socket-aktiviert, genau wie pepsi-ingress; von Hand gestartet bindet er 80/443 als root und gibt die Rechte dann ab. DB-Rolle pepsi-httpd.

pepsi

pepsi-dispatch und jeder Stage-Worker, den er startet

Die Arbeitsidentität der Pipeline. Lässt Nachrichten von pepsi-dkim über dessen Socket signieren (Gruppe pepsi), kann aber keinen Signierschlüssel lesen. DB-Rolle pepsi (besitzt die Warteschlangen-Datensätze). Dies ist das Konto, das die unten genannten Gruppenidentitäten für Zustellung, Wallet und Token vorübergehend erlangt. Da jede Stage eine Nachricht umschreiben kann, nachdem Ingress ihr From: geprüft hat, ist eine Signatur nur so stark wie dieses Konto (Eine kompromittierte Komponente).

pepsi-owner

pepsi-setup (vorübergehend)

Kein Laufzeitdienst. Besitzt die pepsi-Datenbank, das Schema, die Tabellen und Funktionen. Wenn pepsi-setup als Root läuft, nimmt es vorübergehend diese Identität an (seteuid), damit die von ihm erstellten Objekte der peer-authentifizierten pepsi-owner-Rolle gehören, und kehrt dann für die Dateisystemarbeit (Schlüsselerzeugung, Eigentümer-Korrekturen) zu Root zurück.

pepsi-helper-token-refresh

pepsi-helper-token-refresh-Dienst

Nur benötigt, wenn ein Smarthost AUTH = oauth verwendet (das Debian-Paket legt es trotzdem an; ein make install braucht es nur dann). Erneuert OAuth-Zugriffstoken und schreibt die Token-Dateien, die das Smarthost-Relay liest. Hat keine Datenbankrolle.

pepsi-crypto

pepsi-keys (vorübergehend) und die Ende-zu-Ende-Krypto-Stages

Verwahrer des privaten Ende-zu-Ende-Schlüsselmaterials. Besitzt secrets.d/pepsi-crypto.secret, den Schlüsselverschlüsselungsschlüssel, der pepsi.crypto_identity.private_wrapped öffnet, und ist die einzige Datenbankrolle, der diese Spalte gewährt ist; jede andere Rolle, pepsi eingeschlossen, bekommt eine spaltenweise Berechtigung, die sie auslässt. pepsi-keys nimmt diese Identität für die Dauer eines Datenbankaufrufs an und gibt sie sofort wieder ab. Siehe Schlüsselverwaltung. Das begrenzt, wer private Schlüssel lesen kann; die Krypto-Stages, die unter diesem Konto laufen, halten trotzdem alle (siehe Mail-Appliances speichern Geheimnisse für alle lesbar oder ungeschützt).

pepsi-whitelist

pepsi-whitelist (vorübergehend)

Konto, das das setuid-CLI für weiße Listen annimmt, damit gewöhnliche Benutzer ihre eigenen weißen Absenderlisten pflegen können. Seiner Datenbankrolle sind SELECT/INSERT/DELETE auf pepsi.whitelist gewährt und sonst nichts.

pepsi-keydisc

pepsi-keydisc@<method>-Dienste

Schlüsselentdeckung (WKD, DANE, VKS, LDAP). Parst Schlüsselmaterial, das aus dem offenen Internet geholt wird, daher ist seine Datenbankrolle die engste in der Installation. Siehe Schlüsselverwaltung.

pepsi-config

pepsi-config (von einem Betreiber ausgeführt)

Die einzige Datenbankrolle, die das Overlay pepsi.config_override schreiben darf: Eine Komponente, die Mail verarbeitet, darf die Pipeline, in der sie läuft, nicht umschreiben können.

pepsi-greylist

Dienst pepsi-greylist und Timer pepsi-greylist-prune

Der Greylisting-Milter. Seine Gruppe ist die Gruppe seines Sockets /run/pepsi-greylist/milter.sock (0660): Ein MTA, der Mitglied ist, darf ihn befragen (pepsi-ingress ist eines), und die Gruppe gewährt sonst nichts. Seine Datenbankrolle erreicht die greylist_*-Tabellen, liest whitelist und hängt an event_log an.

pepsi-dkim

Dienst pepsi-dkim

Verwahrer der privaten DKIM- und ARC-Schlüssel, Dateien mit Modus 0600 in seinem Home-Verzeichnis /var/lib/pepsi-dkim (0700). Signiert für die Stages über /run/pepsi-dkim/sign.sock, den er der Gruppe pepsi übergibt (deren Mitglied er zu diesem Zweck ist); besitzt secrets.d/pepsi-dkim.secret (den TSIG-Schlüssel von DNS_UPDATE = rfc2136). Hat keine Datenbankrolle.

Der postinst des Pakets (oder, bei einer manuellen Installation, Sie selbst) legt die zehn PostgreSQL-Login-Rollen an, bevor pepsi-setup das Schema installiert: pepsi-owner, pepsi, pepsi-ingress, pepsi-httpd, pepsi-telemetry sowie die eng gefassten Rollen pepsi-whitelist, pepsi-config, pepsi-crypto, pepsi-keydisc und pepsi-greylist. pepsi-setup gewährt dann jeder Rolle, was sie braucht.

4.10.2. Gruppen, die gemeinsame Ressourcen absichern

Vier Gruppen existieren ausschließlich, um den Zugriff auf privilegierte Binärprogramme und geheime Dateien zu kontrollieren. Der pepsi-Benutzer ist bewusst kein dauerhaftes Mitglied einer von ihnen: Das setgid-Bit auf dem betreffenden Stage-Binärprogramm gewährt dem Worker die Gruppenidentität nur für die Lebensdauer dieses Prozesses.

pepsi-maildir

Kontrolliert den Helper für die lokale Zustellung. pepsi-helper-maildir-writer ist setuid root und hat Modus 4750 (root:pepsi-maildir), sodass nur diese Gruppe ihn ausführen darf. pepsi-stage-relay-to-maildir ist setgid auf diese Gruppe (Modus 2550, pepsi:pepsi-maildir; nur der Eigentümer darf ausführen, sodass kein anderer lokaler Benutzer an das setgid-Bit kommt). Wenn der pepsi-Worker die Stage ausführt, erlangt er egid=pepsi-maildir, also genau das Recht, den Helper zu starten. Der Helper wechselt dann per setuid zum Empfänger und schreibt ~/Maildir/new/. Der Helper ist der einzige Code, der jemals das Postfach eines Dritten berührt.

pepsi-forward

Kontrolliert den ~/.forward-Helper, in genau der Form des Maildir-Paares oben: pepsi-helper-dot-forward ist setuid root und hat Modus 4750 (root:pepsi-forward), und pepsi-stage-dot-forward ist setgid auf diese Gruppe (Modus 2550, pepsi:pepsi-forward). Nur nötig, wenn Sie die ~/.forward-Stage betreiben; ohne die Gruppe geben die Ziele install-forward-helper / install-forward-stage von make install nur eine Warnung aus und lassen die Binärprogramme unprivilegiert.

pepsi-wallets

Kontrolliert den Wallet-Helper auf dieselbe Weise: pepsi-helper-auto-pay ist 4750 root:pepsi-wallets und pepsi-stage-auto-pay ist setgid auf diese Gruppe (Modus 2550, pepsi:pepsi-wallets). Ein Systemkonto gleichen Namens besitzt die gemeinsamen Wallet-Datenbanken unter /var/lib/pepsi-wallets, wenn WALLET_MODE = shared gilt. Nur nötig, wenn Sie die Auto-Pay-Stage betreiben; andernfalls fallen install-auto-pay-helper / install-auto-pay-stage auf eine Warnung zurück.

pepsi-token

Kontrolliert das geheime Material, das das Smarthost-Relay liest: OAuth-Token-Dateien, das Mutual-TLS-Client-Zertifikat/-Schlüssel und den Kerberos-Credential-Cache. pepsi-stage-relay-to-smarthost ist setgid auf diese Gruppe (Modus 2550, pepsi:pepsi-token); die Verzeichnisse, die diese Geheimnisse enthalten, sind setgid pepsi-token, sodass dort abgelegte Dateien die Gruppe erben und das Relay sie lesen kann, ohne dass der pepsi-Benutzer Mitglied ist.

4.10.3. Privilegierte Binärprogramme

Diese Bits werden von make install gesetzt, wenn es als Root läuft (andernfalls gibt es die genauen, von Hand auszuführenden chown/chmod aus), sowie vom Debian-Paket über dpkg-statoverride, das die maßgebliche Liste ist (debian/pepsi.postinst):

Binärprogramm

Modus / Eigentümer

Warum

pepsi-helper-maildir-writer

4750 root:pepsi-maildir

Setuid root, damit es in das Postfach jedes lokalen Benutzers schreiben kann; gruppengesperrt, sodass nur pepsi-maildir es ausführen darf.

pepsi-stage-relay-to-maildir

2550 pepsi:pepsi-maildir

Setgid, damit der pepsi-Worker den obigen Helper ausführen darf. Ausführbar für den Eigentümer und nicht für alle: Das setgid-Bit ist die ganze Schranke, also darf kein anderer lokaler Benutzer an es herankommen. pepsi kann das Ausführungsrecht nicht über die Gruppe bekommen (es ist bewusst kein Mitglied), also bekommt es das Recht dadurch, dass ihm die Datei gehört. pepsi-quota, pepsi-stage-dot-forward und pepsi-stage-auto-pay tragen dieselbe Form für ihre eigenen Gruppen.

pepsi-quota

2550 pepsi:pepsi-maildir

Dieselbe Gruppe und derselbe Grund: measure/reconcile führen den obigen Helper aus, und das Bit ist es, was einem unbeaufsichtigten Durchlauf das ohne Root erlaubt.

pepsi-helper-dot-forward

4750 root:pepsi-forward

Setuid root, damit es die ~/.forward eines Benutzers als dieser Benutzer ausführen kann; auf seine Stage gruppengesperrt.

pepsi-stage-dot-forward

2550 pepsi:pepsi-forward

Setgid, damit der pepsi-Worker den obigen Helper ausführen darf.

pepsi-helper-auto-pay

4750 root:pepsi-wallets

Setuid root, damit es auf das Konto, dem das Wallet gehört (oder auf die eigene uid des Empfängers), herabgehen kann, um taler-wallet-cli auszuführen: nur das beim Bauen festgelegte (--with-taler-wallet-cli), nie einen Pfad, den ein Aufrufer nennt.

pepsi-stage-auto-pay

2550 pepsi:pepsi-wallets

Setgid, damit der pepsi-Worker den obigen Helper ausführen darf.

pepsi-stage-relay-to-smarthost

2550 pepsi:pepsi-token

Setgid, damit der pepsi-Worker die pepsi-token-Geheimnisse lesen darf; nicht für alle ausführbar, da die Stage -c akzeptiert und diese Geheimnisse sonst an jeden Server senden würde, den ein lokaler Benutzer nennt.

pepsi-whitelist

4755 pepsi-whitelist:pepsi-whitelist

Setuid und absichtlich für alle ausführbar: Jeder lokale Benutzer darf seinen eigenen <login>/…-Namensraum verwalten, und die Regel, die ihn vom Namensraum anderer fernhält, steckt im Programm, nicht im Dateimodus.

pepsi-stage-encrypt, pepsi-stage-decrypt

4750 pepsi-crypto:pepsi

Setuid, nicht setgid: Die Peer-Authentifizierung von PostgreSQL richtet sich nach der effektiven uid, und pepsi-crypto ist die einzige Rolle, der crypto_identity.private_wrapped gewährt ist. Modus 4750 mit Gruppe pepsi, weil dies keine Benutzerbefehle sind — nur das Konto des Dispatchers und root dürfen sie ausführen.

Jedes andere Binärprogramm wird unprivilegiert installiert, einschließlich pepsi-keys, das aus denselben Gründen eigenständig ist, aber mit 0755 ausgeliefert wird: Ein Binärprogramm, das jeden privaten Schlüssel einer Installation öffnen kann, ist eine weit größere Beute als die eine Tabelle von pepsi-whitelist, sodass es setuid pepsi-crypto zu machen eine Entscheidung je Standort ist statt der Standardwert.

4.10.4. Verzeichnisse und Geheimnisse

pepsi-setup und das Paket legen Folgendes unter /var/pepsi (dem Dienst-Home) und /etc/pepsi an. Die setgid-Verzeichnisse (2750) bewirken, dass neue Dateien die Gruppe des Verzeichnisses erben, sodass Token-/TLS-/Kerberos-Material vom Relay gruppenlesbar ist, ohne dass pro Datei ein chgrp nötig wäre.

Pfad

Eigentümer / Modus

Inhalt

/var/pepsi

pepsi-owner:pepsi

Dienst-Home.

/var/lib/pepsi-dkim

pepsi-dkim 0700

Die privaten DKIM- und ARC-Schlüssel (keys/<domain>/<selector>.key, 0600) und der Zustand des Signier-Daemons. Absichtlich von Sicherungen ausgenommen (Sicherung und Wiederherstellung).

/var/lib/pepsi-dkim-public

pepsi-dkim 0755

Die öffentliche status.json des Daemons (Selektoren, Einträge, ausstehende DNS-Änderungen) und, mit PUBLISH_RETIRED_KEYS, ausgemusterte Schlüssel.

/run/pepsi-dkim

pepsi-dkim 0711

Der Signier-Socket sign.sock (0660), das eigene RuntimeDirectory der Unit.

/run/pepsi-greylist

pepsi-greylist 0711

Der Socket milter.sock des Greylisting-Milters (0660, Gruppe pepsi-greylist), das eigene RuntimeDirectory der Unit.

/var/pepsi/tokens

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

OAuth-Zugriffstoken-Dateien: vom Refresher geschrieben, vom Smarthost-Relay über die Gruppe pepsi-token gelesen.

/var/pepsi/token-refresh

pepsi-helper-token-refresh 0700

Private, rotierte Refresh-Token; niemals gruppenlesbar.

/etc/pepsi/secrets

root:pepsi-helper-token-refresh 0750

Die @inline-secret@-Token-Refresh-Zugangsdaten; nur der Refresher darf sie lesen.

/etc/pepsi/secrets.d

root:root 0751

Die Fragmente, die pepsi-setup erzeugt: den SRS-Schlüssel, Smarthost-/LMTP-Passwörter, Händler- und Resume-Token, den Herkunftsnachweis-Schlüssel und den Schlüsselverschlüsselungsschlüssel für pepsi-crypto. Für alle durchsuchbar (nicht lesbar), damit jeder Dienst das eine Fragment erreicht, das er öffnen darf; die Fragmente selbst sind 0640 und gehören ihrem einzigen lesenden Konto. pepsi-setup legt das Verzeichnis an, falls es fehlt. Eine von Hand statt in einem Fragment in pepsi.conf eingetragene Zugangsinformation ist auf diese Weise nicht geschützt (siehe Mail-Appliances speichern Geheimnisse für alle lesbar oder ungeschützt).

/var/pepsi/tls

root:pepsi-token 2750

Mutual-TLS-Client-Zertifikat + -Schlüssel für das Smarthost-Relay (TLS_CLIENT_CERT / TLS_CLIENT_KEY).

/var/pepsi/krb5

root:pepsi-token 2750

Kerberos-Credential-Cache für AUTH = gssapi-Smarthosts (richten Sie KRB5CCNAME hier auf einen FILE:-Cache; ein externer Keytab-Refresher befüllt ihn).

/run/pepsi

root:root 0775 + ACL

Die Sockets für lokale Einlieferung, Administration, HTTP und den Setup-Applier. Angelegt vom tmpfiles.d-Snippet, dessen ACL pepsi-ingress und pepsi-httpd namentlich Schreibzugriff gewährt.

/var/lib/pepsi-wallets

pepsi-wallets:pepsi-wallets 0700

Home des Kontos pepsi-wallets und die Wallet-Datenbanken, die pepsi-helper-auto-pay darunter anlegt (wallets/<key>.sqlite3, Modus 0700). Nur mit pepsi-stage-auto-pay in WALLET_MODE = shared.

Die Verzeichnisse /var/pepsi/tokens, /var/pepsi/tls und /var/pepsi/krb5 (und das pepsi-helper-token-refresh-Konto) sind nur relevant, wenn Sie einen Smarthost mit dem entsprechenden AUTH-Mechanismus konfigurieren; eine standardmäßige Direkt-zu-MX- oder lokale-Zustellungs-Installation verwendet keines davon.

4.11. Von GNU Mailman migrieren

Eine bestehende GNU-Mailman-Installation – 2.1 oder 3 – zieht mit pepsi-list import und pepsi-archive import auf Pepsi um. Lesen Sie die Tabelle unten, bevor Sie anfangen, nicht danach.

Die Verhaltensunterschiede sind eine andere Tabelle, und sie wird hier nicht wiederholt: Erklärte Unterschiede zu GNU Mailman 3 in Mailinglisten sammelt jede Stelle, an der Pepsi absichtlich etwas anderes tut als upstream. Das sind die Ein-Klick-Abmeldung, das immer empfängerweise Fan-out, die verschleierten Absenderadressen im Archiv, der Löschgrabstein, die umbenannten X-Mailman-*-Header und das, was einfach fehlt (kein NNTP-Gateway, keine einsteckbaren Archivierer, keine Plugin-API). Zwei Kopien dieser Tabelle würden auseinanderlaufen, und die Kopie, die ein migrierender Betreiber zufällig liest, wäre die veraltete. Dieser Abschnitt handelt nur davon, was der Importer zurücklässt.

4.11.1. Was nicht mitkommt und warum

Warum

Passwörter

Weder die sha512_crypt-Hashes von Mailman-Core noch die pbkdf2_sha256-Hashes von Django aus mailman-web werden importiert. Der eigene Importer von upstream hat den Code, und er ist auskommentiert. Deshalb muss der Importer die Django-Datenbank überhaupt nie lesen, und deshalb gibt es nirgends in Pepsi einen Prüfer für Altlast-Hashes. Bestätigte Adressen bleiben bestätigt, niemand belegt also eine Adresse erneut; die Mitglieder wählen nur ein Passwort, und dafür ist pepsi-list invite da.

Bounce-Punktestände

Upstream importiert sie ebenfalls nicht: das bounce_info aus config.pck und die Bounce-Ereignisse von Mailman 3 werden beide verworfen, ein migriertes Mitglied beginnt also auf beiden Systemen bei Punktestand null.

Token in Bearbeitung

Ein anstehendes Bestätigungs- oder Moderationstoken ist ein Versprechen über einen Ablauf, den es nach der Umstellung nicht mehr geben wird. Wer mitten in einem Abonnement steckt, fragt erneut.

Topics (2.1)

Kein Gegenstück in Mailman 3.

Vorlagen-URIs, die wir nicht abrufen

Eine file:-Überschreibung würde die eigene Platte des Servers lesen und wird daher nicht importiert. Der Importer meldet jede solche URI zur Importzeit, statt die erste Benachrichtigung, die sie braucht, Monate später scheitern zu lassen, und die Liste fällt auf die eingebaute Vorlage zurück.

Eine Pepsi-Einstellung wird beim Import festgelegt statt übernommen: Eine Liste, die der Importer anlegt, erhält hold_dmarc_failures = no, sodass sie Beiträge, die DMARC nicht bestehen, weiterhin verteilt, wie GNU Mailman es tat; der Bericht vermerkt das je Liste. Schalten Sie es mit pepsi-list list set-ext <list> hold_dmarc_failures yes ein, sobald bekannt ist, dass die Absender der Liste bestehen (Einstellungen, die Pepsi erfunden hat).

Alles Weitere, was der Importer nicht verstanden hat, steht in seinem Bericht. Er endet mit einem Fehlerstatus, wenn etwas verloren ging, und das ist der Sinn: eine Migration, die halb funktionierte und mit Null endete, ist eine Migration, die niemand prüft. Nichts wird zurückgerollt, und einen Import erneut auszuführen ist gefahrlos: Jeder Schreibvorgang hängt an der Listen-ID, der Adresse oder der Message-ID, ein zweiter Lauf ist also eine Leeroperation.

4.11.3. Wenn unser Pickle-Leser strenger ist als ihrer

pepsi-list import mailman21 liest config.pck mit einem eigenen Parser, der nichts konstruiert: kein Modul wird nachgeschlagen und kein Aufrufbares aufgerufen, denn eine config.pck kommt vom Server eines anderen, und Pythons pickle.load auf nicht vertrauenswürdiger Eingabe ist das Ausführen beliebigen Codes.

Der Preis dafür ist Strenge. Der Leser kann eine Datei ablehnen, zum Beispiel wegen eines Opcodes, den er nicht implementiert, eines Protokolls, das neuer ist als alles, was Python 2 schreiben konnte, oder einer Ganzzahl, die für 64 Bit zu breit ist. Dann sagt er das und nennt die Notluke:

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

Dieses Skript läuft auf dem alten Server, mit dem Python, dem dieser Server ohnehin vertraute, und schreibt dasselbe Wörterbuch als JSON aus. Beide Wege gehen danach durch dieselbe Zuordnung, sie können sich also nicht darüber uneinig sein, was die Datei bedeutet. Eine Migration darf nie daran scheitern, dass unser Parser strenger ist als der, der die Datei geschrieben hat.

4.11.4. Header-Umbenennungen, die ein Benutzer bemerkt

Pepsi gibt X-Pepsi-List-* aus, wo Mailman X-Mailman-* ausgab; die Zuordnungstabelle steht in Mailinglisten. Das sind die echten Kosten eines migrierenden Benutzers, denn procmail- und Sieve-Regeln sind gegen diese Namen geschrieben, und es lohnt sich, es ihnen vor dem Wechsel zu sagen und nicht danach.