Let's Encrypt a-t-il besoin d'un CSR ? (Et quand devez-vous le fournir)

Réponse courte : non, et oui aussi
Let's Encrypt ne vous demande jamais de téléverser un CSR via un formulaire web. Le protocole ACME comporte une étape finalize où le client envoie un CSR, mais le client construit ce CSR lui-même — la clé est générée sur votre machine, signée dans un CSR, et seul le CSR voyage vers la CA.
Donc, dans le cas courant, la réponse est : vous ne créez pas de CSR à la main. Exécutez certbot --nginx -d example.com, et certbot crée privkey.pem et le CSR, accomplit le défi et écrit le certificat.
Il reste quatre situations où vous devez produire le CSR vous-même.
Quand un CSR manuel est réellement nécessaire
| Situation | Pourquoi le client ne peut pas le faire |
|---|---|
| La clé privée réside dans un HSM ou un KMS cloud | La clé ne peut pas être exportée : le CSR doit être signé à l'intérieur de la frontière puis exporté |
| Une CA d'entreprise ou un hébergeur délivre pour vous | Son portail veut un fichier CSR ; il ne voit jamais votre clé |
| Vous réutilisez une clé existante | Le client générerait une nouvelle clé et invaliderait votre clé publique épinglée |
| Vous déboguez un appel finalize échoué | Vous devez inspecter exactement les noms que portait le CSR |
Construire la clé et le CSR avec OpenSSL
Une commande produit les deux fichiers. L'option -addext conserve la liste SAN dans le CSR, c'est ce que Let's Encrypt lit réellement :
openssl req -new -newkey rsa:2048 -nodes \
-keyout privkey.pem -out request.csr \
-subj "/CN=example.com" \
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"Pour une clé ECDSA (plus petite, handshakes plus rapides — parfait pour Let's Encrypt) :
openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -nodes \
-keyout privkey.pem -out request.csr \
-subj "/CN=example.com" \
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"Les deux commandes écrivent privkey.pem sans chiffrement (-nodes). C'est ce dont un serveur web a besoin, et c'est aussi pourquoi le fichier ne doit être lisible que par root.
Vérifier le CSR avant que quiconque ne le signe
openssl req -in request.csr -noout -textTrois éléments comptent dans la sortie :
- Subject Alternative Name liste chaque nom d'hôte. Le CN est décoratif — Let's Encrypt ne valide que sur le SAN.
- Public Key Algorithm et la taille correspondent à ce que vous vouliez (RSA 2048 bits ou P-256).
- Signature Algorithm est présent et correspond au type de clé. Un CSR sans bloc de signature n'est pas un CSR.
Le Décodeur de CSR du site analyse les mêmes champs dans le navigateur si vous préférez ne pas coller le fichier dans un shell.
Ce que la CA fait du CSR
Le flux ACME ressemble à ceci :
- Le client demande une commande couvrant un ensemble d'identifiants.
- La CA distribue les défis (HTTP-01, DNS-01, TLS-ALPN-01).
- Le client prouve le contrôle de chaque identifiant.
- Le client envoie le CSR en POST au point de terminaison finalize.
- La CA vérifie que les noms du CSR sont exactement les identifiants validés, puis délivre.
L'étape 5 est là où la plupart des tentatives manuelles échouent. Si la commande couvre example.com et www.example.com mais que le CSR ne liste que example.com, finalize renvoie une erreur d'incompatibilité d'identifiants. Le CSR ne peut pas ajouter de noms après validation — les deux listes doivent concorder.
Quatre erreurs qui cassent un CSR Let's Encrypt
- SAN absent. Un CSR avec seulement
CN=example.comne valide rien sur les clients modernes ; l'extension SAN est obligatoire. - CN et SAN divergent. Certains outils copient le CN dans le SAN, d'autres non. Inspectez toujours le fichier.
- Joker sans DNS-01.
*.example.comexige un défi DNS TXT ; HTTP-01 ne peut pas prouver un joker. - Clé et CSR issus de runs différents. Si vous régénérez la clé après avoir créé le CSR, le certificat final ne correspondra pas à la clé de votre serveur. Utilisez l'outil de correspondance des clés pour comparer le modulus ou le point public avant de déployer.
Réutiliser une clé au fil des renouvellements
Un CSR n'est pas lié à la durée de vie d'un certificat. Vous pouvez garder la même clé privée pendant des années et ne régénérer que le CSR — certaines équipes le font parce que la clé est épinglée dans la gestion de configuration, ou parce qu'elles font tourner les clés selon un calendrier distinct des certificats.
Le compromis : une clé compromise reste dangereuse jusqu'à ce que vous la fassiez tourner, quel que soit le nombre de renouvellements. Si vous n'avez aucune raison opérationnelle d'épingler la clé, laissez le client en générer une neuve à chaque renouvellement — ce comportement par défaut existe pour une raison.
Le faire directement dans le navigateur
Si le CSR n'est nécessaire que pour être remis à un panneau, le Générateur de CSR produit la clé et le CSR localement et n'en téléverse aucun. Exportez la clé, gardez-la hors réseau, et ne collez que le CSR là où il est demandé.
FAQ
Puis-je coller mon propre CSR dans Let's Encrypt ?
Oui, au niveau ACME. L'appel finalize du client soumet un CSR encodé DER ; un outil qui vous laisse coller un CSR se contente de sauter la génération locale de la clé. Le certificat est délivré pour les noms de ce CSR, qui doivent donc correspondre aux identifiants déjà validés.
certbot écrase-t-il mon CSR ou ma clé ?
certbot crée une nouvelle paire de clés par lignée sous /etc/letsencrypt/live/<domain>/. Si vous remplacez la clé manuellement, les renouvellements continuent d'utiliser le fichier à ce chemin — remplacez-le donc sur place, ou pointez --key-path vers votre propre clé.
Un CSR est-il requis pour un certificat joker ?
Le CSR doit contenir DNS:*.example.com, et le défi ACME doit être DNS-01. Un joker n'est pas autorisé via HTTP-01 : le CSR et le type de défi doivent donc être planifiés ensemble.
Pourquoi mon CSR fonctionne-t-il avec une CA commerciale mais échoue-t-il chez Let's Encrypt ?
Généralement une incompatibilité de noms : les CA commerciales acceptent souvent le CN tandis que Let's Encrypt ne lit que subjectAltName, ou le CSR contient un nom interne qui ne peut pas être validé publiquement.
Outils SSL/TLS gratuits
Vérifiez et inspectez vos certificats en quelques secondes.
Informations associées
En savoir plus sur le choix et l'achat de certificats SSL.