68. pepsi-setup

Richtet Datenbank, Signierschlüssel und DNS für eine Installation ein.

68.1. Rolle

pepsi-setup ist das administrative Bootstrap-Werkzeug. In einem Aufruf validiert es die Konfiguration, installiert das Schema, lässt den DKIM-Signier-Daemon die ihm fehlenden Signierschlüssel erzeugen und gibt die zu veröffentlichenden DNS-Einträge aus; ein separates check verifiziert Live-DNS. Referenzen: pepsi-setup(1) / pepsi.conf(5).

68.2. Funktionen

  • Konfigurationsvalidierung. Parst [pepsi], [pepsi-ingress], [pepsi-dkim] und die [stage-*]-Pipeline; prüft, dass [stage-init] existiert, dass jedes NEXT_STAGE/BOUNCE_STAGE auflöst, dass die Programmkonfiguration jeder Stage (einschließlich Smarthost-Routing) geparst werden kann und dass Domains und PUBLIC_IP-Werte wohlgeformt sind. Bei einem Fehler ändert es nichts und beendet sich mit einem Wert ungleich null.

  • TLS-Zertifikat-Einrichtung. Für jeden TLS-terminierenden Listener-/Zertifikatsabschnitt ohne TLS_CERT/TLS_KEY füllt es das Standard-certbot-Pfad-Layout aus (schreibt die Konfigurationsdatei an Ort und Stelle um, Kommentare erhalten) und führt dann certbot certonly --standalone aus, um jedes noch nicht auf der Festplatte vorhandene Zertifikat zu beziehen (oder eines zu erweitern, das nicht mehr jeden Namen abdeckt). Übergeben Sie --no-certbot, um den certbot-Aufruf zu überspringen und Zertifikate selbst zu verwalten. Ein fehlendes Zertifikat, das nicht bezogen werden kann, wird zurückgestellt, nicht als fatal behandelt: Der Rest des Laufs wird fortgesetzt, und die Zusammenfassung am Ende des Laufs nennt, was noch zu tun ist.

  • Einrichtung des TLS-Zugriffs. Die Server laufen unter unprivilegierten Benutzern, während certbot /etc/letsencrypt nur für root lesbar hält. Unter systemd schreibt pepsi-setup pro Unit ein LoadCredential=-Drop-in, sodass systemd jedes Zertifikat und jeden Schlüssel beim Start der Unit als root liest und dem Dienst eine private Kopie übergibt — die Dateirechte spielen dann überhaupt keine Rolle. Zusätzlich vergibt es POSIX-ACLs und installiert einen certbot-Deploy-Hook (der die Rechte erneut vergibt und die Server neu startet, damit ein erneuertes Zertifikat auch wirklich ausgeliefert wird). Schließlich prüft es, ob alles Übrige tatsächlich lesbar ist: Es wird zum Dienstbenutzer und öffnet die Datei.

  • Schema-Installation. Der einzige Installer des einzigen pepsi-Schemas: wendet die nummerierte Patch-Serie und die neu erstellbaren Prozeduren aus SQL_DIR an; idempotent und wiederholbar. Er hält per Inhalts-Hash fest, was er angewendet hat, sodass jedes Programm ein Schema aus einem anderen Release zurückweisen kann, und weigert sich selbst, über ein neueres Schema zu installieren (siehe Upgrade). run --reset verwirft das Schema und erstellt es neu (zerstört eingereihte Mail; die DKIM-Schlüssel, die pepsi-dkim(1) in Dateien hält, bleiben unberührt).

  • Signierschlüssel. pepsi-setup hält keinen privaten Schlüssel. Es übergibt jede Domain, für die Pepsi autoritativ ist, an den Signier-Daemon (pepsi-dkim sync-domains, pepsi-dkim(1)): ACCEPTED_DOMAINS, die SERVER_NAME-/POSTMASTER-Domain jeder Stage, jedes ausdrückliche SIGNING_DOMAIN, SRS_DOMAIN oder feste RESPONSE_FROM sowie ARC_DOMAIN, zusammengenommen. Der Daemon erzeugt unter seinem eigenen Konto für jede Domain, die noch keine Schlüssel hat, einen RSA-Schlüssel mit [pepsi-dkim] RSA_BITS (Standardwert 2048) und einen Ed25519-Schlüssel (RFC 8463) und meldet ihre Einträge. Ein Daemon, der nicht ausgeführt werden kann, schiebt den Schritt auf, nicht den Lauf. DKIM-Schlüsseldateien, die noch unter [pepsi] KEY_DIR liegen (<domain>/dkim.rsa.key und <domain>/dkim.ed25519.key), werden gelöscht, sobald der Daemon antwortet, da nichts mehr mit ihnen signiert, und ihre Einträge werden als entfernbar aufgeführt.

  • Ausgabe der DNS-Einträge. Gibt im BIND-Zonenformat die öffentlichen DKIM-Schlüssel aus, die der Daemon als benötigt meldet (<DKIM_SELECTOR>-YYYYMM._domainkey und <DKIM_SELECTOR>-YYYYMM-ed25519._domainkey, während einer Rotation auch die der nächsten Generation; entfernbare als Kommentare), eine aus dem PUBLIC_IP jeder Relay-Stage (vereinigt) gebaute SPF-Richtlinie, einen DMARC-Vorschlag, wo keiner veröffentlicht ist (mit rua=mailto:dmarc-reports@<domain>, wenn eine Stage pepsi-stage-dmarc-report ausführt), einen MTA-STS-_mta-sts-TXT-Eintrag (RFC 8461), einen TLSRPT-Eintrag, wenn [pepsi-tlsrpt] RUA gesetzt ist, und DANE/TLSA-Einträge für die TLS-Listener, dazu einen auskommentierten, optionalen CAA-Vorschlag (RFC 8659, mit der accounturi des certbot-Kontos, wenn sie sich lesen lässt), wenn die Zertifikate von Let’s Encrypt stammen, und ein auskommentiertes Wildcard-*.<domain>. TXT "v=spf1 -all" für die Subdomains, unter denen niemand sendet, wobei sp=reject; np=reject für einen DMARC-Eintrag empfohlen wird, der ihnen eine schwächere Richtlinie lässt. Bereits mit dem richtigen Wert veröffentlichte Einträge werden weggelassen. Die Richtliniendatei selbst wird von pepsi-httpd bereitgestellt, nicht ausgegeben. Lange RSA-Einträge werden in mehrere Zeichenketten aufgeteilt. Derselbe SPF-Eintrag wird für jede bediente Domain vorgeschlagen; die Ausgabe weist darauf hin, dass besondere Multi-Host-Konstellationen eine engere, dennoch korrekte domainspezifische Gruppierung bevorzugen könnten, die pepsi-setup nicht automatisch berechnet.

  • Live-DNS-Verifikation (check): fragt das DNS ab und meldet je Domain, ob das veröffentlichte DKIM-p= zum Schlüssel passt, den der Daemon hält (ein Eintrag, den ein DNS-Hoster bei einer 255-Byte-Zeichenkette abgeschnitten hat, wird als solcher benannt; der Eintrag eines ausgemusterten Schlüssels wird als entfernbar aufgeführt), ob der SPF-Eintrag jede PUBLIC_IP aufführt und jeder seiner Terme der Grammatik von RFC 7208 folgt (ein unbekannter Mechanismus wie ipv4: macht den ganzen Eintrag ungültig), ob der DMARC-Eintrag gültig ist und seine rua=/ruf=-Ziele die Berichte empfangen können (ein externes muss seinen _report._dmarc-Autorisierungseintrag veröffentlichen) und ob das _mta-sts-TXT vorhanden und parsebar ist. Eine Gruppe DMARC reports sagt je Domain, ob jede gemeldete Quelle ausgerichtet war, sodass p=reject sicher ist, oder welche Quellen es ablehnt (beratend); sie stützt sich auf die authentifizierten Sammelberichte, die pepsi-stage-dmarc-report für die letzten WINDOW_DAYS gespeichert hat. Es vergleicht außerdem die MTA-STS-Richtlinie mit den Live-MX-Einträgen und mit dem, was tatsächlich ausgeliefert wird, und prüft, ob die SRS-Domain ihre Bounces empfangen kann. Wenn ALLOW_ALIGNED_DOMAIN eine mit einer bedienten Domain ausgerichtete SRS-Domain annimmt, prüft es auch, ob der DMARC-Eintrag der bedienten Domain (aspf=s oder eine durchsetzende Richtlinie mit eingeschaltetem DMARC_ENFORCE) den SPF-Weg schließt, den gefälschte Mail nehmen würde. Es vergleicht jeden veröffentlichten TLSA-Eintrag mit dem Zertifikat, das der Listener ausliefert (passt ein Eintrag nicht mehr zum Schlüssel, lehnen Absender, die DANE durchsetzen, unsere Mail ab), und fragt öffentliche validierende Resolver, ob dieser TLSA-Eintrag und die MX-Einträge der angenommenen Domains DNSSEC-authentisch sind (ein Eintrag ohne das AD-Bit wird nie für DANE verwendet). Es meldet ins Leere zeigende Ziele: einen MX- oder NS-Host ohne Adresse, einen CNAME bei mta-sts., openpgpkey. oder autoconfig., der auf einen Namen ohne Adresse zeigt, ein SPF-include:/redirect=, das eine Domain ohne SPF-Eintrag nennt, und ein SPF-a:/mx:, das einen Host ohne Adresse oder MX nennt. Es führt die Subdomains auf, die die Konfiguration nennt (der EHLO-Host, mta-sts., autoconfig.) und die ohne eigenen SPF-Eintrag existieren, was ein Wildcard nicht abdeckt. Es ruft jeden HTTPS-Namen ab, unter dem pepsi-httpd erreicht wird, und meldet einen, dessen Antwort keinen Strict-Transport-Security-Header von mindestens sechs Monaten hat (ein vorgelagerter Server, der ihn nicht weiterreicht). Und es zählt die DNS-Abfragen, die der SPF-Eintrag der Domain einen Empfänger kostet, über jedes include hinweg, gegen die Grenzen von RFC 7208 von 10 Abfragen und 2 leeren Abfragen. Für jede Adresse mit einer veröffentlichten Ende-zu-Ende-Identität ruft es ab, was das Web Key Directory und die OPENPGPKEY/SMIMEA-Einträge ausliefern, und meldet einen Fingerabdruck, den der Schlüsselspeicher nicht veröffentlicht (Prüfen, was tatsächlich ausgeliefert wird). Informativ: Seine Befunde setzen den Exit-Status nur mit --fail-on-findings, das pepsi-setup-check.timer täglich ausführt; geht ein Eintrag später kaputt, schlägt diese Unit fehl (systemctl --failed). run protokolliert dieselben TLSA- und Leere-Ziel-Befunde als Warnungen und warnt, wenn eine Komponente, die dem DNSSEC-AD-Bit vertraut (DANE in einer Relay-Stage oder in der Schlüsselentdeckung), einen Resolver verwendet, der nicht validiert; run und check nennen beide mit ihren IP-Adressen die Resolver außerhalb dieses Hosts, denen die Installation die DNSSEC-Validierung anvertraut (nichts, wenn jeder Resolver auf Loopback liegt). Die Validierung warnt außerdem vor einem MYNETWORKS-Eintrag des Ingress, der breiter als ein Host ist (nicht Loopback), da jeder Host darin weiterleiten und als jede Adresse senden darf, und die Reverse-Proxy-Site, die es für nginx oder Apache schreibt, schaltet TLS-Session-Tickets für Forward Secrecy ab. Die Site setzt keine Cipher-Liste (die des vorgelagerten Servers wird mit dessen anderen Sites geteilt), aber run liest die effektive Konfiguration des vorgelagerten Servers (nginx -T oder den Konfigurationsbaum von Apache) und warnt, wenn sie noch TLS-1.2-Suites ohne Forward Secrecy (statischen RSA-Schlüsselaustausch) aktiviert, oder sagt, dass es das nicht feststellen konnte.

  • Setup-Assistent (--wizard): ein kurzes interaktives Interview, das eine vollständige, bereits validierte Konfigurationsdatei schreibt (in den --config-Pfad oder standardmäßig /etc/pepsi/pepsi.conf) und dann anbietet, das vollständige Setup auszuführen. Es importiert die Antworten eines vorherigen Laufs aus dem [pepsi-wizard]-Abschnitt der Datei; --force überschreibt eine Datei ohne einen solchen Abschnitt ohne Nachfrage.

