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

⚡ Resumen Ejecutivo

Las pruebas de penetración tradicionales son fundamentalmente defectuosas: son costosas, episódicas, puntuales en el tiempo y dejan a las organizaciones ciegas ante configuraciones erróneas recién introducidas y tácticas de adversarios emergentes. Mientras tanto, los escáneres de vulnerabilidades automatizados abruman a los equipos de SOC con miles de CVE hipotéticos sin demostrar la explotabilidad o las rutas de ataque lateral de múltiples etapas.

ARES cierra esta brecha. Construido desde cero para la infraestructura empresarial moderna, ARES ofrece una plataforma autónoma de compromiso de equipo rojo dirigida por objetivos que modela actores de amenazas del mundo real. Al combinar firewalls de alcance a nivel de kernel, perfilado adaptativo de ruido OPSEC, un solucionador interactivo de ataques de grafo acíclico dirigido (DAG) y más de 60 técnicas armamentizadas mapeadas a MITRE ATT&CK, ARES permite a los equipos de seguridad demostrar la explotabilidad de vulnerabilidades, localizar las rutas de compromiso más cortas hacia las Joyas de la Corona de Active Directory y generar entregables listos para ejecutivos con cero tiempo de inactividad operativo.

🎯 Por Qué las Empresas Eligen 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 y Puerta de Enlace Zero-Trust

Barrera de entrada autónoma diseñada específicamente para operadores ofensivos autorizados y personal de seguridad.

• El Problema Resuelto: Elimina el acceso no autorizado de operadores, los ataques de repetición de tokens y la fuga de tokens al almacenamiento local del navegador.
• Capacidades Clave:
  • Interacción con Firma de Fuego Carmesí: Sistema de partículas de fuego en tiempo real sobre HTML5 Canvas que envuelve el botón Sign In al pasar el cursor (continuo), hacer clic (estallido) y pulsar Enter (estallido sin puntero) — partículas basadas en física con flotabilidad, turbulencia y resplandor radial usando requestAnimationFrame.
  • Mascota Ambiental ARES Cyber Dragon: Marca de agua de la mascota de marca integrada en el panel de telemetría con opacidad calibrada y retro-resplandor carmesí, armonizada con las especificaciones del entorno de cristal esmerilado.
  • Lienzo de Rejilla Arquitectónica Dinámica en vivo: Canvas HTML5 de 60 FPS acelerado por hardware con bajo consumo, con pulsos de datos viajeros en tiempo real e iluminación por proximidad del cursor.
  • Aislamiento de Tokens Solo en Memoria: Los JWT de corta duración residen estrictamente en memoria; las credenciales de refresco usan cookies host-only, HttpOnly con rotación de un solo uso.
  • SSO Multi-Tenant Empresarial (SAML 2.0 y OIDC): Autenticación federada iniciada por SP con Okta, Azure AD y Google Workspace. Incluye cifrado de credenciales Fernet a nivel de aplicación, protección contra repetición de un solo uso (InResponseTo/nonce), mapeo de roles JIT y bloqueo estricto de contraseña local para identidades federadas. (Ver Guía de Configuración de SSO).
  • Protección CSRF de Doble Envío HMAC: Verificación en tiempo constante en todas las solicitudes que mutan estado (X-ARES-CSRF).
  • Escudo Criptográfico contra Fuerza Bruta: Aplica retroceso exponencial y limitación de tasa basada en IP en los intentos de autenticación.

2. 📊 Centro de Mando Ejecutivo y Telemetría

Consola de mando operativa en tiempo real que proporciona visibilidad instantánea de la postura a través de campañas activas.

