Files
claude-harness/plugins/redteam/CAMPAIGN.md
T
DongHyeonka b8cf1b2e91 docs(redteam): 수정 커밋 전 포맷 게이트 단계를 더한다
red team 수정 절차에 "커밋 전 바뀐 파일에 대상 repo 포맷터를 돌린다"
단계가 없었다. 그래서 백엔드 템플릿 수정 PR에서 모듈 시험만 돌리고
push했다가 runner pr / gradle의 :app-bootstrap:spotlessJavaCheck에서
깨졌다. 같은 실수가 반복되지 않게 절차에 못 박는다.

skills/redteam SKILL.md §6(고침과 재실행)과 CAMPAIGN.md §4(발견 처리)에
각각 한 줄을 더한다: 자바 템플릿은 ./gradlew spotlessApply 뒤
spotlessCheck. 스킬 지시가 바뀌므로 plugin.json version 0.1.0 → 0.1.1
(받는 쪽은 버전이 바뀌어야 갱신된다).

위험·한계: 문서·버전만 바뀐다. 훅·스크립트 동작 변화 없음.

검증: scripts/check.sh 통과(harness·redteam·template 시험, manifest validate).
2026-11-12 02:37:18 +09:00

39 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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. **커밋 전 포맷 게이트**: 바뀐 파일에 대상 repo의 포맷터를 돌린다(자바 템플릿은 `./gradlew spotlessApply` → `spotlessCheck`). 시험만 돌리고 포맷 검사를 건너뛰면 CI `pr / gradle`(spotlessCheck)에서 깨진다.
5. 보고서는 각 템플릿 `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회 돌리는 것은 소유자 별도 승인 사항.