Verwenden Sie pepsi-config, um die effektive Konfiguration zu inspizieren.

68.3. Sicherheit

pepsi-setup ist der Ort, an dem die meisten Privilegiengrenzen der Installation eingerichtet werden, und es verifiziert sie, statt sie vorauszusetzen:

  • Datenbankrollen. Jedes Dienstkonto erhält eine eigene, per Peer authentifizierte Rolle. pepsi und pepsi-crypto erhalten die Pipeline-Berechtigung abzüglich der Rücknahmen (nur pepsi-crypto darf crypto_identity.private_wrapped lesen oder otp_key anfassen; die anderen Rollen dürfen nur die Verwendungs-Flags einer Identität aktualisieren); pepsi-ingress, pepsi-httpd und pepsi-telemetry sind auf das zurechtgestutzt, was ihr Code verwendet; pepsi-keydisc, pepsi-whitelist und pepsi-config erhalten einige benannte Tabellen oder Spalten. Die Tabellen mit Zugangsdaten (einschließlich own_enrolment/own_session) gehören allein pepsi-httpd, crl_cache wird allein von pepsi-keydisc geschrieben, und nur pepsi-config darf config_override schreiben oder eine setup_task einreihen. Nachdem sie angewendet wurden, fragen run und schema PostgreSQL und weigern sich, abzuschließen, wenn etwas nicht übereinstimmt (Ein Angreifer, der die Datenbank hat).

  • Geheimnisse. Jedes Geheimnis liegt in einem secrets.d-Fragment, das dem einen Konto gehört, das es liest, und bei jedem Lauf als Erstes gesichert wird; der Schlüsselverschlüsselungsschlüssel wird nur erzeugt, wenn die Datenbank bestätigt, dass noch kein verpackter Schlüssel existiert (Ein Angreifer, der die Konfigurationsdatei hat, Die Verwahrungsgrenze für private Schlüssel).

  • Abgelehnte Konfigurationen. Eine [pepsi-srs] SRS_DOMAIN, die mit einer bedienten Domain DMARC-ausgerichtet ist (sofern nicht ALLOW_ALIGNED_DOMAIN = yes), da die Weiterleitung Fälschungen dieser Domain zu einem DMARC-Pass reinwaschen würde; ein CRYPTO_GENERATE_RSA_BITS außer 2048, 3072, 4096 oder 8192 oder unter CRYPTO_MIN_RSA_BITS; ein gemeinsamer S/MIME-Schlüssel auf einer elliptischen Kurve; ein KEY_WRAP_SECRET kürzer als 16 Zeichen. Ein MYNETWORKS-Eintrag breiter als ein Host und ein vorgelagerter Server, der noch TLS-1.2-Suites mit statischem RSA anbietet, sind Warnungen.

  • DNSSEC-Vertrauen. Ist DANE in Gebrauch (DANE = strict ist der Standard der Relay-Stages), prüft run, dass der Resolver das AD-Bit setzt, und nennt die Resolver außerhalb des Hosts, denen die Installation die Validierung anvertraut (Der Netzwerkangreifer).

  • Wiederverwendete Logins. run aktualisiert das Login-Zuordnungsverzeichnis nach RFC 7293 und meldet Schlüsselmaterial, das älter ist als der aktuelle Inhaber eines Logins (Ein Login, das den Eigentümer wechselt).

  • Der Applier. apply handelt nur nach einer geschlossenen Liste von siebzehn Aufgabenarten, jede autorisiert durch den festgehaltenen Geltungsbereich und dadurch, dass der Datensatz über die Rolle pepsi-config geschrieben wurde; es gibt keinen Neustart und keinen beliebigen Befehl. Der zweite Faktor der Anfrage eines Inhabers (confirm-enrolment eingeschlossen) wird hier geprüft, nie von der Web-Schicht (Ein zweiter Faktor für die Schlüsselverwaltung, Anmeldung an der Konsole per E-Mail, Eine kompromittierte Komponente). Die Begründung steht in pepsi-setup(1), The applier’s trust model.

