25. Die Verwaltungskonsole¶
Pepsi liefert eine kleine Browser-Konsole aus, die pepsi-httpd unter /ui bedient. Sie existiert für die Dinge, die auf der Kommandozeile mühsam sind: die Warteschlange beobachten, Schlüssel und Korrespondenten durchsehen, das Prüfprotokoll lesen und die Konfiguration mit sichtbarer Validierung und Herkunft ändern.
Sie ist ein Client der dokumentierten administrativen API (Die administrative API) und nichts weiter. Jede Seite ruft dieselben Bibliotheksfunktionen auf, die die /api/v1-Endpunkte aufrufen, über dieselbe Authentifizierung, dieselben Geltungsbereichsprüfungen und dasselbe Prüfprotokoll. Alles, was die Konsole kann, lässt sich also auch mit curl tun, und die beiden können sich nicht darüber uneins sein, was die Warteschlange enthält oder ob ein Konfigurationswert gültig ist.
Bemerkung
In diesem Server gibt es zwei HTTP-APIs, und sie sind nicht dasselbe. /api/v1 ist Pepsis eigene (Die administrative API), deren Client diese Konsole ist: Konten, Scopes, Sitzungen und CSRF, über ADMIN = yes freigeschaltet. /3.0/ und /3.1/ sind die REST-API von GNU Mailman 3 (Die REST-API von GNU Mailman 3), nachgebaut, damit Mailman-Software gegen Pepsi läuft: ein gemeinsames Passwort, keine Scopes, die Formen eines anderen, über LIST_API = yes freigeschaltet. Ein Betreiber wird beiden begegnen; sie teilen den Server und nichts weiter, und keine ist eine Version der anderen.
25.1. Drei Listener-Flags, und bei zwei davon lautet der Rat entgegengesetzt¶
pepsi-httpd bietet vier Dinge an und schaltet drei davon frei, jedes über sein eigenes Flag in [pepsi-httpd-listener-*]. Diese zu verwechseln ist der mit Abstand einfachste Weg, Pepsis HTTP-Oberfläche falsch auszuliefern, daher stehen sie in einer Tabelle:
Flag |
Was es anbietet |
Für wen es ist |
Wohin es gehört |
|---|---|---|---|
|
|
Den Betreiber. Bearer-Token, Passwortsitzungen, |
Hinter einem Tunnel. Ein Unix-Socket oder Loopback mit einem Reverse-Proxy. |
|
|
Mailinglisten-Software ( |
Loopback oder TLS. Dieselbe Weigerung wie bei |
|
|
Die anonyme Öffentlichkeit. Überhaupt keine Zugangsdaten. |
Im offenen Internet. Dies ist die eine Oberfläche, die erreichbar sein soll, daher wird die Klartextbeschränkung absichtlich nicht angewandt. Aber ein Anmeldeformular trägt die Adresse eines Menschen, nehmen Sie also den TLS-Listener. |
(keines) |
MTA-STS, Web Key Directory, Mail-Autokonfiguration, das Portal für sichere Links, |
Jeden, der sie braucht, so entworfen. |
Wo auch immer der öffentliche Listener ist. |
Auf einem Listener ohne ihr Flag antwortet jede freigeschaltete Route mit einem einfachen 404, Byte für Byte dem, womit ein unbekannter Pfad antwortet. Deshalb veröffentlicht das Veröffentlichen des öffentlichen HTTPS-Listeners nicht die Verwaltung, und deshalb kann ein öffentlicher Listener nicht danach abgetastet werden, was dieser Server sonst betreibt.
25.2. Sie sicher erreichen¶
Die Konsole wird auf genau denselben Listenern eingehängt wie die API: denen mit dem Flag ADMIN = yes (siehe pepsi-httpd(1)). Auf jedem anderen Listener antworten die /ui-Pfade mit einem schlichten 404, Byte für Byte dem, was ein unbekannter Pfad antwortet, sodass den öffentlichen Listener zu veröffentlichen nicht die Konsole veröffentlicht und ein öffentlicher Listener nicht daraufhin abgetastet werden kann, ob die Verwaltung hier aktiviert ist.
pepsi-httpd weigert sich, sie auf einem gekennzeichneten Listener zu bedienen, der sie im Klartext von diesem Host wegtragen würde: Klartext-TCP wird nur auf einer Loopback-Adresse angenommen, während TLS-Listener und UNIX-Sockets stets in Frage kommen. Ein socket-aktivierter Listener (SERVE = systemd) ohne TLS kommt nie in Frage, was seine Unit auch bindet. Der übergebene Deskriptor könnte alles sein, und ihn als zulässig zu behandeln, ließe den strengsten Fall durch die lockerste Prüfung; geben Sie der Verwaltung also einen eigenen Listener. Dabei geht es nicht nur um Mithören. Das Sitzungs-Cookie trägt das __Host--Präfix (RFC 6265bis §4.1.3.2) nur dann, wenn es Secure gesetzt ist, also nur, wenn die Verbindung des Clients HTTPS ist, denn ein Browser weist ein __Host--Cookie zurück, das nicht Secure ist. Auf dem Klartext-Loopback-Bootstrap-Pfad wird keines von beidem verwendet, sodass die eigene Authentifizierung der Konsole auf einem Klartext-Origin konstruktionsbedingt schwächer ist. Ein Browser kann keinen UNIX-Socket öffnen, sodass eine typische Installation entweder
einen administrativen Listener an
127.0.0.1bindet und ihn über einen SSH-Tunnel erreicht (ssh -L 8443:127.0.0.1:8443 mail.example.com), oderdem administrativen Listener TLS und einen eigenen Namen gibt und ihn wie jede andere ins Internet gerichtete Verwaltungsoberfläche behandelt.
25.3. Anmelden¶
Zwei der drei Mechanismen der API sind aus einem Browser heraus nützlich:
Ein lokaler Betreiber über den administrativen UNIX-Socket wird über SO_PEERCRED identifiziert und braucht überhaupt kein Passwort. Browser können nicht mit einem UNIX-Socket sprechen, sodass dieser Weg für curl und für den Bootstrap beim ersten Lauf gedacht ist; er ist auch der Grund, warum die strenge Sitzungsrichtlinie unten erschwinglich ist.
Ein entfernter Administrator meldet sich unter /ui/login mit einem Konto aus pepsi.admin_account an (legen Sie eines mit POST /api/v1/accounts an). Sitzungen haben ein Leerlauf-Timeout von 30 Minuten und eine harte Lebensdauer von 12 Stunden unabhängig von Aktivität, und es gibt kein „angemeldet bleiben“. Diese Konsole kann einen Schlüssel widerrufen, lesen, wer mit wem korrespondiert, und die Pipeline umschreiben; ein vergessener Browser-Tab sollte diese Macht morgen nicht mehr haben, und ein gestohlener Laptop sollte keine dauerhafte administrative Sitzung sein.
Bearer-Tokens funktionieren ebenfalls, aber ein Browser hat keine Möglichkeit, eines anzuhängen; sie sind für Automatisierung gegen /api/v1.
Eine Passwortprüfung ist Argon2id und läuft außerhalb des Request-Executors, mit höchstens einer Verifikation pro CPU gleichzeitig; eine Anmeldung, die innerhalb von fünf Sekunden keinen freien Platz findet, wird als ratenbegrenzt beantwortet ([pepsi-admin] LOGIN_RATE_LIMIT begrenzt zusätzlich die Versuche pro Konto und pro Quelladresse, und LOGIN_DAILY_LIMIT begrenzt die fehlgeschlagenen Anmeldungen pro Konto und Tag). Ein Konto mit zweitem Faktor (pepsi-keys otp enroll --console LOGIN) braucht außerdem den aktuellen sechsstelligen Code im Code-Feld des Formulars, den der Setup-Applier prüft, bevor die Sitzung eröffnet wird; ein fehlender oder falscher Code wird genau wie ein falsches Passwort beantwortet. Ein unbekanntes Konto wird gegen einen Dummy-Hash geprüft, sodass das Zeitverhalten der Antwort nicht verrät, welche Konten existieren. Was ein erratenes oder gestohlenes Passwort einem Angreifer einbringt, steht in Ein delegierter Administrator.
25.3.1. Sicherheitsschlüssel¶
Ein Konsolenkonto (und ein Endbenutzer, der sich per E-Mail anmeldet, siehe unten) kann Sicherheitsschlüssel als zweiten Faktor neben dem TOTP-Code registrieren. Sicherheitsschlüssel sind WebAuthn-Zugangsdaten: ein Hardware-Schlüssel, ein Telefon oder der Plattform-Authenticator eines Laptops. Jeder einzelne registrierte Schlüssel schließt eine Anmeldung ab, ebenso der TOTP-Code, sofern das Konto einen hat und der Betreiber keine Schlüssel verlangt. Ein Schlüssel ersetzt nie das Passwort.
Was ein Schlüssel gegenüber einem Code hinzufügt, ist Widerstandsfähigkeit gegen Phishing. Ein TOTP-Code ist ein Geheimnis, das der Benutzer eintippt, und eine überzeugend nachgemachte Seite kann ihn erfragen und innerhalb seiner dreißig Sekunden an die echte Konsole weiterreichen. Ein Schlüssel signiert den echten Ursprung (Origin) der Seite und den Namen dieses Servers, beide vom Browser geliefert und nicht von der Seite, sodass eine auf einer nachgemachten Seite erlangte Antwort hier nicht verifiziert (Ein Phishing-Proxy (Angreifer in der Mitte)).
Registrieren. Öffnen Sie angemeldet Sicherheitsschlüssel (/ui/security, verlinkt neben der Abmelde-Schaltfläche), benennen Sie den Schlüssel, geben Sie das Passwort des Kontos ein und drücken Sie Sicherheitsschlüssel registrieren; der Browser fragt nach dem Schlüssel. Ein Konto, das bereits einen Schlüssel hat, fügt einen weiteren in zwei Schritten hinzu: das Passwort und Mit Sicherheitsschlüssel bestätigen (einer der vorhandenen Schlüssel, oder der TOTP-Code, wo er ersatzweise gelten darf), danach die Registrierung des neuen Schlüssels auf der folgenden Seite. Ein gestohlenes Sitzungscookie kann daher nicht den Schlüssel des Diebes hinzufügen. Ab der nächsten Anmeldung führt ein korrektes Passwort zu einer zweiten Seite, die nach einem der Schlüssel fragt (oder das Code-Feld anbietet, wo TOTP ersatzweise gelten darf).
Das Entfernen eines Schlüssels braucht das Passwort und eine Bestätigung mit einem der Schlüssel des Kontos (der zu entfernende ist zulässig) oder den TOTP-Code des Kontos; ein gestohlenes Sitzungscookie kann den Schlüssel daher weder gegen den des Diebes austauschen noch ihn entfernen. Die Wiederherstellung durch den Betreiber bei einem verlorenen Schlüssel ist DELETE /api/v1/accounts/{id}/webauthn (das auch die Sitzungen des Kontos beendet), das Gegenstück zu pepsi-keys otp reset --console.
Schlüssel verlangen. [pepsi-httpd] REQUIRE_WEBAUTHN = admins (oder users, members, all) macht einen Schlüssel zum einzigen zweiten Faktor dieser Art von Konto: Der TOTP-Code schließt keine Anmeldung mehr ab, ein Konto ohne Schlüssel wird als letzter Schritt seiner nächsten Anmeldung durch die Registrierung eines Schlüssels geführt, und sein letzter Schlüssel kann nicht entfernt werden. Der Standardwert ist no.
Schlüssel sind an [pepsi-admin] CONSOLE_URL gebunden (Standard ENROL_URL), den öffentlichen https://-Ursprung, unter dem die Konsole erreichbar ist; ohne eine der beiden Optionen bietet die Konsole keine Schlüssel an. Ein Schlüssel signiert für den Host, bei dem er registriert wurde, sodass ein Wechsel des Hosts die registrierten Schlüssel unbrauchbar macht. Wählen Sie einen Namen, den die Benutzer behalten werden. Pepsi verlangt keine Attestierung (es beurteilt keine Authenticator-Modelle) und akzeptiert ES256- und Ed25519-Schlüssel; der Mechanismus steht in Sicherheitsschlüssel (WebAuthn).
25.4. Was die Konsole kann und was nicht¶
Die Aktionen sind nur auf Nachrichten- und Schlüsselebene:
eine steckengebliebene Nachricht an ihrer aktuellen Stage wieder einreihen, sie zu einer Bounce-Stage routen oder sie ohne Zustellung löschen;
eine Nachricht freigeben oder löschen, die eine Quarantäne-Stage zurückhält (Quarantäne);
einen Client, eine Domain oder einen Absender für das Greylisting zulassen oder abweisen und eine solche Regel entfernen (Greylisting);
eine lokale Identität veröffentlichen oder zurückziehen, eine zur primären machen, sie löschen oder ihr Hochladen auf den Schlüsselserver anfordern;
den Applier um einen servergeführten Schlüssel bitten, darum, den eigenen öffentlichen Schlüssel eines Benutzers zu registrieren, eine Identität zu widerrufen, eine Zertifikatsanforderung über den Schlüssel einer S/MIME-Identität zu erstellen oder das Zertifikat zu installieren, das eine CA daraus ausgestellt hat (alle fünf über den privilegierten Applier, siehe unten);
den Schlüssel eines Korrespondenzpartners von Hand importieren, eine Discovery-Abfrage einreihen, einen zwischengespeicherten Korrespondentenschlüssel erneut prüfen (ihn ablaufen lassen und eine erzwungene Abfrage einreihen) und einen vergessen; einen Vertrauensanker hinzufügen, seinen Geltungsbereich setzen oder aufheben (die Mail-Domains, für die ihm vertraut wird; ein Anker, der für jede Domain bürgt, wird markiert) und einen entfernen. Jedes Formular ruft dieselbe Funktion auf wie sein API-Endpunkt (
POST /api/v1/peers,.../discover,.../{id}/recheck,POST /api/v1/ca-trust,PUT /api/v1/ca-trust/{id}/scope), sodass die Konsole nichts annehmen kann, was die API ablehnt: einen Blob, der kein Schlüssel ist, einen Schlüssel, der eine andere Adresse nennt, ein Zertifikat, das nicht das einer CA ist. Ein domainweiter*@domain-Schlüssel bleibt Sache von pepsi-keys(1);eine Secure-Link-Nachricht widerrufen;
die Managed PKI einer Domain konfigurieren und ihre Benutzer bearbeiten: einen Namen freigeben oder korrigieren, einen Benutzer auswählen, einen abwählen oder löschen (Verwaltete Zertifikate); die Bestellungen selbst und die Zugangsdaten der CA bleiben bei
pepsi-keys mpki;eine Konfigurationsüberschreibung setzen oder entfernen;
das Setup-Interview beantworten und den privilegierten Applier bitten, certbot auszuführen, das Schema zu installieren, Rollen einzurichten, DNS zu prüfen oder die DKIM-Schlüssel einer Domain zu rotieren.
Es gibt bewusst keinen Neustart-, keinen Abschalt- und keinen Sicherungsknopf. Eine Web-Konsole, die den Mailserver anhalten kann, ist eine, die dazu überlistet werden kann, den Mailserver anzuhalten, und systemd besitzt diese Aufgabe bereits. Starten Sie eine Komponente mit systemctl restart pepsi-ingress neu (die Konfigurationsseiten nennen die Unit, wenn eine Änderung eine braucht).
Alles Privilegierte hier hat diese Form: Die Konsole hält fest, was geschehen soll, und ein separates root-Programm tut es. Die Konsole kann /etc nicht schreiben, certbot nicht ausführen und keine Datenbankrolle anlegen, und darf das auch nicht können. Wir tun das, damit ein Fehler in der Anfragebehandlung nicht zur Befehlsausführung als root werden kann (siehe Befehlsinjektion und XXE in Verwaltungsoberflächen von Mail-Gateways). Siehe „Setup im Browser“ unten.
Zwei weitere Dinge, die die Konsole nicht kann, weil der Server es nicht kann:
Schlüsselmaterial selbst erzeugen oder widerrufen. Das erfordert die Datenbankrolle
pepsi-crypto, die das Recht auf die private Spalte hält und die pepsi-httpd bewusst nicht hält. Eine Web-Schicht, die Signaturschlüssel erzeugen kann, ist eine Web-Schicht, deren Kompromittierung Signaturschlüssel erzeugt. Das Formular Servergeführten Schlüssel erzeugen der Identitätsseite bittet daher nur: Es reiht einegenerate-identity-Aufgabe ein, diepepsi-setup applyerneut validiert und alspepsi-cryptoausführt. Eigenen Schlüssel registrieren (einen ASCII-armierten öffentlichen OpenPGP-Schlüssel einfügen) reiht auf dieselbe Weiseregister-client-keyein, und der Knopf Widerrufen einer Identität reiht nach Bestätigungrevoke-identityein, denn das Widerrufen eines reinen Signaturschlüssels vernichtet dessen privaten Teil, und das ist ein Schreibzugriff auf diese Spalte. Jedes antwortet mit der eigenen Seite der eingereihten Aufgabe,/ui/setup/tasks/<id>, die der anfragende Benutzer unabhängig von seinen Geltungsbereichen öffnen darf. Diese Seite zeigt das Ergebnis (erledigt, mit Grund fehlgeschlagen oder abgewiesen), sobald der Applier es festhält. Alle drei antworten mit503, wenn das Applier-Paket nicht installiert ist. Jedes Formular hat außerdem ein Feld Code des zweiten Faktors: Ein Benutzer, der einen zweiten Faktor eingerichtet hat (Schlüsselverwaltung), gibt dort den aktuellen Code aus seiner Authenticator-App ein, und der Applier prüft ihn, weil die Konsole das nicht kann. Die Seite einer S/MIME-Identität bietet zusätzlich Zertifikat anfordern (PKCS#10) und Ausgestelltes Zertifikat installieren, die auf dieselbe Weiseidentity-csrundidentity-certificateeinreihen: Die Anforderung wird mit dem privaten Schlüssel der Identität signiert, und die Installation verpackt ihn neu. Die Aufgabenseite zeigt die PEM-Anforderung für sich, bereit für die CA, sowie das Ergebnis der Installation oder den Grund, warum die Installation abgewiesen wurde (ein Zertifikat über einen anderen Schlüssel, für eine andere Adresse, ein CA-Zertifikat, die falsche Schlüsselverwendung).Die Konfigurations-Überlagerung schreiben, sofern
[pepsi-admin] CONFIG_DBnicht eine Verbindung benennt, die sich als Rollepepsi-configauthentifiziert. Ohne sie sind die Konfigurationsseiten nur lesend und sagen warum.
Die Konsole zeigt auch nie die Header oder den Nachrichtentext einer Nachricht. Die Warteschlangenseiten laden den Umschlag, die Stage, den Status und das state-JSON, und sonst nichts. Das ist strukturell so: Die Abfrage dahinter wählt diese Spalten nicht aus. Mail zu lesen ist keine administrative Funktion.
25.5. Die Seiten¶
Pfad |
Geltungsbereich |
Was sie zeigt |
|---|---|---|
|
|
Dashboard: Warteschlangentiefe nach |
|
|
Filterbare Auflistung (nach Stage und Status), paginiert, mit einer per Opt-in eingeschalteten 30-Sekunden-Aktualisierung. |
|
|
Eine Nachricht: Umschlag, Stage, Status und formatiertes |
|
|
Die Nachrichten, die eine Quarantäne-Stage zurückhält, älteste zuerst, jeweils mit dem, der sie dorthin geschickt hat, und dem Grund (Quarantäne). |
|
|
Eine zurückgehaltene Nachricht: Umschlag, |
|
|
Die Greylisting-Entscheidungen der letzten 24 Stunden, die jüngsten Tripel (filterbar nach Zustand, Domain, Client und Empfänger) und die Regeln. Die Formulare zum Zulassen, Abweisen und Entfernen brauchen |
|
|
Die Mail, die das Greylisting an die eigene Adresse des Benutzers zurückgestellt hat, mit Diesen Absender zulassen (Greylisting). |
|
|
Lokale Schlüsselpaare, filterbar nach Adresse, mit den Formularen Servergeführten Schlüssel erzeugen und Eigenen Schlüssel registrieren ( |
|
|
Eine Identität, mit ihrer Verwahrung (servergeführt oder der eigene Schlüssel des Benutzers) und ihrem Schlüsselserver-Zustand, sowie Veröffentlichen / Zurückziehen / Auf den Schlüsselserver hochladen / Zur primären machen / Widerrufen ( |
|
|
Zwischengespeicherte Korrespondentenschlüssel: Quelle, DNSSEC-Kennzeichen, Gültigkeit, Pin-Zustand. Mit |
|
|
Die S/MIME-Vertrauensanker und ihre Geltungsbereiche; einen hinzuzufügen ( |
|
|
Die Domains, deren S/MIME-Zertifikate bei einer CA bestellt werden: ob jede eingeschaltet ist, ihr Aufnahmemodus und die Zahl ihrer Benutzer; eine Domain hinzuzufügen ( |
|
|
Eine Domain: ihre Einstellungen, ihre Benutzer mit ihrer neuesten Bestellung und dem, worauf diese wartet, und ihre letzten Bestellungen. Das Speichern der Einstellungen, das Hinzufügen eines Benutzers ( |
|
|
Die bei der CA aufgegebenen Bestellungen, die neuesten zuerst, filterbar nach Domain und Adresse oder auf offene Bestellungen. |
|
|
Die Hinweise für Administratoren oder nur die ungelesenen (die Glocke im Seitenkopf verlinkt hierher). Sie als gelesen zu markieren ( |
|
|
Jeder Abschnitt der effektiven Konfiguration für einen Geltungsbereich, samt der Angabe, wie eine Änderung wirksam wird. |
|
|
Ein Abschnitt: der Wert jeder Option, woher er stammt (Datei, global, Domain, Adresse), und die Formulare zum Setzen oder Entfernen einer Überschreibung ( |
|
|
Das Prüfprotokoll, filterbar nach Art und Akteur. |
|
|
Das optionale Protokoll pro Nachricht, filterbar nach Adresse; sagt es deutlich, wenn |
|
|
Ergebnisse ausgehender TLS-Sitzungen je Richtliniendomain. |
|
|
MX-Adressen, die der Resolver-Cache derzeit als fehlschlagend markiert. |
|
|
Die Quellen der DMARC-Aggregatberichte, die andere Empfänger über die bedienten Domains gesendet haben ( |
|
|
Die bedienten Domains, der MTA-STS-Modus, wie viele Identitäten unter jeder veröffentlicht sind, und die zu veröffentlichenden DNS-Einträge mit dem letzten Live-Urteil für jeden. Der Knopf „DNS jetzt prüfen“ braucht |
|
|
Secure-Link-Nachrichten, die das Portal hält: Korrespondenten, Ablauf, Lesevorgänge, falsche PINs, Sperren. Das Widerrufen braucht |
|
|
Eine Nachricht mit ihrer Zugriffshistorie. |
|
|
Der Einstiegspunkt des Setup-Interviews; jeder Schritt ist |
|
|
Was vom privilegierten Applier verlangt wurde, und ein Formular, um mehr zu verlangen. Ohne |
|
|
Eine Aktion mit dem gestreamten Fortschritt des Appliers, aktualisiert, sobald der Applier etwas schreibt. |
Keine Seite lädt eine unbegrenzte Ergebnismenge: Jede Auflistung läuft über eine Abfrage, die ihr eigenes LIMIT/OFFSET trägt, sodass das eine Eigenschaft des SQL ist statt dessen, was der Renderer zeichnet. Die Warteschlangen- und die Journalansichten paginieren mit ?limit=/?offset= (gekappt auf [pepsi-admin] PAGE_LIMIT, höchstens 1000). Die Schlüsselspeicher-Auflistungen (Identitäten, Korrespondenten, Vertrauensanker) holen den Umfang einer Seite plus einen Datensatz, um zu erfahren, ob es mehr gibt, und sagen klar, wenn sie gekürzt wurden; engen Sie sie mit dem Adressfilter ein oder verwenden Sie pepsi-keys(1). Die Konsole fragt nur dort nach einem COUNT(*), wo sie eine Gesamtzahl zeigt (die beiden Journalansichten); die API tut es immer, weil ihre Clients programmatisch blättern. Siehe Die administrative API.
Jede zerstörerische Aktion geht zuerst über eine ausdrückliche Bestätigungsseite: eine eingereihte Nachricht löschen, eine Nachricht in Quarantäne freigeben oder löschen, eine Identität widerrufen oder löschen, einen Vertrauensanker entfernen, eine Konfigurationsüberschreibung oder eine Greylisting-Regel entfernen und einen Benutzer der Managed PKI abwählen oder löschen, was seine Zertifikate widerruft. Jede Änderung wird mit derselben Ereignisart in das Prüfprotokoll geschrieben, die die API festhält, sodass /ui/logs Änderungen zeigt, die aus der Konsole, aus curl und aus den Kommandozeilenwerkzeugen gleichermaßen vorgenommen wurden.
Konfigurationswerte, die ein Geheimnis tragen könnten, werden als *** gezeigt, nie als Werte, nach derselben Regel, die auch die API verwendet. Die Liste ist bewusst großzügig: Ein fälschlich maskierter Wert kostet einen Betreiber einen Blick in die Datei, ein fälschlich gezeigter Wert dagegen wird an jeden veröffentlicht, der config:read hält.
25.5.1. Setup im Browser¶
/ui/setup rendert dasselbe Interview, das pepsi-setup --wizard an einem Terminal stellt. Es ist buchstäblich dasselbe, denn die Fragen, ihre Formen, ihre Standardwerte und die Bedingungen, unter denen sie gestellt werden, liegen als Daten an einer Stelle (pepsi-setup-model), und beide Front-Ends rendern sie. Eine Frage, die dem einen hinzugefügt wird, ist eine Frage, die beiden hinzugefügt wird.
Zwei getrennte Mechanismen halten es sicher:
Antworten sind Entwürfe. Jeder Schritt schreibt in pepsi.config_override mit dem draft-Flag, das jeder Konfigurationsleser strukturell herausfiltert. Nichts wird wirksam, solange das Interview läuft, sodass eine Sitzung, die auf halbem Weg abläuft, keinen Mailserver halb konfiguriert hat, und das erneute Öffnen der Seite dort weitermacht, wo es aufgehört hat. Ein Schritt mit einer schlechten Antwort rendert neu, mit der Meldung neben dem Formularfeld, und speichert nichts, nicht einmal die guten Antworten auf derselben Seite, denn ein halb gespeicherter Schritt ist einer, den ein Betreiber aus dem Gedächtnis rekonstruieren muss.
Aktionen sind Absichten. /ui/setup/tasks zeigt, was vom privilegierten Applier verlangt wurde, und bietet ein Formular, um mehr zu verlangen, aus seiner geschlossenen Menge: run-preflight, obtain-certificate, install-schema, provision-roles. Die Menge ist geschlossen, damit die Türklingel kein allgemeiner Kanal für root-Befehle ist (siehe Mail-Appliances speichern Geheimnisse für alle lesbar oder ungeschützt). Ein Knopf schreibt einen pepsi.setup_task-Datensatz und betätigt eine Türklingel; pepsi-setup apply, als root laufend, erledigt die Arbeit und streamt seinen Fortschritt zurück in den Datensatz, den /ui/setup/tasks/<id> anzeigt. Während die Aufgabe läuft, lädt sich die Seite selbst neu (ein <meta http-equiv="refresh">, kein Timer in einem Skript), und das Neuladen fragt nicht ständig ab: Es fordert die Seite erneut an, zusammen mit dem, was sie bereits gezeigt hat, und der Server hält diese Anfrage bis zu 20 Sekunden lang zurück, bis die Benachrichtigung des Appliers meldet, dass es eine neue Fortschrittszeile oder ein Ergebnis gibt. Das Ergebnis erscheint daher in dem Moment, in dem es existiert. Hat der Server seine Listener-Verbindung zur Datenbank verloren, antwortet er sofort, und die Seite lädt sich ersatzweise alle fünf Sekunden neu. Es gibt keine Neustart- oder Abschaltaktion; eine Änderung, die einen Komponentenneustart braucht, endet damit, dass Sie ihn ausführen.
Beide benötigen setup:write, auch die Lesezugriffe: Die vorgemerkten Antworten sind die Gestalt einer im Aufbau befindlichen Installation, und die Aufgabenliste ist ein Protokoll privilegierter Arbeit. Die eine Ausnahme sind die eigenen Anfragen eines Benutzers: Die Schlüsselaktionen auf den Identitätsseiten reihen ebenfalls Aufgaben ein, und wer eine eingereiht hat, darf sie öffnen und in /ui/setup/tasks finden, das für ihn nichts anderes auflistet. Die Aufgabe eines anderen ist „nicht gefunden“.
Zwei voneinander unabhängige Dinge müssen gegeben sein, bevor etwas gespeichert werden kann, und die Seite sagt Ihnen, welches davon fehlt:
Der privilegierte Applier muss vorhanden sein: das eigene Debian-Paket
pepsi-httpd-admin, daspepsi-setup-apply.socketund dessen Service enthält. Es ist einRecommends, wird also standardmäßig installiert und kann entfernt werden, ohne Pepsi mitzunehmen; und[pepsi-admin] CONFIG_DBmuss eine Verbindung benennen, die sich als Rollepepsi-configauthentifiziert, denn der Applier lehnt jeden Datensatz ab, der nicht von ihr geschrieben wurde.
Der Applier wird zuerst geprüft, denn ohne Applier würde es nicht helfen, CONFIG_DB einzurichten. Fehlt eines von beiden, stuft sich das Interview auf Nur-Lesen zurück, statt Antworten zu speichern, die niemand anwenden wird: Jeder Wert wird weiterhin dargestellt, die Eingabefelder kommen disabled/readonly zurück, der Speichern-Knopf ist verschwunden, und eine Einblendung benennt den Grund. Die entsprechenden API-Aufrufe antworten mit 503 setup_applier_unavailable oder 503 setup_write_unavailable (siehe Die administrative API). Die eine bewusste Ausnahme ist das Verwerfen eines Entwurfs: Das kann keine privilegierte Änderung auslösen, und ein festgefahrenes Interview muss löschbar bleiben.
Beachten Sie, dass die /ui/config-Seiten von einem fehlenden Applier nicht betroffen sind: Sie schreiben nach pepsi.config_override, eine Datenbanktabelle, nicht nach /etc. Sie brauchen CONFIG_DB und sonst nichts.
Eine Antwort in password-Form wird jedes Mal leer gerendert, nie in ein value=-Attribut zurückgespiegelt, und den Schritt mit leerem Formularfeld abzuschicken lässt das Gespeicherte unangetastet. Der Prüfprotokolleintrag für einen Schritt nennt die Fragen-Bezeichner und überhaupt keine Werte.
25.5.2. Secure Links¶
/ui/secure listet die Nachrichten auf, die das Secure-Link-Portal für Empfänger ohne Schlüssel hält: von wem und für wen sie sind, wann sie ablaufen, wie oft die PIN richtig und falsch eingegeben wurde und ob eine Sperre gilt. /ui/secure/<token> ergänzt das Zugriffsprotokoll.
Die Nachricht selbst steht auf keiner der beiden Seiten und kann es nicht. pepsi-httpd ist das Portal, es ist also die eine Datenbankrolle, der die Chiffratspalte gewährt ist. Genau deshalb lesen die Betreiberseiten sie nicht. Die Abfragen dahinter benennen jede Spalte außer dieser einen und melden nur ihre Länge, sodass die Disziplin im SQL liegt statt in einem Struct-Feld, das jemand daran gedacht hat wegzulassen. Widerrufen zerstört die einzige Kopie der Nachricht und braucht daher secure:write, eine von secure:read getrennte Fähigkeit.
25.5.3. DNS auf der Domains-Seite¶
/ui/domains zeigt neben jeder bedienten Domain jeden DNS-Eintrag, den Pepsi von ihr erwartet: den Namen, den zu veröffentlichenden Wert, ob das Live-DNS ihn führt, und was zu tun ist, wenn nicht. Der Zonentext am Fuß der Seite ist derselbe Block, den pepsi-setup run ausgibt.
Das Urteil kommt vom Applier, nicht von diesem Server: Herauszufinden, was veröffentlicht werden sollte, heißt die validierte Konfiguration und den Status des DKIM-Signierdaemons zu lesen, und es zu vergleichen heißt DNS abzufragen. Die Seite zeigt daher stets, wann die Antwort berechnet wurde, und „DNS jetzt prüfen“ (setup:write) bittet um eine frische, statt die Anfrage an einem Resolver zu blockieren.
25.5.4. DKIM-Schlüssel¶
/ui/dkim (keys:read, verlinkt von der Domain-Seite aus; einem auf Adressen beschränkten Prinzipal verweigert) zeigt, was der Signierdaemon pepsi-dkim(1) in seiner öffentlichen Statusdatei meldet, dasselbe Dokument, mit dem GET /api/v1/keys/dkim antwortet: ob die Rotation eingeschaltet ist, und pro signierender Domain jeden Schlüssel mit Selektor, Algorithmus, RSA-Größe, Zustand (next, current, retiring, retired), TXT-Record und ob jeder autoritative Server ihn ausliefert, die ausstehenden DNS-Änderungen (hinzuzufügende Records, Records, die entfallen können) und eine Rotation, die auf DNS wartet. Eine Domain ohne aktuellen Schlüssel wird markiert. Die Seite weist darauf hin, wenn der Daemon seinen Status noch nicht geschrieben hat.
Dieser Server hält oder liest nie einen DKIM-Schlüssel. Die Schaltflächen Jetzt rotieren (weich: umschalten, sobald die Records des nächsten Schlüssels sichtbar sind; hart: sofort umschalten) bitten nur: Jede reiht eine dkim-rotate-Aufgabe ein, die pepsi-setup apply ausführt, indem es pepsi-dkim rotate als root startet, da der Daemon administrative Anfragen nur von root und seinem eigenen Konto annimmt. Sie brauchen setup:write und einen laufenden Applier und werden nur dort angezeigt, wo beides gegeben ist.
25.5.5. Verwaltete Zertifikate¶
Die Seiten Zertifikate zeigen und ändern die Managed PKI: die Domains, deren Benutzer S/MIME-Zertifikate von einer CA erhalten (Zertifikate einer kommerziellen CA: die Managed PKI). Lesen braucht keys:read. Jede Änderung braucht keys:write: die Einstellungen, eine Domain hinzufügen, einen Benutzer hinzufügen, einen Namen korrigieren oder freigeben, einen Benutzer auswählen, einen abwählen oder löschen und Hinweise als gelesen markieren. Diese Einstellungen entscheiden, was die CA der Organisation in Rechnung stellt und wessen Namen ein Zertifikat trägt; deshalb brauchen sie den Geltungsbereich, der Schlüssel ändert. Ein auf eine Adresse beschränkter (own:) Prinzipal sieht nichts davon: keinen Link, keine Glocke, und jede Seite und jedes Formular wird ihm verweigert, da die Einstellungen und die Benutzerliste zur Installation gehören, nicht zu einer Adresse.
/ui/mpki listet die verwalteten Domains auf und hat das Formular, das eine hinzufügt. Eine neue Domain beginnt ausgeschaltet, mit den Standardwerten, und der Browser geht weiter zu ihrer Seite. /ui/mpki/domains/<domain> hat drei Teile:
Einstellungen: der Schalter, wer ein Zertifikat erhält (der Aufnahmemodus), was mit Namen aus dem Header
From:geschieht, ein oder zwei Zertifikate je Benutzer, der Schlüsselalgorithmus, die Gültigkeit, das Erneuerungsfenster, das Tageslimit, die Benachrichtigungsadresse sowie Produkt, Organisations-ID und API-URL der CA. Sie zu speichern ist dieselbe Änderung wiepepsi-keys mpki domain set.Benutzer: eine Zeile je Benutzer mit dem Namen, seiner Herkunft, ob er bestätigt ist, der Auswahl, ob der Benutzer ein Zertifikat erhält, der neuesten Bestellung, worauf sie wartet, und ihrem letzten Fehler. Je Benutzer bestätigt Namen freigeben den Namen so, wie er ist, Namen speichern korrigiert ihn (was ihn ebenfalls bestätigt), Immer aufnehmen und Die Domain entscheiden lassen setzen die Auswahl, und Abwählen und Benutzer löschen widerrufen die Zertifikate des Benutzers beim nächsten Lauf des Bestellauftrags. Diese beiden gehen zuerst über eine Bestätigungsseite, da sich ein widerrufenes Zertifikat nicht zurückholen lässt. Benutzer hinzufügen legt einen Benutzer unter dem Namen an, den der Administrator eintippt, und bestätigt ihn damit.
Bestellungen: die zwanzig neuesten Bestellungen der Domain, mit einem Link zu
/ui/mpki/orders, das alle auflistet und nach Adresse oder auf offene Bestellungen filtert.
/ui/mpki/notices listet die Hinweise auf, die der Bestellauftrag schreibt (eine Bestellung wurde eingereicht, installiert, mit ihrem Grund zurückgehalten, ist fehlgeschlagen oder wurde widerrufen), mit Als gelesen markieren je Hinweis und Alle als gelesen markieren. Ein als gelesen markierter Hinweis ist für jeden Administrator gelesen, und die Konsole hält fest, wer ihn markiert hat. Für einen Prinzipal mit keys:read trägt der Seitenkopf eine Glocke, Hinweise, mit der Zahl der ungelesenen Hinweise; sie kostet eine Zählung je Seitenaufruf, und schlägt die Zählung fehl, fehlt nur die Glocke, nie die Seite.
Die Konsole spricht nie mit der CA und sieht oder setzt nie die CA-Zugangsdaten, eine Datei, die nur pepsi-keys mpki credential set schreibt und die pepsi-httpd nicht lesen kann. Sie kann auch nicht auf eine Bestellung einwirken: Bestellungen freigeben, wiederholen und stornieren sind Befehle von pepsi-keys mpki order, weil pepsi-httpd keine Berechtigung hat, mpki_order zu schreiben. Die Formulare rufen dieselben Funktionen auf wie /api/v1/mpki (Die administrative API), sodass die Konsole annimmt und ablehnt, was auch die API annimmt und ablehnt, und beide erfassen im Prüfprotokoll dieselben Ereignisarten wie die Kommandozeile (mpki.domain.set, mpki.user.add, mpki.user.set, mpki.user.delete; eine Abwahl oder Löschung mit warning), dazu mpki.notice.read.
25.5.6. Quarantäne¶
/ui/quarantine listet die Nachrichten auf, die eine pepsi-stage-quarantine(1)-Stage zurückhält, wie es pepsi-queue quarantine list tut: das Token, die Stage, wann die Nachricht eintraf und seit wann sie zurückgehalten wird, ihren Umschlag sowie by und reason ihres Quarantäne-Eintrags (milter:<name> bei einem Filter). Die Seite einer Nachricht fügt das From: und das Subject: hinzu, die Ingress mit dem Umschlag gespeichert hat, sowie das Ende des Zurückhaltens (MAX_HOLD). Wie die Warteschlangenseiten zeigen diese Seiten nie die Header oder den Nachrichtentext einer Nachricht: pepsi-httpd kann sie nicht lesen. Sehen Sie sich den Inhalt auf dem Server mit pepsi-queue --headers --body an.
Mit queue:write bietet die Seite Freigeben und Ohne Zustellung löschen an, jeweils hinter einer Bestätigungsseite, da eine freigegebene Nachricht zugestellt wird und eine gelöschte verloren ist. Freigeben gibt die Nachricht an ihre Quarantäne-Stage zurück, die sie an ihre RELEASE_STAGE weiterschickt; es läuft nicht über workqueue_resume, das zurückgehaltene Mail ablehnt. Eine Löschung wird im optionalen Mail-Protokoll festgehalten. Beide rufen die Funktionen von pepsi-queue quarantine auf und halten dessen Ereignisarten im Prüfprotokoll fest (queue.quarantine-release, queue.quarantine-delete). Wenn keine Stage pepsi-stage-quarantine ausführt, sagt die Seite, dass nichts zurückgehalten werden kann.
25.5.7. Greylisting¶
Wo pepsi-greylist(1) läuft, enthält die Navigation Greylisting (logs:read) für einen Betreiber und Zurückgestellte Mail für einen Benutzer, der für seine eigene Adresse angemeldet ist. Der Server entscheidet einmal, beim Start, ob die Installation Greylisting betreibt: ein Abschnitt [pepsi-greylist] oder ein Ingress-Milter-Abschnitt, der den Socket des Daemons nennt.
/ui/greylist zeigt die Entscheidungen der letzten 24 Stunden nach Ergebnis, wie pepsi-greylist stats sie zählt (aus den stündlichen Zählern des Daemons, sodass die Seite die Tripel nicht durchsucht), die jüngsten Tripel und die Regeln. Die Tripel lassen sich nach Zustand (wartet auf einen erneuten Versuch, durchgelassen, nur einmal versucht), nach Domain, nach Client-Adresse oder -Netz und nach Empfänger filtern. Mit config:write hat jedes Tripel ein Regelformular: Wählen Sie seinen Absender, die Domain des Clients oder die des Absenders oder das Netz oder die Adresse des Clients, und dann Zulassen oder Abweisen. Ein weiteres Formular fügt eine beliebige Regel mit einer Anmerkung und einer Dauer hinzu, und jede Regel lässt sich nach einer Bestätigung entfernen. Die Regeln werden von greylist_rule_add mit origin = console und der Identität des Betreibers geschrieben und wie auf der Kommandozeile als greylist.rule.added und greylist.rule.removed im Prüfprotokoll erfasst. Eine Domain-Regel passt auch auf die Domain des Umschlagabsenders, die jeder schreiben kann; die Seite weist darauf hin.
/ui/deferred ist die Seite des Benutzers: die Absender, die das Greylisting zu warten bat, bevor ihre Mail an die eigene Adresse des Benutzers angenommen wurde, mit dem ersten und dem letzten Versuch, der Anzahl der Versuche und der Angabe, ob eine Wiederholung durchkam. Diesen Absender zulassen, neben einer Zurückstellung oder für eine im Voraus eingegebene Adresse, setzt den Absender auf die eigene weiße Liste des Benutzers. Das ist die weiße Liste, die WHITELIST_BYPASS des Daemons für den Benutzer befragt, sodass der Absender für diesen Benutzer nicht erneut verzögert wird, und es ist keine Regel, die den Absender für alle durchließe. Der Datensatz ist der, den pepsi-whitelist add für eine Adresse schreibt, mit DKIM als Pflicht, sodass er nur für Mail zählt, die die Domain des Absenders authentifiziert. Befragt der Daemon keine eigene weiße Liste des Benutzers ([pepsi-greylist] WHITELIST_NAME oder eine Whitelist-Stage, deren Name {localpart} oder {login} enthält), sagt die Seite, dass das Zulassen eines Absenders nicht verfügbar ist, und bietet kein Formular an. Im Prüfprotokoll als whitelist.sender.added erfasst.
Der Server kann die Greylisting-Tabellen nicht schreiben und keine weiße Liste lesen: Eine Regel ändert sich nur über die beiden SECURITY DEFINER-Regelfunktionen und ein Datensatz einer weißen Liste nur über whitelist_add_user_sender, das eine einzige wörtliche Adresse entgegennimmt und eine gemeinsame weiße Liste ablehnt.
25.5.8. Seiten für Endbenutzer¶
Der own:<address>-Geltungsbereich ist definiert und durchgesetzt, und ein Prinzipal, der nur ihn hält, erreicht die Identitäts- und Korrespondentenseiten, eingeengt auf seine eigene Adresse. Die Seiten einer anderen Adresse antworten mit 404, und die gemeinsamen Objekte (Änderungen am Korrespondentenschlüssel-Cache, die Vertrauensanker) werden rundweg abgelehnt. Er erreicht auch das Mail-Protokoll, eingeengt auf seine eigene Adresse; eine Anfrage nach einer anderen Adresse wird dort mit 403 abgelehnt. Wo Greylisting läuft, erreicht er die Mail, die das Greylisting an seine Adresse zurückgestellt hat, und darf einen Absender auf seine eigene weiße Liste setzen (Greylisting). Die Navigation verlinkt diese Seiten für ihn. Auf seinen eigenen Identitäten darf er auch handeln: einen servergeführten Schlüssel anfordern, seinen eigenen öffentlichen Schlüssel registrieren, ein Hochladen auf den Schlüsselserver anfordern, veröffentlichen, zurückziehen, einen Schlüssel zum primären machen, einen Widerruf anfordern sowie auf seiner S/MIME-Identität eine Zertifikatsanforderung oder die Installation eines ausgestellten Zertifikats anfordern, also alles außer dem Löschen eines Datensatzes (siehe Schlüsselverwaltung). Jede dieser Aktionen wird beim Setup-Applier angefragt, der den zweiten Faktor der Adresse prüft, sofern einer eingerichtet ist (die Formulare nehmen den Code entgegen), und die Antwort ist die Seite der Aufgabe, die angibt, wann die Änderung erfolgt ist.
25.5.8.1. Anmelden per E-Mail¶
Ein Endbenutzer erhält einen solchen Prinzipal, indem er die Kontrolle über das Postfach nachweist. Ist [pepsi-admin] ENROL_STAGE gesetzt, bietet die Anmeldeseite „Mit einem an Ihre E-Mail-Adresse gesendeten Link anmelden“ an, was zu /ui/enrol führt:
Der Benutzer gibt eine Adresse ein. Wenn dieser Server die Adresse bedient, wird ihr ein Einmal-Link zugesandt, eingespeist bei
ENROL_STAGEmit dem Null-Absender. Der Server bedient eine Adresse, wenn er für sie eine nicht widerrufene Identität im Schlüsselspeicher hält oder wenn die Adresse ein lokales Konto ist, an das eine Maildir- oder.forward-Stage zustellt. Die Seite sagt dasselbe, ob das geschehen ist oder nicht („Falls dieser Server diese Adresse bedient, wurde ein Anmeldelink an sie gesendet“), und die Abfrage läuft, nachdem die Antwort gesendet wurde, sodass weder der Text noch die Antwortzeit verrät, welche Adressen existieren.Der Link (
ENROL_URL/ui/enrol/<token>) öffnet eine Bestätigungsseite; sie zu öffnen ändert nichts, weil Link-Scanner Links abrufen. Wer sie absendet, eröffnet eine Browsersitzung, die genauown:<address>hält, mit denselben Cookies, Lebensdauern und demselben CSRF-Schutz wie eine Passwortanmeldung, und landet bei seinen eigenen Identitäten. Ist ein zweiter Faktor eingerichtet (siehe Schlüsselverwaltung), braucht das Absenden den aktuellen TOTP-Code der Adresse. Hat die Adresse einen Sicherheitsschlüssel (registriert auf der eigenen Seite Sicherheitsschlüssel des Benutzers, wie oben), führt das Absenden stattdessen zu einer Seite, die nach ihm fragt; der TOTP-Code gilt weiterhin ersatzweise, wo die Adresse einen hat undREQUIRE_WEBAUTHNnichtusersnennt, und nur dann, wenn der Applier meldet, dass er tatsächlich einen Code geprüft hat. Den letzten Schlüssel eines Endbenutzers zu entfernen erfordert eine Bestätigung (Assertion) mit ihm; die Wiederherstellung durch den Betreiber istDELETE /api/v1/webauthn/{address}.
Der Link funktioniert einmal, für ENROL_LIFETIME (standardmäßig 30 Minuten), nimmt höchstens fünf Absendungen an und wird durch den nächsten an dieselbe Adresse gesendeten Link ersetzt. Gespeichert wird nur der SHA-256-Wert seines Tokens (pepsi.own_enrolment), so wie vom Sitzungscookie nur der Digest gespeichert wird (pepsi.own_session); beide Tabellen gehören allein pepsi-httpd. Anfragen sind pro Zieladresse begrenzt (ENROL_MAIL_PER_HOUR, standardmäßig 3 Links pro Stunde) und pro Clientadresse (ENROL_RATE_LIMIT, standardmäßig 20 pro Stunde).
Der zweite Faktor wird vom privilegierten Applier geprüft, nicht von diesem Server: otp_key und der Schlüssel, der dessen Geheimnisse verpackt, liegen außerhalb der Reichweite der Web-Schicht. Die Bestätigung reiht eine confirm-enrolment-Aufgabe mit dem Code ein, unter dem eigenen Geltungsbereich der Adresse, und die Sitzung wird erst eröffnet, wenn diese Aufgabe mit done endet. Der Applier lässt eine Adresse ohne zweiten Faktor passieren, sodass die Web-Schicht nicht einmal erfährt, ob einer eingerichtet ist. Die Anmeldung per E-Mail braucht daher den Applier (das Paket pepsi-httpd-admin und [pepsi-admin] CONFIG_DB); ohne ihn antwortet das Adressformular, dass die Anmeldung per E-Mail hier nicht verfügbar ist, und versendet nichts.
Der Mechanismus und das, wogegen er nicht schützt, stehen in Anmeldung an der Konsole per E-Mail; die Darstellung eines gestohlenen Postfachs im Bedrohungsmodell ist Wer das Postfach eines Benutzers lesen kann.
Damit irgendetwas davon hilft, muss die Konsole für die Benutzer erreichbar sein: ENROL_URL nennt den https://-Ursprung eines ADMIN = yes-Listeners (oder des davorstehenden TLS-Reverse-Proxys), und der Link zeigt immer dorthin. Er zeigt nie auf den Host, den die Anfrage gerade trug, denn den könnte ein Angreifer wählen.
Was ein Endbenutzer dort tun kann, ist das, was own:<address> erlaubt: seine eigenen Identitäten, Korrespondentenschlüssel, sein Mail-Protokoll und seine vom Greylisting zurückgestellte Mail lesen, die oben genannten Schlüsseloperationen ausführen und einen Absender zulassen, den das Greylisting zurückgestellt hat. Ansonsten sind die Seiten schreibgeschützt: Benutzer ändern ihre eigenen Einstellungen weiterhin per E-Mail, über pepsi-stage-edit-settings(1), und können ihre Schlüssel per E-Mail über die Steueradresse pepsi-keys@ der Encrypt-Stage verwalten.
25.6. Zwei Templating-Engines, zwei Zwecke¶
Pepsi rendert zwei recht verschiedene Arten von Text und verwendet für jede eine andere Engine. Versuchen Sie also nicht, eine Konsolenseite so zu überschreiben, wie Sie einen Bounce überschreiben.
Nachrichtentexte von Mails sind Mustache-Vorlagen, als Dateien unter [pepsi] TEMPLATE_DIR ausgeliefert (bounce-<name>.<lang>.body, payment-request.<lang>.body, edit-settings.<lang>.body, wallet.<lang>.body). Sie sind vom Betreiber bearbeitbar und je Sprache: Von einem Betreiber wird erwartet, dass er die Prosa, die ein Korrespondent lesen wird, umschreibt und eine Sprache hinzufügt, ohne etwas neu zu bauen. Logikloses Templating ist dort die richtige Wahl: Es gibt nichts zu berechnen, und eine Vorlage, die keinen Code ausführen kann, darf man einem Betreiber gefahrlos in die Hand geben.
Konsolenseiten sind askama-Vorlagen, in das Binärprogramm einkompiliert und zur Bauzeit typgeprüft gegen die Rust-Structs, die sie rendern. Es gibt zur Laufzeit nichts zu installieren, nichts mit dem Binärprogramm synchron zu halten, und ein umbenanntes Feld ist ein Baufehler statt einer leeren Zelle im Produktivbetrieb. Die Konsole besteht überwiegend aus Tabellen und Bedingungen, was logikloses Templating mühsam macht.
Die praktische Folge: Es gibt keine Möglichkeit, eine Konsolenseite zu überschreiben, und das ist auch nicht vorgesehen. Wenn eine Seite das Falsche sagt, ist das ein zu meldender Fehler und keine zu bearbeitende Datei.
25.7. Kein Scripting, keine entfernten Ressourcen¶
Die Konsole liefert kein JavaScript, mit einer Ausnahme. Jede Aktion ist ein Formular oder ein Link, sodass sie mit deaktiviertem Scripting funktioniert. Das gilt auch für die optionale automatische Aktualisierung der Warteschlange: Sie ist ein <meta http-equiv="refresh">, das der Leser mit einem Link ein- und ausschaltet, statt eines Timers. Die Diagramme sind kleine handgeschriebene Inline-SVGs, auf dem Server erzeugt, sodass sie in derselben Anfrage rendern wie der Rest der Seite.
Nichts wird von einem anderen Host geladen: ein Stylesheet, in das Binärprogramm einkompiliert und von /ui/static/console.css ausgeliefert. Die Content-Security-Policy verbietet Skripte daher rundweg, statt die eigenen der Konsole zu erlauben, und verbietet Framing (frame-ancestors 'none', mit X-Frame-Options: DENY daneben).
Die Ausnahme ist eine Sicherheitsschlüssel-Zeremonie, die kein Formular ausführen kann: navigator.credentials ist eine Skriptschnittstelle. Drei Seiten führen eine aus: der zweite Schritt einer Anmeldung, die Bestätigung der E-Mail-Anmeldung, wenn sie nach einem Schlüssel fragt, und Sicherheitsschlüssel. Sie laden ein statisches Skript, webauthn.js, das wie das Stylesheet in das Binärprogramm einkompiliert ist. Ihre Richtlinie erlaubt diese Datei anhand ihres SHA-256-Werts (den das Tag auch als integrity trägt) und ihrer genauen URL unter CONSOLE_URL, und sonst nichts: kein Inline-Skript, kein 'self', kein eval. Das Skript liest die Parameter der Zeremonie aus den data--Attributen der Schaltfläche, schreibt die Antwort des Browsers in versteckte Felder und sendet das gewöhnliche Formular ab; ohne Skript bleibt die Schaltfläche verborgen, sodass ein solcher Browser das TOTP-Feld sieht, sofern es eines gibt. Jede andere Seite behält die Richtlinie ohne script-src. Wir tun das, damit auch ein vergessenes Escaping kein Skript ausführen kann (siehe Fehlendes HTTPS und fehlende Härtung über HTTP-Sicherheitsheader bei Webmail). Seiten werden mit Cache-Control: no-store gesendet, sodass administrative Daten nicht in einem gemeinsamen Cache oder nach dem Abmelden im Zurück-Knopf liegen.
Cross-Site Request Forgery wird doppelt abgewehrt. Jedes Formular trägt das CSRF-Token der Sitzung als verstecktes Feld, geprüft gegen einen mit der Sitzung gespeicherten Digest; und eine verändernde Anfrage, deren Origin-Header einen anderen Host benennt, wird abgelehnt, bevor ihr Rumpf überhaupt gelesen wird. Diese zweite Prüfung deckt das Anmeldeformular ab, das eine Formular, das definitionsgemäß noch keine Sitzung hat (siehe Reflektiertes und gespeichertes XSS oder HTML-Injektion in Portalen und Administratormails).
Werte, die von außen kommen (ein Betreff, der Anzeigename eines Absenders, ein Header-Wert, der Antworttext eines Bounce, die User-ID eines Schlüssels), werden beim Rendern standardmäßig escaped, und die Tests üben das mit feindlichen Eingaben, statt darauf zu vertrauen. Das einzige Markup, das die Konsole unescaped ausgibt, ist das SVG ihrer eigenen Diagramme, das konstruktionsbedingt Zahlen und sonst nichts enthält (siehe Reflektiertes und gespeichertes XSS oder HTML-Injektion in Portalen und Administratormails).
25.8. Barrierefreiheit¶
Die Konsole ist schlichtes HTML: ein Sprunglink zum Hauptinhalt, eine <h1> je Seite, Tabellen mit <caption> und <th scope=…>, ein Label für jedes Formularfeld und aria-current="page" auf dem Navigationseintrag, auf dem Sie sich befinden. Jede Aktion ist ein echter <button> in einem Formular, sodass sie ohne zu erlernende Tastenkombinationen von der Tastatur aus erreichbar und bedienbar ist, und der Fokusring wird ausdrücklich gezeichnet, weil der voreingestellte vor manchen Hintergründen verschwindet. Hell und dunkel kommen beide aus prefers-color-scheme; es gibt keinen Themenschalter, denn ein Schalter braucht Skript oder ein Cookie, und das Betriebssystem kennt die Antwort bereits.
Die Diagramme tragen aria-hidden und sind nie die einzige Darstellung von irgendetwas: Dieselben Zahlen stehen neben jeder Grafik in der Tabelle.
Die Navigation bietet nur, was Ihre Zugangsdaten erlauben, denn ein Link, der mit 403 antwortet, ist schlimmer als gar kein Link.
25.9. Die öffentlichen Mailinglistenseiten¶
Eine zweite, getrennte Browseroberfläche, über LISTS = yes freigeschaltet (siehe Drei Listener-Flags, und bei zwei davon lautet der Rat entgegengesetzt) und hier dokumentiert, weil ein Betreiber beiden begegnet:
/listsDas Verzeichnis der beworbenen Listen, nach Domain gruppiert. Eine Liste, deren Attribut
advertisedfalsch ist, fehlt im Verzeichnis und ist weiterhin über ihre URL erreichbar. Das ist die Bedeutung des Attributs bei upstream, und es ist keine Sicherheitsgrenze. „Nicht beworben“ klingt wie „versteckt“; das ist es nicht./lists/<list-id>Die Beschreibung einer Liste, ihr
info-Text, ihre Absendeadresse, die Formulare zum An- und Abmelden, ein Link zum Archiv, wenn die Richtlinie eines erlaubt, und die Mitgliederliste nur dann, wennmember_roster_visibilitypublicist./lists/<list-id>/confirm/<token>Worauf ein Bestätigungslink zeigt. Ein ``GET`` schließt nichts ab: es zeigt an, wofür das Token ist, und bittet um ein einzelnes
POST. Mailprogramme, Linkvorschauen und Sicherheitsscanner rufen Links ab, mehrere davon, bevor der Mensch es tut. Das ist ein bewusster Unterschied zur Mailadresse-confirm+<token>, bei der die Ankunft die Bestätigung ist, weil das Token im Umschlag reiste und nur sein Eigentümer es dort hineingelegt haben kann./archives/list/<list@domain>/…Das Archiv: Übersicht, Monat, Thread, Nachricht, Anhang, Suche. Die URL-Formen sind die von HyperKitty, sodass jeder
Archived-At:-Header, den eine migrierte Installation je ausgegeben hat, weiter funktioniert. Siehe Archive.
Drei Dinge über diese Seiten lohnt es sich zu wissen, bevor man sie ausliefert.
Sie liefern kein JavaScript aus, außer auf den beiden Mitgliederseiten, die eine Sicherheitsschlüssel-Zeremonie ausführen (siehe unten). Die Content-Security-Policy hat daher kein script-src (nicht einmal 'self') und sagt default-src 'none'. Der Preis sind die interaktiven Teile von HyperKitty: Das Zusammenklappen von Threads ist <details>, es gibt keine Livesuche und keine Antwort auf der Seite. Das wurde bewusst entschieden, und eine Richtlinie, die erlaubt, was nicht benutzt wird, ist eine Richtlinie, die eines Tages erlaubt, was eingeschleust wird (siehe Fehlendes HTTPS und fehlende Härtung über HTTP-Sicherheitsheader bei Webmail).
Nachrichtentexte sind maskierter Text und niemals Markup. Das Attribut archive_rendering_mode von upstream bietet text oder markdown. Pepsi speichert das Attribut und legt es offen, weil der Attributsatz der Kompatibilitätsvertrag ist, und stellt für beide Werte text dar. Vom Benutzer geliefertes Markdown in unseren eigenen Origin zu rendern ist genau das, was die obige Richtlinie unmöglich machen soll, und ein Markdown-Renderer ist eine HTML-Einschleusungsfläche mit Zwischenschritten. Wer Text rendert, hat keinen Sanitizer, der sich falsch machen ließe, und vermeidet so eingeschleustes Markup und eingeschleuste Formulare (siehe Handgeschriebene oder einmal durchlaufende HTML-Sanitizer lassen aktive Inhalte überleben und Handgeschriebene oder einmal durchlaufende HTML-Sanitizer lassen aktive Inhalte überleben).
Adressen werden für anonyme Betrachter verschleiert. Eine Archivseite zeigt alice@... statt der ganzen Adresse, für den Absender und für jede Adresse in einem Nachrichtentext oder Suchausschnitt, außer den eigenen Posting- und Rollenadressen der Liste (list@domain, list-request@domain und die übrigen), die bestimmungsgemäß veröffentlicht sind; Anhänge werden so ausgeliefert, wie sie gespeichert sind. Ein angemeldetes Mitglied sieht sie vollständig. Das Archiv behält die echten Adressen, denn ein Verschleiern beim Hereinkommen ließe sich nicht rückgängig machen, und die Bounce-Verarbeitung braucht die echte Adresse. Das Verschleiern ist also eine Darstellungsentscheidung. Es ist keine Sicherheitsmaßnahme und soll keine sein: Wer auf der Liste ist, hat die Adresse in seiner eigenen Kopie der Nachricht. Was es verhindert, ist das massenhafte Einsammeln, das ein öffentliches Archiv zu einer Spamquelle macht.
25.9.1. Formulare, die den Server Post senden lassen¶
Sich anzumelden ist die Aufforderung an den Server, eine Nachricht an eine Adresse zu senden, deren Besitz niemand belegt hat. Ohne Begrenzung könnte jemand damit einen Fremden mit Mail belästigen, und Pepsi liefert kein CAPTCHA aus, aus derselben Entscheidung, die JavaScript ausschließt. Daher:
jedes solche Formular ist auf die Zieladresse ratenbegrenzt (zwei Mails pro Adresse und Stunde) und ebenso auf die Clientadresse;
eine zweite Einsendung, während ein Token noch gültig ist, verwendet dieses Token erneut, statt ein weiteres auszugeben, zehn Einsendungen sind also nicht zehn Nachrichten;
die Antwort ist identisch, ob die Adresse schon Mitglied ist oder nicht, das Formular ist also kein Mitgliedschaftsorakel.
Das Letzte ist der Grund, weshalb die Seite „falls diese Adresse angemeldet werden kann, wurde eine Bestätigung an sie gesendet“ sagt und nichts Hilfreicheres. Diese Regeln begrenzen das Ausforschen von Adressen über die Formulare; ein Zeitunterschied zwischen den beiden Pfaden ist nicht ausgeschlossen (siehe Portale und APIs legen Benutzerdaten oder Schlüsselmaterial ohne Authentifizierung offen).
Warnung
Die Web-Schicht versendet keine eigene E-Mail. Die Formulare, die List-API und die Mitgliederseiten durchlaufen denselben Anmelde-Ablauf wie die Mail-Befehle -join und -leave und legen dasselbe Token in pepsi.list_pending ab, aber nur die Stage für Mail-Befehle speist die Bestätigungsanfrage ein; die Web-Schicht hält das Token fest und antwortet, als wäre sie gesendet worden. Bis das verdrahtet ist (docs/ROADMAP.md), wartet ein Besucher, der sich über das Web anmeldet, registriert oder ein Passwort zurücksetzt, auf eine Nachricht, die nicht kommt. Ein Betreiber kann das Token aus der Tabelle lesen und den Link weitergeben, das Mitglied mit pepsi-list members add hinzufügen oder ein Passwort mit pepsi-list owner reset-password zurücksetzen.
25.10. Zwei Kontosysteme, und keines gewährt dem anderen etwas¶
Dies ist das am leichtesten missverständliche an der Webebene, es steht daher so klar da wie möglich.
Pepsi hat zwei Arten von Browserkonto, in zwei Tabellen, mit zwei Sätzen von Cookies, und sie haben nichts miteinander zu tun:
Die Konsole des Betreibers |
Das Konto des Listenmitglieds |
|
|---|---|---|
Für wen es ist |
Wer den Mailserver betreibt |
Jeder, der eine Liste abonniert, und die Verwalter und Moderatoren dieser Listen |
Kontotabelle |
|
|
Sitzungstabelle |
|
|
Cookies |
|
|
Listener-Flag |
|
|
Wo es erreichbar sein sollte |
Loopback, über einen SSH-Tunnel |
Das öffentliche Internet |
Angelegt von |
Ein Betreiber, über |
Registrierung unter |
Was es kann |
Die Konfiguration, die Warteschlange, die Schlüssel und die Protokolle. Nicht die Listen: Diese werden mit pepsi-list(1) oder über die Mailman- |
Die eigenen Abonnements, dazu diejenigen Listen, deren Verwalter oder Moderator die eigene Adresse ist |
Keines ist eine schwächere Fassung des anderen. Ein Betreiberkonto ist Mitglied von nichts, und ein Mitgliedskonto, selbst das eines Listenverwalters, kann die Warteschlange, die Konfiguration oder irgendjemandes Schlüssel nicht lesen. Die beiden sind getrennt, weil ihr Auslieferungsrat entgegengesetzt ist: Die Konsole ist das, was das Handbuch aus dem Internet heraushalten lässt, und ein Listenverwalter kann offensichtlich nicht gebeten werden, einen SSH-Tunnel zu öffnen, um eine zurückgehaltene Nachricht freizugeben.
25.10.2. Wenn Sie beide Oberflächen unter einem Hostnamen anbieten¶
Der Assistent warnt davor und kann es nicht verhindern. Cookies sind an den Host gebunden, nicht an den Listener; eine Installation, die ADMIN = yes und LISTS = yes hinter einen Namen legt, hat genau zwei Dinge, die die Oberflächen trennen: die Cookienamen und die Prüfung des Wächters, aus welcher Tabelle eine Sitzung kam.
Das ist eine dünne Linie, und sie ist absichtlich dünn und nicht versehentlich. Sie wird in beide Richtungen getestet: Eine Mitgliedssitzung, die einer Betreiberroute vorgelegt wird, wird genauso abgewiesen, wie es kein Cookie würde, und eine Betreibersitzung an einer Mitgliederroute ebenso, ohne dass eines davon einen unterscheidbaren Fehler erzeugt. Bevorzugen Sie dennoch zwei Namen oder besser zwei Listener: ADMIN auf Loopback und LISTS öffentlich ist die Anordnung, die der Rest dieses Kapitels voraussetzt.
25.11. Die Seiten des Mitglieds¶
/lists/registerLegt ein Konto an und erzeugt ein Bestätigungstoken, in einer einzigen Datenbankanweisung, die gleich ist, ob die Adresse bekannt war oder nicht (das Formular zum Zurücksetzen unten ebenso), sodass weder die Antwort noch die Arbeit dahinter verrät, welche Adressen Konten haben. Kein Orakel und gedrosselt, wie das Anmeldeformular oben und aus demselben Grund. Mit
[pepsi-list] WEB_REGISTRATION = noexistieren die Seite und ihr Handler nicht (404), und die Anmeldeseite bietet sie nicht an; Anmelden, Zurücksetzen von Passwörtern und Bestätigungslinks bestehender Konten funktionieren weiter, und Konten kommen auspepsi-list, einem Import oder von einem Listeneigentümer. Das Token wird nicht versendet (siehe die Warnung oben): Es liegt inpepsi.list_pending(payload->>'account' = 'verify'), bis der Betreiber den Link weitergibt oder es abläuft./lists/verify/<token>Bestätigt die Adresse und setzt das Passwort, in einem Schritt. Es gibt keine gesonderte Seite „Passwort wählen“, denn ein Bestätigungslink, der nur bestätigt, hinterlässt ein Konto, in das sich niemand anmelden kann. Das Passwort muss mindestens zehn Zeichen lang sein, darf nicht auf der mitgelieferten Liste häufiger Passwörter stehen und die Adresse nicht enthalten; ein abgelehntes kostet den Link, und die Seite fordert dazu auf, einen neuen anzufordern.
/lists/sign-in,/lists/sign-outAnmelden mit jeder bestätigten Adresse des Kontos und dem einen Passwort des Kontos. Ein Mitglied darf mehrere Adressen halten (das Modell von upstream ist ein Benutzer mit vielen Adressen), und genau das lässt „ich habe mich mit meiner Arbeitsadresse angemeldet“ funktionieren. Eine unbestätigte Adresse kann sich nicht anmelden: Sie hat nichts belegt.
/lists/resetErzeugt einen Link zum Zurücksetzen (
payload->>'account' = 'reset'), der ebenfalls nicht versendet wird. Einen Link, nie ein Passwort: ein zugesandtes Passwort ist ein Passwort, das für immer in einem Postfach liegt.pepsi-list owner reset-passwordist der Weg des Betreibers, und genau aus diesem Grund ist sein Standard, den Link auszugeben statt ihn zu versenden. Es gibt keine wissensbasierte Wiederherstellung wie Sicherheitsfragen (siehe Schwache Passwörter und erratbare Fragen zur Kontowiederherstellung)./lists/meDie eigenen Adressen und die eigenen Abonnements über alle Listen, jedes mit seinem Zustellmodus und seinem Status.
/lists/me/securityDie Sicherheitsschlüssel (WebAuthn) des Mitglieds, ein zweiter Faktor, den Phishing-Seiten nicht verwenden können. Einen zu registrieren braucht das Passwort; danach braucht die Anmeldung das Passwort und einen der Schlüssel, abgefragt auf einer zweiten Seite (
/lists/sign-in/second-factor). Einen weiteren Schlüssel hinzuzufügen und einen zu entfernen braucht das Passwort und eine Bestätigung (Assertion) mit einem der vorhandenen Schlüssel; beim Hinzufügen wird der neue Schlüssel dann auf der folgenden Seite registriert. Ein Mitgliedskonto hat kein TOTP, daher stellt der Betreiber ein Mitglied wieder her, das alle Schlüssel verloren hat (DELETE /api/v1/webauthn/members/{address}); ein Zurücksetzen des Passworts entfernt keinen Schlüssel, sonst ließe er sich allein mit dem Postfach umgehen. Schlüssel sind an[pepsi-list] BASE_URLgebunden, die einehttps://-URL sein muss, damit überhaupt welche angeboten werden; nennt[pepsi-httpd] REQUIRE_WEBAUTHNmembers, registriert jedes Mitglied bei der nächsten Anmeldung einen. Die beiden Seiten, die die Zeremonie ausführen, laden das eine statische Skript, wie die der Konsole; jede andere Seite hier bleibt skriptfrei.
25.11.1. Warum eine Einstellung nicht dort wirkt, wo man es erwartet¶
Die sechs Zustelleinstellungen werden über eine Kette nachgeschlagen: dieses Abonnement, dann diese Adresse, dann dieses Konto, dann der Standard der Liste selbst. Jede Ebene darf ungesetzt sein. Ein Mitglied, das eine Einstellung an seinem Konto setzt und feststellt, dass sie für eine Liste nicht wirkt, hat sie daher meist auf einer Ebene gesetzt, die eine genauere überschreibt.
/lists/me zeigt deshalb für jedes Abonnement, von welcher Ebene der Wert kam. Diese Spalte ist die Antwort auf die einzige Frage, die dieser Entwurf zuverlässig hervorruft.
25.12. Die Konsole für Verwalter und Moderatoren¶
/lists/<list-id>/adminDie eine Seite, von der aus man beginnt: die zurückgehaltenen Nachrichten, die Abonnementanfragen und (für einen Verwalter) Links zu den Einstellungsseiten und zur Mitgliederliste.
/lists/<list-id>/admin/held/<request-id>Eine zurückgehaltene Nachricht, mit ihren genauen Bytes als Text angezeigt. Das Annehmen gibt diese Bytes frei, keine Neudarstellung davon: Eine zurückgehaltene Nachricht wird gerade deshalb in ihrer Leitungsform aufbewahrt, damit eine Freigabe wirklich zugestellt werden kann, mit unversehrten Signaturen und Anhängen.
Die Seite ist die feindlichste der Website: die Post eines Fremden, dargestellt dort, wo der Klick eines Moderators handeln kann. Der Nachrichtentext ist daher maskierter Text in einem
<pre>, die Richtlinie erlaubt kein Skript, und jede Schaltfläche trägt ein CSRF-Token. Wir tun das, um gespeichertes Cross-Site-Scripting über E-Mail zu vermeiden (siehe Handgeschriebene oder einmal durchlaufende HTML-Sanitizer lassen aktive Inhalte überleben)./lists/<list-id>/admin/settings/<screen>Die schreibbaren Listeneinstellungen, auf elf Seiten in der Gruppierung von Postorius selbst, weil ein migrierender Verwalter eine Einstellung dort sucht, wo sie früher war. Der Hilfetext neben jedem Feld ist der von Postorius, übernommen; siehe die Namensnennung in Mailinglisten.
Die Seiten sind aus derselben Deklaration erzeugt, die die REST-API und die Kommandozeile antreibt; ein Wert, der hier abgelehnt wird, wird dort mit denselben Worten abgelehnt, und eine Einstellung kann nicht an einer Stelle vorhanden und an einer anderen fehlend sein. Eine zwölfte Seite,
pepsi, enthält die Einstellungen, die Pepsi eingeführt hat (darunterhold_dmarc_failures; Einstellungen, die Pepsi erfunden hat), validiert so, wiepepsi-list list set-extsie validiert; ein leerer Wert setzt eine Einstellung auf ihren Standard zurück.Die sechs
*_uri-Vorlagenattribute stehen ebenfalls auf diesen Seiten, sodass ein Verwalter, der seine eigene Willkommensnachricht oder Fußzeile will, die URI dort setzt, wo jede andere Einstellung liegt, und nicht auf einer eigenen Seite./lists/<list-id>/admin/rosterMitglieder, Verwalter und Moderatoren; die Sperren der Liste; und ihre Header-Regeln, mit den serverweiten Sperren und Regeln daneben in Nur-Lese-Form. Die serverweiten haben Vorrang, und ein Verwalter, der eine nie auslösende Regel untersucht, muss die zuerst ausgelöste sehen.
Eine Adresse hinzuzufügen ist die eine Handlung auf dieser Ebene, die jemanden anmeldet, der nicht zugestimmt hat. Es ist eine Verwalterhandlung, sie wird mit dem Verwalter als Handelndem ins Prüfprotokoll geschrieben, und die hinzugefügte Adresse wird nicht als bestätigt markiert: das Wort eines Verwalters ist kein Beleg, dass ein Postfach existiert.
Alles in dieser Konsole wird über dasselbe Protokoll geprüft wie jede Betreiberhandlung, mit dem Konto des Mitglieds als Handelndem. detail trägt nie Nachrichteninhalt: Das Annehmen einer zurückgehaltenen Nachricht hält die Anfrage und den Hash der Nachricht fest, nicht den Text. Das Protokoll wird über den Timer [pepsi-admin] EVENT_RETENTION_DAYS des Betreibers ausgedünnt; prüfen Sie ihn gegen die Dauer, für die Sie die Moderationsgeschichte aufbewahren wollen.
25.13. Die Sprachen der Oberflächen¶
Jede Seite, die pepsi-httpd ausliefert, wählt ihre Sprache anhand des Accept-Language-Headers der Anfrage nach einer Regel: Ein Regionalkürzel erhält seine Sprache (de-CH bekommt die deutschen Seiten, weil eine Variante einer Sprache ihr näher ist als Englisch), die q-Reihenfolge des Headers wird beachtet und nicht seine Dokumentreihenfolge, ein q=0 wird als Ablehnung gelesen (de, en;q=0 bedeutet also Deutsch und nicht „Deutsch, dann irgendetwas“), und ein Header, der nichts nennt, was der Server hat, fällt auf Englisch zurück.
Unterschiedlich ist, wie viele Sprachen jede Oberfläche hat. Die Administrationskonsole und das Secure-Link-Portal werden in den zehn Sprachen ausgeliefert, in denen die Benachrichtigungsvorlagen mitgeliefert werden: Englisch, Deutsch, Spanisch, Französisch, Ungarisch, Italienisch, Russisch, Schwedisch, Türkisch und Ukrainisch. Die Beschriftungen der Konsole sind ein Katalog pro Sprache (pepsi-httpd/src/ui/strings/), die des Portals ebenso (pepsi-secure-link/src/strings/), und ein Test weist einen Katalog zurück, in dem ein Satz auf Englisch belassen wurde. Die drei Mails des Portals (die Benachrichtigung, die PIN und die Lesebestätigung) sind Vorlagen in denselben zehn Sprachen, mit übersetzten Betreffzeilen; siehe Das Secure-Link-Ausweichportal.
Die öffentlichen Mailinglisten-Seiten werden auf Englisch, Deutsch oder Französisch ausgeliefert, den drei Sprachen, in denen es das Handbuch gibt, und diese Lücke wird genannt statt verborgen. Die Benachrichtigungsvorlagen (die Willkommensnachricht, die Bestätigungsanfrage, die Bounce-Warnungen) gibt es in zehn Sprachen, weil sie von GNU Mailman kommen, das sie in vierunddreißig hat (siehe Mailinglisten). Ein Mitglied, das eine deutsche Willkommensnachricht liest und ihrem Link folgt, landet auf einer deutschen Seite; ein schwedisches landet auf einer englischen. Den öffentlichen Seiten eine Sprache hinzuzufügen heißt, etwa 170 kurze Beschriftungen zu übersetzen, und das ist ein Nachmittag und ein Patch, kein Projekt.
Die Wahl wird allein aus dem Header getroffen, vor jedem Datenbankzugriff. Das ist beabsichtigt: eine öffentliche Seite ist für jeden erreichbar, und ein Wort durch das Lesen eines Datensatzes zu wählen würde bedeuten, dass eine nicht authentifizierte Anfrage die Datenbank anfasst, auf einem Server, dessen Worker-Pool eine Verbindung ist. Die gespeicherte Vorliebe eines angemeldeten Mitglieds überschreibt den Header daher nicht.