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.

4.8 KB
Raw Blame
"""
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.
"""

import sys
from unittest.mock import MagicMock, patch

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 == []


@pytest.mark.asyncio
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