Українська
Захищена служба systemd
Крок 1. Навіщо systemd
Навіщо. API – це довготривалий процес. Запущений вручну в сеансі SSH, він зупинився б зі закриттям сеансу, не повернувся б після збою чи перезавантаження, а його вивід загубився б. Інструменти на кшталт nohup або screen тримають його живим, але не розв’язують жодної з інших проблем.
systemd – менеджер служб Ubuntu: процес номер 1, який запускає й наглядає за всім іншим. Службу описують декларативно у файлі одиниці (unit file), а systemd дбає про решту:
- запускає службу під час завантаження, у правильному порядку після мережі й бази даних;
- запускає її від імені налаштованого користувача з налаштованим середовищем;
- перезапускає її після збою;
- збирає все, що вона пише в консоль, у журнал (journal), який читають через
journalctl; - і – про що легко забути – вміщує її в пісочницю з можливостей ядра Linux, що налаштовується кількома рядками.
Docker був би іншим поширеним вибором. Він дає схожу ізоляцію, але додає до розгортання збирання образу, реєстр і середовище виконання контейнерів; для одного процесу .NET на одному сервері systemd впорається тим, що в Ubuntu вже є.
Крок 2. Файл служби
Що зробити. На своєму комп’ютері створіть файл одиниці в папці Deploy/systemd:
ini
# Chatex API (Kestrel on 127.0.0.1:5000, behind Nginx).
# Install: cp Deploy/systemd/chatex-api.service /etc/systemd/system/ && systemctl daemon-reload
# systemctl enable chatex-api
# Logs: journalctl -u chatex-api -f
[Unit]
Description=Chatex API
After=network-online.target postgresql.service
Wants=network-online.target
[Service]
Type=exec
User=chatex
Group=chatex
# /opt/chatex/current is a symlink to the active release; it is resolved on every (re)start.
WorkingDirectory=/opt/chatex/current/api
ExecStart=/usr/bin/dotnet /opt/chatex/current/api/Chatex.Api.dll
EnvironmentFile=/etc/chatex/chatex.env
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=ASPNETCORE_URLS=http://127.0.0.1:5000
Environment=DOTNET_NOLOGO=true
Environment=DOTNET_CLI_TELEMETRY_OPTOUT=true
Restart=always
RestartSec=5
KillSignal=SIGINT
TimeoutStopSec=30
SyslogIdentifier=chatex-api
# Hardening: the release is read-only; only /var/lib/chatex (uploads, Data Protection keys) is writable.
# AF_NETLINK lets .NET read network interface information; nothing else beyond TCP and Unix sockets is allowed.
NoNewPrivileges=true
PrivateTmp=true
PrivateDevices=true
ProtectHome=true
ProtectSystem=strict
ReadWritePaths=/var/lib/chatex
ProtectKernelTunables=true
ProtectKernelModules=true
ProtectControlGroups=true
RestrictSUIDSGID=true
LockPersonality=true
ProtectClock=true
RestrictNamespaces=true
RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6 AF_NETLINK
CapabilityBoundingSet=
UMask=0027
[Install]
WantedBy=multi-user.target[Unit]
Description– назва, яку показуєsystemctl status.After=network-online.target postgresql.serviceупорядковує запуск після того, як мережа працює й PostgreSQL запущено;Wants=network-online.targetгарантує, що ціль мережі справді досягається під час завантаження.Afterлише впорядковує, він не створює залежності: API запускається й тоді, коли PostgreSQL не працює, і тоді повідомляєUnhealthyна/health, доки база даних не повернеться (тема 13).
[Service]
Type=exec– служба вважається запущеною, щойно програмуdotnetвиконано; збій виконання (хибний шлях)systemctlповідомляє відразу.User=chatex,Group=chatex– користувач із попереднього розділу.WorkingDirectoryіExecStartзапускаютьChatex.Api.dllз/opt/chatex/current/apiчерез хостdotnetіз пакета середовища виконання.current– це символічне посилання на активний реліз; воно розв’язується заново за кожного запуску, тож після перемикання посиланняsystemctl restartзапускає нову версію. Файл одиниці між релізами ніколи не змінюється.EnvironmentFile=/etc/chatex/chatex.envзавантажує налаштування з попереднього розділу. systemd читає файл від іменіroot, перш ніж перемкнутися наchatex.Environment=ASPNETCORE_ENVIRONMENT=Productionвибирає робоче середовище:appsettings.Production.jsonіз теми 13 перемикає журнал консолі на форматsystemd, а кінцеві точки лише для розробки (/openapi,/scalar) не відображаються.Environment=ASPNETCORE_URLS=http://127.0.0.1:5000змушує Kestrel слухати лише на адресі зворотного зв’язку. Ніщо поза машиною не може напряму дістатися до API; кожен запит іде через Nginx.Restart=always,RestartSec=5– щоразу, коли процес завершується, з будь-якої причини, systemd запускає його знову через п’ять секунд.KillSignal=SIGINT,TimeoutStopSec=30– під часstopабоrestartsystemd надсилаєSIGINT, сигнал Ctrl+C, на який хост .NET реагує плавним завершенням: поточні запити завершуються, з’єднання SignalR закриваються, фонові служби зупиняються. Лише якщо процес ще живий через 30 секунд, його вбивають.SyslogIdentifier=chatex-api– назва перед кожним рядком у журналі.
[Install]
WantedBy=multi-user.target – systemctl enable підключає одиницю до звичайної цілі завантаження, тож API запускається під час кожного завантаження.
Крок 3. Пісочниця, директива за директивою
Навіщо. Робота від імені chatex уже обмежує шкоду від діри в безпеці. Директиви захисту йдуть набагато далі. Кожна закриває двері, якими API ніколи не користується, тож у часі виконання вони нічого не коштують, а разом лишають зловмисника, який захопив процес, у дуже малій коробці: він може спілкуватися з мережею та базою даних, читати застосунок і записувати завантаження – і майже нічого більше. Таблиця 23.2 пояснює кожну директиву.
Таблиця 23.2. Директиви захисту chatex-api.service
| Директива | Дія для процесу |
|---|---|
NoNewPrivileges=true | він і його нащадки ніколи не можуть здобути привілеїв, наприклад через програми з set-user-id на кшталт sudo |
PrivateTmp=true | власні порожні /tmp і /var/tmp, невидимі для інших програм і видалені, коли процес зупиняється |
PrivateDevices=true | лише псевдопристрої на кшталт /dev/null і /dev/urandom; жодних дисків і терміналів |
ProtectHome=true | /home, /root і /run/user виглядають порожніми |
ProtectSystem=strict | уся файлова система лише для читання, зокрема /usr, /etc, /opt і /var |
ReadWritePaths=/var/lib/chatex | єдиний виняток: папка даних лишається доступною для запису |
ProtectKernelTunables=true | параметри ядра в /proc/sys і /sys доступні лише для читання |
ProtectKernelModules=true | жодних модулів ядра завантажувати не можна |
ProtectControlGroups=true | контрольні групи, обмеження ресурсів systemd, доступні лише для читання |
RestrictSUIDSGID=true | він не може створювати файли з set-user-id чи set-group-id |
LockPersonality=true | він не може перемикати домен виконання – старий прийом зміни поведінки ядра |
ProtectClock=true | він не може змінювати системний годинник (це зламало б строк дії токенів і TLS) |
RestrictNamespaces=true | він не може створювати простори імен Linux, будівельні блоки контейнерів |
RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6 AF_NETLINK | сокети лише для локальних сокетів Unix, IPv4, IPv6 і netlink, який .NET використовує для читання мережевих інтерфейсів |
CapabilityBoundingSet= | порожній список прибирає всі можливості (capabilities) Linux; навіть процес, що став root, не міг би прив’язатися до низьких портів, змінювати власників файлів чи завантажувати модулі |
UMask=0027 | нові файли доступні для читання групі й невидимі іншим (rw-r-----) |
Коментар на початку блоку підсумовує: реліз доступний лише для читання, і для запису доступний тільки /var/lib/chatex. Папки релізів і так належать root (тема 24), тож навіть без ProtectSystem служба не могла б змінити власний код – ці два захисти підстраховують один одного.
Як працюють ці директиви
У systemd немає нічого магічного. Перш ніж запустити програму, systemd створює приватний простір імен монтування (mount namespace), у якому файлову систему перемонтовано лише для читання, порожньою чи приватною відповідно до налаштувань, скидає можливості, виставляє прапорець «жодних нових привілеїв» і встановлює в ядрі фільтр seccomp, що відхиляє заборонені системні виклики. Програма не може скасувати нічого з цього. Повний список параметрів – на сторінці довідки systemd.exec.
Крок 4. Встановлення й перевірка служби
Що зробити. Закомітьте файл одиниці й надішліть його:
powershell
git add Deploypowershell
git commit -m "Add the systemd unit of the API"powershell
git pushНа сервері отримайте його, встановіть, змусьте systemd прочитати його й увімкніть для кожного завантаження:
bash
git pullbash
cp Deploy/systemd/chatex-api.service /etc/systemd/system/ && systemctl daemon-reload && systemctl enable chatex-apiCreated symlink '/etc/systemd/system/multi-user.target.wants/chatex-api.service' → '/etc/systemd/system/chatex-api.service'./etc/systemd/system/– папка для одиниць, написаних адміністратором; одиниці пакетів лежать у/usr/lib/systemd/system/.daemon-reloadзмушує systemd знову прочитати файли одиниць. Він потрібен після кожної зміни файлу одиниці.enableстворює посилання зWantedBy– рядка вище. Він не запускає службу й не повинен: релізу ще немає, тож/opt/chatex/currentне існує. Служба запуститься під час першого розгортання.
Перевірка
bash
systemctl status chatex-api○ chatex-api.service - Chatex API
Loaded: loaded (/etc/systemd/system/chatex-api.service; enabled; preset: enabled)
Active: inactive (dead)Одиницю завантажено й вона enabled, але ще не працює. Нехай systemd перевірить файл на помилки:
bash
systemd-analyze verify /etc/systemd/system/chatex-api.serviceКоманда нічого не виводить, коли одиниця коректна. Нарешті нехай systemd оцінить пісочницю:
bash
systemd-analyze security chatex-apiВона перелічує кожен захист із позначкою чи хрестиком і завершується загальною оцінкою вразливості від 0 (повністю закрито) до 10 (без захисту). Для цієї одиниці останній рядок такий:
→ Overall exposure level for chatex-api.service: 3.5 OK :-)Служба без жодного захисту отримує приблизно 9,6, UNSAFE.
Журнали служби
journalctl -u chatex-api показує журнал одиниці, -f стежить за новими рядками наживо, -n 50 показує останні 50. Зараз він виводить -- No entries --; після першого розгортання ви побачите там повідомлення про запуск API.