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 jedesNEXT_STAGE/BOUNCE_STAGEauflöst, dass die Programmkonfiguration jeder Stage (einschließlich Smarthost-Routing) geparst werden kann und dass Domains undPUBLIC_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_KEYfüllt es das Standard-certbot-Pfad-Layout aus (schreibt die Konfigurationsdatei an Ort und Stelle um, Kommentare erhalten) und führt danncertbot certonly --standaloneaus, 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/letsencryptnur für root lesbar hält. Unter systemd schreibtpepsi-setuppro Unit einLoadCredential=-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 ausSQL_DIRan; 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 --resetverwirft 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-setuphä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, dieSERVER_NAME-/POSTMASTER-Domain jeder Stage, jedes ausdrücklicheSIGNING_DOMAIN,SRS_DOMAINoder festeRESPONSE_FROMsowieARC_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_DIRliegen (<domain>/dkim.rsa.keyund<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._domainkeyund<DKIM_SELECTOR>-YYYYMM-ed25519._domainkey, während einer Rotation auch die der nächsten Generation; entfernbare als Kommentare), eine aus demPUBLIC_IPjeder Relay-Stage (vereinigt) gebaute SPF-Richtlinie, einen DMARC-Vorschlag, wo keiner veröffentlicht ist (mitrua=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] RUAgesetzt ist, und DANE/TLSA-Einträge für die TLS-Listener, dazu einen auskommentierten, optionalen CAA-Vorschlag (RFC 8659, mit deraccounturides 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, wobeisp=reject; np=rejectfü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 jedePUBLIC_IPaufführt und jeder seiner Terme der Grammatik von RFC 7208 folgt (ein unbekannter Mechanismus wieipv4:macht den ganzen Eintrag ungültig), ob der DMARC-Eintrag gültig ist und seinerua=/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, sodassp=rejectsicher ist, oder welche Quellen es ablehnt (beratend); sie stützt sich auf die authentifizierten Sammelberichte, die pepsi-stage-dmarc-report für die letztenWINDOW_DAYSgespeichert 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. WennALLOW_ALIGNED_DOMAINeine mit einer bedienten Domain ausgerichtete SRS-Domain annimmt, prüft es auch, ob der DMARC-Eintrag der bedienten Domain (aspf=soder eine durchsetzende Richtlinie mit eingeschaltetemDMARC_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 dieMX-Einträge der angenommenen Domains DNSSEC-authentisch sind (ein Eintrag ohne dasAD-Bit wird nie für DANE verwendet). Es meldet ins Leere zeigende Ziele: einenMX- oderNS-Host ohne Adresse, einenCNAMEbeimta-sts.,openpgpkey.oderautoconfig., 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 oderMXnennt. Es führt die Subdomains auf, die die Konfiguration nennt (derEHLO-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 keinenStrict-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 dieOPENPGPKEY/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, daspepsi-setup-check.timertäglich ausführt; geht ein Eintrag später kaputt, schlägt diese Unit fehl (systemctl --failed).runprotokolliert 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;runundchecknennen 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 einemMYNETWORKS-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), aberrunliest die effektive Konfiguration des vorgelagerten Servers (nginx -Toder 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.
pepsiundpepsi-cryptoerhalten die Pipeline-Berechtigung abzüglich der Rücknahmen (nurpepsi-cryptodarfcrypto_identity.private_wrappedlesen oderotp_keyanfassen; die anderen Rollen dürfen nur die Verwendungs-Flags einer Identität aktualisieren);pepsi-ingress,pepsi-httpdundpepsi-telemetrysind auf das zurechtgestutzt, was ihr Code verwendet;pepsi-keydisc,pepsi-whitelistundpepsi-configerhalten einige benannte Tabellen oder Spalten. Die Tabellen mit Zugangsdaten (einschließlichown_enrolment/own_session) gehören alleinpepsi-httpd,crl_cachewird allein vonpepsi-keydiscgeschrieben, und nurpepsi-configdarfconfig_overrideschreiben oder einesetup_taskeinreihen. Nachdem sie angewendet wurden, fragenrunundschemaPostgreSQL 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 nichtALLOW_ALIGNED_DOMAIN = yes), da die Weiterleitung Fälschungen dieser Domain zu einem DMARC-Pass reinwaschen würde; einCRYPTO_GENERATE_RSA_BITSaußer 2048, 3072, 4096 oder 8192 oder unterCRYPTO_MIN_RSA_BITS; ein gemeinsamer S/MIME-Schlüssel auf einer elliptischen Kurve; einKEY_WRAP_SECRETkürzer als 16 Zeichen. EinMYNETWORKS-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 = strictist der Standard der Relay-Stages), prüftrun, dass der Resolver dasAD-Bit setzt, und nennt die Resolver außerhalb des Hosts, denen die Installation die Validierung anvertraut (Der Netzwerkangreifer).Wiederverwendete Logins.
runaktualisiert 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.
applyhandelt nur nach einer geschlossenen Liste von siebzehn Aufgabenarten, jede autorisiert durch den festgehaltenen Geltungsbereich und dadurch, dass der Datensatz über die Rollepepsi-configgeschrieben wurde; es gibt keinen Neustart und keinen beliebigen Befehl. Der zweite Faktor der Anfrage eines Inhabers (confirm-enrolmenteingeschlossen) 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 anpepsi-dkimübergeben, DNS ausgeben (die Standardaktion).-r/--resetverwirft 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-dirDIR sichert das Schema zuerst mitpg_dump, wenn es etwas zu aktualisieren gibt, und--backup-keepN löscht danach alle Sicherungen außer den N neuesten (Standardwert 2, 0 behält alle);--if-installedtut 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);runprotokolliert dieselben Warnungen.validate— prüft die Konfiguration genau so, wierunes 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 Siepepsi.confbearbeitet haben und bevor Sie etwas neu starten.visualize— die[stage-*]-Pipeline als Graphviz-dot-Graph auf der Standardausgabe ausgeben (eine durchgezogene Kante jeNEXT_STAGE, eine gestrichelte rote jeBOUNCE_STAGE); leiten Sie sie nachdot -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 auspepsi.setup_taskgelesen werden. Wird normalerweise bei Bedarf von systemd gestartet.--oncearbeitet das Anstehende ab und beendet sich;--idleSECS legt fest, wie lange es ohne Arbeit wartet, bevor es sich beendet;--clearlö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-forSECS,--admin-urlURL).import[MTA] — berichten, was von einem vorhandenen MTA (postfix,exim,sendmail,qmail,stalwart) migriert würde, ohne etwas zu schreiben;--rootliest unterhalb eines anderen Verzeichnisses,--outschreibt den Bericht und die umgewandelten Map-Dateien,--alias-stylewählt, wie bloße Aliasnamen qualifiziert werden.
Optionen, die alle vor dem Unterbefehl stehen:
--no-certbot—certbotnicht 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:--expertSPEC fragt auch die tiefergehenden Optionen ab (--expert=helplistet sie auf),--importMTA /--no-import/--import-rootDIR steuern die Migration der Einstellungen eines vorhandenen MTA, und--answersFILE beantwortet jede Frage aus JSON, statt sie zu stellen.-c/--configFILE,-L/--logLEVEL,-v/--verbose,-h/--help,-V/--version— die von allen Pepsi-Werkzeugen gemeinsam genutzten Optionen. Anders als die anderen ignoriertpepsi-setup[pepsi] LOGundLOG_JSON(die Protokollierung beginnt, bevor eine Konfiguration geladen ist); geben Sie-Lan.
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).