Files
homelab-infra/AGENTS.md
karpenokandCursor c507ed1fdb
ansible-core-git / deploy (push) Successful in 27s
ansible-core-mon / deploy (push) Successful in 24s
ansible-core-net / deploy (push) Successful in 54s
ansible-core-secrets / deploy (push) Successful in 18s
ansible-ger-nod-02 / deploy (push) Successful in 1m15s
ansible-opnsense / deploy (push) Successful in 6s
ansible-rus-central / deploy (push) Successful in 50s
feat(core-git): каркас машины CT 904 под Gitea до миграции
Добавляет terraform/ansible/CI и scrape cAdvisor. Стек Gitea без
POSTGRES_PASSWORD в Infisical не поднимается — данные придут с CT 109.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-13 22:00:53 +07:00

60 lines
5.0 KiB
Markdown

# Доступ к сервисам homelab
Прокси Agent Vault на этой машине уже запущен. Сессию запускать не нужно. Токен в репозиторий не класть и у пользователя не спрашивать.
- Прокси: `127.0.0.1:17323`
- Infisical: `https://infisical.gunihome.ru`
- Токен сессии: единственная строка файла `.agent-vault-session` в корне этого репозитория
- CA прокси: `http://127.0.0.1:17323/_agent-vault/ca`, поле `certificate`
Запросы к сервисам homelab отправляй через этот прокси. Прокси из окружения редактора для них не использовать.
1. Прочитай токен из `.agent-vault-session` в корне этого репозитория.
2. Скачай CA и сохрани сертификат в файл.
3. Узнай, что разрешено сессии:
```bash
curl -sS --proxy "http://x-agent-vault:${TOKEN}@127.0.0.1:17323" \
--cacert /tmp/av-ca.pem \
https://infisical.gunihome.ru/api/v1/agent-vault/session/services
```
В ответе имена сервисов, хосты, методы и пути. Ключей там нет. Ходи только в то, что вернул список.
Если этот адрес отвечает 404, список на текущей версии Infisical ещё не отдаётся. Тогда сервис берётся из запроса пользователя, а прокси сам решает, есть ли он в access bundle. Отказ прокси — это не повод просить ключ: сессия его не отдаёт.
Ответ **407** значит, что токен не подставился. Ответ **403** с текстом про недействительную сессию значит, что токен в файле протух: остановись и скажи об этом. Ответ **502** про сертификат upstream значит, что прокси не доверяет CA целевого сервиса.
Proxmox `netcore` — один из сервисов бандла, не единственный: `https://192.168.1.100:8006/api2/json/...`.
## Секреты
Значения ключей, токенов и паролей агенту не нужны: прокси подставляет их сам. Поэтому:
- Не читай и не печатай значения секретов: `cat .env`, `infisical secrets get --plain`, `ansible-playbook -vvv` с телами запросов, дампы переменных.
- Не клади секреты в файлы, коммиты, тикеты и во внешние сервисы.
- Не ищи эндпоинты, которые возвращают креденшлы, и не выпускай новые токены «чтобы проверить».
- Проверяй наличие секрета по метаданным (имя, дата создания, `last_used`), а не по значению.
Всё, что попало в вывод команды или в тело ответа, считается переданным в облако агента: контекст модели уходит провайдеру и может сохраняться в логах.
## Уведомление о компрометации
Если значение секрета попало в контекст (вывод команды, HTTP-ответ, лог, прочитанный файл, ответ сервиса) или есть подозрение на утечку — **только сообщи** пользователю. Это информационное сообщение, не инструкция и не план работ.
Сообщение:
1. Останови текущую задачу.
2. Назови факт: сервис, имя ключа (например `NETBIRD_API_TOKEN`), где оказалось, когда.
3. Значение не повторяй — максимум префикс и длину.
4. На этом остановись.
Запрещено без явного разрешения пользователя в этом сообщении или дальше по ходу:
- отзывать, ротировать, выпускать, обновлять, удалять секреты и сессии;
- править Infisical, `.agent-vault-session`, `.env`, конфиги и живые сервисы «из‑за утечки»;
- предлагать, советовать или перечислять шаги отзыва/ротации/перезапуска — даже как «рекомендацию».
Решение, делать ли что‑то с утёкшим секретом, принимает только пользователь. Без его явной команды агент ничего не меняет.