
foxguard v0.13.0
๋น ๋ฅธ ๋ฒ์ฉ ์ฝ๋ ๋ณด์ ์ค์บ๋๋ก, Rust๋ก ์์ฑ๋์์ต๋๋ค. ๋ชจ๋ ๊ธฐ๋ฅ์ด ํฌํจ๋์ด ์์ต๋๋ค: 14๊ฐ ์ธ์ด ์ง์, ๋ถ๋ฅ๋ฅผ ์ํ TUI, ๋น๋ฐ ์ ๋ณด, ์์ ์ดํ ๊ฐ์ฌ, ์ฐจ์ด ์ธ์ ์ค์บ ๋ฑ ๐ฅ
foxguard
์ฝ๋, ์ํฌ๋ฆฟ, ์์กด์ฑ ๋ฐ ์ํธํ ์ํ์ ๋ํ ๋น ๋ฅธ ๋ก์ปฌ ๋ณด์ ์ค์บ.
์คํ ์ฌ์ด๋ฒ๋ณด์ ํ๋ค์ค์ธ 0sec์ ํตํฉ๋์์ต๋๋ค.
npx foxguard .
์
ย 12๊ฐ ์์ค ์ธ์ด์ ๊ฑธ์น 200๊ฐ ์ด์์ ๋ด์ฅ ๊ท์น๊ณผ ๊ตฌ์ฑ ๋ฐ ๋งค๋ํ์คํธ ๊ฒ์ฌ
ย 14๊ฐ ์ธ์ด์ ๋ํ ํ
์ธํธ ์ถ์ , Python, JavaScript, Go, Java, Ruby, PHP, C#, Kotlin์ ๋ํ ๊ต์ฐจ ํ์ผ ๋ถ์ ์ง์
ย ๋น ๋ฅธ ๋ก์ปฌ ๋ฐ CI ์ค์บ, "์ด ๋ธ๋์น๊ฐ ๋ฌด์์ ์ถ๊ฐํ๋๊ฐ?"๋ฅผ ์ํ diff ๋ชจ๋ ์ง์
ย ์ํฌ๋ฆฟ ์ค์บ, OSV ๊ธฐ๋ฐ ์์กด์ฑ ์ค์บ, ํฌ์คํธ ์์ ์ํธ ๊ฐ์ฌ
ย ๊ณต๊ฐ ๋ ์ง์คํธ๋ฆฌ์ ์ฝ 98%๋ฅผ ๋ก๋ํ๋ Semgrep/OpenGrep ํธํ YAML ๋ธ๋ฆฌ์ง (์ปค๋ฒ๋ฆฌ์ง ๋ณด๊ณ ์)
ย ํฐ๋ฏธ๋, JSON, SARIF, CycloneDX 1.6 CBOM, Semgrep ํธํ JSON ์ถ๋ ฅ
์ค์น
npx foxguard . # zero install
pipx install foxguard # prebuilt CLI from PyPI
curl -fsSL https://foxguard.dev/install.sh | sh # prebuilt binary (macOS/Linux)
cargo install foxguard # from source
๋
๋ฆฝ ์คํํ ๋ฐ์ด๋๋ฆฌ ์ค์น ํ๋ก๊ทธ๋จ์ GitHub ๋ฆด๋ฆฌ์ค ๋ฐ์ด๋๋ฆฌ๋ฅผ checksums.txt์ ๋์กฐํ์ฌ ๊ฒ์ฆํฉ๋๋ค. ๋ฆด๋ฆฌ์ค ๋ฐ์ด๋๋ฆฌ๋ GitHub ์ํฐํฉํธ ์ฆ๋ช
๋ ๊ฒ์ํฉ๋๋ค. ์๋ ๊ฒ์ฆ์๋ gh attestation verify๋ฅผ ์ฌ์ฉํ๊ฑฐ๋ ๋ฆด๋ฆฌ์ค ์ถ์ฒ๋ฅผ ์ฐธ์กฐํ์ธ์.
PyPI ํ ์ Linux glibc 2.28+ (x86_64/ARM64), macOS
(Intel/Apple Silicon), Windows x86_64์์ Python 3.9+๋ฅผ ์ง์ํฉ๋๋ค. ๊ธฐ์กด Python ๊ฐ์
ํ๊ฒฝ์์๋ ๋์ python -m pip install foxguard๋ฅผ ์ฌ์ฉํ์ธ์. ์ด๋ค์ Rust ์ปดํ์ผ๋ฌ๋ ๋ฐํ์ ๋ฐ์ด๋๋ฆฌ ๋ค์ด๋ก๋ ์์ด ๋ค์ดํฐ๋ธ
CLI๋ฅผ ์ค์นํฉ๋๋ค. Python API๋ ์ ๊ณต๋์ง ์์ต๋๋ค. Alpine/musl ์ฌ์ฉ์๋ ๋
๋ฆฝ ์คํํ Linux ๋ฆด๋ฆฌ์ค ๋ฐ์ด๋๋ฆฌ๋ฅผ ์ฌ์ฉํด์ผ ํฉ๋๋ค.
GitHub Action:
- uses: 0sec-labs/foxguard/[email protected]
with:
path: .
severity: medium
fail-on-findings: "true"
upload-sarif: "true"
pre-commit:
repos:
- repo: https://github.com/0sec-labs/foxguard
rev: v0.14.2
hooks:
- id: foxguard
ํตํฉ: GitHub App, VS Code, Claude Code plugin, ๊ทธ๋ฆฌ๊ณ MCP server.
ํธ์คํ ๋ GitHub App ์ด์
foxguard-github-app์ ์ค๋ฐ๊ฟ์ผ๋ก ๊ตฌ๋ถ๋ JSON ๋ก๊ทธ๋ฅผ ๊ธฐ๋กํฉ๋๋ค. ์๋ฃ ๋ฐ ์คํจํ
์ค์บ์ event=foxguard.scan.completed์ event=foxguard.scan.failed๋ฅผ ์ฌ์ฉํ๋ฉฐ,
์๊ด ๋ถ์์ ์ํ delivery, installation, repository, PR, commit, duration, ๊ทธ๋ฆฌ๊ณ
usage_scope ํ๋๋ฅผ ํฌํจํฉ๋๋ค. ์๋ณ์๋ ๋ฉํธ๋ฆญ ๋ ์ด๋ธ์ด ์๋ ๋ก๊ทธ ํ๋๋ก ์ ์งํ์ธ์.
FOXGUARD_INTERNAL_ACCOUNTS๋ฅผ ์์ ์ GitHub ๊ณ์ ๋ฐ ์กฐ์ง์ ์ผํ๋ก ๊ตฌ๋ถ๋ ๋ชฉ๋ก์ผ๋ก
์ค์ ํ์ธ์. ์ผ์น๋ ๋์๋ฌธ์๋ฅผ ๊ตฌ๋ถํ์ง ์์ต๋๋ค. ๋ค๋ฅธ ์์ ์๋ external๋ก
๋ถ๋ฅ๋๋ฉฐ, ๋ชฉ๋ก์ด ์ค์ ๋์ง ์์๊ฑฐ๋ ์์ ์๊ฐ ๋๋ฝ๋ ๊ฒฝ์ฐ unknown์ด ์์ฑ๋ฉ๋๋ค.
์ธ๋ถ ํ๋์ ์ ๋ฃ ๊ณ ๊ฐ์ ์ฆ๊ฑฐ๊ฐ ์๋๋ฉฐ, ์ค์บ์ ์ฌ๋์ด ์๋๋๋ค.
์ค์น ๋ ์ง์คํธ๋ฆฌ๋ ์์ ์์ ๋งค์๊ฐ GitHub์ App ์ค์น API์ ๋ชจ๋ ํ์ด์ง์ ๋์กฐํ์ฌ ์กฐ์ ๋ฉ๋๋ค. ์๋ก ๊ณ ์นจ ์คํจ ์ ๊ธฐ์กด ์ํ๊ฐ ์ ์ง๋๋ฉฐ, ๋์ ์นํ ์ด ์ฐ์ ํฉ๋๋ค. ํฌ์ํ ์นํ ๋ฉํ๋ฐ์ดํฐ๋ ์๋ ค์ง ๊ณ์ ์ธ๋ถ ์ ๋ณด์ ๊ด์ฐฐ๋ ์ ์ฅ์ ์ด๋ฆ์ ๋ณด์กดํฉ๋๋ค. ์ด๋ฌํ ์ด๋ฆ์ ์ค์น์ ์ ๊ทผ ๊ฐ๋ฅํ ์ ์ฅ์์ ๋ํ ์์ ํ ์ธ๋ฒคํ ๋ฆฌ๊ฐ ์๋๋๋ค.
FOXGUARD_INSTALLATIONS_PATH์ FOXGUARD_PULL_REQUEST_JOBS_PATH๋ฅผ ์๊ตฌ
์คํ ๋ฆฌ์ง์ ์ ์งํ์ธ์. ์ค์บ ์คํจ์ ํจ๊ป foxguard.installations.reconcile_failed๋ฅผ
๋ชจ๋ํฐ๋งํ์ธ์. foxguard.installations.reconciled๋ ์ฑ๊ณต์ ์ธ ์๋ก ๊ณ ์นจ ํ ์ด
์ค์น ์์ ๋ด๋ถ/์ธ๋ถ/์ ์ ์๋ ์ค์น ์๋ฅผ ๋ณด๊ณ ํฉ๋๋ค. FOXGUARD_PR_WORKERS๋
์ธก์ ๋ ์ค์บ๋ ์ต๋ ๋ฉ๋ชจ๋ฆฌ์ ์ปจํ
์ด๋ ๋ฉ๋ชจ๋ฆฌ ์ ํ์ ๊ธฐ์ค์ผ๋ก ํฌ๊ธฐ๋ฅผ ์กฐ์ ํ์ธ์.
์์ ํ๋ก์ธ์ค OOM ํฌ์ ํธ์คํ
๋ ์ ํ๋ฆฌ์ผ์ด์
์ ์ฌ์์ํ์ง ์๊ณ ๋ ๋ฐ์ํ ์ ์์ต๋๋ค.
๋น ๋ฅธ ์์
foxguard . # scan everything
foxguard diff main . # only new findings vs main
foxguard tui . # interactive terminal review
foxguard secrets . # leaked credentials and keys
foxguard sca . # dependency vulnerabilities from OSV
foxguard pqc . # post-quantum crypto audit
foxguard --format sarif . > results.sarif
foxguard --format semgrep-json . # Semgrep CLI-compatible JSON
foxguard --fix src/ ๋๋ foxguard --fix src/app.py๋ฅผ ์ฌ์ฉํ์ฌ ์ง์๋๋ taint ์์ ์ ์ ์๋ฆฌ์์ ์ ์ฉํฉ๋๋ค. ๋์์ ์ ์ ์ค์บ ๋๋ ํฐ๋ฆฌ ๋๋ ์ ํํ ํ์ผ์ ๋ํด ๊ฒ์ฌ๋๋ฉฐ, ํด๋น ๋ฒ์๋ฅผ ๋ฒ์ด๋ ๋ฐ๊ฒฌ ์ฌํญ์ ๊ฑด๋๋๋๋ค. Python ๋ช
๋ น ์ฃผ์
์์ ์ ํ์ํ ๋ import subprocess๋ฅผ ์ถ๊ฐํ๋ฉฐ, ๋ชจ๋ docstring๊ณผ future import๋ฅผ ๋ณด์กดํฉ๋๋ค. ์ปค๋ฐํ๊ธฐ ์ ์ ์์ฑ๋ ๋ณ๊ฒฝ ์ฌํญ์ ๊ฒํ ํ์ญ์์ค.
๋ค์ดํฐ๋ธ ์ฝ๋ ์ค์บ๋์์ ํ์ผ ์ฝ๊ธฐ, ๋ฉํ๋ฐ์ดํฐ, ๋๋ ํฐ๋ฆฌ ์ํ ์คํจ๋ ์ฑ๊ณต์ ์ธ ๋ณด๊ณ ์๋ฅผ ์์ฑํ๊ฑฐ๋ ๋ฒ ์ด์ค๋ผ์ธ์ ๋ฎ์ด์ฐ๋ ๋์ ์ข
๋ฃ ์ฝ๋ 2๋ก ์ข
๋ฃ๋ฉ๋๋ค. ์๋์ ์ ์ธ์ ์ง์๋์ง ์๋ ํ์ผ, ๋ฐ์ด๋๋ฆฌ ํ์ผ, ํฌ๊ธฐ ์ด๊ณผ ํ์ผ์ ๊ฑด๋๋ฐ๊ธฐ๋ก ์ ์ง๋ฉ๋๋ค. ์ค์บ ๋ฒ์๋ฅผ ํ์ธํ ๋ ๊ฑด๋๋ด ํ์ผ ์๋ฆผ์ ๊ฒ์ฌํ์ญ์์ค.
ํฐ๋ฏธ๋ ๊ฒํ
foxguard tui .๋ฅผ ์คํํ๊ณ ํ์ดํ ๋๋ Tab์ผ๋ก Scan, Diff, Secrets, PQC ์ค ํ๋๋ฅผ ์ ํํฉ๋๋ค. Diff ๋ชจ๋์์๋ Enter๋ฅผ ๋๋ฅด๊ธฐ ์ ์ ๋์ ๋ธ๋์น๋ฅผ ์
๋ ฅํฉ๋๋ค. ๋์ ํฐ๋ฏธ๋์ ๋ฐ๊ฒฌ ์ฌํญ์ ์ธ๋ถ ์ ๋ณด ์์ ํ์ํ๊ณ , ์์ ํฐ๋ฏธ๋์ ํ์ฅ ๊ฐ๋ฅํ ์ธ๋ถ ๋ณด๊ธฐ๊ฐ ์๋ ๋ชฉ๋ก์ ์ฌ์ฉํฉ๋๋ค. ์์ค ์ปจํ
์คํธ, ๋ฐ์ดํฐ ํ๋ฆ, ์์ ์ฌํญ์ ๋ฐ๊ฒฌ ์ฌํญ์ด ์ ๊ณตํ๋ ๊ฒฝ์ฐ ํญ์ ์คํฌ๋กคํ ์ ์์ต๋๋ค.
ํค๋๋ ์ค์บ ํต๊ณ์ ๋ฒ ์ด์ค๋ผ์ธ ์นดํ ๊ณ ๋ฆฌ๋ฅผ ๊ตฌ๋ถํฉ๋๋ค. ์ ํํ ์์ค ๋ฒ์๋ ์ถ๊ฐ ์ฃผ์ ํ ์์ด ์ธ๋ผ์ธ์ผ๋ก ๊ฐ์กฐ ํ์๋ฉ๋๋ค. ์ด๊ธฐ ์ปจํธ๋กค์ ์ฝํ ์ธ ๊ฐ ์คํฌ๋กค๋๋ ๋์ ๋ผ์ด๋ธ ์ธ๋ถ ์ ๋ณด ์ฐฝ ์๋์ ์ ์ง๋๋ฉฐ, ์ถ์ฝ๋ ํ์ผ ์์น๋ ์ค ๋ฐ ์ด ์ ๋ฏธ์ฌ๋ฅผ ์ ์งํฉ๋๋ค. ๊ฒ์๊ณผ ๋ํ ์์๋ ํ์ฑ ์ํ์ผ ๋ ์์ฒด ๋จ์ถํค๋ฅผ ์ฌ์ฉํฉ๋๋ค.
์์ค ์ปจํ ์คํธ๋ฅผ ๋ก๋ํ ์ ์๋ ๊ฒฝ์ฐ ์ ์ฅ๋ ๋ฐ๊ฒฌ ์ฌํญ ์ค๋ํซ์ ๊ณ์ ์ฌ์ฉํ ์ ์์ต๋๋ค. Secrets๋ ์์ ์์ค๋ฅผ ์ธ๋ถ ์ ๋ณด ์ฐฝ์ ๋ก๋ํ๋ ๋์ ์์ ๋ ์ค๋ํซ์ ์ฌ์ฉํฉ๋๋ค.
๋ก๋ฉ ์นด๋๋ ๋ฐฑ๋ถ์จ ์ถ์ ์น๊ฐ ์๋ ๋ถํ์ ํ๋๊ณผ ์ค์ ๊ฒฝ๊ณผ ์๊ฐ์ ํ์ํฉ๋๋ค. ์ค์บ ์ค์๋ Ctrl+C๋ก ์ข ๋ฃํฉ๋๋ค.