Files
claude-harness/plugins/redteam
DongHyeonka b00b34bb2b fix(redteam): SAST를 이미지 없는 opengrep에서 semgrep CE로 바꾸고 digest를 고정한다
실측 중 `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(시험·매니페스트 그대로 통과).
2026-11-11 23:17:56 +09:00
..

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로, 끝나면 이미지·산출물을 지운다.