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 nach stage und status, 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 aus state.bounce (entfernter MTA, SMTP-Code, erweiterter Status, Antworttext), dem eigenen state.last_error der Stage und dem state.dispatch_error des Dispatchers (ein abgestürzter oder hängender Worker, eine nicht konfigurierte Stage); durch --limit gedeckelt.

  • 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 viele running-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 = expired zurückgehalten hat, mit den jüngsten von beiden (Adresse, alter und neuer Fingerabdruck, eigener Schlüssel oder Gossip), gelesen aus den key.peer.rotate[.held]-Datensätzen von pepsi.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, sodass p=reject keine 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 --json ist es dkim.

  • Veröffentlichte Schlüssel wie ausgeliefert — beide Methoden des Web Key Directory und die OPENPGPKEY- und SMIMEA-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 --json ist es served_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 = both wird 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 --json ist es rsa_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 signierten SOA von ietf.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). --offline führt die Resolver ohne Prüfung auf; in --json ist es resolvers.

  • 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 sagt validated, insecure, bogus (mit dem Extended DNS Error nach RFC 8914, etwa Signature Expired) oder servfail. bogus und servfail sind 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 die DNSKEY-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 --json ist es own_dnssec.

  • S/MIME-Vertrauensanker — jeder aktivierte Vertrauensanker, der für jede Mail-Domain bürgt (kein pepsi-keys ca scope und keine nameConstraints), ist eine Warnung; in --json ist es unscoped_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).