8. Exploiter Pepsi

Ce chapitre traite des semaines qui suivent l’installation : où se trouvent les journaux, que surveiller, et que sauvegarder pour qu’un disque perdu vous coûte un après-midi plutôt que les clés de tous les utilisateurs. La mise à niveau est décrite dans Mise à niveau, et que faire lorsque quelque chose se passe mal dans Dépannage. Ce que vos utilisateurs voient et peuvent faire, et ce que signifie la protection dont ils bénéficient, fait l’objet du chapitre suivant, Utiliser Pepsi : un guide pour les utilisateurs, écrit pour eux et que vous pouvez librement copier dans vos propres pages d’aide.

8.1. Journaux

Chaque programme de Pepsi journalise sur la sortie d’erreur standard. Sous les unités systemd livrées, il s’agit du journal, une unité par programme de longue durée :

journalctl -u pepsi-ingress -u pepsi-dispatch -u pepsi-httpd --since today
journalctl -u pepsi-dispatch -f          # follow the pipeline live
journalctl -u 'pepsi-*' -p warning       # warnings and errors, every unit

Les programmes d’étape n’ont pas d’unités propres : le dispatcher les lance comme workers et ils héritent de sa sortie d’erreur standard, de sorte que tout ce qu’une étape journalise apparaît sous pepsi-dispatch. Chaque enregistrement nomme le programme qui l’a écrit. Les timers (rafraîchissement des clés, réconciliation des quotas, élagage des journaux, …) journalisent sous leurs propres noms .service ; systemctl list-timers 'pepsi-*' les liste avec leur dernière et leur prochaine exécution.

8.1.1. Niveaux de journalisation

Les niveaux sont error, warn, info (par défaut), debug et trace.

  • [pepsi] LOG fixe le niveau pour tous les programmes à la fois, y compris les workers des étapes, qui ne reçoivent aucune option de ligne de commande du dispatcher. Redémarrez les services après l’avoir modifié (le dispatcher redémarre lui-même ses workers).

  • -L LEVEL (avant la sous-commande, p. ex. pepsi-queue -L debug list) le remplace pour un seul processus, ce qui est la manière habituelle d’examiner de plus près un outil lancé à la main.

  • -v affiche aussi les enregistrements que les bibliothèques de base de données, HTTP et TLS écrivent elles-mêmes, et qui sont masqués sinon. C’est utile pour un problème de connexion, mais très bavard.

  • [pepsi] LOG_JSON = yes écrit un objet JSON par enregistrement, pour un agrégateur de journaux.

info enregistre une ligne ou quelques-unes par message et par étape. warn garde ce qui demande de l’attention et convient à un hôte chargé. debug et trace peuvent inclure les adresses d’enveloppe et des détails de protocole ; ne les laissez pas activés. Aucun niveau n’écrit le contenu des messages, si bien que du texte clair déchiffré ne finit pas dans le journal (voir Courrier déchiffré, clés ou objets conservés dans les journaux et le stockage local). C’est aussi dans le journal que se trouve l’adresse d’un client de soumission : un écouteur de soumission la tient hors de l’en-tête Received: du message (RECEIVED_PRIVACY). Si vous recevez une plainte pour abus concernant un message envoyé par l’un de vos utilisateurs, vous remontez donc sa trace ici, et non à partir de l’en-tête. Il vous faut pour cela l’identifiant de file et l’heure que pepsi-ingress a journalisés en acceptant le message.

8.1.2. Ce qui est conservé, et pour combien de temps

La rétention du journal est celle de systemd (journald.conf). Dans la base de données, Pepsi conserve :

  • le journal d’audit (pepsi.event_log) : qui a modifié quoi, depuis les outils en ligne de commande, l’API et la console, élagué chaque jour par pepsi-log-prune.timer ;

  • aucun journal de remise par message, à moins que vous n’activiez [pepsi] MAIL_LOG (voir pepsi.conf(5) et l’avertissement sur la vie privée qui s’y trouve). Un message remis est supprimé de la file d’attente, de sorte que sans lui le journal est la seule trace du passage d’un message ;

  • les compteurs de rapports TLS (pepsi.tls_session), élagués par pepsi-tlsrpt-prune.timer ;

  • les rapports agrégés DMARC que d’autres destinataires ont envoyés au sujet des domaines servis (pepsi.dmarc_report, lus par pepsi-stage-dmarc-report), supprimés par pepsi-queue gc (pepsi-origin-gc.timer, toutes les heures) une fois leur période terminée depuis plus de [pepsi-dmarc-reports] RETAIN_DAYS (90) jours.

8.2. Surveillance

Deux choses vous disent si le courrier circule : la file d’attente, et les messages que le pipeline a abandonnés.

8.2.1. pepsi-status

pepsi-status est un résumé en lecture seule de la file d’attente, des messages bloqués avec la raison de chacun, des compteurs cumulés par étape, des résultats TLS sortants, des quotas de boîtes aux lettres et des changements de clés récents. Il montre aussi ce que les rapports agrégés DMARC disent des domaines servis, et ce que le Web Key Directory et le DNS servent pour chaque identité publiée. Cette dernière section est la seule qui interroge le réseau (--offline l’omet). On peut lancer la commande sans risque à tout moment, et --json fournit le même rapport à un script :

pepsi-status
pepsi-status --json | jq .problem_total

problem_total est le nombre de messages en failed ou timeout. Le dispatcher ne les réessaie jamais ; pepsi-failure-bouncer.timer les fait rebondir vers leurs expéditeurs une fois qu’ils sont en échec depuis MIN_AGE (une heure ; voir Messages en failed ou timeout), de sorte que le compteur revient normalement à zéro de lui-même. S’il ne cesse d’augmenter, la même étape échoue message après message et la cause doit être corrigée. Une défaillance de l’hôte n’apparaît pas ici au début : ses messages attendent en paused à l’étape défaillante (pepsi_pause_backlog) avec l’erreur dans state.last_error, et sont réessayés jusqu’au MAX_LIFETIME de l’étape.

Un WARNING sous Published keys as served signifie qu’un correspondant qui recherche cette adresse reçoit une clé que le magasin de clés ne publie pas pour elle (Vérifier ce qui est réellement servi). La cause peut être un autre serveur web qui répond pour l’apex du domaine pour la méthode directe WKD, un enregistrement DNS resté d’une rotation, ou quelqu’un qui a pu écrire dans la zone ou sur un serveur web du domaine. Comparez pepsi-keys identity list --served --address ADDRESS avec pepsi-keys dns ADDRESS et supprimez ce qui sert la clé étrangère ; d’ici là, le détenteur de cette clé peut lire le futur courrier de l’utilisateur.

