Destructive half of BEHAVE-INTEGRATION.md Phase 1. SessionProfile + its kd_* columns + the dialect ALTER TABLE migration helpers are deleted outright; pre-v1, the table shipped empty, no migration ceremony required (per the no-new-_migrate_-pre-v1 memory rule). DEBT-036 closes via DEBT-050 supersedure. AttackerDetail's ``observations`` field is wired to the new ``observations`` table and returns an empty list until the BEHAVE-SHELL extractor (DEBT-050 Phase 2) starts emitting. decnet/web/db/models/attackers.py — SessionProfile class deleted (~135 lines), KD_PAUSE_*/KD_START_OF_ACTION_IDLE_S module constants deleted, module docstring updated to point at the observations table. AttackerIdentity.kd_digraph_simhash is KEPT — it's the v2 federation centroid hook, not a SessionProfile field; docstring repointed to the BEHAVE primitive that will populate it. decnet/web/db/sqlmodel_repo/attackers/sessions.py — DELETED. SessionProfilesMixin dropped from the AttackersMixin MRO. decnet/web/db/repository.py — abstract upsert_session_profile + get_session_profile removed. decnet/web/db/sqlite/repository.py + mysql/repository.py — _migrate_session_profile_table helpers and their initialize() calls removed. mysql initialize() now goes attackers → column_types → admin (no session_profile step). decnet/web/db/models/__init__.py — SessionProfile re-export gone. decnet/web/db/models/attacker_intel.py — docstring cross-reference to SessionProfile.schema_version retargeted to AttackerIdentity. decnet/web/router/attackers/api_get_attacker_detail.py — adds ``observations: []`` to the response by calling ``repo.latest_observation_per_primitive(uuid)`` and projecting to a list sorted by primitive path. Empty until the extractor lands; shape matches BEHAVE-INTEGRATION.md §"AttackerDetail consumer". tests/profiler/test_session_profile.py — DELETED (56 lines). tests/db/test_base_repo.py — DummyRepo loses upsert_session_profile and get_session_profile overrides. tests/db/mysql/test_mysql_migration.py — initialize-call-order assertion updated; session_profile step removed from the expected sequence; docstring records why. tests/ttp/test_lifter_absence.py — docstring "no SessionProfile" → "no ObservationRow".
54 lines
2.3 KiB
Python
54 lines
2.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)
|
||
# Attribution leaks — XFF / Forwarded / X-Real-IP mismatches captured
|
||
# by the HTTP bounty extractor. Cap the returned list at 10 so a
|
||
# rotation attack (100s of forged XFF values) doesn't flood the UI;
|
||
# `ip_leaks_total` carries the unbounded count so the UI can render
|
||
# a ROTATION DETECTED badge when the count crosses a threshold.
|
||
attacker["ip_leaks"] = await repo.get_attacker_ip_leaks(uuid, limit=10)
|
||
attacker["ip_leaks_total"] = await repo.count_attacker_ip_leaks(uuid)
|
||
# BEHAVE-SHELL observations — latest value per primitive for this
|
||
# attacker. Empty dict (rendered as empty list) until the
|
||
# extractor (DEBT-050) lands and starts writing rows. The frontend
|
||
# panel that consumes this ships in BEHAVE-INTEGRATION.md Phase 5.
|
||
latest_per_primitive = await repo.latest_observation_per_primitive(uuid)
|
||
attacker["observations"] = [
|
||
{"primitive": primitive, **payload}
|
||
for primitive, payload in sorted(latest_per_primitive.items())
|
||
]
|
||
return attacker
|