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.workqueueventilé parstageetstatus, avec l’âge du message le plus ancien dans chaque groupe.Messages bloqués — les messages
failed/timeoutindividuels, les plus anciens d’abord, avec chaque raison notée à leur sujet : l’échec structuré du saut suivant issu destate.bounce(MTA distant, code SMTP, statut étendu, texte de réponse), lestate.last_errorpropre à l’étape et lestate.dispatch_errordu 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 lignesrunningle 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_sessiondes 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
reconcilede 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 = expireda retenus, avec le plus récent des deux (adresse, ancienne et nouvelle empreinte, clé propre ou gossip), lus dans les ligneskey.peer.rotate[.held]depepsi.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_DAYSjours que pepsi-stage-dmarc-report a stockés : chaque source était alignée, doncp=rejectn’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’estdkim.Clés publiées telles que servies — les deux méthodes Web Key Directory et les enregistrements
OPENPGPKEYetSMIMEAde 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’estserved_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 = bothest 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’estrsa_decryption.Résolveur DNSSEC — chaque résolveur dont un consommateur DANE se fie au bit AD (les étapes de relais avec
DANEactivé,pepsi-keydisc@dane), sondé avec leSOAsigné deietf.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é).--offlineliste les résolveurs sans les sonder ; en--json, c’estresolvers.DNSSEC propre — si la chaîne de confiance des domaines servis tient : on demande à ce résolveur les enregistrements
MXde chaque domaine accepté et les enregistrements TLSA_25._tcpde ses hôtes MX, et il répondvalidated,insecure,bogus(avec l’Extended DNS Error RFC 8914, telle queSignature Expired) ouservfail.bogusetservfailsont 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ésDNSKEYde 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’estown_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 scopeet aucunenameConstraints) est un avertissement ; en--json, c’estunscoped_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).