Un WARNING sous DMARC aggregate reports signifie que des destinataires ont vu du courrier sous un domaine servi provenant d’une source qui n’alignait ni DKIM ni SPF ; une politique p=reject refuse un tel courrier. La source peut être un service qui envoie au nom du domaine (un outil de lettre d’information, un système de tickets, un CRM hébergé). Un tel service a besoin d’une clé DKIM alignée, ou de SPF avec un expéditeur d’enveloppe dans le domaine, avant que vous ne durcissiez la politique. La source peut aussi être un réexpéditeur, ou une contrefaçon, qui est refusée comme prévu. pepsi-setup check donne le même verdict par domaine, et la console liste chaque source (Logs, DMARC reports). Les rapports n’arrivent qu’à un domaine dont l’enregistrement DMARC nomme l’adresse de l’étape dans rua=, et ils ne sont lus que là où une étape exécute pepsi-stage-dmarc-report. Une configuration sans une telle étape n’en lit aucun. Pour y remédier, ajoutez une section [stage-dmarc-reports] au chemin entrant (juste après decrypt, avant les filtres, là où pepsi-setup --wizard la place), et ajoutez rua=mailto:dmarc-reports@<domain> à l’enregistrement de chaque domaine, ce que pepsi-setup run suggère alors.

8.2.2. /metrics

pepsi-httpd sert des métriques Prometheus à /metrics sur un écouteur marqué ADMIN = yes, et nulle part ailleurs. Le point d’accès ne demande aucun identifiant ; ne marquez donc qu’un écouteur que seul votre système de surveillance peut atteindre. L’API d’administration indique quels écouteurs peuvent porter ce marqueur. Les séries :

Série

Type

Signification

pepsi_stage_active_messages{stage}

jauge

Messages en cours de traitement.

pepsi_pause_backlog{stage}

jauge

Messages en attente d’une nouvelle tentative : un serveur distant qui a différé, une clé en cours de recherche, un paiement attendu.

pepsi_stage_messages_total{stage}

compteur

Messages qu’une étape a traités.

pepsi_stage_duration_seconds_total{stage}

compteur

Temps passé dans l’étape ; divisé par la série précédente, la moyenne.

pepsi_stage_timeouts_total{stage}

compteur

Workers tués pour avoir dépassé le MAX_RUNTIME de l’étape.

pepsi_stage_crashes_total{stage}

compteur

Workers morts pendant le traitement d’un message.

pepsi_messages_processed_total

compteur

Messages sortis du pipeline.

pepsi_stages_executed_total

compteur

Passages d’étape, toutes étapes confondues.

pepsi_quarantine_held_messages{stage}

jauge

Messages qu’une étape de quarantaine retient en attente d’une décision (une partie de pepsi_pause_backlog) ; voir Courrier en quarantaine.

pepsi_greylist_decisions_24h{outcome,reason}

jauge

Décisions de greylisting des dernières 24 heures : l’heure en cours et les 23 précédentes. Les résultats et les motifs sont ceux de pepsi-greylist stats --json ; outcome="expired",reason="never-retried" compte les premières tentatives que l’élagage a supprimées faute de nouvelle tentative.

Les compteurs sont écrits par le dispatcher tous les STATS_INTERVAL et lorsqu’il devient inactif, de sorte qu’ils ont jusqu’à cet intervalle de retard. Ce sont des totaux depuis la création du schéma, non par collecte ; utilisez rate(). La série du greylisting est au contraire une jauge sur une fenêtre glissante, car le démon tient des compteurs horaires et l’élagage supprime les anciens, si bien qu’un total diminuerait. Les compteurs des milters de pepsi-ingress consultés pendant la session SMTP (ingress-milter-reject et consorts) sont des clés de télémétrie, pas des séries de cette liste.

8.2.3. Certificats de la PKI gérée

Là où un domaine commande les certificats de ses utilisateurs auprès d’une AC (Certificats d’une AC commerciale : la PKI gérée), pepsi-keys-mpki.timer lance une passe toutes les cinq minutes, et chaque étape qui peut avoir besoin de vous écrit un avis. Trois commandes montrent où en sont les choses :

pepsi-keys mpki notices --unread
pepsi-keys mpki order list --open
pepsi-keys mpki user list --domain example.org

Une commande retenue vous attend ; order list en nomme le motif, et Le certificat qu’un utilisateur attend de l’AC n’arrive pas dit que faire pour chacun. Une commande failed porte le message de l’AC ou le motif de Pepsi dans last error. Marquez les avis comme lus une fois qu’ils sont traités (mpki notices --read ID ou --read-all, ou dans la console, Certificats gérés) : un avis marqué comme lu l’est pour chaque administrateur. Avec une adresse de notification pour le domaine (mpki domain set DOMAIN --notify ADDRESS) et [pepsi-mpki] NOTIFY_STAGE, chaque passe envoie aussi par courrier les nouveaux avis de ce domaine.

8.2.4. Courrier en quarantaine

Un message qu’un milter met en quarantaine, ou qu’une autre étape achemine vers une étape pepsi-stage-quarantine, y attend votre décision. Pepsi ne prévient personne : l’expéditeur n’apprend pas que le message est retenu, et le destinataire ne le voit pas. pepsi-status compte les messages retenus sous le tableau de la file d’attente (quarantined dans --json), et pepsi-queue les liste et agit sur eux par jeton :

pepsi-queue quarantine list
pepsi-queue quarantine show TOKEN
pepsi-queue --headers --body WORKQUEUE_ID > held.eml
pepsi-queue quarantine release TOKEN
pepsi-queue quarantine delete TOKEN

list indique quand chaque message est arrivé, depuis quand il est retenu, son enveloppe, ainsi que le by et le reason de sa notice : qui l’a envoyé en quarantaine (milter:<name> pour un filtre) et pourquoi. Examinez le contenu avec list --headers --body et le workqueue_id qu’affiche show. release fait suivre le message vers la RELEASE_STAGE de l’étape, qui est normalement init pour le courrier qu’ingress a mis en quarantaine, de sorte que le message parcourt alors tout le pipeline. delete demande d’abord confirmation (--yes dans un script) et consigne la suppression dans le journal de courrier facultatif. Les deux figurent dans le journal d’audit (queue.quarantine-release, queue.quarantine-delete).

Une rétention ne dure pas éternellement. Avec MAX_HOLD, l’étape met fin elle-même à ses rétentions et envoie le message à EXPIRE_STAGE, ou le supprime ; sans cette option, pepsi-queue gc fait rebondir, sans son contenu, un message encore retenu [pepsi-queue] QUARANTINE_MAX_AGE_DAYS (14) jours après son arrivée. Le courrier retenu se trouve en clair dans la base de données tant qu’il est retenu. pepsi-queue clear-all ne touche pas au courrier retenu, pas plus que le webhook de paiement POST /resume.

La page Quarantaine de la console et /api/v1/quarantine listent, libèrent et suppriment le courrier retenu de la même façon, avec les mêmes natures d’événement dans le journal d’audit (queue:read pour consulter, queue:write pour agir ; Quarantaine), et pepsi_quarantine_held_messages sur /metrics le compte.

8.2.5. Greylisting

