tanviet12/vbsec / skills/antigravity/vbs-scan-security
vbs-scan-security
FlaggedUse when scanning code for security vulnerabilities. Use when user says "scan security", "kiểm tra bảo mật", "security audit", "review security", or invokes `/vbs-scan-security`. For large scans (>20 main-language files OR >30 total OR >14 days) processes chunks sequentially. Outputs bilingual reports (vi/en). Optional `--auto-fix` (agentic patch + verify loop) and `--sca` (live CVE lookup via OSV.dev).
rules/generic/22-vulnerable-dependency.md
View on GitHub---
id: VULNERABLE-DEPENDENCY
severity_max: CRITICAL
applies_to: all
opt_in: --sca # load-rules.sh bỏ qua rule này; Step 4b tự Read khi $SCA=true
---
# Vulnerable Dependency (Live CVE — OSV.dev)
## Intent
Rule này khác với `20-outdated-dependency`: đây là finding **đã xác nhận** qua tra cứu live tới [OSV.dev](https://osv.dev), có `cve_id` cụ thể, `fixed_version` chính xác, và severity lấy từ advisory — không phải suy đoán từ static list offline. Chỉ chạy khi user truyền flag `--sca` (xem [`../../references/dependency-scan.md`](../../references/dependency-scan.md) cho toàn bộ cơ chế parse manifest + gọi API).
Vibe coder pin version dependency từ tutorial/template cũ, không track CVE. Với data live từ OSV, vbsec biết chính xác: package nào, version nào, CVE nào, và version nào cần nâng cấp lên — đủ để CI/CD chặn merge một cách có cơ sở, không phải "nghi ngờ".
## Khi nào CRITICAL / HIGH / MEDIUM
| Condition | Severity |
|---|---|
| `database_specific.severity: CRITICAL` (của vuln, hoặc của bản ghi GHSA alias) | CRITICAL |
| `database_specific.severity: HIGH` | HIGH |
| `database_specific.severity: MODERATE`/`MEDIUM` | MEDIUM |
| `database_specific.severity: LOW` | LOW |
| Không có severity nào (kể cả qua GHSA alias) | MEDIUM (mặc định, `severity_source: "default"`, ghi rõ lý do trong `issue_summary`) |
KHÔNG tự tính điểm từ CVSS vector trong `severity[].score` — chỉ xuất nguyên chuỗi làm `cvss_vector`. Chi tiết thứ tự ưu tiên ở [`dependency-scan.md`](../../references/dependency-scan.md) Bước 3.
## Reasoning
1. Đọc [`dependency-scan.md`](../../references/dependency-scan.md) để biết cách parse manifest cho ecosystem tương ứng (`NuGet`, `Go`, `npm`, `Packagist`, `PyPI`, `Pub`).
2. Gọi `POST /v1/querybatch` lấy vuln ID, rồi `GET /v1/vulns/{id}` lấy chi tiết (severity, fixed version, CVE alias).
3. Xác định severity từ `database_specific.severity` (tra qua GHSA alias nếu cần), theo bảng trên.
4. Chỉ flag khi OSV **thực sự trả về ≥1 vuln** cho `(package, installed_version)` — không suy đoán, không dùng static list ở đây (đó là việc của rule 20).
5. Nếu network không khả dụng, rule này KHÔNG chạy (không có gì để flag) — rule 20 vẫn chạy độc lập làm fallback offline.
6. Nếu cùng package/version match cả rule này và rule 20, chỉ giữ finding của rule này (data chính xác hơn), bỏ finding trùng của rule 20.
## Search patterns (illustrative — KHÔNG phải lệnh chạy literal)
```bash
# Ví dụ minh họa 1 batch query — chi tiết đầy đủ ở dependency-scan.md
curl -s -X POST https://api.osv.dev/v1/querybatch -H "Content-Type: application/json" -d '{
"queries": [{"package": {"name": "<pkg>", "ecosystem": "<NuGet|Go|npm|Packagist|PyPI|Pub>"}, "version": "<version>"}]
}'
```
## Examples
### HIGH — flag
```json
// composer.lock — guzzlehttp/guzzle 7.4.1, OSV xác nhận GHSA (CVE-2022-31091, CVSS 7.5)
{
"name": "guzzlehttp/guzzle",
"version": "7.4.1"
}
```
→ OSV trả `database_specific.severity: "HIGH"`, `fixed: "7.4.5"`, `aliases: ["CVE-2022-31091"]` → finding HIGH (`severity_source: "osv"`), fix = nâng lên `7.4.5`.
### NOT critical — không flag
```json
{
"name": "guzzlehttp/guzzle",
"version": "7.4.5"
}
```
→ OSV không trả vuln nào cho version này → không flag (đưa vào PASSED list nếu package này là dependency chính được scan).
## Fix recommendation
1. Nâng version package lên đúng `fixed_version` OSV trả về (không phải "latest" — có thể latest đã có breaking change không cần thiết):
```bash
# NuGet
dotnet add package <PackageName> --version <fixed_version>
# npm
npm install <package>@<fixed_version>
# Go
go get <module>@<fixed_version> && go mod tidy
# Composer
composer require <vendor/package>:<fixed_version>
# pip
pip install <package>==<fixed_version>
# Pub (Dart / Flutter)
flutter pub add <package>:^<fixed_version> # hoặc dart pub add; nâng cả ràng buộc trong pubspec.yaml
```
2. Sau khi bump version, chạy lại restore/install (`dotnet restore`, `npm install`, `go build ./...`, `composer update`, `pip install -r requirements.txt`, `flutter pub get`) để lockfile khớp.
3. Nếu dùng `--auto-fix` cùng lúc, xem [`../../workflows/auto-fix.md`](../../workflows/auto-fix.md) Bước 3, mục "Patch sửa dependency": Go/dotnet chỉ được bump khi có `--run-tests` và test của project pass trên version mới; npm/Composer/PyPI/Pub chỉ có gợi ý patch (`suggested_only`).
4. Nếu không thể upgrade ngay (breaking change lớn), note rõ risk acceptance trong PR + theo dõi lại ở lần scan sau.
## Cross-references
- `20-outdated-dependency`: fallback offline/static list khi không có `--sca` hoặc network không khả dụng. Không double-report cùng 1 package/version ở cả 2 rule.
- `01-hardcoded-secret`: một số CVE liên quan tới leak secret qua dependency (vd package độc hại exfiltrate env vars).
- OWASP: [A06:2021 – Vulnerable and Outdated Components](https://owasp.org/Top10/A06_2021-Vulnerable_and_Outdated_Components/)
- CWE: CWE-1104 (Use of Unmaintained Third Party Components)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |