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 hatpostgresqlalsDependsund zieht es für Sie mit herein.)PostgreSQLs
postgresql-contrib– optional und nur für Mailinglisten. Es bringt die Erweiterungpg_trgmmit, 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 checksagt, in welchem Modus der Server ist. Es später zu installieren undpepsi-setup runerneut auszuführen schaltet es ein, danach braucht das bestehende Archiv einpepsi-archive reindex, um die Spalte zu füllen, die der Index liest.Das Debian-Paket führt es unter
Recommends, ein voreingestelltesapt installzieht 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_SERVERSoderDNS_SERVERSeiner 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 Beispielunbound(apt install unbound, dannnameserver 127.0.0.1inresolv.conf) oder systemd-resolved mitDNSSEC=yes. Wo das nicht möglich ist, geben Sie in[pepsi] DNS_SERVERSeinen 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 dasAD-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-setupnennt 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-statuszeigt 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
rustc1.95 oder neuer (die Untergrenze legt das mitgeliefertetaler-commonfest;./configurewarnt 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,~/.forwardund Wallet und ihre aufrufenden Stages, das Smarthost-Relay,pepsi-quota,pepsi-whitelistsowiepepsi-stage-encryptundpepsi-stage-decrypt(beide setuidpepsi-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) undpepsi-helper-mailbox-scan(daspepsi-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-Serverpepsi-dispatch— Stage-Dispatcherpepsi-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 Stagespepsi-setup— Einrichtung/Bootstrappepsi-queue— Inspektion/Reparatur der Warteschlangepepsi-status— Gesundheitszusammenfassung der Pipelinepepsi-reputation— IP-Sperrlisten für eingehende Mailpepsi-sendmail— lokale Submission (vom Debian-Paket als/usr/sbin/sendmailinstalliert)
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=DIRWohin 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=DIRDie 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/sendmailkommt.--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=NAMEDie 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-cryptoundpepsi-whitelist.--enable-docs/--disable-docsOb die Man-Pages und das Info-Handbuch aus den Quellen gerendert oder vorgebaut übernommen werden (was ein Release-Tarball mitliefert). Standardwert ist
auto: an, wennsphinx-build,makeinfound Python mitdocutilsallesamt vorhanden sind.--enable-mta-links/--disable-mta-linksOb
make install/usr/sbin/sendmailund 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 übergibtINSTALL_MTA_LINKS=yes, weil seinConflicts: mail-transport-agentdie Ausschließlichkeit bereits garantiert.--with-taler-wallet-cli=PATHDas einzige Wallet-Programm, das der setuid-Helfer
pepsi-helper-auto-payausfü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=FEATUREDie Kryptobibliothek hinter OpenPGP (Sequoias Backend), ausgewählt per Cargo-Feature. Genau eine wird eingebaut;
FEATUREist eines von:crypto-nettle(der Standard)Nettle mit seiner Public-Key-Hälfte
hogweedund 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, dasnettle/pgp.hentfernt hat; auf einem System, das Nettle 4 mitbringt (etwa Homebrew), wählen Sie dahercrypto-openssl.crypto-opensslOpenSSLs
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
configurelautet dieselbe Wahlmake build CRYPTO_BACKEND=crypto-openssl.--jobs=NWie 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.shunmittelbar 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.Nlegt die Zahl stattdessen fest. OhneconfigurebewirktCARGO_BUILD_JOBS=Nin der Umgebung oder auf dermake-Befehlszeile dasselbe.make -jNerhöht die Zahl nicht, begrenzt sie aber aufN, und der Debian-Build übernimmt diese Grenze ausDEB_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-binBaut 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 inSTANDALONE_BINARIESim Makefile genannt sind, werden als eigene ausführbare Dateien in$(DESTDIR)$(PREFIX)/bininstalliert. Weil jeder Symlink weiterhin in$(PREFIX)/bin(auf$PATH) liegt, ist die Laufzeit-Herleitung vonDATADIRunten davon unberührt.install-dataKopiert die SQL-Dateien von
pepsi-setup/db/nach$(DESTDIR)$(DATADIR)/sql(wobeiDATADIR = $(PREFIX)/share/pepsi).pepsi-setupliest diese beim Installieren des Schemas; der Standardwert vonSQL_DIRist${DATADIR}/sql. Installiert außerdemcontrib/hosters.txtals$(DATADIR)/hosters.txt, die Liste öffentlicher Hoster, für diepepsi-whitelist import --auto-wildcardnie 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, siehepepsi-keys blocklist update.)install-templatesKopiert 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)/templatesist. Der Standardwert[pepsi] TEMPLATE_DIRder Binärprogramme ist${DATADIR}/templatesund wird über dieselbe Laufzeitableitung aufgelöst, sodass beide Enden unter jedem Präfix übereinstimmen, ohne dass die Konfiguration einen Pfad nennt.install-configInstalliert die Referenzdatei
pepsi.conf.sampleunter$(DESTDIR)$(SYSCONFDIR)/pepsi/. Sie legt nie einepepsi.confan: Die Vorlage bindet optionale Stages ein, die weitere Einrichtung brauchen, und ist keine funktionierende Konfiguration; die produktive Datei kommt daher vonpepsi-setup --wizard(eine vorhandene wird nie angefasst).install-config-dKopiert
contrib/config.d/*.confnach$(DESTDIR)$(DATADIR)/config.d. Dies sind paketierte Standardwerte, keine conffiles, und sie werden vorpepsi.confgeparst — siehe Konfiguration. Eine wird mit Pepsi ausgeliefert: die Texte der Abwesenheitsnotiz je Sprache. Liegt in diesem Verzeichnis einethunderbird.conf, löscht das Ziel sie: Jede Datei dort wird geparst, und diese Datei setztCRYPTO_ALLOW_DOWNGRADE = yesfür jeden Peer, während der S/MIME-Fähigkeitseintrag je Peer entscheidet.install-man/install-infoInstalliert die gerenderten roff-Handbuchseiten unter
$(DESTDIR)$(MANDIR)/manNundpepsi.infounter$(DESTDIR)$(INFODIR)(mitinstall-inforegistriert). MitBUILD_DOCS=no— was./configure --disable-docssetzt 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-docInstalliert
README.md,NEWS,SECURITY.md,AUTHORS,COPYINGund die Lizenztexte ausLICENSES/unter$(DESTDIR)$(DOCDIR), standardmäßig$(DATAROOTDIR)/doc/pepsi.install-systemdInstalliert die systemd-Units aus
debian/systemd/in$(DESTDIR)$(SYSTEMDUNITDIR)(wobei/usr/binund/etc/pepsiauf die konfiguriertenBINDIR/SYSCONFDIRumgeschrieben werden) sowie dastmpfiles.d-Bruchstück, das/run/pepsiseinen Eigentümer und seine ACL gibt. Dieses Bruchstück ist die einzige Quelle der Rechte dieses Verzeichnisses, denn keine Unit darf es alsRuntimeDirectorydeklarieren (siehe Keine Unit darf es als RuntimeDirectory beanspruchen). Alles wird deaktiviert ausgeliefert.make install INSTALL_ADMIN_UNITS=nolässt die beidenpepsi-setup-apply-Units weg, was dem Nichtinstallieren des Paketspepsi-httpd-adminbei 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 checkDer 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 --lockedund die Querverweisprüfung des Handbuchs. Jeder dieser Schritte wird übersprungen statt als Fehler gewertet, wenn seine Voraussetzung fehlt.make integrationtests/make benchmarksDie Live-Pipeline-Skripte unter
tests/, die passwortloses SSH zu den inACCOUNTSgenannten Hosts benötigen (Standardwerttests/test-accounts.ini, angelegt austests/test-accounts.ini.sample);integrationtestsführt zuerst die Thunderbird-Interoperabilitätsschranke aus. Die Benchmarks sind ein eigenes Ziel, weil sie den MTA absichtlich belasten.make docsDas 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 undmake docs-allbaut jede Sprache inDOC_LANGUAGES(en de fr);make htmlbaut allein das HTML jeder Sprache.make dist/make distcheckBauen den Release-Tarball
pepsi-$(VERSION).tar.gz(jede versionierte Datei einschließlich des mitgelieferten Submoduls, dazuconfigureund vorgebaute Dokumentation) und prüfen ihn, indem sie ihn in einen sauberen Baum entpacken undconfigure,make,make check,make installundmake uninstallgegen ein Wegwerf-Präfix ausführen. Der Tarball wird aus dem Arbeitsbaum kopiert; deshalb verweigertmake distdie Arbeit, solange eine versionierte Datei vonHEADabweicht oder das Submodul nicht auf dem inHEADverzeichneten Commit steht (unversionierte Dateien zählen nicht);make dist DIST_ALLOW_DIRTY=yesbaut 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-signSigniert einen vorhandenen Release-Tarball: eine abgetrennte, ASCII-armierte OpenPGP-Signatur
pepsi-$(VERSION).tar.gz.ascmit dem Standardschlüssel von gpg oderDIST_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 debBaut die Debian-Pakete nach
target/debian/(Debian-Pakete), unsigniert;make deb DEB_SIGN_KEYID=<fingerprint>signiert die Dateien.changesund.buildinfomit diesem Schlüssel.make clean/make distcleancleanführtcargo cleanaus und entfernt die gerenderte Dokumentation;distcleanentfernt zusätzlichconfig.mk,config.statusund alles, wasmake disterzeugt 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):
Legen Sie die Systemkonten an, jedes
--systemmit/usr/sbin/nologinund Home/var/pepsiund einer privaten Gruppe gleichen Namens, dazu die absichernden Gruppen.debian/pepsi.postinstist 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-whitelistist das Konto, auf das das CLI für weiße Listen setuid ist,pepsi-cryptoist die einzige Datenbankrolle, dercrypto_identity.private_wrappedgewährt ist, und der Eigentümer des Fragments mit dem Schlüsselverschlüsselungsschlüssel,pepsi-keydiscist die engste Rolle der Installation (sie parst Schlüsselmaterial, das aus dem offenen Internet geholt wurde),pepsi-configist die einzige Rolle, die die Konfigurationsüberlagerung schreiben darf, undpepsi-greylistführt den Greylisting-Milter aus, dessen Socket seine Gruppe gehört. Wenn Siepepsi-cryptoauslassen, warntinstall-crypto-suidlediglich, und die beiden Krypto-Stages bleiben unprivilegiert und können keinen einzigen privaten Schlüssel öffnen.Legen Sie die zehn PostgreSQL-Login-Rollen und die Datenbank an (Peer-Authentifizierung, als
postgres-Superuser). Das ist dieselbe Menge, diedebian/pepsi.postinstanlegt: jedes Konto, das sich über den Peer-Authentifizierungs-Socket als es selbst authentifiziert.pepsi-telemetrygehört auch auf einem Knoten dazu, der keine Telemetrie bedient. Dennpepsi-setup runvergibt ihm auf jedem Host Rechte, undpepsi-setuperledigt seine Datenbankarbeit alspepsi-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
Führen Sie
make installalsrootaus (siehe oben), damit die setuid/setgid-Bits gesetzt werden; andernfalls setzen Sie sie von Hand gemäß Privilegierte Binärprogramme unten. Jedesinstall-*-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.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-telemetryundpepsi-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/secretsund/etc/pepsi/secrets.dmit 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 undpepsi-quota), beim setgid-Smarthost-Relay, beim setuidpepsi-whitelistund bei den beiden setuid-pepsi-crypto-Stages (siehe Privilegierte Binärprogramme unten); undlegt 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 diepepsi-Datenbank (im Besitz vonpepsi-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/libund/etc/pepsimit denselben Eigentümern und Modi an.Sie setzt dieselben setuid- und setgid-Bits auf den privilegierten Programmen.
Sie trägt
/runin/etc/synthetic.confein, wodurch/runein Link auf/private/var/runwird. Erscheint/runnicht 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-ingressundpepsi-httpdihre 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-setupstartet ihre launchd-Jobs neu, wenn sich ihre TLS-Dateien ändern, und der certbot-Deploy-Hook startet sie nach einer Erneuerung neu./etc/pepsi/postgres.envwird nur von den Jobs gelesen, die als root laufen. Geben Sie stattdessen jedem Konto über den Platzhalter{role}in[pepsi-postgres] CONFIGeigene Zugangsdaten.Der Setup-Applier (
pepsi-httpd-adminunter Debian) hat keinen launchd-Job, daher sind die Konfigurationsseiten der Browser-Konsole schreibgeschützt; verwalten Sie die Installation mitpepsi-setupin 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.tomlnennt die genauerustc-Version;rustupverwendet (und installiert) in diesem Baum genau diese. Eine nicht vonrustupverwaltete Toolchain ignoriert die Datei, und ein anderer Compiler ergibt eine andere Binärdatei; verwenden Sie daherrustup, um ein Release zu reproduzieren;die Crates —
Cargo.lockmit--locked, das jedesmake-Ziel übergibt;die Pfade —
make buildbildet den Checkout, das Zielverzeichnis (CARGO_TARGET_DIRodertarget/im Checkout) und den Crate-Cache (CARGO_HOME, Standard~/.cargo) auf die festen Namen/build,/targetund/cargoab, jeweils unter seinem eigenen und seinem kanonischen Pfad, fürrustc(--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 = trueentfernt die Symboltabellen. Ein symbolischer Link innerhalb des Crate-Caches ist nicht abgedeckt: Halten Sie ihn als echten Baum;die Zeit —
SOURCE_DATE_EPOCHwird als Datum des Commits exportiert und ist das, was die mtimes des Tarballs und die Datumsangaben der Dokumentation verwenden; übergeben SieSOURCE_DATE_EPOCH=<seconds>, um es in einem Baum zu überschreiben, der kein git-Checkout ist;der Tarball —
make distschreibt ihn mittar --sort=name --mtime=@$SOURCE_DATE_EPOCH --owner=0 --group=0 --numeric-ownerundgzip -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äßigpepsi-keydisc@dane,@wkd-advanced,@wkd-directund@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, denpepsi-ingress(oder ein vorgeschalteter Postfix) beiRCPTbefragt.
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:
Lesen Sie
NEWSzu dem Release. Es führt geänderte Konfigurationsoptionen auf und alles andere, was von Hand zu erledigen ist.Legen Sie eine Sicherung an (Sicherung und Wiederherstellung), oder aktivieren Sie zumindest den unten beschriebenen automatischen Dump.
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, dannpepsi-setup -c /etc/pepsi/pepsi.conf schemaundsystemctl try-restart pepsi.target.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 |
Eine Neuinstallation: |
älter als dieses Programm |
|
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 |
gespeicherte Funktionen aus einem anderen Build |
Nur bei Entwicklungs-Builds: |
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:
Installieren Sie das neue Release wie oben beschrieben.
Führen Sie
pepsi-setup -c /etc/pepsi/pepsi.conf runaus. Es übergibt die Signier-Domains anpepsi-dkim, das die Schlüssel erzeugt, die alten Schlüsseldateien unterKEY_DIRlöscht und die neuen DKIM-Einträge ausgibt, mit den alten Einträgenpepsiundpepsi-ed25519als zu entfernende Kommentare.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 statusund die Mail des Daemons an den Postmaster sagen, was noch fehlt.Entfernen Sie die alten Einträge
pepsi._domainkeyundpepsi-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 |
|---|---|---|
|
|
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 |
|
|
HTTP/HTTPS-Server (MTA-STS-Policy, Web Key Directory, Secure-Link-Portal und, auf administrativen Listenern, |
|
|
Die Arbeitsidentität der Pipeline. Lässt Nachrichten von |
|
|
Kein Laufzeitdienst. Besitzt die |
|
|
Nur benötigt, wenn ein Smarthost |
|
|
Verwahrer des privaten Ende-zu-Ende-Schlüsselmaterials. Besitzt |
|
|
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 |
|
|
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. |
|
|
Die einzige Datenbankrolle, die das Overlay |
|
Dienst |
Der Greylisting-Milter. Seine Gruppe ist die Gruppe seines Sockets |
|
Dienst |
Verwahrer der privaten DKIM- und ARC-Schlüssel, Dateien mit Modus 0600 in seinem Home-Verzeichnis |
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.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 |
|---|---|---|
|
|
Setuid root, damit es in das Postfach jedes lokalen Benutzers schreiben kann; gruppengesperrt, sodass nur |
|
|
Setgid, damit der |
|
|
Dieselbe Gruppe und derselbe Grund: |
|
|
Setuid root, damit es die |
|
|
Setgid, damit der |
|
|
Setuid root, damit es auf das Konto, dem das Wallet gehört (oder auf die eigene uid des Empfängers), herabgehen kann, um |
|
|
Setgid, damit der |
|
|
Setgid, damit der |
|
|
Setuid und absichtlich für alle ausführbar: Jeder lokale Benutzer darf seinen eigenen |
|
|
Setuid, nicht setgid: Die Peer-Authentifizierung von PostgreSQL richtet sich nach der effektiven uid, und |
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 |
|---|---|---|
|
|
Dienst-Home. |
|
|
Die privaten DKIM- und ARC-Schlüssel ( |
|
|
Die öffentliche |
|
|
Der Signier-Socket |
|
|
Der Socket |
|
|
OAuth-Zugriffstoken-Dateien: vom Refresher geschrieben, vom Smarthost-Relay über die Gruppe |
|
|
Private, rotierte Refresh-Token; niemals gruppenlesbar. |
|
|
Die |
|
|
Die Fragmente, die |
|
|
Mutual-TLS-Client-Zertifikat + -Schlüssel für das Smarthost-Relay ( |
|
|
Kerberos-Credential-Cache für |
|
|
Die Sockets für lokale Einlieferung, Administration, HTTP und den Setup-Applier. Angelegt vom |
|
|
Home des Kontos |
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 |
Bounce-Punktestände |
Upstream importiert sie ebenfalls nicht: das |
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 |
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.2. Die empfohlene Reihenfolge¶
Tun Sie es in dieser Reihenfolge. Der Grund steht in Schritt 4.
Die Konfiguration und die Mitgliederliste importieren, gegen den laufenden alten Server:
pepsi-list import mailman3 --rest http://localhost:8001 \ --user restadmin --password-file /etc/mailman3/rest.pw \ --report /root/mailman-import.txt
Oder, für einen Mailman-2.1-Server, dessen Server schon abgeschaltet ist:
pepsi-list import mailman21 --listdir /var/lib/mailman/lists \ --report /root/mailman-import.txt
Setzen Sie zuerst
--dry-rundavor: es liest alles, meldet alles und schreibt nichts.Das Archiv importieren, je Liste:
pepsi-archive import --list announce@lists.example.org \ --rejects /root/rejected.txt /var/lib/mailman/archives/private/announce.mbox/*.mbox
Threads werden am Ende automatisch wieder zusammengehängt und neu nummeriert. Sonst würde ein Import in falscher Reihenfolge sie getrennt lassen, und genau diesen Fehler soll dieser Befehl nicht wiederholen.
Prüfen.
pepsi-list check --strict, dann die Einstellungen einiger Listen gegen den alten Server stichprobenartig abgleichen. Über REST antworten beide Enden auf/3.1/lists/<id>/config, der Vergleich geht also attributweise und nicht nach Augenmaß.Die IP mit dem Einladungslauf aufwärmen, während der alte Server noch Post zustellt.
pepsi-list invite send --dry-run # the per-domain histogram pepsi-list invite send --rate 200 --limit 500 pepsi-list invite status
Dies ist der Schritt, bei dem der Zeitpunkt zählt. Jedem Mitglied zu sagen, es solle ein Passwort wählen, ist die größte Einzelsendung, die dieser Server je verschicken wird. Sie geht an eine Adressliste, die der Server nie geprüft hat, von einer IP-Adresse ohne Reputation, und genau so wird die Reputation einer neuen Installation am ersten Tag zerstört. Tun Sie es vor dem MX-Wechsel, dann wird ein Drosselungs- oder Sperrproblem sichtbar, solange der neue Server die Mail noch nicht trägt.
Das Histogramm des Probelaufs ist ein Werkzeug für die Zustellbarkeit und kein Fortschrittsbalken: ein Anbieter, der vierzig Prozent eines migrierten Servers hält, ist die Tatsache, die die Rate bestimmt, und sie ist unsichtbar, solange sie niemand zählt. Einladungen gelten vier Wochen, der Lauf setzt dort fort, wo er aufhörte, und niemand wird abgemeldet, weil er nicht antwortet: Ein Mitglied, das nie handelt, behält sein Abonnement und kann sich lediglich nicht anmelden, bis es den Link benutzt oder um einen neuen bittet.
Den MX umschalten und erst dann den alten Server abschalten.
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.