From ed5303f618aaec1ee264b60df1488163034213be Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Wed, 28 Oct 2026 14:11:26 +0300 Subject: [PATCH] =?UTF-8?q?[SECURITY]=20Remediation=20API:=20localhost-onl?= =?UTF-8?q?y,=20=D1=83=D0=B1=D1=80=D0=B0=D0=BD=20=D0=BC=D1=91=D1=80=D1=82?= =?UTF-8?q?=D0=B2=D1=8B=D0=B9=20=D1=82=D0=BE=D0=BA=D0=B5=D0=BD,=20=D0=B8?= =?UTF-8?q?=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=20=D0=B0=D0=B4?= =?UTF-8?q?=D1=80=D0=B5=D1=81=20=D1=83=20=D0=BF=D0=BE=D1=82=D1=80=D0=B5?= =?UTF-8?q?=D0=B1=D0=B8=D1=82=D0=B5=D0=BB=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/ops/REMEDIATION-API.md | 53 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 ops/ops/REMEDIATION-API.md diff --git a/ops/ops/REMEDIATION-API.md b/ops/ops/REMEDIATION-API.md new file mode 100644 index 0000000..15f74a9 --- /dev/null +++ b/ops/ops/REMEDIATION-API.md @@ -0,0 +1,53 @@ +# Remediation API (хост, порт 5000) + +Разобрано и приведено в порядок 28.10.2026. + +## Что это + +FastAPI-сервис `remediation-api.service` (`/opt/remediation-api/api.py`). +Единственный маршрут — `POST /api/v1/remediate`, заголовок `x-api-key`, +тело `{"action": "restart_service", "target": "<служба>"}`. + +Действие `restart_service` выполняет `pct exec -- systemctl reboot`, +то есть **перезагружает целый контейнер**, а не отдельный процесс. +Фактически это удалённая перезагрузка любой CT по ключу. + +## Что было не так + +1. **`/opt/buryan-hub/config/remediation.conf`** — файл от 28.09 с URL и токеном. + Его **никто не читал** (поиск по `/opt`, `/root`, `/etc` — без ссылок), а токен + внутри уже недействителен: проверка `POST /api/v1/remediate` с ним давала + `401 Invalid API Key`, тогда как живой ключ из `/opt/remediation-api/.env` + проходит авторизацию (ответ `400 Action not allowed` на тестовое действие). + Файл убран; копия — `/root/.remediation-conf.removed-20261028` (600). +2. **Сервис слушал `0.0.0.0:5000`** и был доступен из любой CT: `GET /docs` + отдавал 200 и с хоста, и из CT108/CT110. Токен — единственная защита от + перезагрузки контейнеров. Переведён на `127.0.0.1:5000`; проверено: локально + `/docs` → 200, из CT108 → нет соединения. Бэкап юнита: + `/root/remediation-api.service.bak-*`. +3. **Неверный адрес у потребителя**: в `/opt/telegram-bot/.env` было + `REMEDIATION_API_URL=http://192.168.1.1:5000` — это роутер, а не хост + (правильный `192.168.1.10`). Исправлено на `http://127.0.0.1:5000`. + +## Где ключ + +* `/opt/remediation-api/.env` (600) — тот, что читает сервис. +* `/opt/telegram-bot/.env` (600) — дубль того же значения; этот файл использует + `/root/vps-watchdog.sh` как источник для Telegram. +* Оба значения — в экспорте Vaultwarden (`infra`: «Remediation API — ключ»). + +## Как безопасно проверить ключ + +```bash +curl -s -X POST http://127.0.0.1:5000/api/v1/remediate -H "Content-Type: application/json" -H "x-api-key: <ключ>" -d '{"action":"noop","target":"nothing"}' +# 400 Action not allowed — ключ верный, ничего не выполняется +# 401 Invalid API Key — ключ неверный +``` + +## Замечание на будущее + +В `bot.py` (хаб и telegram-admin-bot) функция ремедиации читает +`REMEDIATION_API_URL` и `REMEDIATION_API_KEY` из окружения, но в +`/etc/hub-bots/bots.env` этих переменных нет — то есть из ботов действие пока +не включено. Если включать: ключ передавать через `EnvironmentFile`, а не +литералом, и помнить, что действие перезагружает контейнер целиком.