Commandes OpenSSL pour CSR : RSA, ECDSA, SAN et erreurs courantes

La seule commande dont la plupart des gens ont besoin
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"À lire ainsi : créer une nouvelle requête, générer une nouvelle clé en même temps, ne pas chiffrer la sortie de la clé (-nodes), écrire la clé dans privkey.pem et la requête dans request.csr, définir le subject à CN=example.com, et ajouter une extension SAN couvrant le domaine apex et l'hôte www.
Deux options prêtent à confusion :
-nodes(abréviation de « no DES ») signifie que la clé privée est écrite en clair. Retirez-le et une passphrase vous sera demandée, que la plupart des serveurs ne peuvent pas utiliser au démarrage.-addextnécessite OpenSSL 1.1.1+. Sur les versions plus anciennes, la commande perd silencieusement la prise en charge du SAN.
RSA 4096
Même commande, clé plus grande :
openssl req -new -newkey rsa:4096 -nodes \
-keyout privkey.pem -out request.csr \
-subj "/CN=example.com" \
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"Le RSA 4096 coûte nettement plus de CPU à chaque handshake pour un gain de sécurité modeste. Si vous voulez une cryptographie plus solide, ECDSA est le meilleur compromis.
ECDSA P-256 et P-384
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"Remplacez prime256v1 par secp384r1 si la CA exige de l'ECDSA 384 bits. Notez que certaines anciennes piles Android et Windows échouent encore sur les chaînes ECDSA — vérifiez votre trafic avant de basculer.
De nombreux SAN, ou une adresse IP
Pour une longue liste de SAN, -addext devient peu pratique. Utilisez un fichier de configuration :
# csr.cnf
[req]
default_bits = 2048
prompt = no
default_md = sha256
distinguished_name = dn
req_extensions = v3_req
[dn]
CN = example.com
[v3_req]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
IP.1 = 192.0.2.10openssl req -new -newkey rsa:2048 -nodes \
-keyout privkey.pem -out request.csr -config csr.cnfLa ligne req_extensions est celle qui compte. Sans elle, vous obtenez un CSR parfaitement valide sans aucun SAN — et un rejet de la CA indiquant que les noms ne correspondent pas.
Vérifier ce que vous avez produit avant de l'envoyer
openssl req -in request.csr -noout -textRecherchez :
- Subject Alternative Name avec tous les noms d'hôte attendus
- Public-Key indiquant 2048 bit (ou id-ecPublicKey avec la bonne courbe)
- Signature Algorithm, par exemple sha256WithRSAEncryption
Vérifiez ensuite que la signature est cohérente en interne :
openssl req -in request.csr -noout -verifyUn fichier sain affiche verify OK. S'il affiche « unable to load », le fichier est tronqué — généralement parce qu'il a été copié depuis un terminal qui a coupé les lignes.
Messages d'erreur et leur signification réelle
| Message | Cause réelle | Correctif |
|---|---|---|
Error unpacking CSR | Le fichier est du DER, pas du PEM, ou contient du texte parasite | Convertir : openssl req -inform DER -in request.der -out request.csr |
no start line | En-tête PEM absent ou fins de ligne altérées | Vérifier que le fichier commence par -----BEGIN CERTIFICATE REQUEST----- |
error adding extension | -addext sur OpenSSL 1.0.2 | Utiliser un fichier de configuration |
unable to load private key | Clé protégée par passphrase | Ajouter -passin pass:... ou régénérer sans -passphrase |
| CSR accepted but names rejected | SAN absent ou CN uniquement | Régénérer avec -addext |
Faire correspondre le CSR à sa clé
Avant de déployer, confirmez que le certificat que vous récupérez appartient à la clé sur le serveur :
openssl req -in request.csr -noout -pubkey
openssl pkey -in privkey.pem -puboutLes deux blocs doivent être identiques octet par octet. S'ils diffèrent, vous êtes sur le point d'installer un certificat qui ne correspond pas à votre clé — la cause classique de ssl_error_no_cypher_overlap et de « key values mismatch » de nginx.
L'outil de correspondance des clés effectue la même comparaison dans le navigateur, sans copier le matériel de clé privée où que ce soit.
Pourquoi s'embêter avec la ligne de commande ?
Parce qu'elle est reproductible. Un CSR généré sur un portable en cliquant dans un formulaire est difficile à auditer ; une commande dans un runbook peut être relue, réexécutée et versionnée. Gardez la commande à côté du script de déploiement, et ne commitez jamais privkey.pem — seul le CSR peut être stocké dans un dépôt en toute sécurité.
FAQ
Quelle version d'OpenSSL prend en charge -addext ?
1.1.1 et versions ultérieures. Sous CentOS 7 ou sur d'anciennes versions de macOS, vous pouvez être en 1.0.2, où -addext n'existe pas — utilisez plutôt un fichier de configuration avec [v3_req].
Pourquoi mon CSR n'a-t-il pas de SAN alors que j'ai passé -subj ?
-subj ne définit que le subject (CN). Le SAN provient de -addext ou du fichier de configuration. Un CSR construit avec -subj seul est rejeté par toutes les CA modernes, car les navigateurs ignorent le CN.
Comment vérifier qu'un CSR correspond à une clé privée ?
Comparez la clé publique des deux : openssl req -in request.csr -noout -pubkey et openssl pkey -in privkey.pem -pubout doivent afficher des blocs identiques.
Un CSR peut-il contenir une adresse IP ?
Oui, utilisez IP:192.0.2.10 dans la liste SAN. Les CA publiques délivrent rarement pour des IP publiques, mais les CA internes et les environnements de préproduction Let's Encrypt le font.
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.