ssl_ecdh_curve и постквантовый обмен ключами¶
ID проверки Gixy: ssl_ecdh_curve
С тех пор как OpenSSL 3.5 поставляет постквантовый гибрид X25519MLKEM768,
однострочная директива ssl_ecdh_curve может ошибаться тремя разными
способами:
| Находка | Серьёзность | Пример |
|---|---|---|
Постквантовая группа без ? |
HIGH | X25519MLKEM768:X25519:prime256v1 |
| Только классические группы | MEDIUM | X25519:secp384r1:prime256v1 |
| Постквантовая группа в одном ярусе с классическими | LOW | ?X25519MLKEM768:X25519:prime256v1 |
Чистый вариант для nginx, собранного с OpenSSL 3.5+, — не задавать директиву вовсе. Если список всё же нужен, вынесите гибрид в отдельный верхний ярус:
ssl_ecdh_curve ?X25519MLKEM768/X25519:prime256v1;
HIGH: постквантовая группа, из-за которой nginx не запускается¶
nginx передаёт значение напрямую в OpenSSL:
/* src/event/ngx_event_openssl.c */
if (SSL_CTX_set1_curves_list(ssl->ctx, &conf->ecdh_curve...) == 0) {
ngx_ssl_error(NGX_LOG_EMERG, ssl->log, 0,
"SSL_CTX_set1_curves_list(\"%V\") failed", &conf->ecdh_curve);
return NGX_ERROR;
}
Два свойства складываются неудачно:
- OpenSSL отвергает весь список, если не знает хотя бы одно имя группы.
Частичного принятия нет:
X25519MLKEM768:X25519:prime256v1отклоняется целиком, хотя две группы из трёх поддерживаются везде. - nginx пишет это на уровне
NGX_LOG_EMERGи возвращает ошибку, поэтому мастер-процесс не завершает конфигурацию. Это отказ запуска, а не откат на уровне соединения.
X25519MLKEM768 и родственные группы появились в OpenSSL 3.5. Что
поставляют дистрибутивы (проверено в ноябре 2026):
| Дистрибутив | Системный OpenSSL | X25519MLKEM768 |
|---|---|---|
| Debian 13 (trixie) | 3.5 | ✓ |
| RHEL / AlmaLinux / Rocky 9 (9.8) | 3.5 | ✓ |
| Debian 12 (bookworm) | 3.0 | ✗ nginx не запустится |
| Ubuntu 24.04 / 22.04 LTS | 3.0 | ✗ nginx не запустится |
| RHEL / AlmaLinux / Rocky 8 | 1.1.1 | ✗ nginx не запустится |
Значение имеет библиотека, с которой собран nginx, а не системная: проверьте
nginx -V 2>&1 | grep "built with". Пакеты NGINX от
GetPageSpeed собраны с OpenSSL 3.5
LTS на всех перечисленных платформах, включая те, где система даёт 3.0 и 1.1.1.
Предстандартные имена X25519Kyber768Draft00 из старых сборок на BoringSSL и
руководств 2024 года ломаются так же.
Префикс ? и его собственное ограничение по версии¶
? велит OpenSSL пропустить незнакомое имя группы, а не отвергать весь список.
Он появился в OpenSSL 3.3: в OpenSSL 3.0 и 3.2 ?X25519MLKEM768 само по
себе нераспознаваемое имя и ломается точно так же. Разделитель ярусов /
требует OpenSSL 3.5. Поэтому:
- OpenSSL 3.5+:
?X25519MLKEM768/X25519:prime256v1или без директивы. - OpenSSL 3.3 / 3.4: ML-KEM нет.
?не даст списку упасть, но договариваться о постквантовом обмене не с чем. - OpenSSL 3.0 / 3.2 / 1.1.1: не указывайте постквантовые группы совсем. Не задавайте директиву или перечисляйте только классические кривые.
MEDIUM: только классические группы¶
# Совет по усилению из эпохи до ML-KEM. На OpenSSL 3.5+ он выключает постквант.
ssl_ecdh_curve X25519:secp384r1:prime256v1;
Явный список заменяет умолчание OpenSSL, а не дополняет его. В OpenSSL
3.5+, где умолчание начинается с X25519MLKEM768, список из одних классических
групп отказывает гибриду для всех клиентов, включая браузеры. nginx -t
проходит, в лог ничего не пишется, замок в браузере выглядит так же.
Безопасное на любой версии OpenSSL исправление — удалить директиву и положиться
на умолчание библиотеки. На OpenSSL 3.5+ можно вместо этого добавить
постквантовый ярус в начало: ?X25519MLKEM768/X25519:secp384r1:prime256v1.
LOW: постквантовая группа в одном ярусе с классическими¶
OpenSSL 3.5 читает список групп как ярусы предпочтения: : объединяет
группы в один ярус, / начинает следующий, более низкий. Внутри яруса сервер
берёт ту долю ключа (key share), которую клиент прислал первой; более сильную
группу он требует только между ярусами.
Клиент TLS 1.3 может предложить группу, не прислав для неё долю ключа. С
?X25519MLKEM768:X25519:prime256v1 клиент, который предлагает гибрид, но
первой шлёт долю X25519, получит классический X25519. С
?X25519MLKEM768/X25519:prime256v1 сервер вместо этого отвечает
HelloRetryRequest и просит долю гибрида — ценой одного лишнего обмена.
Измерено на nginx 1.30 с OpenSSL 3.5.9:
| Доли ключа клиента | A:B (один ярус) |
A/B (два яруса) |
|---|---|---|
| гибрид, X25519 | X25519MLKEM768 |
X25519MLKEM768 |
| X25519, гибрид | X25519 |
X25519MLKEM768 |
| только X25519, гибрид предложен | X25519 |
X25519MLKEM768 (HRR) |
Актуальные Chrome, Firefox, curl/OpenSSL 3.5, Go и Java присылают долю гибрида
и получают X25519MLKEM768 при любой форме. Ярус важен для клиентов, которые
начинают с X25519, например для соединений Cloudflare с origin-серверами до
внедрения Automatic Key Exchange в 2026 году. Поэтому серьёзность — LOW.
Что эта проверка не помечает¶
- Отсутствие
ssl_ecdh_curveилиssl_ecdh_curve auto;(умолчание nginx). - Списки на основе ключевого слова OpenSSL
DEFAULT, напримерDEFAULT:-X448. - Постквантовые группы с префиксом
?в собственном верхнем ярусе.