문제: redteam-scan.sh secrets 모드가 gitleaks를 --redact 없이 불러, 찾은 비밀 값 원문이 secrets.json에 그대로 남는다. 이 파일은 redteam 스킬이 다음 단계에서 읽으므로 비밀 값이 에이전트 컨텍스트에 들어간다. 또 ZAP(dast-baseline·dast-api)은 기본으로 call home(텔레메트리·업데이트 확인·뉴스)을 한다. semgrep에는 --metrics=off를 걸었지만 ZAP에는 같은 장치가 없었다. NVIDIA SkillSpector 2.13.4 정적 스캔(PE3 secrets.json)과 그 뒤 의미 검토에서 찾았다. 고른 방법: gitleaks에 --redact를 더한다. 위치(파일·줄·커밋·규칙)는 남으니 고칠 곳 찾기에는 지장이 없다. ZAP 두 모드에 -z "-silent"를 더한다(ZAP FAQ: -silent는 call home을 막는다). 가짜 docker로 실제로 넘기는 인자를 확인하는 시험을 더했다(semgrep --metrics=off도 함께 고정). 버린 대안: 결과 파일 이름 secrets.json 바꾸기(스캐너 경고만 줄고 결과를 읽는 문서·에이전트 계약이 깨진다), -notel(텔레메트리만 끄고 업데이트 확인은 남는다). 위험: docker로 실제 이미지를 돌려 보지 않았다. 고정 digest의 ZAP 2.16.1에서 'ZAP is Out of Date' 규칙이 -silent 아래서도 업데이트 확인을 한 적이 있다(ZAP 블로그 2025-10-21). schemathesis 4의 원격 전송 여부는 확인하지 못했다. 플러그인 동작이 바뀌어 redteam 버전을 0.1.2로 올린다. 검증: 고치기 전 스크립트에서 새 시험 2개 실패(RED), 고친 뒤 scripts/check.sh 통과(harness 24·redteam 21·템플릿 11, 매니페스트 3개). Refs: design-docs harness/2026-11-12-skill-specter-audit.md
158 lines
7.1 KiB
Bash
Executable File
158 lines
7.1 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# red team 도구 실행 래퍼. desktop에서만 돈다.
|
|
#
|
|
# bash redteam-scan.sh <mode> --target <소스경로|URL> --out <결과폴더> [옵션]
|
|
#
|
|
# 모드:
|
|
# secrets gitleaks: 소스·git 히스토리의 비밀 값(--redact로 결과에 값 원문을 남기지 않음)
|
|
# sast semgrep CE: 정적 분석(룰은 런타임에 레지스트리에서, --metrics=off로 코드 안 보냄)
|
|
# deps trivy fs: 의존성 취약점(HIGH/CRIT 요약)
|
|
# config checkov + hadolint: compose·Dockerfile·IaC 오구성
|
|
# dast-baseline OWASP ZAP baseline: 띄운 앱에 수동(passive) 스캔(헤더·쿠키·CSP). ZAP은 -silent로
|
|
# call home(텔레메트리·업데이트 확인·뉴스)을 끈다(dast-api도 같다)
|
|
# 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)
|
|
# --redact: 찾은 값 원문 대신 REDACTED를 쓴다. 이 결과를 읽는 에이전트 컨텍스트에 비밀 값이 들어가지 않게.
|
|
# 위치(파일·줄·커밋·규칙)는 그대로 남으니 고칠 곳을 찾는 데는 모자라지 않다.
|
|
ref="$(image_ref gitleaks)"; ensure_image "${ref}"
|
|
docker run --rm -v "${TARGET}:/repo:ro" "${ref}" \
|
|
detect --source=/repo --no-banner --redact --report-format json --report-path /dev/stdout \
|
|
> "${OUT}/secrets.json" 2> "${OUT}/secrets.log" || true
|
|
echo "→ ${OUT}/secrets.json"
|
|
;;
|
|
sast)
|
|
# semgrep CE(엔진 LGPL). 룰은 레지스트리에서 런타임에 받고(커밋 안 함), --metrics=off로
|
|
# 프로젝트 정보를 밖에 보내지 않는다(--config auto는 metrics를 켜야 해 쓰지 않는다).
|
|
ref="$(image_ref semgrep)"; ensure_image "${ref}"
|
|
docker run --rm -v "${TARGET}:/src:ro" "${ref}" \
|
|
semgrep scan --config p/default --config p/secrets --metrics=off --json /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 -z "-silent" \
|
|
> "${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 -z "-silent" \
|
|
> "${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
|