템플릿의 보안 결함은 거기서 나온 모든 서비스로 복제된다(template-program README §4 W4, 소유자 결정). 반복 가능한 red team 장치가 없어 공격을 매번 즉흥으로 했다. 승인된 보안 시험을 위한 장치를 plugins/redteam/로 더한다.
고른 방법과 버린 대안
새 플러그인 redteam(0.1.0). harness와 역할이 달라 훅은 두지 않는다 — 상시 실행은 출력이 모든 세션 컨텍스트에 들어가 오염된다. 요청할 때만 스킬·서브에이전트로 돈다(opt-in).
## 무엇을 왜
템플릿의 보안 결함은 거기서 나온 모든 서비스로 복제된다(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`(도구 표·착수 보고)
템플릿의 보안 결함은 거기서 나온 모든 서비스로 복제된다. 반복 가능한 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 통과.
실측 중 `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(시험·매니페스트 그대로 통과).
한 번의 즉흥 공격이 아니라, 빈칸 없는 기준표(ASVS L2 × API Top 10 × 진입점)를
두 회차 연속 새 발견 0까지 반복하는 절차를 적는다. 공격 표면 목록·기준표·세 축
공격(정적·수동·동적)·발견 처리(근본 원인→전 코드 같은 모양→막는 시험)·재실행과,
AI 침투 에이전트 조사 결과(자동 투입 안 함·방법 차용)를 담는다. 다음 교전이 같은
깊이로 돌게 하는 것이 목적이다. SKILL.md에서 가리킨다.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을 왜
템플릿의 보안 결함은 거기서 나온 모든 서비스로 복제된다(template-program README §4 W4, 소유자 결정). 반복 가능한 red team 장치가 없어 공격을 매번 즉흥으로 했다. 승인된 보안 시험을 위한 장치를
plugins/redteam/로 더한다.고른 방법과 버린 대안
새 플러그인
redteam(0.1.0).harness와 역할이 달라 훅은 두지 않는다 — 상시 실행은 출력이 모든 세션 컨텍스트에 들어가 오염된다. 요청할 때만 스킬·서브에이전트로 돈다(opt-in).agents/역할 6:redteam-reconredteam-authzredteam-inputredteam-depsredteam-configredteam-frontendskills/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). 한 건은 심각도·재현 절차·영향·고치는 법을 담는다버린 대안:
위험·영향
tools.lock의 digest는 아직 미고정(-)이다. 첫 실행pin모드가 실제 digest를 뽑아 채운다(scripts/ci/trivy-scan.sh의 바이너리 SHA-256과 같은 TOFU 방식). 공격 단계에서 쓰는 도구부터 채운다.harness플러그인은 바꾸지 않았다(version 그대로).redteam은 새 것이라 받는 쪽 영향 없음.검증
scripts/check.shrc=0: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— 교전 흐름과 범위·안전 규칙관련 문서
template-program/README.md§4 W4, §7w4-redteam.md(도구 표·착수 보고)