Platform Showcase • Why ARES? • Competitive Matrix • Architecture • MITRE Matrix • Quickstart • Zero-Trust Security • Documentation

⚡ Resumo Executivo

O teste de penetração tradicional é fundamentalmente falho: é caro, episódico, pontual e deixa as organizações cegas a configurações incorretas recém-introduzidas e a táticas emergentes de adversários. Enquanto isso, scanners de vulnerabilidade automatizados sobrecarregam as equipes de SOC com milhares de CVEs hipotéticas sem demonstrar explorabilidade ou caminhos de ataque lateral multiestágio.

A ARES preenche essa lacuna. Construída do zero para infraestrutura corporativa moderna, a ARES oferece uma plataforma autônoma de engajamento de red team orientada a objetivos que modela atores de ameaça do mundo real. Ao combinar firewalls de escopo em nível de kernel, criação adaptativa de perfil de ruído OPSEC, um solucionador de ataque interativo baseado em grafo acíclico direcionado (DAG) e mais de 60 técnicas weaponizadas mapeadas para o MITRE ATT&CK, a ARES permite que equipes de segurança comprovem a explorabilidade de vulnerabilidades, localizem os caminhos mais curtos de comprometimento até as Joias da Coroa do Active Directory e gerem entregáveis prontos para executivos com zero tempo de inatividade operacional.