Là où pepsi-greylist tourne, pepsi-status comporte une section Greylisting : si le démon répond sur sa socket, et les dernières 24 heures par résultat. pepsi-greylist stats affiche la même chose pour un nombre d’heures quelconque, et --json pour un script :

pepsi-greylist stats --hours 168
pepsi-greylist list --pending --rcpt alice@example.org
pepsi-greylist list --never-retried --domain example.net

Deferred compte les premières tentatives ; passed on retry et passed from another host les nouvelles tentatives qui sont revenues ; never retried les premières tentatives dont la fenêtre de nouvelle tentative s’est close sans nouvelle tentative. Une forte proportion de tentatives jamais renouvelées est précisément ce à quoi sert le greylisting, sauf si elles viennent d’un vrai correspondant : un domaine qui y apparaît avec une identité spf ou ptr est un vrai système de messagerie qui ne réessaie pas, et son courrier est perdu à cause du greylisting. Laissez-le passer :

pepsi-greylist allow domain example.net --note 'does not retry'
pepsi-greylist allow network 198.51.100.0/24 --expires '90 days'
pepsi-greylist rules
pepsi-greylist unrule 7

Une règle de domaine s’applique aussi au domaine de l’expéditeur d’enveloppe, que n’importe qui peut écrire ; pour un expéditeur sans SPF, une règle de réseau est le choix le plus restreint. Un utilisateur peut supprimer le délai pour un correspondant en l’inscrivant sur sa whitelist, que le démon lit (WHITELIST_BYPASS). Chaque modification de règle figure dans le journal d’audit (greylist.rule.added, greylist.rule.removed).

Errors désigne les destinataires laissés passer parce que la base de données ou le DNS n’a pas répondu à temps. Quelques-uns pendant un redémarrage de la base de données sont normaux ; un flux continu signifie que le greylisting est pour l’essentiel inopérant.

La page Liste grise de la console (Greylisting) montre les mêmes compteurs, les triplets avec les mêmes filtres et les règles, et avec config:write elle ajoute et supprime des règles (origin = console). Les utilisateurs connectés pour leur propre adresse voient sous Courrier différé ce qui leur a été différé, et peuvent y inscrire un expéditeur qu’ils connaissent sur leur propre whitelist, que le démon lit ensuite (Quand le premier message d’un nouveau correspondant arrive en retard). /metrics fournit les compteurs des dernières 24 heures sous pepsi_greylist_decisions_24h.

8.2.6. Sur quoi alerter

Condition

Pourquoi

pepsi-status --json indique un problem_total supérieur à zéro pendant plus de MIN_AGE plus dix minutes

Un message a échoué et n’a pas rebondi : pepsi-failure-bouncer.timer ne s’exécute pas (systemctl list-timers), ou le rebond lui-même a échoué. Les messages qui échouent à l’étape de rebond ne rebondissent pas à nouveau et vous attendent.

pepsi_pause_backlog d’une étape autre que de remise qui augmente, ou le journal qui répète « failed at stage … retrying »

Une défaillance de l’hôte à cette étape (une clé ou un modèle illisible, un helper qui ne peut démarrer, une instruction refusée). Ses messages sont retenus, non renvoyés en rebond, jusqu’à MAX_LIFETIME ; state.last_error dit pourquoi.

pepsi-status --json indique un quarantined supérieur à zéro, ou min_over_time(sum(pepsi_quarantine_held_messages)[24h:1h]) > 0 (la quarantaine n’a pas été vide depuis un jour)

Du courrier attend une décision à une étape de quarantaine (voir Courrier en quarantaine). Personne d’autre n’est prévenu, et la rétention se termine par un rebond ou une suppression si personne ne décide.

Le dispatcher qui journalise « the worker refused to start » pour une étape

La configuration de l’étape ou un secret qu’elle lit ne s’analyse plus ; ses messages sont retenus jusqu’à ce que ce soit à nouveau le cas.

pepsi_pause_backlog d’une étape de relais qui augmente pendant des heures

Le saut suivant, le DNS ou le port 25 sortant est injoignable. Les nouvelles tentatives continuent jusqu’à MAX_LIFETIME, puis les expéditeurs reçoivent des rebonds.

rate(pepsi_stage_crashes_total[15m]) ou rate(pepsi_stage_timeouts_total[15m]) supérieur à zéro

Un programme d’étape échoue ; ses messages finissent en failed ou timeout.

rate(pepsi_messages_processed_total[1h]) à zéro alors que du courrier est attendu

Rien ne sort du pipeline : le dispatcher est arrêté ou une étape est bloquée.

pepsi-status --json liste une adresse served_keys avec un canal dont le verdict est mismatch

Une clé que le magasin ne publie pas est distribuée pour cette adresse ; quiconque détient cette clé peut donc lire le futur courrier adressé à cette adresse (voir plus haut). Lancez la vérification selon le calendrier de l’hôte de surveillance, pas toutes les minutes : chaque exécution récupère chaque identité publiée.

Une unité pepsi-* dans l’état failed (systemctl --failed)

Les unités de longue durée réessaient indéfiniment, de sorte qu’une unité en échec est en général un timer ou une tâche ponctuelle.

pepsi-status --json liste un enregistrement own_dnssec dont le verdict est bogus (ou servfail)

La chaîne de confiance DNSSEC d’un domaine servi est rompue, par exemple par une signature expirée, ou par un enregistrement DS chez le parent qui ne correspond à aucun DNSKEY publié après un renouvellement de clé. Tout résolveur validant refuse alors le domaine : les expéditeurs qui en utilisent un ne trouvent pas son MX, et ceux qui utilisent DANE diffèrent le courrier qui lui est destiné. detail nomme l’Extended DNS Error ; réparez les signatures de la zone ou l’enregistrement DS. Le même constat fait échouer pepsi-setup-check.service.

pepsi-setup-check.service a échoué

Le pepsi-setup check --fail-on-findings quotidien a trouvé un enregistrement DNS manquant, erroné, invalide ou injoignable depuis Internet, ou cet hôte sur une liste de blocage DNS ; le journal (journalctl -u pepsi-setup-check) contient un avertissement par constat et le rapport complet. Les destinataires refusent alors le courrier du domaine, ou le classent comme indésirable, bien avant que quiconque ne se plaigne. Une requête qui a simplement échoué ne fait pas échouer l’unité. Les boucles de rétroaction des fournisseurs (Microsoft SNDS/JMRP, Gmail Postmaster Tools) ne sont pas lues par Pepsi ; vérifiez-les à la main.

Un courrier « DKIM: DNS changes needed » de pepsi-dkim, ou un avertissement de pepsi-status dans sa section « DKIM keys »

Un enregistrement DKIM manque (les destinataires ne peuvent pas vérifier le courrier signé avec cette clé), une rotation attend ses enregistrements, ou une mise à jour RFC 2136 a été refusée. pepsi-dkim records affiche ce qu’il faut publier (Rotation des clés DKIM).

pepsi-dkim.service ne tourne pas

