[SECURITY] Remediation API: localhost-only, убран мёртвый токен, исправлен адрес у потребителя
lint / hygiene (push) Successful in 15s
lint / hygiene (push) Successful in 15s
This commit is contained in:
1 parent
cc677489c1
commit
ed5303f618
1 file changed
+53
@@ -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`, а не
|
||||
литералом, и помнить, что действие перезагружает контейнер целиком.
|
||||
Reference in new issue
Block a user