68.4. Kommandozeilenoptionen

Ohne Unterbefehl führt pepsi-setup das vollständige Setup durch (dasselbe wie run). Die vollständigen Details stehen in pepsi-setup(1); die Optionen sind:

Unterbefehle:

  • run — validieren, TLS einrichten, Schema installieren, die signierenden Domains an pepsi-dkim übergeben, DNS ausgeben (die Standardaktion). -r/--reset verwirft zuerst das Schema und erstellt es neu (zerstört die gesamte eingereihte Mail; die DKIM-Schlüssel bleiben erhalten).

  • schema — installiert das Schema und die Rollenrechte oder führt ihr Upgrade durch, und sonst nichts; braucht nur [pepsi-postgres] und funktioniert daher auch mit der Konfigurationsdatei eines Telemetrie-Collectors. Weist ein neueres Schema zurück (Exit-Status 78). --backup-dir DIR sichert das Schema zuerst mit pg_dump, wenn es etwas zu aktualisieren gibt, und --backup-keep N löscht danach alle Sicherungen außer den N neuesten (Standardwert 2, 0 behält alle); --if-installed tut nichts bei einer Datenbank, die noch kein Schema hat. Dies führt eine Paketaktualisierung aus; siehe Upgrade.

  • check — fragt das Live-DNS ab und meldet Abweichungen; nimmt keine Änderungen vor, und seine Befunde setzen den Exit-Status nur mit --fail-on-findings (Exit 1 bei einem fehlenden, falschen, ungültigen oder unerreichbaren Eintrag oder einem Sperrlisteneintrag, jeweils auch als Warnung protokolliert; eine fehlgeschlagene Abfrage zählt nicht). Es warnt außerdem vor adressbezogenem Zustand (Einstellungen, Identitäten im Schlüsselspeicher, <login>/...-Whitelists, Postfach-Quotas), der für ein nicht mehr existierendes Login aufbewahrt wird, und vor Schlüsselmaterial, das älter ist als der aktuelle Inhaber eines Logins (Login-Zuordnungsverzeichnis nach RFC 7293; die Datenbank verwirft Einstellungen, Whitelists, Quota und Antwortprotokolle des vorherigen Inhabers selbst, nie Schlüssel); run protokolliert dieselben Warnungen.

  • validate — prüft die Konfiguration genau so, wie run es tut, und ändert nichts (keine Datenbank, kein DNS, keine Schlüssel oder Zertifikate); endet bei einer Zurückweisung mit Exit-Status 1. Führen Sie es aus, nachdem Sie pepsi.conf bearbeitet haben und bevor Sie etwas neu starten.

  • visualize — die [stage-*]-Pipeline als Graphviz-dot-Graph auf der Standardausgabe ausgeben (eine durchgezogene Kante je NEXT_STAGE, eine gestrichelte rote je BOUNCE_STAGE); leiten Sie sie nach dot -Tpng.

  • questions — das Einrichtungsinterview als JSON ausgeben: die Schritte, die Gestalt jeder Frage, ihren Standardwert, ihren Hilfetext und wann sie gestellt wird. Dieses Modell beschreibt sowohl den Terminal-Assistenten als auch die Browser-Einrichtung, und eine --answers-Datei wird nach diesem Schema geschrieben.

  • apply — die privilegierte Einrichtungsarbeit ausführen, um die die Browser-Oberfläche gebeten hat, wobei die Absichtsdatensätze aus pepsi.setup_task gelesen werden. Wird normalerweise bei Bedarf von systemd gestartet. --once arbeitet das Anstehende ab und beendet sich; --idle SECS legt fest, wie lange es ohne Arbeit wartet, bevor es sich beendet; --clear löscht jeden eingereihten Datensatz, ohne einen einzigen davon auszuführen (schließt sich mit den beiden anderen gegenseitig aus).

  • bootstrap — das einmalige Bearer-Token prägen und ausgeben, das das erste Administratorkonto anlegt (--valid-for SECS, --admin-url URL).

  • import [MTA] — berichten, was von einem vorhandenen MTA (postfix, exim, sendmail, qmail, stalwart) migriert würde, ohne etwas zu schreiben; --root liest unterhalb eines anderen Verzeichnisses, --out schreibt den Bericht und die umgewandelten Map-Dateien, --alias-style wählt, wie bloße Aliasnamen qualifiziert werden.