Les étapes de signature ne peuvent pas signer ; le courrier sortant attend dans la file (il n’est jamais envoyé sans signature) jusqu’au retour du démon.

pepsi-greylist.service qui ne tourne pas là où le greylisting est activé, ou pepsi-status qui avertit que le démon ne répond pas

Le courrier est accepté sans greylisting (un MTA traite le milter manquant comme un échec, et ON_FAILURE = accept laisse passer le courrier).

pepsi-greylist stats --json qui compte des résultats error de façon continue

Le démon ne parvient pas à joindre sa base de données ou son résolveur à temps (DNS_TIMEOUT) et laisse passer ces destinataires sans greylisting.

Un domaine avec une identité spf ou ptr qui revient sans cesse dans pepsi-greylist list --never-retried

Un vrai système de messagerie qui ne réessaie pas : son courrier n’arrive jamais. Autorisez-le (voir ci-dessus).

La proportion de tentatives jamais renouvelées nettement au-dessus de son niveau habituel : sum(pepsi_greylist_decisions_24h{outcome="expired",reason="never-retried"}) / sum(pepsi_greylist_decisions_24h{outcome="deferred",reason="new"}). La plupart des premières tentatives jamais renouvelées sont du spam, la proportion est donc élevée de toute façon ; alertez sur une hausse par rapport à ce que votre site observe d’habitude

Un correspondant qui envoie beaucoup de courrier a cessé de réessayer, ou s’est mis à envoyer depuis des adresses que l’échelle d’identités ne parvient pas à relier entre elles. pepsi-greylist list --never-retried ou la page Liste grise de la console (état Tenté une seule fois) nomme les domaines ; autorisez les vrais.

pepsi_greylist_decisions_24h{outcome="error"} qui augmente

La même chose que les résultats error ci-dessus, sur /metrics.

Enregistrements du journal au niveau error

Tout ce qui est journalisé comme erreur mérite d’être examiné.

L’expiration des certificats TLS

certbot les renouvelle ; un renouvellement qui échoue est journalisé par certbot, non par Pepsi.

L’espace libre là où PostgreSQL conserve ses données

En dessous de [pepsi] MIN_FREE_SPACE (1 GiB par défaut), pepsi-ingress refuse le nouveau courrier avec une erreur temporaire.

Des avis non lus de la PKI gérée de gravité warning ou error (pepsi-keys mpki notices --unread), ou une commande failed dans pepsi-keys mpki order list

Le certificat d’un utilisateur vous attend (un nom à confirmer, la limite quotidienne, une licence ou un identifiant manquant) ou n’a pas pu être commandé. L’avis nomme la commande et la ligne de commande qui la libère ; voir Le certificat qu’un utilisateur attend de l’AC n’arrive pas. Avec une adresse de notification et [pepsi-mpki] NOTIFY_STAGE, les mêmes avis arrivent par courrier.

pepsi-keys-mpki.service a échoué

Une passe de la PKI gérée a rencontré une erreur (journalctl -u pepsi-keys-mpki). Les commandes que l’AC a déjà sont réessayées par la passe suivante ; rien n’est perdu, mais des certificats peuvent arriver en retard.

Un avertissement account.reassigned dans le journal d’audit

Un identifiant de connexion est revenu sous un autre uid, ou après sa suppression : les réglages, listes blanches et quota de son précédent propriétaire ont été abandonnés, et pepsi-setup check liste tout matériel de clé encore détenu pour l’adresse, dont vous devez disposer (Un identifiant de connexion qui change de propriétaire).

8.3. Changer la clé derrière un enregistrement TLSA

L’enregistrement DANE que pepsi-setup run affiche pour chaque écouteur d’entrée TLS (_<port>._tcp.<HOSTNAME> IN TLSA 3 1 1 <hash>) épingle la clé publique du certificat de courrier, non le certificat. pepsi-setup obtient donc les certificats certbot avec --reuse-key et conserve reuse_key = True dans leur configuration de renouvellement, si bien qu’un renouvellement ordinaire n’invalide jamais l’enregistrement. Un changement de clé délibéré (une compromission soupçonnée, le passage à un autre type ou une autre taille de clé) est différent : un expéditeur qui impose DANE refuse de livrer à un hôte dont le certificat ne correspond à aucun enregistrement publié, et les résolveurs continuent de servir l’ancien ensemble d’enregistrements pendant son TTL. Pepsi n’a pas de procédure de renouvellement propre. Vous faites le changement à la main, et vous publiez l’enregistrement de la clé suivante avant que la clé ne soit utilisée :

  1. Créez la clé suivante et son certificat à côté des actuels, comme une lignée certbot distincte que les services n’utilisent pas encore (même nom d’hôte, même méthode de défi que l’original, ici la méthode autonome) :

    certbot certonly --cert-name mx.example.org-next -d mx.example.org \
        --standalone --reuse-key
    
  2. Publiez l’enregistrement de la clé suivante à côté de l’actuel, sous chaque nom où l’enregistrement actuel est publié (un par port TLS). Son empreinte est le SHA-256 du SubjectPublicKeyInfo de la nouvelle clé :

    openssl x509 -in /etc/letsencrypt/live/mx.example.org-next/cert.pem \
        -noout -pubkey | openssl pkey -pubin -outform DER \
        | openssl dgst -sha256 -hex
    
    _25._tcp.mx.example.org. IN TLSA 3 1 1 <current hash>
    _25._tcp.mx.example.org. IN TLSA 3 1 1 <next hash>
    

    Les deux enregistrements sont valides en même temps : un expéditeur accepte un certificat qui correspond à l’un ou l’autre, si bien que le certificat actuel continue de fonctionner.

  3. Attendez l’expiration du TTL de l’ensemble d’enregistrements TLSA (et laissez la zone signée atteindre chaque serveur faisant autorité). D’ici là, un résolveur peut encore détenir l’ancien ensemble, qui ne nomme pas encore la clé suivante.

  4. Passez à la nouvelle clé. Faites pointer chaque section qui nomme l’ancienne lignée (TLS_CERT/TLS_KEY des écouteurs d’entrée) vers /etc/letsencrypt/live/mx.example.org-next/. Les écouteurs de pepsi-httpd ont leur propre lignée, mx.example.org-web, qu’aucun enregistrement TLSA n’épingle. Exécutez ensuite pepsi-setup -c /etc/pepsi/pepsi.conf run (qui maintient reuse_key pour la nouvelle lignée et remet le certificat aux services) et redémarrez les services. pepsi-setup check compare ensuite les enregistrements publiés au certificat désormais servi.

  5. Supprimez l’ancien enregistrement, ainsi que l’ancienne lignée avec certbot delete --cert-name mx.example.org. Dès lors, la nouvelle lignée se renouvelle en conservant sa clé, comme le faisait l’ancienne.

8.4. Rotation des clés DKIM

