ochenstarik/server-monitor-manager
1
0
Fork 0
Code Issues Pull requests 6 Projects Releases 17 Packages Wiki Activity Actions

feat(control): add operator web console for nodes, links, and enrollment code generation #59

Merged
ochenstarik-ui merged 3 commits from antigravity/web-console into main 2026-08-17 19:47:39 +00:00
Conversation 0 Commits 3 Files changed 6 +1652
ochenstarik-ui commented 2026-08-17 19:00:55 +00:00 (Migrated from github.com)
Copy link

Antigravity: веб-консоль оператора — Этап 2

Реализована веб-консоль оператора для управления узлами, сетевыми связями (Links) и выдачи кодов регистрации (smm-antigravity-task-web-console-2026-08-17.md).

База

  • Базовая ветка: main @ f7b10ac
  • Ветка: antigravity/web-console

Что сделано

  1. Веб-интерфейс консоли оператора (SPA):
    • Список узлов: загрузка реальных данных из GET /api/v1/control/agents (имя узла, статус, версия агента, последний heartbeat, состояние сертификата).
    • Список сетевых связей (Links): загрузка реальных данных из GET /api/v1/control/links (ID связи, источник, назначение, протокол/порт, требуемое и фактическое состояние, срок действия).
    • Кнопка «Добавить узел» и модальное окно:
      • Валидация имени узла (1-63 символа, строчные буквы, цифры, дефисы).
      • Вызов эндпоинта POST /api/v1/control/agents/{nodeId}/enrollment-code.
      • Крупное отображение выданного кода SMMNODE2... и отпечатка CA (SHA-256) с копированием в буфер обмена в один клик.
      • Обязательное заметное предупреждение: «При выполнении установщика на сервере обязательно сверьте отпечаток CA, выведенный скриптом, с отпечатком ниже. Подтверждение без сверки обесценивает криптографическую проверку подписи!».
      • 10-минутный обратный отсчет срока действия кода.
  2. Интеграция в Control backend и поддержка встроенных ресурсов (Single-File Publish):
    • Веб-ресурсы размещены в src/ServerMonitorManager.Control/wwwroot/ (index.html, style.css, app.js) и встроены как EmbeddedResource в сборку Control, сохраняя единую разворачиваемую единицу (ochenstarik-smm-control) при PublishSingleFile=true.
    • Маршруты консоли (/, /index.html, /style.css, /app.js, /console) защищены авторизацией роли Operator (.RequireAuthorization("Operator")).
    • Механизм GetWebConsoleAsset проверяет наличие файлов на диске и автоматически переключается на извлечение из EmbeddedResource при отсутствии каталога wwwroot на диске.
  3. Безопасность доступа (mTLS):
    • Доступ к статическим ресурсам и API консоли строго ограничен ролью Operator.
    • Неаутентифицированные запросы отклоняются с 401 Unauthorized.
    • Роли Agent и Automation получают отказ с 403 Forbidden.

Отчёт о тестировании

1. Локальные тесты (PASS)

  • Сборка решения: dotnet build — 0 ошибок.
  • Набор тестов: dotnet test — 150 пройденных тестов (включая 16 интеграционных проверок в WebConsoleTests.cs):
    • AnonymousAccessToWebConsoleRoutesIsRejectedWithUnauthorized — 401 Unauthorized на маршрутах /, /index.html, /style.css, /app.js, /console;
    • AgentRoleIsForbiddenFromWebConsole — 403 Forbidden для роли Agent;
    • AutomationRoleIsForbiddenFromWebConsole — 403 Forbidden для роли Automation;
    • OperatorCanAccessWebConsoleHtmlAndAssets — 200 OK с корректными MIME-типами (text/html, text/css, application/javascript);
    • WebConsoleHtmlContainsRequiredUiElementsAndWarning — проверка наличия элементов интерфейса (таблицы, форма добавления узла, поля вывода кода, отпечатка CA, кнопки копирования и текста предупреждения о сверке отпечатка);
    • EmbeddedAssetsAreServedWhenDiskWebRootIsMissing — тест ветки встроенных ресурсов: поднятие тестового хоста с пустым/отсутствующим WebRootPath подтверждает, что маршруты /, /index.html, /style.css, /app.js и /console успешно возвращают 200 OK, ожидаемые MIME-типы и непустое содержимое из ресурсов сборки EmbeddedResource.

2. CI Workflows (PASS, все зелёные)

