ARTEX 작동 방식:두 그래프 위에서 플래너 하나, 워커 셋, 가드가 움직입니다.

ARTEX 루프:계획, 작업, 가드, 검증, 그리고 다시 계획.

1. 01

   계획

   그래프가 바뀌면 플래너가 깨어납니다. 커버리지와 범위를 읽고 할 일 목록을 갱신한 뒤, 각각 자산 하나에 연결된 인텐트를 배정합니다.

2. 02

   작업

   워커는 기본 3개입니다. 각 워커는 인텐트 하나를 맡아 nmap, curl, Playwright 같은 실제 도구를 실행하고, 사실과 발견 사항을 기록한 뒤 종료합니다.

3. 03

   가드

   모든 도구 호출은 인터셉트 규칙, LLM 판정자, 사람 순서로 검사를 거칩니다. 모든 트래픽은 증거로 남도록 포트 8788의 기록 프록시를 통과합니다.

4. 04

   검증

   기록이 생길 때마다 플래너가 다시 깨어나며, prove_goal이 목표를 닫을 때까지 반복합니다. 리포터는 중복을 병합하고, 리테스터는 수정 여부를 확인합니다.

01플래너가 깨어나 인텐트 배정02워커 3개가 도구를 병렬 실행03규칙, 판정자, 사람 순서04prove_goal이 목표를 닫음

REC :8788규칙>판정자>사람

1. 01그래프가 바뀌면 플래너가 깨어납니다(디바운스, 약 800 ms).
2. 02플래너는 graph_overview, 커버리지, 범위를 읽습니다.
3. 03인텐트를 0개에서 N개까지 프런티어 큐에 배정합니다.
4. 04워커가 인텐트 하나를 맡아 해당 자산을 불러옵니다.
5. 05워커는 가드와 기록 프록시를 거쳐 도구를 실행합니다.
6. 06사실, 자산, 발견 사항을 두 그래프에 기록합니다.
7. 07기록이 생기면 플래너가 다시 깨어나며, prove_goal까지 반복합니다.

1. 01

   작업 생성

   설명, 대상, 선택형 템플릿, 작업별 허용 및 차단 규칙, 순서가 정해진 LLM 프로필 체인을 지정합니다. 작업은 이전 작업의 사실을 물려받을 수 있습니다.

2. 02

   자산 불러오기

   자산은 공유 자산 그래프에 들어가며, 에이전트가 입력하거나 ScopeSentry에서 가져옵니다. DNS와 HTTP 정보 보강은 백그라운드에서 실행됩니다.

3. 03

   목표로 분할

   목표 에이전트가 작업을 목표 노드로 나누고 범위를 추출합니다.

4. 04

   계획

   플래너가 깨어나 그래프 개요, 커버리지, 범위를 읽고 할 일 목록을 갱신한 뒤, 자산에 연결된 인텐트를 배정합니다. 차단된 자산은 이 단계에서 거부됩니다.

5. 05

   작업

   워커(기본 3개)는 각각 인텐트 하나를 맡아 가드와 기록 프록시를 거쳐 실제 도구를 실행합니다.

6. 06

   결과 기록

   워커는 사실, 새 자산, 선택적으로 자격 증명, 그리고 발견 사항을 기록하며, 각각 증거와 캡처된 트래픽을 함께 남깁니다.

7. 07

   반복

   기록이 생길 때마다 플래너가 다시 깨어나며, 목표가 검증되거나 예산 또는 시간이 소진될 때까지 반복합니다. 워커에는 기본 1,200초가 주어집니다.

8. 08

   보고

   리포터는 발견 사항마다 보고서를 하나씩 작성하고, 같은 결함의 중복을 취약점 폴더로 병합하며, 메신저로 알림을 보낼 수 있습니다. 리테스터는 수정 여부를 다시 확인합니다.

9. 09

   조정

   사람은 언제든 개입할 수 있습니다. 메인 에이전트와 대화하고, 힌트를 추가하고, 실행 중인 워커에 메시지를 보내거나 일시 정지하고, /btw 곁가지 질문을 할 수 있습니다.

• 엔진

  server/engine.go

  작업마다 플래너 루프 하나와 워커 루틴 N개를 돌립니다. 인텐트 할당, 타임아웃, 일시 정지와 드레인을 처리합니다.

• 목표 에이전트

  agent/goals.go

  작업을 목표로 나누고 범위를 추출합니다.