🎯 Por Que as Empresas Escolhem a ARES```

┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐ │ STRICT SCOPE ENCLAVE │ │ AUTONOMOUS DAG ENGINE │ │ ZERO-TRUST ARCHITECTURE │ │ Hard kernel CIDR egress │ │ Computes shortest paths │ │ Memory-only JWT tokens, │ │ whitelisting prevents │───│ to Domain Admins & Crown│───│ AES-256 encrypted vault,│ │ any collateral impact. │ │ Jewels deterministically│ │ strict HMAC-CSRF checks.│ └─────────────────────────┘ └─────────────────────────┘ └─────────────────────────┘ │ ▼ ┌─────────────────────────┐ │ INSTANT EXECUTIVE SUITE │ │ Branded PDF, HTML, JSON │ │ deliverables with zero │ │ native GTK dependencies │ └─────────────────────────┘

1. 🛡️ Enclave de Operador & Gateway Zero-Trust

Barreira de entrada autónoma concebida especificamente para operadores ofensivos autorizados e pessoal de segurança.

• O Problema Resolvido: Elimina acessos não autorizados de operadores, ataques de repetição de tokens e fuga de tokens para o armazenamento local do navegador.
• Capacidades Principais:
  • Interação de Assinatura de Fogo Carmesim: Sistema de partículas de fogo em HTML5 Canvas em tempo real envolve o botão Sign In ao pairar (contínuo), clicar (explosão) e premir Enter (explosão sem ponteiro) — partículas baseadas em física com flutuabilidade, turbulência e brilho radial usando requestAnimationFrame.
  • Mascote Ambiente ARES Cyber Dragon: Marca de água da mascote da marca integrada no painel de telemetria com opacidade calibrada e retro-brilho carmesim, harmonizada com as especificações de ambiente em vidro fosco.
  • Canvas de Grelha Arquitetural Dinâmica ao vivo: canvas HTML5 acelerado por hardware a 60 FPS com baixo overhead, com pulsos de dados em movimento em tempo real e iluminação por proximidade do cursor.
  • Isolamento de Tokens Apenas em Memória: JWTs de curta duração residem estritamente em memória; as credenciais de atualização usam cookies host-only, HttpOnly com rotação única.
  • SSO Multi-Tenant Empresarial (SAML 2.0 & OIDC): Autenticação federada iniciada pelo SP com Okta, Azure AD e Google Workspace. Inclui encriptação de credenciais Fernet ao nível da aplicação, proteção contra repetição única (InResponseTo/nonce), mapeamento de funções JIT e bloqueio estrito de palavra-passe local para identidades federadas. (Ver Guia de Configuração de SSO).
  • Proteção CSRF Double-Submit HMAC: Verificação em tempo constante em todos os pedidos que alteram estado (X-ARES-CSRF).
  • Escudo Criptográfico contra Força Bruta: Impõe backoff exponencial e limitação de taxa baseada em IP nas tentativas de autenticação.

2. 📊 Centro de Comando Executivo & Telemetria

Consola de comando operacional em tempo real que proporciona visibilidade instantânea da postura em campanhas ativas.

• O Problema Resolvido: Agrega métricas ofensivas dispersas num único painel operacional em tempo real sem exigir consultas manuais de estado.
• Capacidades Principais:
  • Sistema de Design Operacional: Concebido com hierarquia visual de alta densidade (inspirado em Grafana, Linear e Sentry) — apresentando painéis contextuais subtis com acento à esquerda (panel-subtle), indicadores de saúde reativos dinâmicos na barra superior e faixas de progresso tracejadas distintas para linhas de base de métricas não inicializadas.
  • Insights de Envolvimento Acionáveis: Substitui contagens brutas redundantes por insights contextuais de postura de segurança:
    • Postura de Envolvimento: Delimitação clara de estado (Staged, Executing ou Standby) distinguindo alvos em âmbito de campanhas em execução.
    • Saúde de Execução: Monitor em tempo real de anomalias no pipeline, falhas de execução de módulos e estabilidade do enclave.
    • Superfície de Ataque: Rastreamento ao vivo de hosts descobertos, pivôs de credenciais e profundidade de penetração na rede.
  • Ingestão de Telemetria & Pipeline: Débito do pool de workers em tempo real, duração de tarefas P95 e indicadores de ingestão de eventos ao vivo.
  • Hero Tático de Instalação Nova: Fallback automático de estado vazio com CTA de inicialização centrado e faixa de prontidão mínima ao iniciar com zero campanhas.

3. 🎯 Gestão de Campanhas com Âmbito & Fronteiras de Alvos

Governança de alvos com zero danos colaterais, impondo fronteiras rígidas de whitelist CIDR e isolamento encriptado de evidências.

• O Problema Resolvido: Impede varreduras catastróficas fora do âmbito e elimina ficheiros de credenciais não encriptados nos portáteis dos operadores.
• Capacidades Principais:
  • Orientação Persistente ao Operador: Definições persistentes de <label> em todos os seletores de campanha e campos de parâmetros, prevenindo ambiguidade do operador durante envolvimentos rápidos.
  • Whitelists CIDR Rígidas: Aplicação de fronteiras ao nível da rede. O motor interceta e descarta qualquer pedido direcionado a endereços IP ou sub-redes não aprovados.
  • Perfis de Ruído & Jitter: Configure níveis de limitação de envolvimento (Stealth, Normal, Aggressive) com distribuições de atraso aleatórias.
  • Cofre de Enclave Encriptado AES-256: Hashes NTLM recolhidos, tickets Kerberos e credenciais de serviço são encriptados em repouso com AES-256-GCM.
  • Fluxos de Desmontagem Limpos: Eliminação de campanha com um clique que limpa de forma segura todas as linhas de base de dados associadas, vértices de grafo e artefactos temporários.

4. ⚡ Orquestração Modular de Adversários (60+ Módulos)

Catálogo extensivo de técnicas de adversário weaponizadas, alinhadas com a matriz empresarial MITRE ATT&CK.

• O Problema Resolvido: Substitui scripts GitHub não validados e pouco fiáveis por módulos de adversário tipados, reproduzíveis e auditáveis.
• Capacidades Principais:
  • Cobertura Abrangente de Vetores: 60+ técnicas modulares cobrindo Active Directory (ad.kerberoast, ad.adcs, ad.enum_users), Windows (windows.uac_bypass), Linux, Cloud (AWS, Azure, GCP) e infraestrutura de Rede.
  • Painel de Execução Simplificado: Vista de execução limpa com etiquetas de campo persistentes, dicas de dependências de baixo peso relegadas e validação focada no envio, substituindo cartões de aviso predefinidos intrusivos.
  • Esquemas Tipados Dinâmicos: Os formulários da UI são gerados dinamicamente a partir de modelos Python Pydantic com validação estrita.
  • Motor de Segurança Dry-Run: Valide a capacidade de resposta do alvo, parâmetros e resultado esperado antes de transmitir tráfego ofensivo.
  • Execução Condicionada por Função: Permissões de Operador e Team Lead necessárias para execução; módulos sensíveis de alto ruído requerem confirmação explícita.

5. 🕸️ Grafo de Ataque Multi-Vetor & Replay de Objetivos

Solucionador interativo de grafo acíclico dirigido (DAG) que visualiza caminhos de ataque empresariais e cadeias de escalada de privilégios.

• O Problema Resolvido: Traduz dados brutos de vulnerabilidades em caminhos de compromisso visuais e acionáveis que executivos e engenheiros podem compreender imediatamente.
• Capacidades Principais:
  • Encaminhamento Automatizado de Cabos de Ligação Cibernéticos: Renderização em tempo real de cabos brancos luminosos automatizados (#ffffff) que ligam Domain Controllers, descobertas de segurança e hosts descobertos sem arrastamento manual.
  • Hierarquia Determinística da Esquerda para a Direita: Layout de colunas limpo e sem colisões, originado no Domain Controller (DC01) à esquerda, passando por descobertas de segurança ativas, até aos hosts membros alvo.
  • Algoritmos de Caminho Mais Curto: Calcula deterministicamente o menor número de saltos necessários para comprometer Domain Controllers ou credenciais root de cloud.
  • Ingestão Nativa BloodHound / SharpHound: Importe diretamente arquivos JSON do BloodHound para o motor de grafo ARES para análise unificada.
  • Inspeção Interativa de Entidades: Explore relações entre utilizadores, grupos, computadores, ACLs e sessões Kerberos ativas com navegação fluida e inspetor de detalhes seguro em tempo real.
  • Replay de Objetivos: Re-simule cadeias de ataque históricas para verificar a eficácia de patches defensivos.

6. 📑 Motor de Relatórios Automatizados & Biblioteca de Evidências

Geração instantânea de entregáveis produzindo relatórios de conformidade com marca e prontos para auditoria em múltiplos formatos empresariais (PDF Executivo, Markdown Técnico, CSV de Defeitos).

• O Problema Resolvido: Elimina as 40+ horas tipicamente gastas a escrever, formatar e redigir manualmente relatórios de pentest.
• Capacidades Principais:
  • Grelha de Geração Estruturada: Layout alinhado de múltiplas colunas com elementos <label> persistentes (Target Campaign, Export Format) e feedback de erro de validação inline limpo.
  • Exportação Multi-Formato: Geração com um clique de entregáveis PDF, HTML, Markdown e JSON.
  • Motor de PDF Headless Automatizado: Fallback integrado usando o modo headless do Microsoft Edge / Chromium para exportação limpa de PDF sem dependências GTK complexas no Windows.
  • Redação Automatizada de Evidências: Redige automaticamente palavras-passe brutas sensíveis e chaves privadas nos entregáveis ao cliente, mantendo provas de auditoria.
  • Biblioteca de Relatórios Sincronizada: Repositório de artefactos autenticado com downloads instantâneos, eliminação por relatório e sincronização de estado da UI em tempo real.

7. 🧠 Estratégia Autónoma & Planeador de IA

Motor autónomo orientado a objetivos que planeia, prioriza e executa cadeias de ataque complexas respeitando os limites de OPSEC.

• O Problema Resolvido: Coordena cadeias de ataque multi-módulo de forma autónoma sem exigir intervenção manual constante do operador.
• Capacidades Principais:
  • Verificação Dinâmica do Motor: Healthchecks assíncronos em tempo real contra daemons Ollama locais (GET /api/tags) com timeouts sub-segundo e cache TTL, emparelhados com verificação dinâmica de chaves cloud do lado do servidor (Claude, OpenAI).
  • Design Limpo Centrado no Operador: Etiquetas de campo persistentes (Target Campaign, Strategic Objective, AI Planning Engine, Explicit Authorizations), descrições de objetivos legíveis por humanos e eliminação completa de fuga de variáveis de ambiente do servidor em etiquetas da UI.
  • Validação Focada no Envio: Caixas de aviso removidas da renderização predefinida da página; erros de validação são apresentados inline sob os campos alvo apenas após tentativa de execução.
  • Governador de Contenção Adaptativo: Avalia continuamente telemetria defensiva e limiares de ruído, abrandando ou abortando automaticamente ações agressivas quando o risco de deteção atinge o pico.

8. 🔍 Análise Profunda de Entidades do Grafo de Ataque & Inspetor de Nós

Telemetria aprofundada de entidades do Active Directory, inspeção de relações e auditoria segura de detalhes em tempo real diretamente dentro do canvas.

• O Problema Resolvido: Elimina a alternância de contexto entre visualizadores de grafo e ferramentas de reconhecimento CLI, proporcionando telemetria de nós ao vivo numa barra lateral interativa.
• Capacidades Principais:
  • Inspeção de Atributos de Entidades: Examine instantaneamente endereço IP, hostname, telemetria de SO, níveis de compromisso e flags de domain controller (is_dc) ao selecionar qualquer nó do grafo.
  • Mapeamento de Portas da Superfície de Ataque: Visibilidade em tempo real de portas de infraestrutura abertas (DNS 53, Kerberos 88, RPC 135, NetBIOS 139, LDAP 389, SMB 445, LDAPS 636, Global Catalog 3268, RDP 3389).
  • Auditoria Segura de Detalhes: Gaveta deslizante auditada que fornece telemetria granular sem sobrecarregar o canvas principal do DAG, com dispensa rápida.

9. 🔗 Cadeias de Execução Multi-Estágio de Adversários

Kill chains determinísticas de múltiplos passos que orquestram reconhecimento, recolha de credenciais e movimento lateral em sequência.

• O Problema Resolvido: Substitui a invocação manual passo-a-passo de ferramentas por cadeias de ataque coordenadas e pré-verificadas que passam automaticamente os resultados aos módulos seguintes.
• Capacidades Principais:
  • Sequências de Ataque Pré-Construídas: Cadeias prontas a usar para exposição Kerberos (asreproast -> kerberoast -> hashcat), enumeração de domínio e escalada de privilégios em cloud.
  • Passagem Dinâmica de Contexto: Credenciais e hashes recolhidos no passo 1 são automaticamente preenchidos nos argumentos alvo dos passos subsequentes.
  • Orçamentação OPSEC Integrada: Rastreia ruído cumulativo e probabilidade de deteção ao longo de toda a cadeia antes de iniciar a execução.

10. 🛡️ Base de Conhecimento de Evasão & Bypass de EDR / OPSEC

Rastreamento empírico da eficácia de evasão em plataformas empresariais de deteção e resposta de endpoint (EDR).

• O Problema Resolvido: Impede que operadores ofensivos implementem cegamente payloads queimados ou detetados contra infraestrutura de clientes monitorizada.
• Capacidades Principais:
  • Taxas de Sucesso Empíricas: Taxas de sucesso históricas categorizadas por técnicas de evasão específicas (patching AMSI, unhooking de syscalls, process hollowing) e fornecedor de EDR.
  • Memória de Evasão entre Sessões: Os resultados dos envolvimentos atualizam uma base de conhecimento unificada, alertando os operadores antes de executarem técnicas com baixas probabilidades de sucesso.
  • Controlos de Jitter Defensivos: Distribuições de atraso granulares e espaçamento de pacotes para evadir heurísticas comportamentais e regras de correlação SIEM.

11. 🔐 Governança de Segurança Zero-Trust & Trilha de Auditoria

Controlo de acesso multi-função auditado, ciclo de vida criptográfico de chaves API e verificação contínua de integridade da plataforma.

• O Problema Resolvido: Garante não-repúdio, separação de fronteiras baseada em funções e garantia de conformidade para operações de segurança ofensiva.
• Capacidades Principais:
  • Controlo de Acesso Baseado em Funções (RBAC): Níveis de permissão estritamente aplicados (Team Lead, Operator, Recon, Reporter) que regem a execução de módulos e a visualização de evidências.
  • Chaves API com Âmbito: Tokens bearer gerados criptograficamente com expiração configurável e permissões granulares para integração CI/CD.
  • Trilha de Auditoria ao Vivo: Registo contínuo apenas de adição de cada ação do operador, varredura de alvo e recolha de credenciais para revisão pós-envolvimento.

12. 📡 Operações ao Vivo & Fluxo de Eventos em Tempo Real

Barramento de eventos WebSocket de alta frequência que transmite telemetria operacional, saída de módulos e estado do pipeline.

• O Problema Resolvido: Proporciona aos comandantes de envolvimento consciência situacional instantânea e unificada de todos os agentes distribuídos e tarefas em segundo plano.
• Capacidades Principais:
  • Entrega de Eventos Sub-Segundo: Barramento WebSocket assíncrono que transmite stdout/stderr ao vivo, eventos de conclusão de módulos e alertas defensivos.
  • Telemetria de Logs em Buffer: Buffering de eventos resiliente a reconexões, garantindo zero linhas de log perdidas durante flutuações de rede.
  • Colaboração Multi-Operador: Operadores simultâneos veem eventos de execução de campanha partilhados em tempo real.

13. 📋 Playbooks Empresariais & Modelos de Campanha

Arquiteturas de envolvimento padronizadas para exercícios recorrentes de red team, auditorias de conformidade e drills de purple team.

• O Problema Resolvido: Elimina a configuração manual de âmbito para avaliações padronizadas e garante metodologia de teste consistente em envolvimentos empresariais.
• Capacidades Principais:
  • Playbooks Turnkey: Modelos de campanha prontos a implementar com perfis de alvo pré-configurados, conjuntos de módulos e requisitos de relatório.
  • Criação de Modelos Personalizados: Exporte envolvimentos personalizados bem-sucedidos como modelos reutilizáveis para equipas internas e clientes MSSP.
  • Pré-Verificações de Segurança: Validação automatizada de âmbito e permissões antes de qualquer campanha baseada em modelo entrar em produção.

14. 🔌 OpenAPI 3.1 Interativo & Integração para Programadores

Superfície REST API interativa e totalmente documentada para ferramentas personalizadas, orquestração SOC e integração em pipelines CI/CD.

• O Problema Resolvido: Permite integração programática perfeita com plataformas SOAR empresariais existentes, pipelines de relatórios personalizados e portões de segurança CI/CD.
• Capacidades Principais:
  • 70+ Endpoints Documentados: Cobertura REST completa em autenticação, campanhas, execução de módulos, grafos de ataque e entregáveis.
  • Conformidade OpenAPI 3.1: Esquemas de pedido/resposta estritamente validados, gerados diretamente a partir de modelos Python Pydantic.
  • Sandbox Interativo: Testes de API no navegador com autenticação por Bearer token e suporte a token CSRF.

🎛️ Desdobramento das Superfícies de Controlo| Superfície | Responsabilidade Principal | Sub-Abas Disponíveis | Operadores Principais |

| :--- | :--- | :--- | :--- | | Visão Geral | Saúde executiva, contadores de telemetria, métricas de severidade de achados. | Painel Único | Todos os Stakeholders | | Campanhas | Whitelisting de escopo, perfis de ruído, cofre de credenciais criptografado. | List, Scope, Findings | Líder de Equipe, Operador | | Módulos | Catálogo com mais de 60 módulos, formulários de entrada de parâmetros, console de execução. | Catalog, Run Panel, Results | Operador | | Relatórios | Construtor de entregáveis, pacotes de evidências, ciclo de vida da Biblioteca de Relatórios. | Generate, Library | Operador, Relator | | Grafo | Exploração de entidades DAG, caminhos de ataque mais curtos, ingestão do BloodHound. | Entities, Attack Paths, Ingest | Operador, Recon | | Modelos | Playbooks de engajamento repetíveis e planos de fluxo de trabalho multi-estágio. | Templates, Plan Builder | Líder de Equipe, Operador | | Estratégia | Motor autônomo orientado a objetivos, integração com planejador de IA. | Objective, Active, Result | Líder de Equipe, Operador | | Segurança | Credenciais de operadores, ciclo de vida de chaves de API, verificações de auditoria de dependências. | Account, API Keys, Audit | Líder de Equipe | | EDR/OPSEC | Telemetria defensiva, rastreamento de bypass, regras de evasão de detecção. | Knowledge Base, Report Outcome | Operador | | Ao Vivo | Fluxos de eventos WebSocket em tempo real e logs de telemetria em buffer. | Stream, Buffer | Operador |

🏗️ Arquitetura do Sistema e Pipeline de Dados

O ARES segue uma arquitetura estrita de defesa em profundidade, separando apresentação, orquestração de execução, governança de segurança e armazenamento criptográfico persistente:```mermaid flowchart TB subgraph Client["Presentation Layer (Operator Enclave)"] UI["React 19 Dashboard
(Vite + TypeScript)"] Mesh["Dynamic Architectural Grid
(Canvas 2D Engine)"] WSClient["WebSocket Client
(Real-Time Telemetry Stream)"] end

• Suítes de Laboratório Active Directory: Descoberta completa de SPN, Kerberoasting (ad.kerberoast), AS-REP Roasting, abuso de Modelos de Certificado ADCS (ESC1 a ESC8), replicação de conta DCSync e geração de dados BloodHound.
• Verificadores de Postura de Endpoint: Métodos de Bypass do UAC do Windows, inspeção de persistência em chaves de registro, breakouts de contêineres Linux e enumeração de privilégios Sudo.
• Plano de Controle em Nuvem: Auditoria de identidade multicloud em AWS IAM, atribuições de função do Azure Active Directory / Entra ID e vinculações do GCP IAM.

🚀 Início Rápido: Pronto para Uso em 60 Segundos

Pré-requisitos

• Python: 3.11 ou 3.12 (Python 3.12 recomendado para Windows).
• Node.js: v18+ (testado no Node v20 LTS).
• SO: Windows 11/10 (PowerShell), Linux (Ubuntu/Debian/Kali) ou macOS.

Caminho Rápido (PowerShell no Windows)```powershell

1. Clone the repository

git clone https://github.com/Mafifrizi/ARES.git Set-Location .\ARES

2. Setup isolated Python virtual environment

py -3.12 -m venv .venv ..venv\Scripts\python.exe -m pip install -U pip ..venv\Scripts\python.exe -m pip install -e ".[dev,pdf]"

3. Install frontend dependencies

Set-Location frontend & "C:\Program Files\nodejs\npm.cmd" ci Set-Location ..

4. Configure local Edge PDF rendering engine & verify doctor status

$env:ARES_PDF_BROWSER = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" ..venv\Scripts\ares.exe doctor --pdf-smoke

5. Launch development server (Frontend + Backend proxy)

..venv\Scripts\ares.exe dashboard dev --no-reload

2. Configuração do Cliente de IA com 1 Clique (Sem Edição Manual de JSON): Configure automaticamente sua IDE preferida com um único comando: ```powershell

   For Cursor IDE:

   .\mcp.bat setup --client cursor

   For Claude Desktop:

   .\mcp.bat setup --client claude

   For Windsurf:

   .\mcp.bat setup --client windsurf

   For VS Code (Cline):

   .\mcp.bat setup --client cline

   root@kitploit:~

Isso grava o caminho do seu ambiente virtual Python ativo diretamente no arquivo de configuração do cliente (por exemplo, .cursor/mcp.json).

3. Recarregar a Janela no Cursor IDE:

   • No Cursor, pressione Ctrl + Shift + P.
   • Selecione Developer: Reload Window.
   • Abra Settings (Ctrl + ,) → Features → MCP Servers. O servidor ares mostrará um ponto verde (Connected).

4. Iniciar o Monitor ao Vivo de Dois Painéis (Janela Complementar Opcional): Em uma janela de terminal dedicada, execute o monitor de dois painéis no estilo OpenClaw para acompanhar em tempo real as invocações de ferramentas de IA, verificações de escopo e aprovação de tokens: ```powershell .\mcp.bat monitor

   root@kitploit:~

• Painel Esquerdo: Fluxo em tempo real das chamadas de ferramentas executadas pelo agente de IA (ares_scope_check, ares_dry_run_module, ares_run_tool).
  • Painel Direito: Limites CIDR do ScopeGuard, diffs de ações preparadas e o Gateway de Autorização.
  • Controles: Pressione A para aprovar um token de execução pendente, R para rejeitar, C para limpar o fluxo, Q para sair.

5. Emita Seu Primeiro Comando ao Agente de IA: Abra o Cursor Composer / Chat (Ctrl + I ou Ctrl + L) e tente este prompt:

   "Verifique o status da campanha ativa, valide o escopo para o alvo 10.0.1.50 e prepare uma execução simulada do módulo ad_kerberoast."

Para arquitetura aprofundada, as 7 invariantes de segurança, scriptabilidade via CLI (--json), códigos de saída POSIX e esquemas de ferramentas operacionais, consulte ARES MCP Gateway & Product-Grade CLI Specification.

🛠️ SDK de Desenvolvedor Extensível (Arquitetura Autônoma de Próxima Geração)

O ARES fornece um SDK Python de primeira classe e com tipagem segura (ares.sdk) para construir módulos adversários personalizados, simular técnicas em ambientes de teste isolados e automatizar engajamentos programaticamente:

1. Criação de Módulos com Tipagem Segura (BaseModule[P, R] Genérico & @ares_module)

Declare esquemas de parâmetros validados com Pydantic v2 e escreva módulos com autocompletar completo da IDE:```python from ares.sdk import ( BaseModule, ExecutionContext, ModuleResult, ModuleParams, param, SecretParam, OpsecLevel, Severity, ares_module, )

class KerberoastParams(ModuleParams): dc: str = param("Target Domain Controller IP or FQDN", min_length=3) domain: str = param("AD DNS domain name, e.g. CORP.LOCAL", min_length=3) password: SecretParam = param("Domain user password", secret=True, required=False)

class CustomKerberoastModule(BaseModule[KerberoastParams, ModuleResult]): MODULE_ID = "custom.ad.kerberoast" MODULE_NAME = "Custom Kerberoasting" MODULE_CATEGORY = "ad" OPSEC_LEVEL = OpsecLevel.LOW MITRE_TECHNIQUES = ["T1558.003"] PARAMS_MODEL = KerberoastParams

3. Automação Programática (AresClient)

Automatize engajamentos, despache módulos e transmita telemetria WebSocket em tempo real via scripts Python ou pipelines CI/CD:```python from ares.sdk import AresClient

async with AresClient(base_url="http://127.0.0.1:8000", api_key="ares_key_...") as ares: campaign = await ares.campaigns.create(name="Op-Titan", scope=["10.0.0.0/24"]) job = await ares.modules.run("ad.kerberoast", target="dc01.corp.local", campaign_id=campaign["id"]) findings = await ares.campaigns.findings(campaign["id"])