Les clés privées DKIM et ARC appartiennent au démon de signature, pepsi-dkim (pepsi-dkim.service, compte pepsi-dkim). Chaque domaine de signature a une génération courante de clés, une par algorithme de [pepsi] DKIM_ALGORITHMS (l”ARC_DOMAIN en a aussi une pour ARC_ALGORITHM), sous des sélecteurs nommés d’après le mois où la génération a été créée : pepsi-202610._domainkey.example.org pour RSA et pepsi-202610-ed25519._domainkey.example.org pour Ed25519, pepsi étant [pepsi] DKIM_SELECTOR. Une rotation crée une génération next sous de nouveaux sélecteurs, y bascule la signature une fois ses enregistrements publiés, conserve les anciens enregistrements pendant RETIRE_AFTER_DAYS (14 par défaut) pour que le courrier signé juste avant la bascule se vérifie encore, puis retire les anciennes clés.

8.4.1. Voir ce dont le DNS a besoin

Le démon interroge chaque serveur faisant autorité de chaque zone, toutes les heures (DNS_CHECK_INTERVAL), sur l’enregistrement de chaque clé qui doit figurer dans le DNS, et signale le résultat partout :

  • pepsi-dkim status liste chaque clé avec son état (next, current, retiring, retired) et son verdict DNS (visible, missing, disagree tant qu’un secondaire est en retard, unknown) ; pepsi-dkim records affiche les enregistrements à publier sous forme de lignes de fichier de zone et ceux qui peuvent être supprimés sous forme de commentaires ;

  • pepsi-setup run affiche les enregistrements manquants avec le reste de la zone, et pepsi-setup check évalue chaque enregistrement publié, y compris celui qu’un hébergeur DNS a tronqué (une clé de 3072 ou 4096 bits exige un enregistrement TXT découpé en plusieurs chaînes, ce que certains panneaux d’hébergement abîment) ;

  • pepsi-status (« DKIM keys ») et la page DKIM de la console (/ui/dkim) montrent la même chose ;

  • le démon écrit au postmaster (NOTIFY, NOTIFY_ADDRESS) au plus une fois par jour tant qu’un enregistrement doit être ajouté, qu’un enregistrement d’une clé retirée peut être supprimé, qu’une rotation attend ses enregistrements, ou qu’une mise à jour RFC 2136 a été refusée. Chaque courrier nomme les enregistrements et se répète quotidiennement jusqu’à ce que le changement soit fait.

Un domaine qui n’a pas encore de clés reçoit aussitôt une génération, et signe aussitôt. C’est le cas lors d’une installation neuve, pour un domaine ajouté à la configuration, et sur un hôte restauré sans le répertoire d’état du démon. Tant que ses enregistrements ne sont pas publiés, les destinataires ne peuvent pas vérifier ces signatures et DMARC ne repose que sur SPF ; publiez donc sans attendre ce qu’affiche pepsi-setup run.

8.4.2. Rotation planifiée

La rotation est désactivée par défaut (ROTATION_DAYS = 0) : une génération signe jusqu’à ce que quelqu’un exécute pepsi-dkim rotate. Pour une rotation planifiée, réglez par exemple ce qui suit (le M3AAWG conseille une rotation au moins tous les six mois) :

[pepsi-dkim]
ROTATION_DAYS = 180
# made this long before the switch, to give time to publish (default 28)
ROTATION_LEAD_DAYS = 28

et redémarrez pepsi-dkim.service. ROTATION_LEAD_DAYS avant qu’une génération ait signé pendant ROTATION_DAYS, le démon crée la génération next et demande ses enregistrements. Avec WAIT_FOR_DNS = yes (la valeur par défaut), la bascule attend que chaque serveur faisant autorité serve chacun de ses enregistrements ; les anciennes clés continuent de signer entre-temps, et le retard est signalé et envoyé par courrier. WAIT_FOR_DNS = no bascule selon le calendrier, quoi que serve le DNS, ce qui ne convient que là où autre chose garantit que les enregistrements sont présents.

RETIRE_AFTER_DAYS doit dépasser le SIGNATURE_EXPIRATION_DAYS de chaque étape pepsi-stage-dkim-sign et pepsi-stage-arc (sept jours par défaut) ; pepsi-setup validate le vérifie. Avec SIGNATURE_EXPIRATION_DAYS = 0, les signatures ne portent pas d’expiration, et RETIRE_AFTER_DAYS devrait couvrir le MAX_LIFETIME des étapes de livraison plus quelques jours pour les propres files des destinataires. Au-delà, les anciennes clés privées sont supprimées et les anciens enregistrements peuvent être retirés.

[pepsi-dkim] RSA_BITS (2048, 3072 ou 4096 ; 2048 par défaut) fixe la taille des clés RSA de la génération suivante ; les clés existantes gardent la leur.

8.4.3. Rotation à la demande

pepsi-dkim -c /etc/pepsi/pepsi.conf rotate example.org
pepsi-dkim -c /etc/pepsi/pepsi.conf rotate --hard example.org

À exécuter en tant que root (ou pepsi-dkim). Sans domaine, tous les domaines de signature font une rotation. La première forme crée une génération next et bascule dès que ses enregistrements sont visibles (ou immédiatement avec WAIT_FOR_DNS = no) ; publiez ce qu’affiche pepsi-dkim records. --hard bascule immédiatement, avant que quiconque ait pu publier les nouveaux enregistrements, si bien que le courrier signé avec les nouvelles clés échoue à DKIM jusqu’à leur publication. Cette forme est destinée à une clé qui a pu être exposée (Après l’exposition d’une clé). La page DKIM de la console propose les deux sous rotate now ; le bouton met en file une tâche dkim-rotate que l’applicateur root (pepsi-setup apply) exécute ; il faut donc setup:write et un applicateur en marche.

8.4.4. Publier les enregistrements automatiquement

Là où la zone accepte les mises à jour dynamiques, le démon peut ajouter lui-même les enregistrements de ses clés next et current et supprimer ceux des clés retirées, par UPDATE RFC 2136 authentifié par TSIG :

[pepsi-dkim]
DNS_UPDATE = rfc2136
TSIG_KEY_NAME = pepsi-dkim.example.org.
TSIG_ALGORITHM = hmac-sha256
TSIG_SECRET = <base64 of the key>
# default: the zone's primary, the SOA MNAME
DNS_UPDATE_SERVER = ns1.example.org:53

pepsi-setup déplace TSIG_SECRET dans /etc/pepsi/secrets.d/pepsi-dkim.secret, lisible par pepsi-dkim seul. N’accordez à la clé, sur le serveur DNS, rien d’autre que des mises à jour d’enregistrements TXT sous _domainkey (pour BIND, une update-policy avec des règles subdomain ou wildcard limitées à TXT) : quiconque détient la clé TSIG peut modifier tout ce qu’elle est autorisée à modifier. Un serveur injoignable est réessayé une minute plus tard. Un refus (une mauvaise clé, une politique qui interdit le nom) est enregistré sur la clé, envoyé par courrier au postmaster et n’est pas réessayé avant le redémarrage de pepsi-dkim.service ; corrigez les réglages ou faites le changement à la main, puis redémarrez-le.

