GitHub - jiwoochris/artex-ko: ARTEX 한국어판 · AI 자율 침투 테스트 프레임워크 현지화 (upstream: Autumn-27/ARTEX, AGPL-3.0)
Key Points
- 1ARTEX is an autonomous penetration testing system that utilizes a multi-agent LLM framework to execute complex attack chains, ranging from reconnaissance to data exfiltration, with minimal human intervention.
- 2The architecture integrates a Go-based backend and Next.js frontend with a dual-graph structure—comprising an asset graph for global state and a task-specific exploration graph—to manage autonomous decision-making and tool execution.
- 3Specifically designed for security research and defensive testing, the project provides comprehensive guides, detection signatures, and compliance protocols to help security teams identify and mitigate threats posed by autonomous AI-driven attacks.
ARTEX is an autonomous penetration testing system powered by a multi-agent Large Language Model (LLM) architecture. It is designed to perform end-to-end security assessments—ranging from reconnaissance and vulnerability scanning to exploitation—with minimal human intervention. The system employs a Go-based backend and a Next.js frontend, utilizing the norma SDK for agentic operations and PostgreSQL for persistent storage.
Core Methodology and Technical Architecture
The system operates through an event-driven, autonomous loop that manages state across two interconnected graph structures:- Dual Graph Infrastructure:
- Asset Graph (Global): A persistent repository of assets (e.g., ). This graph maintains the "truth" regarding the attack surface, utilizing automated parent-child relationship calculations and deduplication keys.
- Exploration Graph (Session-specific): A temporal record of the penetration testing process. Nodes consist of , , , , and , linked by edges such as , , and . The two graphs are synchronized via , allowing for bidirectional traversal between tested assets and the specific investigative logic that addressed them.
- Autonomous Agent Workflow:
- Planner: Acts as the primary intent generator. By analyzing the exploration graph’s current state and coverage metrics, it determines whether new directions are required and assigns tasks to the frontier queue.
- Worker: Executes specific intents by interacting with real-world tools (e.g., Nmap, cURL, Bash). Workers generate data which is written back to the graphs, triggering a loop that re-evaluates the mission status until the goal is proven ().
- MainAgent: Facilitates human-in-the-loop interaction, allowing for manual guidance during autonomous execution.
- Advanced Logic and Context Management:
- Cross-Worker Trace Exchange: To prevent redundant efforts, workers can search traces of other agents using , enabling the reuse of observations (such as hidden parameters or error responses) that were not formally logged as facts.
- Persistent Todolist: To maintain long-term, sequential attack chains (e.g., Infiltration Lateral Movement Privilege Escalation), the planner utilizes a shared, stateful todo list. This ensures that the system does not execute future steps before prerequisites are satisfied, even in an inherently stateless LLM invocation environment.
Security and Ethical Framework
ARTEX focuses on the "defense-in-depth" perspective. The repository includes:- Defense & Detection Guides: Strategies for identifying AI-driven attacks, including SIEM/WAF integration and hardening checklists.
- Detection Indicators: Formalized Sigma rules and IoCs (Indicators of Compromise) mapped to the MITRE ATT&CK framework, provided in CSV and MISP formats to facilitate immediate integration into defensive platforms.
- Legal Compliance: The project strictly emphasizes its use for research and authorized testing within isolated environments, noting compliance requirements under South Korean legislation (e.g., the Information and Communications Network Act).