#!/usr/bin/env bash # red team 도구 실행 래퍼. desktop에서만 돈다. # # bash redteam-scan.sh --target <소스경로|URL> --out <결과폴더> [옵션] # # 모드: # secrets gitleaks: 소스·git 히스토리의 비밀 값 # sast semgrep CE: 정적 분석(룰은 런타임에 레지스트리에서, --metrics=off로 코드 안 보냄) # 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 소스 폴더(secrets/sast/deps/config) 또는 http URL(dast-*/nuclei) # --out 결과를 쓸 폴더 (기본 ./redteam-out) # --api OpenAPI 스펙 URL 또는 파일 (dast-api) # --net 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) # 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 필요" >&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 필요" >&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 필요" >&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