Files
claude-harness/plugins/redteam/scripts/redteam-scan.sh
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

153 lines
6.3 KiB
Bash
Executable File

#!/usr/bin/env bash
# red team 도구 실행 래퍼. desktop에서만 돈다.
#
# bash redteam-scan.sh <mode> --target <소스경로|URL> --out <결과폴더> [옵션]
#
# 모드:
# secrets gitleaks: 소스·git 히스토리의 비밀 값
# sast opengrep: 정적 분석(언어 자동, 런타임에 룰 받음)
# deps trivy fs: 의존성 취약점(HIGH/CRIT 요약)
# config checkov + hadolint: compose·Dockerfile·IaC 오구성
# dast-baseline OWASP ZAP baseline: 띄운 앱에 수동(passive) 스캔(헤더·쿠키·CSP)
# dast-api ZAP api-scan + schemathesis: OpenAPI 기반 능동·퍼징 (--api 필요)
# nuclei nuclei: 알려진 노출·오구성 템플릿 (대상은 내 로컬 URL만)
# pin tools.lock의 모든 도구를 받아 실제 digest를 출력(고정에 붙여 쓴다)
#
# 옵션:
# --target <v> 소스 폴더(secrets/sast/deps/config) 또는 http URL(dast-*/nuclei)
# --out <dir> 결과를 쓸 폴더 (기본 ./redteam-out)
# --api <v> OpenAPI 스펙 URL 또는 파일 (dast-api)
# --net <name> docker 네트워크(대상 컨테이너에 붙을 때)
#
# 실행 규칙: 무거우니 호출자가 `flock /tmp/claude-gates/heavy.lock`과 setsid로 감싼다.
# 끝나면 받은 이미지를 지운다(desktop 디스크 여유 적음). 공격 대상은 내가 띄운 템플릿뿐.
set -euo pipefail
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
LOCK="${HERE}/tools.lock"
usage() { sed -n '2,33p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'; }
# tools.lock에서 한 도구의 "image digest"를 돌려준다.
lookup() {
local name="$1" line
line="$(awk -v n="$name" '$1==n {print $2, $3; found=1} END{if(!found) exit 3}' "${LOCK}")" \
|| { echo "tools.lock에 '$name' 없음" >&2; return 3; }
echo "${line}"
}
# 실행용 이미지 참조. digest가 있으면 image@digest, 없으면 image:tag(경고).
image_ref() {
local name="$1" image digest
read -r image digest < <(lookup "$name")
if [ "${digest}" = "-" ]; then
echo "경고: ${name} digest 미고정 — 태그로 받는다. pin 모드로 고정하라" >&2
echo "${image}"
else
echo "${image%%:*}@${digest}"
fi
}
ensure_image() {
local ref="$1"
docker image inspect "${ref}" >/dev/null 2>&1 || docker pull "${ref}" >&2
}
# 모든 도구를 받아 실제 digest를 tools.lock 형식으로 출력
do_pin() {
local name image digest ref repo d
while read -r name image digest; do
case "${name}" in ''|\#*) continue;; esac
docker pull "${image}" >&2 || { echo "${name} pull 실패" >&2; continue; }
repo="${image%%:*}"
d="$(docker image inspect --format '{{index .RepoDigests 0}}' "${image}" 2>/dev/null | sed 's/.*@//')"
[ -n "${d}" ] || d="$(docker inspect --format '{{.Id}}' "${image}")"
printf '%-16s %-48s %s\n' "${name}" "${image}" "${d}"
done < "${LOCK}"
}
MODE="${1:-}"; shift || true
TARGET=""; OUT="./redteam-out"; API=""; NET=""
while [ $# -gt 0 ]; do
case "$1" in
--target) TARGET="$2"; shift 2;;
--out) OUT="$2"; shift 2;;
--api) API="$2"; shift 2;;
--net) NET="$2"; shift 2;;
-h|--help) usage; exit 0;;
*) echo "모르는 옵션: $1" >&2; usage; exit 2;;
esac
done
case "${MODE}" in -h|--help|'') usage; exit 0;; esac
command -v docker >/dev/null 2>&1 || { echo "docker 없음 — desktop에서 돌려라" >&2; exit 2; }
mkdir -p "${OUT}"
netarg=(); [ -n "${NET}" ] && netarg=(--network "${NET}")
case "${MODE}" in
pin)
do_pin
;;
secrets)
ref="$(image_ref gitleaks)"; ensure_image "${ref}"
docker run --rm -v "${TARGET}:/repo:ro" "${ref}" \
detect --source=/repo --no-banner --report-format json --report-path /dev/stdout \
> "${OUT}/secrets.json" 2> "${OUT}/secrets.log" || true
echo "→ ${OUT}/secrets.json"
;;
sast)
ref="$(image_ref opengrep)"; ensure_image "${ref}"
docker run --rm -v "${TARGET}:/src:ro" "${ref}" \
scan --config auto --json --output /dev/stdout /src \
> "${OUT}/sast.json" 2> "${OUT}/sast.log" || true
echo "→ ${OUT}/sast.json"
;;
deps)
ref="$(image_ref trivy)"; ensure_image "${ref}"
docker run --rm -v "${TARGET}:/src:ro" "${ref}" \
fs --scanners vuln --severity HIGH,CRITICAL --format json --output /dev/stdout /src \
> "${OUT}/deps.json" 2> "${OUT}/deps.log" || true
echo "→ ${OUT}/deps.json"
;;
config)
ref="$(image_ref checkov)"; ensure_image "${ref}"
docker run --rm -v "${TARGET}:/src:ro" "${ref}" \
-d /src --compact --quiet -o json > "${OUT}/config-checkov.json" 2> "${OUT}/config-checkov.log" || true
hl="$(image_ref hadolint)"; ensure_image "${hl}"
: > "${OUT}/config-hadolint.json"
while IFS= read -r df; do
docker run --rm -i "${hl}" hadolint --format json - < "${df}" >> "${OUT}/config-hadolint.json" 2>> "${OUT}/config-hadolint.log" || true
done < <(find "${TARGET}" -type f -name 'Dockerfile*' 2>/dev/null)
echo "→ ${OUT}/config-checkov.json ${OUT}/config-hadolint.json"
;;
dast-baseline)
[ -n "${TARGET}" ] || { echo "--target <URL> 필요" >&2; exit 2; }
ref="$(image_ref zap)"; ensure_image "${ref}"
docker run --rm "${netarg[@]}" -v "${OUT}:/zap/wrk:rw" "${ref}" \
zap-baseline.py -t "${TARGET}" -J dast-baseline.json -r dast-baseline.html \
> "${OUT}/dast-baseline.log" 2>&1 || true
echo "→ ${OUT}/dast-baseline.json"
;;
dast-api)
[ -n "${API}" ] || { echo "--api <OpenAPI URL|파일> 필요" >&2; exit 2; }
ref="$(image_ref zap)"; ensure_image "${ref}"
docker run --rm "${netarg[@]}" -v "${OUT}:/zap/wrk:rw" "${ref}" \
zap-api-scan.py -t "${API}" -f openapi -J dast-api.json -r dast-api.html \
> "${OUT}/dast-api.log" 2>&1 || true
st="$(image_ref schemathesis)"; ensure_image "${st}"
docker run --rm "${netarg[@]}" "${st}" \
run "${API}" --checks all --report junit --report-junit-path /dev/stdout \
> "${OUT}/dast-schemathesis.xml" 2> "${OUT}/dast-schemathesis.log" || true
echo "→ ${OUT}/dast-api.json ${OUT}/dast-schemathesis.xml"
;;
nuclei)
[ -n "${TARGET}" ] || { echo "--target <URL> 필요" >&2; exit 2; }
ref="$(image_ref nuclei)"; ensure_image "${ref}"
docker run --rm "${netarg[@]}" "${ref}" \
-u "${TARGET}" -jsonl -silent > "${OUT}/nuclei.jsonl" 2> "${OUT}/nuclei.log" || true
echo "→ ${OUT}/nuclei.jsonl"
;;
*)
echo "모르는 모드: ${MODE}" >&2; usage; exit 2;;
esac