Українська
Користувач, папки, база даних і налаштування
Крок 1. Службовий користувач
Навіщо. Програма працює з правами свого користувача. Якби API працювало від імені root, а зловмисник знайшов у ньому діру – у нашому коді чи в бібліотеці, – він заволодів би всією машиною. Linux відповідає принципом найменших привілеїв: кожна служба має власного користувача, який не володіє нічим, крім даних служби. API працюватиме як chatex – користувач, що не може входити в систему й не може записувати власні файли програми.
Що зробити.
bash
useradd --system --home-dir /var/lib/chatex --shell /usr/sbin/nologin chatex--systemстворює системний обліковий запис: ідентифікатор користувача нижче 1000, без старіння пароля й без створення домашньої папки.--home-dir /var/lib/chatexзаписує папку даних як домашню для облікового запису. Деякі бібліотеки шукають домашню папку з правом запису; ця буде придатною для запису (крок 2).--shell /usr/sbin/nologin– ніхто не може увійти якchatex, навіть із паролем чи ключем; обліковий запис існує лише для запуску служби.
Перевірка
bash
id chatexuid=993(chatex) gid=993(chatex) groups=993(chatex)Число може відрізнятися; створено системного користувача та групу з тією самою назвою.
Крок 2. Папки
Навіщо. Файли застосунку поділяються на три групи з різними власниками й строками життя, і розташування папок відповідає для них угодам Linux:
- файли програми в
/opt(додаткове програмне забезпечення): під час розгортання їх записує лишеroot, служба їх читає; - дані в
/var/lib(стан програм): завантажені файли й ключі, які записує служба й які зберігаються між розгортаннями; - налаштування в
/etc: їх записує адміністратор, читаєroot.
Що зробити.
bash
mkdir -p /opt/chatex/incoming /opt/chatex/releases /var/lib/chatex/uploads /etc/chatex && chown -R chatex:chatex /var/lib/chatexmkdir -p створює папки разом із батьківськими й мовчить, якщо вони вже існують; chown -R віддає папку даних користувачу chatex. Усі інші папки лишаються у власності root. Після першого розгортання з теми 24 сервер міститиме таке дерево:
/opt/chatex/
├── incoming/<sha>/ upload from GitHub Actions (rsync)
├── releases/
│ ├── 3c6b219…/ an older release (the newest 5 are kept)
│ └── 03be410…/
│ ├── api/ published Chatex.Api.dll
│ ├── efbundle migration executable
│ ├── web/ Angular build
│ └── REVISION commit hash
└── current → releases/03be410… symlink, swapped atomically
/etc/chatex/chatex.env settings and secrets, mode 600
/var/lib/chatex/ uploads/ and keys/: the only writable folder
/usr/local/bin/chatex-activateРис. 23.2. Файли Chatex на сервері
releases/містить повні версії застосунку, кожну в папці, названій за її комітом Git.current– це не папка, а символічне посилання на один реліз. Служба запускаєcurrent/api, Nginx віддаєcurrent/web; щоб перемкнути весь застосунок на іншу версію, достатньо замінити одне посилання (тема 24).incoming/приймає завантаження, тож недокопійований реліз ніколи не з’являється вreleases/./var/lib/chatexпереживає кожне розгортання: завантажені файли вuploads/, ключі Data Protection уkeys/(їх створює API під час першого запуску).
Перевірка
bash
ls -ld /opt/chatex/incoming /opt/chatex/releases /var/lib/chatex /var/lib/chatex/uploads /etc/chatexdrwxr-xr-x 2 root root 4096 Nov 15 21:25 /etc/chatex
drwxr-xr-x 2 root root 4096 Nov 15 21:25 /opt/chatex/incoming
drwxr-xr-x 2 root root 4096 Nov 15 21:25 /opt/chatex/releases
drwxr-xr-x 3 chatex chatex 4096 Nov 15 21:25 /var/lib/chatex
drwxr-xr-x 2 chatex chatex 4096 Nov 15 21:25 /var/lib/chatex/uploadsКористувачу chatex належать лише папки даних.
Крок 3. PostgreSQL
Навіщо. Пакет уже створив кластер бази даних і запустив його. На машині розробника ми підключалися як суперкористувач postgres (тема 2); на сервері застосунок отримує власну роль, що володіє власною базою даних і більше нічим. Навіть успішна SQL-ін’єкція тоді не змогла б прочитати інші бази, створити ролі чи прочитати файли сервера.
Що зробити. Виберіть пароль із літер і цифр (наприклад, вивід openssl rand -hex 24) і підставте його замість CHANGE_ME:
bash
sudo -u postgres psql -c "CREATE ROLE chatex LOGIN PASSWORD 'CHANGE_ME'" -c "CREATE DATABASE chatex OWNER chatex"sudo -u postgresзапускаєpsqlвід імені користувача операційної системиpostgres, створеного пакетом. PostgreSQL довіряє йому як суперкористувачу бази даних через автентифікацію peer по локальному сокету – для нього пароля немає і не потрібно.CREATE ROLE chatex LOGIN PASSWORD '…'– роль, яка може входити, із паролем; вона не суперкористувач і не може створювати бази даних чи ролі.CREATE DATABASE chatex OWNER chatex– роль володіє своєю базою даних, тож міграції з теми 24 можуть створювати в ній таблиці.
База даних поки порожня; пакет міграцій створить схему під час першого розгортання.
Перевірка
bash
sudo -u postgres psql -c "\l chatex" List of databases
Name | Owner | Encoding | Locale Provider | Collate | Ctype | Locale | ICU Rules | Access privileges
--------+--------+----------+-----------------+---------+---------+--------+-----------+-------------------
chatex | chatex | UTF8 | libc | C.UTF-8 | C.UTF-8 | | |
(1 row)База даних існує, і її власник – chatex.
Чому брандмауеру не треба блокувати порт 5432
PostgreSQL в Ubuntu слухає лише на localhost (listen_addresses у /etc/postgresql/18/main/postgresql.conf), тож порт і так не відкритий в інтернет. Брандмауер – друга лінія оборони: навіть якщо хтось змінить цей параметр, порт 5432 залишиться заблокованим.
Крок 4. Файл налаштувань
Навіщо. Робочі налаштування – рядок підключення з паролем бази даних, ключ підпису JWT – це секрети. Їх не можна тримати в репозиторії, де їх бачив би кожен співавтор, кожна копія (fork) і кожна витікла резервна копія. Репозиторій може й має містити шаблон: які налаштування існують, що вони означають і безпечні значення-заповнювачі. Справжній файл лежить лише на сервері, і читати його може тільки root.
ASP.NET Core читає конфігурацію також зі змінних середовища, а systemd може завантажувати змінні середовища з файлу. Тож налаштування – це простий файл із рядків KEY=value; подвійне підкреслення замінює : розділу конфігурації, тож Jwt__SigningKey задає Jwt:SigningKey.
Що зробити. На своєму комп’ютері створіть шаблон у новій папці Deploy:
ini
# Production settings for the Chatex API, read by systemd (EnvironmentFile) and by chatex-activate.
# Install as /etc/chatex/chatex.env, owned root:root, mode 600. systemd syntax: KEY=value, no export,
# no quotes needed. '__' stands for ':' in configuration keys (Jwt__SigningKey = Jwt:SigningKey).
ConnectionStrings__Chatex=Host=localhost;Database=chatex;Username=chatex;Password=CHANGE_ME
Jwt__Issuer=https://chatex.mvano.com
Jwt__Audience=https://chatex.mvano.com
# At least 32 characters, for example: openssl rand -base64 48
Jwt__SigningKey=CHANGE_ME
Storage__RootPath=/var/lib/chatex/uploads
# Keeps the Data Protection keys across restarts; the API creates the folder (/var/lib/chatex is writable for it).
DataProtection__KeysPath=/var/lib/chatex/keys
# Requests for any other Host header are rejected with 400; 127.0.0.1 is for the health check in chatex-activate.
AllowedHosts=chatex.mvano.com;127.0.0.1
# Optional (defaults shown):
# Jwt__AccessTokenLifetime=00:15:00
# Jwt__RefreshTokenLifetime=30.00:00:00
# Attachments__MaxBytes=20971520
# Presence__OfflineGraceSeconds=5
# Maintenance__Interval=01:00:00
# Maintenance__StaleUploadAge=1.00:00:00
# RateLimiting__AuthPermitLimit=20
# RateLimiting__AuthWindowSeconds=60ConnectionStrings__Chatex– рядок підключення дляAddData(тема 5): локальна база даних, рольchatexі її пароль.Jwt__Issuer,Jwt__Audience– публічна адреса сайту, записана в кожен токен доступу й перевірювана в кожному запиті (теми 8 і 13).Jwt__SigningKey– ключ HMAC, щонайменше 32 символи (інакше[MinLength(32)]уJwtOptionsзупиняє API під час запуску).openssl rand -base64 48дає 64 випадкові символи.Storage__RootPath– папка для завантажених файлів (тема 5).DataProtection__KeysPath– де ASP.NET Core зберігає ключі Data Protection (тема 13). Без нього ключі жили б лише в пам’яті й змінювалися б за кожного перезапуску.AllowedHosts– фільтр хостів ASP.NET Core: на запит, чий заголовокHostвідсутній у списку, відповідають400 Bad Request. Домен призначено для запитів, що надходять через Nginx;127.0.0.1– для перевірки стану в скрипті активації з теми 24, який звертається до API напряму.- Необов’язкові налаштування наприкінці показують значення за замовчуванням для класів параметрів; розкоментуйте рядок, щоб змінити одне з них, наприклад
Attachments__MaxBytes.
Закомітьте шаблон і надішліть його:
powershell
git add Deploypowershell
git commit -m "Add the production settings template"powershell
git pushНа сервері отримайте його й установіть як справжній файл налаштувань, доступний для читання лише root:
bash
git pullbash
cp Deploy/chatex.env.example /etc/chatex/chatex.env && chmod 600 /etc/chatex/chatex.env && nano /etc/chatex/chatex.envУ редакторі nano змініть чотири речі, потім збережіть через Ctrl+O, Enter і вийдіть через Ctrl+X:
Password=CHANGE_ME→ пароль бази даних із кроку 3;https://chatex.mvano.comуJwt__IssuerіJwt__Audience→https://<your domain>;Jwt__SigningKey=CHANGE_ME→ новий випадковий ключ. Згенеруйте його в другому вікні SSH командоюopenssl rand -base64 48і вставте;chatex.mvano.comуAllowedHosts→<your domain>; залиште;127.0.0.1наприкінці.
Перевірка
bash
ls -l /etc/chatex/chatex.envРядок починається з -rw------- 1 root root: файл може читати лише root. systemd читає його від імені root, перш ніж запустити службу як chatex, тож API отримує значення, не маючи змоги прочитати сам файл. Переконайтеся, що жодного заповнювача не лишилося:
bash
grep -c CHANGE_ME /etc/chatex/chatex.envВідповідь – 0.
Ніколи не комітьте справжній файл
.gitignore із теми 2 ігнорує *.env і .env.*, а шаблон називається chatex.env.example саме для того, щоб його не ігнорували. Ніколи не копіюйте справжні значення назад у шаблон і ніколи не вставляйте ключ підпису чи пароль бази даних у задачу (issue), чат або знімок екрана. Якщо секрет витік, замініть його (тема 24 показує як).