Provision
—— XP

Практика: HTTPS на стенде

практика~25 минут+350 XP

Настоящий сертификат Let's Encrypt выдаётся только на домен, который смотрит в интернет, а у стенда такого нет. Это не повод пропускать тему: механика HTTPS в nginx одна и та же, отличается только то, откуда взялись два файла.

Поэтому возьмём сертификат, который Ubuntu выпускает сама для проверок, — его называют snakeoil, «змеиное масло», намекая, что доверять ему нельзя. Подпишет его сама машина, и мы увидим, как клиент на такой сертификат ругается. В конце — что поменяется, когда домен появится.

Шаг 1. Поставить учебный сертификат

Сертификат создаёт пакет ssl-cert. На многих системах он уже стоит, тогда apt просто скажет, что ставить нечего.

ubuntu@stand:~$
sudo apt install -y ssl-cert

Шаг 2. Найти файлы

Пакет кладёт сертификат в общий каталог сертификатов. Флаг -l у ls покажет права и размер.

ubuntu@stand:~$
ls -l /etc/ssl/certs/ssl-cert-snakeoil.pem
ubuntu@stand:~$
-rw-r--r-- 1 root root 1127 Oct  1 11:02 /etc/ssl/certs/ssl-cert-snakeoil.pem

Права rw-r--r-- значат: читать могут все. Сертификат и должен быть публичным. А вот ключ лежит в закрытом каталоге, и обычному пользователю туда нельзя.

ubuntu@stand:~$
ls /etc/ssl/private/
ubuntu@stand:~$
ls: cannot open directory '/etc/ssl/private/': Permission denied

Это правильно: закрытый ключ читает только root. nginx справится, потому что его главный процесс запущен от root.

Шаг 3. Посмотреть, на кого выдан сертификат

Сертификаты читает утилита openssl. Перейдём в каталог, чтобы команда стала короче.

ubuntu@stand:~$
cd /etc/ssl/certs

Раздел x509 работает с сертификатами: -in — какой файл, -noout — не печатать его целиком, -subject — показать, кому выдан.

ubuntu@stand:~$
openssl x509 -in ssl-cert-snakeoil.pem -noout -subject
ubuntu@stand:~$
subject=CN = stand

CN — имя, на которое выдан сертификат. Здесь это имя машины, а не stand.provision.internal, поэтому даже с доверием к нему клиент заметил бы несовпадение. Флаг -enddate покажет срок.

ubuntu@stand:~$
openssl x509 -in ssl-cert-snakeoil.pem -noout -enddate
ubuntu@stand:~$
notAfter=Sep 28 08:02:11 2036 GMT

Десять лет — ещё один признак учебного сертификата: настоящие живут месяцы.

Шаг 4. Готовый кусок конфига

Чтобы не писать пути руками, nginx в Ubuntu держит готовый кусочек в snippets.

ubuntu@stand:~$
cat /etc/nginx/snippets/snakeoil.conf
ubuntu@stand:~$
# Self signed certificates generated by the ssl-cert package
# Don't use them in a production server!
ssl_certificate /etc/ssl/certs/ssl-cert-snakeoil.pem;
ssl_certificate_key /etc/ssl/private/ssl-cert-snakeoil.key;

Ровно две директивы из теории, сертификат и ключ. Подключим их в сайт одной строкой include.

Шаг 5. Включить HTTPS в сайте

Открой файл сайта.

ubuntu@stand:~$
sudo nano /etc/nginx/sites-available/provision

В основном блоке server замени строку listen 80; на две строки.

вместо listen 80;
    listen 443 ssl;
    include snippets/snakeoil.conf;

Всё остальное — root, /health, /api/ — не меняется: шифрование включается на входе, а дальше сайт работает как раньше.

Шаг 6. Перенаправление с HTTP

В самый конец файла, после закрывающей скобки основного server, добавь второй блок.

в конец файла
server {
    listen 80;
    server_name stand.provision.internal;
    return 301 https://$host$request_uri;
}

Шаг 7. Проверить и применить

Как всегда, сначала проверка.

ubuntu@stand:~$
sudo nginx -t
ubuntu@stand:~$
nginx: configuration file /etc/nginx/nginx.conf test is successful

Ошибка cannot load certificate значит, что путь в snakeoil.conf не совпадает с файлом: вернись к шагу 1. Если проверка прошла — применяем.

