Files
buryan-infra/ops/ops/REMEDIATION-API.md
T

3.4 KiB
Raw Blame History

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 — ключ»).

Как безопасно проверить ключ

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, а не литералом, и помнить, что действие перезагружает контейнер целиком.