• 플래너

  agent/planner.go

  인텐트를 만드는 유일한 에이전트입니다. 깨어날 때마다 이어지는 공유 할 일 목록을 유지해, 여러 단계로 이어지는 작업이 순서대로 진행됩니다.

• 워커

  agent/worker.go

  인텐트 하나를 맡아 도구를 실행하고, 결과를 두 그래프에 기록한 뒤 종료합니다.

• 메인 에이전트

  agent/mainagent.go

  작업 안의 채팅 에이전트입니다. 사람이 대화할 수 있고, 에이전트는 인텐트와 힌트를 추가할 수 있습니다.

• 리포터와 리테스터

  agent/finding_recorder.go

  발견 사항 보고서를 작성하고, 중복을 취약점 폴더로 병합하며, 발견 사항을 재현됨, 수정됨, 미확인으로 재검사합니다.

• 가드

  guard/, intercept/

  모든 도구 호출을 인터셉트 규칙, LLM 판정자, 사람 승인 순서로 검사합니다. 감사 로그를 남깁니다.

• 트래픽 기록기

  traffic/

  자체 인증 기관(CA)을 갖춘 포트 8788의 기록 프록시입니다. 워커의 모든 HTTP 및 셸 트래픽이 증거로 저장됩니다.

• 정보 보강

  enrich/enrich.go

  새 자산의 DNS와 HTTP 정보를 백그라운드에서 조회합니다.

• LLM 풀

  llmpool/, llmrec/

  모델 프로필을 보관하고, 프로필 간 장애 조치를 수행하며, 원본 요청과 응답을 기록합니다.

• 알림

  notify/

  발견 사항을 DingTalk, Feishu, WeCom, Telegram, 이메일, 웹훅으로 실시간 또는 30분 단위 요약으로 보냅니다.

• 자체 업데이트

  selfupdate/

  GitHub Releases에서 원클릭으로 업데이트하며, 체크섬 확인, 스모크 테스트, 부팅 3회 실패 시 롤백을 지원합니다.

1. 인터셉트 규칙

   v0.3.15

   허용 및 거부 규칙과 함께, HTTP DELETE나 삭제성 경로 같은 파괴적 호출에 대한 내장 규칙이 있습니다.

2. LLM 판정자

   v0.3.11

   규칙으로 결정되지 않는 호출을 검토합니다. v0.3.23부터는 판정자가 실패하면 호출을 통과시키지 않고 사람 승인으로 넘깁니다.

3. 자산 차단 목록

   v0.3.13

   기본으로 .gov, .gov.cn, .edu, .edu.cn을 차단하며, 그 위에 작업별 허용 및 차단 목록을 둘 수 있습니다.

4. 스크립트 검토

   v0.3.18

   판정자는 각 스크립트의 스냅샷(경로, 크기, SHA-256)을 봅니다. 스냅샷이 불완전하면 사람 검토로 넘어갑니다.

5. Basic Auth

   v0.3.16

   콘솔 앞단의 선택형 HTTP Basic Auth로, RuoJi6가 추가했습니다.

6. 기록 프록시

   모든 도구 트래픽이 포트 8788의 프록시를 거치므로, 워커가 보내는 모든 요청이 증거로 남습니다.

공개 코드에는 한때 교전 규칙(RoE) 범위 검사가 있었습니다. 이 기능은 제거되었고, ThreatBook은 공개판에 내장 안전 통제가 없다고 밝혔습니다.

LLM에 노출된 도구

31

PostgreSQL 테이블

60

LLM 통신 형식

4

작업당 기본 워커 수

3

백엔드

Go 1.26, 단일 바이너리, server-sent events를 지원하는 REST API

콘솔

Next.js 16, React 19, Tailwind 4, 바이너리에 내장

에이전트 SDK

Autumn-27의 norma v0.4.3, Apache-2.0, 아직 공개 상태

주 저장소

PostgreSQL 16: 두 그래프, 작업, 발견 사항, 설정, 테이블 60개

트래픽 저장소

./data 아래의 SQLite

포트 8787

웹 콘솔, API, 실시간 스트림

포트 8788

기록 프록시, Docker Compose에서는 localhost에 바인딩

Docker 이미지

amd64 및 arm64용 ruoji6/artex. 원본 autumn27/artex는 사라졌습니다

코드 규모

v0.3.25 기준 173,504줄: Go 100,569줄, TypeScript 62,418줄

이력

커밋 458개, 첫 커밋 2026-07-26

라이선스

AGPL-3.0