feat: Windows admin in Settings UI and WinRM host test (0.10.1)

Store domain admin in ui_settings (DB overrides env); qwinsta/logoff use effective config.
Host card: POST /hosts/{id}/actions/winrm-test via pywinrm.

backend/app/api/v1/hosts.py

@@ -10,6 +10,14 @@ from app.models import Event, Host
 from app.schemas.list_models import HostDetail, HostListResponse, HostSummary
 from app.services.agent_version import latest_agent_versions_by_product
 from app.services.host_delete import delete_host_and_related
+from app.services.win_admin_settings import get_effective_win_admin_config
+from app.services.winrm_connect import (
+    HostNotWindowsError,
+    HostTargetMissingError,
+    WinAdminNotConfiguredError,
+    resolve_windows_host_target,
+    test_winrm_connection,
+)
 from app.services.host_health import (
     HEARTBEAT_TYPE,
     agent_status as compute_agent_status,
@@ -156,6 +164,53 @@ class HostDeleteResponse(BaseModel):
     deleted_problems: int
 
 
+class HostWinRmTestResponse(BaseModel):
+    ok: bool
+    message: str
+    target: str
+    hostname: str | None = None
+
+
+@router.post("/{host_id}/actions/winrm-test", response_model=HostWinRmTestResponse)
+def test_host_winrm(
+    host_id: int,
+    db: Session = Depends(get_db),
+    _user=Depends(require_admin),
+) -> HostWinRmTestResponse:
+    host = db.get(Host, host_id)
+    if host is None:
+        raise HTTPException(status_code=404, detail="Host not found")
+
+    cfg = get_effective_win_admin_config(db)
+    if not cfg.configured:
+        raise HTTPException(status_code=400, detail="Windows domain admin is not configured")
+
+    try:
+        target = resolve_windows_host_target(host)
+    except HostNotWindowsError as exc:
+        raise HTTPException(status_code=400, detail=str(exc)) from exc
+    except HostTargetMissingError as exc:
+        raise HTTPException(status_code=400, detail=str(exc)) from exc
+
+    try:
+        result = test_winrm_connection(
+            target=target,
+            user=cfg.user,
+            password=cfg.password,
+        )
+    except WinAdminNotConfiguredError as exc:
+        raise HTTPException(status_code=400, detail=str(exc)) from exc
+    except RuntimeError as exc:
+        raise HTTPException(status_code=503, detail=str(exc)) from exc
+
+    return HostWinRmTestResponse(
+        ok=result.ok,
+        message=result.message,
+        target=result.target,
+        hostname=result.hostname,
+    )
+
+
 @router.delete("/{host_id}", response_model=HostDeleteResponse)
 def delete_host(
     host_id: int,

backend/app/api/v1/settings.py

@@ -37,6 +37,17 @@ from app.services.ui_settings import (
     get_effective_ui_settings,
     upsert_ui_settings,
 )
+from app.services.win_admin_settings import (
+    get_effective_win_admin_config,
+    upsert_win_admin_settings,
+)
+from app.services.winrm_connect import (
+    HostNotWindowsError,
+    HostTargetMissingError,
+    WinAdminNotConfiguredError,
+    resolve_windows_host_target,
+    test_winrm_connection,
+)
 
 router = APIRouter(prefix="/settings", tags=["settings"])
 
@@ -439,3 +450,46 @@ def update_ui_settings(
         show_sidebar_system_stats=cfg.show_sidebar_system_stats,
         source=cfg.source,
     )
+
+
+class WinAdminSettingsResponse(BaseModel):
+    configured: bool
+    user: str | None = None
+    password_hint: str | None = None
+    source: str = Field(description="env или db")
+
+
+class WinAdminSettingsUpdate(BaseModel):
+    user: str | None = None
+    password: str | None = None
+
+
+@router.get("/win-admin", response_model=WinAdminSettingsResponse)
+def get_win_admin_settings(
+    db: Session = Depends(get_db),
+    _user=Depends(require_admin),
+) -> WinAdminSettingsResponse:
+    cfg = get_effective_win_admin_config(db)
+    return WinAdminSettingsResponse(
+        configured=cfg.configured,
+        user=cfg.user or None,
+        password_hint=_mask_secret(cfg.password),
+        source=cfg.source,
+    )
+
+
+@router.put("/win-admin", response_model=WinAdminSettingsResponse)
+def update_win_admin_settings(
+    body: WinAdminSettingsUpdate,
+    db: Session = Depends(get_db),
+    _user=Depends(require_admin),
+) -> WinAdminSettingsResponse:
+    if body.user is not None and not body.user.strip():
+        raise HTTPException(status_code=422, detail="user must not be empty")
+    cfg = upsert_win_admin_settings(db, user=body.user, password=body.password)
+    return WinAdminSettingsResponse(
+        configured=cfg.configured,
+        user=cfg.user or None,
+        password_hint=_mask_secret(cfg.password),
+        source=cfg.source,
+    )

backend/app/models/ui_settings.py

@@ -1,4 +1,4 @@
-from sqlalchemy import Boolean
+from sqlalchemy import Boolean, String, Text
 from sqlalchemy.orm import Mapped, mapped_column
 
 from app.database import Base
@@ -13,3 +13,5 @@ class UiSettings(Base):
 
     id: Mapped[int] = mapped_column(primary_key=True)
     show_sidebar_system_stats: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
+    win_admin_user: Mapped[str | None] = mapped_column(String(256), nullable=True)
+    win_admin_password: Mapped[str | None] = mapped_column(Text, nullable=True)

backend/app/services/agent_commands.py

@@ -12,20 +12,20 @@ from sqlalchemy.orm import Session
 from app.config import get_settings
 from app.models import AgentCommand, Event, Host
 from app.services.rdg_session_flap import event_has_rdg_flap
+from app.services.win_admin_settings import get_effective_win_admin_config
 
 
 def _win_admin_configured() -> bool:
-    settings = get_settings()
-    return bool(settings.sac_win_admin_user.strip() and settings.sac_win_admin_password.strip())
+    return get_effective_win_admin_config().configured
 
 
 def win_admin_run_as() -> dict[str, str] | None:
-    if not _win_admin_configured():
+    cfg = get_effective_win_admin_config()
+    if not cfg.configured:
         return None
-    settings = get_settings()
     return {
-        "user": settings.sac_win_admin_user.strip(),
-        "password": settings.sac_win_admin_password,
+        "user": cfg.user,
+        "password": cfg.password,
     }
 
 
@@ -53,7 +53,7 @@ def queue_qwinsta(db: Session, event: Event, *, requested_by: str) -> AgentComma
     if not _win_admin_configured():
         raise HTTPException(
             status_code=503,
-            detail="SAC_WIN_ADMIN_USER / SAC_WIN_ADMIN_PASSWORD not configured",
+            detail="Windows domain admin is not configured (Settings or SAC_WIN_ADMIN_*)",
         )
     details = event.details if isinstance(event.details, dict) else {}
     user = details.get("user")
@@ -83,7 +83,7 @@ def queue_logoff(
     if not _win_admin_configured():
         raise HTTPException(
             status_code=503,
-            detail="SAC_WIN_ADMIN_USER / SAC_WIN_ADMIN_PASSWORD not configured",
+            detail="Windows domain admin is not configured (Settings or SAC_WIN_ADMIN_*)",
         )
     cmd = AgentCommand(
         command_uuid=str(uuid.uuid4()),

backend/app/services/win_admin_settings.py

@@ -0,0 +1,82 @@
+"""Effective Windows domain admin credentials (DB overrides env)."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from sqlalchemy.orm import Session
+
+from app.config import get_settings
+from app.models.ui_settings import UI_SETTINGS_ROW_ID, UiSettings
+
+
+@dataclass(frozen=True)
+class WinAdminConfig:
+    user: str
+    password: str
+    source: str  # env | db
+
+    @property
+    def configured(self) -> bool:
+        return bool(self.user.strip() and self.password.strip())
+
+
+def _win_admin_from_env() -> WinAdminConfig:
+    settings = get_settings()
+    return WinAdminConfig(
+        user=settings.sac_win_admin_user.strip(),
+        password=settings.sac_win_admin_password,
+        source="env",
+    )
+
+
+def get_effective_win_admin_config(db: Session | None = None) -> WinAdminConfig:
+    if db is None:
+        from app.database import SessionLocal
+
+        session = SessionLocal()
+        try:
+            return get_effective_win_admin_config(session)
+        finally:
+            session.close()
+
+    row = db.get(UiSettings, UI_SETTINGS_ROW_ID)
+    env_cfg = _win_admin_from_env()
+    if row is None:
+        return env_cfg
+
+    user = (row.win_admin_user or "").strip() or env_cfg.user
+    password = (row.win_admin_password or "") or env_cfg.password
+    has_db_values = bool((row.win_admin_user or "").strip() or (row.win_admin_password or "").strip())
+    return WinAdminConfig(
+        user=user,
+        password=password,
+        source="db" if has_db_values else env_cfg.source,
+    )
+
+
+def upsert_win_admin_settings(
+    db: Session,
+    *,
+    user: str | None = None,
+    password: str | None = None,
+) -> WinAdminConfig:
+    row = db.get(UiSettings, UI_SETTINGS_ROW_ID)
+    env_cfg = _win_admin_from_env()
+    if row is None:
+        row = UiSettings(
+            id=UI_SETTINGS_ROW_ID,
+            show_sidebar_system_stats=True,
+            win_admin_user=env_cfg.user or None,
+            win_admin_password=env_cfg.password or None,
+        )
+        db.add(row)
+
+    if user is not None and user.strip():
+        row.win_admin_user = user.strip()
+    if password is not None and password.strip():
+        row.win_admin_password = password
+
+    db.commit()
+    db.refresh(row)
+    return get_effective_win_admin_config(db)

backend/app/services/winrm_connect.py

@@ -0,0 +1,106 @@
+"""WinRM connectivity test for Windows hosts using domain admin credentials."""
+
+from __future__ import annotations
+
+import socket
+from dataclasses import dataclass
+
+from app.models import Host
+
+
+class WinAdminNotConfiguredError(Exception):
+    pass
+
+
+class HostNotWindowsError(Exception):
+    pass
+
+
+class HostTargetMissingError(Exception):
+    pass
+
+
+@dataclass(frozen=True)
+class WinRmTestResult:
+    ok: bool
+    message: str
+    target: str
+    hostname: str | None = None
+
+
+def resolve_windows_host_target(host: Host) -> str:
+    if not is_windows_host(host):
+        raise HostNotWindowsError("Host is not Windows")
+    target = (host.ipv4 or "").strip() or (host.hostname or "").strip()
+    if not target:
+        raise HostTargetMissingError("Host has no IPv4 or hostname for WinRM test")
+    return target
+
+
+def is_windows_host(host: Host) -> bool:
+    if (host.os_family or "").strip().lower() == "windows":
+        return True
+    return (host.product or "").strip() == "rdp-login-monitor"
+
+
+def test_winrm_connection(
+    *,
+    target: str,
+    user: str,
+    password: str,
+    timeout_sec: int = 15,
+) -> WinRmTestResult:
+    target = target.strip()
+    user = user.strip()
+    if not target or not user or not password:
+        raise WinAdminNotConfiguredError("Windows admin credentials or target missing")
+
+    try:
+        import winrm
+    except ImportError as exc:
+        raise RuntimeError("pywinrm is not installed on SAC server") from exc
+
+    endpoint = f"http://{target}:5985/wsman"
+    try:
+        session = winrm.Session(
+            endpoint,
+            auth=(user, password),
+            transport="ntlm",
+            read_timeout_sec=timeout_sec,
+            operation_timeout_sec=timeout_sec,
+        )
+        result = session.run_cmd("hostname")
+    except winrm.exceptions.WinRMTransportError as exc:
+        return WinRmTestResult(
+            ok=False,
+            message=f"WinRM transport error: {exc}",
+            target=target,
+        )
+    except (socket.timeout, TimeoutError):
+        return WinRmTestResult(
+            ok=False,
+            message=f"WinRM timeout ({timeout_sec}s) to {target}:5985",
+            target=target,
+        )
+    except Exception as exc:
+        return WinRmTestResult(
+            ok=False,
+            message=f"WinRM error: {exc}",
+            target=target,
+        )
+
+    stdout = (result.std_out or b"").decode("utf-8", errors="replace").strip()
+    stderr = (result.std_err or b"").decode("utf-8", errors="replace").strip()
+    if result.status_code == 0 and stdout:
+        return WinRmTestResult(
+            ok=True,
+            message=f"WinRM OK, hostname={stdout}",
+            target=target,
+            hostname=stdout,
+        )
+    detail = stderr or stdout or f"exit code {result.status_code}"
+    return WinRmTestResult(
+        ok=False,
+        message=f"WinRM command failed: {detail}",
+        target=target,
+    )

backend/app/version.py

@@ -1,5 +1,5 @@
 """Единый источник версии SAC (API, health, логи, OpenAPI)."""
 
 APP_NAME = "Security Alert Center"
-APP_VERSION = "0.10.0"
+APP_VERSION = "0.10.1"
 APP_VERSION_LABEL = f"{APP_NAME} v.{APP_VERSION}"