Optionen, die alle vor dem Unterbefehl stehen:

  • --no-certbot — certbot nicht für fehlende TLS-Zertifikate aufrufen; sie werden stattdessen zurückgestellt (siehe TLS-Zertifikat-Einrichtung oben).

  • --no-reverse-proxy — sich nicht automatisch in einen vorhandenen vorgelagerten HTTP-Server integrieren; pepsi-httpd bindet 443 direkt.

  • -y/--yes-to-all, -n/--no-to-all — jedes interaktive Angebot gleich beantworten, sodass die Einrichtung nie auf Eingaben wartet.

  • --wizard — den interaktiven Konfigurationsassistenten ausführen (setzt keine vorhandene Konfigurationsdatei voraus); --force überschreibt eine nicht importierbare Datei ohne Nachfrage. Dazu: --expert SPEC fragt auch die tiefergehenden Optionen ab (--expert=help listet sie auf), --import MTA / --no-import / --import-root DIR steuern die Migration der Einstellungen eines vorhandenen MTA, und --answers FILE beantwortet jede Frage aus JSON, statt sie zu stellen.

  • -c/--config FILE, -L/--log LEVEL, -v/--verbose, -h/--help, -V/--version — die von allen Pepsi-Werkzeugen gemeinsam genutzten Optionen. Anders als die anderen ignoriert pepsi-setup [pepsi] LOG und LOG_JSON (die Protokollierung beginnt, bevor eine Konfiguration geladen ist); geben Sie -L an.

68.5. Konfiguration

Liest [pepsi-dkim] (vollständig validiert; PUBLIC_DIR lokalisiert den Status des Daemons), den gemeinsamen Abschnitt [pepsi] (KEY_DIR, in dem run übrig gebliebene DKIM-Schlüsseldateien löscht, DKIM_SELECTOR, DKIM_ALGORITHMS, ARC_DOMAIN, ARC_ALGORITHM, ORIGINATE_SUCCESS_DSN, MTA_STS_MODE, MTA_STS_MAX_AGE), [pepsi-postgres] (CONFIG, SQL_DIR), [pepsi-ingress] (HOSTNAME, ACCEPTED_DOMAINS) und die [stage-*]-Abschnitte — einschließlich der PUBLIC_IP jeder Relay-Stage (gesammelt nach PROGRAM). Vollständige Referenz: pepsi.conf(5).

68.6. Siehe auch

Installation, Konfiguration, pepsi-setup(1), pepsi-dkim(1), pepsi.conf(5).