• El Problema Resuelto: Agrega métricas ofensivas dispersas en un único panel operativo en tiempo real sin requerir consultas manuales de estado.
• Capacidades Clave:
  • Sistema de Diseño Operativo: Diseñado con jerarquía visual de alta densidad (inspirado en Grafana, Linear y Sentry) — con paneles contextuales de acento izquierdo sutiles (panel-subtle), indicadores de salud reactivos dinámicos en la barra superior y pistas de progreso discontinuas distintivas para líneas base de métricas no inicializadas.
  • Perspectivas de Compromiso Accionables: Reemplaza recuentos brutos redundantes con perspectivas contextuales de postura de seguridad:
    • Postura de Compromiso: Delineación clara de estado (Staged, Executing o Standby) que distingue objetivos en alcance de campañas en ejecución.
    • Salud de Ejecución: Monitor en tiempo real de anomalías del pipeline, fallos de ejecución de módulos y estabilidad del enclave.
    • Superficie de Ataque: Seguimiento en vivo de hosts descubiertos, pivotes de credenciales y profundidad de penetración de red.
  • Ingesta de Telemetría y Pipeline: Rendimiento del pool de workers en tiempo real, duración de tareas P95 e indicadores de ingesta de eventos en vivo.
  • Hero Táctico de Instalación Limpia: Respaldo automático de estado vacío con CTA de inicialización centrado y franja de preparación mínima al iniciar con cero campañas.

3. 🎯 Gestión de Campañas con Alcance y Límites de Objetivos

Gobernanza de objetivos con cero daños colaterales que aplica límites estrictos de lista blanca CIDR y aislamiento cifrado de evidencias.

• El Problema Resuelto: Previene escaneos catastróficos fuera de alcance y elimina archivos de credenciales sin cifrar en los portátiles de los operadores.
• Capacidades Clave:
  • Guía Persistente para el Operador: Definiciones persistentes de <label> en todos los selectores de campaña y entradas de parámetros, previniendo ambigüedad del operador durante compromisos rápidos.
  • Listas Blancas CIDR Estrictas: Aplicación de límites a nivel de red. El motor intercepta y descarta cualquier solicitud dirigida a direcciones IP o subredes no aprobadas.
  • Perfiles de Ruido y Jitter: Configure niveles de limitación de compromiso (Stealth, Normal, Aggressive) con distribuciones de retardo aleatorizadas.
  • Bóveda de Enclave Cifrada AES-256: Los hashes NTLM recolectados, tickets Kerberos y credenciales de servicio se cifran en reposo con AES-256-GCM.
  • Flujos de Desmantelamiento Limpio: Eliminación de campaña con un solo clic que limpia de forma segura todas las filas de base de datos asociadas, vértices de grafo y artefactos temporales.

4. ⚡ Orquestación Modular de Adversarios (60+ Módulos)

Catálogo extenso de técnicas de adversario weaponizadas alineadas con la matriz empresarial MITRE ATT&CK.

• El Problema Resuelto: Reemplaza scripts de GitHub no validados y poco fiables con módulos de adversario tipados, reproducibles y auditables.
• Capacidades Clave:
  • Cobertura Integral de Vectores: Más de 60 técnicas modulares que cubren Active Directory (ad.kerberoast, ad.adcs, ad.enum_users), Windows (windows.uac_bypass), Linux, Cloud (AWS, Azure, GCP) e infraestructura de Red.
  • Panel de Ejecución Simplificado: Vista de ejecución limpia con etiquetas de campo persistentes, sugerencias de dependencias de bajo peso relegadas y validación enfocada al enviar que reemplaza las tarjetas de advertencia predeterminadas intrusivas.
  • Esquemas Tipados Dinámicos: Los formularios de UI se generan dinámicamente a partir de modelos Python Pydantic con validación estricta.
  • Motor de Seguridad Dry-Run: Valide la capacidad de respuesta del objetivo, los parámetros y el resultado esperado antes de transmitir tráfico ofensivo.
  • Ejecución Restringida por Rol: Se requieren permisos de Operador y Team Lead para la ejecución; los módulos sensibles de alto ruido requieren confirmación explícita.

5. 🕸️ Grafo de Ataque Multi-Vector y Repetición de Objetivos

Solucionador interactivo de grafo acíclico dirigido (DAG) que visualiza rutas de ataque empresariales y cadenas de escalada de privilegios.

