73. pepsi-dkim¶
Détenir les clés de signature DKIM et ARC, signer pour le pipeline, renouveler les clés et indiquer de quels enregistrements DNS elles ont besoin.
73.1. Rôle¶
pepsi-dkim serve est un service de longue durée (pepsi-dkim.service) qui s’exécute sous son propre compte, pepsi-dkim. Lui seul détient les clés privées de chaque domaine de signature, sous forme de fichiers 0600 dans son répertoire d’état 0700 /var/lib/pepsi-dkim. pepsi-stage-dkim-sign et pepsi-stage-arc calculent eux-mêmes l’empreinte du corps et construisent les champs de signature, envoient le bloc d’en-têtes canonisé via la socket /run/pepsi-dkim/sign.sock (groupe pepsi) et placent dans le champ la valeur de signature que renvoie le démon. Référence : pepsi-dkim(1).
73.2. Pourquoi un démon¶
Les étapes s’exécutent en tant que pepsi, le compte que partagent toutes les étapes ordinaires. Si ces étapes pouvaient lire une clé, un attaquant qui en compromettrait une seule pourrait emporter la clé et continuer de signer pour le domaine après la correction de la faille. Derrière le démon, une étape compromise peut encore faire signer des messages tant qu’elle s’exécute, car tout processus pepsi peut utiliser les clés : par la socket, ou en réécrivant un From: en file que l’étape de signature signe ensuite. Elle ne peut cependant pas copier une clé. Un composant compromis énonce le risque résiduel, et Le démon de signature DKIM décrit le mécanisme.
73.3. Fonctionnalités¶
Signature. Une requête JSON par ligne ; le démon confronte le bloc d’en-têtes à sa politique (un
d=servi, pour DKIM unFrom:aligné avecd=et nommé dansh=, ARC seulement pour[pepsi] ARC_DOMAIN) et signe avec la clé courante. Un démon injoignable rend temporaire l’erreur de l’étape de signature : le message est réessayé, jamais envoyé non signé.Sélecteurs par génération.
<DKIM_SELECTOR>-YYYYMM(RSA,RSA_BITS2048, 3072 ou 4096) et<DKIM_SELECTOR>-YYYYMM-ed25519, de sorte que chaque clé a un nom d’enregistrement qui lui est propre.Cycle de vie
next->current->retiring->retired. Un domaine sans clés reçoit aussitôt une génération courante. Les enregistrements d’une génération en retrait restentRETIRE_AFTER_DAYS(14), plus longtemps que lex=de toute signature ; ensuite ses clés privées sont supprimées, ou publiées avecPUBLISH_RETIRED_KEYSdès que le DNS ne sert plus leurs enregistrements.Renouvellement facultatif (
ROTATION_DAYS, désactivé par défaut), la génération suivante étant crééeROTATION_LEAD_DAYS(28) à l’avance et, avecWAIT_FOR_DNS, la bascule retenue jusqu’à ce que chaque serveur faisant autorité serve ses enregistrements.pepsi-dkim rotate [--hard]et le rotate now de la console basculent à la demande.Vérifications DNS de chaque serveur faisant autorité, toutes les heures par défaut ; mises à jour RFC 2136 facultatives avec TSIG (
DNS_UPDATE = rfc2136).Avis au postmaster par courrier lorsqu’un enregistrement doit être ajouté ou peut être retiré, qu’un renouvellement attend le DNS, ou qu’une mise à jour DNS a été refusée.
Un document d’état public,
/var/lib/pepsi-dkim-public/status.json, lu par pepsi-status, pepsi-setup (run,check), l’API d’administration (GET /api/v1/keys/dkim) et la page DKIM de la console.
73.4. L’exploiter¶
Rotation des clés DKIM dans Exploiter Pepsi est le guide de l’opérateur : publier les enregistrements, activer le renouvellement, renouvellement d’urgence, RFC 2136, et pourquoi les clés sont exclues des sauvegardes.
73.5. Voir aussi¶
pepsi-stage-dkim-sign, pepsi-stage-arc, pepsi-setup, Modèle de sécurité, pepsi-dkim(1).