Comandi OpenSSL per CSR: RSA, ECDSA, SAN ed errori comuni

L'unico comando che serve quasi a tutti
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"Leggilo così: crea una richiesta nuova, genera una chiave nuova insieme ad essa, non cifrare l'output della chiave (-nodes), scrivi la chiave in privkey.pem e la richiesta in request.csr, imposta il subject su CN=example.com e aggiungi un'estensione SAN che copra il dominio apex e l'host www.
Due flag creano confusione:
-nodes(abbreviazione di « no DES ») significa che la chiave privata viene scritta in chiaro. Se lo rimuovi, ti verrà chiesta una passphrase che la maggior parte dei server non può usare all'avvio.-addextrichiede OpenSSL 1.1.1+. Sulle build più vecchie il comando perde silenziosamente il supporto SAN.
RSA 4096
Stesso comando, chiave più 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"RSA a 4096 bit costa sensibilmente più CPU per ogni handshake a fronte di un modesto guadagno di sicurezza. Se vuoi crittografia più robusta, ECDSA è il compromesso migliore.
ECDSA P-256 e 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"Sostituisci prime256v1 con secp384r1 se la CA richiede ECDSA a 384 bit. Nota che alcuni stack Android e Windows più vecchi falliscono ancora con catene ECDSA: controlla il tuo traffico prima di passare.
Molti SAN, oppure un indirizzo IP
Per un elenco SAN lungo, -addext diventa scomodo. Usa un file di configurazione:
# 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 riga req_extensions è quella che conta. Senza di essa ottieni un CSR perfettamente valido senza alcun SAN, e un rifiuto della CA che dice che i nomi non corrispondono.
Controlla ciò che hai generato prima di inviarlo
openssl req -in request.csr -noout -textCerca:
- Subject Alternative Name con tutti i nomi host attesi
- Public-Key con 2048 bit (o id-ecPublicKey con la curva corretta)
- Signature Algorithm, ad esempio sha256WithRSAEncryption
Poi verifica che la firma sia internamente coerente:
openssl req -in request.csr -noout -verifyUn file sano stampa verify OK. Se stampa « unable to load », il file è troncato, di solito perché è stato copiato da un terminale che ha spezzato le righe.
Messaggi di errore e cosa significano davvero
| Messaggio | Causa reale | Soluzione |
|---|---|---|
Error unpacking CSR | Il file è DER, non PEM, oppure contiene testo estraneo | Converti: openssl req -inform DER -in request.der -out request.csr |
no start line | Manca l'header PEM o i fine riga sono alterati | Verifica che il file inizi con -----BEGIN CERTIFICATE REQUEST----- |
error adding extension | -addext su OpenSSL 1.0.2 | Usa un file di configurazione |
unable to load private key | Chiave protetta da passphrase | Aggiungi -passin pass:... o rigenera senza -passphrase |
| CSR accepted but names rejected | SAN mancante o solo CN | Rigenera con -addext |
Abbinare il CSR alla sua chiave
Prima di distribuire, conferma che il certificato che ricevi appartenga alla chiave sul server:
openssl req -in request.csr -noout -pubkey
openssl pkey -in privkey.pem -puboutI due blocchi devono essere identici byte per byte. Se differiscono, stai per installare un certificato che non corrisponde alla tua chiave: la causa classica di ssl_error_no_cypher_overlap e di « key values mismatch » di nginx.
Lo strumento di corrispondenza chiavi esegue lo stesso confronto nel browser, senza copiare da nessuna parte il materiale della chiave privata.
Perché usare ancora la riga di comando?
Perché è riproducibile. Un CSR generato su un portatile cliccando in un modulo è difficile da auditare; un comando in un runbook può essere rivisto, rieseguito e versionato. Tieni il comando accanto allo script di deploy e non committare mai privkey.pem: solo il CSR si può conservare in un repository in sicurezza.
Domande frequenti
Quale versione di OpenSSL supporta -addext?
La 1.1.1 e successive. Su CentOS 7 o su vecchie build di macOS potresti avere la 1.0.2, dove -addext non esiste: usa invece un file di configurazione con [v3_req].
Perché il mio CSR non ha SAN anche se ho passato -subj?
-subj imposta solo il subject (CN). Il SAN deriva da -addext o dal file di configurazione. Un CSR creato con il solo -subj viene rifiutato da tutte le CA moderne perché i browser ignorano il CN.
Come verifico che un CSR corrisponda a una chiave privata?
Confronta la chiave pubblica di entrambi: openssl req -in request.csr -noout -pubkey e openssl pkey -in privkey.pem -pubout devono stampare blocchi identici.
Un CSR può contenere un indirizzo IP?
Sì, usa IP:192.0.2.10 nell'elenco SAN. Le CA pubbliche raramente emettono per IP pubblici, ma le CA interne e gli ambienti di staging di Let's Encrypt lo fanno.
Strumenti SSL/TLS gratuiti
Verifica e ispeziona i tuoi certificati in pochi secondi.
Informazioni sui certificati
Scopri come scegliere e acquistare certificati SSL.