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.2 KB
Raw Blame
import sys
import types
from unittest.mock import MagicMock

from ares.core.campaign import Campaign, NoiseProfile, ScopeEntry
from ares.core.config import AresSettings
from ares.core.noise import NoiseController
from ares.modules.ad.dependencies import build_ad_bind_plan
from ares.modules.ad.enum_acl import ADEnumACLModule
from ares.modules.ad.laps_enum import LAPSEnumModule


def _make_module(cls):
    settings = AresSettings(
        ares_secret_key="test-secret-key-32chars-minimum!!",
        ares_encryption_key="test-encryption-key-32chars-min!!",
    )
    campaign = Campaign(
        name="AD-Test",
        client="Unit-Testing",
        scope=[ScopeEntry(cidr="10.0.0.0/8")],
        noise_profile=NoiseProfile.NORMAL,
    )
    noise = NoiseController(campaign)
    return cls(settings=settings, campaign=campaign, noise=noise)


def _install_mock_ldap3(monkeypatch):
    """Install mock ldap3 modules in sys.modules for test environments lacking optional ldap3."""
    ldap3_mod = types.ModuleType("ldap3")
    ldap3_mod.AUTO_BIND_NONE = "AUTO_BIND_NONE"
    ldap3_mod.ALL = "ALL"
    ldap3_mod.NTLM = "NTLM"
    ldap3_mod.SUBTREE = "SUBTREE"

    mock_conn = MagicMock()
    mock_conn.bind.return_value = True
    mock_conn.entries = []
    mock_conn.result = {}

    mock_connection_cls = MagicMock(return_value=mock_conn)
    mock_server_cls = MagicMock()
    mock_tls_cls = MagicMock()

    ldap3_mod.Connection = mock_connection_cls
    ldap3_mod.Server = mock_server_cls
    ldap3_mod.Tls = mock_tls_cls
    ldap3_mod.CERT_NONE = 0

    ldap3_core = types.ModuleType("ldap3.core")
    ldap3_exceptions = types.ModuleType("ldap3.core.exceptions")
    ldap3_exceptions.LDAPBindError = type("LDAPBindError", (Exception,), {})
    ldap3_mod.core = ldap3_core
    ldap3_core.exceptions = ldap3_exceptions

    monkeypatch.setitem(sys.modules, "ldap3", ldap3_mod)
    monkeypatch.setitem(sys.modules, "ldap3.core", ldap3_core)
    monkeypatch.setitem(sys.modules, "ldap3.core.exceptions", ldap3_exceptions)

    return mock_connection_cls, mock_conn


def test_build_ad_bind_plan_formats():
    """Verify build_ad_bind_plan handles UPN, NetBIOS, and plain username."""
    # UPN
    upn_plan = build_ad_bind_plan("[email protected]", "corp.local")
    assert upn_plan.mode == "simple"
    assert upn_plan.user == "[email protected]"
    assert upn_plan.username_format == "upn"

    # NetBIOS
    netbios_plan = build_ad_bind_plan("CORP\\alice", "corp.local")
    assert netbios_plan.mode == "ntlm"
    assert netbios_plan.user == "CORP\\alice"
    assert netbios_plan.username_format == "netbios"

    # Plain with domain
    plain_plan = build_ad_bind_plan("alice", "corp.local")
    assert plain_plan.mode == "simple"
    assert plain_plan.user == "[email protected]"
    assert plain_plan.username_format == "plain_to_upn"


def test_enum_acl_uses_build_ad_bind_plan(monkeypatch):
    """MOD-057: enum_acl._enum_acls_sync uses build_ad_bind_plan rather than raw string concat."""
    mock_connection_cls, mock_conn = _install_mock_ldap3(monkeypatch)

    module = _make_module(ADEnumACLModule)

    # Test with UPN: should use simple bind and [email protected], NOT CORP.LOCAL\\[email protected]
    module._enum_acls_sync(
        dc="10.0.0.1",
        username="[email protected]",
        password="Password123!",
        domain="corp.local",
    )

    mock_connection_cls.assert_called()
    call_kwargs = mock_connection_cls.call_args[1]
    assert call_kwargs["user"] == "[email protected]"
    # For UPN, simple bind is used (no NTLM in kwargs)
    assert "authentication" not in call_kwargs


def test_laps_enum_uses_build_ad_bind_plan(monkeypatch):
    """MOD-057: laps_enum._query_laps_sync uses build_ad_bind_plan rather than raw string concat."""
    mock_connection_cls, mock_conn = _install_mock_ldap3(monkeypatch)

    module = _make_module(LAPSEnumModule)

    # Test with NetBIOS: should use NTLM authentication
    module._query_laps_sync(
        dc="10.0.0.1",
        username="CORP\\admin",
        password="Password123!",
        domain="corp.local",
    )

    mock_connection_cls.assert_called()
    call_kwargs = mock_connection_cls.call_args[1]
    assert call_kwargs["user"] == "CORP\\admin"
    assert call_kwargs.get("authentication") == "NTLM"