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.0 KB
Raw Blame
"""
Tests for MOD-067: Azure AD indentation bug, UnboundLocalError,
and Graph API enumeration reachability in cloud.azure_ad.
"""

from unittest.mock import 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.cloud.azure_ad import AzureADModule


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


@pytest.mark.asyncio
async def test_azure_ad_enumerate_no_unbound_local_error():
    """Verify default technique='enumerate' does NOT raise UnboundLocalError when no token is present."""
    mod = _make_module()
    findings, raw = await mod.run(
        tenant_id="00000000-0000-0000-0000-000000000000",
        technique="enumerate",
    )
    assert isinstance(raw, dict)
    assert raw.get("tenant_id") == "00000000-0000-0000-0000-000000000000"
    assert "error" in raw
    assert "azure_ad_findings" in raw
    assert raw["azure_ad_findings"] == findings


@pytest.mark.asyncio
async def test_azure_ad_enumerate_reaches_graph_api():
    """Verify Graph API enumeration code path is reached and executed when token is supplied."""
    mod = _make_module()
    mock_tenant_results = {
        "guests": [{"userPrincipalName": "[email protected]"}],
        "service_principals": [
            {"displayName": "HighPrivDaemon", "privileged": True, "has_expired_secret": False}
        ],
        "privileged_users": [{"userPrincipalName": "[email protected]"}],
        "user_count": 42,
    }

    with patch.object(mod, "_enumerate_tenant", return_value=mock_tenant_results) as mock_enum:
        findings, raw = await mod.run(
            tenant_id="11111111-2222-3333-4444-555555555555",
            access_token="eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.fake",
            technique="enumerate",
        )

        mock_enum.assert_called_once_with(
            "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.fake",
            "11111111-2222-3333-4444-555555555555",
        )

        assert raw.get("tenant_id") == "11111111-2222-3333-4444-555555555555"
        assert raw.get("technique") == "enumerate"
        assert raw.get("user_count") == 42
        assert raw.get("guest_count") == 1
        assert raw.get("sp_count") == 1
        assert "azure_ad_findings" in raw
        assert raw["azure_ad_findings"] == findings

        titles = [f.title for f in findings]
        assert any("Guest Accounts" in t for t in titles)
        assert any("Privileged Service Principals" in t for t in titles)


@pytest.mark.asyncio
async def test_azure_ad_device_code_technique_still_works():
    """Verify technique='device_code' flow works properly and populates expected keys."""
    mod = _make_module()
    mock_dc_info = {
        "user_code": "XYZ-9876",
        "verification_uri": "https://microsoft.com/devicelogin",
        "expires_in": 900,
        "interval": 5,
        "device_code": "mock_device_code",
    }

    with patch.object(mod, "_request_device_code", return_value=mock_dc_info) as mock_dc:
        findings, raw = await mod.run(
            tenant_id="99999999-8888-7777-6666-555555555555",
            technique="device_code",
        )

        mock_dc.assert_called_once()
        assert raw.get("technique") == "device_code"
        assert raw.get("user_code") == "XYZ-9876"
        assert "access_tokens" in raw
        assert "azure_ad_findings" in raw
        assert raw["azure_ad_findings"] == findings

        titles = [f.title for f in findings]
        assert any("Device Code Generated" in t for t in titles)