byrsapty
ed8fc831bf
Один коміт, а не десяток тематичних, свідомо: теми переплетені в
спільних файлах (store.go, docker-compose.yml, deploy/README.md), і
розділити їх можна було б лише індексуванням шматків. Коміти, які не
збираються, гірші за один великий — тим паче що це рівно той стан, який
перевірявся разом.
ЩО ПРАЦЮЄ НА СТЕНДІ Й ПЕРЕВІРЕНО ТАМ
0058 подієві алерти: syslog, ncm, compliance спрацьовують у мить
події; правило з нереалізованим джерелом більше не зберігається
мовчки
0059 snmp.walk і прототипи шаблонів — таблиці з динамічним індексом
описуються шаблоном, а не Go
0060 відкат конфігу: план як різниця, маскування паролів із підписом
плану, обов'язковий контрольний збір, verifying при обриві
0061 кнопки Telegram: довге опитування, авторизація не з callback_data
0062 аудит і архів хостів; тест на AST, що падає на ключі без назви
0063 RLS: три ролі, окремий пул для фонових тактів
0064 строки зберігання даних і сторінка сховища
0065 приймач SNMP-трапів; перевірено справжніми пакетами по дроту,
переклад v1→v2 за RFC 3584 дає правильний OID
0066 ескалації сповіщень
0067 алерт про вичерпання диска
0068 поля заливки конфігу переїхали в каталог профілів
Плюс: 137 тестів вебу з нуля (їх не було взагалі), одинадцять справжніх
вад, знайдених ними й виправлених, і виправлення двох інтеграційних
тестів grpcapi, які мовчки пропускались півтора року.
ЩО ЩЕ НЕ ЗАПУСКАЛОСЬ
netpulse установник: одна команда замість 18 змінних і
593 рядків інструкції
RLS з першого запуску нова інсталяція під політиками одразу;
RLS-EXISTING-INSTALL.md лишається тільки для
старих інсталяцій
.forgejo + CI раннер не зареєстрований
Ці три перевірені компіляцією й міркуванням, але не виконанням.
ГОЛОВНИЙ ВИСНОВОК ДВОХ СЕСІЙ
Зелена перевірка доводить рівно те, що вона перевіряє. Тест ізоляції RLS
був правильний і зелений — і пропустив зламаний вхід, бо перевіряв «чи
не видно чужого», коли зламалось «чи видно своє». Інтеграційні тести
grpcapi були зелені, бо не виконувались. Схема, довідник і протокол
описували те, чого в коді не існувало, і виглядало це як готове.
Тому в кожному завданні цих сесій стояла вимога назвати НЕПОКРИТЕ, а
чотири задачі закінчились не можливістю, а відмовою: правило з
нереалізованим джерелом не зберігається, профіль без команд заливки
каже про це замість мовчазної кнопки, міграція RLS валить сама себе на
таблиці без політики, тест словника аудиту падає на ключі без назви.
Подробиці — HISTORY.md, розділи за 26 і 27 серпня.
90 lines
5 KiB
Text
90 lines
5 KiB
Text
# Приклад оточення для docker compose. Скопіювати в .env у корені
|
||
# репозиторію й заповнити. Файл .env у git не потрапляє.
|
||
|
||
# Домен, на який дивиться A-запис. Caddy візьме під нього сертифікат.
|
||
NETPULSE_DOMAIN=netpulse.example.com
|
||
|
||
# Пошта для Let's Encrypt: на неї приходять листи про проблеми з
|
||
# продовженням сертифіката. Порожньо — ACME без контакту.
|
||
ACME_EMAIL=admin@example.com
|
||
|
||
# Пароль ролі netpulse у PostgreSQL — власника схеми. Ним ходять
|
||
# міграції та утиліти netpulse-user і netpulse-secret.
|
||
# openssl rand -hex 24
|
||
POSTGRES_PASSWORD=
|
||
|
||
# --- ролі бази й Row Level Security -----------------------------------
|
||
#
|
||
# Два паролі нижче — це вимикач другого рубежу ізоляції.
|
||
#
|
||
# Заповнені: API й колектор ходять у базу роллю netpulse_app БЕЗ
|
||
# BYPASSRLS, тобто під політиками RLS, а фонові такти — окремою роллю
|
||
# netpulse_worker. Забутий предикат tenant_id у коді дає порожній
|
||
# результат замість чужих даних.
|
||
#
|
||
# Порожні: застосунок ходить роллю власника (суперкористувач), і жодна
|
||
# з політик RLS не діє. Ізоляцію кабінетів тримає лише те, що кожен
|
||
# запит у коді фільтрує tenant_id руками.
|
||
#
|
||
# НОВА ІНСТАЛЯЦІЯ: заповнити обидва, більше нічого не робити.
|
||
# netpulse-migrate побачить порожню базу, накотить схему й сам видасть
|
||
# ці паролі ролям — RLS працює з першого запуску. Установник заповнює
|
||
# ці рядки за вас.
|
||
#
|
||
# ІНСТАЛЯЦІЯ, СТАРША ЗА 0063: не чіпати цих рядків, поки не пройдено
|
||
# deploy/RLS-EXISTING-INSTALL.md. На непорожній базі мігратор паролів не
|
||
# видає навмисно — там паролі видає людина, з перевіркою після кожного
|
||
# кроку й зі шляхом назад.
|
||
#
|
||
# Обидва або жодного. Заповнений NETPULSE_APP_PASSWORD без
|
||
# NETPULSE_WORKER_PASSWORD — найгірший стан із можливих: інтерфейс
|
||
# працює, а бекапи, алерти й події мовчки не відбуваються. Мігратор
|
||
# такої пари не приймає й зупиняє запуск.
|
||
#
|
||
# ТІЛЬКИ HEX, і це не стиль, а вимога. Пароль їде всередині DSN
|
||
# postgres://роль:пароль@db, тому не кожен символ лишається собою:
|
||
# `/` (звичайний символ base64) обриває пароль і перетворює його хвіст
|
||
# на ім'я бази, а `%` читається як початок %XX і мовчки робить пароль
|
||
# іншим рядком. У журналі це «database ... does not exist» або
|
||
# «authentication failed», а на вигляд — «RLS усе зламав».
|
||
# openssl rand -hex 24
|
||
NETPULSE_APP_PASSWORD=
|
||
|
||
# openssl rand -hex 24
|
||
NETPULSE_WORKER_PASSWORD=
|
||
|
||
# Ключ шифрування секретів (паролі SSH, SNMP-community).
|
||
# Формат: <id>=<32 байти hex>. Id потрібен для зміни ключа: старий
|
||
# лишається в списку, щоб розшифрувати вже записане.
|
||
# echo "np1=$(openssl rand -hex 32)"
|
||
#
|
||
# ВТРАТА ЦЬОГО КЛЮЧА — ВТРАТА ВСІХ ЗБЕРЕЖЕНИХ ПАРОЛІВ. Бекап бази без
|
||
# нього не відновлюється: у БД лежить лише шифротекст.
|
||
NETPULSE_DEK=
|
||
|
||
# Ключ підпису сесійних токенів, не менше 32 байтів.
|
||
# openssl rand -base64 48
|
||
NETPULSE_JWT_SECRET=
|
||
|
||
# --- необовʼязкове ---------------------------------------------------
|
||
|
||
# Часовий пояс: у ньому рахуються розклади бекапів і вікна тиші.
|
||
TZ=Europe/Kyiv
|
||
|
||
# Як часто перевіряються правила сповіщень.
|
||
NETPULSE_ALERT_INTERVAL=30s
|
||
|
||
# debug|info|warn|error
|
||
NETPULSE_LOG_LEVEL=info
|
||
|
||
# Розмір shared_buffers PostgreSQL. Орієнтир — чверть памʼяті хоста.
|
||
PG_SHARED_BUFFERS=512MB
|
||
|
||
# Версія для тегів образів і рядка -version у бінарниках.
|
||
NETPULSE_VERSION=dev
|
||
NETPULSE_COMMIT=none
|
||
|
||
# Запрошення для локального зонда (профіль agent). Береться в
|
||
# інтерфейсі: Зонди → Додати зонд.
|
||
NETPULSE_ENROLL=
|
||
NETPULSE_AGENT_NAME=локальний зонд
|