70. pepsi-status¶
Fasst die Gesundheit der Mail-Pipeline zusammen.
70.1. Rolle¶
pepsi-status ist die nur lesende Gesundheitsübersicht des Betreibers über die Pipeline. Es verbindet sich über den gemeinsamen Abschnitt [pepsi-postgres] und hat keinen eigenen Abschnitt. Es ändert nie einen Datensatz und löst keine Benachrichtigung aus, daher kann man es gefahrlos über SSH gegen eine laufende Installation ausführen. Zu den übrigen Optionen, die es liest, gehören [pepsi] MAILBOX_QUOTA (der Standardwert der Installation, den ein Konto ohne eigenen Datensatz erbt), [pepsi-dmarc-reports] WINDOW_DAYS und [pepsi-dkim] PUBLIC_DIR.
Drei Abschnitte fragen das Netz statt der Datenbank: was das Web Key Directory und das DNS für die veröffentlichten Identitäten ausliefern (dieser Abschnitt liest [pepsi-keydiscovery] für seine Zeitlimits und sein CA-Bündel), ob der Resolver, dem die DANE-Nutzer vertrauen, DNSSEC validiert, und was er für die bedienten Domains antwortet. --offline überspringt den ersten und den letzten und führt die Resolver auf, ohne sie abzufragen. Wird das Programm als root gestartet, arbeitet es vor dem Verbinden als Dienstkonto pepsi weiter, sodass kein sudo -u pepsi nötig ist. Referenz: pepsi-status(1).
70.2. Funktionen¶
Warteschlange — der
pepsi.workqueue-Rückstau, aufgeschlüsselt nachstageundstatus, mit dem Alter der ältesten Nachricht in jedem Bucket.Festhängende Nachrichten — die einzelnen
failed/timeout-Nachrichten, älteste zuerst, mit jedem für sie festgehaltenen Grund: dem strukturierten Fehler des nächsten Hops ausstate.bounce(entfernter MTA, SMTP-Code, erweiterter Status, Antworttext), dem eigenenstate.last_errorder Stage und demstate.dispatch_errordes Dispatchers (ein abgestürzter oder hängender Worker, eine nicht konfigurierte Stage); durch--limitgedeckelt.Zustellung & Fehler — kumulative
dispatch_stats/stage_stats-Zähler: insgesamt verarbeitete Nachrichten, Nachrichtenzahlen pro Stage, durchschnittliche Verarbeitungszeit, Worker-Timeouts und -Abstürze. Eine Warnung meldet, wie vielerunning-Zeilen der Dispatcher gefunden hat, die kein Worker hielt. Er setzt sie selbst zurück, aber jede bedeutet, dass ein Schreibvorgang verloren ging; suchen Sie also in seinem Log nach Datenbankausfällen.Ausgehendes TLS —
tls_session-Ergebnisse der letzten sieben UTC-Berichtstage (einschließlich des heutigen), gruppiert nach Richtliniendomain und Ergebnistyp (nicht-erfolgreiche Ergebnisse markiert), plus MX-Adressen, die der Resolver-Cache als beim Verbinden fehlschlagend markiert hat.Postfachquoten — jedes Konto mit Quotenbuchführung, älteste Messung zuerst (die Reihenfolge, in der der
reconcile-Durchlauf von pepsi-quota arbeitet), mit seiner wirksamen Grenze, der gemessenen Nutzung, der ungemessenen Zustellungsschätzung obendrauf und dem Alter der Messung. Ein Konto erscheint hier, sobald ihm etwas zugestellt wurde, mit oder ohne Quote.Schlüsselwechsel von Korrespondenten — wie viele Schlüssel von Korrespondenten die Autocrypt-Regel „das Neueste gewinnt“ in den letzten 30 Tagen ersetzt hat und wie viele Ersetzungen
ACCEPT_ROTATION = expiredzurückgehalten hat, mit den jüngsten von beiden (Adresse, alter und neuer Fingerabdruck, eigener Schlüssel oder Gossip), gelesen aus denkey.peer.rotate[.held]-Datensätzen vonpepsi.event_log. Eine Rotation ist der eine Weg, auf dem eine Nachricht, die nur behauptet, von einem Korrespondenten zu stammen, den Schlüssel ändern kann, an den Pepsi verschlüsselt, weshalb sie hier angezeigt wird (Schlüssel von Korrespondenten).DMARC-Sammelberichte — je bediente Domain das Urteil der authentifizierten Berichte der letzten
WINDOW_DAYS, die pepsi-stage-dmarc-report gespeichert hat: Jede Quelle war ausgerichtet, sodassp=rejectkeine von ihnen ablehnt, oder eine Warnung, die die Quellen nennt, die es nicht waren (DMARC-Aggregatberichte).Liste bekanntermaßen kompromittierter Schlüssel — wann die badkeys-Liste zuletzt geprüft wurde und ob die letzte Aktualisierung fehlschlug.
IP-Reputation — welche der IP-Sperrlisten, die der Ingress konsultiert, aktuell sind (pepsi-reputation), und die letzte Selbstprüfung der eigenen Adressen und Domains dieses Hosts gegen die DNS-Sperrlisten, wobei jeder Eintrag eine Warnung ist.
DKIM-Schlüssel — was pepsi-dkim(1) in seiner öffentlichen Statusdatei meldet: Rotation an oder aus und je signierender Domain die aktuellen, nächsten und ausscheidenden Schlüssel mit ihrem DNS-Zustand, die zu veröffentlichenden oder zu entfernenden Einträge und eine auf das DNS wartende Rotation. Ein aktueller Schlüssel, dessen Eintrag nicht sichtbar ist, ein ausstehender Eintrag, eine verzögerte Rotation, eine Domain, für die kein Schlüssel signiert, und eine fehlende Statusdatei sind Warnungen. In
--jsonist esdkim.Veröffentlichte Schlüssel wie ausgeliefert — beide Methoden des Web Key Directory und die
OPENPGPKEY- undSMIMEA-Einträge jeder Adresse mit einer veröffentlichten, aktiven Identität, abgerufen wie ein Korrespondent es täte und mit dem Schlüsselspeicher verglichen (Prüfen, was tatsächlich ausgeliefert wird): wie viele Adressen genau wie gespeichert ausgeliefert werden, und jeder Kanal der übrigen. Ein Fingerabdruck, den der Speicher für die Adresse nicht veröffentlicht, ist eine Warnung (Was das Verzeichnis für unsere Nutzer ausliefert). Mit--offlineübersprungen; in--jsonist esserved_keys.RSA-Entschlüsselungsschlüssel — die aktiven S/MIME-Identitäten, deren Zertifikat RSA ist und deren privaten Schlüssel Pepsi zur Entschlüsselung hält, sodass eingehendes S/MIME an sie eine Operation mit dem privaten RSA-Schlüssel erreicht (Timing- und mikroarchitektonische Bleichenbacher-Orakel (Marvin und Nachfolger)); eine mit
purpose = bothwird als ihren Schlüssel zwischen Signieren und Entschlüsseln teilend markiert. Eine INFO-Zeile sagt, was zu tun ist: eine P-256-Identität erzeugen (pepsi-keys identity generate), damit neue Mail ECDH verwendet, und die RSA-Identität zum Entschlüsseln alter Mail behalten. In--jsonist esrsa_decryption.DNSSEC-Resolver — jeder Resolver, dessen AD-Bit ein DANE-Nutzer vertraut (die Relay-Stages mit eingeschaltetem
DANE,pepsi-keydisc@dane), geprüft mit dem signiertenSOAvonietf.org: Ein Resolver, der das AD-Bit nicht setzt, ist eine Warnung, weil DANE dann konfiguriert, aber nie angewendet wird, ebenso einer, der nicht auf diesem Host liegt (die Annahme eines validierenden Resolvers aus Sicherheitsmodell).--offlineführt die Resolver ohne Prüfung auf; in--jsonist esresolvers.Eigenes DNSSEC — ob die Vertrauenskette der bedienten Domains hält: Dieser Resolver wird für jede angenommene Domain nach ihren
MX-Einträgen und den_25._tcp-TLSA-Einträgen ihrer MX-Hosts gefragt und sagtvalidated,insecure,bogus(mit dem Extended DNS Error nach RFC 8914, etwaSignature Expired) oderservfail.bogusundservfailsind Warnungen: Validierende Resolver lehnen die Domain dann ab, sodass Absender hinter einem solchen ihren MX nicht finden und Absender mit DANE Mail an sie aufschieben. Der Abschnitt führt außerdem dieDNSKEY-Schlüssel jeder Zone auf, die dieser Host bedient, und warnt vor einem veralteten Algorithmus, einem RSA-Schlüssel unter 2048 Bit, einem Schlüssel, den sich diese Zonen teilen, und einem bekanntermaßen kompromittierten Schlüssel. Mit--offlineübersprungen; in--jsonist esown_dnssec.S/MIME-Vertrauensanker — jeder aktivierte Vertrauensanker, der für jede Mail-Domain bürgt (kein
pepsi-keys ca scopeund keinenameConstraints), ist eine Warnung; in--jsonist esunscoped_anchors.
Von jemand anderem gewählter Text — die Antwort eines entfernten MTA, ein Betreff, ein Hostname — bekommt seine Steuerzeichen ersetzt, bevor er ausgegeben wird, sodass eine Terminal-Escape-Sequenz den Bildschirm des Betreibers über SSH nicht übermalen kann.
--json gibt den gesamten Bericht als ein JSON-Objekt für Überwachungssysteme aus, und --limit begrenzt die Listen der steckengebliebenen Nachrichten, der Postfachquoten, der Schlüsselwechsel, der nicht ausgerichteten DMARC-Quellen und der RSA-Entschlüsselungsschlüssel.
70.3. Eine Anmerkung zu „jüngsten Erfolgen“¶
Eine erfolgreich zugestellte Nachricht wird aus der Warteschlange gelöscht, sodass es kein Zustell-Journal pro Nachricht gibt. Die Zustellzahlen sind daher die seit der Erstellung des Schemas angesammelten kumulativen Zähler — Lebenszeit-Gesamtwerte, kein gleitendes Zeitfenster. Nur der Warteschlangen-Schnappschuss und der TLS-Abschnitt (der nach Berichtstag geschlüsselt ist) spiegeln wirklich jüngste Aktivität wider.
70.4. Siehe auch¶
pepsi-queue, pepsi-quota, pepsi-tlsrpt, pepsi-dispatch, Architektur, pepsi-status(1), pepsi.conf(5).