3. Границы изменений

  • git diff --name-only origin/main:
    • src/ServerMonitorManager.Control/Program.cs
    • src/ServerMonitorManager.Control/ServerMonitorManager.Control.csproj
    • src/ServerMonitorManager.Control/wwwroot/app.js
    • src/ServerMonitorManager.Control/wwwroot/index.html
    • src/ServerMonitorManager.Control/wwwroot/style.css
    • tests/ServerMonitorManager.Control.Tests/WebConsoleTests.cs
  • Файлы deploy/**, релизные workflow и защищённые каталоги не затрагивались.

4. Что не проверялось и почему

  • Вход по логину и паролю без mTLS не реализовывался, так как является предметом изолированного Этапа 3 и должен разрабатываться после слияния Этапа 2 в main.
## Antigravity: веб-консоль оператора — Этап 2 Реализована веб-консоль оператора для управления узлами, сетевыми связями (Links) и выдачи кодов регистрации (`smm-antigravity-task-web-console-2026-08-17.md`). ### База - Базовая ветка: `main` @ `f7b10ac` - Ветка: `antigravity/web-console` --- ### Что сделано 1. **Веб-интерфейс консоли оператора (SPA):** - **Список узлов:** загрузка реальных данных из `GET /api/v1/control/agents` (имя узла, статус, версия агента, последний heartbeat, состояние сертификата). - **Список сетевых связей (Links):** загрузка реальных данных из `GET /api/v1/control/links` (ID связи, источник, назначение, протокол/порт, требуемое и фактическое состояние, срок действия). - **Кнопка «Добавить узел» и модальное окно:** - Валидация имени узла (`1-63` символа, строчные буквы, цифры, дефисы). - Вызов эндпоинта `POST /api/v1/control/agents/{nodeId}/enrollment-code`. - Крупное отображение выданного кода `SMMNODE2...` и отпечатка CA (SHA-256) с копированием в буфер обмена в один клик. - **Обязательное заметное предупреждение:** «При выполнении установщика на сервере обязательно сверьте отпечаток CA, выведенный скриптом, с отпечатком ниже. Подтверждение без сверки обесценивает криптографическую проверку подписи!». - 10-минутный обратный отсчет срока действия кода. 2. **Интеграция в Control backend и поддержка встроенных ресурсов (Single-File Publish):** - Веб-ресурсы размещены в `src/ServerMonitorManager.Control/wwwroot/` (`index.html`, `style.css`, `app.js`) и встроены как `EmbeddedResource` в сборку Control, сохраняя единую разворачиваемую единицу (`ochenstarik-smm-control`) при `PublishSingleFile=true`. - Маршруты консоли (`/`, `/index.html`, `/style.css`, `/app.js`, `/console`) защищены авторизацией роли `Operator` (`.RequireAuthorization("Operator")`). - Механизм `GetWebConsoleAsset` проверяет наличие файлов на диске и автоматически переключается на извлечение из `EmbeddedResource` при отсутствии каталога `wwwroot` на диске. 3. **Безопасность доступа (mTLS):** - Доступ к статическим ресурсам и API консоли строго ограничен ролью `Operator`. - Неаутентифицированные запросы отклоняются с `401 Unauthorized`. - Роли `Agent` и `Automation` получают отказ с `403 Forbidden`. --- ### Отчёт о тестировании #### 1. Локальные тесты (PASS) - Сборка решения: `dotnet build` — 0 ошибок. - Набор тестов: `dotnet test` — **150 пройденных тестов** (включая 16 интеграционных проверок в `WebConsoleTests.cs`): - `AnonymousAccessToWebConsoleRoutesIsRejectedWithUnauthorized` — 401 Unauthorized на маршрутах `/`, `/index.html`, `/style.css`, `/app.js`, `/console`; - `AgentRoleIsForbiddenFromWebConsole` — 403 Forbidden для роли `Agent`; - `AutomationRoleIsForbiddenFromWebConsole` — 403 Forbidden для роли `Automation`; - `OperatorCanAccessWebConsoleHtmlAndAssets` — 200 OK с корректными MIME-типами (`text/html`, `text/css`, `application/javascript`); - `WebConsoleHtmlContainsRequiredUiElementsAndWarning` — проверка наличия элементов интерфейса (таблицы, форма добавления узла, поля вывода кода, отпечатка CA, кнопки копирования и текста предупреждения о сверке отпечатка); - `EmbeddedAssetsAreServedWhenDiskWebRootIsMissing` — **тест ветки встроенных ресурсов**: поднятие тестового хоста с пустым/отсутствующим `WebRootPath` подтверждает, что маршруты `/`, `/index.html`, `/style.css`, `/app.js` и `/console` успешно возвращают 200 OK, ожидаемые MIME-типы и непустое содержимое из ресурсов сборки `EmbeddedResource`. #### 2. CI Workflows (PASS, все зелёные) - **Linux control and agent (PR #59):** - Run: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203480 - Job `build-and-test`: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203480/job/95482658110 — **PASS** (4m 34s) - **Linux platform matrix (PR #59):** - Run: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491 - Jobs: - Release archive (linux-x64): https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95482658550 — **PASS** - Release archive (linux-arm64): https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95482658482 — **PASS** - Ubuntu 22.04 x64 / arm64: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95483027945 / https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95483027753 — **PASS** - Ubuntu 24.04 x64 / arm64: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95483027806 / https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95483027824 — **PASS** - Debian 12 x64 / arm64: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95483027885 / https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95483027803 — **PASS** - Debian 13 x64 / arm64: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95483027739 / https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203491/job/95483027857 — **PASS** - **Windows build (PR #59):** - Run: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203452 - Job `build`: https://github.com/ochenstarik-ui/server-monitor-manager/actions/runs/32061203452/job/95482657920 — **PASS** (3m 21s) #### 3. Границы изменений - `git diff --name-only origin/main`: - `src/ServerMonitorManager.Control/Program.cs` - `src/ServerMonitorManager.Control/ServerMonitorManager.Control.csproj` - `src/ServerMonitorManager.Control/wwwroot/app.js` - `src/ServerMonitorManager.Control/wwwroot/index.html` - `src/ServerMonitorManager.Control/wwwroot/style.css` - `tests/ServerMonitorManager.Control.Tests/WebConsoleTests.cs` - Файлы `deploy/**`, релизные workflow и защищённые каталоги не затрагивались. #### 4. Что не проверялось и почему - Вход по логину и паролю без mTLS не реализовывался, так как является предметом изолированного Этапа 3 и должен разрабатываться после слияния Этапа 2 в `main`.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
bug

Something isn't working

  
documentation

Improvements or additions to documentation

  
duplicate

This issue or pull request already exists

  
enhancement

New feature or request

  
good first issue

Good for newcomers

  
help wanted

Extra attention is needed

  
invalid

This doesn't seem right

  
question

Further information is requested

  
wontfix

This will not be worked on

No labels
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: ochenstarik/server-monitor-manager#59
No description provided.
Delete branch "antigravity/web-console"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?