Files
claude-harness/plugins/redteam/README.md
T
DongHyeonka 1e81786001 feat(redteam): 두 템플릿을 공격하는 red team 플러그인을 더한다
템플릿의 보안 결함은 거기서 나온 모든 서비스로 복제된다. 반복 가능한 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 통과.
2026-11-11 21:44:30 +09:00

39 lines
2.7 KiB
Markdown

# redteam 플러그인 — 두 템플릿을 공격하는 red team 장치
승인된 보안 시험으로 내가 통제하는 템플릿·서비스를 공격해 취약점을 찾아 고친다. 역할별 서브에이전트와 발동 스킬, 핀 고정 오픈소스 도구 실행 래퍼, 하나의 발견 수집 도구로 이뤄진다.
## 왜 훅이 없나
이 플러그인은 **훅을 두지 않는다.** 보안 공격은 모든 세션에서 자동으로 돌 일이 아니고(출력·컨텍스트 오염), 교전할 때 스킬·서브에이전트로 **요청해서** 돌린다. `harness` 플러그인(위험 명령 차단·장부)과 역할이 다르다.
## 구성
- `agents/` — 역할 서브에이전트 6: `redteam-recon` `redteam-authz` `redteam-input` `redteam-deps` `redteam-config` `redteam-frontend`.
- `skills/redteam/` — 교전 오케스트레이션 스킬(범위 확인 → 정찰 → 공격 → 수집 → 보고 → 고침 → 재실행).
- `scripts/redteam-scan.sh` — 핀 고정 도구 실행 래퍼(desktop에서). 모드: `secrets sast deps config dast-baseline dast-api nuclei pin`.
- `scripts/tools.lock` — 도구 이미지 버전+digest 핀.
- `scripts/finding.py` — 발견 정규화·검사·정렬·보고(JSON Lines). `validate` `report` `summary` `merge`.
- `tests/` — finding.py 로직과 tools.lock·스크립트 형식 시험(표준 라이브러리만).
## 쓰는 법
`/redteam` 스킬을 부르거나, 역할 서브에이전트를 Agent로 띄운다. 자세한 흐름·명령은 `skills/redteam/SKILL.md`.
## 도구와 라이선스
| 도구 | 라이선스 | 비고 |
|---|---|---|
| gitleaks | MIT | 비밀 값 |
| opengrep | LGPL-2.1 | SAST(semgrep 포크, 룰도 OSS) |
| trivy | Apache-2.0 | 의존성/이미지 — 기존 게이트와 공유 |
| osv-scanner | Apache-2.0 | lockfile 교차검증 |
| checkov | Apache-2.0 | IaC·compose·Dockerfile |
| hadolint | GPL-3.0 | Dockerfile(실행만) |
| OWASP ZAP | Apache-2.0 | DAST baseline·api |
| nuclei | MIT | 노출 템플릿(로컬 대상만) |
| schemathesis | MIT | OpenAPI 퍼징 |
| trufflehog | AGPL-3.0 | 심층 비밀 값(실행만, 배포 안 함) |
| claude-code-security-review(참고) | MIT | AI diff 리뷰. 신뢰 코드에만 |
**공개 repo 규칙:** 룰셋·CVE 데이터를 vendoring하지 않는다(semgrep 룰은 제한 라이선스 — opengrep을 기본으로). 도구는 런타임에 받고 룰도 그때 받는다. CodeQL은 라이선스(OSS 전용 조건)로 기본 제외.
## 범위·안전
- 공격은 **내가 띄운 인스턴스와 의존 컨테이너뿐.** 운영·남의 서비스·외부는 제외. DoS 금지.
- 무거운 실행은 desktop에서 `flock`·setsid로, 끝나면 이미지·산출물을 지운다.