70. pepsi-status

Résumer la santé du pipeline de messagerie.

70.1. Rôle

pepsi-status est l’aperçu de santé en lecture seule du pipeline destiné à l’opérateur. Il se connecte via la section partagée [pepsi-postgres] et n’a pas de section propre. Il ne modifie jamais une ligne et n’émet aucune notification ; on peut donc l’exécuter sans risque par SSH sur un déploiement en service. Les autres options qu’il lit comprennent [pepsi] MAILBOX_QUOTA (la valeur par défaut du site, dont hérite un compte sans ligne propre), [pepsi-dmarc-reports] WINDOW_DAYS et [pepsi-dkim] PUBLIC_DIR.

Trois sections interrogent le réseau plutôt que la base de données : ce que le Web Key Directory et le DNS servent pour les identités publiées (cette section lit [pepsi-keydiscovery] pour ses délais et son bundle d’AC), si le résolveur auquel se fient les consommateurs DANE valide DNSSEC, et ce qu’il répond pour les domaines servis. --offline saute la première et la dernière et liste les résolveurs sans les sonder. Lorsqu’il est démarré en tant que root, le programme continue sous le compte de service pepsi avant de se connecter, si bien qu’aucun sudo -u pepsi n’est nécessaire. Référence : pepsi-status(1).

70.2. Fonctionnalités

  • File d’attente — l’arriéré pepsi.workqueue ventilé par stage et status, avec l’âge du message le plus ancien dans chaque groupe.

  • Messages bloqués — les messages failed/timeout individuels, les plus anciens d’abord, avec chaque raison notée à leur sujet : l’échec structuré du saut suivant issu de state.bounce (MTA distant, code SMTP, statut étendu, texte de réponse), le state.last_error propre à l’étape et le state.dispatch_error du dispatcher (un worker planté ou bloqué, une étape non configurée) ; plafonné par --limit.

  • Remise et échecs — compteurs cumulatifs dispatch_stats/stage_stats : total de messages traités, nombres de messages par étape, temps de traitement moyen, timeouts et plantages de workers. Un avertissement indique combien de lignes running le dispatcher a trouvées sans worker qui les tienne. Il les remet en place de lui-même, mais chacune signifie qu’une écriture a été perdue : cherchez donc des pannes de base de données dans son journal.

  • TLS sortant — issues tls_session des sept derniers jours de rapport UTC (aujourd’hui compris) groupées par domaine de politique et type de résultat (résultats non réussis marqués), plus les adresses MX que le cache du résolveur a signalées comme échouant à se connecter.

  • Quotas de boîtes aux lettres — chaque compte doté d’une comptabilité de quota, mesure la plus ancienne d’abord (l’ordre dans lequel travaille le balayage reconcile de pepsi-quota), avec sa limite effective, l’utilisation mesurée, l’estimation des remises non mesurées qui s’y ajoute et l’âge de la mesure. Un compte y figure dès que quelque chose lui a été remis, qu’il ait un quota ou non.

  • Changements de clés des correspondants — combien de clés de correspondants la règle Autocrypt du plus récent a remplacées au cours des 30 derniers jours et combien de remplacements ACCEPT_ROTATION = expired a retenus, avec le plus récent des deux (adresse, ancienne et nouvelle empreinte, clé propre ou gossip), lus dans les lignes key.peer.rotate[.held] de pepsi.event_log. Une rotation est le seul moyen par lequel un message qui se contente de prétendre venir d’un correspondant peut changer la clé vers laquelle Pepsi chiffre, raison pour laquelle elle est mise en évidence ici (Clés des correspondants).

  • Rapports agrégés DMARC — par domaine servi, le verdict des rapports authentifiés des derniers WINDOW_DAYS jours que pepsi-stage-dmarc-report a stockés : chaque source était alignée, donc p=reject n’en refuse aucune, ou un avertissement nommant les sources qui ne l’étaient pas (Les rapports agrégés DMARC).

  • Liste des clés connues comme compromises — quand la liste badkeys a été vérifiée pour la dernière fois, et si la dernière mise à jour a échoué.

  • Réputation IP — lesquelles des listes de blocage IP que consulte l’ingress sont à jour (pepsi-reputation), et la dernière auto-vérification des propres adresses et domaines de cet hôte auprès des listes de blocage DNS, chaque inscription étant un avertissement.

  • Clés DKIM — ce que pepsi-dkim(1) indique dans son fichier d’état public : renouvellement activé ou non, et par domaine de signature les clés courantes, suivantes et en retrait avec leur état DNS, les enregistrements à publier ou à retirer, et un renouvellement en attente du DNS. Une clé courante dont l’enregistrement n’est pas visible, un enregistrement dû, un renouvellement retardé, un domaine pour lequel aucune clé ne signe et un fichier d’état manquant sont des avertissements. En --json, c’est dkim.

  • Clés publiées telles que servies — les deux méthodes Web Key Directory et les enregistrements OPENPGPKEY et SMIMEA de chaque adresse ayant une identité publiée et active, récupérés comme le ferait un correspondant et comparés au magasin de clés (Vérifier ce qui est réellement servi) : combien d’adresses sont servies exactement telles que stockées, et chaque canal des autres. Une empreinte que le magasin ne publie pas pour l’adresse est un avertissement (Ce que l’annuaire sert pour nos utilisateurs). Sauté avec --offline ; en --json, c’est served_keys.

  • Clés de déchiffrement RSA — les identités S/MIME actives dont le certificat est RSA et dont Pepsi détient la clé privée pour le déchiffrement, de sorte que le S/MIME entrant qui leur est destiné atteint une opération à clé privée RSA (Oracles de Bleichenbacher temporels et microarchitecturaux (Marvin et successeurs)) ; une identité avec purpose = both est marquée comme partageant sa clé entre signature et déchiffrement. Une ligne INFO indique quoi faire : générer une identité P-256 (pepsi-keys identity generate) afin que le nouveau courrier utilise ECDH, et conserver l’identité RSA pour déchiffrer l’ancien courrier. En --json, c’est rsa_decryption.

  • Résolveur DNSSEC — chaque résolveur dont un consommateur DANE se fie au bit AD (les étapes de relais avec DANE activé, pepsi-keydisc@dane), sondé avec le SOA signé de ietf.org : un résolveur qui ne positionne pas le bit AD est un avertissement, car DANE est alors configuré mais jamais appliqué, de même qu’un résolveur qui n’est pas sur cet hôte (l’hypothèse de résolveur validant de Modèle de sécurité). --offline liste les résolveurs sans les sonder ; en --json, c’est resolvers.

  • DNSSEC propre — si la chaîne de confiance des domaines servis tient : on demande à ce résolveur les enregistrements MX de chaque domaine accepté et les enregistrements TLSA _25._tcp de ses hôtes MX, et il répond validated, insecure, bogus (avec l’Extended DNS Error RFC 8914, telle que Signature Expired) ou servfail. bogus et servfail sont des avertissements : les résolveurs validants refusent alors le domaine, de sorte que les expéditeurs qui se trouvent derrière l’un d’eux ne peuvent pas trouver son MX et que les expéditeurs utilisant DANE diffèrent le courrier qui lui est destiné. La section liste aussi les clés DNSKEY de chaque zone que sert cet hôte et avertit d’un algorithme obsolète, d’une clé RSA de moins de 2048 bits, d’une clé partagée entre ces zones et d’une clé connue comme compromise. Sauté avec --offline ; en --json, c’est own_dnssec.

  • Ancres de confiance S/MIME — chaque ancre de confiance activée qui se porte garante de tous les domaines de courrier (aucun pepsi-keys ca scope et aucune nameConstraints) est un avertissement ; en --json, c’est unscoped_anchors.

Le texte choisi par quelqu’un d’autre — la réponse d’un MTA distant, un objet, un nom d’hôte — voit ses caractères de contrôle remplacés avant d’être affiché, de sorte qu’une séquence d’échappement de terminal ne peut pas repeindre l’écran de l’opérateur via SSH.

--json émet tout le rapport sous forme d’un objet JSON pour les systèmes de surveillance, et --limit plafonne les listes des messages bloqués, des quotas de boîtes aux lettres, des changements de clés, des sources DMARC non alignées et des clés de déchiffrement RSA.

70.3. Une note sur les « succès récents »

Un message remis avec succès est supprimé de la file d’attente, de sorte qu’il n’y a pas de journal de remise par message. Les chiffres de remise sont donc les compteurs cumulatifs accumulés depuis la création du schéma — des totaux sur toute la durée de vie, pas une fenêtre temporelle glissante. Seuls l’instantané de la file d’attente et la section TLS (indexée par jour de rapport) reflètent une activité véritablement récente.

70.4. Voir aussi

pepsi-queue, pepsi-quota, pepsi-tlsrpt, pepsi-dispatch, Architecture, pepsi-status(1), pepsi.conf(5).