mirror of
https://github.com/jokob-sk/NetAlertX.git
synced 2026-06-21 14:49:59 -04:00
26b337d6a7
- Added `queryByConditions` method to `DeviceInstance` for flexible device querying based on dynamic conditions. - Introduced `interpolate_tokens` function to replace placeholders in action values with actual device data. - Updated `UpdateFieldAction` to handle cross-device updates and archive conflicting MAC addresses. - Implemented cascade prevention in `WorkflowManager` to avoid processing events for devices modified in the same batch. - Added unit tests for new functionalities, including token interpolation, condition querying, and action execution. - Created constants for device column validation to enhance security and maintainability. - Established a structured research skill specification to guide development practices.
42 lines
2.0 KiB
Python
42 lines
2.0 KiB
Python
"""
|
|
Shared constants for the workflow engine.
|
|
|
|
Centralised here so that manager, actions, and models can all import from a
|
|
single source of truth rather than duplicating schema knowledge across files.
|
|
"""
|
|
|
|
import re
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Devices table column whitelist
|
|
# ---------------------------------------------------------------------------
|
|
|
|
# Every column present in the Devices table schema. Used in two ways:
|
|
# 1. Token validation — {{trigger.COLUMN}} tokens are rejected at workflow
|
|
# load time if COLUMN is not in this set.
|
|
# 2. Query safety — queryByConditions() refuses to build WHERE clauses for
|
|
# columns not in this set, preventing SQL injection via workflow JSON.
|
|
VALID_DEVICE_COLUMNS = frozenset([
|
|
"devMac", "devName", "devOwner", "devType", "devVendor", "devFavorite",
|
|
"devGroup", "devComments", "devFirstConnection", "devLastConnection",
|
|
"devLastIP", "devPrimaryIPv4", "devPrimaryIPv6", "devVlan", "devForceStatus",
|
|
"devStaticIP", "devScan", "devLogEvents", "devAlertEvents", "devAlertDown",
|
|
"devSkipRepeated", "devLastNotification", "devPresentLastScan", "devIsNew",
|
|
"devLocation", "devIsArchived", "devParentMAC", "devParentPort",
|
|
"devParentRelType", "devIcon", "devGUID", "devSite", "devSSID",
|
|
"devSyncHubNode", "devSourcePlugin", "devFQDN", "devMacSource",
|
|
"devNameSource", "devFQDNSource", "devLastIPSource", "devVendorSource",
|
|
"devSSIDSource", "devParentMACSource", "devParentPortSource",
|
|
"devParentRelTypeSource", "devVlanSource", "devCustomProps",
|
|
])
|
|
|
|
# Devices table columns whose CHECK constraint requires a strict integer 0 or 1.
|
|
# Values destined for these columns are cast to int before being written to DB.
|
|
BOOLEAN_COLUMNS = frozenset([
|
|
"devFavorite", "devStaticIP", "devLogEvents", "devAlertEvents",
|
|
"devAlertDown", "devPresentLastScan", "devIsNew", "devIsArchived",
|
|
])
|
|
|
|
# Compiled regex for {{trigger.COLUMN_NAME}} token substitution and validation.
|
|
TOKEN_RE = re.compile(r"\{\{trigger\.(\w+)\}\}")
|