60 lines
2.2 KiB
Python
60 lines
2.2 KiB
Python
"""Server status and health-check Pydantic models.
|
|
|
|
Used by the dashboard router, health service, and server settings router.
|
|
"""
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
|
|
class ServerStatus(BaseModel):
|
|
"""Cached fail2ban server health snapshot."""
|
|
|
|
model_config = ConfigDict(strict=True)
|
|
|
|
online: bool = Field(..., description="Whether fail2ban is reachable via its socket.")
|
|
version: str | None = Field(default=None, description="fail2ban version string.")
|
|
active_jails: int = Field(default=0, ge=0, description="Number of currently active jails.")
|
|
total_bans: int = Field(default=0, ge=0, description="Aggregated current ban count across all jails.")
|
|
total_failures: int = Field(default=0, ge=0, description="Aggregated current failure count across all jails.")
|
|
|
|
|
|
class ServerStatusResponse(BaseModel):
|
|
"""Response for ``GET /api/dashboard/status``."""
|
|
|
|
model_config = ConfigDict(strict=True)
|
|
|
|
status: ServerStatus
|
|
bangui_version: str = Field(..., description="BanGUI application version.")
|
|
|
|
|
|
class ServerSettings(BaseModel):
|
|
"""Domain model for fail2ban server-level settings."""
|
|
|
|
model_config = ConfigDict(strict=True)
|
|
|
|
log_level: str = Field(..., description="fail2ban daemon log level.")
|
|
log_target: str = Field(..., description="Log destination: STDOUT, STDERR, SYSLOG, or a file path.")
|
|
syslog_socket: str | None = Field(default=None)
|
|
db_path: str = Field(..., description="Path to the fail2ban ban history database.")
|
|
db_purge_age: int = Field(..., description="Seconds before old records are purged.")
|
|
db_max_matches: int = Field(..., description="Maximum stored matches per ban record.")
|
|
|
|
|
|
class ServerSettingsUpdate(BaseModel):
|
|
"""Payload for ``PUT /api/server/settings``."""
|
|
|
|
model_config = ConfigDict(strict=True)
|
|
|
|
log_level: str | None = Field(default=None)
|
|
log_target: str | None = Field(default=None)
|
|
db_purge_age: int | None = Field(default=None, ge=0)
|
|
db_max_matches: int | None = Field(default=None, ge=0)
|
|
|
|
|
|
class ServerSettingsResponse(BaseModel):
|
|
"""Response for ``GET /api/server/settings``."""
|
|
|
|
model_config = ConfigDict(strict=True)
|
|
|
|
settings: ServerSettings
|