
foxguard v0.13.0
é«éãªãŠãããŒãµã«ã³ãŒãã»ãã¥ãªãã£ã¹ãã£ããŒãRustã§èšè¿°ãããããªãŒå梱ïŒ14èšèªå¯Ÿå¿ãããªã¢ãŒãžçšTUIãã·ãŒã¯ã¬ããããã¹ãéåç£æ»ãdiff察å¿ã¹ãã£ã³ãªã© ð¥
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 installation API ã®å šããŒãžã«å¯ŸããŠç §åãããŸããæŽæ°ã«å€±æããå Žåã¯æ¢åã®ç¶æ ãä¿æãããåæã«çºçãã webhook ãåªå ãããŸããç㪠webhook ã¡ã¿ããŒã¿ã¯ãæ¢ç¥ã®ã¢ã«ãŠã³ã詳现ãšèŠ³æž¬ããããªããžããªåãä¿æããŸãããããã®ååã¯ãã€ã³ã¹ããŒã«ãã¢ã¯ã»ã¹å¯èœãªãªããžããªã®å®å šãªã€ã³ãã³ããªã§ã¯ãããŸããã
FOXGUARD_INSTALLATIONS_PATH ãš FOXGUARD_PULL_REQUEST_JOBS_PATH ã¯æ°žç¶ã¹ãã¬ãŒãžäžã«ä¿åããŠãã ãããã¹ãã£ã³å€±æãšããã㊠foxguard.installations.reconcile_failed ãç£èŠããŠãã ãããfoxguard.installations.reconciled ã¯ãæ£åžžãªæŽæ°åŸã®åèšããã³ internal/external/unknown ã®ã€ã³ã¹ããŒã«æ°ãå ±åããŸããFOXGUARD_PR_WORKERS ã¯ãèšæž¬ãããã¹ãã£ããŒã®ããŒã¯ã¡ã¢ãªãšã³ã³ããã®ã¡ã¢ãªå¶éã«åºã¥ããŠãµã€ãºã決å®ããŠãã ãããåããã»ã¹ã® OOM kill ã¯ããã¹ãåã¢ããªã±ãŒã·ã§ã³ãåèµ·åããã«çºçããå¯èœæ§ããããŸãã
ã¯ã€ãã¯ã¹ã¿ãŒã
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 ã䜿çšããŠããµããŒããããŠãããã€ã³ãä¿®æ£ããã®å Žã§é©çšããŸããã¿ãŒã²ããã¯æ£èŠã®ã¹ãã£ã³ãã£ã¬ã¯ããªãŸãã¯éžæãããã¡ã€ã«ã«å¯ŸããŠãã§ãã¯ããããã®ç¯å²å€ã®æ€åºçµæã¯ã¹ããããããŸããPython ã®ã³ãã³ãã€ã³ãžã§ã¯ã·ã§ã³ä¿®æ£ã§ã¯ãå¿
èŠã«å¿ã㊠import subprocess ã远å ãããã¢ãžã¥ãŒã«ã® docstring ãš future import ãä¿æãããŸããã³ãããããåã«çæããã倿Žã確èªããŠãã ããã
ãã€ãã£ãã³ãŒãã¹ãã£ãã«ããããã¡ã€ã«èªã¿åããã¡ã¿ããŒã¿ãããã³ãã£ã¬ã¯ããªãã©ããŒãµã«ã®å€±æã¯ãæåããã¬ããŒããçæãããããŒã¹ã©ã€ã³ãäžæžãããããã代ããã« 2 ã§çµäºããŸããæå³çãªé€å€ããã³ãµããŒããããŠããªããã¡ã€ã«ããã€ããªãã¡ã€ã«ããŸãã¯ãµã€ãºè¶
éã®ãã¡ã€ã«ã¯ã¹ãããã®ãŸãŸã§ããã¹ãã£ã³ã«ãã¬ããžã確èªããéã¯ãã¹ãããããããã¡ã€ã«ã®éç¥ãæ€æ»ããŠãã ããã
ã¿ãŒããã«ã¬ãã¥ãŒ
foxguard tui . ãå®è¡ããç¢å°ããŒãŸã㯠Tab ã§ ScanãDiffãSecretsããŸã㯠PQC ãéžæããŸããDiff ã¢ãŒãã§ã¯ãEnter ãæŒãåã«å¯Ÿè±¡ãã©ã³ããå
¥åããŸããã¯ã€ããªã¿ãŒããã«ã§ã¯æ€åºçµæããã®è©³çŽ°ã®æšªã«è¡šç€ºãããããå°ããªã¿ãŒããã«ã§ã¯å±éå¯èœãªè©³çްãã¥ãŒä»ãã®ãªã¹ãã䜿çšãããŸãããœãŒã¹ã³ã³ããã¹ããããŒã¿ãããŒãããã³ä¿®æ£ã¯ãæ€åºçµæãããããæäŸããå Žåã¯åžžã«ã¹ã¯ããŒã«å¯èœã§ãã
ããããŒã¯ã¹ãã£ã³çµ±èšãšããŒã¹ã©ã€ã³ã«ããŽãªãåé¢ããŸããéžæããããœãŒã¹ç¯å²ã¯ãäœåãªæ³šéè¡ãªãã§ã€ã³ã©ã€ã³ã§ãã€ã©ã€ããããŸããéããŠããã³ã³ãããŒã«ã¯ããã®ã³ã³ãã³ããã¹ã¯ããŒã«ããŠããéãã©ã€ã詳现ãã€ã³ã®äžã«çãŸããççž®ããããã¡ã€ã«ã®å Žæã¯è¡ãšåã®ãµãã£ãã¯ã¹ãä¿æããŸããæ€çŽ¢ãšãã€ã¢ãã°ã¯ãã¢ã¯ãã£ããªéã¯ç¬èªã®ã·ã§ãŒãã«ãããææããŸãã
ãœãŒã¹ã³ã³ããã¹ããèªã¿èŸŒããªãå Žåãä¿åãããæ€åºçµæã®ã¹ããããã¯åŒãç¶ãå©çšå¯èœã§ããSecrets ã¯ãçã®ãœãŒã¹ã詳现ãã€ã³ã«èªã¿èŸŒã代ããã«ãç·šéæžã¿ã®ã¹ããããã䜿çšããŸãã
ããŒãã£ã³ã°ã«ãŒãã¯ãããŒã»ã³ããŒãžã®æšå®å€ã§ã¯ãªããäžç¢ºå®ãªã¢ã¯ãã£ããã£ãšå®éã®çµéæéã衚瀺ããŸããCtrl+C ã¯ã¹ãã£ã³äžã«çµäºããŸãã