Skip to content

tanviet12/vbsec / skills/antigravity/vbs-scan-security

vbs-scan-security

Flagged

Use 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).

FileKindSize
SKILL.mdskill md28.2 KB
VERSIONother6 B
references/chunking-strategy.mdmarkdown7.2 KB
references/data-flow-classification.mdmarkdown9.5 KB
references/dependency-scan.mdmarkdown9.7 KB
references/i18n/en.mdmarkdown8.7 KB
references/i18n/vi.mdmarkdown9.4 KB
references/language-detection.mdmarkdown7.5 KB
references/load-rules.shexecutablescript5.2 KB
references/output-format.mdmarkdown26.1 KB
references/project-context.mdmarkdown2.7 KB
references/sub-agent-prompts.mdmarkdown16.5 KB
references/validate-report.pyexecutablescript8.7 KB
rules/generic/01-hardcoded-secret.mdmarkdown5.4 KB
rules/generic/02-sql-injection.mdmarkdown5.2 KB
rules/generic/03-xss.mdmarkdown4.9 KB
rules/generic/04-idor.mdmarkdown5.7 KB
rules/generic/05-slopsquatting.mdmarkdown6.1 KB
rules/generic/06-brute-force.mdmarkdown6.9 KB
rules/generic/07-mass-assignment.mdmarkdown6.3 KB
rules/generic/08-insecure-deserialization.mdmarkdown6.3 KB
rules/generic/09-ssrf.mdmarkdown6.7 KB
rules/generic/10-path-traversal.mdmarkdown6.3 KB
rules/generic/11-csrf.mdmarkdown7.8 KB
rules/generic/12-broken-access-control.mdmarkdown7.9 KB
rules/generic/13-weak-password-hashing.mdmarkdown5.2 KB
rules/generic/14-jwt-none-algorithm.mdmarkdown5.3 KB
rules/generic/15-cors-misconfig.mdmarkdown5.3 KB
rules/generic/16-unrestricted-file-upload.mdmarkdown5.9 KB
rules/generic/17-verbose-error-debug-mode.mdmarkdown5.8 KB
rules/generic/18-missing-rate-limit.mdmarkdown10.7 KB
rules/generic/19-race-condition.mdmarkdown11.5 KB
rules/generic/20-outdated-dependency.mdmarkdown7.2 KB
rules/generic/21-command-injection.mdmarkdown6.6 KB
rules/generic/22-vulnerable-dependency.mdmarkdown5.3 KB
rules/generic/23-llm-prompt-injection.mdmarkdown9.7 KB
rules/generic/24-excessive-agency.mdmarkdown10.1 KB
rules/generic/25-tenant-isolation.mdmarkdown10.1 KB
rules/generic/26-authz-path-parity.mdmarkdown10.9 KB
rules/generic/27-excessive-data-exposure.mdmarkdown10.4 KB
rules/generic/28-business-state-integrity.mdmarkdown9.5 KB
rules/generic/29-sensitive-data-in-logs.mdmarkdown9.1 KB
rules/generic/30-auth-session-lifecycle.mdmarkdown9.4 KB
rules/generic/31-resource-exhaustion.mdmarkdown9.0 KB
rules/languages/README.mdmarkdown8.5 KB
rules/languages/dart/01-hardcoded-secret.mdmarkdown7.9 KB
rules/languages/dart/03-xss.mdmarkdown5.2 KB
rules/languages/dart/05-slopsquatting.mdmarkdown4.6 KB
rules/languages/dart/10-path-traversal.mdmarkdown6.3 KB
rules/languages/dart/12-broken-access-control.mdmarkdown8.3 KB
rules/languages/dart/17-verbose-error-debug-mode.mdmarkdown6.7 KB
rules/languages/dart/20-outdated-dependency.mdmarkdown4.7 KB
rules/languages/dart/README.mdmarkdown3.7 KB
rules/languages/dotnet/02-sql-injection.mdmarkdown5.7 KB
rules/languages/dotnet/07-mass-assignment.mdmarkdown6.0 KB
rules/languages/dotnet/08-insecure-deserialization.mdmarkdown5.7 KB
rules/languages/dotnet/17-verbose-error-debug-mode.mdmarkdown5.0 KB
rules/languages/dotnet/21-command-injection.mdmarkdown5.3 KB
rules/languages/dotnet/README.mdmarkdown1.7 KB
rules/languages/go/02-sql-injection.mdmarkdown5.2 KB
rules/languages/go/08-insecure-deserialization.mdmarkdown5.0 KB
rules/languages/go/09-ssrf.mdmarkdown5.8 KB
rules/languages/go/17-verbose-error-debug-mode.mdmarkdown6.1 KB
rules/languages/go/21-command-injection.mdmarkdown5.2 KB
rules/languages/go/README.mdmarkdown2.7 KB
rules/languages/php/02-sql-injection.mdmarkdown5.8 KB
rules/languages/php/08-insecure-deserialization.mdmarkdown6.2 KB
rules/languages/php/11-csrf.mdmarkdown6.2 KB
rules/languages/php/17-verbose-error-debug-mode.mdmarkdown6.5 KB
rules/languages/php/21-command-injection.mdmarkdown6.7 KB
rules/languages/php/README.mdmarkdown2.9 KB
rules/languages/python/02-sql-injection.mdmarkdown7.2 KB
rules/languages/python/07-mass-assignment.mdmarkdown7.3 KB
rules/languages/python/08-insecure-deserialization.mdmarkdown7.3 KB
rules/languages/python/09-ssrf.mdmarkdown7.5 KB
rules/languages/python/11-csrf.mdmarkdown7.6 KB
rules/languages/python/14-jwt-none-algorithm.mdmarkdown7.5 KB
rules/languages/python/15-cors-misconfig.mdmarkdown8.0 KB
rules/languages/python/17-verbose-error-debug-mode.mdmarkdown8.4 KB
rules/languages/python/21-command-injection.mdmarkdown8.5 KB
rules/languages/python/README.mdmarkdown3.4 KB
rules/languages/typescript/02-sql-injection.mdmarkdown7.5 KB
rules/languages/typescript/03-xss.mdmarkdown6.7 KB
rules/languages/typescript/07-mass-assignment.mdmarkdown7.4 KB
rules/languages/typescript/08-insecure-deserialization.mdmarkdown7.0 KB
rules/languages/typescript/09-ssrf.mdmarkdown7.5 KB
rules/languages/typescript/11-csrf.mdmarkdown7.3 KB
rules/languages/typescript/14-jwt-none-algorithm.mdmarkdown7.0 KB
rules/languages/typescript/15-cors-misconfig.mdmarkdown7.2 KB
rules/languages/typescript/17-verbose-error-debug-mode.mdmarkdown7.2 KB
rules/languages/typescript/21-command-injection.mdmarkdown6.7 KB
rules/languages/typescript/README.mdmarkdown3.3 KB
workflows/auto-fix.mdmarkdown18.9 KB
workflows/large-review-sequential.mdmarkdown14.8 KB
workflows/small-review.mdmarkdown10.1 KB