8.4.5. Publier les clés retirées

Une signature DKIM permet à quiconque détient une copie d’un message de prouver à un tiers que le domaine l’a envoyé, longtemps après la livraison (Les signatures DKIM rendent le courrier volé attribuable de façon vérifiable). Avec [pepsi-dkim] PUBLISH_RETIRED_KEYS = yes, une clé privée retirée n’est pas supprimée mais écrite dans /var/lib/pepsi-dkim-public/retired/<domain>/<selector>.pem, et pepsi-httpd la sert à https://<host>/.well-known/pepsi-dkim-retired/<domain>/<selector>.pem. Dès lors que n’importe qui peut produire une telle signature, une ancienne ne prouve plus rien. Cette fonction exige la rotation, puisque les clés ne sont retirées que par rotation, et un écouteur HTTPS public ; pepsi-setup validate avertit si l’un ou l’autre manque.

Une clé retirée n’est publiée qu’une fois que chaque serveur faisant autorité a cessé de servir ses enregistrements ; d’ici là le démon la garde non publiée, car n’importe qui pourrait signer au nom du domaine avec une clé publiée dont l’enregistrement se résout encore. Supprimez donc les enregistrements quand le démon les signale supprimables (DNS_UPDATE = rfc2136 le fait lui-même). Une clé dont les enregistrements ne sont jamais supprimés est effacée, non publiée, 90 jours après son retrait.

Note

Les résolveurs peuvent encore détenir un enregistrement supprimé jusqu’à l’expiration de son TTL ; pendant quelques heures après la publication, une signature faite avec la clé publiée peut donc encore se vérifier chez certains destinataires. Gardez court le TTL des enregistrements de sélecteur là où cela compte.

8.5. Rotation de la clé SRS

Le secret SRS ([pepsi-srs] SECRET, dans /etc/pepsi/secrets.d/pepsi-ingress.secret) signe chaque expéditeur d’enveloppe réécrit, et un rebond revient à cette adresse jusqu’à MAX_AGE_DAYS (21 par défaut) plus tard ; il en va de même de l’adresse de retour de réexpédition d’une copie réexpédiée, dont les clés sont dérivées du secret. Remplacer le secret d’un coup ferait échouer la vérification de toutes les adresses encore en circulation, et leurs rebonds seraient refusés. L’ancien secret est donc conservé pour la seule vérification, dans [pepsi-srs] PREVIOUS_SECRET_FILE, jusqu’à ce que la dernière adresse qu’il a signée ait expiré :

  1. Déplacez le secret actuel dans son propre fichier, lisible par root seul jusqu’à l’étape 3, et faites pointer PREVIOUS_SECRET_FILE vers lui :

    install -m 0600 /dev/null /etc/pepsi/secrets.d/srs-previous.secret
    sed -n 's/^SECRET *= *//p' /etc/pepsi/secrets.d/pepsi-ingress.secret \
        > /etc/pepsi/secrets.d/srs-previous.secret
    
    [pepsi-srs]
    PREVIOUS_SECRET_FILE = /etc/pepsi/secrets.d/srs-previous.secret
    
  2. Écrivez un nouveau secret dans la section [pepsi-srs] de secrets.d/pepsi-ingress.secret (SECRET = `` suivi, par exemple, de la sortie de ``openssl rand -hex 32), en laissant toutes les autres lignes du fichier telles quelles.

  3. Exécutez pepsi-setup -c /etc/pepsi/pepsi.conf run. Il donne au fichier du secret précédent le propriétaire et le mode de l’actuel (pepsi-ingress, 0640) et vérifie que les deux peuvent être lus.

  4. Redémarrez pepsi-ingress sans attendre, car il ne lit les secrets qu’une fois, au démarrage. pepsi-stage-srs les lit pour chaque message, et signe donc dès ce moment avec le nouveau secret. Les adresses qui reviennent se vérifient sous l’un ou l’autre secret.

  5. Après MAX_AGE_DAYS jours, retirez PREVIOUS_SECRET_FILE et le fichier, puis redémarrez à nouveau pepsi-ingress. pepsi-setup run et pepsi-setup check indiquent quand ce moment est venu : ils avertissent au sujet d’un fichier de secret précédent modifié pour la dernière fois il y a plus de MAX_AGE_DAYS.

8.6. Après l’exposition d’une clé

