Українська
Nginx і HTTPS
Крок 1. Навіщо зворотний проксі
Навіщо. Kestrel, вебсервер усередині ASP.NET Core, швидкий і міг би дивитися в інтернет сам. Проте Chatex ставить перед ним Nginx, як і більшість розгортань, бо в парадних дверей є завдання, що не належать застосунку:
- TLS: сертифікати, їх поновлення й параметри шифрування обробляються в одному місці, інструментом, створеним для цього;
- статичні файли: збірка Angular – це папка файлів; Nginx віддає їх із диска зі стисненням і кешуванням, не будячи .NET;
- одне джерело (origin): браузер бачить одну адресу.
/– це застосунок Angular,/apiі/hubsідуть до API. CORS не потрібен, а cookie оновлення зSecureі тим самим сайтом просто працює; - захист: обмеження розміру запитів, тайм-аути й заголовки для кожної відповіді, зокрема для статичних файлів.
Зворотний проксі отримує запит від браузера й пересилає його справжньому серверу – тут Kestrel на 127.0.0.1:5000 – від імені браузера (рис. 23.3). Caddy чи Traefik зробили б те саме з меншою конфігурацією й вбудованими сертифікатами; Nginx найпоширеніший, його конфігурація явна, а Ubuntu постачає його з плагіном certbot.
Рис. 23.3. Що Nginx робить із кожним шляхом
Крок 2. Заголовки безпеки
Навіщо. Кілька заголовків відповіді змушують браузери дотримуватися правил, що захищають користувачів сайту, навіть якщо в нашому коді є помилка. Кожен коштує один рядок, тож їх має нести кожна відповідь – і HTML, і скрипти, і відповіді API. Chatex тримає їх в невеликому фрагменті (snippet), який підключає сайт.
Що зробити. На своєму комп’ютері створіть папку Deploy/nginx і фрагмент:
nginx
# Security headers for the Chatex site, included by chatex.conf at server level and again in every location that
# sets its own add_header (Nginx drops inherited add_header directives in such locations).
# Install: cp Deploy/nginx/chatex-security-headers.conf /etc/nginx/snippets/
#
# CSP: scripts only from this origin (the theme script is the file theme-init.js, not inline); inline styles are
# allowed because Angular injects component styles as <style> elements; images may be blob: URLs (avatars and
# attachments fetched with the bearer token) or data: URLs; 'self' in connect-src also covers the same-origin
# wss:// connection of SignalR.
add_header Strict-Transport-Security "max-age=31536000" always;
add_header Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' blob: data:; font-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-Frame-Options "DENY" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header Permissions-Policy "camera=(), microphone=(), geolocation=(), payment=(), usb=()" always;Таблиця 23.3 показує, що робить кожен заголовок.
Таблиця 23.3. Заголовки безпеки Chatex
| Заголовок | Дія | Захищає від |
|---|---|---|
Strict-Transport-Security: max-age=31536000 | браузер використовує для цього сайту лише HTTPS протягом року, навіть якщо посилання каже http:// | пониження до звичайного HTTP у ворожій мережі |
Content-Security-Policy | браузер завантажує й виконує лише те, що дозволяє політика (нижче) | впроваджених скриптів (міжсайтовий скриптинг), викрадення даних |
X-Content-Type-Options: nosniff | браузер довіряє заявленому типу вмісту й ніколи не вгадує | текстового файлу, виконаного як скрипт |
X-Frame-Options: DENY | сайт не можна показувати всередині фрейму | клікджекінгу: прихованого Chatex під фальшивою кнопкою |
Referrer-Policy: strict-origin-when-cross-origin | інші сайти бачать лише https://<your domain>, а не повну адресу | витоку ідентифікаторів чатів в адресах URL |
Permissions-Policy | камеру, мікрофон, геолокацію, платежі й USB вимкнено | зловживання можливостями пристрою з боку впровадженого коду |
Політика безпеки вмісту (Content Security Policy) заслуговує пильнішого погляду, бо це найсильніший захист від міжсайтового скриптингу:
default-src 'self'– за замовчуванням усе лише з нашого джерела;script-src 'self'– скрипти лише з файлів нашого джерела; вбудовані блоки<script>іevalвідхиляються. Тому клієнт застосовує збережену тему до запуску Angular файломtheme-init.js, а не вбудованим скриптом. Навіть якби зловмисник зумів вставити тег скрипта в повідомлення, браузер його не виконав би;style-src 'self' 'unsafe-inline'– Angular додає стилі компонентів як елементи<style>, а це потребує вбудованих стилів;img-src 'self' blob: data:– аватари й зображення завантажуються з токеном-носієм і показуються як адресиblob:(BlobUrlService, тема 18);connect-src 'self'–fetchі з’єднання WebSocket лише з нашим джерелом; це охоплює йwss://для SignalR на тому самому хості;object-src 'none',base-uri 'self',form-action 'self',frame-ancestors 'none'– жодних плагінів, жодного стороннього елемента<base>, форми надсилаються лише нам, і ніхто не може вставити нас у фрейм (сучасна формаX-Frame-Options).
always наприкінці кожного рядка додає заголовок і до відповідей про помилки (4xx, 5xx); без нього Nginx додавав би його лише до успішних.
Крок 3. Сайт
Що зробити. Створіть конфігурацію сайту поруч із фрагментом:
nginx
# Chatex site: the Angular app from disk, /api, /hubs and /health proxied to Kestrel.
# Install: cp Deploy/nginx/chatex.conf /etc/nginx/sites-available/chatex
# cp Deploy/nginx/chatex-security-headers.conf /etc/nginx/snippets/
# ln -s /etc/nginx/sites-available/chatex /etc/nginx/sites-enabled/chatex
# nginx -t && systemctl reload nginx (server_name is chatex.mvano.com; change it for another domain)
# certbot --nginx -d chatex.mvano.com (adds the TLS server block and the redirect)
upstream chatex_api {
server 127.0.0.1:5000;
keepalive 16;
}
# WebSocket upgrade for SignalR; plain keep-alive for everything else.
map $http_upgrade $chatex_connection {
default upgrade;
'' '';
}
server {
listen 80;
listen [::]:80;
server_name chatex.mvano.com;
root /opt/chatex/current/web;
index index.html;
# Attachments are limited to 20 MB by default (Attachments:MaxBytes); leave room for the form.
client_max_body_size 25m;
include snippets/chatex-security-headers.conf;
# Text responses from disk and from the API (index.html is always compressed).
gzip on;
gzip_vary on;
gzip_proxied any;
gzip_comp_level 5;
gzip_min_length 1024;
gzip_types text/css text/plain application/javascript application/json application/problem+json image/svg+xml;
location ^~ /api/ {
proxy_pass http://chatex_api;
proxy_http_version 1.1;
proxy_set_header Connection '';
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_request_buffering off;
}
location ^~ /hubs/ {
proxy_pass http://chatex_api;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $chatex_connection;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 1h;
proxy_send_timeout 1h;
proxy_buffering off;
}
# The API only answers the hosts in AllowedHosts, so pass the real Host on here too.
location = /health {
proxy_pass http://chatex_api;
proxy_http_version 1.1;
proxy_set_header Connection '';
proxy_set_header Host $host;
access_log off;
}
# Hashed build output (outputHashing: all) never changes under the same name: main-IWEIRFGV.js, media/...
location ~* "-[a-z0-9_-]{8}\.(?:js|css)$" {
include snippets/chatex-security-headers.conf;
add_header Cache-Control "public, max-age=31536000, immutable";
try_files $uri =404;
}
location ^~ /media/ {
include snippets/chatex-security-headers.conf;
add_header Cache-Control "public, max-age=31536000, immutable";
try_files $uri =404;
}
# Everything else (index.html, SPA routes, favicons, site.webmanifest, theme-init.js) is revalidated on every load.
location / {
include snippets/chatex-security-headers.conf;
add_header Cache-Control "no-cache";
try_files $uri $uri/ /index.html;
}
}Замініть chatex.mvano.com у server_name своїм доменом: Nginx відповідає за це ім’я, а certbot шукає його на кроці 5.
Upstream і мапа WebSocket
upstream chatex_apiназиває API:127.0.0.1:5000, адресу зASPNETCORE_URLSу файлі служби.keepalive 16тримає відкритими до 16 бездіяльних з’єднань із Kestrel, щоб не кожен запит платив за нове з’єднання TCP.map $http_upgrade $chatex_connectionобчислює заголовокConnectionдля хаба: якщо браузер надіславUpgrade: websocket, значення –upgrade; якщо заголовокUpgradeпорожній, значення порожнє. WebSocket починається як запит HTTP із проханням «оновити» з’єднання; проксі має переслати цей запит явно, боUpgradeіConnection– це заголовки «від вузла до вузла» (hop-by-hop), які проксі зазвичай відкидає.
Блок server
listen 80,listen [::]:80– звичайний HTTP на IPv4 та IPv6. Certbot додасть HTTPS на кроці 5.root /opt/chatex/current/web– файли збірки Angular активного релізу через посиланняcurrent. Перемикання посилання перемикає клієнт і API разом.client_max_body_size 25m– найбільше тіло запиту, яке приймає Nginx (за замовчуванням 1 МБ). Вкладення можуть мати 20 МБ (Attachments:MaxBytes); решта – запас на форму multipart. Більші тіла Nginx відхиляє з413, ще до того, як вони дійдуть до API.include snippets/chatex-security-headers.conf– заголовки з кроку 2 для кожної відповіді цього сервера.gzip …– стискає текстові відповіді від 1 КБ, з диска й, завдякиgzip_proxied any, від API.index.htmlстискається завжди;gzip_typesдодає CSS, JavaScript, JSON, проблемні деталі (problem details) і SVG. JavaScript Chatex стискається приблизно вп’ятеро.
/api/, /hubs/ і /health
location ^~ /api/– кожен шлях, що починається з/api/, іде до upstream.^~означає «якщо цей префікс збігається, не пробуй наведені нижче регулярні вирази», тож/api/…-abcdefgh.jsніколи не можна сплутати з кешованим файлом.proxy_http_version 1.1і порожній заголовокConnectionвмикають з’єднання keep-alive з upstream.Host $hostпередає початкове ім’я хоста. API перевіряє його заAllowedHosts.X-Forwarded-ForіX-Forwarded-Protoповідомляють API справжню адресу клієнта й те, що браузер використав HTTPS.UseForwardedHeadersіз теми 13 застосовує їх; він довіряє цим заголовкам лише від проксі на адресі зворотного зв’язку, яким є Nginx. Без них обмежувач частоти запитів бачив би кожного користувача як127.0.0.1і душив би всіх разом.proxy_request_buffering offпередає завантаження потоком просто до API, а не зберігає їх спершу в тимчасовому файлі.
location ^~ /hubs/– хаб SignalR: ті самі налаштування проксі плюсUpgradeі обчислений заголовокConnectionдля WebSocket;proxy_read_timeout 1hіproxy_send_timeout 1h, бо з’єднання реального часу може довго мовчати (стандартні 60 секунд його обірвали б);proxy_buffering off, щоб кожна подія доходила до браузера відразу.location = /health– саме цей шлях, для димового тесту з теми 24 і для моніторингу;access_log offне пускає в журнал часті перевірки.
Кешування та односторінковий застосунок
location ~* "-[a-z0-9_-]{8}\.(?:js|css)$"– хешовані файли збірки на кшталтmain-IWEIRFGV.js: ім’я змінюється щоразу, коли змінюється вміст, тож браузери можуть зберігати їх рік (immutable: навіть без повторної перевірки). Те саме для/media/, куди збірка кладе шрифти й зображення з хешованими іменами.location /– усе інше, передусімindex.html, ізCache-Control: no-cache: браузер має щоразу питати, чи змінився файл, тож новий реліз підхоплюється відразу.try_files $uri $uri/ /index.htmlвіддає наявний файл, а інакшеindex.html– це запасний варіант для клієнтських маршрутів на кшталт/chats/…, які існують лише в маршрутизаторі Angular.
add_header не успадковується
Розташування (location), що має власний add_header, втрачає всі директиви add_header рівня сервера. Тому три розташування з Cache-Control не надсилали б жодних заголовків безпеки, якби не підключали фрагмент знову, що вони й роблять. Розташування проксі не мають add_header і успадковують заголовки сервера.
Крок 4. Встановлення сайту
Що зробити. Закомітьте обидва файли з вашим доменом у server_name і надішліть їх:
powershell
git add Deploypowershell
git commit -m "Add the Nginx site and the security headers"powershell
git pushНа сервері:
bash
git pullbash
cp Deploy/nginx/chatex-security-headers.conf /etc/nginx/snippets/bash
cp Deploy/nginx/chatex.conf /etc/nginx/sites-available/chatex && ln -s /etc/nginx/sites-available/chatex /etc/nginx/sites-enabled/ && rm -f /etc/nginx/sites-enabled/defaultsites-availableмістить конфігурації сайтів; символічне посилання вsites-enabledвмикає один із них. Головний/etc/nginx/nginx.confпакета підключає все зsites-enabled.rm -f …/defaultвимикає вітальну сторінку пакета. Chatex тепер єдиний сайт, тож він відповідає й на запити до голої IP-адреси.
Перевірте конфігурацію й завантажте її без переривання з’єднань:
bash
nginx -t && systemctl reload nginxПеревірка
nginx -t виводить:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successfulТепер запитайте в сайту про його стан через інтернет, зі свого комп’ютера:
powershell
curl.exe -i http://<your domain>/healthВідповідь – HTTP/1.1 502 Bad Gateway із заголовками безпеки: Nginx працює, а API за ним ще не запущено. http://<your domain>/ з тієї самої причини відповідає 500 Internal Server Error – current/web/index.html ще не існує, і /var/log/nginx/error.log пояснює це рядком rewrite or internal redirection cycle while internally redirecting to "/index.html". Обидві відповіді стануть справжніми з першим релізом у темі 24.
Крок 5. Сертифікат від certbot
Навіщо. HTTPS шифрує трафік і доводить браузеру, що він розмовляє зі справжнім сервером. Chatex не може працювати без нього: cookie оновлення має Secure і ніколи не надсилається через звичайний HTTP, а заголовок HSTS через HTTP ігнорується. Let’s Encrypt видає безкоштовні сертифікати, дійсні 90 днів, усім, хто може довести контроль над доменом. certbot автоматизує доказ, встановлення в Nginx і поновлення.
Що зробити. Запис DNS із першого розділу вже має вказувати на сервер (перевірте через nslookup). Потім:
bash
certbot --nginx -d <your domain>Під час першого запуску certbot просить адресу електронної пошти для попереджень про закінчення строку дії та вашу згоду з умовами обслуговування. Потім він
- просить у Let’s Encrypt сертифікат; Let’s Encrypt надсилає випадковий токен, certbot змушує Nginx віддати його за адресою
http://<your domain>/.well-known/acme-challenge/…, а Let’s Encrypt його завантажує – це доказ того, що домен вказує на цей сервер (виклик HTTP-01, через що порт 80 має бути відкритим); - зберігає сертифікат і його ключ у
/etc/letsencrypt/live/<your domain>/; - змінює
/etc/nginx/sites-available/chatex: блок server тепер слухає порт 443 зsslі сертифікатом, а новий невеликий блок server на порту 80 відповідає на кожен запит перенаправленням наhttps://. Кожен доданий рядок закінчується# managed by Certbot; - перезавантажує Nginx.
Він завершується рядками Successfully deployed certificate for <your domain> і Congratulations! You have successfully enabled HTTPS on https://<your domain>.
Перевірка
Зі свого комп’ютера:
powershell
curl.exe -I http://<your domain>/Відповідь – HTTP/1.1 301 Moved Permanently із Location: https://<your domain>/.
powershell
curl.exe -i https://<your domain>/healthВідповідь і далі 502 Bad Gateway – але тепер через HTTPS, із сертифікатом, якому довіряє ваш комп’ютер, і з Strict-Transport-Security серед заголовків. У браузері https://<your domain>/ показує значок замка (і сторінку з помилкою до першого релізу). На сервері заплановано поновлення:
bash
systemctl status certbot.timer● certbot.timer - Run certbot twice daily
Loaded: loaded (/usr/lib/systemd/system/certbot.timer; enabled; preset: enabled)
Active: active (waiting) since …Перевірте поновлення, нічого не змінюючи:
bash
certbot renew --dry-runВоно завершується рядком Congratulations, all simulated renewals succeeded.
Встановлений файл тепер відрізняється від репозиторію
Після certbot /etc/nginx/sites-available/chatex містить рядки TLS, а Deploy/nginx/chatex.conf – ні, і це навмисно: шляхи сертифіката належать цьому серверу. Якщо ви пізніше зміните сайт у репозиторії й скопіюєте його знову, рядки TLS зникнуть. Тоді знову виконайте nginx -t && systemctl reload nginx && certbot --nginx -d <your domain> – certbot запропонує перевстановити наявний сертифікат.
Сервер готовий. Кожна частина з рис. 23.1 встановлена, крім самого застосунку.