feat(redteam): 두 템플릿을 공격하는 red team 플러그인을 더한다 #2

Merged
donghyeon.kang merged 3 commits from claude/great-wu-55f9c7 into main 2026-11-11 15:15:34 +00:00
Owner

무엇을 왜

템플릿의 보안 결함은 거기서 나온 모든 서비스로 복제된다(template-program README §4 W4, 소유자 결정). 반복 가능한 red team 장치가 없어 공격을 매번 즉흥으로 했다. 승인된 보안 시험을 위한 장치를 plugins/redteam/로 더한다.

고른 방법과 버린 대안

새 플러그인 redteam(0.1.0). harness와 역할이 달라 훅은 두지 않는다 — 상시 실행은 출력이 모든 세션 컨텍스트에 들어가 오염된다. 요청할 때만 스킬·서브에이전트로 돈다(opt-in).

  • agents/ 역할 6: redteam-recon redteam-authz redteam-input redteam-deps redteam-config redteam-frontend
  • skills/redteam/ 교전 오케스트레이션: 범위 확인 → 정찰 → 역할별 공격(도구+수동) → 발견 수집 → 보고 → 고침(막는 시험) → 재실행(회귀 0)
  • scripts/redteam-scan.sh 핀 고정 도구 실행 래퍼(desktop). 모드 secrets sast deps config dast-baseline dast-api nuclei pin. scripts/tools.lock 이미지 핀
  • scripts/finding.py 발견 정규화·검사·정렬·보고(JSON Lines). 한 건은 심각도·재현 절차·영향·고치는 법을 담는다

버린 대안:

  • 룰셋·CVE 데이터 vendoring → 공개 repo 라이선스 문제. semgrep 룰은 Semgrep Rules License v1.0(내부용·재배포 금지)이다. 도구는 런타임에 받고 룰도 그때 받는다. SAST 기본은 opengrep(LGPL-2.1 포크).
  • CodeQL 기본 → 라이선스(OSS 전용 조건)로 제외. opengrep+기존 FindSecBugs로 대체.
  • 훅으로 상시 실행 → 컨텍스트 오염. opt-in으로.

위험·영향

  • tools.lock의 digest는 아직 미고정(-)이다. 첫 실행 pin 모드가 실제 digest를 뽑아 채운다(scripts/ci/trivy-scan.sh의 바이너리 SHA-256과 같은 TOFU 방식). 공격 단계에서 쓰는 도구부터 채운다.
  • 도구 실행은 desktop·docker가 있어야 한다. 그래서 시험은 형식·로직만 본다(도구 실행 아님).
  • harness 플러그인은 바꾸지 않았다(version 그대로). redteam은 새 것이라 받는 쪽 영향 없음.

검증

scripts/check.sh rc=0:

  • 플러그인 시험 redteam 18 · harness 21 · 템플릿 10 통과
  • claude plugin validate --strict: marketplace · harness · redteam 매니페스트 통과

리뷰어가 볼 곳

  • plugins/redteam/scripts/finding.py — 발견 형식·정렬·게이트 로직(시험 tests/test_redteam.py)
  • plugins/redteam/scripts/tools.lock — 도구·라이선스 선택과 핀 방식
  • plugins/redteam/skills/redteam/SKILL.md — 교전 흐름과 범위·안전 규칙

관련 문서

  • design-docs template-program/README.md §4 W4, §7
  • 공유 노트 w4-redteam.md(도구 표·착수 보고)
## 무엇을 왜 템플릿의 보안 결함은 거기서 나온 모든 서비스로 복제된다(template-program README §4 W4, 소유자 결정). 반복 가능한 red team 장치가 없어 공격을 매번 즉흥으로 했다. 승인된 보안 시험을 위한 장치를 `plugins/redteam/`로 더한다. ## 고른 방법과 버린 대안 새 플러그인 `redteam`(0.1.0). `harness`와 역할이 달라 **훅은 두지 않는다** — 상시 실행은 출력이 모든 세션 컨텍스트에 들어가 오염된다. 요청할 때만 스킬·서브에이전트로 돈다(opt-in). - `agents/` 역할 6: `redteam-recon` `redteam-authz` `redteam-input` `redteam-deps` `redteam-config` `redteam-frontend` - `skills/redteam/` 교전 오케스트레이션: 범위 확인 → 정찰 → 역할별 공격(도구+수동) → 발견 수집 → 보고 → 고침(막는 시험) → 재실행(회귀 0) - `scripts/redteam-scan.sh` 핀 고정 도구 실행 래퍼(desktop). 모드 `secrets sast deps config dast-baseline dast-api nuclei pin`. `scripts/tools.lock` 이미지 핀 - `scripts/finding.py` 발견 정규화·검사·정렬·보고(JSON Lines). 한 건은 **심각도·재현 절차·영향·고치는 법**을 담는다 버린 대안: - **룰셋·CVE 데이터 vendoring** → 공개 repo 라이선스 문제. semgrep 룰은 Semgrep Rules License v1.0(내부용·재배포 금지)이다. 도구는 런타임에 받고 룰도 그때 받는다. SAST 기본은 opengrep(LGPL-2.1 포크). - **CodeQL 기본** → 라이선스(OSS 전용 조건)로 제외. opengrep+기존 FindSecBugs로 대체. - **훅으로 상시 실행** → 컨텍스트 오염. opt-in으로. ## 위험·영향 - `tools.lock`의 digest는 아직 미고정(`-`)이다. 첫 실행 `pin` 모드가 실제 digest를 뽑아 채운다(`scripts/ci/trivy-scan.sh`의 바이너리 SHA-256과 같은 TOFU 방식). 공격 단계에서 쓰는 도구부터 채운다. - 도구 실행은 desktop·docker가 있어야 한다. 그래서 시험은 **형식·로직만** 본다(도구 실행 아님). - `harness` 플러그인은 바꾸지 않았다(version 그대로). `redteam`은 새 것이라 받는 쪽 영향 없음. ## 검증 `scripts/check.sh` rc=0: - 플러그인 시험 redteam 18 · harness 21 · 템플릿 10 통과 - `claude plugin validate --strict`: marketplace · harness · redteam 매니페스트 통과 ## 리뷰어가 볼 곳 - `plugins/redteam/scripts/finding.py` — 발견 형식·정렬·게이트 로직(시험 `tests/test_redteam.py`) - `plugins/redteam/scripts/tools.lock` — 도구·라이선스 선택과 핀 방식 - `plugins/redteam/skills/redteam/SKILL.md` — 교전 흐름과 범위·안전 규칙 ## 관련 문서 - design-docs `template-program/README.md` §4 W4, §7 - 공유 노트 `w4-redteam.md`(도구 표·착수 보고)
donghyeon.kang added 1 commit 2026-11-11 12:46:08 +00:00
템플릿의 보안 결함은 거기서 나온 모든 서비스로 복제된다. 반복 가능한 red
team 장치가 없어, 공격을 사람이 매번 즉흥으로 했다.