• El Problema Resuelto: Traduce datos brutos de vulnerabilidades en rutas de compromiso visuales y accionables que ejecutivos e ingenieros pueden entender de inmediato.
• Capacidades Clave:
  • Enrutamiento Automatizado de Cables de Conexión Ciber: Renderizado en tiempo real de cables blancos luminosos automatizados (#ffffff) que conectan Controladores de Dominio, hallazgos de seguridad y hosts descubiertos sin arrastre manual.
  • Jerarquía Determinista de Izquierda a Derecha: Diseño de columnas limpio y sin colisiones que se origina en el Controlador de Dominio (DC01) a la izquierda, pasa por los hallazgos de seguridad activos y llega a los hosts miembros objetivo.
  • Algoritmos de Ruta Más Corta: Calcula de forma determinista los mínimos saltos necesarios para comprometer Controladores de Dominio o credenciales raíz de cloud.
  • Ingesta Nativa de BloodHound / SharpHound: Importe directamente archivos JSON de BloodHound en el motor de grafos ARES para un análisis unificado.
  • Inspección Interactiva de Entidades: Explore relaciones entre usuarios, grupos, equipos, ACLs y sesiones Kerberos activas con navegación fluida e inspector de detalles seguro en tiempo real.
  • Repetición de Objetivos: Re-simule cadenas de ataque históricas para verificar la eficacia de los parches defensivos.

6. 📑 Motor de Informes Automatizados y Biblioteca de Evidencias

Generación instantánea de entregables que produce informes de cumplimiento con marca y listos para auditoría en múltiples formatos empresariales (PDF Ejecutivo, Markdown Técnico, CSV de Defectos).

• El Problema Resuelto: Elimina las más de 40 horas que normalmente se dedican a escribir, formatear y censurar manualmente informes de pentest.
• Capacidades Clave:
  • Rejilla de Generación Estructurada: Diseño alineado de múltiples columnas con elementos <label> persistentes (Target Campaign, Export Format) y retroalimentación limpia de errores de validación en línea.
  • Exportación Multi-Formato: Generación con un solo clic de entregables en PDF, HTML, Markdown y JSON.
  • Motor PDF Headless Automatizado: Respaldo integrado usando el modo headless de Microsoft Edge / Chromium para una exportación PDF limpia sin dependencias complejas de GTK en Windows.
  • Censura Automatizada de Evidencias: Censura automáticamente contraseñas brutas sensibles y claves privadas en los entregables al cliente mientras conserva las pruebas de auditoría.
  • Biblioteca de Informes Sincronizada: Repositorio de artefactos autenticado con descargas instantáneas, eliminación por informe y sincronización de estado de UI en tiempo real.

7. 🧠 Estrategia Autónoma y Planificador IA

Motor autónomo dirigido por objetivos que planifica, prioriza y ejecuta cadenas de ataque complejas respetando los límites de OPSEC.

• El Problema Resuelto: Coordina cadenas de ataque multi-módulo de forma autónoma sin requerir intervención manual constante del operador.
• Capacidades Clave:
  • Verificación Dinámica del Motor: Healthchecks asíncronos en tiempo real contra daemons Ollama locales (GET /api/tags) con timeouts sub-segundo y caché TTL, emparejados con verificación dinámica de claves cloud del lado del servidor (Claude, OpenAI).
  • Diseño Limpio Centrado en el Operador: Etiquetas de campo persistentes (Target Campaign, Strategic Objective, AI Planning Engine, Explicit Authorizations), descripciones de objetivos legibles por humanos y eliminación completa de fugas de variables de entorno del servidor en las etiquetas de UI.
  • Validación Enfocada al Enviar: Cuadros de advertencia eliminados del renderizado predeterminado de la página; los errores de validación se muestran en línea debajo de los campos objetivo solo al intentar la ejecución.
  • Gobernador de Contención Adaptativa: Evalúa continuamente la telemetría defensiva y los umbrales de ruido, ralentizando o abortando automáticamente acciones agresivas cuando el riesgo de detección alcanza su punto máximo.

8. 🔍 Análisis Profundo de Entidades del Grafo de Ataque e Inspector de Nodos

Telemetría detallada de entidades de Active Directory, inspección de relaciones y auditoría segura de detalles en tiempo real directamente dentro del lienzo.

• El Problema Resuelto: Elimina el cambio de contexto entre visualizadores de grafos y herramientas de reconocimiento CLI al proporcionar telemetría de nodos en vivo en una barra lateral interactiva.
• Capacidades Clave:
  • Inspección de Atributos de Entidad: Examine instantáneamente la dirección IP, el nombre de host, la telemetría del SO, los niveles de compromiso y los indicadores de controlador de dominio (is_dc) al seleccionar cualquier nodo del grafo.
  • Mapeo de Puertos de Superficie de Ataque: Visibilidad en tiempo real de puertos de infraestructura abiertos (DNS 53, Kerberos 88, RPC 135, NetBIOS 139, LDAP 389, SMB 445, LDAPS 636, Catálogo Global 3268, RDP 3389).
  • Auditoría Segura de Detalles: Panel deslizante auditado que proporciona telemetría granular sin saturar el lienzo DAG principal, completo con cierre rápido.

9. 🔗 Cadenas de Ejecución de Adversarios Multi-Etapa

Cadenas de kill deterministas de múltiples pasos que orquestan reconocimiento, recolección de credenciales y movimiento lateral en secuencia.

• El Problema Resuelto: Reemplaza la invocación manual paso a paso de herramientas con cadenas de ataque coordinadas y pre-verificadas que pasan las salidas automáticamente a los módulos posteriores.
• Capacidades Clave:
  • Secuencias de Ataque Preconstruidas: Cadenas listas para usar para exposición Kerberos (asreproast -> kerberoast -> hashcat), enumeración de dominio y escalada de privilegios en cloud.
  • Paso Dinámico de Contexto: Las credenciales y hashes recolectados en el paso 1 se rellenan automáticamente en los argumentos objetivo para los pasos posteriores.
  • Presupuesto OPSEC Integrado: Rastrea el ruido acumulativo y la probabilidad de detección a lo largo de toda la cadena antes de iniciar la ejecución.

10. 🛡️ Base de Conocimiento de Evasión y Bypass de EDR / OPSEC

Seguimiento empírico de la eficacia de evasión en plataformas empresariales de detección y respuesta de endpoints (EDR).

• El Problema Resuelto: Evita que los operadores ofensivos desplieguen a ciegas payloads quemados o detectados contra infraestructura de clientes monitorizada.
• Capacidades Clave:
  • Tasas de Éxito Empíricas: Tasas de éxito históricas categorizadas por técnicas de evasión específicas (parcheo de AMSI, desenganche de syscalls, process hollowing) y proveedor de EDR.
  • Memoria de Evasión entre Sesiones: Los resultados de los compromisos actualizan una base de conocimiento unificada, advirtiendo a los operadores antes de que ejecuten técnicas con bajas probabilidades de éxito.
  • Controles de Jitter Defensivo: Distribuciones de retardo granulares y espaciado de paquetes para evadir heurísticas de comportamiento y reglas de correlación de SIEM.

11. 🔐 Gobernanza de Seguridad Zero-Trust y Pista de Auditoría

Control de acceso multi-rol auditado, ciclo de vida criptográfico de claves API y verificación continua de integridad de la plataforma.

• El Problema Resuelto: Garantiza el no repudio, la separación de límites basada en roles y la garantía de cumplimiento para operaciones de seguridad ofensiva.
• Capacidades Clave:
  • Control de Acceso Basado en Roles (RBAC): Niveles de permisos estrictamente aplicados (Team Lead, Operator, Recon, Reporter) que gobiernan la ejecución de módulos y la visualización de evidencias.
  • Claves API con Alcance: Tokens bearer generados criptográficamente con expiración configurable y permisos granulares para integración CI/CD.
  • Pista de Auditoría en Vivo: Registro continuo de solo anexado de cada acción del operador, escaneo de objetivos y recuperación de credenciales para revisión posterior al compromiso.

12. 📡 Operaciones en Vivo y Flujo de Eventos en Tiempo Real

Bus de eventos WebSocket de alta frecuencia que transmite telemetría operativa, salida de módulos y estado del pipeline.

• El Problema Resuelto: Proporciona a los comandantes de compromiso conciencia situacional instantánea y unificada de todos los agentes distribuidos y tareas en segundo plano.
• Capacidades Clave:
  • Entrega de Eventos Sub-Segundo: Bus WebSocket asíncrono que transmite stdout/stderr en vivo, eventos de finalización de módulos y alertas defensivas.
  • Telemetría de Logs Almacenada en Búfer: Almacenamiento en búfer de eventos resistente a reconexiones que garantiza cero líneas de log perdidas durante fluctuaciones de red.
  • Colaboración Multi-Operador: Los operadores simultáneos ven los eventos de ejecución de campaña compartidos en tiempo real.

13. 📋 Playbooks Empresariales y Plantillas de Campaña

Arquitecturas de compromiso estandarizadas para ejercicios recurrentes de red team, auditorías de cumplimiento y simulacros de purple team.

• El Problema Resuelto: Elimina la configuración manual del alcance para evaluaciones estandarizadas y garantiza una metodología de pruebas consistente en todos los compromisos empresariales.
• Capacidades Clave:
  • Playbooks Listos para Usar: Plantillas de campaña listas para desplegar con perfiles de objetivos preconfigurados, conjuntos de módulos y requisitos de informes.
  • Autoría de Plantillas Personalizadas: Exporte compromisos personalizados exitosos como plantillas reutilizables para equipos internos y clientes MSSP.
  • Pre-Vuelos de Seguridad: Validación automatizada de alcance y permisos antes de que cualquier campaña basada en plantilla entre en funcionamiento.

14. 🔌 OpenAPI 3.1 Interactivo e Integración para Desarrolladores

Superficie de API REST interactiva y completamente documentada para herramientas personalizadas, orquestación SOC e integración de pipelines CI/CD.

• El Problema Resuelto: Permite una integración programática fluida con plataformas SOAR empresariales existentes, pipelines de informes personalizados y puertas de seguridad CI/CD.
• Capacidades Clave:
  • Más de 70 Endpoints Documentados: Cobertura REST completa en autenticación, campañas, ejecución de módulos, grafos de ataque y entregables.
  • Conformidad con OpenAPI 3.1: Esquemas de solicitud/respuesta estrictamente validados generados directamente desde modelos Python Pydantic.
  • Sandbox Interactivo: Pruebas de API en el navegador con autenticación de token Bearer y soporte de token CSRF.

🎛️ Desglose de Superficies de Control| Superficie | Responsabilidad Principal | Sub-Pestañas Disponibles | Operadores Principales |

| :--- | :--- | :--- | :--- | | Overview | Estado ejecutivo, contadores de telemetría, métricas de severidad de hallazgos. | Panel Único | Todos los Interesados | | Campaigns | Lista blanca de alcance, perfiles de ruido, bóveda de credenciales cifradas. | List, Scope, Findings | Líder de Equipo, Operador | | Modules | Catálogo de más de 60 módulos, formularios de entrada de parámetros, consola de ejecución. | Catalog, Run Panel, Results | Operador | | Reports | Constructor de entregables, paquetes de evidencia, ciclo de vida de la Biblioteca de Informes. | Generate, Library | Operador, Reportero | | Graph | Exploración de entidades DAG, rutas de ataque más cortas, ingesta de BloodHound. | Entities, Attack Paths, Ingest | Operador, Recon | | Templates | Playbooks de compromiso repetibles y planes de flujo de trabajo multietapa. | Templates, Plan Builder | Líder de Equipo, Operador | | Strategy | Motor autónomo dirigido por objetivos, integración de planificador de IA. | Objective, Active, Result | Líder de Equipo, Operador | | Security | Credenciales de operador, ciclo de vida de claves API, verificaciones de auditoría de dependencias. | Account, API Keys, Audit | Líder de Equipo | | EDR/OPSEC | Telemetría defensiva, seguimiento de evasión, reglas de evasión de detección. | Knowledge Base, Report Outcome | Operador | | Live | Flujos de eventos WebSocket en tiempo real y registros de telemetría almacenados en búfer. | Stream, Buffer | Operador |

🏗️ Arquitectura del Sistema y Canalización de Datos

ARES sigue una estricta arquitectura de defensa en profundidad que separa la presentación, la orquestación de ejecución, la gobernanza de seguridad y el almacenamiento 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

• Active Directory Lab Suites: Descubrimiento completo de SPN, Kerberoasting (ad.kerberoast), AS-REP Roasting, abuso de plantillas de certificados ADCS (ESC1 a ESC8), replicación de cuentas DCSync y generación de datos de BloodHound.
• Endpoint Posture Checkers: Métodos de bypass de UAC en Windows, inspección de persistencia en claves de registro, escapes de contenedores Linux y enumeración de privilegios Sudo.
• Cloud Control Plane: Auditoría de identidades multicloud en AWS IAM, asignaciones de roles de Azure Active Directory / Entra ID y enlaces de GCP IAM.

🚀 Quickstart: En marcha en 60 segundos

Requisitos previos

• Python: 3.11 o 3.12 (se recomienda Python 3.12 para Windows).
• Node.js: v18+ (probado en Node v20 LTS).
• SO: Windows 11/10 (PowerShell), Linux (Ubuntu/Debian/Kali) o macOS.

Ruta rápida (PowerShell en 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. Configuración del cliente de IA con 1 clic (sin edición manual de JSON): Configura automáticamente tu IDE preferido con un solo 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:~

Esto escribe la ruta de tu entorno virtual de Python activo directamente en el archivo de configuración del cliente (p. ej., .cursor/mcp.json).

3. Recargar la ventana en Cursor IDE:

   • En Cursor, pulsa Ctrl + Shift + P.
   • Selecciona Developer: Reload Window.
   • Abre Settings (Ctrl + ,) → Features → MCP Servers. El servidor ares mostrará un punto verde (Connected).

4. Iniciar el monitor en vivo de dos paneles (ventana complementaria opcional): En una ventana de terminal dedicada, ejecuta el monitor de dos paneles estilo OpenClaw para observar en tiempo real las invocaciones de herramientas de IA, las comprobaciones de alcance y aprobar tokens: ```powershell .\mcp.bat monitor

   root@kitploit:~

• Panel Izquierdo: Flujo en vivo de llamadas a herramientas ejecutadas por el agente de IA (ares_scope_check, ares_dry_run_module, ares_run_tool).
  • Panel Derecho: Límites CIDR de ScopeGuard, diferencias de acciones preparadas y la Puerta de Autorización.
  • Controles: Pulsa A para aprobar un token de ejecución pendiente, R para rechazar, C para limpiar el flujo, Q para salir.

5. Emite Tu Primer Comando al Agente de IA: Abre Cursor Composer / Chat (Ctrl + I o Ctrl + L), y prueba este prompt:

   "Verifica el estado de la campaña activa, valida el alcance para el objetivo 10.0.1.50, y prepara una ejecución en seco del módulo ad_kerberoast."

Para obtener información detallada sobre la arquitectura, las 7 invariantes de seguridad, la capacidad de scripting CLI (--json), los códigos de salida POSIX y los esquemas de herramientas operativas, consulta Especificación de ARES MCP Gateway y CLI de Grado Productivo.

🛠️ SDK de Desarrollador Extensible (Arquitectura Autónoma de Próxima Generación)

ARES proporciona un SDK de Python de primera clase y con tipado seguro (ares.sdk) para construir módulos de adversario personalizados, simular técnicas en entornos de prueba aislados y automatizar compromisos de forma programática:

1. Creación de Módulos con Tipado Seguro (BaseModule[P, R] Genérico y @ares_module)

Declara esquemas de parámetros validados con Pydantic v2 y escribe módulos con autocompletado completo del 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. Automatización programática (AresClient)

Automatiza compromisos, despacha módulos y transmite telemetría WebSocket en tiempo real mediante scripts de Python o pipelines de 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"])