Une clé peut avoir échappé à votre contrôle, par exemple par un portable volé portant la clé d’un client de messagerie, par une sauvegarde égarée ou par une étape compromise. Une telle clé reste valide jusqu’à ce que quelqu’un dise le contraire ; rien ne la fait expirer, et les correspondants continuent d’utiliser ce qu’ils ont en cache. Les étapes ci-dessous dépendent de ce qui a été exposé. Chacune est idempotente ; dans le doute, faites-les donc toutes :

  1. La clé OpenPGP d’un utilisateur ou de la passerelle (une identité du magasin de clés) : révoquez-la et publiez la révocation, dans cet ordre d’importance

    pepsi-keys -c /etc/pepsi/pepsi.conf identity revoke ID --reason 'laptop stolen' --upload
    

    Toute révocation, qu’elle vienne de cette commande, de la commande par courrier retire de l’utilisateur ou de la console, construit un certificat de révocation tant que la clé privée existe encore, et le stocke comme moitié publique de la clé. Dès lors, le Web Key Directory sert la clé comme révoquée. Si la clé avait été téléversée sur un serveur de clés, la révocation y est téléversée aussi, car on ne peut pas demander à un serveur de clés d’oublier une clé ; cette commande le fait immédiatement, sinon pepsi-keys identity publish --retry s’en charge. --upload envoie aussi la révocation à un serveur de clés qui n’a jamais eu la clé. Si le certificat ne peut pas être produit, rien n’est révoqué et la commande peut être relancée. La moitié publique de la clé révoquée est conservée pour que les anciennes signatures se vérifient encore, et le message suivant de l’adresse reçoit une nouvelle clé selon la politique habituelle (Gestion des clés). Les correspondants apprennent la révocation par le serveur de clés et le Web Key Directory lorsqu’ils rafraîchissent, et par l’en-tête Autocrypt du prochain courrier de l’utilisateur. Un correspondant qui ne rafraîchit rien continue de chiffrer vers l’ancienne clé, et il n’y a pas de remède à cela. La propre clé MUA d’un utilisateur n’est révoquée ici que localement : sa moitié privée, et donc son certificat de révocation, se trouve dans son client.

  2. Le certificat S/MIME d’un utilisateur : demandez à l’AC émettrice de le révoquer (Pepsi ne le peut pas ; la CRL de l’AC est ce que verront les correspondants qui vérifient), puis révoquez l’identité comme ci-dessus (il n’existe pas de certificat de révocation pour S/MIME, et --upload n’a pas de sens) pour que cet hôte cesse de signer avec.

  3. La clé d’un correspondant dont vous avez appris l’exposition (il vous l’a dit, ou sa révocation ne vous est jamais parvenue) : supprimez la copie en cache ; le message en cours est alors traité comme pour un correspondant sans clé, selon l”ON_NO_KEY de l’étape de chiffrement

    pepsi-keys -c /etc/pepsi/pepsi.conf peer list --address ADDRESS
    pepsi-keys -c /etc/pepsi/pepsi.conf peer remove PEER-KEY-ID
    

    Une AC dont la clé est exposée est désactivée ou supprimée de la même façon (pepsi-keys ca disable CA-ID, ca remove CA-ID). Ensuite, aucun certificat qu’elle a émis ne se vérifie plus ici. Un certificat S/MIME que son AC a listé est retiré automatiquement dès que pepsi-keydisc récupère cette CRL (pepsi-keydisc).

  4. La clé de chiffrement de clés (secrets.d/pepsi-crypto.secret) ou le processus du rôle pepsi-crypto : toutes les clés privées du MTA étaient lisibles. Faites une rotation de la KEK (pepsi-keys wrap rotate), puis révoquez et recréez chaque identité concernée comme à l’étape 1 ; la rotation seule ne fait que ré-envelopper des clés qu’un attaquant détient peut-être déjà en clair.

  5. La clé TLS d’un écouteur : obtenez un certificat pour une nouvelle clé et publiez d’abord son enregistrement TLSA, comme le décrit Changer la clé derrière un enregistrement TLSA, puis faites révoquer l’ancien certificat par son AC (certbot revoke --cert-name mx.example.org --reason keycompromise pour une lignée certbot). Les pairs qui valident par DANE cessent d’accepter l’ancienne clé une fois l’ancien enregistrement disparu. Les pairs qui valident par PKIX ne voient la révocation que s’ils la vérifient ; Pepsi lui-même vérifie une réponse OCSP agrafée et refuse un certificat révoqué sur une session validante, mais ne récupère aucun statut. La clé du serveur web (la lignée mx.example.org-web de pepsi-httpd) est une clé distincte qu’aucun enregistrement TLSA n’épingle : remplacez-la avec certbot renew --cert-name mx.example.org-web --force-renewal --new-key et révoquez l’ancien certificat ; la clé de courrier n’est pas concernée. Son certificat nomme bien HOSTNAME ; tant que la révocation ne les a pas atteints, les expéditeurs et clients de messagerie qui authentifient le MX par PKIX seul peuvent donc être trompés avec lui.

  6. Une clé DKIM ou ARC, ou le compte pepsi-dkim : faites immédiatement une rotation avec pepsi-dkim rotate --hard DOMAIN (Rotation des clés DKIM), publiez les nouveaux enregistrements qu’affiche pepsi-dkim records, et supprimez tout de suite les enregistrements de l’ancien sélecteur au lieu d’attendre RETIRE_AFTER_DAYS. Le courrier signé avant la bascule échoue alors à DKIM en chemin, ce qui coûte moins que de laisser le détenteur de la clé signer au nom du domaine. Ne publiez pas une clé exposée avec PUBLISH_RETIRED_KEYS avant que ses enregistrements aient disparu. Une étape compromise tournant sous pepsi ne pouvait pas lire les clés, mais a pu faire signer du courrier pendant qu’elle tournait : le journal du démon nomme chaque signature et le processus demandeur.

Quoi qu’il ait été exposé, le journal d’audit (GET /api/v1/events ; pepsi-keys et pepsi-queue y écrivent) montre à quoi la clé a servi après le moment suspecté, et Un identifiant de connexion qui change de propriétaire ce que perd un identifiant de connexion recyclé.

8.7. Sauvegarde et restauration

Avertissement

Un vidage de la base de données ne constitue pas à lui seul une sauvegarde de Pepsi. Les clés privées de la base de données sont chiffrées sous une clé de chiffrement de clés conservée, à dessein, hors de la base de données, dans /etc/pepsi/secrets.d/pepsi-crypto.secret. Perdez ce fichier et les clés privées stockées de tous les utilisateurs sont perdues avec lui : rien ne peut plus les ouvrir, et pepsi-setup n’en générera pas de remplaçante tant que des clés chiffrées existent (voir Gestion des clés trop difficile : clients de messagerie de bout en bout sources d’erreurs ou inutilisés). La frontière de garde que cette séparation maintient est décrite dans La frontière de garde des clés privées, et ce qu’une copie de la seule base de données livre ou non dans Quelqu’un qui détient une copie de la base de données.

8.7.1. Que sauvegarder

Quoi

Ce qui est perdu sans cela

/etc/pepsi/secrets.d/, avant tout pepsi-crypto.secret

pepsi-crypto.secret : toutes les clés privées stockées (voir plus haut). Les autres fragments : la clé SRS (les rebonds vers du courrier réacheminé avant la perte sont refusés), le poivre du lien sécurisé (les messages sécurisés pas encore retirés ne peuvent plus être ouverts), la clé de preuve d’origine (les demandes de paiement pour du courrier envoyé avant la perte ne sont plus reconnues comme les nôtres), ainsi que les mots de passe et jetons que vous avez saisis (mots de passe du smarthost et LMTP, mot de passe de liaison LDAP de la découverte de clés, mot de passe de l’API des listes, identifiants client OAuth du rafraîchisseur de jetons, et les clés d’API mpki-<domain>.secret des comptes d’AC de la PKI gérée, sans lesquelles aucun certificat n’est commandé, renouvelé ni révoqué tant que vous n’avez pas stocké de nouveau une clé). Un secret SRS retiré nommé par [pepsi-srs] PREVIOUS_SECRET_FILE a lui aussi sa place dans la sauvegarde tant qu’il est configuré.

La base de données PostgreSQL (pepsi par défaut)

La file d’attente, les réglages par utilisateur, les listes blanches, les listes de diffusion et leur archive, le magasin de clés, les quotas, les comptes d’administrateur et les jetons d’API, le journal d’audit.

/etc/pepsi/ (le reste)

La configuration. Elle peut être réécrite avec l’assistant, mais pas rapidement.

/var/lib/pepsi-dkim/

Laissez-le de côté. Il contient les clés privées DKIM et ARC, qui n’ont rien à faire dans une sauvegarde : une copie est un endroit de plus d’où elles peuvent fuir. Après une restauration sans lui, le démon génère de nouvelles clés sous de nouveaux sélecteurs et signe aussitôt avec, ce qui équivaut à une rotation ; publiez les enregistrements qu’affiche pepsi-setup run et supprimez les anciens. Tant que les nouveaux enregistrements ne sont pas publiés, DKIM échoue chez les destinataires et DMARC repose sur SPF.

/var/lib/pepsi-wallets/

Avec pepsi-stage-auto-pay en mode portefeuille partagé : les portefeuilles et l’argent qu’ils contiennent. En mode local-user, les portefeuilles se trouvent dans les répertoires personnels des utilisateurs.

/etc/letsencrypt/

