95.1.43. pepsi-setup¶
provision the Pepsi database, signing keys and DNS for a deployment
- Handbuchabschnitt:
1
95.1.43.1.1. Name¶
pepsi-setup - das Schema installieren, die Konfiguration validieren, die DKIM-Schlüssel erzeugen lassen und DNS-Einträge ausgeben.
95.1.43.1.2. Übersicht¶
pepsi-setup [GLOBAL-OPTIONS] [run [-r | –reset]]
pepsi-setup [GLOBAL-OPTIONS] schema [–backup-dir DIR] [–backup-keep N] [–if-installed]
pepsi-setup [GLOBAL-OPTIONS] check [–fail-on-findings]
pepsi-setup [GLOBAL-OPTIONS] validate
pepsi-setup [GLOBAL-OPTIONS] visualize
pepsi-setup –wizard [–force] [–expert SPEC] [–answers FILE] [–import MTA [–import-root DIR] | –no-import] [-c FILE]
pepsi-setup [GLOBAL-OPTIONS] questions
pepsi-setup [GLOBAL-OPTIONS] apply [–once] [–idle SECS]
pepsi-setup [GLOBAL-OPTIONS] apply –clear
pepsi-setup [GLOBAL-OPTIONS] bootstrap [–valid-for SECS] [–admin-url URL]
pepsi-setup [GLOBAL-OPTIONS] import [MTA] [–root DIR] [–out DIR] [–alias-style STYLE]
GLOBAL-OPTIONS umfassen –no-certbot, –no-reverse-proxy und -y/-n, um Eingabeaufforderungen nicht-interaktiv zu beantworten (siehe Globale Optionen).
95.1.43.1.3. Beschreibung¶
pepsi-setup ist das administrative Bootstrap-Werkzeug für eine Pepsi-Installation. In einem einzigen Aufruf:
Validiert die Konfiguration. Es parst die
[pepsi]- und[pepsi-ingress]-Abschnitte (einschließlich Listener) und die[stage-*]-Pipeline. Es prüft, dass ein[stage-init]existiert, dass jedesNEXT_STAGE/BOUNCE_STAGEaufgelöst werden kann, dass sich die Programmkonfiguration jeder Stage (einschließlich des Routings zum vorgelagerten MTA) parsen lässt, dass jeder Domainname wohlgeformt und jederPUBLIC_IP-Eintrag eine gültige IP-Adresse ist. Es warnt, wenn diePUBLIC_IPeiner Relay-Stage eine nicht-öffentliche Adresse ist (Loopback, RFC 1918 / Unique-Local, Link-Local oder CGNAT) und wenn eine Relay-Stage überhaupt keinePUBLIC_IPsetzt (der Eintrag degradiert dann zu einem bloßenv=spf1 -all). Eine nicht-öffentliche Adresse kann im Internet niemals Mail senden. Steht sie mit dem abschließenden-allim Eintrag, scheitert ausgehende Mail aus dieser Adressfamilie an SPF; verwenden Sie hinter NAT die öffentliche Egress-IP des Hosts, nicht seine LAN-Adresse. Es warnt vor jedemMYNETWORKS-Eintrag eines Ingress-Listeners, der mehr als einen Host abdeckt (größer als/32oder/128) und kein Loopback ist: Jeder Host darin darf über diesen Server weiterleiten und ohne Authentifizierung als jede Adresse senden, daher erstreckt sich eine Netzfreigabe auf jede Maschine, die zu diesem Netz gehört oder später hinzukommt. Führen Sie einzelne Hosts auf, und lassen Sie andere Clients sich mit SASL oder einem TLS-Client-Zertifikat authentifizieren. Es verweigert außerdem die in der Beispielkonfiguration mitgelieferte reservierte.invalid-Platzhalter-Identität: Wenn eines vonHOSTNAME,ACCEPTED_DOMAINS,[pepsi] ARC_DOMAINoder einem Stage-SERVER_NAMEnoch auf.invalidendet (z. B.example.invalid), stoppt es mit einem Fehler, der die beanstandeten Werte benennt, weil das Beispiel nie bearbeitet wurde; es richtet keine Schlüssel und kein DNS für eine Domain ein, die nie Mail empfangen kann. Setzen Sie diese Felder auf Ihre echte Domain oder führen Siepepsi-setup --wizardaus. Es warnt vor jeder Option, die in einem bekannten Abschnitt gesetzt ist, aber von nichts gelesen wird, und schlägt den nächstliegenden echten Optionsnamen vor, denn eine falsch geschriebene Option nimmt stillschweigend ihren Standardwert an. Es warnt auch vor Optionen, die seit einer früheren Version umbenannt wurden (siehe „Umbenannte Optionen“ in pepsi.conf(5)). Abschnitte, die es nicht kennt, bleiben unberührt. Es prüft[pepsi-dkim](siehe pepsi-dkim(1)):RSA_BITSist 2048, 3072 oder 4096;ROTATION_LEAD_DAYSist kürzer als einROTATION_DAYSungleich null;RETIRE_AFTER_DAYSist mindestens 1 und überschreitet dasSIGNATURE_EXPIRATION_DAYSjeder pepsi-stage-dkim-sign(1)- und pepsi-stage-arc(1)-Stage, da ein außer Dienst gestellter Schlüssel, dessen Signaturen noch gültig sind, Mail unterwegs an DKIM scheitern lässt;NOTIFY_ADDRESSist eine Adresse; undDNS_UPDATE = rfc2136kommt mit einemTSIG_KEY_NAME, einem Base64-TSIG_SECRETund einemTSIG_ALGORITHMvonhmac-sha256,hmac-sha384oderhmac-sha512. Es warnt, wennPUBLISH_RETIRED_KEYSan ist, aber kein pepsi-httpd-Listener HTTPS öffentlich ausliefert (die Schlüssel würden für niemanden zum Abrufen geschrieben), oder wenn es ohneROTATION_DAYSan ist (Schlüssel werden dann nur bei einem manuellenpepsi-dkim rotateaußer Dienst gestellt). Wenn etwas falsch ist, meldet es das Problem und beendet sich mit einem Wert ungleich null, ohne ein Schema zu installieren, einen Schlüssel zu erzeugen oder irgendetwas zu veröffentlichen. (Die Validierung ist nicht buchstäblich das Erste, was läuft. Die unten beschriebenen Schritte, die die Konfigurationsdatei reparieren, gehen ihr notwendigerweise voraus, weil die Validierung gegen ihr Ergebnis läuft: die Reverse-Proxy-Integration, die certbot-Pfade, das Herkunftsnachweis-Geheimnis, die Telemetrie-Kennung und dieMAILBOX_FS_QUOTA-Sondierung.) Die vom Betreiber bearbeiteten Map-Dateien (unten) sind bewusst nicht Teil dieses Schritts, sodass ein unzusammenhängender Map-Tippfehler den Lauf nie blockieren kann. Wenn die Pipeline einepepsi-stage-detect-language-Stage verwendet, dieses Binärprogramm aber nicht auf$PATHgefunden wird (es wird in einem eigenen großen Paket, getrennt vom Rest von Pepsi, ausgeliefert), warnt der Lauf und fährt fort; installieren Siepepsi-stage-detect-languagevor dem Start des Dienstes, sonst kann die detect-language-Stage nicht gestartet werden. Zwei weitere nicht-fatale Warnungen weisen auf wahrscheinliche Fehlkonfigurationen hin: einepepsi-stage-block-language-Stage mit einerBLACKLIST, aber leererWHITELISTund einem nicht-negativenTHRESHOLD(was für alle Mail in neutraler Sprache einen Bounce erzeugt; siehe pepsi-stage-block-language(1)), und ein nicht-fortschreitenderNEXT_STAGE-Zyklus (eine Kette vonNEXT_STAGE-Kanten, die auf sich selbst zurückführt, sodass eine Nachricht bisMAX_LIFETIMEim Kreis liefe; legitimer Wiedereintritt überBOUNCE_STAGE/RESTART_STAGEwird nicht markiert). Es warnt außerdem, wenn einTARGETS-Eintrag eine uid unterhalb vonUID_MINaus/etc/login.defszulässt, und zwar bei einer Stage, deren setuid-Helfer solche uids verweigert, da ein Empfänger, auf den nur dieser Eintrag passt, bei jeder Nachricht im Helfer scheitert. Solche Stages sind pepsi-stage-relay-to-maildir(1), pepsi-stage-dot-forward(1) und pepsi-stage-auto-pay(1) mitWALLET_MODE = local-user. Es warnt, wenn[pepsi-ingress] ACCEPTED_DOMAINSgesetzt ist,DMARC_ENFORCEaber nicht: Der einkompilierte Standardwert istno, daher stellt eine solche Konfiguration Mail zu, die an DMARC scheitert; ein ausdrücklichesnobleibt unbeanstandet. Es warnt, wenn ein Smarthost-Abschnitt auf Exchange Online zeigt (…mail.protection.outlook.com) und kein Abschnitt[pepsi-ingress-exchange-online-*]den Mandanten nennt: Mail, die der ausgehende Connector von Exchange Online über diesen Host an andere Domains sendet, wird dann abgelehnt (siehe pepsi.conf(5)). Es warnt vor einer pepsi-stage-anti-spam(1)-Stage ohneBOUNCE_TARGET_STAGE, die eine Nachricht mit Null-Absender ohne gültigenPepsi-Origin-Nachweis (einen gefälschten Bounce) an der Zahlungsschranke vorbeileitet, und, mit[pepsi-origin] ENABLED = no, vor jeder Anti-Spam-Stage (jeder Bounce geht dann an dieses Ziel) und jeder pepsi-stage-secretary(1)-Stage (jeder Bounce passiert sie dann).Mit einer Stage, die pepsi-stage-srs(1) ausführt, ist eine
[pepsi-srs] SRS_DOMAIN, die mit einer bedienten Domain DMARC-ausgerichtet ist, ein Fehler: selbst einACCEPTED_DOMAINS-Eintrag oder eine andere Sendeidentität, eine Subdomain oder übergeordnete Domain einer solchen oder ein Name, der seine letzten zwei Labels mit einer solchen teilt (es gibt keine Public-Suffix-Liste, daher neigt der Test zu ausgerichtet). Weitergeleitete Mail geht mit einem in diese Domain umgeschriebenen Umschlagabsender hinaus, von den Adressen dieses Hosts, sodass SPF dafür beim nächsten Hop besteht; eine ausgerichtete SRS-Domain ließe eine als bediente Domain gefälschte Nachricht, die von außen empfangen und weitergeleitet wurde, dort DMARC allein über SPF bestehen.[pepsi-srs] ALLOW_ALIGNED_DOMAIN = yesmacht aus dem Fehler eine Warnung, für einen Host, der keine eigene Domain haben kann. Die Warnung nennt, was den Weg schließt:aspf=sim DMARC-Eintrag der bedienten Domain, wenn die SRS-Domain eine Subdomain von ihr ist, oder dortp=quarantine/p=rejectzusammen mit[pepsi-ingress] DMARC_ENFORCE = yes, sodass eine Fälschung beim Eintreffen abgelehnt wird. check liest dann diesen DMARC-Eintrag (oder den der Organisationsdomain, wenn die bediente Domain keinen hat) und meldet ihn alsSRS alignment:[ok], wennaspf=sveröffentlicht ist und sich die beiden Namen unterscheiden oder die Richtlinie durchsetzt undDMARC_ENFORCEan ist, sonst[MISMATCH]mit der Abhilfe. Es warnt vor jeder[pepsi-srs] PREVIOUS_SECRET_FILE, die zuletzt vor mehr alsMAX_AGE_DAYSgeändert wurde: Jede Adresse, die der außer Dienst gestellte Schlüssel signiert hat, ist abgelaufen, daher verifiziert er nichts mehr und kann entfernt werden. Nur die Änderungszeit der Datei wird herangezogen, nie ihr Inhalt. Es warnt außerdem, wenn eine Stage pepsi-stage-srs(1) ausführt, aber keine pepsi-stage-bounce(1): Ein entfernter Bericht über eine Kopie, die ein Alias oder eine~/.forwardnach außerhalb gesendet hat, wird dann von pepsi-ingress(1) verworfen, und der Absender erfährt es nie.Die Einstellungen der Ende-zu-Ende-Kryptographie werden hier ebenfalls geprüft: die
CRYPTO_*-Optionen von[pepsi]und der Schlüsselspeicher-Abschnitt[pepsi-crypto](siehe pepsi.conf(5)). Einzeln gültige, gemeinsam aber falsche Kombinationen sind Fehler:CRYPTO_SMIME_SHARED_KEY = yesmit einem Elliptische-Kurven-CRYPTO_SMIME_ALGORITHM, den Standardwertp256eingeschlossen (mehrere S/MIME-Clients lehnen einen EC-Schlüssel ab, der sowohl ECDSA als auch ECDH macht), einCRYPTO_GENERATE_RSA_BITSaußer 2048, 3072, 4096 oder 8192 (die in konstanter Zeit erzeugten Größen) oder unterhalb vonCRYPTO_MIN_RSA_BITS(die Installation würde Schlüssel erzeugen, die sie dann ablehnt), ein unplausibel kleinesCRYPTO_MIN_RSA_BITS, ein nicht positivesIDENTITY_VALIDITY_DAYSund einKEY_WRAP_KEY_ID, das seine eigeneKEY_WRAP_SECRET_<ID>-Option nicht benennen könnte. Ein[pepsi-crypto]-Abschnitt, der überhaupt etwas sagt, aber keinKEY_WRAP_SECREThat, ist ebenfalls ein Fehler, und die Meldung nennt das@inline-secret@-Fragment, aus dem das Geheimnis hätte kommen sollen, samt seinem Eigentümer und Modus: Der@inline-secret@-Mechanismus warnt nur über ein Fragment, das er nicht lesen kann, sodass ein unlesbares andernfalls von einer nicht gesetzten Option nicht zu unterscheiden ist. Ein Geheimnis, das kürzer als 16 Zeichen ist, wird abgelehnt, denn es ist der eine Schlüssel, der jeden gespeicherten privaten Schlüssel öffnet. Eine Installation, die keine Ende-zu-Ende-Kryptographie betreibt, konfiguriert nichts davon und wird deswegen nicht behelligt. Drei Optionen, die gültig sind, aber schwächen, was der Schutz einer Nachricht bedeutet, werden jeweils mit einer Warnung angenommen:CRYPTO_MIN_RSA_BITSunter 2048,CRYPTO_ALLOW_WEAK_DIGESTS = yes(SHA-1-Signaturen, deren Kollisionen eine Signatur oder einen CMS-Digest-Algorithmus austauschbar machen) undCRYPTO_ALLOW_DOWNGRADE = yes(S/MIME-3DES bei der Entschlüsselung und der nicht authentifizierte S/MIME-CBC-Container für jeden Empfänger statt nur für die, deren Fähigkeitsdatensatz ihn braucht).Für jede pepsi-stage-encrypt(1)-Stage prüft es außerdem die pEp-Voreinstellung (
ENABLE_PEP) und die Schlüssel-Selbstbedienung. Es warnt, wennENABLE_PEPeingeschaltet ist, aber[pepsi-crypto] AUTO_CREATE_IDENTITY = nogilt (ein gültiges Veto des Standorts, doch dann erhält kein Absender automatisch einen Schlüssel; setzen SieENABLE_PEP = no, um das ausdrücklich zu machen) oder keinKEY_WRAP_SECRETkonfiguriert ist (kein Absender kann einen Schlüssel erhalten); wennRESPONSE_STAGEnicht gesetzt ist (Benutzer erfahren nicht, wenn ein neuer Schlüssel für ihre Adresse registriert wird, und die E-Mail-Schlüsselbefehle anpepsi-keys@<domain>sind abgeschaltet); und wenn[pepsi-ingress] USERNAME_MAPeinen Platzhalter gewährt, wobei es diese Konten nennt: Sie dürfen als jede passende Adresse senden, können aber nie einen eigenen Schlüssel für eine davon registrieren. Es verweigert einRESPONSE_STAGE, das keine Stage benennt, und, wennRESPONSE_STAGEgesetzt ist, einTEMPLATE_DIR, dem die Rückfallvorlagekey-registered.en.bodyoderkeys.en.bodyfehlt.Das Setup repariert außerdem ein verwaistes Fragment. Das Geheimnis und die
@inline-secret@-Direktive, die es einzieht, sind zwei Hälften einer Aussage, die in zwei Dateien leben, und das Fragment überlebt die Konfiguration, die es referenzierte. Eine neu erzeugte oder handgeschriebenepepsi.confhinterlässt daher eine Installation, in dersecrets.d/pepsi-crypto.secretvorhanden und korrekt ist, nichts es lädt und jede Nachricht durch pepsi-stage-encrypt(1) scheitert. Keine der beiden Hälften sieht für sich falsch aus, und ein erneuter Lauf alsroothilft nicht: root kann das Fragment lesen, aber die Direktive ist es, die es einzieht. Wenn das Fragment existiert und die Konfiguration es nicht referenziert, fügt das Setup die Direktive hinzu und meldet das. Dabei wird nichts rotiert und kein Schlüsselmaterial geschrieben; der Schritt ist also selbst dann sicher, wenn das Geheimnis selbst unlesbar ist. Was es nicht wiederherstellen kann, ist eine nicht standardmäßigeKEY_WRAP_KEY_ID, die zu der verlorenen Datei gehörte, daher nennt die Warnung die ID, die das Setup angenommen hat; setzen Sie sie von Hand, wenn der Schlüssel unter einer anderen gespeichert wurde.Bereitet die vom Betreiber bearbeiteten Map-Dateien vor. Bei jedem Lauf durchläuft es die konfigurierten Lookup-Tabellen: die
[pepsi-ingress] USERNAME_MAPund dieALIASES-Map jederpepsi-stage-aliases-Stage. Eine Datei, die nicht existiert, wird aus einer kommentierten Starter-Vorlage (Modus0644) erstellt, die den Zweck der Datei dokumentiert und die Syntax zeigt, sodass der Betreiber eine selbstdokumentierende Datei am richtigen Ort vorfindet. Eine Datei, die existiert, wird mit demselben Parser auf Syntax geprüft, den die besitzende Komponente zur Laufzeit verwendet, sodass eine fehlerhafte Zeile (oder ein Adress-/Domain-Tippfehler) mit ihrer Zeilennummer sichtbar gemacht wird. Dieser Schritt ist rein beratend: eine fehlerhafte Map oder eine Vorlage, die nicht geschrieben werden kann, wird als Warnung protokolliert und bricht den Lauf nie ab (die Laufzeit-Parser sind selbst nachsichtig, warnen und überspringen eine fehlerhafte Zeile). Im--wizard-Modus läuft dies erst nachdempepsi.confgeschrieben wurde, sodass ein Map-Problem den Assistenten nie daran hindert, die Konfiguration zu schreiben.Integriert sich mit einem bestehenden Front-HTTP-Server. Wenn ein anderer Webserver (nginx oder Apache) bereits auf den Ports 80/443 lauscht, kann pepsi-httpd 443 nicht binden und
certbot --standalonekann 80 nicht binden. Statt um die Ports zu kämpfen, erkennt pepsi-setup den Front-Server (überss), bestätigt, dass er keinen dermta-sts.<domain>-Hostnamen bereits bedient, und tut dann zwei Dinge.Erstens hält es
[pepsi-httpd-listener-https]socket-aktiviert, aber als Klartext-HTTP (SERVE = systemd,MODE = plain), und entfernt jedes direkt bindendeMODE = tls+TLS_CERT/TLS_KEYsowie die nun nicht mehr benötigten[pepsi-httpd-cert-*]-Abschnitte. Außerdem legt es einpepsi-httpd.socket-Override (/etc/systemd/system/pepsi-httpd.socket.d/10-reverse-proxy.conf) ab, dasListenStreamvon443auf einen UNIX-Socket unter/run/pepsi/httpd.sockumbindet (SocketGroup=ist die Gruppe des Front-Servers:www-dataunter Debian, anderswonginx/apache/httpd).Auf einem Host, den nicht systemd betreibt, übergibt pepsi-httpd niemand einen Socket, daher bindet der Listener den UNIX-Socket stattdessen selbst:
SERVE = unix,UNIXPATH = /run/pepsi/httpd.sock,UNIXPATH_MODE = 660undUNIXPATH_GROUPdie Gruppe des Frontservers, wieder mitMODE = plain. pepsi-setup startet pepsi-httpd danach neu (unter macOS seinen launchd-Job; bei einem anderen Init-System fordert es Sie dazu auf).Ist der Frontserver verschwunden, oder mit
--no-reverse-proxy, macht pepsi-setup beides rückgängig: Es löscht das Override fürpepsi-httpd.socketoder macht auf einem Host ohne systemd den Listener wieder zuSERVE = tcpauf Port 443. Danach setzt es wiederMODE = tlsund fügt für jeden Namenmta-sts.<domain>, den keinSNInennt, einen Abschnitt[pepsi-httpd-cert-mta-sts-<domain>]hinzu, außer bei[pepsi] MTA_STS_MODE = none. Der anschließende TLS-Schritt trägt deren Zertifikatspfade ein, beschafft die Zertifikate und startet pepsi-httpd neu. Ein Listener auf einem eigenen Socket bleibt unangetastet.Zweitens schreibt es eine Reverse-Proxy-Site (
pepsi-mta-sts) in diesites-availabledes Front-Servers und aktiviert sie insites-enabled(conf.dfür Nicht-Debian-nginx). Die Site terminiert TLS für diese Hostnamen, sendet auf ihnenStrict-Transport-Security: max-age=31536000(pepsi-httpd sendet es nur auf seinen eigenen TLS-Listenern; ein von Hand konfigurierter Front-Server muss es ebenfalls hinzufügen, was check prüft), schaltet TLS-Session-Tickets ab und leitet die Anfragen an den Socket weiter. Die Tickets sind abgeschaltet (ssl_session_tickets off/SSLSessionTickets off), weil ein Ticket-Schlüssel, den der Server bis zu seinem Neustart behält, jedem, der ihn erlangt, das Entschlüsseln jeder damit wiederaufgenommenen, aufgezeichneten Sitzung erlauben würde; das höbe die Forward Secrecy auf. Die Site setzt keine Cipher-Liste: Der Front-Server gehört dem Betreiber und wird mit dessen anderen Sites geteilt, daher ist es die Richtlinie dieses Servers, welche alten Clients er aufgibt. Stattdessen liest pepsi-setup die wirksamen TLS-Einstellungen des Front-Servers und warnt, wenn sie noch TLS-1.2-Suiten ohne Forward Secrecy (statischer RSA-Schlüsselaustausch) aktivieren: Wer später den privaten Schlüssel des Servers erlangt, kann die mit diesen Suiten aufgezeichneten Sitzungen entschlüsseln. Wenn die Einstellungen nicht gelesen werden können, meldet pepsi-setup das. In diesem Aufbau terminiert der Front-Server TLS, sodass die Zertifikate (dieser Schritt und das SMTP-MX-Zertifikat des nächsten Schritts) über das certbot-Authenticator-Plugin dieses Servers (--nginx/--apache) statt über--standalonebezogen werden. Dieser Schritt ist eine No-Op, wenn kein Front-Server vorhanden ist, und wird mit--no-reverse-proxyvollständig übersprungen (in welchem Fall pepsi-httpd 443 direkt bindet). Sobald diepepsi-mta-sts-Site existiert, erzeugt ein erneuter Lauf sie neu und lädt den Front-Server nur dann neu, wenn sich ihr Text ändert: Einmta-sts.<domain>-Name für eine neu angenommene Domain kommt hinzu (es sei denn, der Front-Server bedient diesen Namen bereits anderswo; das wird wie unten beschrieben aufgeschoben), nachdem zuerst sein Zertifikat bezogen wurde, und eine von einem älteren pepsi-setup geschriebene Site erhält, was die aktuelle sendet, etwaStrict-Transport-Security. Von Hand an der Datei vorgenommene Änderungen werden daher überschrieben. Lehnt der Konfigurationstest des Front-Servers den neuen Text ab, wird der vorige Text wiederhergestellt und der Schritt aufgeschoben. In einigen Fällen wird die Integration aufgeschoben, statt den Lauf abzubrechen: wenn der Front-Server bereits einen dermta-sts.<domain>-Namen bedient (ein Konflikt, den Sie auflösen müssen), wenn es ein Server ist, den pepsi-setup noch nicht automatisieren kann (Caddy, lighttpd, Apache Traffic Server; verdrahten Sie den Proxy von Hand oder übergeben Sie--no-reverse-proxy), wenn pepsi-setup nicht als root läuft oder wenn das MTA-STS-Zertifikat selbst nicht bezogen werden kann (die Reverse-Proxy-Site verweist auf das Live-Zertifikat, sodass sie nicht geschrieben werden kann, bevor das Zertifikat existiert). Die Zusammenfassung am Ende des Laufs gibt dann eine umsetzbare Meldung aus, und pepsi-httpd bleibt in seiner direkt bindenden Konfiguration; führen Sie in jedem Fallpepsi-setup runerneut aus, sobald die Ursache behoben ist. Das Socket-Verzeichnis/run/pepsistammt aus demsystemd-tmpfiles-Eintrag des Pakets (keine Unit darfRuntimeDirectory=pepsideklarieren: systemd würde dem Verzeichnis und jedem Socket darin bei jedem Start einen neuen Eigentümer geben), und pepsi-setup schreibt neben dem Socket-Drop-in/etc/tmpfiles.d/pepsi-reverse-proxy.conf, das dem Benutzer des Front-Servers Zugriff darauf gewährt; dieser Benutzer muss den gruppengeteilten Socket erreichen können.Richtet TLS-Zertifikate ein. Für jeden Listener, der TLS terminiert und kein
TLS_CERT/TLS_KEYgesetzt hat, füllt es die Optionen mit dem Standard-certbot-Layout aus (/etc/letsencrypt/live/<lineage>/fullchain.pemundprivkey.pem) und schreibt sie an Ort und Stelle in die Konfigurationsdatei (Kommentare bleiben erhalten). Diese Listener sind die[pepsi-ingress-listener-*]-Sockets mitMODE = tls/starttls, die TLS-[pepsi-httpd-listener-*]-Sockets und jedes[pepsi-httpd-cert-*]-SNI-Zertifikat. Mail und Web haben getrennte Zertifikate und Schlüssel, jeweils eine eigene certbot-Lineage:die Mail-Lineage
<HOSTNAME>(das[pepsi-ingress] HOSTNAME), von jedem Ingress-Listener verwendet: der Schlüssel, den derTLSA-Eintrag pinnt;die Web-Lineage
<HOSTNAME>-web, von den TLS-[pepsi-httpd-listener-*]-Sockets verwendet (und von einem[pepsi-httpd-cert-*]-Abschnitt, dessen ersterSNI-HostHOSTNAMEist);eine Lineage je weiterem
[pepsi-httpd-cert-*]-Abschnitt, benannt nach seinem erstenSNI-Host (mta-sts.<domain>in einer Konfiguration, die der Assistent geschrieben hat).
pepsi-httpd, der exponiertere der beiden Server, hält daher nie den Mail-Schlüssel: Ein ihm entwendeter Schlüssel passt zu keinem veröffentlichten
TLSA-Eintrag, daher lehnt ein Absender, der DANE durchsetzt, ihn für den MX ab. Listener eines Dienstes teilen sich ihre Lineage.Eine Konfiguration, in der der HTTPS-Listener (oder ein solcher Zertifikatsabschnitt) noch die Pfade der Mail-Lineage nennt, wie im Aufbau mit einer einzigen gemeinsamen Lineage, wird vom nächsten Lauf aufgeteilt: pepsi-setup bezieht die Web-Lineage und ersetzt, sobald deren Zertifikat und Schlüssel auf der Platte liegen,
TLS_CERT/TLS_KEYdieses Abschnitts durch die der Web-Lineage und protokolliert einen Hinweis. Bis dahin (--no-certbotoder ein aufgeschobenes Zertifikat) behält der Abschnitt das gemeinsame Zertifikat und funktioniert weiter, und ein späterer Lauf schließt die Aufteilung ab. Das Mail-Zertifikat, sein Schlüssel und seinTLSA-Eintrag werden nicht angetastet. Ein Zertifikat, das der Betreiber außerhalb des certbot-Layouts konfiguriert hat, wird nie verschoben.Das (Web-)Zertifikat des HTTPS-Listeners deckt
HOSTNAMEundopenpgpkey.<domain>für jede Domain inACCEPTED_DOMAINSab, weil dort die erweiterte Methode des Web Key Directory abgerufen wird (pepsi-httpd(1)). Wenn[pepsi-autoconfig]die Mail-Autokonfiguration einschaltet, deckt es auchautoconfig.<domain>ab, also die erste URL, die ein Mail-Client versucht. Diese Namen werden dem Zertifikat des Listeners selbst hinzugefügt und erhalten keinen eigenen Abschnitt[pepsi-httpd-cert-*], denn dieses Zertifikat ist der Rückfall, der ausgeliefert wird, wann immer SNI auf nichts passt. So deckt ein Zertifikat sowohl den SNI-Treffer als auch den Rückfall ab.Das (Mail-)Zertifikat der Ingress-Listener deckt jeden MX-Host ab, den eine MTA-STS-Richtlinie erlaubt, also die Menge
[pepsi] MTA_STS_MXüber alle bedienten Domains. Der Grund dafür hat auf der HTTPS-Seite kein Gegenstück. RFC 8461 §4.1 verlangt, dass das Zertifikat, das ein MX vorlegt, zu dem Namen passt, den derMX-Eintrag dem Absender gegeben hat, und pepsi-ingress(1) liefert genau ein Zertifikat je Listener aus: Es hält das SNI des Clients fest, wählt aber nie danach aus. Ein Host, der alsmx.example.orgundmail.example.neterreichbar ist, kann daher nicht mit zwei Zertifikaten antworten; er braucht ein Zertifikat, das beide Namen trägt. Platzhalter-mx-Einträge (*.example.net) werden mit einer Warnung übersprungen; eine Installation, die einen solchen Eintrag veröffentlicht, muss dieses Zertifikat daher selbst bereitstellen. HTTP-01 kann einen Platzhalter nicht erfüllen, und wer einen an certbot übergibt, lässt die ganze Anfrage scheitern, einschließlich der Namen, die funktioniert hätten.Dann führt pepsi-setup für jeden solchen Host
certbot certonly --standaloneaus (HTTP-01 über TCP/80, ohne E-Mail-Adresse registriert), wenn das Zertifikat nicht auf der Platte liegt. Liegt es doch dort, liest pepsi-setup die Subject Alternative Names daraus und führt certbot erneut aus (--expand, gleicher--cert-name), falls sie nicht jeden der oben genannten Namen abdecken. Das zählt, weil der Namenssatz eines Zertifikats bei der ersten Ausstellung nicht festgelegt ist: Wenn Sie eine bediente Domain hinzufügen, die Autokonfiguration einschalten oder einen neuen MX-Host benennen, wird er jeweils größer. Ein Zertifikat, dessen Namen nicht gelesen werden können, wird in Ruhe gelassen statt neu ausgestellt, denn „ich konnte es nicht feststellen“ darf keine ratenbegrenzte Ausstellung verbrauchen. Jeder Name wird gegen DNS geprüft und nicht nur der--cert-namedes Zertifikats selbst: certbot prüft jedes-dgesondert und lässt die ganze Anfrage scheitern, wenn einer davon nicht erreichbar ist.pepsi-setup entscheidet, für welche Zertifikate es certbot antreiben darf, indem es die konfigurierten
TLS_CERT/TLS_KEYmit den Layoutpfaden vergleicht, die es für diesen Host selbst geschrieben hätte. Die Frage kann nicht „istTLS_CERTgesetzt?“ lauten, denn ein erfolgreicher erster Lauf setzt es. Danach sähe jeder Listener betreiberkonfiguriert aus, und kein Zertifikat ließe sich je um weitere Namen erweitern. Pfade, die dem Layout entsprechen, hält pepsi-setup selbst aktuell; alles andere ist ein Zertifikat, das der Betreiber gewählt hat, und wird nie angefasst. Ein halb konfigurierter Abschnitt (eine der beiden Optionen gesetzt) wird der strengen Validierung überlassen, die ihn besser meldet. Ein Zertifikat, das fehlt und nicht beschafft werden kann, wird aufgeschoben statt fatal: Das Setup läuft weiter (installiert das Schema, erzeugt Schlüssel, gibt DNS-Einträge aus) und führt jedes aufgeschobene Zertifikat in einer Zusammenfassung ganz am Ende auf, mit dem konkreten nächsten Schritt und der Erinnerung,pepsi-setup runerneut auszuführen, sobald das Hindernis behoben ist. Ein erneuter Lauf ist idempotent und vollendet nur das, was noch fehlt. Ein Zertifikat wird aufgeschoben, wenn--no-certbotangegeben war,certbotnicht installiert ist, pepsi-setup nicht als root läuft (es kann dann TCP/80 nicht binden), das DNS des Hosts nicht auf eine konfiguriertePUBLIC_IPauflöst (die Challenge würde dann scheitern) odercertbotselbst scheitert (etwa bei einem vorübergehenden Vorfall beim ACME-Server oder einer Ratenbegrenzung; ein einfacher erneuter Lauf versucht es dann noch einmal). Der DNS-Fall unterscheidet einen Namen ohne A/AAAA-Eintrag von einem, der anderswohin auflöst (und meldet die gefundenen Adressen gegenüber den konfiguriertenPUBLIC_IPs). Da die Zertifikatsdatei dann fehlt, kann der DANE/TLSA-Eintrag für diesen Host nicht berechnet werden; die DNS-Ausgabe gibt daher einen Kommentar aus, der sagt, dass der Eintrag noch fehlt und wie er bereitzustellen ist. Nur ein wirklich unbrauchbarer Aufruf ist fatal: eine nicht schreibbare Konfigurationsdatei oder ein unbekannter Pfad für sie (wenn an keinem Standardort eine Konfigurationsdatei existiert und kein--configangegeben wurde), sodass die automatisch gefüllten Pfade nicht dauerhaft gespeichert werden können. Beachten Sie, dass ein Server, dessen TLS-Listener noch kein Zertifikat hat, nicht startet, bis das Zertifikat existiert.Verschafft den Servern Zugriff auf ihr Schlüsselmaterial. Die TLS-Server (pepsi-ingress, pepsi-httpd) laufen unter unprivilegierten Benutzern und können certbots nur für root lesbaren Baum
/etc/letsencrypt/{live,archive}nicht lesen; ein Listener würde sonst mit einem nackten permission denied nicht starten. Drei Mechanismen adressieren das, angewandt bei jedem Lauf:systemd-Dienst-Credentials — der primäre Mechanismus überall dort, wo systemd die Server ausführt. Für jeden Server schreibt pepsi-setup
/etc/systemd/system/<unit>.d/10-tls-credentials.confund benennt darin jedes Zertifikat und jeden Schlüssel, den dieser Server liest, alsLoadCredential=-Eintrag. systemd öffnet diese Dateien dann als root, wenn es die Unit startet, und übergibt dem Dienst private Kopien unter$CREDENTIALS_DIRECTORY(einem Unit-eigenen tmpfs-Verzeichnis, das nur dieser eine Dienst lesen kann), wo Pepsis TLS-Lader jeden konfigurierten Pfad nachschlägt, bevor er auf das Lesen des Pfades selbst zurückfällt; die Dateirechte spielen damit überhaupt keine Rolle mehr. Das Drop-in wird bei jedem Lauf aus der Konfiguration neu erzeugt und führt nur Dateien auf, die existieren, denn systemd weigert sich, eine Unit zu starten, deren Credential-Quelle fehlt; führen Siepepsi-setup runerneut aus, nachdem Sie ein Zertifikat hinzugefügt, verschoben oder entfernt haben. Ändert sich das Drop-in, lädt pepsi-setup systemd neu und führt für den betroffenen Servertry-restartaus (nur wenn er läuft), damit das neue Material wirksam wird.POSIX-ACLs und ein certbot-Deploy-Hook — der Rückfall für eine Installation, die nicht von systemd ausgeführt wird, und das Vehikel für Erneuerungen. Für jedes certbot-verwaltete Zertifikat, auf das die Konfiguration verweist, gewährt pepsi-setup diesen Dienstbenutzern Lese- und Durchlaufrechte per POSIX-ACLs (
setfacl). Außerdem installiert es unter/etc/letsencrypt/renewal-hooks/deploy/pepsi-cert-access.sheinen certbot-Deploy-Hook, der die Rechtevergabe bei jeder künftigen Ausstellung/Erneuerung erneut anwendet und die Pepsi-Server neu startet. Eine einmalige Vergabe würde nicht überdauern, weil certbotarchive/<host>/privkeyN.pemrotiert; die Default-ACLs des Hooks sorgen dafür, dass auch neu erzeugte Dateien den Zugriff erben. Erst der Neustart nimmt ein erneuertes Zertifikat tatsächlich in Betrieb: Jeder Server liest sein Material einmal beim Start, und systemd stellt Credentials beim Start der Unit bereit. Diese Hälfte ist best effort: Sie benötigt root,setfacl(das Paketacl) und ein ACL-fähiges Dateisystem, und eine fehlende Voraussetzung wird mit der Abhilfe zurückgestellt, nicht als fatal behandelt. Zertifikate außerhalb von certbots Baum (vom Betreiber gesetzteTLS_CERT/TLS_KEY) werden nicht verwaltet, sondern nur mit einer Warnung erwähnt; deren Leserechte vergeben Sie selbst.Überprüfung — für alles, was kein Credential abdeckt, nimmt pepsi-setup nicht an, dass die Rechtevergabe funktioniert hat. Es forkt, wird zum Dienstbenutzer und versucht, die Datei zu öffnen; ein weiterhin unlesbares Zertifikat (eine vom Dateisystem stillschweigend ignorierte ACL, ein nur für root zugängliches übergeordnetes Verzeichnis, ein vom Betreiber gesetzter Pfad, für den niemand Rechte vergeben hat) wird so als zurückgestellter Schritt gemeldet, der die genaue Datei, den Benutzer und die Unit benennt, statt später als Server aufzutauchen, der den Start verweigert.
launchd unter macOS — die launchd-Jobs starten pepsi-ingress und pepsi-httpd als root, und jeder liest seine Zertifikate und Schlüssel, bevor er in sein Konto wechselt; daher muss keine Datei für einen Dienstbenutzer lesbar sein, und es wird keine ACL vergeben. pepsi-setup hält fest, welche TLS-Dateien jeder Server liest (unter
/var/lib/pepsi/launchd-tls), und startet den Job eines laufenden Servers neu (launchctl kickstart -k), wenn sich diese Liste ändert. Der certbot-Deploy-Hook wird ebenfalls installiert; unter macOS startet er nur die Jobs neu, die launchd geladen hat.Stellt die Erreichbarkeit von Dovecot sicher. Wenn lokale Zustellung über LMTP oder Submission-Authentifizierung über Dovecot-SASL konfiguriert ist, prüft pepsi-setup den konfigurierten Socket als der Dienstbenutzer, der sich mit ihm verbinden wird: der
pepsides Dispatchers für LMTP,pepsi-ingressfür SASL. Das fängt den häufigen Fall eines Sockets ab, der zwar existiert, aber unerreichbar ist: Dovecots geteilter/run/dovecot/auth-clientist0600 dovecotund kann vonpepsi-ingressnicht geöffnet werden. Wenn ein Socket fehlt oder nicht lesbar ist und ein lokales Dovecot vorhanden ist, bietet pepsi-setup (interaktiv als root laufend) an,/etc/dovecot/conf.d/10-pepsi.confzu installieren, einen dediziertenunix_listenerim Besitz des Pepsi-Dienstbenutzers (mode = 0600, sodass die Berechtigungen des geteilten Sockets unberührt bleiben). Danach validiert es die zusammengeführte Konfiguration mitdoveconfund lädt Dovecot neu. Wenn es das nicht kann (nicht root, kein Terminal zum Nachfragen,doveconfweist das Ergebnis ab oder kein lokales Dovecot), gibt es das Drop-in aus und schiebt es auf, damit Sie es von Hand ausrollen können. Pepsis Standard-SASL_PATHist dieser private Socket,/run/dovecot/auth-client-pepsi. Diese Prüfung läuft bei jedempepsi-setup run, nicht nur unter--wizard.-y/--yes-to-allinstalliert das Drop-in ohne Nachfrage;-n/--no-to-allüberspringt die Installation und gibt es nur aus; beides macht den Lauf vollständig nicht-interaktiv.Prüft auf einen anderen MTA auf den SMTP-Ports. Pepsi ist selten der erste Mailserver auf einem Host: Debian zieht Postfix oder Exim als Standard-
mail-transport-agentmit herein. Wenn einer von ihnen noch lauscht, kann pepsi-ingress nicht binden, und der Fehlschlag bleibt auf besonders irreführende Weise still: Unter Socket-Aktivierung ist espepsi-ingress.socket, das fehlschlägt (systemctl status pepsi-ingress.socketmeldetResult: resources), Mail wird weiterhin vom anderen Server mit dessen Alias- und Virtual-Maps zugestellt, und jede Änderung anpepsi.confscheint daher überhaupt keine Wirkung zu haben. pepsi-setup liest die Listener-Tabelle des Kernels (/proc/net/tcp) für jeden Port, den die[pepsi-ingress-listener-*]-Abschnitte benötigen, und benennt den beanstandeten Prozess (mit seiner PID), wenn der Inhaber wedersystemdnoch Pepsi selbst ist. Diese Ports sind der konfiguriertePORTbei einemSERVE = tcp-Listener und dieFD_INDEX-Zuordnung der mitgelieferten Socket-Unit (0 → 25, 1 → 465, 2 → 587) bei einemSERVE = systemd-Listener. Dies ist beratend: Es wird auf die Zusammenfassung am Ende des Laufs aufgeschoben, statt fatal zu sein, da ein Betreiber mitten in einer Migration den alten MTA bewusst noch eine Weile laufen lassen möchte. Beheben Sie es, indem Sie den anderen Server stoppen und deaktivieren (systemctl disable --now postfix) und dannpepsi-ingress.socketstarten.Prüft, dass der Resolver DNSSEC validiert, und nennt, wem er vertraut. In derselben Phase stellt pepsi-setup dem Resolver, den die Komponente verwendet (ihre
DNS_SERVERS,[pepsi] DNS_SERVERSoder/etc/resolv.conf), eine Frage, deren Antwort es kennt, und sucht nach demAD-Bit. Das geschieht nur, wenn die Konfiguration DANE verlangt: eine Relay-Stage, derenDANEnichtoffist (strictist der Standardwert für beide Relay-Stages und für jeden Smarthost-Abschnitt[pepsi-stage-relay-to-smarthost-mta-*]), oderdanein[pepsi-keydiscovery] SOURCES. Pepsi vertraut einem validierenden Resolver, statt DNSSEC selbst zu validieren. Setzt ein ResolverADnie, finden DANE und die DANE-basierte Schlüsselentdeckung daher stillschweigend überhaupt nichts; dieser Befund wird aufgeschoben, nicht als fatal behandelt. Danach nennt es, wem die Installation vertraut: Wenn einer dieser Resolver weder eine Loopback-Adresse ist noch über DNS over TLS oder HTTPS erreicht wird, führt ein Hinweis ihre IP-Adressen auf, sagt, wo jede genannt ist, und dass der Betreiber ihnen die DNSSEC-Validierung anvertraut. DasAD-Bit ist ein einzelnes nicht authentifiziertes Header-Bit. Wer einen solchen Resolver betreibt, und jeder auf dem Weg dorthin entscheidet daher, was als validiert gilt (ein gefälschter TLSA-,OPENPGPKEY- oderSMIMEA-Eintrag eingeschlossen). Zur Laufzeit wird nichts abgelehnt: Die DNS-Einrichtung liegt außerhalb von Pepsis Zuständigkeit, und die empfohlene Einrichtung ist ein eigener validierender rekursiver Resolver auf dem Host (unbound oder systemd-resolved mitDNSSEC=yes) unter127.0.0.1/::1, für den der Hinweis schweigt.checkgibt denselben Hinweis aus.Installiert das Datenbankschema. Jede Pepsi-Komponente teilt sich eine Datenbank (den
[pepsi-postgres]-Abschnitt) und das einepepsi-Schema; pepsi-setup ist der einzige Installer. Das Schema ist eine einzige Patch-Serie (pepsi-NNNN.sql) mit einerprocedures.sql, angewendet aus[pepsi-postgres] SQL_DIR(Standardwert${DATADIR}/sql). Die Operation ist idempotent und kann nach Upgrades erneut ausgeführt werden. Die anderen Komponenten haben keinen eigenen Befehl zur Schema-Initialisierung.Richtet die Datenbank-Login-Rollen ein. Jedes Pepsi-Dienstkonto bekommt eine gleichnamige PostgreSQL-Login-Rolle, über den lokalen Socket per Peer-Authentifizierung authentifiziert, und die Berechtigungen, die es auf dem
pepsi-Schema braucht. Die Pipeline-Rollepepsi(undpepsi-crypto) bekommt das ganze Schema, abzüglich der unten beschriebenen Rücknahmen. Als allerletzter Schritt werden die Berechtigungen der drei Dienste, die nicht die Pipeline sind, auf das zurückgestutzt, was eine Prüfung ihres Codes als tatsächlich genutzt ausweist, und das Setup weigert sich abzuschließen, wenn PostgreSQL dem widerspricht:pepsi-ingressINSERTinpepsi.workqueueundpepsi.workqueue_body(plusSELECTder IDs, dieworkqueue_addzurückgibt, und der beiden generierten Größenspaltenheader_octetsundoctets, die die Aufnahmeprüfung der Warteschlange summiert),SELECTaufconfig_override,mailbox_quota,login_assignment(der Test nach RFC 7293 beiRCPT), den heruntergeladenen IP-Sperrlisten (ip_blocklist,ip_blocklist_source) undcrl_cache(Widerruf von TLS-Client-Zertifikaten),SELECTder Spaltenlist_nameundmail_hostvonmailing_list(die Empfängerprüfung),INSERTauf den beiden nur anhängbaren Logs. Sie kann keine bereits eingereihte Nachricht lesen.pepsi-telemetryIhre eigene Tabelle
pepsi.telemetry.pepsi-httpdAlles, was die Konsole, das Portal, die Listen-Website und das Archiv verwenden, mit diesen Grenzen: Auf
pepsi.workqueuebekommt sie nur die Umschlag-,state- und Routing-Spalten, nieheadersoder den Nachrichtentext, und sie kann denbody_ideiner Nachricht nicht umbiegen. Aufpepsi.workqueue_bodybekommt sie nurINSERT(die Webformulare senden Mail) undDELETE(das Löschen einer Nachricht entfernt den Nachrichtentext, den nur sie trug; der Fremdschlüssel verhindert das Löschen eines Nachrichtentexts, auf den eine andere Nachricht noch verweist), nieSELECTdes Nachrichtentexts. Überhaupt nichts bekommt sie aufsettings,whitelist,vacation_reply,payment_request_reply, den Secretary-Tabellen,telemetry,origin_nonce,auto_pay_spend,archive_category,archive_tag,list_post_rate,mta_sts_policy,list_confirmation,crl_cache,ca_issuer_cache,smime_capability,otp_key,otp_pending,compromised_key,compromised_key_import,login_assignment,ip_blocklist,ip_blocklist_source,reputation_checkodersigned_sender. Nur lesen darf sie die Statistik-, Kontingent-, DNS-, TLS-Report- und DMARC-Report-Tabellen sowie die Lebendigkeitszeile des Telemetrie-Daemons (telemetry_client). Umgekehrt gehören die Tabellen mit Zugangsdaten (admin_account,admin_session,api_tokensowieown_enrolmentundown_sessionder Endbenutzer-Konsole) alleinpepsi-httpd, und die Audit- und Mail-Logs sind für jede Rolle, die Mail verarbeitet, nur anhängbar;pepsi-httpddarf zum Ausdünnen daraus löschen, aber keine Dienstrolle darf sie ändern.
Die Standardberechtigungen für Tabellen, die ein späterer Patch anlegt, werden
pepsi-ingressundpepsi-telemetryebenfalls entzogen. Die Begründung steht im Kapitel „Sicherheitsmodell“ des Handbuchs, und wie die Grenze getestet wird, in dessen Kapitel „Testsuite“.Drei weitere Rollen sind bewusst noch enger:
pepsi-whitelistBekommt
SELECT,INSERTundDELETEaufpepsi.whitelistund sonst nichts, sodass ein Programm, das jeder lokale Benutzer ausführen darf (pepsi-whitelist(1), setuid installiert), weder die Nachrichtenwarteschlange noch die Statistiken noch die Signierschlüssel erreichen kann.pepsi-keydiscDie Schlüsselentdeckungsdienste (pepsi-keydisc(1)), die aus dem offenen Internet geholtes Schlüsselmaterial parsen und daher der wahrscheinlichste Prozess hier sind, in den eingebrochen wird. Das ist die engste Rolle der Installation:
SELECT/INSERT/UPDATE/DELETEaufpepsi.peer_key(diesen Cache zu füllen ist ihre ganze Aufgabe, und die Konfliktregel muss einen Datensatz ersetzen können),SELECT/INSERT/UPDATEaufpepsi.key_request,EXECUTEauf denkeydisc_*-Funktionen und den beidencrypto_*-Helpern, die sie aufrufen,SELECT/INSERT/UPDATE/DELETEaufpepsi.crl_cache(die Sperrlisten, die sie abruft; sie ist die einzige Rolle, die sie schreibt, währendpepsiundpepsi-cryptosie nur lesen dürfen und keine andere Rolle sie sieht), dasselbe aufpepsi.ca_issuer_cache(die Zwischenzertifikate, die sie abruft),SELECTauf der Liste bekanntermaßen kompromittierter Schlüssel (pepsi.compromised_keyundcompromised_key_import, damit sie das Speichern eines aufgeführten Schlüssels verweigert) und aufpepsi.workqueueSELECTplus ein spaltenweisesUPDATE (status, timeout).Diese beiden Spalten sind der interessante Teil. Sie reichen genau aus, um eine an einer Adresse geparkte Nachricht von
pausedzurück aufpendingzu bewegen, waskeydisc_resolveundkeydisc_sweeptun (einfacheSECURITY INVOKER-Funktionen, sodass die Reichweite ausdrücklich gewährt statt geerbt werden muss). Mit einer Berechtigung auf Tabellenebene könnte dieses Konto die Empfänger oder den Nachrichtentext einer Nachricht umschreiben; mit diesen beiden Spalten kann es eine Nachricht nur aufwecken. Es hat überhaupt keinen Zugriff aufpepsi.crypto_identity.pepsi-cryptoDas Konto, das privates Ende-zu-Ende-Schlüsselmaterial verwahrt. Es erhält die gewöhnlichen Pipeline-Berechtigungen über das ganze Schema plus die Spalte
pepsi.crypto_identity.private_wrapped, und es ist die einzige Rolle, die diese Spalte bekommt. Es ist auch die einzige Rolle, die die Liste bekanntermaßen kompromittierter Schlüssel schreibt (pepsi.compromised_key,compromised_key_import: waspepsi-keys blocklist updateundpeer screenfesthalten);pepsiundpepsi-keydiscdürfen sie nur lesen, und die anderen Rollen sehen sie nicht. Wer sie schreiben kann, könnte Pepsi den Schlüssel jedes Korrespondenten ablehnen lassen, daher dürfen die Stage-Worker, die feindselige Mail parsen, es nicht.
Um diese letzte Spalte geht es bei der ganzen Übung. Unmittelbar nach den pauschalen Berechtigungen entzieht pepsi-setup das
SELECT/INSERT/UPDATEauf Tabellenebene fürpepsi.crypto_identityjeder gewöhnlichen Dienstrolle und gewährtSELECTSpalte für Spalte für jede Spalte außerprivate_wrappedzurück. Die gewöhnlichen Dienstrollen sindpepsi(der Dispatcher und jeder Stage-Worker),pepsi-ingress,pepsi-httpdundpepsi-telemetry.INSERTwird nicht zurückgewährt undUPDATEnur auf den Spalten, die der Code der Rolle schreibt: die Flagsis_primary,publishedundvks_wanted(pepsiundpepsi-httpd) und die Fortschrittsspalten für den Keyserver (pepsi). So können diese Rollen die öffentliche Hälfte einer Identität lesen und veröffentlichen, sie aber nicht ersetzen, ebenso wenig ihren Fingerabdruck oder für welche Adresse, welches Protokoll und welchen Zweck sie gilt, und die Kompromittierung einer unbeteiligten Stage liefert nicht mehr, selbst mit vollem Datenbankzugriff unter dieser Rolle; pepsi-setup fragt PostgreSQL danach und verweigert den Abschluss, wenn eine von ihnen noch eine andere Spalte schreiben kann. (DELETEhat in PostgreSQL keine Spaltengranularität und bleibt ganz: Eine Stage, die einen Identitätsdatensatz löschen kann, kann den Dienst verweigern, aber sie kann immer noch keinen Schlüssel lesen.) Die Spaltenliste wird ausinformation_schemazurückgelesen statt fest verdrahtet, sodass eine später hinzugefügte Spalte automatisch abgedeckt ist und die Berechtigung gegenüber dem Schema nicht veralten kann. Wie alles andere in diesem Schritt ist es idempotent und wird bewusst bei jedem Lauf erneut angewandt, weil die pauschalen Berechtigungen das Tabellen-Privileg jedes Mal wieder hinzufügen.Die verpackte Spalte ist nur die halbe Verwahrung; der Schlüssel, der sie öffnet, liegt in einem
secrets.d-Fragment (unten). Beachten Sie außerdem, dass die Peer-Authentifizierung von PostgreSQL sich nach der effektiven uid richtet, nicht nach der gid. Ein Programm, das diese Rolle sein muss, muss daher dieses Konto sein; genau das richtet pepsi-keys(1) um jeden Datenbankaufruf herum ein. Siehe pepsi-keys(1).Lässt die Signierschlüssel erzeugen. Es übergibt die Menge der Domains, für die Pepsi autoritativ ist, an den Signier-Daemon,
pepsi-dkim sync-domains DOMAIN...(siehe pepsi-dkim(1)). Diese Menge ist die Vereinigung von[pepsi-ingress] ACCEPTED_DOMAINS, den Domains vonSERVER_NAME/POSTMASTERjeder Stage, einer ausdrücklichenSIGNING_DOMAIN, der[pepsi-srs] SRS_DOMAINeiner SRS-Stage, dem festenRESPONSE_FROMeiner Selbstbedienungs-Stage und der[pepsi] ARC_DOMAIN, falls gesetzt. pepsi-setup erzeugt, liest oder hält nie einen privaten Schlüssel: Der Daemon erzeugt Schlüssel für jede Domain, die keine hat (einen RSA-Schlüssel mit[pepsi-dkim] RSA_BITSund einen Ed25519-Schlüssel, wieDKIM_ALGORITHMSundARC_ALGORITHMes verlangen), stellt die Schlüssel einer Domain außer Dienst, die die Menge verlassen hat, und gibt sein Statusdokument aus, aus dem run die DKIM-Einträge nimmt. Ein neuer Schlüssel signiert sofort, daher scheitert DKIM bei Empfängern, bis sein Eintrag veröffentlicht ist. Für jede Domain, für die der Daemon einen noch zu veröffentlichenden Eintrag oder eine auf das DNS wartende Rotation meldet, protokolliert run eine Warnung; vor einem RSA-Schlüssel unter 2048 Bit in diesem Status (unter einer anderen Richtlinie erzeugt) wird hier und alsnote:vonpepsi-setup checkgewarnt, mitpepsi-dkim rotateals Abhilfe. Wenn der Daemon nicht ausgeführt werden kann, wird der Schritt aufgeschoben, nicht als fatal behandelt: Die Einträge stammen aus der Statusdatei, die er zuletzt geschrieben hat, falls es eine gibt, und ausgehende Mail wartet in der Warteschlange, bis der Daemon für jede Domain Schlüssel hat.Sobald der Daemon antwortet, werden die DKIM-Schlüsseldateien, die Version 0.0.0 unter
[pepsi] KEY_DIRaufbewahrte (<domain>/dkim.rsa.keyund<domain>/dkim.ed25519.key), gelöscht, wobei jedes Verzeichnis je Domain leer zurückbleibt, da nichts mit ihnen signiert; ihre Einträge (<DKIM_SELECTOR>._domainkeyund<DKIM_SELECTOR>-ed25519._domainkey) werden protokolliert und als entfernbar ausgegeben.Gibt DNS-Einträge aus. Es schreibt auf die Standardausgabe, im BIND-Zonendateiformat, die für jede Domain zu veröffentlichenden Einträge: die öffentlichen DKIM-Schlüssel, die pepsi-dkim(1) als im DNS benötigt meldet (seine Schlüssel
next,currentundretiring, unter<DKIM_SELECTOR>-YYYYMM._domainkeyfür RSA und<DKIM_SELECTOR>-YYYYMM-ed25519._domainkeyfür Ed25519, ein RSA-Wert aufgeteilt in Zeichenketten in Anführungszeichen von höchstens 255 Bytes), eine SPF-Richtlinie (v=spf1 …), gebaut aus denPUBLIC_IP-Adressen jeder Relay-Stage (vereinigt; siehe unten), eine DMARC-Richtlinie (_dmarc.<domain>TXT; siehe unten) und einen MTA-STS-Eintrag (_mta-sts.<domain>TXT, sofern nichtMTA_STS_MODE = none), damit andere Absender für unsere eingehende Mail validiertes TLS verwenden. Die MTA-STS-Richtliniendatei selbst wird von pepsi-httpd(1) über HTTPS unterhttps://mta-sts.<domain>/.well-known/mta-sts.txtangeboten (ihremx-Menge kommt aus[pepsi] MTA_STS_MX, mit Rückfall auf das[pepsi-ingress] HOSTNAME), pepsi-setup gibt daher nur den_mta-sts-TXT-Eintrag aus sowie eine Erinnerung,mta-sts.<domain>auf den Server zu richten. Dieiddes Eintrags ist aus der eigenen Richtlinie dieser Domain abgeleitet, sodass zwei Domains mit verschiedenenmx-Mengen verschiedene ids bewerben. Anders als jeder andere Eintrag hier wird der MTA-STS-Eintrag nur für die[pepsi-ingress] ACCEPTED_DOMAINSausgegeben. DKIM, SPF und DMARC authentifizieren eine Identität, als die dieser Host sendet, sie decken daher die weitere Menge oben ab; MTA-STS ist ein Versprechen über eingehende Mail, und nur für eine angenommene Domain wird dieses Versprechen eingehalten: pepsi-httpd(1) antwortet allein für diese Hosts auf/.well-known/mta-sts.txt, und das Zertifikat (und jede Site des Front-Servers) wird allein für diese Namen beschafft. Eine Domain, die nur eine Sendeidentität ist (ein Relay-SERVER_NAME, eine ausdrücklicheSIGNING_DOMAIN, die[pepsi-srs] SRS_DOMAIN), aber dennoch einen veröffentlichten_mta-sts-TXT-Eintrag hat, erhält stattdessen einen; DELETE:-Kommentar: Der Eintrag bewirbt eine Richtlinie, die keine Komponente anbietet, die Anfrage fällt also auf das durch, was sonst auf dieser Adresse antwortet. Ist[pepsi-tlsrpt] RUAgesetzt, wird außerdem ein TLSRPT-Eintrag ausgegeben (_smtp._tls.<domain>TXT,v=TLSRPTv1; rua=…), damit andere Absender ihre TLS-Ergebnisse zu unseren Domains an die beworbene Adresse melden (siehe pepsi-tlsrpt(1)). Lange RSA-Einträge werden automatisch in mehrere Zeichenketten aufgeteilt. Schließlich schlägt es für jeden TLS-terminierenden Ingress-Listener einen DANE/TLSA-Eintrag (RFC 7672) unter dem MX-Hostnamen vor (_<port>._tcp.<HOSTNAME>IN TLSA 3 1 1 <hash>), wobei die Zuordnungsdaten der SHA-256 desSubjectPublicKeyInfodes ausgelieferten Zertifikats sind. Das ist die Form3 1 1(DANE-EE / SPKI / SHA-256), sodass der Eintrag Zertifikatserneuerungen übersteht, die dasselbe Schlüsselpaar wiederverwenden. Für ein certbot-Zertifikat, das es bezieht, übergibt es--reuse-key, und bei jedem Lauf setzt esreuse_key = Truein der Erneuerungskonfiguration (/etc/letsencrypt/renewal/<name>.conf) jedes certbot-Zertifikats, das die Konfiguration verwendet, sodass certbot den Schlüssel bei der Erneuerung behält und der Eintrag gültig bleibt. (Ein bereits für einen früheren Schlüssel veröffentlichter Eintrag muss dennoch durch den jetzt ausgegebenen ersetzt werden.) Ein bewusster Schlüsselwechsel ist ein manuelles Verfahren: Veröffentlichen Sie den Eintrag des nächsten Schlüssels neben dem aktuellen, warten Sie die TTL ab, wechseln Sie dann die Schlüssel und entfernen Sie den alten Eintrag (das Pepsi-Handbuch, Kapitel „Operations“, nennt die Schritte). Die bereits veröffentlichten TLSA-Einträge werden mit dem Zertifikat verglichen, das jeder Listener ausliefert. NebenHOSTNAMEumfasst das jeden MX-Host jeder angenommenen Domain und jede angenommene Domain selbst, sofern der Name auf diesen Host auflöst; ein Name, der anderswohin auflöst, pinnt den Schlüssel eines anderen Servers und wird übersprungen. Der Vergleich geht so vor, wie ein sendender MTA es tut (RFC 7672: ein DANE-EE-Eintrag gegen das Blattzertifikat, ein DANE-TA-Eintrag gegen jedes Zertifikat in der Kettendatei, jeder Selektor und Abgleichtyp): Wenn Einträge veröffentlicht sind und keiner passt, wird eine Warnung protokolliert und in den DANE-Block ausgegeben, weil jeder Absender, der DANE durchsetzt, die Zustellung an diesen Host verweigert, bis der Eintrag ersetzt ist. Eine Abweichung unter einem Namen, der kein MX-Host einer angenommenen Domain ist, wird ebenfalls gemeldet, mit dem Rat, den Eintrag zu entfernen: Absender, die RFC 7672 folgen, sehen dort nicht nach, aber ein Absender, der dort nachsieht, verweigert die Zustellung. Ist ein solcher Eintrag nicht DNSSEC-validiert, verwendet ihn kein Absender, und er wird nicht gemeldet. Ein DANE-TA-Eintrag, dessen Anker nicht in der Kettendatei steht (eine Wurzel, die der Server nicht sendet), kann nicht beurteilt werden und wird nur vermerkt. Jedes veröffentlichte TLSA-RRset wird außerdem bei den öffentlichen Resolvern ([pepsi] PUBLIC_RESOLVERS, die DNSSEC validieren) mit angefordertem AD-Bit abgefragt; ein Eintrag, den sie ohne es zurückgeben, wird als veröffentlicht, aber nicht DNSSEC-validiert gemeldet, ebenso dasMX-RRset einer angenommenen Domain, wenn TLSA-Einträge für den MX-Host dieser Domain existieren: Ein Absender verwendet TLSA-Einträge nur, wenn beide validieren (RFC 7672), daher macht eine unsignierte Zone oder ein fehlenderDSbei der übergeordneten Zone den Pin zur Dekoration. Ein Resolver, derSERVFAILantwortet (so zeigt sich auch eine gefälschte Signatur), liefert hier kein Urteil. Veröffentlichen Sie diese nur in einer DNSSEC-signierten Zone; der Eintrag für Port 25 ist der, der die Zustellung zwischen MTAs authentifiziert (Submission-Ports werden als Hinweis gekennzeichnet, da Absender dort das PKIX-Zertifikat verwenden). Für die HTTPS-Listener von pepsi-httpd(1) wird kein TLSA-Eintrag ausgegeben oder geprüft: HTTPS-Clients (Browser, Abholer von MTA-STS-Richtlinien) verwenden kein DANE, und das Webzertifikat hat einen eigenen Schlüssel, daher wird nur der Mail-Schlüssel gepinnt.Wenn Zertifikate über certbot von Let’s Encrypt stammen (ein
/etc/letsencrypt/live/-Pfad, dessen Erneuerungskonfiguration keinen anderen ACME-Server nennt), schlägt ein mit OPTIONAL, not applied gekennzeichneter Block einen CAA-Eintrag vor (RFC 8659), auskommentiert:; example.org. IN CAA 0 issue "letsencrypt.org", unter der angenommenen Domain, unter der jeder Zertifikatshost liegt (sonst unter dem Host selbst). Wenn das certbot-Konto der Lineage gelesen werden kann (bei Ausführung als root), trägt der Wert seineaccounturi(RFC 8657), sodass nur das ACME-Konto dieses Hosts ein Zertifikat beziehen kann. Der Eintrag lässt eine CA, die durch eine gekaperte Domain-Validierung getäuscht wird, die Ausstellung verweigern, aber er beschränkt jedes Zertifikat für die Domain, nicht nur Pepsis; deshalb wird er nie angewendet. Fügen Sie vor der Veröffentlichung einenissue-Eintrag für jede andere CA hinzu, die die Domain verwendet, und lassen Sieaccounturiweg, wenn sich das certbot-Konto ändern kann. Der Block wird nur zusammen mit anderen zu veröffentlichenden Einträgen ausgegeben; er lässt die Zonenausgabe nie für sich allein erscheinen. check meldet die tatsächlich veröffentlichten CAA-Einträge (siehe check).Ein mit Subdomains (SPF, OPTIONAL, not applied) gekennzeichneter Block schlägt, auskommentiert,
; *.example.org. IN TXT "v=spf1 -all"für jede bediente Domain vor, deren Platzhalter nicht bereits mit einem SPF-Eintrag antwortet. SPF wird für den genauen Namen inMAIL FROMausgewertet, daher erhält ohne ihn ein gefälschter Absender bei einer erfundenen Subdomain von jedem Empfänger, der DMARC nicht durchsetzt, SPFnone. Er wird nie angewendet, weil ein Platzhalter-TXT-Eintrag auch die Antwort auf jede andere TXT-Abfrage nach einem nicht existierenden Namen unterhalb der Domain ist, und er antwortet nicht für einen Namen, der existiert; check führt diese auf (siehe check). Wie der CAA-Block lässt er die Zonenausgabe nie für sich allein erscheinen.Zwei weitere Blöcke betreffen die Veröffentlichung von Ende-zu-Ende-Schlüsseln (siehe pepsi-keys(1)). Erstens für jede bediente Domain, deren
openpgpkey.<domain>-Host nicht bereits auflöst, eine Erinnerung, dafür einen A/AAAA-Eintrag zu veröffentlichen: Die advanced-Methode des Web Key Directory, die jeder aktuelle Client zuerst versucht, wird von diesem Namen abgeholt; er muss also auf den pepsi-httpd(1)-Host zeigen. Eine Domain, die bereits Schlüssel veröffentlicht, wird in der Ausgabe gekennzeichnet und im Journal beanstandet, denn für sie schlägt die erweiterte Abfrage heute fehl, statt bloß unkonfiguriert zu sein. (Die direct-Methode auf dem Apex funktioniert ohne ihn, sodass dies eine Verschlechterung ist, kein Ausfall.) Zweitens einOPENPGPKEY- (RFC 7929) oderSMIMEA-Eintrag (RFC 8162) für jede veröffentlichte, aktive Identität im Schlüsselspeicher, unter dem gehashten Eigentümernamen des RFC (SHA-256 des lokalen Teils auf 28 Oktette gekürzt, hexadezimal; das ist nicht der Web-Key-Directory-Hash, der z-base-32-SHA-1 des kleingeschriebenen lokalen Teils ist). Diese werden nicht gegen Live-DNS verglichen: Jeder ist ein paar hundert Bytes, dessen Eigentümername ein Hash je Identität ist, sodass Sondieren eine Abfrage je Benutzer für Einträge kostete, die der Betreiber geschlossen einfügt. Die Auflistung endet nach zwanzig Identitäten; verwenden Siepepsi-keys dns <address>für eine bestimmte. Veröffentlichen Sie Schlüsseleinträge nur in einer DNSSEC-signierten Zone: Ein Schlüssel in einer unsignierten Zone kann von jedem stammen, der für die Zone antworten kann. Ein weiterer Kommentar sagt, was der Existenznachweis der Zone verrät: UnterNSEClässt sich jede veröffentlichte Adresse auflisten und unterNSEC3lassen sich die gängigen Local-Parts wiederherstellen, wogegen Online-Signieren mit minimal abdeckenden Einträgen (RFC 4470/7129) schützt; eine Adressliste, die privat bleiben muss, wird nur per WKD veröffentlicht.Ein letzter Block betrifft die Mail-Autokonfiguration. Ist
[pepsi-autoconfig]eingeschaltet, wird jederautoconfig.<domain>-Host einer bedienten Domain, der noch nicht auflöst, mit dem Hinweis aufgeführt, ihn auf den pepsi-httpd(1)-Host zu richten. Anders als beim Web-Key-Directory-Hinweis oben kommt das eher einem Totalausfall gleich als einer Verschlechterung: Ein Client versucht zuersthttps://autoconfig.<domain>/mail/config-v1.1.xml, und die/.well-known/-Form am Apex, die keinen neuen Eintrag benötigt, ist im Entwurf optional, sodass ein Client, der sie nicht versucht, schlicht nichts findet.Der SPF-Eintrag wird aus
PUBLIC_IPgebaut, einer stage-weisen Option, die pepsi-setup aus jeder Relay-Stage liest und vereinigt. Eine Relay-Stage wird an ihremPROGRAMerkannt (pepsi-stage-relay-to-internet(1) oder pepsi-stage-relay-to-smarthost(1)), niemals am Abschnittsnamen. Eine Installation kann somit mehrere Relay-Stages haben, jede mit ihrem eigenenPUBLIC_IP(eine pepsi-stage-relay-to-internet-Stage listet die eigenen Sende-IPs dieses Hosts auf; eine pepsi-stage-relay-to-smarthost-Stage listet die Egress-IPs des Smarthosts auf, da Mail von dort aus ins Internet geht). Wenn eine Relay-Stage existiert, aber keinePUBLIC_IPsetzt, ist der Eintrag ein bloßesv=spf1 -all, das allen Hosts verbietet, als Ihre Domains zu senden, und Ihre eigene ausgehende Mail bei SPF durchfallen lässt; pepsi-setup protokolliert dann eine Warnung. Vor einer reinen Empfangs-Installation (keine Relay-Stage) wird nicht gewarnt. Der vereinigte Eintrag wird für jede bediente Domain identisch vorgeschlagen: korrekt, aber weit gefasst. In besonderen Konstellationen, in denen verschiedene Domains von verschiedenen Hosts senden, ist ein von Hand geschriebener SPF-Eintrag je Domain, der nur die eigenen Sende-IPs jener Domain auflistet, enger und dennoch korrekt; pepsi-setup berechnet diese Gruppierung nicht automatisch und gibt einen entsprechenden Hinweis neben den vorgeschlagenen Einträgen aus.Ein SPF-Fall erhält in der Zonenausgabe einen ausdrücklichen Hinweis, nicht bloß einen vorgeschlagenen Eintrag: eine Domain, die bereits zwei
v=spf1-Einträge veröffentlicht. RFC 7208 §4.5 macht das zu einem dauerhaften Fehler, sodass keine SPF-Richtlinie gilt (der erste Eintrag gewinnt nicht). Die Abhilfe ist, die Einträge zusammenzuführen. Der vorgeschlagene Eintrag wird daher mit dem Hinweis ausgegeben, dass es nichts ändert, ihn hinzuzufügen, ohne die anderen zu entfernen. Ein übriggebliebenesv=spf1 include:<old provider>ist das Häufigste, was eine MTA-Migration hinterlässt.Jeder Term des veröffentlichten Eintrags wird gegen die Grammatik von RFC 7208 §12 geprüft, nicht nur die
ip4:/ip6:-Terme, die pepsi-setup verlangt: die Mechanismenall,include,a,mx,ptr,ip4,ip6undexistsmit ihren Qualifikatoren, Adresssyntax und CIDR-Längen (/0–/32,/0–/128), die Modifikatorenredirect=undexp=(jeder höchstens einmal), unbekanntename=value-Modifikatoren, Domain-Argumente, die auf ein Top-Level-Label enden, und Makrosyntax. Ein unbekannter Mechanismus (ipv4:,ip:,inculde:) oder ein fehlerhafter Term lässt Empfänger für den ganzen Eintrag einen permanenten Fehler zurückgeben, sodass keine SPF-Richtlinie gilt, obwohl unsere Adressen aufgeführt sind; check meldet ihn als[INVALID]unter Nennung des Terms, und die Reparatur erfolgt an Ort und Stelle.ptrist gültig, wird aber vermerkt: RFC 7208 §5.5 sagt, es SOLLTE NICHT verwendet werden.Der veröffentlichte SPF-Eintrag jeder bedienten Domain wird außerdem gegen die Verarbeitungsgrenzen von RFC 7208 §4.6.4 gezählt: Jedem
include:undredirect=folgend (einemredirect=nur, wenn der Eintrag keinallhat), summiert es die Terme, die eine DNS-Abfrage auslösen (include,a,mx,ptr,exists,redirect), und die leeren Abfragen darunter (eina-,mx- oderinclude-Ziel, das nicht existiert). Mehr als 10 Abfragen oder mehr als 2 leere, und Empfänger geben einen permanenten Fehler zurück: Die Domain hat keine verwendbare SPF-Richtlinie, obwohl der Eintrag gut aussieht. Die Zählung ist der schlimmste Fall (kein Mechanismus passt vor dem Ende), und das ist der Fall, unter dem eine gefälschte Nachricht beurteilt wird. Eine Warnung wird protokolliert, und check meldet es als[INVALID].Der DMARC-Eintrag ist der eine, den pepsi-setup nicht ableiten kann: Welche Richtlinie eine Domain will, ist eine Betreibertscheidung, keine Folge der Konfiguration. Dieser Block handelt daher davon, dass der Eintrag brauchbar ist, und er verhält sich je nach dem, was bereits veröffentlicht ist, unterschiedlich:
Nichts veröffentlicht.
v=DMARC1; p=reject; adkim=swird vorgeschlagen: Jede Nachricht, die Pepsi für eine bediente Domain sendet, trägt eine DKIM-Signatur, derend=genau dieFrom:-Domain ist. Die Richtlinie, die Fälschungen tatsächlich aufhält, kostet die eigene Mail daher nichts, selbst mit strikter DKIM-Ausrichtung, die verhindert, dass die Signatur einer Subdomain für die Domain spricht. Der Kommentar daneben nennt das eine Risiko: Ein anderer Dienst, der als die Domain sendet (ein Newsletter-Werkzeug, ein Ticketsystem), muss zuerst mit ausgerichtetem DKIM signieren oder in SPF aufgeführt werden, und bis dahin istp=none(nur Überwachung) der Rückfall; für einen Dienst, der als Subdomain signiert, mussadkim=sentfallen. Die SPF-Ausrichtung bleibt locker, und der Kommentar empfiehlt,aspf=shinzuzufügen, sobald jeder Dienst, der als die Domain sendet, einen Umschlagabsender genau bei ihr verwendet (Pepsi tut das). Wenn eine Stage pepsi-stage-dmarc-report(1) für die Domain ausführt, ergänzt der Vorschlagrua=mailto:dmarc-reports@<domain>(ihrenLOCAL_PART). Unter dieser Adresse liest die Stage die Aggregatberichte, die Ihnen sagen, ob jeder Absender ausgerichtet ist; check meldet dann, was sie sagen. Ohne eine solche Stage bittet der Kommentar um einrua=mailto:<address>und nennt die Stage.Ein gültiger Eintrag. Nichts wird ausgegeben, genau wie bei den anderen Einträgen, es sei denn, eine Stage liest die Berichte und das
rua=des Eintrags lässt ihre Adresse aus: Dann wird der stattdessen zu veröffentlichende Eintrag ausgegeben, der veröffentlichte mit allen Tags in ihrer Reihenfolge und der Adresse inrua=hinzugefügt (oder einem am Ende angefügtenrua=-Tag). Jedesrua=/ruf=-Ziel wird geprüft, wie check es beschreibt (ein externes ohne seinen_report._dmarc-Autorisierungseintrag, eines, das keine Mail empfangen kann); ein Problem wird als; WARNING:-Kommentar ausgegeben und protokolliert. Ist seinp=quarantineoderrejectund[pepsi-ingress] DMARC_ENFORCEaus, wird eine Warnung protokolliert: Die Domain bittet jeden anderen Empfänger, auf einen DMARC-Fehlschlag zu reagieren, den dieser Host zustellt. Eine Warnung empfiehlt denselben Eintrag mitsp=reject; np=reject, wenn der Eintrag den Subdomains eine schwächere Richtlinie alsrejectlässt: einp=außerrejectohnesp=oder ein ausdrückliches schwächeressp=odernp=(die Richtlinie für Namen, die nicht existieren). Eine Subdomain, als die niemand Mail sendet, kann Fälschungen ablehnen, während die Domain selbst noch überwacht wird. check zeigt denselben Rat neben dem Eintrag.Ein Eintrag, den Empfänger ignorieren würden. Der Grund wird als Kommentar ausgegeben und als Warnung protokolliert, und es wird kein Ersatzwert angeboten. Das ist Absicht: Ein Eintrag, der nicht parst, ist immer noch eine Absichtserklärung, und ein fehlerhafter Eintrag muss dort repariert werden, wo er steht, statt durch den bloßen Eintrag ersetzt zu werden, den dieses Werkzeug sonst vorschlüge. Wer einen Tippfehler behebt, sollte nicht stillschweigend das
rua,spoder bewusstep=quarantineeiner Domain verlieren.
Die Gültigkeit wird streng beurteilt, Tag für Tag, gegen RFC 7489 §6.4 statt durch Suche nach Teilzeichenketten, denn ein DMARC-Eintrag scheitert stillschweigend: Nichts bounct, kein Empfänger beschwert sich, und die Domain hört einfach auf, geschützt zu sein, während alle glauben, sie sei es. Insbesondere ist ein Eintrag mit einem einzigen fehlenden
;, etwa… p=reject; aspf=s adkim=s, immer noch vollkommen gute generische Tag-Listen-Syntax (RFC 6376 §3.2 erlaubt Leerzeichen und=innerhalb eines Tag-Werts). Ein nachsichtiger Leser sieht daher das Tagaspfmit dem Werts adkim=sund akzeptiert es; nur die DMARC-spezifische Wertegrammatik lehnt es ab. Wo der beanstandete Wert etwas enthält, das wie das nächste Tag aussieht, sagt die Diagnose das beim Namen (tags are separated by ';', and there is none before 'adkim='). Die anderen gemeldeten Dinge sind ein zweiter DMARC-Eintrag unter demselben Namen (RFC 7489 §6.6.3: Empfänger verwerfen die ganze Menge), ein wiederholtes Tag (RFC 6376 §3.2, wo undefiniert ist, welcher Wert gewinnt), ein fehlendesp=-Tag und einerua=/ruf=-Adresse ohne ihrmailto:-Schema. Alles, was pepsi-setup gültig nennt, wird in der Testsuite gegen genau den Parser gegengeprüft, den pepsi-ingress(1) auf eingehende Mail anwendet. Ein Eintrag, den dieses Werkzeug gutheißt, kann daher keiner sein, den ein Empfänger wegwirft. Die obigen Prüfungen sind bewusst strenger als jener Parser, denn ein Eintrag kann parsen und dennoch nicht die Richtlinie sein, die sein Autor veröffentlicht hat.Bevor es jeden TXT-Eintrag (DKIM, SPF, DMARC, MTA-STS, TLSRPT) vorschlägt, fragt pepsi-setup zunächst Live-DNS ab (nach bestem Bemühen): Ein Eintrag, der bereits mit dem korrekten Wert veröffentlicht ist, trägt nichts zur Ausgabe bei, nicht einmal seine Abschnittsüberschrift für die Domain, sodass nur die Einträge ausgegeben werden, die wirklich (neu) veröffentlicht werden müssen. Die
mta-sts.<domain>-Erinnerung, einen A/AAAA-(oder CNAME-)Eintrag zu veröffentlichen, wird ebenfalls nur ausgegeben, wenn dieser Host nicht bereits auflöst, und der DANE/TLSA-Block wird nur ausgegeben, wenn ein TLS-terminierender Ingress-Listener existiert. Wenn nichts geändert werden muss, wird der ganze Zonen-Dump unterdrückt und stattdessen eine einzelnesetup: DNS records checked and they are OK-Zeile protokolliert, sodass ein erneuter Lauf über eine bereits konfigurierte Zone still ist. Die Probe ist nicht fatal: Wenn das DNS unerreichbar ist (oder kein Resolver gebaut werden kann), wird jeder Eintrag als Änderung behandelt und ausgegeben. Der DMARC-Block ist in dieser letzten Hinsicht die Ausnahme: Ohne Antwort vom DNS gibt es nichts zu vergleichen und keinen lokalen Wert, auf den zurückzufallen wäre, sodass er still bleibt, statt einer womöglich bereits korrekten Domain zu sagen, sie solle eine neue Richtlinie veröffentlichen. (Verwenden Sie den check-Unterbefehl zur Live-Überprüfung der veröffentlichten TXT-Einträge.)„Bereits mit dem korrekten Wert veröffentlicht“ heißt korrekt auf jedem autoritativen Nameserver der Zone, nicht nur in der Antwort des System-Resolvers. Für jeden TXT-Eintrag ermittelt pepsi-setup außerdem die
NS-Menge der Zone und fragt jeden Server direkt, ohne Rekursion: Ein Secondary, der noch einen alten Schlüssel ausliefert, ein delegierter Server, der die Zone nicht mehr bedient (eine lahme Delegation), oder einer, der gar nicht antwortet, lässt Empfänger den richtigen Eintrag nur zeitweise sehen; der Eintrag wird daher mit einer; NOTE:-Zeile ausgegeben, die jeden abweichenden Server nennt (und eine Warnung wird protokolliert). Eine falsche Antwort des Resolvers, der jeder autoritative Server widerspricht, wird als veralteter Cache markiert. Wenn kein autoritativer Server erreichbar ist, etwa in einem Netz, das nur den lokalen Resolver auf Port 53 hinauslässt, wird einmal eine Warnung protokolliert, und allein die Antwort des Resolvers entscheidet.Ein DKIM-Selektor-Eintrag wird so beurteilt, wie ein Verifizierer ihn liest (RFC 6376 §3.6.1), nicht allein nach seinem
p=: genau ein Schlüsseleintrag unter dem Namen,v=(falls vorhanden) zuerst undDKIM1, eink=, das den Schlüsseltyp nennt (ein Ed25519-Schlüssel ohnek=-Tag scheitert überall, da das Tag standardmäßigrsaist), keineh=/s=-Einschränkung, diesha256/emailausschließt, keint=y(Testmodus, in dem eine Signatur nichts zählt) und einp=gleich dem Schlüssel, den pepsi-dkim(1) für den Selektor meldet. Nur die Selektoren, mit denen[pepsi] DKIM_ALGORITHMSsigniert, werden ausgegeben und geprüft, dazu derjenige, den das ARC-Siegel an derARC_DOMAINbraucht. Ein Eintrag, der entfallen kann, wird als; remove:-Kommentar ausgegeben, nie als Eintrag; ein solcher Eintrag gehört zu einem Schlüssel, den der Daemon außer Dienst gestellt hat, oder zu einer 0.0.0-Schlüsseldatei, die run gelöscht hat. Hat der Daemon seine Schlüssel noch nicht gemeldet, hat die Zone keine DKIM-Einträge, und eine Warnung sagt,pepsi-dkim.servicezu starten und erneut nachzusehen. Neben dem Ed25519-Eintrag, oder in einer Logzeile, wenn jeder Eintrag bereits korrekt ist, vermerkt pepsi-setup, dass Gmail, Microsoft 365 und Yahoo keine Ed25519-Signaturen verifizieren und dass Googles DMARC-Aggregatberichte sie alsfailführen. Das ist erwartet und harmlos, da die RSA-Signatur das ausgerichtete Bestehen für DMARC liefert, und die Ed25519-Signatur lässt sich mitDKIM_ALGORITHMS = rsaabstellen.In derselben Phase prüft pepsi-setup außerdem das Reverse DNS (PTR) jeder
PUBLIC_IPeiner pepsi-stage-relay-to-internet-Stage, also der eigenen Egress-Adressen dieses Hosts (einePUBLIC_IPvon pepsi-stage-relay-to-smarthost ist die des Smarthosts und wird daher übersprungen). Jede Adresse wird gegen den Namen beurteilt, den die besitzende Stage ankündigt, ihrSERVER_NAME(das auf das Ingress-HOSTNAMEzurückfällt, wenn eine Stage keines setzt), denn das ist das Paar, das ein Empfänger vergleicht. EinePUBLIC_IPist nur dann korrekt, wenn ihrPTRexistiert, vorwärtsbestätigt und genau diesen Host benennt; jedes andere Ergebnis ist eine Warnung:kein PTR-Eintrag — ein starkes Spam-Signal bei vielen Empfängern;
ein PTR, der nicht vorwärtsbestätigt ist — der
PTR-Hostname löst nicht (A/AAAA) auf dieselbe IP zurück auf, sodass die Rundlaufprüfung (forward-confirmed reverse DNS, FCrDNS), die viele MTAs anwenden, fehlschlägt und sie die IP behandeln, als hätte sie überhaupt keinenPTR;ein generischer / dynamisch zugewiesen wirkender PTR — ein Name, der die IP einbettet oder ein Token aus einem Endkunden-Pool trägt (
dynamic,dsl,pool…), was Empfänger oft bestrafen;ein PTR, der einen anderen Host benennt als der ``EHLO``-Name — der Eintrag ist vollkommen wohlgeformt und vorwärtsbestätigt, er benennt nur einen anderen Host. Eine große Familie von Empfängern verweigert die Sitzung rundweg mit HELO host does not match rDNS. Das greift auch dann, wenn der ``PTR``-Name eine Ihrer eigenen
ACCEPTED_DOMAINSist: Eine Maschine, die auf mehrere Namen hört (etwaexample.orgimEHLOangekündigt, während ihre Adresse rückwärts aufexample.netauflöst), besteht hier jede andere Prüfung und bekommt ihre Mail dennoch abgewiesen;ein PTR, der überhaupt nicht nachgeschlagen werden konnte — eine nicht delegierte Reverse-Zone oder unerreichbares DNS. Die Korrektheit ließ sich nicht feststellen, und eine Adresse ohne brauchbaren
PTRwird von vielen Empfängern abgewiesen oder als Müll behandelt, sodass dies gemeldet statt stillschweigend übergangen wird.
Jede Warnung trägt eine konkrete Abhilfe. Weil das Reverse DNS einer
PUBLIC_IPin der Zone des IP-Eigentümers liegt (in-addr.arpa/ip6.arpa), besteht die übliche Abhilfe darin, Ihren ISP oder Hoster zu bitten, denPTRauf den angekündigten Namen zu setzen; wenn Sie die Reverse-Zone selbst betreiben, gibt die Fehlender-PTR-Meldung den genauen… IN PTR …-Eintrag zum Veröffentlichen aus. Bei einer Namensabweichung, wo derPTRbereits eine Ihrer eigenen Domains ist, bietet die Meldung auch die andere Richtung an, denn diese Abhilfe braucht niemandes Mitwirkung: denPTR-Namen als Identität dieses Hosts zu übernehmen ([pepsi-ingress] HOSTNAMEund dasSERVER_NAMEjeder Stage, wobei MX-Eintrag und TLS-Zertifikat folgen). Die beiden Namen müssen einen Host bezeichnen; sich eine Domain zu teilen genügt nicht. Die Hostnamen-Vorgabe des Assistenten stammt aus derselbenPTR-Abfrage (siehe –wizard unten), sodass eine im Interview erzeugte Konfiguration von vornherein mit dem Reverse DNS übereinstimmt.Eine Relay-Stage mit
EHLO_FROM_PTR = yes(siehe pepsi.conf(5)) kündigt den vorwärts bestätigtenPTR-Namen ihrer Absendeadresse selbst an. Für diese Stage wird derPTRdeshalb mit ihrem eigenen Namen verglichen: Eine Namensabweichung kann nicht auftreten, ein fehlender, unbestätigter oder generisch aussehenderPTRwird aber weiterhin gemeldet. Ohne vorwärts bestätigten Namen greift die Stage aufSERVER_NAMEzurück, und die Prüfung beurteilt diesen Namen wie gewohnt.DNS, wie das Internet es sieht. Jede obige Prüfung erfolgt von diesem Host aus, und von dort sieht eine Zone, die aus dem eigenen Netz des Hosts bedient wird, immer gesund aus. Hinter NAT wird eine Anfrage von innen nach einer Reverse-Zone, deren Nameserver genau diese Maschine ist, vom LAN, vom Router oder vom Host selbst beantwortet. Eine Anfrage aus dem Internet dagegen läuft an einem Router, der Port 25 weiterleitet, aber nicht Port 53, in einen Timeout. Oder sie erreicht einen Nameserver, der eine kleinere Zone bedient, als die übergeordnete Zone delegiert, sodass Resolver, die ihre Anfragen minimieren (RFC 9156),
REFUSEDerhalten. Empfänger stellen dann jede Nachricht mit cannot find your reverse hostname zurück, und die lokale Prüfung sagt, derPTRsei korrekt.Deshalb fragt pepsi-setup erneut über die öffentlichen Resolver, die
[pepsi] PUBLIC_RESOLVERSnennt (standardmäßig Google, Cloudflare und Quad9, jeweils über IPv4 und IPv6; siehe pepsi.conf(5)): denPTRjederPUBLIC_IP, vorwärts bestätigt über denselben Resolver; dieMX-Menge jeder Domain und die TXT-Einträge, die der Unterbefehl check prüft; und die Adressen des Ingress-HOSTNAME. Alle werden gefragt, weil sie sich in der Adressfamilie unterscheiden, über die sie einen Nameserver erreichen, und darin, wie sie eine Delegation abschreiten. Eine Zone, die nur über IPv6 erreichbar oder nur für einen minimierenden Resolver lahm ist, scheitert bei einigen von ihnen und bei anderen nicht. Ein Empfänger verwendet ebenfalls einen davon. Jeder Resolver, der einen Namen nicht auflösen kann, keinen Eintrag findet oder eine andere Antwort sieht als dieser Host (Split-Horizon-DNS),, ist eine Warnung, die den Resolver nennt und, sofern er einen sendet, seinen erweiterten Fehler nach RFC 8914 (No Reachable Authority: At delegation …). Lösen sich die Nameserver der Zone zu eigenen oder privaten Adressen dieses Hosts auf, sagt die Warnung das und nennt die üblichen Ursachen: eine Portweiterleitung, die für UDP- oder TCP-Port 53 fehlt oder deaktiviert ist, eine IPv6-Firewallregel oder eine bediente Zone, die nicht die delegierte ist. Der Unterbefehl check meldet diese als[UNREACHABLE](ein korrekter Eintrag, den das Internet nicht lesen kann) und führt diePTR-Urteile in einer eigenen Gruppe reverse DNS auf.Resolver, die von diesem Host aus nicht erreichbar sind, werden stillschweigend verworfen (ein Host ohne IPv6-Konnektivität verliert die IPv6-Resolver); ist keiner erreichbar, wird einmal eine Warnung protokolliert und nur die lokale Sicht geprüft.
PUBLIC_RESOLVERS = noneschaltet diese Prüfung ab.MTA-STS-Gegenprüfungen. Alles Übrige, was pepsi-setup über MTA-STS prüft, ist konstruktionsbedingt in sich stimmig: der
_mta-sts-TXT-Eintrag trägt eineid, die aus der Richtlinie abgeleitet ist, und die Richtlinie ist aus der Konfiguration abgeleitet, ein Vergleich kann also nur gelingen. Zwei Dinge sind nicht aus der Konfiguration abgeleitet, und unterMTA_STS_MODE = enforcestoppt jedes davon, wenn es falsch ist, stillschweigend die gesamte eingehende Post für die Domain. Beide werden bei jedempepsi-setup rungeprüft und vom Unterbefehl check sowie von der Webkonsole gemeldet; wie diePTR-Befunde sind sie Warnungen und lassen den Lauf nie scheitern.Die ``mx``-Menge der Richtlinie gegen die lebenden MX-Einträge. Eine Richtlinie ist ein Versprechen, dass Absender sich nur mit den von ihr genannten Hosts verbinden dürfen. Ein Absender löst den
MXder Domain auf, findet einen Host, den die Richtlinie nicht erlaubt, und weigert sich zuzustellen. Jeder konforme Absender tut das gleichzeitig, und auf dieser Seite gibt es kein Symptom außer Post, die nie ankommt. Das ist der Fehlschlag, den derMTA_STS_MX-Rückfall einlädt, dennHOSTNAMEist derEHLO-Begrüßungsname und muss kein Name sein, auf den irgendeinMX-Eintrag zeigt. Die Warnung benennt die Hosts auf jeder Seite und gibt die einzelneMTA_STS_MX-Zeile aus, die sie in Übereinstimmung bringen würde, je Domain qualifiziert, wenn die bedienten Domains verschiedene MX-Hosts haben, dazu die Alternative, stattdessen denMX-Eintrag zu ändern, und den Rat, bis zur Übereinstimmung aufMTA_STS_MODE = testingzurückzufallen. Diese Prüfung meldet außerdem eine Domain ohneMX-Eintrag, ein Null-MX nach RFC 7505 auf einer Domain, für die wir Post annehmen, einMX-Ziel, das einCNAMEist (von RFC 5321 §5.1 verboten, und Absender dürfen es ablehnen), einen Richtlinieneintrag, der auf keinen lebendenMX-Host passt (harmlos, weitet aber, womit Absender sich verbinden werden), und einenDOMAIN:HOST-Eintrag, der eine Domain benennt, die nicht inACCEPTED_DOMAINSsteht. Ein solcher Eintrag gilt für überhaupt keine Richtlinie, und genau so sieht ein Tippfehler in der Option aus.Ob die Richtlinie abgeholt werden kann.
pepsi-setupforderthttps://mta-sts.<domain>/.well-known/mta-sts.txtan und vergleicht das Zurückkommende mit der Richtlinie, die diese Konfiguration definiert. Der Vergleich ist semantisch, Zeilenenden und Schlüsselreihenfolge sind also keine Unterschiede. Umleitungen werden nicht verfolgt, denn RFC 8461 §3.3 verbietet einem Absender, ihnen zu folgen, und eine Richtlinie, die nur hinter einer angeboten wird, ist eine Richtlinie, die kein Absender lesen kann. Ein korrekter TXT-Eintrag vor einer Richtlinie, die niemand abholen kann, ist nicht hypothetisch. Ein unerreichbarer Socket, ein falsch konfigurierter vorgelagerter Server oder ein fehlendes Zertifikat genügt, damit jeder Absender stattdessen ein502erhält, während jede Unitactivebleibt und nichts protokolliert wird. Absender, die eine Richtlinie schon zwischengespeichert haben, setzen bis zumax_agelang weiter die alte durch, der Fehlschlag endet also nicht einmal von selbst. Ein5xxwird gemeldet, mit dem Socket des vorgelagerten Servers als dem, was zu prüfen ist.Wenn der veröffentlichte Name von diesem Rechner aus nicht erreichbar ist, weil er noch nicht auflöst oder weil das Netz den Rechner seine eigene öffentliche Adresse nicht erreichen lässt, wird die Anfrage über die Loopback-Schnittstelle gegen diese Maschine wiederholt. Der veröffentlichte Name bleibt dabei in SNI und
Host, sodass das Zertifikat weiterhin gegen den Namen geprüft wird, den ein Absender benutzen würde. Dieses Ergebnis wird als lokale Sondierung gekennzeichnet, denn es sagt, was ein Absender erhalten würde, sobaldmta-sts.<domain>hierher auflöst; es ist der Grund, weshalb eine rein lokale Fehlkonfiguration auch auf einem Rechner gemeldet wird, dessen DNS noch nicht veröffentlicht ist.
Die SRS-Domain kann ihre eigenen Bounces empfangen. Wenn eine Stage pepsi-stage-srs(1) ausführt, prüft pepsi-setup, dass
[pepsi-srs] SRS_DOMAINeinenMX-Eintrag hat oder andernfalls einenA/AAAA-Eintrag (den impliziten MX aus RFC 5321 §5.1). Eine SRS-Adresse ist ein Rückweg: Das Umschreiben macht diesen Host zum Bounce-Ziel für Mail, die er nicht geschrieben hat, und der HMAC in der Adresse existiert, damit pepsi-ingress(1) einen zurückkommenden Bounce dekodieren und an den ursprünglichen Absender weiterleiten kann. Fehlen beide Einträge, endet diese Rundreise im Schweigen: Das Weiterleiten funktioniert, SPF besteht beim nächsten Hop, und jeder Bounce wird von dem MTA verworfen, der ihn zurückzusenden versuchte. Dem ursprünglichen Absender wird also nie gesagt, dass seine Nachricht nicht ankam. Ein Null-MX nach RFC 7505 (MX 0 .) ist dieselbe Antwort, absichtlich ausgesprochen, und einMX-Ziel, das einCNAMEist, wird aus demselben Grund gemeldet wie überall sonst (RFC 5321 §5.1, RFC 2181 §10.3). Die Warnung gibt den zu veröffentlichenden Eintrag aus und benennt dabei einen Host, an den die angenommenen Domains schon Mail routen, und bietet als Alternative an, die Stage wegzulassen, wenn nichts nach außen weitergeleitet wird. (Eine angenommene Domain, die bereits empfangen würde, ist keine Alternative: Sie ist mit sich selbst DMARC-ausgerichtet, siehe oben.) Wie die Prüfungen oben ist sie eine Warnung und lässt den Lauf nie scheitern.Die Prüfung existiert, weil das Versäumnis aus jedem anderen Blickwinkel unsichtbar ist. Die SRS-Domain ist eine Sende*identität, sie tritt daher der Menge bei, die DKIM-Schlüssel sowie SPF- und DMARC-Ratschläge erhält; **pepsi-setup* schlägt für keine Domain einen
MX-Eintrag vor, da dies die eigene Routingentscheidung des Betreibers ist. Ein Betreiber, der alles veröffentlicht, was ihm gesagt wird, endet daher mit zwei der drei Einträge, die die Domain braucht, und nirgends sagt etwas davon.Die Vorwärtsbestätigung fragt nur autoritatives DNS ab und ignoriert bewusst die lokale
/etc/hosts-Datei, denn ein Mailhost führt dort häufig seinen eigenen Namen gegen127.0.1.1oder eine NAT-interne Adresse auf, was einen vollkommen vorwärtsbestätigten Namen sonst unbestätigt aussehen ließe. Diese Befunde sind Zustellbarkeitswarnungen, keine Fehler: Sie lassen den Lauf nie scheitern.Verifiziert das Zahlungs-Backend (optional). Wenn ein
[pepsi-payments]-Abschnitt ein GNU-Taler-Händler-Backend konfiguriert, prüft pepsi-setup es über HTTP:GET /configmuss eintaler-merchant-Backend identifizieren (damit die URL korrekt ist) undGET /private/orders?limit=1muss200zurückgeben (damit dasMERCHANT_ACCESS_TOKENkorrekt ist). Es stellt dann sicher, dass einpepsi-resume-Webhook existiert, der an den/resume-Endpunkt von pepsi-httpdPOSTet, wann immer eine Bestellung bezahlt wird. Fehlt der Webhook, erstellt es ihn; existiert bereits einpepsi-resume-Webhook, protokolliert es eine Warnung, wenn seine Definition von der erwarteten abweicht (er wird nie stillschweigend überschrieben). Der Webhook zielt über HTTPS auf den kürzesten konfigurierten[pepsi-httpd-cert-*]-SNI-Host und authentifiziert sich mit[pepsi-httpd] RESUME_AUTHORIZATION_TOKEN. Wenn kein Händler-Backend konfiguriert ist, wird dieser Schritt vollständig übersprungen.Erinnert an Zugangsdaten, die außerhalb des Systems ablaufen. Wenn irgendein Smarthost-MTA
AUTH = oauthverwendet, validiert pepsi-setup die entsprechenden[pepsi-helper-token-refresh-<name>]-Geheimnis-Abschnitte, die es lesen kann (es läuft alsroot), und gibt eine Erinnerung aus, dass diese Zugriffstokens aktuell gehalten werden müssen, zum Beispiel durch Aktivieren von pepsi-helper-token-refresh(1), das nicht Teil vonpepsi.targetist. Verwendet einerAUTH = gssapi, erinnert es ebenso daran, dass der Kerberos-Credential-Cache außerhalb des Systems erneuert werden muss (ein Keytab plusk5startoder Cron) und für den Worker des Dispatchers lesbar sein muss, wobei es jeden Cache-Pfad, den es sehen kann, auf Plausibilität prüft. Beide Erinnerungen gehen in das Journal (Standardfehlerausgabe), nach der Zonenausgabe, sodass sie eine umgeleitete Zonendatei nie beschädigen können.
Das gesamte Verhalten wird durch eine Konfigurationsdatei im INI-Stil gesteuert (siehe pepsi.conf(5)). Dieselbe Konfigurationsdatei wird mit den anderen Pepsi-Werkzeugen geteilt.
95.1.43.1.4. Privilegien und Eigentümerschaft¶
pepsi-setup kann entweder direkt als der Datenbankeigentümer ausgeführt werden (zum Beispiel su pepsi-owner -c 'pepsi-setup … run') oder als root. Wenn es als root ausgeführt wird, verwaltet es zwei verschiedene Identitäten selbst, sodass die resultierenden Objekte den richtigen Konten gehören:
Datenbankobjekte werden als die
pepsi-owner-Rolle erstellt. Vor jeder Datenbankarbeit (Schema-Installation, Rollen-Einrichtung, Einstellungsvalidierung, Zahlungs-Backend-Prüfung) nimmt pepsi-setup die effektive Identität despepsi-owner-Benutzers an; die PostgreSQL-Peer-Authentifizierung verbindet sich dann als die gleichnamige Rolle, sodass daspepsi-Schema, seine Tabellen, Sequenzen und Funktionenpepsi-ownergehören. Derpepsi-owner-Benutzer/die -Rolle und die Datenbank selbst müssen bereits existieren (das Debian-Paket erstellt sie; andernfalls erstellen Sie sie von Hand). Nur die effektive uid ändert sich, sodass root danach wiedererlangt wird.Der Signier-Daemon arbeitet als sein eigenes Konto.
pepsi-dkim sync-domains, von root ausgeführt, legt[pepsi-dkim] STATE_DIRundPUBLIC_DIRan, wenn sie fehlen, und wird zum Kontopepsi-dkim, bevor es einen Schlüssel anfasst, sodass jede Schlüsseldatei diesem Konto gehört (Modus0600in0700-Verzeichnissen) und keinem anderen.
Wenn pepsi-setup nicht als root ausgeführt wird, geschieht keiner der beiden Wechsel: Es arbeitet vollständig als der aufrufende Benutzer, der daher der Datenbankeigentümer sein muss, und pepsi-dkim sync-domains muss die Verzeichnisse des Daemons schreiben können (oder den laufenden Daemon erreichen). Das Löschen der 0.0.0-Schlüsseldateien unter KEY_DIR braucht dort Schreibzugriff.
Bemerkung
Die ARC-Versiegelung (durchgeführt von pepsi-stage-arc(1) auf eingehender Mail) verwendet den DKIM-Schlüssel der [pepsi] ARC_DOMAIN für ARC_ALGORITHM, daher gibt es keinen separaten ARC-Schlüssel oder DNS-Eintrag: ARC-Verifizierer holen den öffentlichen Schlüssel des Siegels aus demselben DKIM-Eintrag. Wenn ARC_DOMAIN gesetzt ist, nimmt pepsi-setup sie einfach unter die Signierdomains auf, die es an pepsi-dkim(1) übergibt, und unter die Domains, für die es Einträge ausgibt.
95.1.43.1.5. Assistent¶
Für eine erste Installation ersetzt –wizard das Bearbeiten von Hand durch ein kurzes interaktives Interview und schreibt eine vollständige, bereits validierte Konfigurationsdatei.
Das Interview wird als Folge nummerierter Schritte dargestellt, die zusammengehörige Fragen gruppieren: Server identity, Existing mail system, Local delivery, Submission authentication, Trust loopback, Forwarded mail, Transport security, Content filtering, Anti-spam paywall, Account self-service und End-to-end cryptography (dazu Expert options unter –expert). Jeder Schritt erscheint als Step X/Y-Banner mit einer einzeiligen Beschreibung, auf einem fähigen Terminal in Farbe (setzen Sie die Umgebungsvariable NO_COLOR, um sie zu deaktivieren). Welche Schritte erscheinen (und damit Y), ergibt sich aus der gewählten Richtung und daraus, ob ein lokales Dovecot erkannt wird. Das Kapitel Der Assistent des Handbuchs zeichnet die Pipeline, die jede Richtung erzeugt, und führt auf, was jede Frage entscheidet. Wenn stdin ein echtes Terminal ist, werden Eingabeaufforderungen mit den üblichen GNU-readline-Tastenbelegungen zeilenweise bearbeitet (Home/End, Ctrl-Left/Ctrl-Right, um Wörter zu überspringen, Ctrl-A/ Ctrl-E/Ctrl-K/Ctrl-U/Ctrl-W und Up/Down, um frühere Antworten zurückzurufen); ein weitergeleitetes (nicht-terminales) stdin, wie es die Testsuite und Skripte verwenden, fällt auf einfaches zeilenweises Lesen zurück. Jede Antwort wird im Moment ihrer Eingabe validiert (Hostnamen und Domains müssen voll qualifiziert sein, der Postmaster eine gültige Adresse, Sende-IPs echte IP-Literale, Ports numerisch, die Zahlungsfrist eine h/m/s-Dauer und so weiter), sodass ein Fehler an seiner eigenen Eingabeaufforderung gemeldet und an Ort und Stelle korrigiert wird statt erst bei der abschließenden Validierung der gesamten Konfiguration.
Es fragt zuerst die Richtung, die der Host bedient; sie bestimmt die SMTP-Listener (Port 25 für eingehend, 465/587 für ausgehend) und die Relay-Stages, die erscheinen: inbound (Mail für unsere Domains aus dem Internet empfangen und sie lokal zustellen und/oder weiterleiten), outbound (die Submissions unserer eigenen Benutzer direkt ins Internet senden) oder both (der Standardwert; nach state.local_origin mit einer Routing-Stage aufteilen). Es fragt dann nach dem Hostnamen, der/den akzeptierten Domain(s), der Postmaster-Adresse, der/den öffentlichen Sende-IP(s) und der Datenbank-Verbindungszeichenfolge und schlägt sinnvolle Standardwerte vor (die übergeordnete Domain des Hostnamens als Domain). Die Hostnamen-Vorgabe stammt aus dem Reverse DNS: Der Assistent ermittelt die öffentlichen Adressen dieses Hosts (dieselbe Ermittlung, die unten für die Sende-IPs beschrieben ist), schlägt ihre PTR-Einträge nach und bietet den ersten Namen an, der zur Adresse zurück vorwärtsbestätigt und nicht automatisch erzeugt aussieht. Nur wenn es keinen solchen Namen gibt, fällt es auf /etc/hostname zurück. Das ist Absicht: Ein empfangender Mailserver vergleicht den im EHLO angekündigten Namen mit dem PTR der Adresse, von der die Sitzung kommt, und weist ab, wenn sie nicht übereinstimmen (HELO host does not match rDNS), während /etc/hostname ein rein lokales Etikett ist, das kein Empfänger je sieht. Auf einem Host, der auf mehrere Namen hört, weichen die beiden routinemäßig ab, und das Reverse DNS liegt in der Zone des IP-Eigentümers, ist also normalerweise die Hälfte, die sich nicht ändern lässt. Wenn die angebotene Vorgabe (die Antwort eines früheren Laufs oder /etc/hostname) dem PTR widerspricht, sagt der Assistent das und nennt beide, bevor er fragt. Die Vorgabe der öffentlichen Sende-IP(s) wird automatisch ermittelt und zur Bestätigung angeboten: die veröffentlichten A/AAAA-Einträge des Hostnamens, vereinigt mit den eigenen global routbaren Schnittstellenadressen des Hosts, dazu die WAN-IPv4, die das lokale UPnP-Gateway über upnpc (miniupnpc) meldet, sofern installiert. Das Gateway wird nur gefragt, wenn die anderen Quellen keine öffentliche IPv4 finden (ein NAT-Host mit privater IPv4). Es werden nur öffentliche Adressen vorgeschlagen: Eine private/Loopback-/Link-Local-Adresse wird nie vorbelegt (hinter NAT ist der ermittelte Wert die öffentliche Egress-IP, nicht die LAN-Adresse). Der Betreiber bestätigt oder bearbeitet ihn, bevor irgendetwas geschrieben wird.
Auf dem eingehenden Pfad ist die nächste Frage, ob hinter diesem Host ein bestehendes Mailsystem sitzt, also Microsoft Exchange oder Microsoft 365. Ein Ja macht Pepsi zu einem transparenten Gateway: Es wird der MX und reicht alles an den Mandanten-Endpunkt weiter, sodass es keine lokalen Postfächer gibt und die untenstehenden Fragen zur lokalen Zustellung übersprungen werden. Es fragt dann nach Host und SMTP-Port dieses Endpunkts (mit dem Hinweis, dass es der mandantenspezifische Endpunkt sein muss und nicht der öffentliche MX der Domain, der dieser Host ist und eine Schleife ergäbe) und nach der IP-Adressfamilie, über die er erreicht werden soll (any/ipv4/ipv6; Exchange Online weist Mail von einer IPv6-Adresse ohne Reverse DNS zurück, ipv4 ist daher der Notausgang, wenn IPv6-Reverse-DNS nicht delegiert ist).
Andernfalls fragt es auf dem eingehenden Pfad, welche Methode(n) zur lokalen Zustellung zu verwenden sind: Maildir (pepsi-stage-relay-to-maildir) und/oder LMTP zu einem MDA (pepsi-stage-relay-to-lmtp). Ist Maildir aktiviert, fragt es außerdem, ob benutzereigene ~/.forward-Dateien beachtet werden sollen (pepsi-stage-dot-forward; der erzeugte Abschnitt leitet nur an Adressen weiter, mit ausgeschaltetem ALLOW_PIPE / ALLOW_FILE).
Weiterhin auf dem eingehenden Pfad fragt es, ob dieser Host Mail für abwesende Empfänger beantworten soll (pepsi-stage-vacation, Standardwert nein). Ja zu antworten setzt lediglich die Stage in die Pipeline, und zwar nach der Alias-Expansion und nach den Spam-Schranken, sodass eine Notiz nie im Namen eines Alias oder in Antwort auf Mail gesendet wird, die die Schranken abgewiesen hätten. Niemand wird beantwortet, bevor Urlaubszeiträume existieren, und die sind gewöhnliche Konfiguration je Adresse statt einer Assistentenantwort: Ein Benutzer kann seine eigenen per E-Mail setzen, ein Betreiber mit pepsi-settings set <address> vacation VACATION_RANGES …, und einen Feiertag, den alle teilen, mit pepsi-config set --scope domain:<domain> stage-vacation VACATION_RANGES …. Der erzeugte Abschnitt lässt VACATION_RANGES daher ungesetzt (mit der Syntax in einem Kommentar) und richtet RESPONSE_STAGE auf den gemeinsamen Signier-Schwanz, sodass jede Notiz signiert und weitergeleitet wird. Auf einem Host ohne lokale Zustellung, etwa einem reinen Weiterleiter oder einem Exchange-Vorbau, setzt es außerdem VACATION_TAG = none: Eine Markierung im Betreff schriebe sonst einen Header um, den die DKIM-Signatur des Autors und das eigene ARC-Siegel dieses Hosts abdecken; beim nächsten Hop schlügen beide fehl. Siehe pepsi-stage-vacation(1).
Es fragt dann nach dem vorgelagerten Smarthost (optional, wenn die lokale Zustellung oder ein Exchange-System die bedienten Domains übernimmt, andernfalls erforderlich).
Zwei Fragen entscheiden dann, wie Mail diesen Host mit einer eigenen Signatur verlässt. Die erste betrifft Programme, die auf diesem Host laufen, etwa cron, mail(1), logwatch, git send-email oder eine Webanwendung; sie werden andernfalls für jeden Empfänger außerhalb einer bedienten Domain mit 550 5.7.1 Relaying denied abgewiesen.
Der Assistent fragt nicht, ob der UNIX-Domain-Submission-Socket bedient werden soll, den /usr/sbin/sendmail verwendet. pepsi-ingress bedient ihn immer und leitet ihn aus [pepsi-sendmail] SOCKET ab, sodass kein Listener-Abschnitt geschrieben wird und es nichts gibt, was man falsch beantworten könnte. Der Kernel teilt pepsi-ingress mit, welches Konto den Socket geöffnet hat, sodass ein Aufrufer immer nur als er selbst senden kann: Der Login wird genau so durch USERNAME_MAP geführt, wie es ein SASL-Benutzername würde. Siehe pepsi-sendmail(1) und SOCKET = none, um es abzuschalten.
Was es sehr wohl fragt, als Ja/Nein-Frage mit Vorgabe nein, ist, ob zusätzlich dem Loopback zu vertrauen ist. Diese Frage stellt es nur auf einem Host, der beide Richtungen bedient: Die Antwort wird zu MYNETWORKS am MX-Listener auf Port 25, den nur ein eingehender Host hat, und die Frage lohnt sich nur bei einem Host, der auch Submissions einliefert.
TRUST_LOOPBACKFügt
MYNETWORKS = 127.0.0.0/8 ::1/128zum Port-25-Listener hinzu (zusammengeführt mit allen über die Experten-Optionen gesetzten Netzen, nie doppelt). Dies vertraut einer Netzwerk-Position statt einem Benutzer, sodass jeder lokale Prozess, einschließlich einer kompromittierten Webanwendung, als beliebiger Absender senden kann. Es ist auch das, was eine Nachricht, die dieser Host an sich selbst weiterleitet (eine bediente Domain, deren öffentlicher MX dieser Host ist), als frische Submission wieder eintreten und in einer Schleife kreisen lässt. Sagen Sie nur für Software ja, die darauf besteht, SMTP mit Port 25 zu sprechen, und nicht auf den Socket gerichtet werden kann.
So oder so gelten die resultierenden Nachrichten als lokal erzeugt (state.local_origin) und werden daher vom ausgehenden Pfad DKIM-signiert.
Auf dem eingehenden Pfad fragt es, ob die von diesem Host weitergeleitete Mail DKIM-signiert werden soll (Standardwert: ja): ein Alias, der nach außen expandiert, ein ~/.forward, das auf einen anderen Anbieter zeigt, oder der gesamte reine Relay-Pfad. Diese Nachrichten verlassen den Host über das eingehende Ende, das die ausgehende [stage-dkim-sign] nie berührt, sodass sie ohne dies mit unserem SRS-Umschlag, aber mit dkim=none von uns beim nächsten Hop ankommen. Ein Ja erzeugt eine zweite Signier-Stage, [stage-dkim-sign-relay], zwischen der SRS-Umschreibung und dem Ziel, mit einem auf die primäre bediente Domain festgelegten SIGNING_DOMAIN. Diese Festlegung ist beabsichtigt: Das Signieren ist fail-closed, und die Domain des Autors gehört jemand anderem; die Signierdomain aus einem fremden From: abzuleiten, würde jede weitergeleitete Nachricht mangels Schlüssel scheitern lassen. Die eigene Identität des Hosts ist durchgehend der konfigurierte Hostname, unterschieden von den akzeptierten Empfängerdomains (die SRS, MTA-STS und die TLS-Report-Adressen begrenzen). Zu dieser Identität gehören die ARC-Versiegelungsdomain ([pepsi] ARC_DOMAIN), jedes Relay-/Bounce-SERVER_NAME und das Rückfall-Listener-Zertifikat.
Die Art, wie diese Listener ihre Ports binden, hängt vom Host ab. Wenn das System von systemd verwaltet wird (erkannt am Vorhandensein von /run/systemd/system), schreibt der Assistent socket-aktivierte Listener (SERVE = systemd mit einem FD_INDEX pro Listener), sodass die privilegierten Ports von .socket-Units gebunden und vom unprivilegierten Dienst geerbt werden; andernfalls fällt er auf direkte Bindungen zurück (SERVE = tcp mit BIND_TO / PORT). Die Ingress-Listener erhalten immer FD_INDEX 0 für Port 25, 1 für 465 und 2 für 587, passend zum mitgelieferten pepsi-ingress.socket, das alle drei auflistet, gleich welche Richtung der Host bedient. Bei Socket-Aktivierung müssen Sie die passenden .socket-Units installieren (ein pepsi-ingress.socket, das ListenStream=25, 465 und 587 in dieser Reihenfolge auflistet, und ein pepsi-httpd.socket für Port 443); der Assistent gibt nach dem Schreiben eine Erinnerung aus.
Zwei Transportsicherheitsfragen folgen. Auf dem eingehenden Pfad fragt es, ob eine MTA-STS-Richtlinie bereitgestellt werden soll (Standardwert ja): Wenn aktiviert, setzt es MTA_STS_MODE = enforce und fügt einen [pepsi-httpd-cert-*]-Abschnitt für den mta-sts.<domain>-Richtlinienhost jeder akzeptierten Domain hinzu (über HTTPS von pepsi-httpd bereitgestellt), dessen Zertifikat pepsi-setup wie jedes andere über certbot einrichtet; Sie müssen das DNS jedes mta-sts.<domain>-Namens auf den Server richten, damit die Richtlinie erreichbar ist. Nach den Hosts, die die Richtlinie zulässt, wird nicht gefragt: Sie werden aus den aktuellen MX-Einträgen der bedienten Domains gelesen und als [pepsi] MTA_STS_MX geschrieben (weggelassen, wenn noch kein MX-Eintrag existiert, sodass die Richtlinie auf HOSTNAME zurückfällt; siehe MTA-STS cross-checks oben). Es fragt dann, ob SMTP-TLS-Reports gesendet werden sollen (TLSRPT, RFC 8460; Standardwert ja), was den [pepsi-tlsrpt]-Abschnitt ausgibt.
Derselbe Schritt schließt mit der einen Frage, die überhaupt nicht diese Installation betrifft: ob anonyme Telemetrie zur Funktionsnutzung mit dem Pepsi-Projekt geteilt werden soll ([pepsi] SHARE_TELEMETRY, Standardwert nein). Sie ist Opt-in, die Eingabeaufforderung erklärt daher vor dem Fragen, was gesendet würde: eine zufällige 256-Bit-SYSTEM_ID und Zählungen darüber, welche Pepsi-Funktionen dieser Host genutzt hat, nie Adressen, Nachrichtendaten, Hostnamen oder IP-Adressen. Wer sich mit der Eingabetaste durch das ganze Interview drückt, teilt somit nichts. Ein Nein deaktiviert den gesamten Pfad: Es wird keine Kennung erzeugt, das Setup startet den Daemon nie, und ein Daemon, den der Betreiber gestartet hat, wird in den Ruhezustand versetzt. Siehe pepsi-telemetry-client(1).
Die pepsi-httpd-Abschnitte werden immer geschrieben, was auch immer sonst abgelehnt wird: HTTPS auf Port 443 mit dem Web-Zertifikat, das von dem der SMTP-Listener getrennt ist (und das die MTA-STS-Richtlinie ausliefert, wenn diese an ist), und die administrative Konsole auf /run/pepsi/admin.sock für die Gruppe pepsi-admin. pepsi.target startet den Server und seinen Socket auf jedem Host, sodass eine Konfiguration ohne Listener ihn fehlschlagen und neu starten ließe.
Ein kurzes Funktionsmenü folgt, nur dort gefragt, wo es für die gewählte Richtung zutrifft: ob Mail nach erkannter Sprache blockiert werden soll (und, falls nicht, ob dennoch Bounce-Nachrichten lokalisiert werden sollen, was die Spracherkennung aktiviert). Wenn die Erkennung aktiviert ist, gibt es zuerst die vollständige Liste der unterstützten ISO-639-1-Codes aus und fragt, welche Sprachen der Detektor erkennen soll, wobei es * (der Standardwert) für jede vom Detektor unterstützte Sprache akzeptiert und jeden nicht unterstützten Code an Ort und Stelle ablehnt (statt erst bei der abschließenden Validierung). Nur eine erkannte Sprache kann dann erlaubt oder blockiert werden, sodass es, wenn die Blockierung an ist, als Nächstes nach einer einzigen kombinierten Sprachrichtlinie in einer +allow/-block-Syntax fragt. Zum Beispiel erlaubt +en +fr -ja -zh Englisch und Französisch, während es Japanisch und Chinesisch blockiert, und ein einzelnes -*-(oder +*-)Wildcard deckt jede andere erkannte Sprache ab (sodass +en +fr -* nur Englisch und Französisch erlaubt). Das Literal none kann aufgeführt werden, um das Schicksal nicht erkannter Mail zu entscheiden. Diese eine Antwort wird in die WHITELIST- und BLACKLIST-Optionen der Stage aufgeteilt. Es fragt dann, ob unbekannte Absender um Bestätigung per Antwort gebeten werden sollen (SECRETARY, pepsi-stage-secretary(1), Standardwert nein), und nach der GNU-Taler-Anti-Spam-Bezahlschranke (die auch die Whitelist der Korrespondenten einschaltet, sodass bekannte Kontakte die Zahlungsaufforderung überspringen). Wenn die Bezahlschranke aktiviert ist, fragt der Assistent zuerst nach der Händler-Backend-URL und verifiziert sie sofort über HTTP (GET /config muss ein taler-merchant-Backend identifizieren) und liest die Währungen zurück, die das Backend unterstützt. Der Preis muss in einer von ihnen angegeben werden, daher die URL bekannt sein muss, bevor nach dem Preis gefragt wird. Es fragt dann nach dem Zugangs-Credential: entweder ein fertiges Zugriffstoken (erkannt an seinem secret-token:-Präfix und gegen das Backend verifiziert) oder das Instanz-Passwort, das der Assistent über POST /private/token gegen ein Zugriffstoken mit Geltungsbereich eintauscht (wobei er den Geltungsbereich all anfordert, sodass das Token auch den pepsi-resume-Webhook verwalten kann). Schließlich fragt es nach dem Preis pro Nachricht als leerzeichengetrennte Liste von Taler-Beträgen (z. B. EUR:1 CHF:1 KUDOS:10), gegen die Währungen des Backends validiert; jeder Betrag wird zu einer Wahlmöglichkeit im erzeugten v1-Order-ORDER_CHOICES, sodass der Zahler eine Währung wählen kann. Wenn sowohl die Bezahlschranke als auch Confirm-to-Send aus sind und der Host auch einen ausgehenden Pfad hat, fragt der Assistent stattdessen, ob lediglich eine Whitelist der Korrespondenten aus ausgehender Mail gelernt werden soll.
Auf dem ausgehenden Pfad stellt ein Selbstbedienungs-Schritt danach bis zu zwei unabhängige Ja/Nein-Fragen, beide mit dem Standardwert nein. Die erste ist, ob Kontoinhaber ihre eigenen Einstellungen je Adresse per E-Mail bearbeiten dürfen (pepsi-stage-edit-settings(1)); sie wird nur auf einem Host gestellt, der beide Richtungen bedient, denn jede Stage, die ein Kontoinhaber bearbeiten darf, ist eine eingehende. Die zweite ist, ob sie ihre eigene GNU-Taler-Wallet per E-Mail bedienen dürfen (Guthaben, Aufladung und Peer-to-Peer-Zahlungen), bedient von demselben pepsi-stage-auto-pay(1), das eingehende Zahlungsforderungen bezahlt.
Der letzte Schritt, gestellt gleich welche Richtung gewählt wurde, ist die Ende-zu-Ende-Kryptografie (Standardwert nein): ob dieses Gateway Mail selbst ver- und entschlüsseln soll (OpenPGP und S/MIME), sodass Benutzer kein Client-Plugin brauchen. Ein Ja stellt pepsi-stage-encrypt(1) und pepsi-stage-decrypt(1) in die Pipeline; nichts wird verschlüsselt, bevor der Schlüssel eines Empfängers bekannt ist, und Schlüssel kommen aus der Suche (pepsi-keydisc(1)), aus pepsi-keys(1) oder aus der Mail, die Korrespondenten uns senden. Auf dem eingehenden Pfad fragt es danach, ob die Schlüssel der Korrespondenten aus dieser Mail gelernt werden sollen (Autocrypt, Standardwert ja), was pepsi-stage-autocrypt-learn(1) hinzufügt, und ob das, was das Gateway entschlüsselt hat, vor dem Ablegen erneut für den eigenen Mail-Client-Schlüssel des Benutzers verschlüsselt werden soll (REENCRYPT, Standardwert ja), was pepsi-stage-reencrypt(1) vor der lokalen Zustellung hinzufügt. Auf dem ausgehenden Pfad fragt es, ob die automatische Verschlüsselung im pEp-Stil aktiviert werden soll (PEP, Standardwert ja): Jeder Absender an einer bedienten Domain erhält bei seiner ersten Nachricht einen OpenPGP-Schlüssel, der in einem Autocrypt:-Header angekündigt wird, und Mail wird innerhalb der Verschlüsselung signiert. Es nennt die Kosten, bevor es fragt: Die vorzeitige Schlüsselerzeugung legt für jeden, der Mail sendet, einen verpackten privaten Schlüssel in die Datenbank und seinen öffentlichen Schlüssel in das Web Key Directory, ob er Verschlüsselung jemals nutzt oder nicht. Danach schreibt es die Antwort ausdrücklich, ENABLE_PEP = yes oder ENABLE_PEP = no, in [stage-encrypt] in pepsi.conf, wo sie wirkt (keine config.d-Datei setzt sie). Bei Zustimmung fragt es, ob der Schlüssel des Absenders zusätzlich als Datei angehängt werden soll (ATTACH_KEYS_AS_FILES, Standardwert nein), was nur geschrieben wird, wenn es gewählt wurde. Die Verschlüsselungs-Stage erhält immer RESPONSE_STAGE = dkim-sign, sodass die Benachrichtigungen über registrierte Schlüssel und die Antworten auf die E-Mail-Schlüsselbefehle wie jede andere ausgehende Mail signiert und weitergeleitet werden. Das Browser-Einrichtungsinterview stellt dieselben Fragen. Der Schlüsselspeicher, die Schlüsselsuche und der Schlüsselverpackungsschlüssel werden vom Rest der Einrichtung unabhängig von der Antwort eingerichtet.
SRS wird auf jedem eingehenden Pfad automatisch verdrahtet, gleich welches Weiterleitungsziel, mit einem erzeugten Geheimnis; nur seine SRS_DOMAIN wird erfragt, im selben Schritt wie die Frage zum Signieren weitergeleiteter Mail und ohne Standardwert. Sie muss eine eigene Domain sein, die nicht mit den bedienten ausgerichtet ist; eine ausgerichtete Antwort wird erst nach einer zweiten Frage, SRS_ALLOW_ALIGNED, angenommen.
95.1.43.1.5.1. Auf diesem Host gefundene Mailfilter (Milter)¶
Auf einem Host, der Mail empfängt, durchsucht der Assistent ihn nach Milter-Daemons und bietet jeden gefundenen als Milter an, den pepsi-ingress(1) während der SMTP-Sitzung befragt (ein [pepsi-ingress-milter-<label>]-Abschnitt, in [pepsi-ingress] MILTERS genannt; siehe pepsi.conf(5)). Er installiert nie einen und startet oder sperrt den Daemon nie ein: Wie unter sendmail und Postfix behält der Filter sein eigenes Paket, seine Unit und sein Benutzerkonto, und Pepsi ist nur ein Client. Der Suchlauf wird auf einem rein ausgehenden Host übersprungen, wo keine Sitzung Mail von außen empfängt, und jeder gefundene Filter wird für Mail befragt, die an den Listenern eintrifft, die keine Submission-Listener sind. Ein Filter für eingelieferte Mail wird von Hand konfiguriert oder, auf einem Host, der auch empfängt, aus einem importierten non_smtpd_milters als pepsi-stage-milter(1)-Stage auf dem Submission-Pfad übernommen.
Sieben Filter werden erkannt: milter-greylist, milter-regex, clamav-milter, spamass-milter, rspamd (über seinen rspamd_proxy-Milter-Worker), mimedefang und amavisd-milter.
Jeder wird in drei Stufen gesucht, und ein Filter wird nur angeboten, wenn alle drei gelingen:
Installiert — sein Binärprogramm liegt auf
$PATHoder in den üblichensbin-Verzeichnissen, oder es existiert eine systemd-Unit-Datei dafür.Lauscht irgendwo — ein Socket wird aus der eigenen Konfigurationsdatei des Filters gelesen (
MilterSocketinclamav-milter.conf,socketingreylist.conf, einSOCKET=oder ein-p-Flag in einem/etc/default-Fragment, Rspamdsbind_socket), dann aus demExecStartseiner Unit, dann aus den Pfaden, die seine Distribution mitliefert.Antwortet — das Setup führt eine echte Milter-Optionsaushandlung mit jedem Kandidaten-Socket vollständig durch und nimmt den ersten, der gelingt.
Der Handschlag ist es, was das Angebot vertrauenswürdig macht: Ein installiertes Paket beweist nichts über einen gestoppten Daemon, und eine falsche Vermutung in den Pfadlisten kostet nichts, denn ein Socket, der nicht antwortet, wird schlicht nie angeboten. Er klärt auch, was der Filter tun darf. ALLOW_ACTIONS muss jede Aktion gewähren, die ein Filter verlangt, sonst scheitert die Aushandlung und das ON_FAILURE des Filters greift, und der Filter nennt diese Menge während der Aushandlung. Das Setup bietet daher alles an, bloß um die Antwort zu hören, und schreibt genau das aus, was verlangt wurde, und nichts mehr. Einem Filter, der nur inspiziert, wird none gewährt; MIMEDefang werden die Umschlagaktionen genau dann gewährt, wenn die eigene Perl-Richtlinie des Standorts sie verwendet.
Die angenommenen Filter werden in [pepsi-ingress] MILTERS nach ihrer Aufgabe aufgeführt statt in der Reihenfolge, in der sie gefunden wurden: zuerst Richtlinien und Greylisting, dann Virenprüfung, dann Spam-Bewertung, dann die Allzweck-Frameworks. Aus einem MTA-Import übernommene Filter haben keinen bekannten Zweck und kommen daher nach all diesen, in der relativen Reihenfolge, in der dieser MTA sie ausgeführt hat. Pepsis eigener Greylister kommt, wenn die Antwort auf GREYLIST ja lautet, vor allen anderen. Das Label eines Abschnitts ist der Name des Filters ohne das Präfix milter- ([pepsi-ingress-milter-clamav]); milter-greylist behält das Präfix, weil greylist das Label von Pepsis eigenem Greylister ist.
Ein Filter in der Sitzung antwortet dem sendenden Server selbst. Lehnt er einen Empfänger oder eine Nachricht ab, erhält der Client sein 4xx oder 5xx, wie unter einem MTA, sodass hinterher kein Bounce erzeugt werden muss und kein Backscatter entsteht. Sobald in der Sitzung irgendein Milter befragt wird, schreibt der Assistent außerdem [stage-quarantine] (PROGRAM = pepsi-stage-quarantine, RELEASE_STAGE = init): pepsi-ingress bietet einem Filter die Quarantäne-Aktion nur an, wenn es eine solche Stage gibt, und speichert eine in Quarantäne gestellte Nachricht dort, bis sie freigegeben wird. Beim Speichern hat die Nachricht noch keine Stage durchlaufen, daher beginnt sie bei der Freigabe bei der ersten Stage der Pipeline.
Mit –expert oder wenn ein früherer Lauf sie gewählt hat, hat die Frage jedes Filters eine dritte Antwort, after-decrypt. Sie platziert den Filter als pepsi-stage-milter-Stage nach [stage-decrypt] (sodass der Filter Klartext sieht) und vor den Whitelist-, Paywall- und Autocrypt-Stages (sodass diese nach dem verzweigen können, was der Filter markiert hat). Eine solche Stage läuft, nachdem pepsi-ingress mit 250 geantwortet hat, daher wird ihre abgewiesene Mail verworfen, statt einen Bounce zu erzeugen: Ein Bounce sendete Backscatter an die Adresse, die der gefälschte Spam nannte. Ihr REJECT_STAGE zeigt daher auf eine erzeugte [stage-discard-rejected] (ein pepsi-stage-discard mit DISPOSITION = failure, BOUNCE = no); das Urteil wird weiterhin in state.milter und im Journal festgehalten. REJECT_STAGE = bounce zu setzen stellt die Benachrichtigung wieder her, und der erzeugte Abschnitt sagt das. milter-greylist hat keine solche Antwort, weil Greylisting nur funktioniert, indem es die Zustellung in der Sitzung verweigert. Eine aus non_smtpd_milters übernommene Stage behält REJECT_STAGE = bounce, da ihr Absender ein lokaler Benutzer ist.
Filter, deren Aufgabe Pepsi bereits erledigt, werden nicht angeboten: opendkim, openarc, opendmarc, SPF-Richtliniendaemons und postsrsd. Einen davon neben Pepsi zu betreiben bedeutet, dass zwei Komponenten dieselbe Nachricht signieren oder beurteilen. Sie werden nicht stillschweigend übersprungen: Wird einer gefunden, sagt der Suchlauf das und nennt die Pepsi-Funktion, die ihn ersetzt, sodass ein Suchlauf, der nichts anzubieten fand, von einem unterscheidbar ist, der nicht lief. Die Spam-Klassifikation liegt bewusst nicht in dieser Kategorie: Pepsi hat eigene Meinungen über Spam, aber es sind andere Meinungen als die eines Bayes-Bewerters, und ein Betreiber mag vernünftigerweise beide wollen.
Jede Antwort wird unter ihrem eigenen MILTER_*-Schlüssel (MILTER_CLAMAV, MILTER_RSPAMD, …) in [pepsi-wizard] gemerkt, als yes, no oder after-decrypt. Nur Filter, die dieser Lauf tatsächlich gefunden hat, werden dort geschrieben; ein erneuter Lauf sucht erneut.
Nach dem Suchlauf fragt der Assistent GREYLIST: ob Greylisting mit Pepsis eigenem Greylisting-Milter pepsi-greylist betrieben werden soll. Die Antwort ist standardmäßig nein, weil Greylisting die erste Nachricht jedes neuen Korrespondenten um mindestens fünf Minuten verzögert, genauer um so lange, wie der sendende Server bis zu seinem erneuten Versuch wartet. Ja schreibt [pepsi-ingress-milter-greylist] mit SOCKET = unix:/run/pepsi-greylist/milter.sock, ALLOW_ACTIONS = none und ON_FAILURE = accept, an erster Stelle in [pepsi-ingress] MILTERS. run aktiviert und startet dann pepsi-greylist.service (unter macOS den launchd-Job), wenn ein Milter-Abschnitt den Socket des Greylisters nennt; den Dienst deaktiviert es nie.
Die erzeugte Konfiguration wird vor dem Schreiben durch genau dieselben Prüfungen wie run validiert, sodass der Assistent nie eine Datei erzeugt, die später nicht geladen werden könnte. Wenn die Validierung doch fehlschlägt, gibt der Assistent den beanstandeten Fehler aus und führt das Interview erneut durch, wobei Ihre vorherigen Antworten als Standardwerte vorausgefüllt sind, sodass Sie die fehlerhafte(n) Option(en) korrigieren können, ohne alles erneut einzugeben. Die Interview-Antworten werden in einem [pepsi-wizard]-Abschnitt am Ende der Datei festgehalten, und ein erneuter Lauf von –wizard importiert sie als die neuen Standardwerte. Geheimnisse (das Smarthost-Passwort, das Händler-Zugriffstoken und der erzeugte SRS-Schlüssel) werden dort nicht gespeichert.
Weil die Hauptkonfiguration weltweit lesbar geschrieben wird (Modus 0644, sodass die unprivilegierten Stage-Konten sie lesen können), belässt der Assistent keine Geheimnisse darin. Jedes Geheimnis, das er sonst inline schreiben würde, wird in ein eingeschränktes secrets.d/*.secret-Fragment neben der Konfiguration verschoben und von dort mit einer @inline-secret@-Direktive referenziert (siehe pepsi.conf(5)). Diese Geheimnisse sind das SRS-SECRET, die Smarthost-/LMTP-PASSWORDs, das Händler-MERCHANT_ACCESS_TOKEN und das pepsi-httpd-RESUME_AUTHORIZATION_TOKEN. Die erzeugten (der SRS-Schlüssel, das /resume-Token) werden aus dem bestehenden Fragment zurückgelesen und wiederverwendet, sodass ein erneuter Lauf des Assistenten sie nie stillschweigend rotiert (was bereits in Bearbeitung befindliche SRS-Absender oder den installierten Zahlungs-Webhook ungültig machen würde).
Ein von Hand in die Datei eingetragenes Zugangsmerkmal verschiebt run, bevor es die Fragmente sichert: jede Option, die der Assistent externalisieren würde, und außerdem [pepsi-keydiscovery] LDAP_BIND_PASSWORD (nach secrets.d/pepsi-keydisc.secret), [pepsi-list] API_PASS (nach secrets.d/pepsi-list.secret), [pepsi-dkim] TSIG_SECRET (nach secrets.d/pepsi-dkim.secret) sowie CLIENT_ID, CLIENT_SECRET und REFRESH_TOKEN für OAuth eines [pepsi-helper-token-refresh-<name>]-Abschnitts (nach secrets.d/pepsi-helper-token-refresh.secret). Der Wert wird in das Fragment eingefügt, wobei die dort bereits vorhandenen Geheimnisse erhalten bleiben, und die Zeile in der Hauptdatei wird durch eine @inline-secret@-Direktive am Ende ihres Abschnitts ersetzt. Eine Option, deren Name sagt, dass sie ein Passwort, Geheimnis oder Token ist, deren Leser Pepsi aber nicht kennt (eine, die kein Pepsi-Programm definiert), bleibt, wo sie geschrieben wurde, und run warnt bei jedem Lauf davor und nennt Abschnitt und Option: Verschieben Sie den Wert in eine Datei, die nur ihr Leser lesen kann, und ziehen Sie ihn mit einer @inline-secret@-Direktive herein. Eine Option, die eine Datei nennt (SECRET_FILE, TOKEN_FILE), ist ein Pfad, kein Zugangsmerkmal, und bleibt unberührt.
95.1.43.1.5.2. Geheimnis-Abfragen¶
Die Geheimnisse, die Sie eingeben (die Smarthost- und LMTP-Passwörter, das Händler-Zugriffstoken), werden nie angezeigt und nie in [pepsi-wizard] geschrieben. Bei einem erneuten Lauf werden sie aus ihrem secrets.d-Fragment zurückgelesen, sodass die Eingabeaufforderung [***] zeigt und Enter das gespeicherte Geheimnis beibehält:
Smarthost password [***]:
Drei Antworten sind möglich:
- Enter
Behält das Gespeicherte bei. Wenn das Fragment existiert, dieser Prozess es aber nicht lesen darf (es gehört dem Dienstkonto und der Assistent läuft unprivilegiert), wird das Fragment völlig unangetastet gelassen und die Konfiguration zeigt weiterhin darauf; das Geheimnis bleibt erhalten, ohne dass der Assistent es je zu sehen bekommt.
- ein Wert
Ersetzt das gespeicherte Geheimnis durch das, was Sie eingegeben haben.
- Enter zweimal
Lässt das Geheimnis vorerst ungesetzt. Dies wird nur angeboten, wenn nichts gespeichert ist, und nur auf einem Terminal; der Assistent schreibt die Konfiguration dann ohne diese Option, gibt Abschnitt, Option und Datei aus, in die sie einzutragen ist, und hinterlässt im Fragment eine auskommentierte Zeile, die sie benennt. Die Dienste werden nicht funktionieren, bis Sie sie ausfüllen und
pepsi-setup runausführen.
Für einen Smarthost, der sich authentifiziert, bietet der Assistent anschließend an, die Zugangsdaten zu prüfen, indem er eine Sitzung zum Relay öffnet und sich authentifiziert, genau wie bei einer Zustellung, nur ohne die Nachricht. Ein vertipptes Passwort fällt dann auf, solange Sie noch da sind, um es zu korrigieren, und nicht erst dadurch, dass still keine Mail mehr fließt:
Check these credentials against smtp.relay.example:587 now [Y/n]:
Wenn das Relay sie ablehnt, bietet der Assistent an, das Passwort erneut entgegenzunehmen; wenn es überhaupt nicht erreichbar ist (Firewall, DNS, der Host ist ausgefallen), sagt er das und drängt Sie nicht dazu, ein möglicherweise völlig korrektes Passwort neu einzutippen. Die Prüfung entfällt vollständig, wenn stdin kein Terminal ist: Ein unbeaufsichtigter Lauf darf nicht davon abhängen, dass das Netz erreichbar ist.
Jede Direktive wird nach der letzten Option des Abschnitts geschrieben, den sie speist, weil eine Direktive ihren Abschnitt für den Parser beendet (siehe pepsi.conf(5)). Die Fragmente werden gesichert (Modus und Eigentümerschaft), sobald sie geschrieben werden, und erneut durch run; siehe den run-Befehl unten. Der Assistent lädt danach die gerade geschriebene Datei neu und validiert diese, sodass nie eine Konfiguration zurückbleibt, die er selbst nicht parsen kann. Nach dem Schreiben bietet der Assistent an, die vollständige Einrichtung (run) sofort auszuführen.
Wenn die Zieldatei bereits existiert und einen [pepsi-wizard]-Abschnitt enthält, werden ihre Antworten als Standardwerte importiert. Existiert sie ohne einen, warnt der Assistent, dass er keine vorherigen Antworten importieren kann, und fragt vor dem Überschreiben um Bestätigung; –force überschreibt ohne Nachfrage.
Bemerkung
Die Anti-Spam-Bezahlschranke setzt voraus, dass ihre Nachrichtenvorlagen (z. B. payment-request.en.body) unter [pepsi] TEMPLATE_DIR installiert sind (Standardwert ${DATADIR}/templates, also /usr/share/pepsi/templates bei einer Installation mit --prefix=/usr); make install legt sie dort ab. Weil der Assistent gegen die Live-Umgebung validiert, meldet das Aktivieren der Bezahlschranke vor der Installation der Vorlagen einen klaren Fehler, statt eine Konfiguration zu schreiben, die zur Laufzeit scheitern würde.
95.1.43.1.5.3. Ohne Terminal antworten¶
–answers FILE führt das gesamte Interview aus einem JSON-Objekt von Fragen-Bezeichner auf Wert aus, ohne etwas zu fragen. Es ist keine zweite Implementierung des Assistenten: Dasselbe interview() läuft, mit jeder Eingabeaufforderung auf die gelieferte Antwort kurzgeschlossen (oder, wo es keine gibt, auf die eigene Vorgabe des Assistenten, genau wie ein Druck auf Enter). Die Verzweigungsstruktur, die Validierung je Feld und das Rendern sind daher die interaktiven.
Die Bezeichner sind das, was pepsi-setup questions ausgibt, und es sind dieselben Schlüssel, die der erzeugte [pepsi-wizard]-Abschnitt hin- und zurückführt, sodass eine von einem früheren Lauf geschriebene Konfiguration selbst eine gültige Antwortdatei ist, sobald dieser Abschnitt in JSON verwandelt wird. Die Experten-Optionen (–expert und alles, was eine MTA-Migration gefunden hat) teilen sich diesen Namensraum und werden hier ebenfalls angenommen, validiert durch dieselbe Prüfung, die die --expert-Eingabeaufforderung anwendet. Das Browser-Interview weist sie bewusst ab, denn eine Option, nach der nichts fragt, ist keine, die ein Webformular setzen sollte. Ein unbekannter Bezeichner ist ein Fehler, der den Schlüssel nennt, statt einer stillschweigend verworfenen Zeile, denn eine Antwort, die stillschweigend ignoriert wird, sieht genau so aus wie eine, die angenommen wurde und keine Wirkung hatte.
Geheimnisse können in der Datei auftauchen (SMARTHOST_PASSWORD, LMTP_PASSWORD, MERCHANT_ACCESS_TOKEN); sie werden wie jedes andere in secrets.d-Fragmente verschoben, sodass die Datei selbst wie ein Berechtigungsnachweis behandelt und anschließend gelöscht werden sollte. Ein bereits in einem Fragment gespeichertes Geheimnis wird weitergetragen, wenn die Antwortdatei es nicht erwähnt, und das ist es, was einen skriptgesteuerten erneuten Lauf zerstörungsfrei macht.
Beispiel:
cat > answers.json <<'EOF'
{
"DIRECTION": "both",
"HOSTNAME": "mx.example.com",
"DOMAINS": "example.com",
"POSTMASTER": "postmaster@example.com",
"PUBLIC_IPS": "203.0.113.7",
"LOCAL_METHODS": "maildir",
"MTA_STS": "yes"
}
EOF
pepsi-setup --wizard --answers answers.json -c /etc/pepsi/pepsi.conf
95.1.43.1.6. Migration von einem anderen MTA¶
Niemand installiert einen Mailserver auf einer leeren Maschine. Wenn –wizard am Zielpfad keine Konfiguration findet, sucht es nach dem Mailserver, den der Host heute betreibt — Postfix, Exim, Sendmail, qmail oder Stalwart — und bietet an, dessen Einstellungen als Standardantworten des Interviews zu importieren. Wenn mehrere konfiguriert sind, präsentiert es ein nummeriertes Menü; –import MTA wählt einen ohne Nachfrage und –no-import überspringt die Suche vollständig. Die automatische Erkennung entfällt, wenn stdin kein Terminal ist, sodass ein skriptgesteuerter –wizard-Lauf weiterhin die Konfiguration erzeugt, die seine Antworten beschreiben, statt einer, die von dem geprägt ist, was auf der Maschine übrig geblieben ist.
Gleich welcher Server importiert wird, wird die SRS-Domain, in die ein daneben laufendes postsrsd weitergeleitete Absender umschreibt (SRS_DOMAIN= in /etc/default/postsrsd oder srs-domain in /etc/postsrsd.conf), zum Standardwert der Frage nach SRS_DOMAIN: Jeder Bounce von vor der Migration weitergeleiteter Mail ist an sie adressiert, und die Frage hat keinen anderen Standardwert. Ist diese Domain mit einer bedienten ausgerichtet, erklärt die Frage warum und bittet um eine andere; ein Lauf ohne Terminal zum Fragen stoppt mit dieser Erklärung.
Nichts wird stillschweigend importiert. Jeder importierte Wert wird zum [default] seiner Frage, den der Betreiber bestätigt oder korrigiert, und alles, was nicht übernommen werden konnte, wird in einem Migrationsbericht gesammelt, der neben der Konfiguration als import-report.txt geschrieben wird (und vor dem Start des Interviews auch als einzeilige Zusammenfassung ausgegeben wird). Der Bericht gruppiert seine Befunde in vier Kategorien:
FAILEDEine Datei konnte nicht gelesen oder geparst werden; aus ihr wurde nichts importiert.
UNSUPPORTEDVerstanden, aber Pepsi hat kein Gegenstück, etwa für eine
header_checks-Tabelle oder einen Alias, der an einen Befehl zustellt. Der Eintrag nennt, was Pepsi stattdessen anbietet, wo es etwas gibt. Ein vertrauenswürdiges Netz des alten Servers außerhalb von Loopback wird ebenfalls hier gemeldet, ein Eintrag je Netz, statt inMYNETWORKSübernommen zu werden: Pepsi vertraut einem Netz nur so weit, wie[pepsi-ingress] SENDER_MAPes bindet, und pepsi-ingress verweigert bei einem ungebundenen den Start, daher fügt der Betreiber das Netz und seine Bindung von Hand hinzu.APPROXIMATEDMit anderer Semantik importiert, etwa eine mbox-Zustellung, die zu Maildir wird, ein auf volle Stunden gerundetes
maximal_queue_lifetime, ein ausMYNETWORKSentferntes Loopback-Netz.UNKNOWNEine Direktive, die der Importer nicht kennt und daher nicht migriert hat. Gemeldet, damit eine nicht erkannte Einstellung sichtbar statt unsichtbar ist.
Ein Import kann den Lauf nie scheitern lassen: eine unlesbare Datei, eine korrupte Zeile oder eine Direktive aus einem Fork, von dem niemand je gehört hat, erzeugt eine Warnung, und der Rest der Konfiguration wird trotzdem importiert.
95.1.43.1.6.1. Milter¶
Die Milter, die Postfix oder Sendmail für über SMTP eintreffende Mail befragt hat, werden als Milter übernommen, die pepsi-ingress während der SMTP-Sitzung befragt, in derselben Reihenfolge, sodass ein Filter, der Mail abgelehnt hat, weiterhin dem sendenden Server antwortet. Der Assistent fragt einmal, ob sie übernommen werden sollen (MILTERS_ENABLED), handelt mit jedem aus, welche Aktionen er braucht, und schreibt seinen [pepsi-ingress-milter-<label>]-Abschnitt (zu Labels und Reihenfolge siehe den Milter-Suchlauf oben). Jede Option, die der alte MTA für seine Milter gesetzt hat, gilt für jeden von ihnen:
Postfix |
Pepsi |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
eine |
Sendmails INPUT_MAIL_FILTER und MAIL_FILTER definieren die Filter, und confINPUT_MAIL_FILTERS (das jedes INPUT_MAIL_FILTER erweitert) entscheidet, welche davon laufen und in welcher Reihenfolge; ein Filter, der definiert, aber nicht aufgeführt ist, wird gemeldet und nicht übernommen. S= ist der SOCKET und wird wörtlich übernommen; F=T wird zu ON_FAILURE = tempfail, F=R zu reject und kein Flag zu accept; T=C:…;S:…;R:…;E:… wird zu CONNECT_TIMEOUT, der größere der Werte S und R zu COMMAND_TIMEOUT und E zu CONTENT_TIMEOUT. Die confMILTER_MACROS_*-Definitionen werden zu den MACROS_*-Optionen (ENVFROM ist MACROS_MAIL, ENVRCPT MACROS_RCPT).
Ein übernommener Milter erzeugt keinen Berichtseintrag, da sich an ihm nichts geändert hat. Folgendes schon, als APPROXIMATED: milter_default_action = quarantine, das die Nachricht in der Hold-Queue von Postfix zurückhielt und zu tempfail wird; eine Makroliste, die den eingebauten Standardwert des MTA erweitert und für diese Phase auf Pepsis Standardwert belassen wird; ein relativer Socket-Pfad, den Postfix innerhalb seines Chroot auflöste; und jeder non_smtpd_milters-Filter. Pepsis lokaler Submission-Socket wird ohne Listener-Abschnitt bedient, es gibt also keinen Ort, an dem ein Sitzungs-Milter für ihn genannt werden könnte, und ein solcher Filter wird zu einer pepsi-stage-milter-Stage unmittelbar vor der DKIM-Signierung. Diese Stage läuft, nachdem die Nachricht angenommen wurde, daher wird aus einer Ablehnung ein Bounce an den lokalen Absender.
95.1.43.1.6.2. Routing-Tabellen¶
/etc/aliases, /etc/postfix/virtual, Sendmails virtusertable, qmails .qmail-*-Dateien und ihre Entsprechungen werden in eine Pepsi-Alias-Map umgewandelt (siehe pepsi-stage-aliases(1)), die neben der Konfiguration als aliases geschrieben wird, und eine Submission-Identitätstabelle (Postfix‘ smtpd_sender_login_maps und Verwandte) in username.map (siehe USERNAME_MAP in pepsi-ingress(1)). Eine bestehende Datei wird nie überschrieben: Die umgewandelte Tabelle landet stattdessen in aliases.imported, damit der Betreiber sie zusammenführt.
Pepsi-Alias-Schlüssel tragen eine Domain (local@domain, @domain oder einen *-Glob), während /etc/aliases-Schlüssel bloße Local-Parts sind, daher fragt der Assistent, wie sie zu qualifizieren sind (–alias-style beim import-Befehl):
per-domainEine Zeile je Alias und akzeptierter Domain — exakt, und der Standardwert.
wildcardEine Zeile je Alias mit einem Domain-Glob (
postmaster@*) — kompakt, passt aber auch auf später hinzugefügte Domains.primaryNur mit der ersten akzeptierten Domain qualifizieren; die übrigen werden als nicht aliasiert gemeldet.
Einträge, die Pepsi nicht ausdrücken kann, werden als inerte # UNCONVERTED-Kommentare in die umgewandelte Map geschrieben, neben einem Berichtseintrag, der erklärt warum, sodass nichts spurlos verschwindet. Solche Einträge sind eine Zustellung an ein Kommando (|/usr/bin/…), eine Zustellung an eine Datei oder ein unlesbares :include:. Die erzeugte Map wird mit derselben strengen Syntaxprüfung geprüft, die run auf eine handgeschriebene anwendet.
95.1.43.1.6.3. Abdeckung je Server¶
- Postfix
/etc/postfix/main.cf(mit$parameter-Interpolation und Fortsetzungszeilen) undmaster.cf. Die Identität stammt ausmyhostname/mydomain, die akzeptierten Domains ausmydestination,virtual_alias_domains,virtual_mailbox_domainsundrelay_domains; der Smarthost ausrelayhost, sein Transport aussmtp_tls_security_level/smtp_tls_wrappermodeund seine Zugangsdaten aussmtp_sasl_password_maps. Die lokale Zustellung wird aushome_mailbox,mailbox_transport/virtual_transport(einlmtp:unix:-Ziel wird zu Pepsis LMTP-Stage) undmail_spool_directorygelesen; die Submission-SASL aussmtpd_sasl_type = dovecotundsmtpd_sasl_path; die aktivierten Dienste inmaster.cfentscheiden über die Richtung.alias_maps/alias_databaseundvirtual_alias_mapswerden zur Alias-Map (Virtual-Einträge gewinnen, wie sie es in Postfix tun), undsmtpd_sender_login_mapswird zuusername.map, invertiert in Pepsis nach dem Login geschlüsselte Form.message_size_limit,recipient_delimiter,maximal_queue_lifetime,smtp_helo_nameund diesmtpd_tls_*-Zertifikatspfade kommen als Experten-Optionen an;mynetworkswird Netz für Netz für eineSENDER_MAP-Bindung gemeldet (sieheUNSUPPORTEDoben).Gemeldet statt migriert:
header_checks/body_checks,transport_maps, kanonisches Umschreiben,smtpd_*_restrictions,postscreen_*,content_filter, Zustellung in virtuelle Postfächer, dienstweise-o-Überschreibungen inmaster.cfund Map-Typen, die nichts als Text lesen kann (regexp:,pcre:,mysql:,ldap:, …). Rund neunzig Parameter, die Postfix‘ eigene Installation oder Feinabstimmung beschreiben, werden stillschweigend ignoriert; alles andere wird als nicht erkannt aufgeführt.- Exim
Debians Antwortdatei
/etc/exim4/update-exim4.conf.confist die reichhaltigste und zuverlässigste Quelle und hat Vorrang:dc_eximconfig_configtypegibt die Richtung und ob es einen Smarthost gibt,dc_other_hostnamesdie Domains,dc_smarthostdas Relay,dc_relay_netsdie vertrauenswürdigen Netze (für eineSENDER_MAP-Bindung gemeldet, nicht übernommen) unddc_localdeliverydas Postfachformat. Der Hauptteil vonexim4.conf.template/exim.conf/conf.d/main/*(alles vor dem erstenbegin) ergänztprimary_hostname,qualify_domain,domainlist local_domains,hostlist relay_from_hosts,message_size_limit,smtp_accept_maxund dastls_certificate-Paar. Exims Listensyntax wird korrekt behandelt: verdoppelte Trennzeichen,<;-Überschreibungen,.include,+named-Referenzen und.ifdef, ausgewertet gegen die tatsächlich definierten Makros./etc/aliaseswird zur Alias-Map,/etc/email-addresseszur Submission-Identitäts-Map und/etc/exim4/passwd.clientzu den Smarthost-Zugangsdaten.Exims Router, Transports, ACLs, Rewrite-Regeln, Authenticators und Retry-Regeln sind eine Programmiersprache, und ein halbes Parsen davon erzeugt eine plausible, aber falsche Migration. Sie werden daher überhaupt nicht interpretiert: Jeder
begin-Block wird einmal gemeldet, benannt mit dem, was ihn in Pepsi ersetzt (der Stage-Graph für Router und Transports, Listener-MYNETWORKS/SASL plus die Stages für weiße Liste und Anti-Spam für ACLs, SRS und die Alias-Map für das Umschreiben). Zwei Folgen: Weil die Retry-Leiter inbegin retryliegt, wirdMAX_LIFETIMEnie erraten, und weil der Transport die TLS- und AUTH-Richtlinie hält, wird die Transportsicherheit des Smarthosts angenommen statt gelesen. Eintls_certificate, das eine$-Expansion enthält, ist eine Berechnung und kein Pfad und wird gemeldet statt importiert.- Sendmail
/etc/mail/sendmail.mc, die m4-Quelle, die ein Administrator tatsächlich bearbeitet, wird bevorzugt;sendmail.cfwird verwendet, wenn keine.mcexistiert, und dann nur seine zuverlässig lesbaren Zeilen (Djder kanonische Name,DSder Smarthost,Cw/Fwdie lokalen Hostnamen,DZdie Version und dieO-Optionen). Die erzeugten Regelsätze werden nie interpretiert, und der Bericht sagt das. Aus der.mc:SMART_HOST(mit seinem Mailer-Präfix, Port und Klammern),confDOMAIN_NAME,confMAX_MESSAGE_SIZE,confTO_QUEUERETURN,confMAX_DAEMON_CHILDREN,confSERVER_CERT/confSERVER_KEY,ALIAS_FILE,DAEMON_OPTIONS(welche Ports bedient wurden, also die Richtung) und dieFEATUREs, auf die es ankommt (use_cw_file,virtusertable,authinfo,local_lmtp,plussed_users,local_procmail,nullclient). Die Tabellenlocal-host-names,virtusertable,aliasesundauthinfo(die Smarthost-Zugangsdaten, mit dem Mechanismus aus ihremM:-Feld) werden gelesen;postmasterwird über die Alias-Kette zu einer echten Adresse aufgelöst.Gemeldet statt migriert:
MASQUERADE_ASund Verwandte (Pepsi schreibt Absender stattdessen mit SRS um),access_db,mailertable,domaintable,genericstable,LOCAL_RULE_*/LOCAL_CONFIG/HACK, DNSBL- und Greet-Pause-Funktionen,smrsh/procmail als lokale Mailer und rechtevirtusertable-Seiten, die Pepsi nicht ausdrücken kann (error:,%1).- qmail
Das Control-Verzeichnis (
/var/qmail/control,/etc/qmailoder/usr/local/etc/qmail) wird aufgezählt und nicht namentlich abgefragt, sodass jede Control-Datei entweder verarbeitet, stillschweigend als irrelevant ignoriert oder gemeldet wird, einschließlich solcher aus einem Fork, von dem dieser Importer nie gehört hat.megibt den Hostnamen;locals,rcpthosts,morercpthostsundvirtualdomainsdie Domains; der:relay:port-Catch-All insmtproutesden Smarthost (mit Zugangsdaten, wenn die erweiterte Form der AUTH-Patches verwendet wird);defaultdelivery(oder dasqmail-start-Argument inrc) das Postfachformat;databytes,queuelifetime,helohostund einservercert.pemdie Experten-Optionen.Die Alias-Tabelle sind die
.qmail-*-Dateien in qmails Alias-Verzeichnis:.qmail-foo-barwird zufoo-bar,:dekodiert zurück zu.,.qmail-defaultwird zu einem Catch-All und.qmail-foo-defaultzu einem Glob. Ihre Inhalte werden als Ziele durchgereicht, sodass ein|command, ein Dateipfad oder ein relatives./Maildir/im Bericht erklärt statt zu einer unsinnigen Adresse verstümmelt wird. Benutzereigene~/.qmail-Dateien werden bewusst nicht durchlaufen (teuer und datenschutzsensibel;pepsi-stage-dot-forwardist die Laufzeit-Entsprechung), und es wird nie eine.cdbgeöffnet; stattdessen wird das textuelleusers/assigngelesen.badmailfrom/badrcptto,spfbehavior,percenthack,qmqpserversundtlsclientswerden mit ihren Pepsi-Gegenstücken gemeldet.- Stalwart
config.tomlunter/opt/stalwart-mail/etc,/opt/stalwart/etc,/etc/stalwartoder/etc/stalwart-mail(ein Verzeichnis von.toml-Fragmenten wird ebenfalls gelesen, und!include-Direktiven wird gefolgt).server.hostnameund dieserver.listener.*-Ports geben Identität und Richtung,queue.outbound.next-hop/queue.strategy.routeund dieremote.*-Tabelle den Smarthost (ein Hop mitprotocol = "lmtp"wird stattdessen zu lokaler LMTP-Zustellung),certificate.*die TLS-Pfade,session.data.limits.sizeund der Queue-Ablauf die Experten-Optionen. Eindirectoryvom Typmemory(oder einprincipals-Array) liefert Konten: Jede zusätzliche Adresse wird zu einem Alias auf die primäre Adresse des Kontos, und die Logins werden zuusername.map. Als%{file:…}%geschriebene Geheimnisse werden aufgelöst;%{env:…}%kann nicht aufgelöst werden und wird gemeldet.Stalwarts eigene Ausdrücke (
[{if = …}, {else = …}]) werden nie ausgewertet: Nur ein einfacher Wert wird berücksichtigt, und alles andere wird gemeldet statt erraten. Der wichtige Fall, den man kennen sollte: Neuere Stalwart-Versionen halten die Betriebskonfiguration in ihrem Datenspeicher, nicht in der TOML. Wenn die Datei wie ein Bootstrap-Rumpf aussieht, sagt der Bericht das deutlich, benennt den Speicher und weist Sie an, die Konfiguration aus Stalwarts Admin-Oberfläche zu exportieren, denn auf der Platte gibt es für Pepsi nichts zu lesen. IMAP-, JMAP-, POP3-, ManageSieve-, Sieve-, Spamfilter- und Reporting-Einstellungen werden als nicht unterstützt gemeldet, mit einem Verweis auf die Pepsi- (oder Dovecot-)Entsprechung.
95.1.43.1.6.4. Zugangsdaten¶
Zugangsdaten für das Smarthost-Relay werden aus der eigenen Passwortdatei des Quell-MTA gelesen (Postfix‘ smtp_sasl_password_maps, Exims passwd.client, Sendmails authinfo, Stalwarts TOML), sodass der Betreiber ein Passwort nicht wiederbeschaffen muss, das er vielleicht nicht mehr hat. Der Bericht benennt immer die Datei, aus der ein Geheimnis gelesen wurde. Importierte Passwörter gehen denselben Weg wie eingegebene: Der Assistent verschiebt sie aus der weltweit lesbaren Konfiguration in secrets.d/*.secret-Fragmente, die mit @inline-secret@ referenziert werden.
95.1.43.1.6.5. Was nicht migriert wird¶
Bereits im alten Server eingereihte Mail wird nicht migriert; lassen Sie die Warteschlange leerlaufen oder leeren Sie sie, bevor Sie den MX umschalten. DKIM-Schlüssel werden ebenfalls nicht migriert; pepsi-dkim(1) erzeugt frische, wenn run ihm die Domains übergibt, und run gibt die zu veröffentlichenden DNS-Einträge aus. Wenn der alte MTA noch auf Port 25 lauscht, während der Assistent läuft, sagt der Bericht das: pepsi-ingress kann den Port nicht binden, bis er gestoppt und deaktiviert ist.
95.1.43.1.7. Experten-Optionen¶
Zwischen den Fragen, die das Interview stellt, und dem vollen Optionsumfang von pepsi.conf(5) liegt eine Schicht gewöhnlicher Pepsi-Optionen, die niemand beantworten muss, um einen funktionierenden Server zu bekommen: das Nachrichtengrößenlimit, das Empfänger-Trennzeichen, die vertrauenswürdigen Netze, die Warteschlangen-Lebensdauer, der DKIM-Selektor.
–expert SPEC lässt den Assistenten in einem abschließenden Interview-Schritt nach ihnen fragen. SPEC ist eine durch Kommas oder Leerzeichen getrennte Liste von Gruppenwörtern und/oder Optionsnamen:
highDie Optionen, die ein Administrator plausiblerweise anpasst:
MAX_MESSAGE_SIZE,MYNETWORKS,RECIPIENT_DELIMITER,MAX_LIFETIME,DMARC_ENFORCE,IP_BLOCKLISTSundMAILBOX_QUOTA(bewusst in dieser Gruppe statt ininsane: Eine Installation, die lokal zustellt, will einen Standardwert für die Quota und sollte den Namen der Option nicht kennen müssen).insaneAlles in der Registry, ergänzt um
HELO_NAME,TLS_CERT,TLS_KEY,DNS_TIMEOUT,MAX_CONNECTIONS,MAX_OPEN_SOCKETS,DKIM_SELECTOR,KEY_DIR,MAILBOX_OVER_QUOTAundCRYPTO_ALLOW_DOWNGRADE.- Ein Optionsname
Fragt genau nach dieser einen, unabhängig von ihrer Gruppe:
--expert=MAX_MESSAGE_SIZE,RECIPIENT_DELIMITER. Kombinierbar mit einem Gruppenwort:--expert=high,DKIM_SELECTOR.
all wird als Synonym für insane akzeptiert, und none (oder off) löscht ein zuvor in derselben SPEC angegebenes Gruppenwort. Ein unbekannter Selektor ist ein Fehler, der die gültigen Namen auflistet, und keine stillschweigend leere Auswahl.
--expert=help gibt die Liste aus und beendet sich.
Jede Option wird in den Abschnitt geschrieben, der sie tatsächlich liest, und in [pepsi-wizard] festgehalten, sodass ein späterer erneuter Lauf sie beibehält. MYNETWORKS kommt auf den Port-25-Listener (nie auf einen Submission-Listener), MAX_MESSAGE_SIZE nach [pepsi-ingress] und HELO_NAME auf die Route des Smarthosts ([pepsi-stage-relay-to-smarthost-mta-smarthost]). Eine leer gelassene Antwort entfernt die Option und stellt Pepsis eigenen Standardwert wieder her.
IP_BLOCKLISTS nennt die mitgelieferten IP-Sperrlisten, gegen die eingehende Mail geprüft wird (spamhaus-drop-v4, spamhaus-drop-v6, blocklist-de-mail, uceprotect-1; none für keine), und schreibt ENABLED = yes oder no in jeden [pepsi-reputation-list-NAME]-Abschnitt; siehe pepsi-reputation(1). Eine per rsync abgerufene Liste (uceprotect-1) wird abgelehnt, solange das Programm rsync nicht installiert ist. Unbeantwortet gelten die mitgelieferten Standardwerte in config.d. Unabhängig vom Assistenten warnt pepsi-setup run vor jeder aktivierten rsync-Liste auf einem Host ohne rsync und entfernt ihre Einträge, sodass Ingress aufhört, eine Liste heranzuziehen, die nicht mehr aufgefrischt werden kann.
RECIPIENT_DELIMITER ist diejenige, die es auszubuchstabieren lohnt: Sie wird in den globalen [pepsi]-Abschnitt geschrieben statt auf die Stages der lokalen Zustellung, weil pepsi-ingress (das keinen eigenen Stage-Abschnitt hat) denselben Wert lesen muss, um zu entscheiden, zu wessen Postfachkontingent ein Empfänger mit Subadresse gehört, und weil der Locality-Parser der Stages auf [pepsi] zurückfällt. MAILBOX_QUOTA, MAILBOX_OVER_QUOTA und CRYPTO_ALLOW_DOWNGRADE landen ebenfalls dort.
–expert steuert nur, nach welchen Optionen gefragt wird. Ein von einem MTA-Import gefundener Wert wird angewendet, ob danach gefragt wurde oder nicht: Wenn Pepsi die Option hat, wird eine migrierte Einstellung nie mangels einer Frage verworfen.
95.1.43.1.8. Befehle¶
- import [MTA] [–root DIR] [–out DIR] [–alias-style STYLE]
Meldet, was von einem bestehenden MTA migriert würde, ohne etwas zu schreiben. Ohne MTA wird der installierte erkannt (und wenn es mehrere sind, werden sie aufgelistet und einer muss benannt werden). Die Ausgabe ist derselbe Migrationsbericht, den –wizard schreibt, dazu die Alias-Map, die erzeugt würde, und die Assistenten-Antworten, die der Import vorbelegen würde; Geheimnisse werden als Platzhalter gezeigt, nie ausgegeben.
Dieser Befehl benötigt keine Pepsi-Konfiguration: Er ist dafür gedacht, ausgeführt zu werden, bevor es eine gibt, um zu sehen, was eine Migration erzeugen würde.
- –root DIR
Liest die Konfiguration des MTA unterhalb von DIR statt von
/. Nützlich, um eine Sicherung oder das an Ort und Stelle kopierte/etceiner anderen Maschine zu inspizieren.- –out DIR
Schreibt den Bericht und die umgewandelten Map-Dateien nach DIR (eine bestehende Datei wird nach
<name>.importedumgeleitet statt überschrieben).- –alias-style STYLE
Wie bloße Alias-Namen qualifiziert werden:
per-domain(Standardwert),wildcardoderprimary; siehe Migration von einem anderen MTA.
- run [-r | –reset]
Führt die vollständige Einrichtung durch (validieren, TLS-Zertifikate einrichten, Schema installieren, pepsi-dkim die DKIM-Schlüssel erzeugen lassen, DNS-Einträge ausgeben). Dies ist auch die Standardaktion, wenn kein Unterbefehl angegeben ist. Es richtet außerdem das Herkunftsnachweis-Geheimnis ein, wann immer
[pepsi-origin]weder einSECRETnoch einSECRET_FILEhat und nicht mitENABLED = noabgeschaltet ist; der Herkunftsnachweis ist standardmäßig an, der Abschnitt muss also nicht vorhanden sein. Ein zufälliges Geheimnis wird in einsecrets.d/pepsi-origin.secret-Fragment geschrieben (im Besitz despepsi-Kontos, Modus0640) und von der Hauptkonfiguration mit einer@inline-secret@-Direktive referenziert, sodass es aus dieser für alle lesbaren Datei herausgehalten wird; ein erneuter Lauf verwendet das vorhandene Fragment wieder, statt den Schlüssel zu rotieren. Es wird mit einer Warnung übersprungen, wenn[pepsi-ingress] HOSTNAMEnicht gesetzt ist (der Name ist in denPepsi-Origin-MAC eingebunden) oder wenn der Pfad der zu aktualisierenden Konfigurationsdatei unbekannt ist.Nach demselben Grundsatz erzeugt es den Schlüsselverpackungsschlüssel von
[pepsi-crypto], wenn es keinen gibt, aber erst nachdem das Schema installiert ist, und nur wenn die Datenbank bestätigt, dass noch kein verpackter privater Schlüssel existiert. Ein fehlendes Fragment neben gespeicherten Schlüsseln ist ein verlorener Schlüssel und keine Neuinstallation, und einen frischen zu prägen würde stillschweigend jeden gespeicherten privaten Schlüssel unöffenbar machen. Sowohl bei „Schlüssel existieren“ als auch bei „ich konnte es nicht prüfen“ verweigert es daher lautstark den Schritt und benennen das Wiederherstellen des Fragments als Abhilfe.Noch vor allem anderen sichert run alle Geheimnis-Fragmente neben der Konfiguration, also die
secrets.d/*.secret-Dateien, in die –wizard die Geheimnisse externalisiert (siehe unten). Es gibt jedem den Modus0640und übergibt es an das Konto, das es lesen muss:secrets.d/pepsi.secret(Smarthost-/LMTP-Passwörter, das Händler-Zugriffstoken) anpepsi,secrets.d/pepsi-httpd.secret(dasRESUME_AUTHORIZATION_TOKEN) anpepsi-httpd,secrets.d/pepsi-ingress.secret(das SRS-SECRET) anpepsi-ingress,secrets.d/pepsi-crypto.secret(dasKEY_WRAP_SECRETvon[pepsi-crypto], aktuell und außer Dienst gestellt) anpepsi-cryptosowiesecrets.d/pepsi-secure-link.secret(das[pepsi-secure-link] PEPPER) undsecrets.d/pepsi-list.secret([pepsi-list] UNSUBSCRIBE_SECRET,VERP_SECRETundAPI_PASS) anpepsi-httpdmit der Gruppepepsi(diese beiden Fragmente haben zwei Leser, da das Portal ausliefert, was die Stage versiegelt hat, und der Web-Endpunkt das Abmelde-Token verifiziert, das die Zustell-Stage berechnet hat);secrets.d/pepsi-keydisc.secret(das LDAP-LDAP_BIND_PASSWORD) anpepsi-keydisc,secrets.d/pepsi-helper-token-refresh.secret(die OAuth-Client-Zugangsdaten) anpepsi-helper-token-refreshundsecrets.d/pepsi-dkim.secret(das[pepsi-dkim] TSIG_SECRET) anpepsi-dkim. Jede von[pepsi-srs] PREVIOUS_SECRET_FILEgenannte Datei (ein außer Dienst gestellter SRS-Schlüssel) erhält Eigentümer und Modus der aktuellen. Das SRS-Geheimnis gehörtpepsi-ingress, weil Ingress SRS-Rückadressen rückwärts dekodiert; die SRS-Stage läuft alspepsiund liest es über die geteiltepepsi-ingress-Gruppe (das Debian-Paket machtpepsizu einem Mitglied; eine Quellinstallation muss das Äquivalent einrichten). Das Schlüsselverpackungs-Geheimnis ist dasjenige, dessen Verlust nicht wiederherstellbar ist: Es öffnet jeden gespeicherten privaten Schlüssel, sichern Sie es also getrennt von der Datenbank (siehe pepsi-keys(1)).Dies ist der erste Schritt, damit ein Lauf, der später abbricht (an einem Zertifikat, das nicht ausgestellt werden kann, oder an einer nicht erreichbaren Datenbank), dennoch jedes Geheimnis für seinen Dienst lesbar zurücklässt. Anschließend wird für jedes Fragment verifiziert, dass es wirklich diesem Konto gehört, und jedes, bei dem das nicht der Fall ist, wird unter den aufgeschobenen Schritten aufgeführt: Ein unlesbares Fragment ist sonst unsichtbar, weil der Konfigurationslader über eine
@inline-secret@-Datei, die er nicht öffnen kann, nur warnt; der Dienst startet und schlägt dann später mit einem irreführenden „… is not configured“ fehl.Zuletzt bringt run
pepsi-telemetry-client.servicemit[pepsi] SHARE_TELEMETRYin Einklang:systemctl enable --now, wenn die Telemetrie an ist. Ist sie aus, bleibt die Unit so, wie der Betreiber sie hinterlassen hat, weder gestartet noch gestoppt: Ein laufender Daemon ist ruhend (kein Socket, nichts übermittelt), und solange er weiterläuft, kann die Browser-Konsole anbieten, die Telemetrie einzuschalten. In beiden Fällen sendet run danach die Benachrichtigungtelemetry_changed, sodass ein laufender Daemon der Antwort sofort folgt; das Ausschalten der Telemetrie wirkt sofort.pepsi.targetstartet diese Unit nicht: Nichts im TargetWantssie, denn eine Unit, die das Target mitzöge, liefe, gleich was die Antwort war. Die Unit ist allerdingsPartOf=des Targets und stoppt daher mit der Pipeline. Es geschieht hier, am Ende, weil dieSYSTEM_IDfrüher im selben Lauf erzeugt wird; mit eingeschalteter Telemetrie und ohne gültige Kennung wird die Unit trotzdem scharfgeschaltet (der Daemon bleibt ruhend und sagt, warum), und der Grund wird protokolliert. All das geschieht nach bestem Bemühen: Einem Host ohne systemd, ohne installierte Unit oder ohne root wird stattdessen der einzelnesystemctl-Befehl genannt. Siehe pepsi-telemetry-client(1).- -r, –reset
Verwirft alle bestehenden
pepsi-Objekte, bevor sie neu erstellt werden. GEFÄHRLICH: Alle gespeicherten Nachrichten sind unwiederbringlich verloren. Die DKIM-Schlüssel, die pepsi-dkim(1) in Dateien hält, sind nicht betroffen. Nötig ist dies nur für eine Datenbank, die eine Entwicklungsversion aus einer anderen Fassung eines unveröffentlichten Patches gebaut hat; das Schema einer älteren Version wird an Ort und Stelle aktualisiert (siehe schema).
- schema [–backup-dir DIR] [–backup-keep N] [–if-installed]
Installiert das Datenbankschema oder führt sein Upgrade durch und wendet die Rollenrechte erneut an, und sonst nichts: keine Konfigurationsprüfung über
[pepsi-postgres]hinaus, keine Zertifikate, keine Schlüssel, kein DNS. Es funktioniert daher mit jeder Konfigurationsdatei, die die Datenbank nennt, etwa/etc/pepsi/pepsi.confauf einem Mail-Host oder/etc/pepsi-telemetry/pepsi-telemetry.confauf einem Telemetrie-Collector, und es ist das, was eine Paketaktualisierung ausführt, bevor die Dienste neu starten.Der Installer hält den SHA-256 jeder angewendeten SQL-Datei und das Release, aus dem sie stammt, in
pepsi.schema_filefest; jedes Pepsi-Programm vergleicht diesen Eintrag beim Verbinden mit den in es einkompilierten Hashes und verweigert den Betrieb (Exit-Status 78) gegen ein Schema, das älter, neuer oder aus anderen Dateien gebaut ist. schema bringt ein älteres Schema auf den Stand dieses Releases. Es weist zurück, bevor es irgendetwas ändert und mit Exit-Status 78, ein Schema, das neuer als dieses Release ist (Downgrades werden nicht unterstützt: ältere gespeicherte Funktionen, über ein neueres Schema installiert, würden es beschädigen), eines, das aus einer anderen Fassung einer Patch-Datei gebaut wurde, und eines ganz ohne Eintrag (von einer Entwicklungsversion gebaut, bevor es den Eintrag gab; eine solche Datenbank muss geleert und mit run –reset neu erstellt werden). Es weist auch SQL-Dateien inSQL_DIRzurück, die nicht diejenigen sind, mit denen dieses Binary gebaut wurde, wie in einem veralteten Verzeichnis nach einem unvollständigen Upgrade. Gleichzeitig laufende Installer serialisieren sich über eine Advisory-Sperre.- –backup-dir DIR
Sichert das Schema, bevor ein Upgrade irgendetwas ändert, mit pg_dump(1) (Custom-Format; die Schemas
pepsiund_vsowie die Erweiterungen, die der Trigramm-Index des Archivs braucht) als DIR/pepsi-OLD-VERSION-UTC-TIME.dump, Modus 0600, ausgeführt als Schemaeigentümer. Wird nur angelegt, wenn es etwas zu aktualisieren gibt. Schlägt der Dump fehl, wird nichts aktualisiert. Wiederherstellen lässt sich einer mit pg_restore(1) in eine leere Datenbank.- –backup-keep N
Nachdem ein Dump angelegt wurde, alle außer den neuesten N Dumps in DIR löschen (beurteilt nach der Zeit im Namen; Dateien mit anderem Namen bleiben unberührt). Standardwert
2: der gerade angelegte Dump und der davor, genug, um das letzte oder vorletzte Upgrade rückgängig zu machen.0behält jeden Dump. Ein Dump enthält alles im Schema (eingereihte Mail, den Klartext entschlüsselter Mail, die noch in der Warteschlange liegt, verpackte private Schlüssel), daher sind Dumps, die niemand wiederherstellen wird, Kopien von Mail außerhalb der eigenen Lebensdauer der Datenbank. Ein Dump, der nicht entfernt werden kann, wird protokolliert, und das Upgrade läuft weiter.- –if-installed
Tut nichts, wenn die Datenbank noch kein Pepsi-Schema hat. Eine Neuinstallation wird mit run eingerichtet; dies ist für Maintainer-Skripte gedacht, die kein Schema installieren dürfen, um das niemand gebeten hat.
- check
Fragt Live-DNS ab und meldet für jede autoritative Domain, ob die tatsächlich veröffentlichten Einträge dem entsprechen, was run erzeugen würde. Geprüft werden die DKIM-Selektor-Einträge (ein wohlgeformter Schlüsseleintrag vom richtigen
k=-Typ, dessen öffentlicher Schlüssel inp=dem Schlüssel entspricht, den pepsi-dkim(1) hält; siehe Gibt DNS-Einträge aus unter run), der SPF-Eintrag (derv=spf1-Eintrag führt jede konfiguriertePUBLIC_IPauf), der_dmarc-TXT-Eintrag (genau einer, und streng gültig; siehe Gibt DNS-Einträge aus unter run oben) und der_mta-sts-TXT-Eintrag (vorhanden und ein parsbarerv=STSv1-Eintrag mit einemid=-Tag; der Wert vonidwird vom Betreiber gewählt und nicht verglichen, seine Syntax aber schon: RFC 8461 §3.1 erlaubt 1 bis 32 Buchstaben und Ziffern). Jeder Eintrag wird als[ok],[MISSING],[MISMATCH],[INVALID]oder[lookup failed]gemeldet; auf jede Zeile, die nicht[ok]ist, folgt eine eingerückte→-Zeile, die sagt, was zu tun ist, und, wenn die Abhilfe ein Eintrag ist, dessen Wert Setup kennt (DKIM, SPF,_mta-sts, eine fehlende DMARC-Richtlinie oder eine, derenrua=die Berichtsadresse fehlt, ein TLSA- oder CAA-Eintrag, dasv=spf1 -alleiner Subdomain), dieser Eintrag im Zonendateiformat, bereit zum Einfügen und identisch mit dem, was run ausgibt. Eine fehlerhafte DMARC-Richtlinie erhält keinen Ersatz, aus dem weiter unten genannten Grund. Der Befehl ändert nichts, und ohne –fail-on-findings bestimmen seine Befunde nie den Exit-Status: Er beendet sich mit 0, ganz gleich, wie viele Einträge fehlen oder falsch sind; lesen Sie also seine Ausgabe statt seines Exit-Status. (Nur eine Konfiguration, die nicht validiert, oder ein Resolver, der sich gar nicht erst aufbauen lässt, führt zu einem Exit-Status ungleich null; dann hat er nichts zu melden.)–fail-on-findings lässt ihn mit 1 enden, wenn ein Eintrag
[MISSING],[MISMATCH],[INVALID]oder[UNREACHABLE]oder eine Adresse[LISTED]ist, nachdem jeder solche Befund als Warnung protokolliert wurde (Zielsetup), sodass er das Journal mit Warnpriorität erreicht. Ein[lookup failed]zählt nicht, ebenso wenig die beratenden Urteile ([todo],[none],[NO ACCOUNTURI],[UNVALIDATED],[UNALIGNED],[INCOMPLETE],[UNSCOPED]).pepsi-setup-check.timer, vonpepsi.targetgenannt, führt täglichpepsi-setup -c /etc/pepsi/pepsi.conf check --fail-on-findingsaus (pepsi-setup-check.service, als root auf einem schreibgeschützten Dateisystem, da die Validierung die Geheimnisse jedes Dienstes liest); ein Befund lässt die Unit scheitern, diesystemctl --faileddann auflistet.[INVALID]ist das Urteil für einen Eintrag, der zwar veröffentlicht ist, den Empfänger aber verwerfen, sodass die Domain ungeschützt ist, während sie konfiguriert aussieht. Die Abhilfe unterscheidet sich von der der anderen: Der Eintrag wird an Ort und Stelle repariert, statt durch den Wert ersetzt zu werden, den run ausgibt. Neben den unten beschriebenen DKIM-Befunden erzeugen ihn diese Prüfungen: ein DMARC-Eintrag, der sich nicht parsen lässt (oder ein zweiter unter demselben Namen), mehr als einv=spf1-Eintrag (RFC 7208 §4.5 macht das zu einem permanenten Fehler, sodass keine SPF-Richtlinie gilt, statt dass die erste gewinnt), einv=spf1-Eintrag mit einem Term außerhalb der Grammatik von RFC 7208 (ein unbekannter Mechanismus wieipv4:, eine fehlerhafte Adresse oder CIDR-Länge, ein fehlerhaftes Makro; der Term wird genannt) und mehr als einv=STSv1-Eintrag oder einer, dessenid=außerhalb der erlaubten Syntax liegt. Einv=spf1-Eintrag, der auf+allendet, wird als[MISMATCH]gemeldet: Er ist gültig, er besteht den Test „sind meine Adressen aufgeführt?“, und er ermächtigt jeden Host im Internet, als die Domain zu senden, womit er die daneben veröffentlichten DKIM- und DMARC-Einträge aushebelt.Jeder Eintrag wird zweimal geprüft: in der Antwort des System-Resolvers und bei jedem autoritativen Nameserver der Zone, direkt gefragt (jede Adresse eines Servers zweimal, bevor er als nicht antwortend gilt, denn ein verlorenes UDP-Datagramm ist gewöhnlich). Ein Eintrag, den der Resolver korrekt liefert, ein Nameserver aber nicht (ein veralteter Secondary, ein lahmer oder unerreichbarer Server), ist ein
[MISMATCH], der die Server nennt, mit einer Abhilfe, die auf die Verteilung der Zone statt auf den Eintrag zeigt. Ein DKIM-Eintrag mit falschem oder fehlendemk=, einem falsch platziertenv=, einerh=/s=-Einschränkung, die ausschließt, was Pepsi signiert, oder einem zweiten Schlüsseleintrag unter demselben Namen ist[INVALID];t=yist ein[MISMATCH]. Wenn Ed25519-Signieren an ist, erklärt ein abschließendesnote:, warum Google diesen Selektor alsfailmeldet.Die geprüften DKIM-Einträge sind diejenigen, die pepsi-dkim(1) in seiner Statusdatei als im DNS benötigt meldet, jeder danach beschriftet, wo sein Schlüssel in seinem Lebenszyklus steht:
DKIM (RSA)/DKIM (Ed25519)für den aktuellen Schlüssel,DKIM (RSA, next key)für einen vor einer Rotation erzeugten Schlüssel,DKIM (RSA, retiring key)für einen ersetzten Schlüssel, dessen Signaturen noch unterwegs sein können. Einp=, das ein echtes Präfix des Schlüssels des Daemons ist, etwa weil ein DNS-Host nur die erste 255-Byte-Zeichenkette eines langen Eintrags behalten hat, ist ein[MISMATCH], der sagt, dass der Schlüssel abgeschnitten ist und wie er als mehrere Zeichenketten einzugeben ist. Ein Eintrag, den der Daemon als entfernbar meldet (ein außer Dienst gestellter Schlüssel), ist eine beratende[todo]-Zeile,DKIM (retired key), deren Abhilfe ist, ihn zu entfernen. Eine Domain, für die der Daemon keine Schlüssel gemeldet hat, weil seine Statusdatei noch nicht geschrieben ist oder weil er nicht für die Domain signiert, ist[MISSING]unter<DKIM_SELECTOR>._domainkey, mit der Abhilfe,pepsi-dkim.servicezu starten und run auszuführen.Ein Eintrag kann auch
[ok]sein und eine Anmerkung tragen: Einep=none-DMARC-Richtlinie ist gültig, ist der richtige Anfang und setzt nichts durch, sodass der Bericht das sagt, statt eine Domain unbegrenzt im Überwachungsmodus sitzen zu lassen.Über die TXT-Einträge hinaus führt es für jede Domain, für die eine MTA-STS-Richtlinie ausgeliefert wird, die beiden unter run beschriebenen MTA-STS-Gegenprüfungen durch: die
mx-Menge der Richtlinie gegen die aktuellenMX-Einträge und einen Abruf vonhttps://mta-sts.<domain>/.well-known/mta-sts.txt, verglichen mit der konfigurierten Richtlinie. Es endet mit einem Hinweis, der dieMTA_STS_MX-Zeile angibt, mit der beide übereinstimmen würden. Für die[pepsi-srs] SRS_DOMAINfügt es die unter Die SRS-Domain kann ihre eigenen Bounces empfangen beschriebene Zustellbarkeitsprüfung hinzu.Zwei Gruppen folgen den Domains. DANE/TLSA führt jedes TLSA-RRset auf, das unter einem Namen veröffentlicht ist, für den run einen vorschlägt, verglichen mit dem ausgelieferten Zertifikat wie unter Gibt DNS-Einträge aus beschrieben:
[MISMATCH], wenn kein nutzbarer Eintrag zum Schlüssel passt,[INVALID], wenn kein Eintrag eine Verwendung hat, die SMTP anwendet (DANE-TA oder DANE-EE). Namen, unter denen nichts veröffentlicht ist, werden nicht aufgeführt, da die Veröffentlichung von TLSA optional ist. Und innerhalb jeder Domain werden verwaiste Ziele als[MISSING]gemeldet: einMX-Eintrag, der einen Host ohneA/AAAA-Eintrag nennt (oder einen, der nicht existiert); einNS-Eintrag der Domain, der einen Nameserver ohne Adresse nennt; einCNAMEuntermta-sts.<domain>,openpgpkey.<domain>oderautoconfig.<domain>, der auf einen Namen ohne Adresse zeigt; ein SPF-include:oder -redirect=, das eine Domain nennt, die keinen SPF-Eintrag veröffentlicht (oder mehr als einen); und ein SPF-a:<host>oder -mx:<host>, das einen anderen Host ohne Adresse nennt (bzw. ohneMX-Eintrag). All das hinterlässt typischerweise eine Migration oder ein gekündigter Hosting-Vertrag. Ein verwaister SPF-Verweis macht die ganze SPF-Richtlinie der Domain zu einem permanenten Fehler (RFC 7208), und in jedem Fall erhält, wer diesen Namen später anlegen oder registrieren kann, die Mail der Domain, antwortet für ihre Zone, liefert ihre MTA-STS-Richtlinie oder OpenPGP-Schlüssel aus oder entscheidet, wer als sie senden darf. Ein SPF-Eintrag über den Abfragegrenzen von RFC 7208 (siehe Gibt DNS-Einträge aus) wird daneben als[INVALID]gemeldet. DANE/TLSA führt außerdem als[INVALID]ein veröffentlichtes TLSA-RRset auf, das die öffentlichen Resolver nicht als DNSSEC-authentisch markieren, sowie eine angenommene Domain, derenMX-RRset sie nicht so markieren (BeschriftungenTLSA (DNSSEC)undMX (DNSSEC)). Die Antworten dieser Resolver werden nach Antwortcode und Extended DNS Error nach RFC 8914 unterschieden: Ein SERVFAIL, der einen DNSSEC-Fehler nennt (DNSSEC Bogus, Signature Expired, Signature Not Yet Valid, DNSKEY Missing, RRSIGs Missing, No Zone Key Bit Set, NSEC Missing), bedeutet, dass die Vertrauenskette gebrochen ist: Validierende Resolver verweigern den Namen, sodass Absender hinter einem solchen ihn nicht auflösen können und Absender, die DANE verwenden, Mail aufschieben. Ein solcher SERVFAIL wird unter Nennung des Fehlers gemeldet, für ein TLSA-RRset in dieser Gruppe und für dasMX-RRset einer angenommenen Domain, ob DANE veröffentlicht ist oder nicht, unter der Domain selbst; ein TLSA-RRset, das mit einem bloßen SERVFAIL beantwortet wird, wird als „bogus or unreachable“ gemeldet. Eine Abfrage, die bloß fehlschlägt, wird nicht gemeldet; nur eine eindeutige Antwort. run protokolliert dieselben Befunde als Warnungen.CAA hat eine Zeile je angenommener Domain und je Zertifikatshost, der unter keiner von ihnen liegt, und gibt die CAA-Eintragsmenge an, die eine CA dafür heranziehen würde (RFC 8659: die des Namens selbst, sonst die des nächsten Vorfahren), und was sie für die Zertifikate bedeutet, die run bezieht:
[none], wenn kein Eintrag die Ausstellung beschränkt (kein CAA oder keineissue-Eigenschaft), sodass jede CA an jeden ausstellt, der eine Domain-Validierung besteht, eine gekaperte eingeschlossen;[NO ACCOUNTURI], wennletsencrypt.orgohne dieaccounturinach RFC 8657 des certbot-Kontos dieses Hosts genannt ist;[UNVALIDATED], wenn die Menge stimmt, die öffentlichen Resolver sie aber nicht als DNSSEC-authentisch markieren, sodass ein Angreifer, der die Abfragen der CA beantwortet, sie verbergen kann; sonst[ok]. Eine Menge, die kein Let’s-Encrypt-Konto ein Zertifikat über HTTP-01 beziehen lässt (nur andere CAs, dieaccounturieines anderen Kontos,validationmethodsohnehttp-01, eine unbekannte kritische Eigenschaft), ist ein[MISMATCH], da die nächste Erneuerung durch certbot scheitert; es ist der einzige CAA-Befund, der das Urteil des Berichts scheitern lässt. Eine Domain, deren Zertifikate hier nicht von certbot stammen, wird nur nach Vorhandensein und Validierung beurteilt. Den Eintrag selbst veröffentlicht run nie; es gibt ihn als auskommentierten Vorschlag aus (siehe Gibt DNS-Einträge aus).DNSKEY beurteilt die Schlüssel, die die Zonen signieren, die dieser Host bedient: die Zone jeder angenommenen Domain, von
HOSTNAMEund der SRS-Domain, gefunden über denSOA-Eintrag (der Name selbst oder der nächste Vorfahr, der einen trägt), ihrDNSKEY-RRset bei den öffentlichen Resolvern abgefragt (sonst bei denen dieses Hosts). Widerrufene Schlüssel und Schlüssel ohne Zonen-Flag werden übersprungen. Eine signierte Zone validiert, gleich was ihre Schlüssel wert sind, und wer einen Schlüssel hält oder faktorisiert, fälscht gültig signierteMX- undTLSA-Einträge für die Zone, daher ist jeder dieser Fälle ein Befund:[INVALID]für einen Schlüssel, dessen Algorithmus RFC 8624 §3.1 zum Signieren als MUST NOT einstuft (RSAMD5 1, DSA 3, DSA-NSEC3-SHA1 6, ECC-GOST 12 und seit RFC 9905 RSASHA1 5 und RSASHA1-NSEC3-SHA1 7) oder als NOT RECOMMENDED bezeichnet (RSASHA512 10), für einen RSA-Modulus unter 2048 Bit und für einen Schlüssel, der auch eine andere der geprüften Zonen signiert (ein Schlüssel hinter mehreren Zonen ist die Art, wie ein DNS-Host die Zone jedes Kunden gleich signiert);[LISTED]für einen Schlüssel auf der Liste bekanntermaßen kompromittierter Schlüssel (pepsi.compromised_key: die badkeys-Liste, diepepsi-keys blocklist updatepflegt, und die Moduli, diepepsi-keys peer screenfaktorisiert hat), nachgeschlagen über den badkeys-Hash des RSA-Modulus, der ECDSA-x-Koordinate oder des EdDSA-Schlüssels. Eine saubere Zone ist[ok]mit Aufführung ihrer Schlüssel, eine unsignierte[todo](Signieren ist optional; die DNSSEC-Befunde oben sagen, was DANE dann verliert). Jeder Befund zählt für--fail-on-findings. Wenn die Datenbank nicht gelesen werden kann, wird der Listenabgleich übersprungen, und ein Hinweis sagt das.subdomains führt als
[MISSING] SPF (subdomain)jede Subdomain einer bedienten Domain auf, die die Konfiguration nennt, die existiert (einen Adress- oderMX-Eintrag hat) und die keinen eigenen SPF-Eintrag hat. Die Konfiguration nennt denEHLO-Host einer Relay-Stage,[pepsi-ingress] HOSTNAME,mta-sts.<domain>undautoconfig.<domain>. Ein Platzhalter-SPF-Eintrag antwortet nicht für einen Namen, der existiert, daher erhält ein gefälschter Absender dort SPFnone. Der Eintrag, den ein solcher Name braucht, istv=spf1 -alloder, für einen Namen, den Pepsi inEHLOankündigt, der SPF-Eintrag der bedienten Domains mit den Sendeadressen (Empfänger prüfen denEHLO-Namen bei jedem Bounce). Die Gruppe ist beratend und lässt das Urteil des Berichts nicht scheitern.Zwei Gruppen zur Zustellbarkeit folgen. blocklists hat eine Zeile je Adresse, von der dieser Host Mail sendet oder empfängt (jede
PUBLIC_IPeinerpepsi-stage-relay-to-internet-Stage, die Adressen von[pepsi-ingress] HOSTNAME,[pepsi-reputation] CHECK_ADDRESSES), und je bedienter Domain:[LISTED]unter Nennung jeder DNS-Sperrliste, die sie aufführt,[ok], wenn jede Liste, die geantwortet hat, sauber sagt,[lookup failed], wenn keine gefragt werden konnte (siehe pepsi-reputation(1)checkdazu, wie die Antwort einer Liste geprüft wird, bevor ihr geglaubt wird). mailbox providers übersetzt die obigen Einträge in die Anforderungen, die Gmail, Yahoo und Microsoft für Absender veröffentlichen ([ok]oder[INCOMPLETE]), und führt ihre Anmeldungen auf, auf die Pepsi verweist, die es aber nie selbst durchführt: Gmail Postmaster Tools ([ok], sobald[pepsi-reputation] GOOGLE_SITE_VERIFICATIONein Token für jede bediente Domain hat, dessengoogle-site-verification=-TXT-Eintrag run ausgibt und check alsGoogle verificationverifiziert), Microsoft SNDS und JMRP für die Sendeadressen und Yahoo Sender Hub für die DKIM-Domains, jeweils[todo]mit dem, was wo einzutragen ist. Nur eine Listung lässt das Gesamturteil des Berichts scheitern. run fragt die Sperrlisten ebenfalls und protokolliert für jede Listung eine Warnung.Eine Gruppe DMARC reports hat eine Zeile je bedienter Domain, aus den authentifizierten DMARC-Aggregatberichten, die pepsi-stage-dmarc-report(1) für die letzten
[pepsi-dmarc-reports] WINDOW_DAYS(7) Tage gespeichert hat:[ok], wenn jede Quelle, die die Empfänger gemeldet haben, ausgerichtet war (DKIM oder SPF in Ausrichtung mit derFrom:-Domain), sodassp=rejectkeine davon ablehnt;[UNALIGNED]unter Nennung der Quellen, die es nicht waren (Adresse, Nachrichtenzahl, Umschlagdomain, DKIM-d=, Melder) und diep=rejectablehnt (ein Dienst, der als die Domain sendet, braucht zuerst ausgerichtetes DKIM oder SPF; weitergeleitete Mail und Fälschungen werden wie beabsichtigt abgelehnt);[todo], wenn kein Bericht eingetroffen ist, mit dem zu veröffentlichendenrua=. Ein Bericht, dessen Mail weder SPF noch DMARC bestanden hat, zählt nichts. Die Gruppe ist beratend und lässt den Bericht nie scheitern; sie entfällt, wenn keine Stage Berichte liest und keiner gespeichert ist. Mit einer Stage, die Berichte liest, ist ein gültiger Eintrag, dessenrua=die Adresse der Stage auslässt,[MISMATCH]in der_dmarc-Zeile, gefolgt von diesem Eintrag mit hinzugefügter Adresse.Innerhalb jeder Domain wird jede
mailto:-Adresse, die der gültige_dmarc-Eintrag inrua=oderruf=nennt, dort geprüft, wohin die Berichte gingen (BeschriftungDMARC report destination). Eine Zieldomain außerhalb der Organisation der Richtliniendomain muss einenv=DMARC1-TXT-Eintrag unter domain._report._dmarc.destination veröffentlichen (RFC 7489 §7.1); ohne einen senden ihr prüfende Empfänger nichts, was ein[MISMATCH]ist. Ein Ziel, intern oder extern, ohneMXund ohneA/AAAA-Eintrag (oder mit einem Null-MX) ist[INVALID]: eine veraltete oder vertippte Adresse, deren Berichte (der Mailfluss der Domain und beiruf=ganze Nachrichten) an den gehen, der den Namen registriert. Eine Abfrage, die fehlschlägt, ist kein Befund. Welcher Verarbeiter die Berichte erhält, bleibt die Wahl des Betreibers; eine Adresse bei der Domain selbst, gelesen von pepsi-stage-dmarc-report(1), hält sie auf diesem Host.Eine Gruppe HSTS hat eine Zeile je HTTPS-Name, unter dem pepsi-httpd erreicht wird, wenn ein httpd-Listener konfiguriert ist: jeder
SNI-Host eines[pepsi-httpd-cert-*], der eigene Host des Listeners undopenpgpkey.domain,autoconfig.domain (mit eingeschaltetem[pepsi-autoconfig]) undmta-sts.domain (mit veröffentlichtem MTA-STS) für jede angenommene Domain. Jeder wird alshttps://name/mit verifiziertem Zertifikat und ohne Folgen einer Umleitung abgerufen, und seinStrict-Transport-Security-Header wird beurteilt, wie ein Browser es täte (nur der erste Header zählt):[ok]mit einem gültigenmax-agevon mindestens sechs Monaten (15768000 Sekunden),[MISMATCH], wenn der Header fehlt, kürzer oder fehlerhaft ist (keinmax-age, eine Direktive doppelt). pepsi-httpd sendet ein Jahr auf seinen eigenen TLS-Listenern, daher ist ein[MISMATCH]meist ein TLS terminierender Front-Server, der den Header nicht weitergibt: Er muss ihn hinzufügen. Ein Name, der nicht antwortet, entfällt (die Erreichbarkeit ist Sache der anderen Prüfungen).includeSubDomainsundpreloadwerden nicht verlangt; sie binden jeden Host der Domain. run protokolliert dieselben Befunde als Warnungen.When any end-to-end identity is published, a published keys group has one line per address (label
Served keys): what a correspondent is given by both Web Key Directory methods (openpgpkey.domain and the domain itself) and by theOPENPGPKEYandSMIMEArecords, fetched with key discovery’s hardened clients and[pepsi-keydiscovery]settings and compared with the published, active rows of the key store.[MISMATCH]means that a channel serves a fingerprint that the store does not publish for that address, for example from another web server on the apex answering the direct method, from a DNS record left over from a rotation, or as a key that somebody else placed there; it makes the report’s overall verdict fail.[INCOMPLETE]means that a stored key is not served, or that neither WKD method serves anything;[lookup failed]means that a channel could not be asked. A DNS record that was never published is not a fault. The detail names every channel and fingerprint; see pepsi-keys(1)identity list --servedfor the same per identity. The check asks from this host, once: a server that answers other askers differently is not detected.When any S/MIME trust anchor is enabled, a trust anchors group has one line per enabled anchor (label
S/MIME anchor, named by itsca_id):[ok]when the operator limited it to named mail domains (pepsi-keys(1)ca scope) or its certificate carriesnameConstraintsof its own,[UNSCOPED]when nothing limits it, so that a signature from any address chaining to that CA readsvalid.unscopedis advisory (it is not a finding for--fail-on-findings) and is also logged as a warning.Eine letzte Gruppe, state of removed or reassigned accounts, betrifft nicht das DNS. Pepsi hält Zustand, der nach einer Adresse oder einem Login geschlüsselt ist, und entfernt nichts davon, wenn das passwd-Konto verschwindet: adressbezogene Überschreibungen (
pepsi.settings), nicht widerrufene Ende-zu-Ende-Identitäten (pepsi.crypto_identity), die eigenen<login>/...-Whitelists eines Benutzers und eine Postfach-Quota. Für jede Adresse bei einer bedienten Domain (die[pepsi-ingress] ACCEPTED_DOMAINSund dieLOCAL_DOMAINSjeder Stage, Unteradresse bei[pepsi] RECIPIENT_DELIMITERabgetrennt) und jeden Login, für den die passwd-Abfrage sagt, dass es kein solches Konto gibt, nennt eine[WARNING]-Zeile den Login und den dafür gehaltenen Zustand. Der Zustand kann gewollt sein (ein Alias oder eine Listenadresse hat kein eigenes Konto, und eine Quota kann gesetzt werden, bevor das Konto existiert), daher wird nichts geändert: Löschen Sie, was zu einem entfernten Konto gehörte (pepsi-settings remove, pepsi-keys identity revoke, pepsi-whitelist remove, pepsi-quota remove), bevor der Name erneut vergeben wird. Eine passwd-Abfrage, die fehlschlägt (ein unerreichbares Verzeichnis), wird nicht als „kein solches Konto“ gelesen: Diese Logins werden nur gezählt.Pepsi hält außerdem fest, wann jeder Login vergeben wurde (
pepsi.login_assignment, RFC 7293; siehe unten Das Login-Zuordnungsverzeichnis), und ein Login, der unter einer anderen uid zurückkommt oder nachdem er als verschwunden erkannt wurde, hat einen neuen Inhaber. Die Datenbank verwirft die Einstellungen, eigenen Whitelists, Quota und Auto-Antwort-Einträge des vorherigen Inhabers, sobald das bemerkt wird, aber nie Schlüsselmaterial: Eine weitere[WARNING]-Zeile nennt jede (nicht widerrufene) Identität im Schlüsselspeicher, jeden zwischengespeicherten Peer-Schlüssel und jeden TOTP-zweiten-Faktor für die Adressen des Logins, die älter sind als der aktuelle Inhaber, mit dem Befehl, der sie beseitigt (pepsi-keys identity revoke ID, pepsi-keys peer remove ID, pepsi-keys otp reset ADDRESS). Bis dahin entschlüsselt eine Identität weiterhin Mail für die Adresse, also nun die Mail des neuen Inhabers, und kann den neuen Inhaber die des vorherigen lesen lassen. Die Zeilen wiederholen sich bei jedem Lauf, bis der Schlüssel erledigt ist. Die Datenbank wird als Rollepepsi-ownergelesen. run protokolliert dieselben Befunde als Warnungen.- questions
Gibt das Setup-Interview auf stdout als JSON aus: die geordneten Schritte und für jede Frage ihren Bezeichner, ihre Art (
text,bool,choice,list,secret,path,port,domain,integer,address,url), Eingabeaufforderung, Hilfetext, Vorgabe, ob sie erforderlich ist, die Konfigurationsoption, auf die sie abbildet, wenn sie auf genau eine abbildet, und die Bedingung, unter der sie überhaupt gestellt wird.Beide Frontends werden durch dieses Modell beschrieben: das Terminal-Interview und das Browser-Interview, das pepsi-httpd unter
/api/v1/setup/questionsbedient. Es ist auch das Schema, gegen das eine –answers-Datei geschrieben wird. Es braucht keine Konfiguration, denn es ist das, was man liest, bevor man eine hat.- apply [–once] [–idle SECS] | apply –clear
Führt die privilegierte Einrichtungsarbeit aus, um die die Browser-Oberfläche gebeten hat. Als root ausführen. Siehe Das Vertrauensmodell des Appliers unten, bevor Sie das einsetzen.
Auf einem Debian-System liegen die systemd-Units, die dies auf Anforderung ausführen, im separaten Paket pepsi-httpd-admin; es zu entfernen lässt diesen Unterbefehl aus einer root-Shell weiterarbeiten und macht ihn zugleich von der Web-Konsole aus unerreichbar. Siehe Die Fähigkeit entfernen: das Paket pepsi-httpd-admin unten.
Es liest Absichts-Datensätze aus der Tabelle
pepsi.setup_task; jeder ist eine Anforderung der administrativen API für etwas aus einer geschlossenen Menge. Es prüft, dass jeder ausgeführt werden darf, tut es und hält das Ergebnis und seine Fortschrittszeilen wieder im Datensatz fest. Es verrichtet keine andere Arbeit und nimmt keine andere Eingabe an: Insbesondere liest es nie einen Befehl, einen auszuführenden Pfad oder eine wortgetreu zu schreibende Datei aus einer Aufgabe.- –once
Leert, was ansteht, und endet. Das, was ein Cron-Eintrag oder ein manueller Lauf will.
- –idle SECS
Ohne –once wartet es nach dem Leeren auf dem
setup_task-NOTIFY-Kanal und endet, sobald SECS ohne Arbeit vergangen sind (Standardwert 300). Das ist es, was Socket-Aktivierung funktionieren lässt: pepsi-httpd verbindet sich nach dem Einreihen mit dem Türklingel-Socket, systemd startet diese Unit, sie leert die Warteschlange und verschwindet wieder. Ein root-Prozess, der dauerhaft auf einer von einer Web-Schicht gelieferten Arbeitswarteschlange sitzt, ist genau das dauerhafte Privileg, das der Entwurf vermeidet.- –clear
Löscht jeden Datensatz von
pepsi.setup_taskohne einen davon auszuführen, meldet, wie viele entfernt wurden, und endet. Zusammen mit –once oder –idle abgelehnt: Dies ist ein administratives Zurücksetzen, kein Leerungsmodus.Eine Aufgabe ist eine dauerhafte Anfrage an einen als root laufenden Prozess, und nichts lässt sie verfallen, sodass eine Warteschlange, die dort herumliegt, eher eine Gefahr als ein Rückstau ist. Die Units des Appliers sind genau deshalb ein eigenes Paket, damit eine Installation laufen kann, ohne dass irgendetwas diese Warteschlange leert. Datensätze können die Warteschlange in diesem Zustand dennoch erreichen, etwa von einem Betreiber mit einer root-Shell. Wird das fehlende Paket Monate später installiert, läuft jeder einzelne davon beim ersten Betätigen der Türklingel, in der Reihenfolge, in der er verlangt wurde, gegen eine Installation, die sich inzwischen verändert hat. Eine Zustimmung gilt nicht so lange, daher führt die Installation von
pepsi-httpd-admindies aus ihrempostinstaus.Jeder Datensatz geht, nicht nur die
pending. Nur einpending-Datensatz kann je ausgeführt werden, und einrunning-Datensatz ist definitionsgemäß verwaist, sodass es für die Sicherheit genügte, nur diese beiden zu löschen. Aber ein „Leeren“, das eine Konsole vollerdone- undrefused-Datensätze zurückließe, wäre keines, und durch ihr Entfernen geht nichts verloren: Jede Anfrage, Ablehnung, jeder Erfolg und Fehlschlag ist ein eigener dauerhafter Prüfeintrag, den dies nicht anfasst. Diesetup_task_log-Fortschrittszeilen der Aufgabe folgen ihr per Kaskade.Eine Datenbank ohne Pepsi-Schema hat nie eine Aufgabe gehalten, daher wird sie als leere Warteschlange gemeldet statt als Fehler, und dies kann auf einem noch nicht eingerichteten Host gefahrlos ausgeführt werden.
Übergeben Sie für die Leerungsmodi ein
-cFILE: Der Applier schreibt diese Datei und ihresecrets.d-Fragmente, und der Pfad kommt von seiner eigenen Kommandozeile und nie von irgendetwas, das eine Aufgabe beeinflussen kann. Streng erforderlich ist er nicht: Ohne-cgilt die gewöhnliche Standardsuche weiter unten, und der Applier scheitert erst, wenn diese nichts findet. Aber genau darum geht es, die Datei zu benennen: Die Standardsuche zieht$XDG_CONFIG_HOMEund$HOMEheran, und das ist nicht das, was ein als root laufender Applier auflösen sollte. –clear führt nichts aus und braucht daher keine solche Datei.- bootstrap [–valid-for SECS] [–admin-url URL]
Prägt das Einmal-Credential, das das erste Administratorkonto anlegt, und gibt es samt dem
curl-Befehl aus, der es verwendet. –admin-url URL ist die Basis-URL des administrativen Listeners, an den dieser Befehl gerichtet ist (Standardwerthttp://localhost:8080); sie wirkt sich nur auf das ausgegebene Beispiel aus.Eine frische Installation hat kein Konto, sodass sich nichts an der Konsole anmelden kann, die eines anlegen würde. Dies gibt ein Bearer-Token aus, das den vollständigen Satz an Administrator-Geltungsbereichen hält, SECS lang gültig (Standardwert 3600) und genau einmal akzeptiert — genug für ein einzelnes
POST /api/v1/accounts. Es wird bei Vorlage durch eine Aktualisierung verbraucht, die nur eine konkurrierende Anfrage gewinnen kann, sodass ein von zwei Personen gelesenes Token eine davon einlässt.Die Liste der Geltungsbereiche ist keine Wahl:
POST /api/v1/accountsweigert sich, einen Geltungsbereich auszustellen, den der Aufrufer nicht selbst hält, sodass ein Token, das alleinsetup:writehält, keinen Administrator anlegen könnte; und da das Token verbraucht wird, bevor der Handler ablehnt, würde der Versuch es aufbrauchen. Das ausgegebenecurlverlangt genau die Geltungsbereiche, mit denen das Token geprägt wurde, aus derselben Liste gerendert, sodass die beiden nicht auseinanderdriften können.Einmalig, wegen des Ortes, an dem es ausgegeben wird: Ein Token auf einem Terminal steckt in einem Scrollback-Puffer, und ein Token im Journal ist für jeden lesbar, der das Journal lesen kann. Nur sein Digest wird gespeichert, sodass es nicht wiederhergestellt werden kann; führen Sie den Befehl erneut aus, wenn Sie es verlieren. Ihn erneut auszuführen widerruft außerdem jedes ausstehende Bootstrap-Token.
Ein lokaler Administrator über den
ADMIN = yes-UNIX-Socket-Listener wird überSO_PEERCREDidentifiziert und braucht überhaupt kein Credential, sodass ein abgelaufenes oder verlorenes Bootstrap-Token eine Unannehmlichkeit ist und keine Aussperrung.- validate
Prüft die Konfiguration genau so, wie run es tut, bevor es irgendetwas ändert: jeden Abschnitt, den es kennt, die
[stage-*]-Pipeline und die Startprüfungen jeder Stage sowie die Dateien, die die Konfiguration nennt, etwaSENDER_MAP. Warnungen werden protokolliert; eine Ablehnung wird protokolliert und endet mit Exit-Status 1. Nichts wird geändert, und weder das Netz noch die Datenbank wird gefragt, daher ist der Befehl nach jeder Änderung und vor einem Neustart gefahrlos. Die einzige Ausnahme sind die Milter: validate (wie auch run) handelt wie check mit jedem[pepsi-ingress-milter-*]-Filter aus und protokolliert eine Warnung für einen, der nicht antwortet oder eine Aktion verlangt, die seinALLOW_ACTIONSvorenthält. Es warnt außerdem vor einem Milter-Abschnitt, den kein Listener ausführt, und vor einem Milter, der Header oder den Nachrichtentext ändern darf, wenn keine Stage pepsi-stage-arc(1) ausführt: Pepsi wendet eine solche Änderung auf eine Nachricht, die eine ARC-Kette trägt, erst an, nachdem diese Stage die Kette verifiziert hat. Die Überlagerung in der Datenbank (pepsi.config_override) wird nicht herangezogen; run prüft auch sie.- visualize
Gibt die konfigurierte
[stage-*]-Pipeline auf stdout als Graphviz-dot-Graphen aus. Jede Stage ist ein Knoten, beschriftet mit ihrem Konfigurationsabschnittsnamen (z. B.stage-init) und demPROGRAM, das sie ausführt, mit entferntempepsi-stage--Präfix (z. B.arc). Eine durchgezogene Kante folgt demNEXT_STAGEjeder Stage und eine gestrichelte rotebounce-Kante ihremBOUNCE_STAGE. Der Befehl liest nur die Konfiguration (keine DNS-, Schema- oder Dateisystemänderungen); leiten Sie ihn zum Rendern durchdot, zum Beispiel:pepsi-setup -c /etc/pepsi/pepsi.conf visualize | dot -Tpng -o pipeline.png
95.1.43.1.9. Das Login-Zuordnungsverzeichnis¶
Pepsi hat keinen eigenen Kontolebenszyklus, da Logins aus passwd stammen, aber RFC 7293 (Require-Recipient-Valid-Since) verlangt von einem Empfänger zu wissen, wann jede Adresse ihrem aktuellen Inhaber zugewiesen wurde. pepsi.login_assignment hält das je Login fest: die uid, wann die aktuelle Zuordnung zuerst gesehen wurde und ob sie auf eine frühere folgte. Es wird aus Sichtungen aufgebaut:
die lokale Zustellung hält jeden Login fest, an den sie zustellt, mit der uid, die passwd ihm gab: pepsi-stage-relay-to-maildir vor dem Schreiben, pepsi-stage-relay-to-lmtp für jeden Empfänger, den der MDA angenommen hat und der zu einem passwd-Login auflöst (ein virtueller Benutzer des MDA wird nicht festgehalten);
run hält jeden existierenden Login fest, der in gehaltenem Zustand genannt wird (Einstellungen, Identitäten, Whitelists, Quotas), und schlägt dann jeden festgehaltenen Login erneut nach;
pepsi-queue gc (stündlich,
pepsi-origin-gc.timer) wiederholt diesen letzten Schritt.
Ein zum ersten Mal gesehener Login ist eine erste Zuordnung, wann immer das ist: Was geschah, bevor Pepsi zusah, ist unbekannt, und RFC 7293 zählt eine Adresse mit einem Inhaber seit ihrer Erstellung als ununterbrochen besessen. Ein unter einer anderen uid wieder gesehener Login oder einer, der wieder gesehen wird, nachdem eine Prüfung ihn als verschwunden erkannt hat (selbst unter seiner alten uid), hat einen neuen Inhaber. In dem Moment, in dem das bemerkt wird, beginnt der Eintrag neu, und die Datenbank verwirft den adressbezogenen Zustand, den der vorherige Inhaber hinterlassen hat:
pepsi.settings-Datensätze der Adressen des Logins (jede bediente Domain, Unteradresse beiRECIPIENT_DELIMITERabgetrennt);die eigenen
<login>/...-Whitelists des Logins und ihre offenen Confirm-to-Send-Challenges;sein
pepsi.mailbox_quota-Datensatz (eine je Konto gesetzte Grenze gehörte dem vorherigen Inhaber; der Standardwert der Installation gilt wieder);die Antwortprotokolle für Abwesenheitsnotizen und Zahlungsaufforderungen seiner Adressen.
Schlüsselmaterial (Identitäten im Schlüsselspeicher, zwischengespeicherte Peer-Schlüssel, ein TOTP-zweiter-Faktor) wird nicht verworfen: Das Löschen eines privaten Schlüssels lässt sich nicht rückgängig machen, und bei Gateway-Verwahrung kann es das Einzige sein, was die archivierte Mail des vorherigen Inhabers öffnet. Es wird von run und check gemeldet, bis der Betreiber es beseitigt (siehe oben state of removed or reassigned accounts). Jede Neuzuordnung wird als Warnung account.reassigned in das Ereignisprotokoll geschrieben, unter Nennung beider uids und wie viele Datensätze entfielen. Der Mailinglisten-Zustand des Logins wird ausgesetzt statt verworfen: Seine Listenadressen verlieren ihre Verifikation und ihre Verknüpfung mit dem Listenkonto des vorherigen Inhabers, seine schlichten Mitgliedschaften erhalten nichts mehr (delivery_status unknown), und Inhaber- oder Moderatorenrollen bleiben, werden aber im Ereignis gezählt (list_roles_kept, mit den Listen in list_roles_kept_lists), damit der Betreiber sie prüft. Adresszustand, der nicht an einen Login gebunden ist (Aliase), liegt außerhalb des Verzeichnisses.
Einem Verzeichnis, das plötzlich niemanden kennt, wird nicht geglaubt: Wenn bei einer Prüfung mehr als die Hälfte der festgehaltenen Logins verschwunden aussieht, wird keiner markiert, sodass eine defekte nsswitch.conf oder eine leere LDAP-Antwort nicht die Einstellungen jedes Benutzers bei dessen Rückkehr auslöschen kann. Eine fehlschlagende Abfrage wird nie als „verschwunden“ gelesen.
95.1.43.1.10. Das Vertrauensmodell des Appliers¶
pepsi-setup apply ist die eine Komponente in Pepsi, die im Auftrag einer HTTP-Anfrage als root läuft.
95.1.43.1.10.1. Warum die Konsole nicht handelt¶
pepsi-httpd gibt Privilegien ab, bevor es eine einzige Verbindung annimmt, und darf sie nie zurückerlangen können: Es parst berufsmäßig vom Angreifer gelieferte Eingaben. Es kann daher /etc/pepsi/pepsi.conf nicht schreiben, ein secrets.d-Fragment nicht dem Konto übergeben, das es liest, certbot nicht ausführen, keine Datenbankrolle anlegen und kein Schlüsselmaterial erzeugen, und all das muss das Setup tun.
Also versucht es das nicht. Es schreibt einen Datensatz, der sagt, was wahr sein soll, und der Applier entscheidet wie. Root bleibt vollständig vom Netz fern: Es wird über eine Datenbanktabelle erreicht, nicht über einen Socket, der ein Protokoll spricht.
95.1.43.1.10.2. Die geschlossene Aufgabenliste¶
Es gibt siebzehn Aufgabenarten, und es wird keine allgemeine geben. Eine Art für beliebige Befehle wäre eine root-Shell über HTTP im Gewand eines Aufgabennamens.
write-configRendert die Konfiguration aus einer Antwortmenge (denselben Antworten, die das Interview sammelt), prüft sie genau so, wie
pepsi-setup runes täte, und schreibt dann die Datei und ihre Secret-Fragmente und übergibt jedes Fragment seinem besitzenden Konto. Die Antworten sind die Absicht; die Datei ist das eigene Rendering des Appliers davon. Nichts, was eine Aufgabe liefert, wird wortgetreu geschrieben.write-secretSpeichert ein Credential im
secrets.d-Fragment, das sein Leser besitzt, und bewahrt dabei jedes andere Geheimnis in diesem Fragment. Es lehnt jedes[section] OPTION-Paar ab, das nicht bereits ein von der Secrets-Schicht verwaltetes Credential ist; sonst schriebe es eine beliebige Option in eine root-eigene Datei, die jeder Dienst liest.obtain-certificateBeschafft die TLS-Zertifikate, um die die Konfiguration bittet. Benannte Hosts engen ein, was gemeldet wird, nicht, was versucht wird: Dürfte eine Aufgabe einen Host einführen, kämen certbots Argumente aus der Aufgabe.
install-schemaInstalliert oder migriert das Schema. ``reset`` wird abgelehnt: Das Schema fallen zu lassen zerstört jede eingereihte Nachricht und macht jeden verpackten privaten Schlüssel unöffenbar, was nichts ist, worum ein Webformular bitten darf. Verwenden Sie
pepsi-setup run --resetauf einer Konsole.provision-rolesLegt die Datenbank-Login-Rollen an und wendet ihre Berechtigungen erneut an.
generate-keyspepsi-dkim(1) die ihm fehlenden DKIM-Schlüssel je Domain erzeugen lassen (
pepsi-dkim sync-domains, immer mit der ganzen Domainmenge der Installation, da dieser Befehl die Menge ersetzt). Eine Aufgabe darf die Domains, über die sie berichtet, einengen, nie erweitern: Eine Domain, die diese Installation nicht bedient, erhält keinen Signierschlüssel. Sie schlägt fehl, wenn der Daemon für eine angeforderte Domain keinen Schlüssel meldet.dkim-rotateJetzt eine DKIM-Schlüsselrotation für eine Signierdomain beginnen (Parameter
domainund ein optionales boolescheshard): Der Applier führtpepsi-dkim -c CONFIG rotate [--hard] DOMAINals root aus, da der Daemon administrative Anfragen nur von root und seinem eigenen Konto annimmt. Die Domain muss eine sein, für die diese Installation signiert. Ohneharderzeugt der Daemon die nächsten Schlüssel und wechselt zu ihnen, sobald jeder autoritative Server ihre Einträge ausliefert; mit ihm wechselt er sofort, sodass Mail mit Schlüsseln signiert wird, die Empfänger womöglich nicht finden, bis ihre Einträge veröffentlicht sind. Das Ergebnis hältdomain,hardund dieoutputdes Befehls fest.run-preflightFührt nur lesende Umgebungsproben aus und hält den Bericht fest. Welche Proben, ist eine Positivliste (
ports,dnssec,dns-records), sodass „führe einen Preflight aus“ nicht zu „führe dies aus“ werden kann.generate-identityErzeugt einen vom Server verwalteten OpenPGP-Schlüssel (einen MTA-Schlüssel) für eine Adresse (Parameter
addressund ein optionales booleschesvks, dessen Standardwert[pepsi-keys] VKS_PUBLISHist und das ein Hochladen auf einen Schlüsselserver anfordert). Die Adresse muss an einer Domain aus[pepsi-ingress] ACCEPTED_DOMAINSliegen, und einKEY_WRAP_SECRETmuss konfiguriert sein. Wird auf Anforderung immer ausgeführt, auch neben dem eigenen Schlüssel des Benutzers oder einem widerrufenen Schlüssel. Der Applier erledigt die Arbeit als die Rollepepsi-crypto(root wird für die Verbindung zu diesem Konto, wie es pepsi-keys(1) tut), weil nur diese Rolle die private Spalte schreiben darf.register-client-keyRegistriert den eigenen öffentlichen Schlüssel des Benutzers (einen MUA-Schlüssel,
custody = client) für eine Adresse (Parameteraddressundkey, ein öffentlicher OpenPGP-Schlüssel als Text, höchstens 64 KiB). Die Adresse muss bedient werden, der Schlüssel muss ein einzelnes OpenPGP-Zertifikat sein, mit einer User-ID, die die Adresse nennt, und ein Fingerabdruck, den die Adresse bereits hat, ausgemustert oder nicht, wird nicht erneut registriert. Dies läuft über den Applier, obwohl kein privates Material beteiligt ist: Ein als eigener Schlüssel des Benutzers registrierter Schlüssel wird zum öffentlichen Gesicht der Adresse und verifiziert Signaturen als die des Benutzers, daher darf eine kompromittierte Web-Schicht keinen solchen unterschieben können.revoke-identityWiderruft eine lokale Identität (Parameter
address,identity_idund ein optionaler einzeiligerreasonvon höchstens 1024 Bytes, der als Widerrufsgrund festgehalten wird). Die Identität muss zuaddressgehören. Die Regel für die Außerdienststellung ist die von pepsi-keys identity revoke: Die private Hälfte eines reinen Signaturschlüssels wird vernichtet, die eines Verschlüsselungsschlüssels wird behalten, sodass bereits an ihn verschlüsselte Mail lesbar bleibt. Ein OpenPGP-Schlüssel, dessen private Hälfte gehalten wird, erhält zuerst sein Widerrufszertifikat, wie bei pepsi-keys identity revoke: Das Web Key Directory liefert es aus, und für einen Schlüssel, der zu einem Keyserver hochgeladen worden war, wird es für pepsi-keys identity publish –retry vorgemerkt. Das Ergebnis hältrevocation_certificate,wkd_serves_revocation,key_server_upload_dueund inpublisheddieselben Sätze fest, die die E-Mail-Antwort aufretireträgt. Wird als die Rollepepsi-cryptoausgeführt, weil das Vernichten einer privaten Hälfte die private Spalte schreibt (und das Signieren des Zertifikats sie liest). Das Widerrufen einer bereits widerrufenen Identität ändert nichts und gelingt; das Ergebnis sagt, was geschehen ist.set-identity-flagsÄndert die Flags einer lokalen Identität für den Inhaber ihrer Adresse (Parameter
address,identity_idund mindestens eines vonis_primary(nurtrue),publishedundvks_wanted, boolesch). Die Identität muss zuaddressgehören; ein Keyserver-Upload braucht eine aktive OpenPGP-Identität und veröffentlicht sie ebenfalls. Das sind die Änderungen, die ein Betreiber mitkeys:writedirekt über die administrative API vornimmt; ein Inhaber unterown:<address>beantragt sie als diese Aufgabe, damit der zweite Faktor des Inhabers, den nur der Applier prüfen kann, sie absichert. Das Ergebnis führt die Flags inchangedauf; ein Flag auf den Wert zu setzen, den es hat, gelingt. Auditiert alskey.identity.update.reset-otpEntfernt den zweiten Faktor einer Adresse (Parameter
address); so wird auch ein durch zehn falsche Codes gesperrter zweiter Faktor entsperrt, und sein Inhaber registriert sich danach erneut. Ausgeführt als Rollepepsi-crypto, der einzigen mit einer Berechtigung aufpepsi.otp_key. Das Entfernen eines nicht vorhandenen gelingt und sagt das.confirm-enrolmentPrüft den Code des zweiten Faktors eines Inhabers für die Anmeldung per E-Mail an der Konsole (Parameter
addressund ein optionalesotp) und ändert sonst nichts. pepsi-httpd(1) erstellt eine Browsersitzung mitown:<address>für jeden, der einem an die Adresse gesandten Link folgt, kann aberpepsi.otp_keynicht lesen; es reiht diese Aufgabe unter dem eigenen Geltungsbereich der Adresse ein und öffnet die Sitzung erst, wenn die Aufgabe mitdoneendet. Eine Adresse ohne zweiten Faktor besteht.confirm-loginPrüft den Code des zweiten Faktors eines Administrators, der sich mit einem Passwort an der Konsole anmeldet (Parameter
loginundotp), und ändert sonst nichts. Ein Konsolenkonto mit einem TOTP-zweiten-Faktor (pepsi-keys otp enroll --console LOGIN) hält diesen inpepsi.otp_keyunter dem Subjektconsole <login>, das pepsi-httpd(1) nicht lesen kann; sobald das Passwort verifiziert ist, reiht es diese Aufgabe ein und öffnet die Sitzung erst, wenn die Aufgabe mitdoneendet. Ein fehlender, falscher, wiedereingespielter oder gesperrter Code lässt sie scheitern, und ein falscher zählt zur Sperre. Es ist die eine Art, die ohne jeden Geltungsbereich zugelassen wird, da niemand vor der Anmeldung einen hält; sie muss trotzdem wie jeder andere Datensatz vonpepsi-configgeschrieben worden sein, und der Aufgaben-Endpunkt der administrativen API lehnt sie ab.identity-csrBaut eine PKCS#10-Zertifikatsanforderung über den vorhandenen Schlüssel einer S/MIME-Identität (Parameter
address,identity_idund ein optionaler einzeiligerdisplay_namevon höchstens 128 Bytes, dasCNdes Subjekts). Die Identität muss zuaddressgehören, S/MIME sein und eine private Hälfte halten. Der Subject Alternative Name ist immer die eigene Adresse der Identität, nie ein Parameter, sodass eine Aufgabe eine CA nicht bitten kann, über diesen Schlüssel ein anderes Postfach zu zertifizieren. Wird als die Rollepepsi-cryptoausgeführt, weil die Anforderung mit dem privaten Schlüssel signiert wird, genau wie pepsi-keys identity csr es tut; die PEM-Anforderung ist das Ergebnis der Aufgabe (csr_pem), wo der Anfragende sie liest. Auditiert alskey.identity.csr.identity-certificateInstalliert das Zertifikat, das eine CA für eine S/MIME-Identität ausgestellt hat (Parameter
address,identity_idundcertificate, entweder PEM oder DER als Base64, höchstens 64 KiB; ein PEM-Bündel trägt sein erstes Zertifikat bei). Abgelehnt, sofern das Zertifikat nicht über den eigenen Schlüssel der Identität ausgestellt ist (gegen den geöffneten privaten Schlüssel geprüft),addressin seinemrfc822Namenennt, ein Endentitätszertifikat ist, dasemailProtectionmit der Schlüsselverwendung erlaubt, die der Zweck der Identität braucht, und nicht abgelaufen ist. Der Applier ersetzt dann die öffentliche Hälfte, den Fingerabdruck und das Ablaufdatum und verpackt den privaten Schlüssel unter dem neuen Fingerabdruck neu (die authentifizierten Daten der Verpackung binden den Blob daran), in einem abgesichertenUPDATE; eine Identität, die mit ihrem alten Zertifikat abgelaufen war, wird wieder aktiv. Das bereits vorhandene Zertifikat zu installieren, ändert nichts und sagt das. Wird als die Rollepepsi-cryptoausgeführt, weil die Neuverpackung die private Spalte schreibt. Auditiert alskey.identity.certificate.
Diese acht wirken auf eine Adresse statt auf die Installation und werden anders autorisiert (siehe Die zwei Schranken).
Der zweite Faktor des Inhabers. generate-identity, register-client-key, revoke-identity, set-identity-flags, confirm-enrolment, identity-csr und identity-certificate akzeptieren einen optionalen Parameter otp (sechs Ziffern). Wird eine Aufgabe allein aufgrund von own:<address> zugelassen, fragt also der Inhaber der Adresse und nicht ein Betreiber mit keys:write, prüft der Applier den Code gegen den zweiten Faktor der Adresse (siehe pepsi-keys(1), otp), bevor er irgendetwas tut: Eine Adresse ohne zweiten Faktor braucht keinen Code, und ein fehlender, falscher, wiedereingespielter oder gesperrter Code lässt die Aufgabe mit dem Grund fehlschlagen. Der Versuch wird festgehalten (ein falscher Code zählt zur Sperre), und ein Code ist verbraucht, auch wenn die Aufgabe danach fehlschlägt.
95.1.43.1.10.3. Was bewusst fehlt¶
Es gibt keine Neustart-, Reload- oder Abschaltaufgabe, und es wird keine geben; dieselbe Entscheidung hält die Dienststeuerung aus der Konsole heraus. Der Preis ist real: Eine Konfigurationsänderung, die einen Neustart einer Komponente braucht, endet damit, dass der Betreiber sie neu startet. Wo es möglich ist, greifen Komponenten Änderungen stattdessen selbst auf (die config_changed-Benachrichtigung tut das für die Konfigurations-Überlagerung in der Datenbank).
95.1.43.1.10.4. Die zwei Schranken¶
Eine Aufgabe wird nur ausgeführt, wenn beides gilt:
ihre festgehaltenen
scopessetup:writeenthalten, die Autorisierung, die die administrative API für den anfragenden Principal festgestellt hat. Für die acht Adressarten (generate-identity,register-client-key,revoke-identity,set-identity-flags,reset-otp,confirm-enrolment,identity-csrundidentity-certificate) ist der erforderliche Geltungsbereich stattdessenkeys:writeoderown:<address>für genau die in den Parametern der Aufgabe genannte Adresse: Ein Benutzer, der seinen eigenen Schlüssel verwaltet, konfiguriert nicht den Server, undsetup:writeallein genügt nicht.reset-otpist allein dem Betreiber vorbehalten und akzeptiertown:<address>nicht. Die Adresse wird den geparsten Parametern entnommen, nie der Liste der Geltungsbereiche, sodass ein auf eine Adresse beschränkter Principal keine andere nennen kann; undihr
written_byist die Datenbankrollepepsi-config, was beweist, dass der Datensatz die Tabelle über den einen Weg erreicht hat, den wir kontrollieren. Diese Spalte wird von einemBEFORE INSERT-Trigger auscurrent_usererzwungen, sodass sie eine Tatsache über die Verbindung statt einer Behauptung in der Nutzlast ist, und es gibt keine Schreibweise desINSERT, die einen gefälschten Wert daran vorbeibrächte.
pepsi-setup run setzt die zweite Hälfte bei jedem Lauf gegen PostgreSQL durch: Nur pepsi-config darf in setup_task INSERT``en; ``pepsi-httpd darf nur SELECT (es reiht über die separate [pepsi-admin] CONFIG_DB-Verbindung ein); und kein Konto, das Mail verarbeitet, darf die Tabelle überhaupt berühren. Ein Stage-Worker parst berufsmäßig feindliche Mail und darf einem root-Prozess keine Arbeit vorlegen können. Das wird geprüft, nicht behauptet: Eine Abweichung ist ein harter Fehler, der die Rolle und das Privileg nennt.
95.1.43.1.10.5. Was es nicht versprechen kann¶
Der Applier hat die HTTP-Anfrage nie gesehen, kann den Prinzipal also nicht erneut authentifizieren. scopes ist eine von der administrativen Oberfläche festgehaltene Behauptung; was der Applier prüft, ist, dass die Behauptung von der einzigen Rolle festgehalten wurde, die sie festhalten darf. Eine Kompromittierung von pepsi-httpd zusammen mit seinem Credential für die Konfigurationsdatenbank erreicht daher die obige geschlossene Aufgabenliste. Das ist das Restrisiko, und es ist der Grund, warum die Liste geschlossen und klein statt bequem ist.
95.1.43.1.10.6. Die Fähigkeit entfernen: das Paket pepsi-httpd-admin¶
Der Applier wird nur je von systemds Socket-Aktivierung auf der Türklingel gestartet, die pepsi-httpd betätigt. Diese beiden Unit-Dateien, pepsi-setup-apply.socket und pepsi-setup-apply.service, sind daher der gesamte Weg von einer HTTP-Anfrage zu einer Änderung unter /etc/pepsi, und Debian liefert sie in einem eigenen Binärpaket aus, pepsi-httpd-admin.
pepsi Recommends es, sodass eine Standardinstallation es hat und die Browser-Konsole wie dokumentiert funktioniert. Ein Betreiber, der diese Installation vom Terminal aus verwaltet, entfernt es:
apt remove pepsi-httpd-admin
und pepsi bleibt installiert. Eine Quellinstallation hat denselben Hebel als make install INSTALL_ADMIN_UNITS=no.
Was das entfernt, ist der Mechanismus, nicht ein Knopf. Sind die Units fort, startet nichts den Applier, sodass ein setup_task-Datensatz inaktiv ist, wie auch immer er dorthin kam: pepsi-httpd erkennt die fehlende Türklingel und bedient seine Konfigurations- und Einrichtungsseiten nur lesend und weist die entsprechenden API-Änderungen mit 503 setup_applier_unavailable ab; siehe pepsi-httpd(1), Der privilegierte Applier, und ohne ihn auskommen.
pepsi-setup selbst bleibt im pepsi-Paket und ist unberührt. pepsi-setup run, pepsi-setup --wizard, pepsi-setup check und sogar pepsi-setup apply --once funktionieren weiterhin: root, das das Programm ausführt, ist root, das handelt, und das ist nicht das, was dies einschränkt. Was es entfernt, ist die Fähigkeit der Web-Schicht, das geschehen zu lassen.
Bemerkung
Das Entfernen des Pakets widerruft bewusst nicht die Datenbankberechtigung, die der Rolle pepsi-config das INSERT in pepsi.setup_task erlaubt, aus drei Gründen: Ein Maintainer-Skript bräuchte einen erreichbaren Cluster und ein Superuser-Credential, das es nicht hat, sodass ein Härtungsschritt zu einem Entfernungsfehlschlag werden könnte; die Berechtigung ist nicht die Grenze, auf die es ankommt, denn ein Datensatz, den nichts leert, ist inaktiv, und die beiden Schranken des Appliers gelten ohnehin; und eine spätere Neuinstallation käme mit einer Konsole zurück, die auf eine Weise kaputt ist, deren Fehlermeldung auf den Socket statt auf die Berechtigung zeigt.
Ein Standort, der Gürtel und Hosenträger will, kann es von Hand tun, und pepsi-setup run (das die Berechtigungen erneut anwendet) stellt es wieder her:
REVOKE INSERT ON pepsi.setup_task FROM "pepsi-config";
95.1.43.1.10.7. Prüfbarkeit¶
Jede Aufgabe ist ein dauerhafter Datensatz: wer gefragt hat, was verlangt wurde, wann sie begann und endete, was sie erzeugte und was schiefging. Jede Zulassung, Ablehnung, jeder Erfolg und Fehlschlag wird zusätzlich in das Prüfprotokoll geschrieben (setup.task.requested, setup.task.refused, setup.task.done, setup.task.failed), das für jede Komponente, die Mail verarbeitet, nur anfügbar ist. Fortschrittszeilen werden während der Arbeit in setup_task_log gestreamt, sodass ein certbot-Lauf oder eine Schemainstallation beobachtet werden kann, ohne dass der Applier eine HTTP-Verbindung hält.
Die Schreibvorgänge des Appliers werden angekündigt, sodass niemand, der eine Aufgabe beobachtet, die Datenbank immer wieder fragen muss. Zwei Trigger in procedures.sql benachrichtigen mit der Aufgaben-ID als Nutzlast: setup_task_progress für jede setup_task_log-Zeile und setup_task_done, wenn eine Aufgabe done, failed oder refused wird, gleich welcher Schreiber diesen Übergang vollzieht: der Applier, der eine Aufgabe abschließt, oder der Applier, der eine aufräumt, die ein früherer Applier als running hinterlassen hat. Der Applier selbst setzt kein pg_notify ab; pepsi-httpd(1) lauscht auf beiden Kanälen und weckt die Anfragen, die auf diese Aufgabe warten (GET /api/v1/setup/tasks/{id}?wait= und die Aufgabenseite der Konsole). Der Kanal setup_task, der den Applier weckt, ist ein anderer und wird von keinem der beiden ausgelöst.
95.1.43.1.11. Globale Optionen¶
Diese globalen Optionen stehen vor dem Unterbefehl (ein nachgestelltes Flag wird abgelehnt).
- -c FILE, –config FILE
Liest die Konfiguration aus FILE statt die Standardorte zu durchsuchen (siehe FILES). pepsi-setup schreibt diese Datei außerdem an Ort und Stelle um, wenn es TLS-Zertifikatspfade, den Reverse-Proxy-Socket, das Herkunftsnachweis-Secret, den Verweis auf den Schlüsselverpackungsschlüssel, die Telemetrie-System-ID und das sondierte
[pepsi] MAILBOX_FS_QUOTAautomatisch ausfüllt. Wenn -c weggelassen wird, löst es denselben Standardort auf, aus dem die Konfiguration geladen wurde, normalerweise/etc/pepsi/pepsi.conf, und schreibt diese Datei um, sodass ein bloßespepsi-setup runsich wiepepsi-setup -c /etc/pepsi/pepsi.conf runverhält. Es meldet den Pfad nur dann als unbekannt, wenn an keinem Standardort eine Konfigurationsdatei existiert.- –no-certbot
Ruft
certbotnicht auf, um fehlende TLS-Zertifikate zu beziehen. Das certbot-Pfad-Layout wird bei Bedarf weiterhin in die Konfiguration gefüllt; ein Zertifikat, das dann fehlt, wird aufgeschoben, nicht fatal: Der Host wird in der Zusammenfassung am Ende des Laufs mit einer umsetzbaren Meldung aufgeführt, und der Rest des Laufs (Schema, Schlüssel, DNS) fährt fort. Verwenden Sie dies, wenn Zertifikate auf andere Weise verwaltet werden, und beachten Sie, dass ein erfolgreiches Ende daher nicht behauptet, dass jedes konfigurierte Zertifikat vorhanden ist.- –no-reverse-proxy
Integriert sich nicht automatisch mit einem bestehenden Front-HTTP-Server. pepsi-httpd bindet dann Port 443 direkt, statt auf einen UNIX-Socket hinter einem Reverse-Proxy umgestellt zu werden (siehe Schritt 3 der Beschreibung). Verwenden Sie dies, wenn kein anderer Webserver 80/443 belegt oder wenn Sie den Reverse-Proxy von Hand verdrahten.
- -y, –yes-to-all
Nimmt für jede interaktive Eingabeaufforderung, die das Setup stellen kann, „ja“ an (derzeit das Angebot, das Dovecot-Drop-in zu installieren, Schritt 4), sodass ein Lauf nie auf Eingabe wartend blockiert; das ist nützlich in Skripten und nicht-interaktiven Installationen. Schließt sich mit -n gegenseitig aus.
- -n, –no-to-all
Nimmt für jede interaktive Eingabeaufforderung „nein“ an: Das Setup führt keine angebotene Aktion aus und gibt stattdessen aus, was es getan hätte (z. B. das von Hand auszurollende Dovecot-Drop-in), und schiebt es dann auf. Macht den Lauf ebenfalls vollständig nicht-interaktiv.
- –wizard
Führt den interaktiven Konfigurationsassistenten aus (siehe Assistent). Die Konfiguration wird in den -c-Pfad geschrieben oder nach
/etc/pepsi/pepsi.conf, wenn kein -c angegeben ist. Anders als die anderen Modi erfordert dies keine bestehende Konfigurationsdatei. Er nimmt keinen Unterbefehl (pepsi-setup --wizard runwird zurückgewiesen): Am Ende bietet er an, das vollständige Setup selbst auszuführen. Die unten stehenden Optionen, die „mit –wizard“ sagen, werden ohne es zurückgewiesen, außer--expert=help.- –force
Überschreibt mit –wizard eine bestehende Konfigurationsdatei, die keine importierbaren
[pepsi-wizard]-Antworten hat, ohne um Bestätigung zu bitten.- –expert SPEC
Fragt mit –wizard auch nach den tieferliegenden Pepsi-Optionen, die das Interview normalerweise für Sie entscheidet. SPEC ist eine Gruppe (
high,insane), eine kommagetrennte Liste von Optionsnamen oder beides;--expert=helplistet sie auf und beendet sich. Siehe Experten-Optionen.- –answers FILE
Beantwortet mit –wizard jede Frage aus dem JSON-Objekt in FILE, statt zu fragen: Die Schlüssel sind die Frage-Kennungen, die pepsi-setup questions ausgibt (plus die Namen der Experten-Optionen), und eine Frage, die die Datei nicht beantwortet, nimmt den Standardwert des Assistenten an, wie es das Drücken der Eingabetaste täte. Ein unbekannter Schlüssel oder eine Antwort der falschen Form ist ein Fehler. Von stdin wird nichts gelesen, und auch jede andere Eingabeaufforderung nimmt ihren Standardwert an, insbesondere das abschließende Angebot „Run setup now“; führen Sie daher danach pepsi-setup run aus. Siehe Ohne Terminal antworten.
- –import MTA
Importiert mit –wizard Standardwerte aus diesem bestehenden MTA (
postfix,exim,sendmail,qmail,stalwart), statt ein Menü des Erkannten anzubieten. Anders als die automatische Erkennung gilt dies auch, wenn bereits eine Konfigurationsdatei existiert, und es funktioniert bei nicht-interaktivem stdin. Siehe Migration von einem anderen MTA.- –no-import
Sucht mit –wizard überhaupt nicht nach einer bestehenden MTA-Konfiguration.
- –import-root DIR
Liest mit –wizard den zu importierenden MTA unterhalb von DIR statt von
/, etwa aus einer Sicherung oder aus der an Ort und Stelle kopierten Konfiguration einer anderen Maschine. Dies ist dieselbe Option, die der import-Unterbefehl –root nennt.- -L LOGLEVEL, –log LOGLEVEL
Setzt die Ausführlichkeit des Loggings. LOGLEVEL ist eines von
error,warn,info,debugodertrace(Standardwert:info). Anders als die anderen Pepsi-Programme beachtet pepsi-setup[pepsi] LOGundLOG_JSONnicht: Das Logging wird eingerichtet, bevor die Konfiguration geladen wird (und der Assistent läuft, bevor es eine gibt), übergeben Sie -L also ausdrücklich.- -v, –verbose
Zeigt Log-Meldungen aus allen Quellen, einschließlich Drittanbieter-Bibliotheken.
- -h, –help
Gibt eine Verwendungsübersicht aus und beendet sich.
- -V, –version
Gibt die Version aus und beendet sich.
95.1.43.1.12. Exit-Status¶
- 0
Erfolgreicher Abschluss.
- 1
Ein Fehler ist aufgetreten: eine fehlerhafte Konfigurationsdatei, ein ungültiger Domainname oder
PUBLIC_IP-Eintrag, eine Konfigurationsdatei, die nicht geschrieben werden konnte, eine fehlgeschlagene Datenbankverbindung oder ein Schlüssel, der nicht geschrieben werden konnte. Der Grund wird in das Journal geschrieben.Ein TLS-Zertifikat, das fehlt und nicht bezogen werden konnte, steht nicht auf dieser Liste: Es wird aufgeschoben und in der Zusammenfassung am Ende des Laufs gemeldet (Schritt 4), und der Lauf gelingt dennoch.
- 2
Die Kommandozeile selbst war falsch (eine unbekannte Option, eine globale Option nach dem Unterbefehl geschrieben, eine nur für
--wizardgedachte Option ohne –wizard).- 78
Das Datenbankschema kann von dieser Version nicht verwendet werden: schema (und run) lehnen ein Schema ab, das neuer als dieses Programm ist, eines, das aus einer anderen Fassung einer Patch-Datei gebaut wurde, eines ohne Installationsnachweis und ein
SQL_DIR, dessen Dateien nicht die sind, mit denen dieses Binärprogramm gebaut wurde (siehe schema).
95.1.43.1.13. Dateien¶
Wenn –config nicht angegeben ist, wird die erste vorhandene Datei aus der folgenden Liste verwendet:
$XDG_CONFIG_HOME/pepsi.conf$HOME/.config/pepsi.conf/etc/pepsi/pepsi.conf/etc/pepsi.conf
Beachten Sie die letzten beiden: Jedes Pepsi-Programm bevorzugt das kanonische /etc/pepsi/pepsi.conf gegenüber dem bloßen /etc/pepsi.conf, weil die Paketierung, die systemd-Units und @inline-secret@ allesamt das Unterverzeichnis benennen, und eine veraltete Kopie direkt in /etc darf die Datei, die die laufenden Dienste lesen, nicht verdecken. Existiert mehr als eine davon, protokolliert pepsi-setup, welche Datei es verwendet und welche ignoriert werden.
pepsi-setup hält keinen Signierschlüssel. Die DKIM- und ARC-Schlüssel gehören pepsi-dkim(1), unter [pepsi-dkim] STATE_DIR (Standardwert /var/lib/pepsi-dkim); check, run und die Konsole lesen ihren öffentlichen Status aus PUBLIC_DIR/status.json (Standardwert /var/lib/pepsi-dkim-public/status.json). [pepsi] KEY_DIR (Standardwert /var/pepsi/keys) ist der Ort, an dem Version 0.0.0 ihre DKIM-Schlüsseldateien aufbewahrte, die run löscht.
Neben der Konfigurationsdatei schreibt –wizard aliases (die Alias-Map, umgewandelt aus den Routing-Tabellen des vorherigen MTA, wenn einer importiert wurde), username.map (die Submission-Identitäts-Map), secrets.d/*.secret (die externalisierten Geheimnisse) und, nach einer Migration, import-report.txt. Eine bereits bestehende Datei wird von einem Import nie überschrieben: Der umgewandelte Inhalt wird stattdessen nach <name>.imported geschrieben.
95.1.43.1.14. Beispiele¶
Eine frische Installation bootstrappen und die zu veröffentlichenden DNS-Einträge erfassen:
pepsi-setup -c /etc/pepsi/pepsi.conf run > pepsi-dns.zone
Nach einem Upgrade erneut ausführen, das neue Migrationen mitliefert (Schlüssel und DNS bleiben unverändert, sofern keine neue Domain hinzugefügt wurde):
pepsi-setup -c /etc/pepsi/pepsi.conf run
Die Konfiguration validieren und die Datenbank von Grund auf zurücksetzen:
pepsi-setup -c /etc/pepsi/pepsi.conf run --reset
Nach dem Veröffentlichen (oder Ändern) von DNS das tatsächlich Veröffentlichte gegen das überprüfen, was Pepsi erwartet:
pepsi-setup -c /etc/pepsi/pepsi.conf check
Die Stage-Pipeline in ein PNG rendern, um zu überprüfen, wie Nachrichten geroutet werden:
pepsi-setup -c /etc/pepsi/pepsi.conf visualize | dot -Tpng -o pipeline.png
Vor einer Migration sehen, was vom heute auf diesem Host laufenden Mailserver übernommen würde (es wird nichts geschrieben):
pepsi-setup import
Von Postfix migrieren und dabei auch die tieferliegenden Fragen beantworten:
pepsi-setup --wizard --import postfix --expert=high
Inspizieren, was eine Migration aus dem unter /mnt/oldhost gespeicherten /etc einer anderen Maschine erzeugen würde:
pepsi-setup import postfix --root /mnt/oldhost --out /tmp/migration
95.1.43.1.15. Siehe auch¶
pepsi-config(1), pepsi.conf(5), pepsi-ingress(1), pepsi-stage-relay-to-smarthost(1), pepsi-keys(1), pepsi-keydisc(1)
95.1.43.1.16. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.