ubuntu@stand:~$
sudo systemctl reload nginx

Шаг 8. Проверить перенаправление

Спросим старый адрес по HTTP с каким-нибудь путём. Флаг -I — только заголовки.

ubuntu@stand:~$
curl -I http://stand.provision.internal/about
ubuntu@stand:~$
HTTP/1.1 301 Moved Permanently
Server: nginx/1.24.0 (Ubuntu)
Date: Thu, 01 Oct 2026 11:05:40 GMT
Content-Type: text/html
Content-Length: 178
Connection: keep-alive
Location: https://stand.provision.internal/about

Смотри на первую и последнюю строки: код 301 и заголовок Location, по нему браузер сам перейдёт на новый адрес. Location стоит в самом конце, поэтому в команде сдачи заголовки отбираются через grep, а не первыми строками. Путь /about сохранился — это заслуга $request_uri.

Шаг 9. Увидеть недоверенный сертификат

Теперь HTTPS напрямую.

ubuntu@stand:~$
curl -I https://stand.provision.internal/
ubuntu@stand:~$
curl: (60) SSL: no alternative certificate subject name matches target host name 'stand.provision.internal'
More details here: https://curl.se/docs/sslcerts.html

Так curl отказывается говорить с сервером, которому не верит. Причина, которую он назвал, — имя: сертификат выдан на stand (шаг 3), а спрашиваем мы stand.provision.internal. Даже если бы имя совпало, следом пришла бы вторая ошибка, self-signed certificate: сертификат подписан сам собой, а не известным центром. curl сообщает о первой проблеме, на которую наткнулся. Браузер в этой ситуации покажет страницу «Подключение не защищено». С настоящим сертификатом ни одной из ошибок не будет.

Шаг 10. Проверить, что HTTPS работает

Чтобы проверить сам nginx, скажем curl не проверять сертификат. Флаг -k значит «insecure», «небезопасно»: на стенде это нормально, в скриптах для прода так делать нельзя.

ubuntu@stand:~$
curl -kI https://stand.provision.internal/
ubuntu@stand:~$
HTTP/1.1 200 OK
Server: nginx/1.24.0 (Ubuntu)

И приложение за прокси тоже отвечает по HTTPS. Если копии из прошлой практики остановлены, запусти их снова, как в её шаге 12.

ubuntu@stand:~$
curl -k https://stand.provision.internal/api/
ubuntu@stand:~$
app A

Шаг 11. Что поменяется с настоящим доменом

Когда у тебя будет домен, направленный на сервер, вместо шагов 1–5 будет одна команда из теории: sudo certbot --nginx -d твой-домен. Certbot сам впишет ssl_certificate с путями в /etc/letsencrypt/live/, а перенаправление из шага 6 предложит добавить сам.

После этого обязательно проверить продление — те же две команды, что в теории: systemctl list-timers | grep certbot и sudo certbot renew --dry-run. Ошибка из шага 9 при этом пропадёт, и флаг -k станет не нужен.

Что спросят на собеседовании

  • curl ругается «self-signed certificate». Что это значит?
    Сертификат подписан не известным центром, а самим сервером. Для прода нужен сертификат от центра, например Let's Encrypt; флаг -k только отключает проверку и годится для отладки.
  • Как проверить, что редирект на HTTPS настроен правильно?
    curl -I на http-адрес с путём: должен прийти 301 и Location на https с тем же путём.
Практика 03+350 XP

Включить HTTPS в nginx: listen 443 ssl, подключение сертификата, редирект 301 с HTTP и проверка через curl — та же механика, что с сертификатом Let's Encrypt.

  • Конфигурация проходит проверку
  • HTTP перенаправляет на HTTPS
  • Перенаправление сохраняет путь
  • Сайт отвечает по HTTPS
  • Приложение доступно через HTTPS
  • Сайт слушает 443 с шифрованием
  • Сертификат подключён
Команда сдачи — выполни на своей машине
команда
sudo nginx -t 2>&1 | tail -1; curl -sI http://stand.provision.internal/about | grep -iE '^(HTTP|location)'; curl -sk -o /dev/null -w 'https %{http_code}\n' https://stand.provision.internal/; curl -sk https://stand.provision.internal/api/; sudo nginx -T 2>/dev/null | grep -E 'listen|ssl_certificate'

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.