diff --git a/plugins/redteam/CAMPAIGN.md b/plugins/redteam/CAMPAIGN.md new file mode 100644 index 0000000..8ffabfe --- /dev/null +++ b/plugins/redteam/CAMPAIGN.md @@ -0,0 +1,37 @@ +# red team 캠페인 절차 — 체계적으로 빈틈을 반복해서 판다 + +한 번의 즉흥 공격이 아니라, **빈칸 없는 기준표**를 두 회차 연속 새 발견 0까지 반복한다. 소유자가 "체계적으로 파고들었나"를 물을 때 이 표가 답이다. + +```text +범위 확인 ─> 1 공격 표면 목록 ─> 2 기준표(ASVS L2 × API Top 10 × 진입점) ─> 3 공격(정적·수동·동적) ─> 4 발견→근본원인→전 코드 같은 모양→막는 시험 ─> 5 재실행(2회 연속 0까지) +``` + +## 1. 공격 표면 목록 (capability 전부 켠 조합) +모든 진입점을 표로. 한 칸도 빼지 않는다: +- HTTP endpoint(경로·메서드·인증), WebSocket/STOMP(destination·handshake·origin), GraphQL(query/mutation/subscription·introspection), gRPC(service·method·bind·reflection), 메시지 consumer(topic·역직렬화), 관리/actuator(endpoint·port·bind·auth), 파일 업로드/다운로드, 설정·환경 변수(SSOT registry), 스케줄러/콜백/웹훅. +- 프론트: 라우트(auth-gated?)·API client(endpoint·auth)·저장소(key·분류)·service worker·web worker·postMessage/BroadcastChannel(origin 검증?)·인증/세션·설정(VITE_·runtime)·동적 HTML sink·업로드. +- 서브에이전트(Explore)로 템플릿마다 하나씩, 취약점 분석이 아니라 **열거**만. 결과는 공유 노트. + +## 2. 기준표 (빈칸 0이 끝) +행렬: **OWASP API Security Top 10(2023)** + **OWASP Top 10(2021)** + **ASVS L2 핵심 장(V1~V14)** × 1의 진입점 그룹. +칸마다: **시험함(방법) / 근거 / 결과**. 방법은 코드추적(C)·정적도구(S)·동적(D)·아키텍처시험(A). 결과는 PASS·FINDING·N/A·동적대기. +- 빈칸이 있으면 아직 안 끝난 것이다. 동적이 필요한 칸은 "동적 대기"로 두고 3에서 채운다. + +## 3. 공격 (세 축 모두) +- 정적: `redteam-scan.sh sast|secrets|deps|config`(semgrep·gitleaks·trivy·checkov·hadolint). 도달 가능·신뢰하지 않는 입력만 발견으로(오탐 거르기). +- 수동: 역할 서브에이전트(authz·input·config·frontend)로 inbound→sink 추적. "checked, not a finding"까지 적어 커버리지를 남긴다. +- 동적: 대상을 띄우고(`bootRunH2`나 전 capability compose) `redteam-scan.sh dast-baseline|dast-api|nuclei` + schemathesis(/v3/api-docs 등 OpenAPI 표면) + **역할별 인가 행렬**(권한 없는 역할·타 tenant 토큰으로 전 endpoint 호출 — keycloak로 다중 역할 토큰 발급). +- 범위: 내가 띄운 인스턴스·의존 컨테이너만. DoS 없음. + +## 4. 발견 처리 (한 건도 겉만 고치지 않는다) +`finding.py` 형식(심각도·재현·영향·고치는 법). 발견마다: +1. **근본 원인**을 적는다. +2. **전 코드에서 같은 모양**을 찾는다(한 곳의 버그는 보통 한 부류다). +3. **막는 시험**: 재현(RED) → 고침 → 통과(GREEN). 재분류(오탐·by-design)면 근거를 적고 의도를 시험/주석으로 고정한다. +4. 보고서는 각 템플릿 `docs/reviews/<날짜>-redteam-*.md`에. + +## 5. 재실행 — 두 회차 연속 0 +회차마다 **무엇을 새로 봤는지** 적는다(새 capability·새 벡터·수정 뒤 재공격). red team 장치를 다시 돌려 고친 발견이 다시 안 나옴을 보이고, **두 회차 연속 새 발견이 0일 때** 끝. + +## AI 침투시험 에이전트 (조사 결과, 2026-11) +Strix(Apache-2.0)·PentAGI(MIT)·CAI·PentestGPT·hackingBuddyGPT는 대부분 **LLM이 같은 하위 도구(ZAP·nuclei·sqlmap 등)를 오케스트레이션**하는 구조다. 이 플러그인이 같은 패턴을 **범위 제한·감사 가능·재현 가능**하게 구현한다. 제3자 자율 에이전트를 대상에 자동 투입하는 것은 (a) 범위 이탈·DoS 위험, (b) 외부 에이전트에 넓은 도구 권한을 주는 신뢰/공급망 위험, (c) 프롬프트 인젝션, (d) 비용 때문에 **기본으로 하지 않는다**. 차용한 방법: 모든 발견을 PoC/동적으로 재검증, 두 회차 0까지 반복. 격리 랩에서 외부 시각으로 1회 돌리는 것은 소유자 별도 승인 사항. diff --git a/plugins/redteam/skills/redteam/SKILL.md b/plugins/redteam/skills/redteam/SKILL.md index 40b7acb..07e56b9 100644 --- a/plugins/redteam/skills/redteam/SKILL.md +++ b/plugins/redteam/skills/redteam/SKILL.md @@ -72,3 +72,6 @@ python3 "${CLAUDE_PLUGIN_ROOT}/scripts/finding.py" summary findings.jsonl # o ## 라이선스 주의 - 공개 repo에는 제한 라이선스 룰셋(semgrep 룰)·CVE 데이터를 vendoring하지 않는다. 도구는 런타임에 받고 룰도 그때 받는다. - claude-code-security-review·trailofbits 스킬은 **신뢰 코드에만**(프롬프트 인젝션 미하드닝). 외부 자동 fetch를 켜지 않는다. + +## 체계적 반복 캠페인 +한 번의 공격이 아니라 빈칸 없는 기준표를 두 회차 연속 새 발견 0까지 반복하려면 `CAMPAIGN.md`를 따른다: 공격 표면 목록 → ASVS L2 × API Top 10 × 진입점 행렬 → 정적·수동·동적 → 발견마다 근본 원인·전 코드 같은 모양·막는 시험 → 재실행.