Configurer DKIM

Aide du Hub TheSocle · james.domain.dkim.configurer

Génère une nouvelle clé DKIM, range sa partie privée au Vault et publie sa partie publique dans le DNS. À chaque clic, une clé neuve.

Voir l'élément dans l'écran : james/domain-detail

Explication

DKIM signe les messages qui partent du domaine. La clé a deux moitiés :

la clé privée, qui signe : le Hub la range au Vault ;
la clé publique, qui vérifie : le Hub la publie dans le DNS, sous soclehub._domainkey.<domaine>.

Le bouton demande une confirmation, puis génère une paire RSA de 2048 bits. Il faut que la zone du domaine soit au registre des domaines du Hub : sinon, rien n'est écrit et l'écran affiche l'échec.

À chaque clic, une nouvelle paire. La clé privée précédente est remplacée au Vault, et un nouvel enregistrement TXT est demandé au fournisseur DNS. Ne cliquez pas « pour voir » sur un domaine qui signe déjà.

Fiche complète

Requête

POST /hub/james/domains/{domaine}/dkim → james_worker.configure_dkim (domain).

Effets

Où	Quoi
Vault `soclehub/james/dkim/<domaine>`	`private_key` (PEM), `selector: soclehub`, `created_at`
DNS	TXT `soclehub._domainkey.<domaine>` = `v=DKIM1; k=rsa; p=…`
base	`mail.mail_domain.dkim_enabled = true`, `dkim_selector = soclehub`

Réponses

Cas	Message
succès	« DKIM configure pour domaine. »
zone inconnue	« Echec configuration DKIM : No Cloudflare zone found for domain … »
TXT refusé	« … clé DKIM générée et rangée au Vault, mais le fournisseur … n'a pas créé le TXT … »

Pièges

La publication ne branche pas la signature. L'action ne touche pas à la configuration de James : que James signe effectivement avec cette clé ne se vérifie qu'en lisant Authentication-Results sur un message reçu.
Le message d'erreur parle de « Cloudflare » quel que soit le fournisseur de la zone : le Hub 3.77.0 résout pourtant la zone par son registre multi-fournisseur.
Si le TXT n'est pas créé, la clé privée a déjà remplacé l'ancienne au Vault.

Sommaire du démonstrateur