anti
351a8939c3
Adds a new card on AttackerDetail: SCANNED · N services | INTERACTED WITH · M services. Distinguishes port-scanners (N high, M=0) from actual engagement (M>0) at a glance — the analyst's first question when triaging a new attacker row. Classifier lives in decnet/correlation/event_kinds.py, a single source of truth for the event-type vocabulary: - INTERACTION_EVENT_TYPES — command-family (command/exec/query/...), SMTP engagement (mail_from/rcpt_to/message_accepted), file/payload activity (file_captured/upload/download_attempt/retr), pub/sub (publish/subscribe), recorded TTY sessions. - NOISE_EVENT_TYPES — DECNET-internal (startup/shutdown/parse_error/ unknown_*). - Everything else defaults to scan. Conservative by design: new template verbs show up as "scanned" until explicitly promoted. Bucket logic: a service is "interacted" if ≥1 of its events classifies as interaction; otherwise "scanned" if ≥1 scan event; noise-only services drop. Disjoint by construction. Deliberate no-schema path: compute on-the-fly in the detail endpoint via SELECT DISTINCT service, event_type FROM logs. Small result set (tens of pairs per attacker), cost is trivial vs. the existing behavior/commands queries. Trade-off: one more DB round-trip per detail view in exchange for zero ALTER TABLE migration pain and immediate classifier-change feedback loop. Profiler's _COMMAND_EVENT_TYPES stays as-is (strict subset of interactions that carry executable text), with a comment pointing at the new canonical module. Closes DEVELOPMENT.md "Attacker Intelligence §Service-Level Behavioral Profiling — Services actively interacted with".
38 lines
1.3 KiB
Python
38 lines
1.3 KiB
Python
from typing import Any
|
||
|
||
from fastapi import APIRouter, Depends, HTTPException
|
||
|
||
from decnet.correlation.event_kinds import bucket_services
|
||
from decnet.telemetry import traced as _traced
|
||
from decnet.web.dependencies import require_viewer, repo
|
||
|
||
router = APIRouter()
|
||
|
||
|
||
@router.get(
|
||
"/attackers/{uuid}",
|
||
tags=["Attacker Profiles"],
|
||
responses={
|
||
401: {"description": "Could not validate credentials"},
|
||
403: {"description": "Insufficient permissions"},
|
||
404: {"description": "Attacker not found"},
|
||
},
|
||
)
|
||
@_traced("api.get_attacker_detail")
|
||
async def get_attacker_detail(
|
||
uuid: str,
|
||
user: dict = Depends(require_viewer),
|
||
) -> dict[str, Any]:
|
||
"""Retrieve a single attacker profile by UUID (with behavior block)."""
|
||
attacker = await repo.get_attacker_by_uuid(uuid)
|
||
if not attacker:
|
||
raise HTTPException(status_code=404, detail="Attacker not found")
|
||
attacker["behavior"] = await repo.get_attacker_behavior(uuid)
|
||
# Scanned vs. interacted-with — computed per-request from the log
|
||
# stream, not persisted. Cheap (DISTINCT bounded by service ×
|
||
# event_type cardinality), and changes to the classifier take effect
|
||
# immediately without a profiler re-tick.
|
||
pairs = await repo.get_attacker_service_activity(uuid)
|
||
attacker["service_activity"] = bucket_services(pairs)
|
||
return attacker
|