Нужен ли Let's Encrypt CSR? (И когда его нужно предоставить самому)

Короткий ответ: нет, и одновременно да
Let's Encrypt никогда не просит загрузить CSR через веб-форму. В протоколе ACME есть шаг finalize, на котором клиент отправляет CSR, но этот CSR клиент строит сам: ключ генерируется на вашей машине, подписывается в CSR, и к CA уходит только CSR.
Поэтому в типичном случае ответ такой: CSR вручную вы не создаёте. Запустите certbot --nginx -d example.com — certbot сам создаст privkey.pem и CSR, пройдёт проверку и запишет сертификат.
При этом есть четыре ситуации, когда CSR действительно нужно получить самостоятельно.
Когда ручной CSR действительно необходим
| Ситуация | Почему клиент не может это сделать |
|---|---|
| Закрытый ключ хранится в HSM или облачном KMS | Ключ нельзя экспортировать, поэтому CSR подписывают внутри границы и экспортируют уже его |
| Сертификат за вас выпускает корпоративный CA или хостинг | Их портал хочет получить файл CSR; ваш ключ они никогда не видят |
| Вы переиспользуете существующий ключ | Клиент сгенерировал бы новый ключ и сделал бы недействительным закреплённый открытый ключ |
| Вы разбираетесь с неудачным вызовом finalize | Нужно точно посмотреть, какие именно имена нёс CSR |
Создайте ключ и CSR с помощью OpenSSL
Одна команда создаёт оба файла. Флаг -addext сохраняет список SAN в CSR — именно его и читает Let's Encrypt:
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"Для ключа ECDSA (меньше по размеру, быстрее рукопожатие — для 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"Обе команды записывают privkey.pem незашифрованным (-nodes). Именно такой файл нужен веб-серверу, и именно поэтому он должен быть доступен для чтения только root.
Проверьте CSR до того, как его кто-либо подпишет
openssl req -in request.csr -noout -textВ выводе важны три вещи:
- Subject Alternative Name перечисляет все имена хостов. CN декоративен — Let's Encrypt проверяет только SAN.
- Public Key Algorithm и размер соответствуют задуманному (2048-битный RSA или P-256).
- Signature Algorithm присутствует и соответствует типу ключа. CSR без блока подписи — не CSR.
Декодер CSR этого сайта разбирает те же поля в браузере, если вы не хотите вставлять файл в shell.
Что CA делает с CSR
Поток ACME выглядит так:
- Клиент запрашивает заказ на набор идентификаторов.
- CA выдаёт проверки (HTTP-01, DNS-01, TLS-ALPN-01).
- Клиент подтверждает контроль над каждым идентификатором.
- Клиент отправляет CSR методом POST на endpoint finalize.
- CA проверяет, что имена в CSR в точности равны проверенным идентификаторам, и выпускает сертификат.
Именно на шаге 5 чаще всего терпят неудачу ручные попытки. Если заказ покрывает example.com и www.example.com, а в CSR указан только example.com, finalize вернёт ошибку несовпадения идентификаторов. CSR не может добавить имена после проверки — два списка должны совпадать заранее.
Четыре ошибки, которые ломают CSR для Let's Encrypt
- Отсутствует SAN. CSR только с
CN=example.comничего не подтверждает в современных клиентах; расширение SAN обязательно. - CN и SAN расходятся. Одни инструменты копируют CN в SAN, другие — нет. Всегда смотрите в файл.
- Подстановочный домен без DNS-01.
*.example.comтребует проверку через DNS TXT; HTTP-01 не может подтвердить подстановочный домен. - Ключ и CSR из разных запусков. Если после создания CSR сгенерировать ключ заново, итоговый сертификат не совпадёт с ключом сервера. Перед развёртыванием сравните модуль или точку открытого ключа с помощью инструмента сопоставления ключей.
Переиспользование ключа при продлениях
CSR не привязан к сроку действия сертификата. Одну и ту же пару закрытого ключа можно держать годами, пересоздавая только CSR — некоторые команды так делают, потому что ключ закреплён в системе управления конфигурацией или потому что ключи и сертификаты ротируются по разным расписаниям.
Обратная сторона: скомпрометированный ключ остаётся опасным до самой ротации, сколько бы раз ни продлевался сертификат. Если нет операционной причины закреплять ключ, позвольте клиенту генерировать новый при каждом продлении — это поведение по умолчанию выбрано неслучайно.
Сделайте это прямо в браузере
Если CSR нужен лишь для того, чтобы отдать его в панель, генератор CSR создаёт ключ и CSR локально и не загружает ни то, ни другое. Экспортируйте ключ, держите его вне сети и вставляйте только CSR там, где его просят.
Вопросы и ответы
Можно ли вставить свой CSR в Let's Encrypt?
Да, на уровне ACME. Вызов finalize у клиента отправляет CSR в кодировке DER; инструмент, позволяющий вставить CSR, просто пропускает локальную генерацию ключа. Сертификат выпускается для имён из этого CSR, поэтому они должны совпадать с уже проверенными идентификаторами.
Перезапишет ли certbot мой CSR или ключ?
certbot создаёт новую пару ключей для каждого lineage в /etc/letsencrypt/live/<domain>/. Если заменить ключ вручную, при продлении будет использоваться файл по этому пути — поэтому подменяйте его на месте либо укажите --key-path на свой ключ.
Нужен ли CSR для подстановочного сертификата?
CSR должен содержать DNS:*.example.com, а проверка ACME должна быть DNS-01. Подстановочный домен нельзя подтвердить через HTTP-01, поэтому CSR и тип проверки нужно планировать вместе.
Почему CSR работает с коммерческим CA, но не проходит в Let's Encrypt?
Обычно из-за несовпадения имён: коммерческие CA часто принимают CN, тогда как Let's Encrypt читает только subjectAltName, либо в CSR есть внутреннее имя, которое нельзя проверить публично.
Бесплатные SSL/TLS инструменты
Проверяйте сертификаты за секунды.
Информация о сертификатах
Подробнее о выборе и покупке SSL-сертификатов.