Lệnh tạo CSR bằng OpenSSL: RSA, ECDSA, SAN và các lỗi thường gặp

Một lệnh mà hầu hết mọi người cần
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"Đọc như sau: tạo một yêu cầu mới, sinh khóa mới kèm theo, không mã hóa đầu ra khóa (-nodes), ghi khóa vào privkey.pem và yêu cầu vào request.csr, đặt subject là CN=example.com, rồi thêm phần mở rộng SAN phủ tên miền gốc và www.
Hai flag hay gây nhầm lẫn:
-nodes(viết tắt của "no DES") nghĩa là private key được ghi dạng rõ. Bỏ nó đi, bạn sẽ bị hỏi passphrase mà hầu hết server không thể nhập lúc khởi động.-addextcần OpenSSL 1.1.1+. Trên bản cũ lệnh vẫn chạy nhưng âm thầm thiếu SAN.
RSA 4096
Cùng một lệnh, khóa lớn hơn:
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 4096-bit tốn thêm CPU đáng kể cho mỗi lần bắt tay để đổi lấy mức tăng bảo mật khiêm tốn. Nếu muốn mã hóa mạnh hơn, ECDSA là lựa chọn đáng giá hơn.
ECDSA P-256 và 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"Thay prime256v1 bằng secp384r1 nếu CA yêu cầu ECDSA 384-bit. Lưu ý một số stack Android và Windows cũ vẫn lỗi với chuỗi chứng chỉ ECDSA — hãy xem lưu lượng truy cập trước khi đổi.
Nhiều SAN, hoặc một địa chỉ IP
Với danh sách SAN dài, -addext trở nên rắc rối. Dùng file cấu hình:
# 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.cnfDòng req_extensions mới là dòng quan trọng. Thiếu nó, bạn có một CSR hoàn toàn hợp lệ nhưng không có SAN nào — kèm thông báo từ chối của CA rằng tên không khớp.
Kiểm tra những gì bạn vừa tạo trước khi gửi
openssl req -in request.csr -noout -textTìm:
- Subject Alternative Name với mọi tên máy chủ mong đợi
- dòng Public-Key cho thấy 2048 bit (hoặc id-ecPublicKey với đường cong đúng)
- Signature Algorithm ví dụ sha256WithRSAEncryption
Rồi kiểm tra chữ ký nhất quán nội bộ:
openssl req -in request.csr -noout -verifyFile lành in verify OK. Nếu in "unable to load", file bị cụt — thường do copy ra từ terminal đã xuống dòng.
Thông báo lỗi và ý nghĩa thật sự
| Message | Real cause | Fix |
|---|---|---|
Error unpacking CSR | File là DER, không phải PEM, hoặc có text lạ | Chuyển đổi: openssl req -inform DER -in request.der -out request.csr |
no start line | Thiếu PEM header hoặc xuống dòng bị hỏng | Kiểm tra file bắt đầu bằng -----BEGIN CERTIFICATE REQUEST----- |
error adding extension | -addext trên OpenSSL 1.0.2 | Dùng file cấu hình |
unable to load private key | Khóa được bảo vệ bằng passphrase | Thêm -passin pass:... hoặc tạo lại không dùng -passphrase |
| CSR accepted but names rejected | Thiếu SAN hoặc chỉ có CN | Tạo lại với -addext |
Đối chiếu CSR với khóa của nó
Trước khi triển khai, hãy xác nhận chứng chỉ nhận về thuộc về khóa trên server:
openssl req -in request.csr -noout -pubkey
openssl pkey -in privkey.pem -puboutHai khối phải giống hệt từng byte. Nếu khác, bạn sắp cài một chứng chỉ không khớp khóa — nguyên nhân kinh điển của ssl_error_no_cypher_overlap và "key values mismatch" từ nginx.
Công cụ đối chiếu khóa làm cùng phép so sánh ngay trong trình duyệt, không copy tư liệu private key đi đâu cả.
Tại sao vẫn bận tâm đến CLI
Vì nó có thể tái lập. CSR tạo trên laptop bằng cách click qua form rất khó audit; một câu lệnh trong runbook có thể được review, chạy lại và quản lý phiên bản. Đặt lệnh cạnh script triển khai, và đừng bao giờ commit privkey.pem — chỉ CSR là an toàn để lưu trong repository.
Câu hỏi thường gặp
Phiên bản OpenSSL nào hỗ trợ -addext?
1.1.1 trở lên. Trên CentOS 7 hoặc các bản macOS cũ bạn có thể đang dùng 1.0.2, nơi không có -addext — hãy dùng file cấu hình có [v3_req] thay thế.
Tại sao CSR không có SAN dù tôi đã truyền -subj?
-subj chỉ đặt subject (CN). SAN lấy từ -addext hoặc file cấu hình. CSR tạo chỉ bằng -subj sẽ bị mọi CA hiện đại từ chối vì trình duyệt bỏ qua CN.
Làm sao kiểm tra CSR khớp với private key?
So sánh public key của cả hai: openssl req -in request.csr -noout -pubkey và openssl pkey -in privkey.pem -pubout phải in ra các khối giống hệt nhau.
CSR có chứa được địa chỉ IP không?
Có, dùng IP:192.0.2.10 trong danh sách SAN. CA công khai hiếm khi cấp cho IP public, nhưng CA nội bộ và môi trường staging của Let’s Encrypt thì có.
Công cụ SSL/TLS miễn phí
Xác minh và kiểm tra chứng chỉ của bạn trong vài giây.
Thông tin chứng chỉ liên quan
Tìm hiểu cách chọn và mua chứng chỉ SSL.