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:

  1. 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 jedes NEXT_STAGE/BOUNCE_STAGE aufgelöst werden kann, dass sich die Programmkonfiguration jeder Stage (einschließlich des Routings zum vorgelagerten MTA) parsen lässt, dass jeder Domainname wohlgeformt und jeder PUBLIC_IP-Eintrag eine gültige IP-Adresse ist. Es warnt, wenn die PUBLIC_IP einer Relay-Stage eine nicht-öffentliche Adresse ist (Loopback, RFC 1918 / Unique-Local, Link-Local oder CGNAT) und wenn eine Relay-Stage überhaupt keine PUBLIC_IP setzt (der Eintrag degradiert dann zu einem bloßen v=spf1 -all). Eine nicht-öffentliche Adresse kann im Internet niemals Mail senden. Steht sie mit dem abschließenden -all im 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 jedem MYNETWORKS-Eintrag eines Ingress-Listeners, der mehr als einen Host abdeckt (größer als /32 oder /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 von HOSTNAME, ACCEPTED_DOMAINS, [pepsi] ARC_DOMAIN oder einem Stage-SERVER_NAME noch auf .invalid endet (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 Sie pepsi-setup --wizard aus. 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_BITS ist 2048, 3072 oder 4096; ROTATION_LEAD_DAYS ist kürzer als ein ROTATION_DAYS ungleich null; RETIRE_AFTER_DAYS ist mindestens 1 und überschreitet das SIGNATURE_EXPIRATION_DAYS jeder 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_ADDRESS ist eine Adresse; und DNS_UPDATE = rfc2136 kommt mit einem TSIG_KEY_NAME, einem Base64-TSIG_SECRET und einem TSIG_ALGORITHM von hmac-sha256, hmac-sha384 oder hmac-sha512. Es warnt, wenn PUBLISH_RETIRED_KEYS an ist, aber kein pepsi-httpd-Listener HTTPS öffentlich ausliefert (die Schlüssel würden für niemanden zum Abrufen geschrieben), oder wenn es ohne ROTATION_DAYS an ist (Schlüssel werden dann nur bei einem manuellen pepsi-dkim rotate auß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 die MAILBOX_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 eine pepsi-stage-detect-language-Stage verwendet, dieses Binärprogramm aber nicht auf $PATH gefunden wird (es wird in einem eigenen großen Paket, getrennt vom Rest von Pepsi, ausgeliefert), warnt der Lauf und fährt fort; installieren Sie pepsi-stage-detect-language vor dem Start des Dienstes, sonst kann die detect-language-Stage nicht gestartet werden. Zwei weitere nicht-fatale Warnungen weisen auf wahrscheinliche Fehlkonfigurationen hin: eine pepsi-stage-block-language-Stage mit einer BLACKLIST, aber leerer WHITELIST und einem nicht-negativen THRESHOLD (was für alle Mail in neutraler Sprache einen Bounce erzeugt; siehe pepsi-stage-block-language(1)), und ein nicht-fortschreitender NEXT_STAGE-Zyklus (eine Kette von NEXT_STAGE-Kanten, die auf sich selbst zurückführt, sodass eine Nachricht bis MAX_LIFETIME im Kreis liefe; legitimer Wiedereintritt über BOUNCE_STAGE/RESTART_STAGE wird nicht markiert). Es warnt außerdem, wenn ein TARGETS-Eintrag eine uid unterhalb von UID_MIN aus /etc/login.defs zulä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) mit WALLET_MODE = local-user. Es warnt, wenn [pepsi-ingress] ACCEPTED_DOMAINS gesetzt ist, DMARC_ENFORCE aber nicht: Der einkompilierte Standardwert ist no, daher stellt eine solche Konfiguration Mail zu, die an DMARC scheitert; ein ausdrückliches no bleibt 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 ohne BOUNCE_TARGET_STAGE, die eine Nachricht mit Null-Absender ohne gültigen Pepsi-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 ein ACCEPTED_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 = yes macht aus dem Fehler eine Warnung, für einen Host, der keine eigene Domain haben kann. Die Warnung nennt, was den Weg schließt: aspf=s im DMARC-Eintrag der bedienten Domain, wenn die SRS-Domain eine Subdomain von ihr ist, oder dort p=quarantine/ p=reject zusammen 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 als SRS alignment: [ok], wenn aspf=s veröffentlicht ist und sich die beiden Namen unterscheiden oder die Richtlinie durchsetzt und DMARC_ENFORCE an ist, sonst [MISMATCH] mit der Abhilfe. Es warnt vor jeder [pepsi-srs] PREVIOUS_SECRET_FILE, die zuletzt vor mehr als MAX_AGE_DAYS geä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 ~/.forward nach 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 = yes mit einem Elliptische-Kurven-CRYPTO_SMIME_ALGORITHM, den Standardwert p256 eingeschlossen (mehrere S/MIME-Clients lehnen einen EC-Schlüssel ab, der sowohl ECDSA als auch ECDH macht), ein CRYPTO_GENERATE_RSA_BITS außer 2048, 3072, 4096 oder 8192 (die in konstanter Zeit erzeugten Größen) oder unterhalb von CRYPTO_MIN_RSA_BITS (die Installation würde Schlüssel erzeugen, die sie dann ablehnt), ein unplausibel kleines CRYPTO_MIN_RSA_BITS, ein nicht positives IDENTITY_VALIDITY_DAYS und ein KEY_WRAP_KEY_ID, das seine eigene KEY_WRAP_SECRET_<ID>-Option nicht benennen könnte. Ein [pepsi-crypto]-Abschnitt, der überhaupt etwas sagt, aber kein KEY_WRAP_SECRET hat, 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_BITS unter 2048, CRYPTO_ALLOW_WEAK_DIGESTS = yes (SHA-1-Signaturen, deren Kollisionen eine Signatur oder einen CMS-Digest-Algorithmus austauschbar machen) und CRYPTO_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, wenn ENABLE_PEP eingeschaltet ist, aber [pepsi-crypto] AUTO_CREATE_IDENTITY = no gilt (ein gültiges Veto des Standorts, doch dann erhält kein Absender automatisch einen Schlüssel; setzen Sie ENABLE_PEP = no, um das ausdrücklich zu machen) oder kein KEY_WRAP_SECRET konfiguriert ist (kein Absender kann einen Schlüssel erhalten); wenn RESPONSE_STAGE nicht gesetzt ist (Benutzer erfahren nicht, wenn ein neuer Schlüssel für ihre Adresse registriert wird, und die E-Mail-Schlüsselbefehle an pepsi-keys@<domain> sind abgeschaltet); und wenn [pepsi-ingress] USERNAME_MAP einen 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 ein RESPONSE_STAGE, das keine Stage benennt, und, wenn RESPONSE_STAGE gesetzt ist, ein TEMPLATE_DIR, dem die Rückfallvorlage key-registered.en.body oder keys.en.body fehlt.

    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 handgeschriebene pepsi.conf hinterlässt daher eine Installation, in der secrets.d/pepsi-crypto.secret vorhanden 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 als root hilft 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äßige KEY_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.

  2. Bereitet die vom Betreiber bearbeiteten Map-Dateien vor. Bei jedem Lauf durchläuft es die konfigurierten Lookup-Tabellen: die [pepsi-ingress] USERNAME_MAP und die ALIASES-Map jeder pepsi-stage-aliases-Stage. Eine Datei, die nicht existiert, wird aus einer kommentierten Starter-Vorlage (Modus 0644) 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 nachdem pepsi.conf geschrieben wurde, sodass ein Map-Problem den Assistenten nie daran hindert, die Konfiguration zu schreiben.

  3. 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 --standalone kann 80 nicht binden. Statt um die Ports zu kämpfen, erkennt pepsi-setup den Front-Server (über ss), bestätigt, dass er keinen der mta-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 bindende MODE = tls + TLS_CERT/TLS_KEY sowie die nun nicht mehr benötigten [pepsi-httpd-cert-*]-Abschnitte. Außerdem legt es ein pepsi-httpd.socket-Override (/etc/systemd/system/pepsi-httpd.socket.d/10-reverse-proxy.conf) ab, das ListenStream von 443 auf einen UNIX-Socket unter /run/pepsi/httpd.sock umbindet (SocketGroup= ist die Gruppe des Front-Servers: www-data unter Debian, anderswo nginx/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 = 660 und UNIXPATH_GROUP die Gruppe des Frontservers, wieder mit MODE = 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ür pepsi-httpd.socket oder macht auf einem Host ohne systemd den Listener wieder zu SERVE = tcp auf Port 443. Danach setzt es wieder MODE = tls und fügt für jeden Namen mta-sts.<domain>, den kein SNI nennt, 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 die sites-available des Front-Servers und aktiviert sie in sites-enabled (conf.d für Nicht-Debian-nginx). Die Site terminiert TLS für diese Hostnamen, sendet auf ihnen Strict-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 --standalone bezogen werden. Dieser Schritt ist eine No-Op, wenn kein Front-Server vorhanden ist, und wird mit --no-reverse-proxy vollständig übersprungen (in welchem Fall pepsi-httpd 443 direkt bindet). Sobald die pepsi-mta-sts-Site existiert, erzeugt ein erneuter Lauf sie neu und lädt den Front-Server nur dann neu, wenn sich ihr Text ändert: Ein mta-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, etwa Strict-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 der mta-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 Fall pepsi-setup run erneut aus, sobald die Ursache behoben ist. Das Socket-Verzeichnis /run/pepsi stammt aus dem systemd-tmpfiles-Eintrag des Pakets (keine Unit darf RuntimeDirectory=pepsi deklarieren: 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.

  4. Richtet TLS-Zertifikate ein. Für jeden Listener, der TLS terminiert und kein TLS_CERT/TLS_KEY gesetzt hat, füllt es die Optionen mit dem Standard-certbot-Layout aus (/etc/letsencrypt/live/<lineage>/fullchain.pem und privkey.pem) und schreibt sie an Ort und Stelle in die Konfigurationsdatei (Kommentare bleiben erhalten). Diese Listener sind die [pepsi-ingress-listener-*]-Sockets mit MODE = 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 der TLSA-Eintrag pinnt;

    • die Web-Lineage <HOSTNAME>-web, von den TLS-[pepsi-httpd-listener-*]-Sockets verwendet (und von einem [pepsi-httpd-cert-*]-Abschnitt, dessen erster SNI-Host HOSTNAME ist);

    • eine Lineage je weiterem [pepsi-httpd-cert-*]-Abschnitt, benannt nach seinem ersten SNI-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_KEY dieses Abschnitts durch die der Web-Lineage und protokolliert einen Hinweis. Bis dahin (--no-certbot oder 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 sein TLSA-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 HOSTNAME und openpgpkey.<domain> für jede Domain in ACCEPTED_DOMAINS ab, weil dort die erweiterte Methode des Web Key Directory abgerufen wird (pepsi-httpd(1)). Wenn [pepsi-autoconfig] die Mail-Autokonfiguration einschaltet, deckt es auch autoconfig.<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 der MX-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 als mx.example.org und mail.example.net erreichbar 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 --standalone aus (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-name des Zertifikats selbst: certbot prüft jedes -d gesondert 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_KEY mit den Layoutpfaden vergleicht, die es für diesen Host selbst geschrieben hätte. Die Frage kann nicht „ist TLS_CERT gesetzt?“ 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 run erneut 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-certbot angegeben war, certbot nicht installiert ist, pepsi-setup nicht als root läuft (es kann dann TCP/80 nicht binden), das DNS des Hosts nicht auf eine konfigurierte PUBLIC_IP auflöst (die Challenge würde dann scheitern) oder certbot selbst 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 konfigurierten PUBLIC_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 --config angegeben 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.conf und benennt darin jedes Zertifikat und jeden Schlüssel, den dieser Server liest, als LoadCredential=-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 Sie pepsi-setup run erneut 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 Server try-restart aus (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.sh einen 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 certbot archive/<host>/privkeyN.pem rotiert; 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 Paket acl) 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 gesetzte TLS_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 pepsi des Dispatchers für LMTP, pepsi-ingress für SASL. Das fängt den häufigen Fall eines Sockets ab, der zwar existiert, aber unerreichbar ist: Dovecots geteilter /run/dovecot/auth-client ist 0600 dovecot und kann von pepsi-ingress nicht 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.conf zu installieren, einen dedizierten unix_listener im Besitz des Pepsi-Dienstbenutzers (mode = 0600, sodass die Berechtigungen des geteilten Sockets unberührt bleiben). Danach validiert es die zusammengeführte Konfiguration mit doveconf und lädt Dovecot neu. Wenn es das nicht kann (nicht root, kein Terminal zum Nachfragen, doveconf weist 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_PATH ist dieser private Socket, /run/dovecot/auth-client-pepsi. Diese Prüfung läuft bei jedem pepsi-setup run, nicht nur unter --wizard. -y/--yes-to-all installiert 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.

  5. 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-agent mit 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 es pepsi-ingress.socket, das fehlschlägt (systemctl status pepsi-ingress.socket meldet Result: resources), Mail wird weiterhin vom anderen Server mit dessen Alias- und Virtual-Maps zugestellt, und jede Änderung an pepsi.conf scheint 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 weder systemd noch Pepsi selbst ist. Diese Ports sind der konfigurierte PORT bei einem SERVE = tcp-Listener und die FD_INDEX-Zuordnung der mitgelieferten Socket-Unit (0 → 25, 1 → 465, 2 → 587) bei einem SERVE = 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 dann pepsi-ingress.socket starten.

    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_SERVERS oder /etc/resolv.conf), eine Frage, deren Antwort es kennt, und sucht nach dem AD-Bit. Das geschieht nur, wenn die Konfiguration DANE verlangt: eine Relay-Stage, deren DANE nicht off ist (strict ist der Standardwert für beide Relay-Stages und für jeden Smarthost-Abschnitt [pepsi-stage-relay-to-smarthost-mta-*]), oder dane in [pepsi-keydiscovery] SOURCES. Pepsi vertraut einem validierenden Resolver, statt DNSSEC selbst zu validieren. Setzt ein Resolver AD nie, 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. Das AD-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- oder SMIMEA-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 mit DNSSEC=yes) unter 127.0.0.1/::1, für den der Hinweis schweigt. check gibt denselben Hinweis aus.

  6. Installiert das Datenbankschema. Jede Pepsi-Komponente teilt sich eine Datenbank (den [pepsi-postgres]-Abschnitt) und das eine pepsi-Schema; pepsi-setup ist der einzige Installer. Das Schema ist eine einzige Patch-Serie (pepsi-NNNN.sql) mit einer procedures.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-Rolle pepsi (und pepsi-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-ingress

    INSERT in pepsi.workqueue und pepsi.workqueue_body (plus SELECT der IDs, die workqueue_add zurückgibt, und der beiden generierten Größenspalten header_octets und octets, die die Aufnahmeprüfung der Warteschlange summiert), SELECT auf config_override, mailbox_quota, login_assignment (der Test nach RFC 7293 bei RCPT), den heruntergeladenen IP-Sperrlisten (ip_blocklist, ip_blocklist_source) und crl_cache (Widerruf von TLS-Client-Zertifikaten), SELECT der Spalten list_name und mail_host von mailing_list (die Empfängerprüfung), INSERT auf den beiden nur anhängbaren Logs. Sie kann keine bereits eingereihte Nachricht lesen.

    pepsi-telemetry

    Ihre eigene Tabelle pepsi.telemetry.

    pepsi-httpd

    Alles, was die Konsole, das Portal, die Listen-Website und das Archiv verwenden, mit diesen Grenzen: Auf pepsi.workqueue bekommt sie nur die Umschlag-, state- und Routing-Spalten, nie headers oder den Nachrichtentext, und sie kann den body_id einer Nachricht nicht umbiegen. Auf pepsi.workqueue_body bekommt sie nur INSERT (die Webformulare senden Mail) und DELETE (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), nie SELECT des Nachrichtentexts. Überhaupt nichts bekommt sie auf settings, 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_check oder signed_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_token sowie own_enrolment und own_session der Endbenutzer-Konsole) allein pepsi-httpd, und die Audit- und Mail-Logs sind für jede Rolle, die Mail verarbeitet, nur anhängbar; pepsi-httpd darf 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-ingress und pepsi-telemetry ebenfalls 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-whitelist

    Bekommt SELECT, INSERT und DELETE auf pepsi.whitelist und 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-keydisc

    Die 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/DELETE auf pepsi.peer_key (diesen Cache zu füllen ist ihre ganze Aufgabe, und die Konfliktregel muss einen Datensatz ersetzen können), SELECT/INSERT/UPDATE auf pepsi.key_request, EXECUTE auf den keydisc_*-Funktionen und den beiden crypto_*-Helpern, die sie aufrufen, SELECT/INSERT/UPDATE/ DELETE auf pepsi.crl_cache (die Sperrlisten, die sie abruft; sie ist die einzige Rolle, die sie schreibt, während pepsi und pepsi-crypto sie nur lesen dürfen und keine andere Rolle sie sieht), dasselbe auf pepsi.ca_issuer_cache (die Zwischenzertifikate, die sie abruft), SELECT auf der Liste bekanntermaßen kompromittierter Schlüssel (pepsi.compromised_key und compromised_key_import, damit sie das Speichern eines aufgeführten Schlüssels verweigert) und auf pepsi.workqueue SELECT plus ein spaltenweises UPDATE (status, timeout).

    Diese beiden Spalten sind der interessante Teil. Sie reichen genau aus, um eine an einer Adresse geparkte Nachricht von paused zurück auf pending zu bewegen, was keydisc_resolve und keydisc_sweep tun (einfache SECURITY 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 auf pepsi.crypto_identity.

    pepsi-crypto

    Das 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: was pepsi-keys blocklist update und peer screen festhalten); pepsi und pepsi-keydisc dü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/ UPDATE auf Tabellenebene für pepsi.crypto_identity jeder gewöhnlichen Dienstrolle und gewährt SELECT Spalte für Spalte für jede Spalte außer private_wrapped zurück. Die gewöhnlichen Dienstrollen sind pepsi (der Dispatcher und jeder Stage-Worker), pepsi-ingress, pepsi-httpd und pepsi-telemetry. INSERT wird nicht zurückgewährt und UPDATE nur auf den Spalten, die der Code der Rolle schreibt: die Flags is_primary, published und vks_wanted (pepsi und pepsi-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. (DELETE hat 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 aus information_schema zurü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).

  7. 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 von SERVER_NAME / POSTMASTER jeder Stage, einer ausdrücklichen SIGNING_DOMAIN, der [pepsi-srs] SRS_DOMAIN einer SRS-Stage, dem festen RESPONSE_FROM einer 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_BITS und einen Ed25519-Schlüssel, wie DKIM_ALGORITHMS und ARC_ALGORITHM es 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 als note: von pepsi-setup check gewarnt, mit pepsi-dkim rotate als 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_DIR aufbewahrte (<domain>/dkim.rsa.key und <domain>/dkim.ed25519.key), gelöscht, wobei jedes Verzeichnis je Domain leer zurückbleibt, da nichts mit ihnen signiert; ihre Einträge (<DKIM_SELECTOR>._domainkey und <DKIM_SELECTOR>-ed25519._domainkey) werden protokolliert und als entfernbar ausgegeben.

  8. 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, current und retiring, unter <DKIM_SELECTOR>-YYYYMM._domainkey für RSA und <DKIM_SELECTOR>-YYYYMM-ed25519._domainkey für Ed25519, ein RSA-Wert aufgeteilt in Zeichenketten in Anführungszeichen von höchstens 255 Bytes), eine SPF-Richtlinie (v=spf1 …), gebaut aus den PUBLIC_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 nicht MTA_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 unter https://mta-sts.<domain>/.well-known/mta-sts.txt angeboten (ihre mx-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. Die id des Eintrags ist aus der eigenen Richtlinie dieser Domain abgeleitet, sodass zwei Domains mit verschiedenen mx-Mengen verschiedene ids bewerben. Anders als jeder andere Eintrag hier wird der MTA-STS-Eintrag nur für die [pepsi-ingress] ACCEPTED_DOMAINS ausgegeben. 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ückliche SIGNING_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] RUA gesetzt, 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 des SubjectPublicKeyInfo des ausgelieferten Zertifikats sind. Das ist die Form 3 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 es reuse_key = True in 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. Neben HOSTNAME umfasst 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 das MX-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 fehlender DS bei der übergeordneten Zone den Pin zur Dekoration. Ein Resolver, der SERVFAIL antwortet (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 seine accounturi (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 einen issue-Eintrag für jede andere CA hinzu, die die Domain verwendet, und lassen Sie accounturi weg, 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 in MAIL FROM ausgewertet, daher erhält ohne ihn ein gefälschter Absender bei einer erfundenen Subdomain von jedem Empfänger, der DMARC nicht durchsetzt, SPF none. 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 ein OPENPGPKEY- (RFC 7929) oder SMIMEA-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 Sie pepsi-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: Unter NSEC lässt sich jede veröffentlichte Adresse auflisten und unter NSEC3 lassen 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 jeder autoconfig.<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 zuerst https://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_IP gebaut, einer stage-weisen Option, die pepsi-setup aus jeder Relay-Stage liest und vereinigt. Eine Relay-Stage wird an ihrem PROGRAM erkannt (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 eigenen PUBLIC_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 keine PUBLIC_IP setzt, ist der Eintrag ein bloßes v=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 übriggebliebenes v=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 Mechanismen all, include, a, mx, ptr, ip4, ip6 und exists mit ihren Qualifikatoren, Adresssyntax und CIDR-Längen (/0–/32, /0–/128), die Modifikatoren redirect= und exp= (jeder höchstens einmal), unbekannte name=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. ptr ist 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: und redirect= folgend (einem redirect= nur, wenn der Eintrag kein all hat), summiert es die Terme, die eine DNS-Abfrage auslösen (include, a, mx, ptr, exists, redirect), und die leeren Abfragen darunter (ein a-, mx- oder include-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=s wird vorgeschlagen: Jede Nachricht, die Pepsi für eine bediente Domain sendet, trägt eine DKIM-Signatur, deren d= genau die From:-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 ist p=none (nur Überwachung) der Rückfall; für einen Dienst, der als Subdomain signiert, muss adkim=s entfallen. Die SPF-Ausrichtung bleibt locker, und der Kommentar empfiehlt, aspf=s hinzuzufü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 Vorschlag rua=mailto:dmarc-reports@<domain> (ihren LOCAL_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 ein rua=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 in rua= hinzugefügt (oder einem am Ende angefügten rua=-Tag). Jedes rua=/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 sein p= quarantine oder reject und [pepsi-ingress] DMARC_ENFORCE aus, 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 mit sp=reject; np=reject, wenn der Eintrag den Subdomains eine schwächere Richtlinie als reject lässt: ein p= außer reject ohne sp= oder ein ausdrückliches schwächeres sp= oder np= (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, sp oder bewusste p=quarantine einer 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 Tag aspf mit dem Wert s adkim=s und 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 fehlendes p=-Tag und eine rua=/ruf=-Adresse ohne ihr mailto:-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 einzelne setup: 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 und DKIM1, ein k=, das den Schlüsseltyp nennt (ein Ed25519-Schlüssel ohne k=-Tag scheitert überall, da das Tag standardmäßig rsa ist), keine h=/s=-Einschränkung, die sha256/email ausschließt, kein t=y (Testmodus, in dem eine Signatur nichts zählt) und ein p= gleich dem Schlüssel, den pepsi-dkim(1) für den Selektor meldet. Nur die Selektoren, mit denen [pepsi] DKIM_ALGORITHMS signiert, werden ausgegeben und geprüft, dazu derjenige, den das ARC-Siegel an der ARC_DOMAIN braucht. 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.service zu 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 als fail führen. Das ist erwartet und harmlos, da die RSA-Signatur das ausgerichtete Bestehen für DMARC liefert, und die Ed25519-Signatur lässt sich mit DKIM_ALGORITHMS = rsa abstellen.

    In derselben Phase prüft pepsi-setup außerdem das Reverse DNS (PTR) jeder PUBLIC_IP einer pepsi-stage-relay-to-internet-Stage, also der eigenen Egress-Adressen dieses Hosts (eine PUBLIC_IP von 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, ihr SERVER_NAME (das auf das Ingress-HOSTNAME zurückfällt, wenn eine Stage keines setzt), denn das ist das Paar, das ein Empfänger vergleicht. Eine PUBLIC_IP ist nur dann korrekt, wenn ihr PTR existiert, 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 keinen PTR;

    • 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_DOMAINS ist: Eine Maschine, die auf mehrere Namen hört (etwa example.org im EHLO angekündigt, während ihre Adresse rückwärts auf example.net auflö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 PTR wird 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_IP in der Zone des IP-Eigentümers liegt (in-addr.arpa / ip6.arpa), besteht die übliche Abhilfe darin, Ihren ISP oder Hoster zu bitten, den PTR auf 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 der PTR bereits eine Ihrer eigenen Domains ist, bietet die Meldung auch die andere Richtung an, denn diese Abhilfe braucht niemandes Mitwirkung: den PTR-Namen als Identität dieses Hosts zu übernehmen ([pepsi-ingress] HOSTNAME und das SERVER_NAME jeder 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 derselben PTR-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ätigten PTR-Namen ihrer Absendeadresse selbst an. Für diese Stage wird der PTR deshalb mit ihrem eigenen Namen verglichen: Eine Namensabweichung kann nicht auftreten, ein fehlender, unbestätigter oder generisch aussehender PTR wird aber weiterhin gemeldet. Ohne vorwärts bestätigten Namen greift die Stage auf SERVER_NAME zurü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), REFUSED erhalten. Empfänger stellen dann jede Nachricht mit cannot find your reverse hostname zurück, und die lokale Prüfung sagt, der PTR sei korrekt.

    Deshalb fragt pepsi-setup erneut über die öffentlichen Resolver, die [pepsi] PUBLIC_RESOLVERS nennt (standardmäßig Google, Cloudflare und Quad9, jeweils über IPv4 und IPv6; siehe pepsi.conf(5)): den PTR jeder PUBLIC_IP, vorwärts bestätigt über denselben Resolver; die MX-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 die PTR-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 = none schaltet 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 eine id, 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 unter MTA_STS_MODE = enforce stoppt jedes davon, wenn es falsch ist, stillschweigend die gesamte eingehende Post für die Domain. Beide werden bei jedem pepsi-setup run geprüft und vom Unterbefehl check sowie von der Webkonsole gemeldet; wie die PTR-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 MX der 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 der MTA_STS_MX-Rückfall einlädt, denn HOSTNAME ist der EHLO-Begrüßungsname und muss kein Name sein, auf den irgendein MX-Eintrag zeigt. Die Warnung benennt die Hosts auf jeder Seite und gibt die einzelne MTA_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 den MX-Eintrag zu ändern, und den Rat, bis zur Übereinstimmung auf MTA_STS_MODE = testing zurückzufallen. Diese Prüfung meldet außerdem eine Domain ohne MX-Eintrag, ein Null-MX nach RFC 7505 auf einer Domain, für die wir Post annehmen, ein MX-Ziel, das ein CNAME ist (von RFC 5321 §5.1 verboten, und Absender dürfen es ablehnen), einen Richtlinieneintrag, der auf keinen lebenden MX-Host passt (harmlos, weitet aber, womit Absender sich verbinden werden), und einen DOMAIN:HOST-Eintrag, der eine Domain benennt, die nicht in ACCEPTED_DOMAINS steht. 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-setup fordert https://mta-sts.<domain>/.well-known/mta-sts.txt an 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 ein 502 erhält, während jede Unit active bleibt und nichts protokolliert wird. Absender, die eine Richtlinie schon zwischengespeichert haben, setzen bis zu max_age lang weiter die alte durch, der Fehlschlag endet also nicht einmal von selbst. Ein 5xx wird 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, sobald mta-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_DOMAIN einen MX-Eintrag hat oder andernfalls einen A/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 ein MX-Ziel, das ein CNAME ist, 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 gegen 127.0.1.1 oder 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.

  9. 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 /config muss ein taler-merchant-Backend identifizieren (damit die URL korrekt ist) und GET /private/orders?limit=1 muss 200 zurückgeben (damit das MERCHANT_ACCESS_TOKEN korrekt ist). Es stellt dann sicher, dass ein pepsi-resume-Webhook existiert, der an den /resume-Endpunkt von pepsi-httpd POSTet, wann immer eine Bestellung bezahlt wird. Fehlt der Webhook, erstellt es ihn; existiert bereits ein pepsi-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.

  10. Erinnert an Zugangsdaten, die außerhalb des Systems ablaufen. Wenn irgendein Smarthost-MTA AUTH = oauth verwendet, validiert pepsi-setup die entsprechenden [pepsi-helper-token-refresh-<name>]-Geheimnis-Abschnitte, die es lesen kann (es läuft als root), 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 von pepsi.target ist. Verwendet einer AUTH = gssapi, erinnert es ebenso daran, dass der Kerberos-Credential-Cache außerhalb des Systems erneuert werden muss (ein Keytab plus k5start oder 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 des pepsi-owner-Benutzers an; die PostgreSQL-Peer-Authentifizierung verbindet sich dann als die gleichnamige Rolle, sodass das pepsi-Schema, seine Tabellen, Sequenzen und Funktionen pepsi-owner gehören. Der pepsi-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_DIR und PUBLIC_DIR an, wenn sie fehlen, und wird zum Konto pepsi-dkim, bevor es einen Schlüssel anfasst, sodass jede Schlüsseldatei diesem Konto gehört (Modus 0600 in 0700-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_LOOPBACK

Fügt MYNETWORKS = 127.0.0.0/8 ::1/128 zum 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:

  1. Installiert — sein Binärprogramm liegt auf $PATH oder in den üblichen sbin-Verzeichnissen, oder es existiert eine systemd-Unit-Datei dafür.

  2. Lauscht irgendwo — ein Socket wird aus der eigenen Konfigurationsdatei des Filters gelesen (MilterSocket in clamav-milter.conf, socket in greylist.conf, ein SOCKET= oder ein -p-Flag in einem /etc/default-Fragment, Rspamds bind_socket), dann aus dem ExecStart seiner Unit, dann aus den Pfaden, die seine Distribution mitliefert.

  3. 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 run ausfü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:

FAILED

Eine Datei konnte nicht gelesen oder geparst werden; aus ihr wurde nichts importiert.

UNSUPPORTED

Verstanden, 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 in MYNETWORKS übernommen zu werden: Pepsi vertraut einem Netz nur so weit, wie [pepsi-ingress] SENDER_MAP es bindet, und pepsi-ingress verweigert bei einem ungebundenen den Start, daher fügt der Betreiber das Netz und seine Bindung von Hand hinzu.

APPROXIMATED

Mit anderer Semantik importiert, etwa eine mbox-Zustellung, die zu Maildir wird, ein auf volle Stunden gerundetes maximal_queue_lifetime, ein aus MYNETWORKS entferntes Loopback-Netz.

UNKNOWN

Eine 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

smtpd_milters

[pepsi-ingress] MILTERS, in derselben Reihenfolge

milter_default_action

ON_FAILURE: accept, tempfail und reject unverändert, quarantine als tempfail

milter_connect_timeout

CONNECT_TIMEOUT

milter_command_timeout

COMMAND_TIMEOUT

milter_content_timeout

CONTENT_TIMEOUT

milter_protocol

PROTOCOL_VERSION

milter_macro_daemon_name

MILTER_NAME

milter_<phase>_macros

MACROS_<phase>: connect, helo, mail, rcpt und data nach Namen, end_of_header als MACROS_EOH und end_of_data als MACROS_EOM

non_smtpd_milters

eine pepsi-stage-milter-Stage auf dem Submission-Pfad (siehe unten)

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

Eine Zeile je Alias und akzeptierter Domain — exakt, und der Standardwert.

wildcard

Eine Zeile je Alias mit einem Domain-Glob (postmaster@*) — kompakt, passt aber auch auf später hinzugefügte Domains.

primary

Nur 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) und master.cf. Die Identität stammt aus myhostname/mydomain, die akzeptierten Domains aus mydestination, virtual_alias_domains, virtual_mailbox_domains und relay_domains; der Smarthost aus relayhost, sein Transport aus smtp_tls_security_level / smtp_tls_wrappermode und seine Zugangsdaten aus smtp_sasl_password_maps. Die lokale Zustellung wird aus home_mailbox, mailbox_transport/virtual_transport (ein lmtp:unix:-Ziel wird zu Pepsis LMTP-Stage) und mail_spool_directory gelesen; die Submission-SASL aus smtpd_sasl_type = dovecot und smtpd_sasl_path; die aktivierten Dienste in master.cf entscheiden über die Richtung. alias_maps/alias_database und virtual_alias_maps werden zur Alias-Map (Virtual-Einträge gewinnen, wie sie es in Postfix tun), und smtpd_sender_login_maps wird zu username.map, invertiert in Pepsis nach dem Login geschlüsselte Form. message_size_limit, recipient_delimiter, maximal_queue_lifetime, smtp_helo_name und die smtpd_tls_*-Zertifikatspfade kommen als Experten-Optionen an; mynetworks wird Netz für Netz für eine SENDER_MAP-Bindung gemeldet (siehe UNSUPPORTED oben).

Gemeldet statt migriert: header_checks/body_checks, transport_maps, kanonisches Umschreiben, smtpd_*_restrictions, postscreen_*, content_filter, Zustellung in virtuelle Postfächer, dienstweise -o-Überschreibungen in master.cf und 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.conf ist die reichhaltigste und zuverlässigste Quelle und hat Vorrang: dc_eximconfig_configtype gibt die Richtung und ob es einen Smarthost gibt, dc_other_hostnames die Domains, dc_smarthost das Relay, dc_relay_nets die vertrauenswürdigen Netze (für eine SENDER_MAP-Bindung gemeldet, nicht übernommen) und dc_localdelivery das Postfachformat. Der Hauptteil von exim4.conf.template / exim.conf / conf.d/main/* (alles vor dem ersten begin) ergänzt primary_hostname, qualify_domain, domainlist local_domains, hostlist relay_from_hosts, message_size_limit, smtp_accept_max und das tls_certificate-Paar. Exims Listensyntax wird korrekt behandelt: verdoppelte Trennzeichen, <;-Überschreibungen, .include, +named-Referenzen und .ifdef, ausgewertet gegen die tatsächlich definierten Makros. /etc/aliases wird zur Alias-Map, /etc/email-addresses zur Submission-Identitäts-Map und /etc/exim4/passwd.client zu 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 in begin retry liegt, wird MAX_LIFETIME nie erraten, und weil der Transport die TLS- und AUTH-Richtlinie hält, wird die Transportsicherheit des Smarthosts angenommen statt gelesen. Ein tls_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.cf wird verwendet, wenn keine .mc existiert, und dann nur seine zuverlässig lesbaren Zeilen (Dj der kanonische Name, DS der Smarthost, Cw/Fw die lokalen Hostnamen, DZ die Version und die O-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 die FEATUREs, auf die es ankommt (use_cw_file, virtusertable, authinfo, local_lmtp, plussed_users, local_procmail, nullclient). Die Tabellen local-host-names, virtusertable, aliases und authinfo (die Smarthost-Zugangsdaten, mit dem Mechanismus aus ihrem M:-Feld) werden gelesen; postmaster wird über die Alias-Kette zu einer echten Adresse aufgelöst.

Gemeldet statt migriert: MASQUERADE_AS und 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 rechte virtusertable-Seiten, die Pepsi nicht ausdrücken kann (error:, %1).

qmail

Das Control-Verzeichnis (/var/qmail/control, /etc/qmail oder /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. me gibt den Hostnamen; locals, rcpthosts, morercpthosts und virtualdomains die Domains; der :relay:port-Catch-All in smtproutes den Smarthost (mit Zugangsdaten, wenn die erweiterte Form der AUTH-Patches verwendet wird); defaultdelivery (oder das qmail-start-Argument in rc) das Postfachformat; databytes, queuelifetime, helohost und ein servercert.pem die Experten-Optionen.

Die Alias-Tabelle sind die .qmail-*-Dateien in qmails Alias-Verzeichnis: .qmail-foo-bar wird zu foo-bar, : dekodiert zurück zu ., .qmail-default wird zu einem Catch-All und .qmail-foo-default zu 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-forward ist die Laufzeit-Entsprechung), und es wird nie eine .cdb geöffnet; stattdessen wird das textuelle users/assign gelesen. badmailfrom/badrcptto, spfbehavior, percenthack, qmqpservers und tlsclients werden mit ihren Pepsi-Gegenstücken gemeldet.

Stalwart

config.toml unter /opt/stalwart-mail/etc, /opt/stalwart/etc, /etc/stalwart oder /etc/stalwart-mail (ein Verzeichnis von .toml-Fragmenten wird ebenfalls gelesen, und !include-Direktiven wird gefolgt). server.hostname und die server.listener.*-Ports geben Identität und Richtung, queue.outbound.next-hop / queue.strategy.route und die remote.*-Tabelle den Smarthost (ein Hop mit protocol = "lmtp" wird stattdessen zu lokaler LMTP-Zustellung), certificate.* die TLS-Pfade, session.data.limits.size und der Queue-Ablauf die Experten-Optionen. Ein directory vom Typ memory (oder ein principals-Array) liefert Konten: Jede zusätzliche Adresse wird zu einem Alias auf die primäre Adresse des Kontos, und die Logins werden zu username.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:

high

Die Optionen, die ein Administrator plausiblerweise anpasst: MAX_MESSAGE_SIZE, MYNETWORKS, RECIPIENT_DELIMITER, MAX_LIFETIME, DMARC_ENFORCE, IP_BLOCKLISTS und MAILBOX_QUOTA (bewusst in dieser Gruppe statt in insane: Eine Installation, die lokal zustellt, will einen Standardwert für die Quota und sollte den Namen der Option nicht kennen müssen).

insane

Alles 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_QUOTA und CRYPTO_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 /etc einer anderen Maschine zu inspizieren.

–out DIR

Schreibt den Bericht und die umgewandelten Map-Dateien nach DIR (eine bestehende Datei wird nach <name>.imported umgeleitet statt überschrieben).

–alias-style STYLE

Wie bloße Alias-Namen qualifiziert werden: per-domain (Standardwert), wildcard oder primary; 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 ein SECRET noch ein SECRET_FILE hat und nicht mit ENABLED = no abgeschaltet ist; der Herkunftsnachweis ist standardmäßig an, der Abschnitt muss also nicht vorhanden sein. Ein zufälliges Geheimnis wird in ein secrets.d/pepsi-origin.secret-Fragment geschrieben (im Besitz des pepsi-Kontos, Modus 0640) 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] HOSTNAME nicht gesetzt ist (der Name ist in den Pepsi-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 Modus 0640 und übergibt es an das Konto, das es lesen muss: secrets.d/pepsi.secret (Smarthost-/LMTP-Passwörter, das Händler-Zugriffstoken) an pepsi, secrets.d/pepsi-httpd.secret (das RESUME_AUTHORIZATION_TOKEN) an pepsi-httpd, secrets.d/pepsi-ingress.secret (das SRS-SECRET) an pepsi-ingress, secrets.d/pepsi-crypto.secret (das KEY_WRAP_SECRET von [pepsi-crypto], aktuell und außer Dienst gestellt) an pepsi-crypto sowie secrets.d/pepsi-secure-link.secret (das [pepsi-secure-link] PEPPER) und secrets.d/pepsi-list.secret ([pepsi-list] UNSUBSCRIBE_SECRET, VERP_SECRET und API_PASS) an pepsi-httpd mit der Gruppe pepsi (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) an pepsi-keydisc, secrets.d/pepsi-helper-token-refresh.secret (die OAuth-Client-Zugangsdaten) an pepsi-helper-token-refresh und secrets.d/pepsi-dkim.secret (das [pepsi-dkim] TSIG_SECRET) an pepsi-dkim. Jede von [pepsi-srs] PREVIOUS_SECRET_FILE genannte Datei (ein außer Dienst gestellter SRS-Schlüssel) erhält Eigentümer und Modus der aktuellen. Das SRS-Geheimnis gehört pepsi-ingress, weil Ingress SRS-Rückadressen rückwärts dekodiert; die SRS-Stage läuft als pepsi und liest es über die geteilte pepsi-ingress-Gruppe (das Debian-Paket macht pepsi zu 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.service mit [pepsi] SHARE_TELEMETRY in 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 Benachrichtigung telemetry_changed, sodass ein laufender Daemon der Antwort sofort folgt; das Ausschalten der Telemetrie wirkt sofort. pepsi.target startet diese Unit nicht: Nichts im Target Wants sie, denn eine Unit, die das Target mitzöge, liefe, gleich was die Antwort war. Die Unit ist allerdings PartOf= des Targets und stoppt daher mit der Pipeline. Es geschieht hier, am Ende, weil die SYSTEM_ID frü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 einzelne systemctl-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.conf auf einem Mail-Host oder /etc/pepsi-telemetry/pepsi-telemetry.conf auf 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_file fest; 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 in SQL_DIR zurü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 pepsi und _v sowie 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. 0 behä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 in p= dem Schlüssel entspricht, den pepsi-dkim(1) hält; siehe Gibt DNS-Einträge aus unter run), der SPF-Eintrag (der v=spf1-Eintrag führt jede konfigurierte PUBLIC_IP auf), 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 parsbarer v=STSv1-Eintrag mit einem id=-Tag; der Wert von id wird 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, deren rua= die Berichtsadresse fehlt, ein TLSA- oder CAA-Eintrag, das v=spf1 -all einer 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 (Ziel setup), 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, von pepsi.target genannt, führt täglich pepsi-setup -c /etc/pepsi/pepsi.conf check --fail-on-findings aus (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, die systemctl --failed dann 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 ein v=spf1-Eintrag (RFC 7208 §4.5 macht das zu einem permanenten Fehler, sodass keine SPF-Richtlinie gilt, statt dass die erste gewinnt), ein v=spf1-Eintrag mit einem Term außerhalb der Grammatik von RFC 7208 (ein unbekannter Mechanismus wie ipv4:, eine fehlerhafte Adresse oder CIDR-Länge, ein fehlerhaftes Makro; der Term wird genannt) und mehr als ein v=STSv1-Eintrag oder einer, dessen id= außerhalb der erlaubten Syntax liegt. Ein v=spf1-Eintrag, der auf +all endet, 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 fehlendem k=, einem falsch platzierten v=, einer h=/s=-Einschränkung, die ausschließt, was Pepsi signiert, oder einem zweiten Schlüsseleintrag unter demselben Namen ist [INVALID]; t=y ist ein [MISMATCH]. Wenn Ed25519-Signieren an ist, erklärt ein abschließendes note:, warum Google diesen Selektor als fail meldet.

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. Ein p=, 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.service zu starten und run auszuführen.

Ein Eintrag kann auch [ok] sein und eine Anmerkung tragen: Eine p=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 aktuellen MX-Einträge und einen Abruf von https://mta-sts.<domain>/.well-known/mta-sts.txt, verglichen mit der konfigurierten Richtlinie. Es endet mit einem Hinweis, der die MTA_STS_MX-Zeile angibt, mit der beide übereinstimmen würden. Für die [pepsi-srs] SRS_DOMAIN fü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: ein MX-Eintrag, der einen Host ohne A/AAAA-Eintrag nennt (oder einen, der nicht existiert); ein NS-Eintrag der Domain, der einen Nameserver ohne Adresse nennt; ein CNAME unter mta-sts.<domain>, openpgpkey.<domain> oder autoconfig.<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. ohne MX-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, deren MX-RRset sie nicht so markieren (Beschriftungen TLSA (DNSSEC) und MX (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 das MX-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 keine issue-Eigenschaft), sodass jede CA an jeden ausstellt, der eine Domain-Validierung besteht, eine gekaperte eingeschlossen; [NO ACCOUNTURI], wenn letsencrypt.org ohne die accounturi nach 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, die accounturi eines anderen Kontos, validationmethods ohne http-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 HOSTNAME und der SRS-Domain, gefunden über den SOA-Eintrag (der Name selbst oder der nächste Vorfahr, der einen trägt), ihr DNSKEY-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 signierte MX- und TLSA-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, die pepsi-keys blocklist update pflegt, und die Moduli, die pepsi-keys peer screen faktorisiert 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- oder MX-Eintrag hat) und die keinen eigenen SPF-Eintrag hat. Die Konfiguration nennt den EHLO-Host einer Relay-Stage, [pepsi-ingress] HOSTNAME, mta-sts.<domain> und autoconfig.<domain>. Ein Platzhalter-SPF-Eintrag antwortet nicht für einen Namen, der existiert, daher erhält ein gefälschter Absender dort SPF none. Der Eintrag, den ein solcher Name braucht, ist v=spf1 -all oder, für einen Namen, den Pepsi in EHLO ankündigt, der SPF-Eintrag der bedienten Domains mit den Sendeadressen (Empfänger prüfen den EHLO-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_IP einer pepsi-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) check dazu, 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_VERIFICATION ein Token für jede bediente Domain hat, dessen google-site-verification=-TXT-Eintrag run ausgibt und check als Google verification verifiziert), 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 der From:-Domain), sodass p=reject keine davon ablehnt; [UNALIGNED] unter Nennung der Quellen, die es nicht waren (Adresse, Nachrichtenzahl, Umschlagdomain, DKIM-d=, Melder) und die p=reject ablehnt (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öffentlichenden rua=. 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, dessen rua= 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 in rua= oder ruf= nennt, dort geprüft, wohin die Berichte gingen (Beschriftung DMARC report destination). Eine Zieldomain außerhalb der Organisation der Richtliniendomain muss einen v=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, ohne MX und ohne A/AAAA-Eintrag (oder mit einem Null-MX) ist [INVALID]: eine veraltete oder vertippte Adresse, deren Berichte (der Mailfluss der Domain und bei ruf= 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 und openpgpkey.domain, autoconfig.domain (mit eingeschaltetem [pepsi-autoconfig]) und mta-sts.domain (mit veröffentlichtem MTA-STS) für jede angenommene Domain. Jeder wird als https://name/ mit verifiziertem Zertifikat und ohne Folgen einer Umleitung abgerufen, und sein Strict-Transport-Security-Header wird beurteilt, wie ein Browser es täte (nur der erste Header zählt): [ok] mit einem gültigen max-age von mindestens sechs Monaten (15768000 Sekunden), [MISMATCH], wenn der Header fehlt, kürzer oder fehlerhaft ist (kein max-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). includeSubDomains und preload werden 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 the OPENPGPKEY and SMIMEA records, 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 --served for 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 its ca_id): [ok] when the operator limited it to named mail domains (pepsi-keys(1) ca scope) or its certificate carries nameConstraints of its own, [UNSCOPED] when nothing limits it, so that a signature from any address chaining to that CA reads valid. unscoped is 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_DOMAINS und die LOCAL_DOMAINS jeder Stage, Unteradresse bei [pepsi] RECIPIENT_DELIMITER abgetrennt) 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 Rolle pepsi-owner gelesen. 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/questions bedient. 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_task ohne 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-admin dies aus ihrem postinst aus.

Jeder Datensatz geht, nicht nur die pending. Nur ein pending-Datensatz kann je ausgeführt werden, und ein running-Datensatz ist definitionsgemäß verwaist, sodass es für die Sicherheit genügte, nur diese beiden zu löschen. Aber ein „Leeren“, das eine Konsole voller done- und refused-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. Die setup_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 -c FILE: Der Applier schreibt diese Datei und ihre secrets.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 -c gilt 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_HOME und $HOME heran, 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 (Standardwert http://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/accounts weigert sich, einen Geltungsbereich auszustellen, den der Aufrufer nicht selbst hält, sodass ein Token, das allein setup:write hält, keinen Administrator anlegen könnte; und da das Token verbraucht wird, bevor der Handler ablehnt, würde der Versuch es aufbrauchen. Das ausgegebene curl verlangt 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 über SO_PEERCRED identifiziert 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, etwa SENDER_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 sein ALLOW_ACTIONS vorenthä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 dem PROGRAM, das sie ausführt, mit entferntem pepsi-stage--Präfix (z. B. arc). Eine durchgezogene Kante folgt dem NEXT_STAGE jeder Stage und eine gestrichelte rote bounce-Kante ihrem BOUNCE_STAGE. Der Befehl liest nur die Konfiguration (keine DNS-, Schema- oder Dateisystemänderungen); leiten Sie ihn zum Rendern durch dot, 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 bei RECIPIENT_DELIMITER abgetrennt);

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

Rendert die Konfiguration aus einer Antwortmenge (denselben Antworten, die das Interview sammelt), prüft sie genau so, wie pepsi-setup run es 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-secret

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

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

Installiert 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 --reset auf einer Konsole.

provision-roles

Legt die Datenbank-Login-Rollen an und wendet ihre Berechtigungen erneut an.

generate-keys

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

Jetzt eine DKIM-Schlüsselrotation für eine Signierdomain beginnen (Parameter domain und ein optionales boolesches hard): Der Applier führt pepsi-dkim -c CONFIG rotate [--hard] DOMAIN als 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. Ohne hard erzeugt 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ält domain, hard und die output des Befehls fest.

run-preflight

Fü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-identity

Erzeugt einen vom Server verwalteten OpenPGP-Schlüssel (einen MTA-Schlüssel) für eine Adresse (Parameter address und ein optionales boolesches vks, dessen Standardwert [pepsi-keys] VKS_PUBLISH ist und das ein Hochladen auf einen Schlüsselserver anfordert). Die Adresse muss an einer Domain aus [pepsi-ingress] ACCEPTED_DOMAINS liegen, und ein KEY_WRAP_SECRET muss 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 Rolle pepsi-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-key

Registriert den eigenen öffentlichen Schlüssel des Benutzers (einen MUA-Schlüssel, custody = client) für eine Adresse (Parameter address und key, 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-identity

Widerruft eine lokale Identität (Parameter address, identity_id und ein optionaler einzeiliger reason von höchstens 1024 Bytes, der als Widerrufsgrund festgehalten wird). Die Identität muss zu address gehö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ält revocation_certificate, wkd_serves_revocation, key_server_upload_due und in published dieselben Sätze fest, die die E-Mail-Antwort auf retire trägt. Wird als die Rolle pepsi-crypto ausgefü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_id und mindestens eines von is_primary (nur true), published und vks_wanted, boolesch). Die Identität muss zu address gehören; ein Keyserver-Upload braucht eine aktive OpenPGP-Identität und veröffentlicht sie ebenfalls. Das sind die Änderungen, die ein Betreiber mit keys:write direkt über die administrative API vornimmt; ein Inhaber unter own:<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 in changed auf; ein Flag auf den Wert zu setzen, den es hat, gelingt. Auditiert als key.identity.update.

reset-otp

Entfernt 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 Rolle pepsi-crypto, der einzigen mit einer Berechtigung auf pepsi.otp_key. Das Entfernen eines nicht vorhandenen gelingt und sagt das.

confirm-enrolment

Prüft den Code des zweiten Faktors eines Inhabers für die Anmeldung per E-Mail an der Konsole (Parameter address und ein optionales otp) und ändert sonst nichts. pepsi-httpd(1) erstellt eine Browsersitzung mit own:<address> für jeden, der einem an die Adresse gesandten Link folgt, kann aber pepsi.otp_key nicht lesen; es reiht diese Aufgabe unter dem eigenen Geltungsbereich der Adresse ein und öffnet die Sitzung erst, wenn die Aufgabe mit done endet. Eine Adresse ohne zweiten Faktor besteht.

confirm-login

Prüft den Code des zweiten Faktors eines Administrators, der sich mit einem Passwort an der Konsole anmeldet (Parameter login und otp), und ändert sonst nichts. Ein Konsolenkonto mit einem TOTP-zweiten-Faktor (pepsi-keys otp enroll --console LOGIN) hält diesen in pepsi.otp_key unter dem Subjekt console <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 mit done endet. 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 von pepsi-config geschrieben worden sein, und der Aufgaben-Endpunkt der administrativen API lehnt sie ab.

identity-csr

Baut eine PKCS#10-Zertifikatsanforderung über den vorhandenen Schlüssel einer S/MIME-Identität (Parameter address, identity_id und ein optionaler einzeiliger display_name von höchstens 128 Bytes, das CN des Subjekts). Die Identität muss zu address gehö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 Rolle pepsi-crypto ausgefü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 als key.identity.csr.

identity-certificate

Installiert das Zertifikat, das eine CA für eine S/MIME-Identität ausgestellt hat (Parameter address, identity_id und certificate, 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), address in seinem rfc822Name nennt, ein Endentitätszertifikat ist, das emailProtection mit 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 abgesicherten UPDATE; 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 Rolle pepsi-crypto ausgeführt, weil die Neuverpackung die private Spalte schreibt. Auditiert als key.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 scopes setup:write enthalten, 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-csr und identity-certificate) ist der erforderliche Geltungsbereich stattdessen keys:write oder own:<address> für genau die in den Parametern der Aufgabe genannte Adresse: Ein Benutzer, der seinen eigenen Schlüssel verwaltet, konfiguriert nicht den Server, und setup:write allein genügt nicht. reset-otp ist allein dem Betreiber vorbehalten und akzeptiert own:<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; und

  • ihr written_by ist die Datenbankrolle pepsi-config, was beweist, dass der Datensatz die Tabelle über den einen Weg erreicht hat, den wir kontrollieren. Diese Spalte wird von einem BEFORE INSERT-Trigger aus current_user erzwungen, sodass sie eine Tatsache über die Verbindung statt einer Behauptung in der Nutzlast ist, und es gibt keine Schreibweise des INSERT, 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_QUOTA automatisch 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ßes pepsi-setup run sich wie pepsi-setup -c /etc/pepsi/pepsi.conf run verhält. Es meldet den Pfad nur dann als unbekannt, wenn an keinem Standardort eine Konfigurationsdatei existiert.

–no-certbot

Ruft certbot nicht 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 run wird 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=help listet 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, debug oder trace (Standardwert: info). Anders als die anderen Pepsi-Programme beachtet pepsi-setup [pepsi] LOG und LOG_JSON nicht: 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 --wizard gedachte 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.