From db95be39f31a8b41aa6d0d79451fd4bb30e06b75 Mon Sep 17 00:00:00 2001 From: PTah Date: Fri, 19 Jun 2026 23:38:02 +1000 Subject: [PATCH] docs: agent poll contract for RDP 2.0.39-SAC --- docs/agent-control-plane.md | 2 +- docs/agent-integration.md | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/agent-control-plane.md b/docs/agent-control-plane.md index db035ea..58dc052 100644 --- a/docs/agent-control-plane.md +++ b/docs/agent-control-plane.md @@ -286,7 +286,7 @@ Authorization: Bearer sac_xxx |------|------------|--------| | **1** | `rule:rdg_session_flap`, Problem, notify, флаг `rdg_flap` | ✅ SAC | | **2** | Кнопка **qwinsta** на «Обзоре» | ✅ SAC UI | -| **3** | Poll API, `agent_commands`, env admin | ✅ SAC; ⏳ RDP-login-monitor | +| **3** | Poll API, `agent_commands`, env admin | ✅ SAC; ✅ RDP ≥ 2.0.39-SAC | | **4** | logoff в модалке | ✅ SAC UI | | **5** | Settings «Обновления агентов» | ⏳ | | **6** | Self-update B1 | ⏳ | diff --git a/docs/agent-integration.md b/docs/agent-integration.md index e408b34..6bd0b13 100644 --- a/docs/agent-integration.md +++ b/docs/agent-integration.md @@ -274,6 +274,7 @@ SAC применяет cooldown по `dedup_key` (события, по умол - `Send-SacEvent` + замена вызовов `Send-TelegramMessage` для событий мониторинга. - Heartbeat и daily report — отдельные типы в SAC. +- **Команды SAC (≥ 2.0.39-SAC):** poll `GET /api/v1/agent/commands?agent_instance_id=…` каждые `$SacCommandPollIntervalSec` (по умолчанию 60 с); типы `qwinsta`, `logoff`. Ответ: `POST /api/v1/agent/commands/{uuid}/result`. Учётные данные доменного admin приходят в `run_as` (на SAC — `SAC_WIN_ADMIN_*`). Подробнее: [agent-control-plane.md](agent-control-plane.md). - При `UseSAC=exclusive` суточный отчёт может формироваться **на SAC** (`generated_by: sac` в `details`), если агент за день не прислал `report.daily.*` — см. `SAC_DAILY_REPORT_*`, job `python -m app.jobs.daily_report`, timer `sac-daily-report.timer`. - **Единый шаблон отчёта** (SSH / Windows): агенты `ssh-monitor` ≥ 1.2.8-SAC, `RDP-login-monitor` ≥ 1.2.21-SAC и SAC используют одинаковые секции в `report_body` / `details.stats`. - **Только SAC, без отчёта с агента:** на агенте `DAILY_REPORT_ENABLED=0` (ssh) или `$DailyReportEnabled = $false` (RDP); на SAC `SAC_DAILY_REPORT_ENABLED=true`, `SAC_DAILY_REPORT_SKIP_IF_AGENT_SENT=true`.