Files
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

4.3 KiB
Raw Permalink Blame History

red team 캠페인 절차 — 체계적으로 빈틈을 반복해서 판다

한 번의 즉흥 공격이 아니라, 빈칸 없는 기준표를 두 회차 연속 새 발견 0까지 반복한다. 소유자가 "체계적으로 파고들었나"를 물을 때 이 표가 답이다.

범위 확인 ─> 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회 돌리는 것은 소유자 별도 승인 사항.