references/dependency-scan.md

View on GitHub
# Dependency Scan — Live SCA via OSV.dev (`--sca`)

Hướng dẫn parse dependency manifest và tra cứu CVE live qua [OSV.dev](https://osv.dev) API cho rule [`22-vulnerable-dependency`](../rules/generic/22-vulnerable-dependency.md).

> Được gọi từ [`../SKILL.md`](../SKILL.md) **Step 4b** khi user truyền flag `--sca`. Chạy sau khi Step 2 đã detect `$PRIMARY_LANG` (và multi-lang nếu có).
>
> **Đây là 1 trong 2 chỗ duy nhất trong skill được phép gọi network** (chỗ còn lại là `gh pr diff` cho scope `pr id`). Mọi request là read-only GET/POST tới `api.osv.dev`, không gửi code hay nội dung file đi — chỉ gửi package name + version.

## Bước 1 — Đọc manifest theo ecosystem

vbsec hiện chuyên sâu 6 ngôn ngữ — mỗi ngôn ngữ map sang đúng 1 [OSV ecosystem name](https://ossf.github.io/osv-schema/#affectedpackage-field):

| Lang (vbsec) | OSV ecosystem | Manifest/lockfile đọc | Cách trích PackageId + Version (illustrative) |
|---|---|---|---|
| `dotnet` | `NuGet` | `*.csproj` (`<PackageReference Include="X" Version="Y" />`), `Directory.Packages.props` (Central Package Management: `<PackageVersion Include="X" Version="Y" />`; `.csproj` khi đó chỉ có `<PackageReference Include="X" />`, hoặc `VersionOverride="Y"` để ghi đè), `packages.lock.json` | Regex `Include="([^"]+)"\s+Version="([^"]+)"` trong `.csproj`; hoặc field `resolved` trong `packages.lock.json` (chính xác hơn — version đã resolve) |
| `go` | `Go` | `go.mod` (`require X vY`) | Mỗi dòng trong block `require (...)` hoặc `require X vY` đơn dòng |
| `typescript` | `npm` | `package-lock.json` (lockfile v2/v3, object `packages`) | Ưu tiên `package-lock.json` hơn `package.json` — có version đã resolve thật, không phải range (`^1.2.3`). Walk `packages["node_modules/<name>"].version` |
| `php` | `Packagist` | `composer.lock` (`packages[].name` + `.version`) | JSON parse trực tiếp — `composer.lock` luôn có version cụ thể |
| `python` | `PyPI` | `requirements.txt` (`pkg==version`), `poetry.lock`, `Pipfile.lock` | `requirements.txt`: split theo `==` (bỏ qua dòng dùng `>=`/`~=` — không có version cụ thể để query); `poetry.lock`/`Pipfile.lock`: parse TOML/JSON lấy `name` + `version` |
| `dart` | `Pub` | `pubspec.lock` (map `packages:`, mỗi key là tên package) | Chỉ lấy package có `source: hosted` và `description.url` là `https://pub.dev` (hoặc `https://pub.dartlang.org`): tên = key, version = field `version`. Bỏ `source: sdk` (`flutter`, `flutter_test`...), `path`, `git`, và hosted server riêng (không có trên OSV). Không có `pubspec.lock` (package thư viện thường không commit lock) → không query, chỉ `pubspec.yaml` có range `^1.2.3` |

**Nguyên tắc đọc:** Dùng Read tool, KHÔNG chạy lệnh `jq`/parser thật — đây là illustrative pattern, agent tự parse bằng reasoning giống cách đọc code khác. Nếu 1 repo có nhiều manifest cùng ecosystem (vd nhiều `.csproj` trong monorepo), gộp tất cả package tìm được, dedup theo `(name, version)`.

Nếu không tìm thấy manifest nào cho `$PRIMARY_LANG` (hoặc bất kỳ lang nào trong multi-lang repo) → note `{msg_sca_no_manifest}`, skip ecosystem đó, không lỗi toàn bộ scan.

## Bước 2 — Query OSV.dev (batch)

### 2a. Batch query lấy vuln IDs

```bash
curl -s -X POST https://api.osv.dev/v1/querybatch \
  -H "Content-Type: application/json" \
  -d '{
    "queries": [
      {"package": {"name": "Newtonsoft.Json", "ecosystem": "NuGet"}, "version": "12.0.1"},
      {"package": {"name": "lodash", "ecosystem": "npm"}, "version": "4.17.20"}
    ]
  }'
```

Response mỗi query trả về **chỉ ID** (không có severity/fixed-version):

```json
{"results": [{"vulns": [{"id": "GHSA-5crp-9r3c-p9vr"}]}, {"vulns": [{"id": "GHSA-29mw-wpgm-hmr9"}]}]}
```

Batch theo nhóm ~500 package/lần gọi (giới hạn thực tế cho payload hợp lý — với repo thường <500 dependency, 1 lần gọi là đủ).

### 2b. Lấy chi tiết từng vuln ID (dedup trước khi gọi)

```bash
curl -s https://api.osv.dev/v1/vulns/GHSA-5crp-9r3c-p9vr
```

Trích từ response:
- `aliases[]` — tìm entry dạng `CVE-YYYY-NNNNN` → dùng làm `cve_id` (nếu không có alias CVE nào, dùng chính OSV id làm `cve_id` fallback)
- `database_specific.severity` (string `CRITICAL`/`HIGH`/`MODERATE`/`LOW`, có ở bản ghi GHSA) — nguồn chính để xác định severity, xem Bước 3
- `severity[].score` — chuỗi CVSS vector (vd `CVSS:3.1/AV:N/...`), KHÔNG phải điểm số. Chỉ xuất ra làm `cvss_vector`, không dùng để tính severity
- `affected[].ranges[].events[]` — tìm event có `"fixed": "<version>"` → dùng làm `fixed_version` (lấy version fixed nhỏ nhất lớn hơn version đang dùng, nếu có nhiều range)
- `summary` — 1 dòng mô tả, dùng cho `issue_summary`

### 2c. Graceful degradation (BẮT BUỘC)

Nếu `curl` không có sẵn, network timeout, DNS fail, hoặc response không phải JSON hợp lệ:
1. In `{msg_sca_unavailable}` vào report (1 dòng, không phải lỗi block scan).
2. Fallback: dùng static list trong [`../rules/generic/20-outdated-dependency.md`](../rules/generic/20-outdated-dependency.md) — rule đó vẫn chạy độc lập, không phụ thuộc `--sca`.
3. KHÔNG retry network call nhiều lần (1 lần thử là đủ, tránh treo scan vì mạng chậm).

## Bước 3 — Xác định severity

KHÔNG tự tính base score từ CVSS vector. `severity[].score` của OSV là chuỗi vector (vd `CVSS:3.1/AV:N/AC:L/...`), không phải điểm số; tự tính điểm từ vector rất dễ sai. Severity lấy theo thứ tự ưu tiên sau, dừng ở bước đầu tiên có kết quả:

| # | Nguồn | `severity_source` |
|---|---|---|
| 1 | `database_specific.severity` của chính vuln (có sẵn ở bản ghi GHSA) | `"osv"` |
| 2 | Vuln không có (bản ghi `GO-*`, `PYSEC-*`...) nhưng `aliases[]` có id `GHSA-*` → `GET /v1/vulns/<GHSA-id>` (dedup như Bước 2b), lấy `database_specific.severity` của bản ghi GHSA đó | `"ghsa_alias"` |
| 3 | Không có nguồn nào ở trên | `"default"` → severity `MEDIUM`, ghi "OSV không có severity, mặc định MEDIUM" trong `issue_summary` |

Map giá trị string sang severity vbsec:

| `database_specific.severity` | Severity |
|---|---|
| `CRITICAL` | CRITICAL |
| `HIGH` | HIGH |
| `MODERATE` / `MEDIUM` | MEDIUM |
| `LOW` | LOW |

**`cvss_vector`:** nếu vuln (hoặc bản ghi GHSA alias ở nguồn 2) có `severity[]`, xuất nguyên chuỗi `score` làm `cvss_vector` để người dùng/CI tự tra cứu. Ưu tiên `type: CVSS_V3`, rồi `CVSS_V4`, rồi `CVSS_V2`. `cvss_vector` chỉ để tham khảo, KHÔNG dùng để suy ra severity.

Severity cuối cùng vẫn bị cap bởi `severity_max: CRITICAL` của rule 22 (xem rule file) — nhưng vì cap đã là CRITICAL, mapping trên áp dụng nguyên vẹn.

## Bước 4 — Tạo finding

Với mỗi `(package, version)` có ≥1 vuln xác nhận từ OSV:

```
rule_id: VULNERABLE-DEPENDENCY
file: <đường dẫn manifest, vd api/pkg.csproj>
line: <dòng chứa PackageReference/dependency đó trong manifest>
severity: <xác định ở Bước 3>
issue_summary: "<package>@<installed_version> có <cve_id> (<summary ngắn>)"
fix_summary: "Nâng cấp lên <fixed_version>"
# Fields riêng cho JSON canonical (xem output-format.md):
cve_id, osv_id, package, ecosystem, installed_version, fixed_version, severity_source, cvss_vector (nếu có)
```

Nếu 1 package có nhiều lỗ hổng khác nhau → tạo nhiều finding riêng (đúng nguyên tắc "1 finding = 1 rule_id" đã áp dụng cho toàn skill, mỗi lỗ hổng là 1 finding dù cùng `rule_id: VULNERABLE-DEPENDENCY`).

**Gộp alias trước khi tạo finding (BẮT BUỘC):** OSV thường trả cùng 1 lỗ hổng dưới nhiều id cho cùng package (vd `GO-2023-2102` và `GHSA-4374-p667-p6c8`, hoặc `PYSEC-*` và `GHSA-*`). Hai vuln id được coi là 1 lỗ hổng nếu có chung `cve_id`, hoặc id này nằm trong `aliases[]` của id kia. Mỗi nhóm chỉ tạo 1 finding, giữ bản ghi có `severity_source` tốt nhất (`osv` > `ghsa_alias` > `default`). Không gộp thì report bị đếm trùng: thử trên repo mẫu 7 package, OSV trả 59 vuln id nhưng chỉ có 43 lỗ hổng thật.

**Ưu tiên rule 22 hơn rule 20:** nếu cùng 1 package/version vừa nằm trong static list của rule 20 VÀ được OSV live xác nhận, chỉ tạo finding rule 22 (bỏ finding rule 20 trùng) — rule 22 có data chính xác hơn (fixed_version thật từ OSV thay vì static list có thể lỗi thời).

## Bước 5 — Enrich JSON canonical

Thêm block top-level vào JSON summary cuối report (xem chi tiết field ở [`output-format.md`](output-format.md) mục 7):

```json
"dependencies_scanned": {
  "total": 47,
  "ecosystems": ["NuGet", "npm"],
  "vulnerable_count": 3,
  "scan_source": "osv.dev live"
}
```

`scan_source` = `"static list (offline)"` nếu Bước 2c fallback xảy ra (network unavailable).

## Cross-references

- [`../rules/generic/22-vulnerable-dependency.md`](../rules/generic/22-vulnerable-dependency.md) — rule chính dùng data từ file này
- [`../rules/generic/20-outdated-dependency.md`](../rules/generic/20-outdated-dependency.md) — fallback offline, cross-check tránh double-report
- [`../workflows/auto-fix.md`](../workflows/auto-fix.md) — khi kết hợp `--sca --auto-fix`, finding `VULNERABLE-DEPENDENCY` của Go/dotnet được bump version, build và chạy test của project, chỉ giữ khi test pass (có snapshot để khôi phục khi fail); npm/Composer/PyPI/Pub chỉ có gợi ý patch (`suggested_only`)
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall