# 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 | 비밀 값 | | semgrep CE | 엔진 LGPL-2.1 | SAST(공식 이미지, 룰은 런타임·`--metrics=off`로 코드 안 보냄) | | 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하지 않는다. 도구는 런타임에 받고 룰도 그때 받는다. SAST는 semgrep CE(엔진 LGPL): 레지스트리 룰은 Semgrep Rules License(내부 실행은 허용, 재배포 금지)라 커밋하지 않고 런타임에만 받으며, `--metrics=off`로 프로젝트 코드를 밖에 보내지 않는다. opengrep은 공식 컨테이너 이미지가 없어 뺐다. CodeQL은 라이선스(OSS 전용 조건)로 기본 제외. ## 범위·안전 - 공격은 **내가 띄운 인스턴스와 의존 컨테이너뿐.** 운영·남의 서비스·외부는 제외. DoS 금지. - 무거운 실행은 desktop에서 `flock`·setsid로, 끝나면 이미지·산출물을 지운다.