Rien de permanent ; certbot obtient de nouveaux certificats. Conservez-le néanmoins si vous publiez des enregistrements DANE (TLSA) pour la clé actuelle.

/var/pepsi/tokens, /var/pepsi/token-refresh, /var/pepsi/tls

Seulement avec un smarthost OAuth ou à certificat client : le jeton de rafraîchissement doit être autorisé à nouveau.

Les boîtes aux lettres des utilisateurs (Maildir, ou le stockage du MDA derrière LMTP) n’appartiennent pas à Pepsi et relèvent de votre sauvegarde ordinaire des répertoires personnels.

Conservez les fichiers et le vidage de la base de données ensemble, et pris au même moment : un vidage plus récent que secrets.d peut contenir des clés enveloppées sous une clé de chiffrement de clés que la sauvegarde des fichiers n’a pas. Les deux contiennent des secrets ; stockez-les chiffrés et lisibles par root seulement. Le vidage de la base de données contient aussi les messages en file, qui, pour le courrier que Pepsi a déchiffré, sont en clair (voir Courrier déchiffré, clés ou objets conservés dans les journaux et le stockage local).

8.7.2. Effectuer une sauvegarde

sudo -u pepsi-owner pg_dump --format=custom pepsi > pepsi-$(date +%F).dump
tar -C / -czpf pepsi-files-$(date +%F).tar.gz \
    etc/pepsi var/pepsi var/lib/pepsi-wallets

Exécutez en tant que root, afin que tar puisse lire secrets.d. Un [pepsi-mpki] CREDENTIAL_DIR situé hors de /etc/pepsi doit être ajouté à la commande tar. pg_dump prend un instantané cohérent pendant que les services tournent ; les fichiers changent rarement (une nouvelle clé, une modification de configuration), il suffit donc de les prendre juste avant ou juste après le vidage. Le nom de la base de données et son propriétaire sont ceux de [pepsi-postgres].

Le vidage inclut la liste des clés connues comme compromises (pepsi.compromised_key, environ 240 Mo). C’est la seule grande table dont une restauration pourrait se passer : l’exclure (--exclude-table-data=pepsi.compromised_key) garde le vidage petit, et après une restauration pepsi-keys blocklist update --force récupère à nouveau la liste. Les modules que pepsi-keys peer screen a factorisés (source screen) sont cependant perdus jusqu’à ce que le prochain criblage les retrouve.

Le vidage que pepsi-setup schema --backup-dir effectue avant une mise à niveau (voir Sauvegarder avant une mise à niveau du schéma) ne couvre que la base de données, et seulement le schéma pepsi, et seuls les deux plus récents de ces vidages sont conservés ; il ne remplace pas ceci.

8.7.3. Restauration

Restaurez sur un hôte exécutant la même version de Pepsi que celle dont provient la sauvegarde (mettez à niveau ensuite, si vous le souhaitez), dans cet ordre :

  1. Installez Pepsi. Le paquet Debian crée les comptes de service et les rôles de base de données ; sur une installation depuis les sources, créez-les comme dans Installation.

  2. Arrêtez tout : systemctl stop pepsi.target.

  3. Restaurez les fichiers, secrets.d en premier. tar conserve les propriétaires par nom, les comptes doivent donc exister avant que vous ne décompressiez :

    tar -C / -xzpf pepsi-files-2026-10-01.tar.gz
    
  4. Restaurez la base de données dans une base vide appartenant au propriétaire du schéma :

    sudo -u postgres dropdb --if-exists pepsi
    sudo -u postgres createdb -O pepsi-owner pepsi
    sudo -u pepsi-owner pg_restore -d pepsi pepsi-2026-10-01.dump
    
  5. Exécutez pepsi-setup -c /etc/pepsi/pepsi.conf run. Il réapplique les droits des rôles, réécrit ce qui vit hors des deux sauvegardes (les drop-ins systemd qui remettent les certificats TLS aux services) et fait créer par pepsi-dkim de nouvelles clés DKIM et ARC, puisque celles-ci ne sont pas dans la sauvegarde. Il ne remplace aucune clé ni aucun secret qui existe déjà. Publiez les enregistrements DKIM qu’il affiche (nouveaux sélecteurs) et supprimez les enregistrements des anciens sélecteurs.

  6. Démarrez les services : systemctl start pepsi.target.

Si pepsi-setup indique qu’il refuse de générer une clé de chiffrement de clés parce que des identités existent, secrets.d/pepsi-crypto.secret n’a pas été restauré, ou n’est pas celui qui va avec cette base de données. Ne contournez pas le problème : retrouvez le bon fichier.

8.7.4. Machines virtuelles clonées et restaurées

Chaque clé, nonce et secret que produit Pepsi vient du générateur de nombres aléatoires du système d’exploitation. Sur une machine virtuelle, l’état de ce générateur fait partie de chaque instantané : deux instances démarrées depuis un même instantané, ou une instance restaurée deux fois, peuvent tirer les mêmes octets « aléatoires » jusqu’à ce que quelque chose les réensemence. Avec ENABLE_PEP, un seul hôte génère les clés à long terme de tous les utilisateurs, et pepsi-setup génère la clé de chiffrement de clés ; un état répété les rendrait donc toutes prévisibles d’un coup. Attendre que le générateur soit ensemencé n’aide pas : après un clonage il est ensemencé, avec l’état de l’original.

  • Redémarrez une instance clonée ou restaurée avant qu’elle ne génère quoi que ce soit, et avant qu’elle ne démarre les services Pepsi : un démarrage à neuf réensemence le générateur du noyau, et les processus lancés ensuite y puisent. Restaurer une sauvegarde sur un hôte nouvellement installé n’a pas ce problème ; restaurer une image complète de machine virtuelle, si.

  • Laissez l’hyperviseur l’automatiser. Un hyperviseur qui expose un identifiant de génération de VM (QEMU/KVM -device vmgenid, Hyper-V, VMware) permet au pilote Linux vmgenid de remarquer un clonage ou une restauration et de réensemencer aussitôt le générateur du noyau. Vérifiez que le périphérique est présent (ls /sys/bus/acpi/devices/ | grep -i -e VMGENID -e QEMUVGID) et activez-le là où il ne l’est pas.

  • Pepsi avertit au sujet de ce qu’il a généré juste après un changement. Le pilote annonce le changement par un événement udev, sur lequel la règle udev de Pepsi (60-pepsi.rules) touche /run/pepsi-vmgenid-changed. Générer une clé OpenPGP ou S/MIME (pepsi-keys, l’étape de chiffrement avec ENABLE_PEP), un secret de mot de passe à usage unique, la clé de chiffrement de clés ou un nouvel enveloppement des clés privées dans les dix minutes qui suivent consigne un avertissement nommant ce qui a été produit. Si l’instance n’a pas été redémarrée depuis le changement, redémarrez-la, puis révoquez et régénérez ce que nomment les avertissements (Après l’exposition d’une clé). Sans le pilote, ou sans la règle, rien n’est enregistré et aucun avertissement n’est émis.