SAST, SCA, 시크릿 탐지 및 IaC 분석을 결합한 고성능 오픈소스 보안 스캐너로, 개발자와 CI/CD 파이프라인을 위해 구축되었으며 AI를 활용한 권장 사항을 제공합니다!
OWASP Top 10:2025에 맞춰 SAST, SCA, 시크릿 탐지를 결합한 오픈소스 종합 보안 스캐너 — 지능형 교정을 위해 만들어졌습니다.
전체 깊이 SCA. 의존성 엔진이 이제 실제로 배포되는 트리를 읽습니다 — 매니페스트가 선언한 소수 패키지가 아니라, 지원되는 8개 생태계 모두에서 설치된 버전 그대로의 모든 전이적 패키지를 읽습니다.
mvn dependency:tree와 아티팩트 단위까지 일치합니다. gradle.lockfile도 읽습니다.Required : via com.example:core — 따라서 수정이 개발자가 실제로 변경할 수 있는 의존성에 적용됩니다.partialFingerprints로 그 정체성을 유지합니다.자세한 내용은 CHANGELOG를 참조하세요.
📖 전체 문서: --> Drogonsec Doc
| 엔진 | 설명 |
|---|---|
| SAST | 20개 이상 언어에 대한 정적 애플리케이션 보안 테스트 |
| SCA | 소프트웨어 구성 분석 — 선언한 것만이 아니라 전체 전이적 트리 |
| Leaks | 시크릿 탐지 — 50개 이상 패턴 (AWS, GCP, GitHub, JWT, SSH 키...) |
| IaC | Infrastructure as Code 오구성 (Terraform, Kubernetes) |
| AI | AI 기반 교정 — Ollama(로컬/무료) 또는 클라우드 제공자 |
Python Java JavaScript TypeScript Go Kotlin C# PHP Ruby Swift Dart Elixir Erlang Shell C/C++ HTML Terraform Kubernetes Nginx
매니페스트는 버전 범위로 소수의 패키지만 명시합니다. lockfile은 실제로 설치될 모든 패키지를 설치될 버전 그대로 명시합니다 — 그리고 두 번째 그룹이 배포하는 코드의 거의 전부이며, 권고문이 거의 전부 존재하는 곳입니다. 따라서 중요한 열은 깊이입니다:
| 생태계 | 읽는 위치 | 깊이 |
|---|---|---|
| Node.js | package-lock.json, yarn.lock, node_modules/, package.json | 전체 트리 |
| Python | poetry.lock, uv.lock, Pipfile.lock, .venv/, pyproject.toml, requirements.txt | 전체 트리 |
| PHP | composer.lock, vendor/composer/installed.json, composer.json | 전체 트리 |
| Rust | Cargo.lock, Cargo.toml | 전체 트리 |
| Ruby | Gemfile.lock | 전체 트리 |
| Go | go.mod, 모듈 캐시에서 가져온 경로 | 전체 집합 |
| Java | ~/.m2를 기준으로 오프라인 해석된 pom.xml, gradle.lockfile | 전체 트리 |
| Dart | pubspec.lock, pubspec.yaml | 전체 트리 |
npm, Python, PHP의 경우 엔진은 세 가지 소스를 순차적으로 대체하며 사용합니다 — 잠금 파일(lockfile), 그다음 디스크에 설치된 트리(node_modules/, 가상 환경, vendor/), 그다음 매니페스트입니다. 잠금 파일을 커밋하지 않은 저장소도 설치 후에는 전체가 스캔됩니다.
Go, Dart, Java의 경우 엣지는 패키지 관리자 자체의 캐시 — 모듈 캐시, pub 캐시, Maven 로컬 저장소 — 에서 가져오며, 이 캐시에는 프로젝트가 빌드된 후 모든 의존성의 매니페스트가 이미 들어 있습니다. 잠금 파일이 없는 Maven은 Maven 자체의 규칙(부모 POM, 가져온 BOM, 최근접 우선, 의존성 관리, 제외)에 따라 오프라인으로 해석되며 mvn dependency:tree와 아티팩트 단위까지 일치합니다.
모든 발견 항목에는 해당 패키지가 직접(direct) 의존성인지 여부와, 소스가 기록하는 경우 이를 도입한 경로가 함께 포함됩니다:
#8 [CRITICAL] guzzlehttp/psr7 1.9.1
CVE : CVE-2026-49214 CVSS: 9.0
Required : via guzzlehttp/guzzle
Fixed in : 2.10.2
범위는 버전이 아닙니다. 매니페스트에서 읽은 의존성은 요구 사항이 단일 릴리스를 지정할 때만 권고 사항과 대조하여 검사됩니다. lodash: "4.17.15"는 검사되지만, lodash: "^4.17.15"는 검사되지 않습니다. 이는 4.17.21을 설치하며, 4.17.15에 대한 권고 사항을 보고하는 것은 실제로 설치하지 않은 버전을 지목하는 것이기 때문입니다. 해당 패키지들은 여전히 인벤토리와 SBOM에 나타나며, 스캔은 건너뛰어야 했던 항목 수를 알려줍니다. 해결책은 lockfile을 커밋하는 것이며, 이는 동시에 전이적 트리도 확보해 줍니다.
네트워크 없음. 레지스트리에 대해 범위를 해석하는 것은 다른 질문, 즉 오늘 무엇이 설치될 것인가에 답하는 것이며, 에어갭 환경에서 실행되는 스캔을 인터넷 반대편에 두게 됩니다.
자세한 내용은 docs/modules.md를 참조하세요.
Go Install (Go 1.26.6+ 필요):
go install github.com/filipi86/drogonsec/cmd/drogonsec@latest
출처:
git clone https://github.com/filipi86/drogonsec
cd drogonsec
make install
Docker:
docker run --rm -v $(pwd):/scan ghcr.io/filipi86/drogonsec scan /scan
# Scan current directory
drogonsec scan .
# Scan with JSON output
drogonsec scan ./myproject --format json --output report.json
# Scan with HTML report
drogonsec scan . --format html --output report.html
# Scan with AI remediation (local Ollama — free, no API key needed)
drogonsec scan . --enable-ai
# Scan with AI remediation (cloud provider — requires API key)
AI_API_KEY="..." drogonsec scan . --enable-ai --ai-provider anthropic
# Scan git history for secrets
drogonsec scan . --git-history
# Only report HIGH and CRITICAL
drogonsec scan . --severity HIGH
# Disable specific engines
drogonsec scan . --no-sca
drogonsec scan . --no-leaks
drogonsec scan . --no-sast
Drogonsec Security Scanner
═══════════════════════════════════════════
Target : /path/to/project
SAST : enabled
SCA : enabled
Leaks : enabled
═══════════════════════════════════════════
═══ SAST FINDINGS ══════════════════════
#1 [HIGH] SQL Injection via string formatting
File : src/users.py:42
Rule : PY-001
OWASP : A05:2025 - Injection
CWE : CWE-89 CVSS: 9.8
Fix : Use parameterized queries...
{
"version": "0.4.0",
"stats": { "total_findings": 5, "critical": 1, "high": 3 },
"sast_findings": [ ... ],
"sca_findings": [ ... ],
"leak_findings": [ ... ]
}
# .github/workflows/security.yml
- name: DrogonSec Scan
run: drogonsec scan . --format sarif --output results.sarif
- name: Upload to GitHub Security
uses: github/codeql-action/upload-sarif@v4
with:
sarif_file: results.sarif
SCA 엔진이 발견한 종속성에 대한 CycloneDX 1.5 소프트웨어 자재 명세서(Software Bill of Materials)를 내보냅니다. 출력 결과는 Grype, Trivy, Dependency-Track과 같은 도구에서 사용할 수 있습니다.
drogonsec scan . --format cyclonedx --output sbom.json
참고: lockfile 또는 설치된 트리를 사용할 수 있는 경우, SBOM은 전체 전이적 집합을 포함하며 CycloneDX
dependencies그래프를 함께 제공합니다 — 모든 엣지를 포함하므로, 소비자는 어떤 컴포넌트가 취약한 컴포넌트를 끌어들였는지 스스로 파악할 수 있습니다. 매니페스트만으로 읽은 생태계는 엣지 없이 선언된 컴포넌트만 기여하는데, 매니페스트는 엣지를 기록하지 않기 때문입니다. SPDX 출력은 이후 릴리스에서 제공될 예정입니다.
프로젝트 루트에 .drogonsec.yaml을 생성하세요:
scan:
min_severity: LOW
workers: 4
git_history: false
ignore_paths:
- node_modules
- vendor
- dist
engines:
sast:
enabled: true
sca:
enabled: true
leaks:
enabled: true
min_entropy: 3.5
ai:
enabled: false
high_severity_only: true
fail_on:
critical: true
high: true
DrogonSec은 AI 기반 교정 기능을 포함하여 탐지된 취약점에 대해 지능적이고 상황을 인식하는 수정 방안을 제공합니다. Ollama + DeepSeek Coder가 권장되는 오픈소스 옵션입니다 — Ollama는 오픈소스(MIT 라이선스) 이며 100% 로컬에서 실행되어 데이터가 사용자의 컴퓨터를 벗어나지 않습니다.
# 1. Install Ollama (https://ollama.com)
# macOS: brew install ollama
# 2. Pull the recommended model
ollama pull deepseek-coder