새 플러그인 `redteam`을 더한다. harness와 역할이 달라 훅은 두지 않고(상시 실행은
컨텍스트를 오염시킨다) 요청할 때만 스킬·서브에이전트로 돈다.
- agents/ 역할 6: recon·authz·input·deps·config·frontend
- skills/redteam/ 교전 오케스트레이션(범위→정찰→공격→수집→보고→고침→재실행)
- scripts/redteam-scan.sh 핀 고정 도구 실행 래퍼(desktop), tools.lock
- scripts/finding.py 발견 정규화·검사·정렬·보고(심각도·재현·영향·고치는 법)

버린 대안:
- 룰셋·CVE 데이터 vendoring → 공개 repo 라이선스 문제(semgrep 룰은 내부용
  제한 라이선스). 도구는 런타임에 받고 룰도 그때 받는다. SAST 기본은 opengrep.
- CodeQL 기본 → 라이선스(OSS 전용 조건)로 제외, opengrep+FindSecBugs로 대체.
- 훅으로 상시 실행 → 출력이 모든 세션 컨텍스트에 들어가 오염. 그래서 opt-in.

위험·한계: tools.lock의 digest는 아직 미고정(-)이다. 첫 실행 `pin` 모드가 실제
digest를 뽑아 채운다(trivy-scan.sh의 바이너리 SHA-256과 같은 TOFU 방식). 도구
실행은 desktop·docker가 있어야 하므로, 시험은 형식·로직만 본다(실행 아님).

검증: scripts/check.sh rc=0 — redteam 18, harness 21, 템플릿 10 시험 통과,
marketplace·harness·redteam 매니페스트 validate --strict 통과.
donghyeon.kang added 1 commit 2026-11-11 14:17:59 +00:00
실측 중 `sast` 모드가 rc=1로 비어 나왔다. tools.lock의 `opengrep/opengrep`
이미지가 Docker Hub·GHCR에 없다(pull access denied). 공식 컨테이너 이미지가
없어 핀을 걸 수 없었다.

SAST를 공식 `semgrep/semgrep` 이미지(엔진 LGPL-2.1)로 바꾼다. 룰은 레지스트리
에서 런타임에 받고 커밋하지 않으며, `--config p/default --config p/secrets
--metrics=off`로 돌린다. `--config auto`는 metrics를 켜야 작동해, 프로젝트
정보가 semgrep.dev로 나가므로 쓰지 않는다.

버린 대안:
- 비공식 opengrep 서드파티 이미지(wollomatic·codacy 등) → 공급망 위험.
- `--config auto` → 룰 자동 선택이 편하나 코드 메타데이터를 밖으로 보낸다.

위험·한계: 레지스트리 룰은 Semgrep Rules License(내부 실행 허용, 재배포 금지)
라 커밋하지 않고 런타임에만 받는다. 실제로 받아 digest를 확인한 4개
(gitleaks·semgrep·trivy·checkov)를 tools.lock에 고정했고, 아직 안 받은 것은
`-`(첫 실행 pin으로 채운다).

검증: desktop에서 semgrep 1.184.0이 Java 139파일에 룰 167개를 돌렸다(rc=0,
--metrics=off). scripts/check.sh rc=0(시험·매니페스트 그대로 통과).
donghyeon.kang added 1 commit 2026-11-11 14:57:40 +00:00
한 번의 즉흥 공격이 아니라, 빈칸 없는 기준표(ASVS L2 × API Top 10 × 진입점)를
두 회차 연속 새 발견 0까지 반복하는 절차를 적는다. 공격 표면 목록·기준표·세 축
공격(정적·수동·동적)·발견 처리(근본 원인→전 코드 같은 모양→막는 시험)·재실행과,
AI 침투 에이전트 조사 결과(자동 투입 안 함·방법 차용)를 담는다. 다음 교전이 같은
깊이로 돌게 하는 것이 목적이다. SKILL.md에서 가리킨다.
donghyeon.kang merged commit 50b8f94cef into main 2026-11-11 15:15:34 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/claude-harness#2