[SECURITY] Remediation API: localhost-only, убран мёртвый токен, исправлен адрес у потребителя
lint / hygiene (push) Successful in 15s

This commit is contained in:
root committed 2026-10-28 14:11:26 +03:00
1 parent cc677489c1
commit ed5303f618
1 file changed
+53
+53
View File
@@ -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 <CT> -- 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`, а не
литералом, и помнить, что действие перезагружает контейнер целиком.