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

rules/generic/10-path-traversal.md

View on GitHub
---
id: PATH-TRAVERSAL
severity_max: HIGH
applies_to: all
---

# Path Traversal

## Intent

Code thao tác file với path chứa user input (L1). Attacker truyền `../../../../etc/passwd`, `..\\..\\Windows\\System32\\drivers\\etc\\hosts`, hoặc absolute path `/etc/shadow` để **đọc file hệ thống, ghi đè config, leak source code, đọc `.env`, đọc private key SSH** — từ đó lateral move hoặc chiếm server.

Vibe code dính khi AI sinh code "download/preview file theo tên" mà ghép tên trực tiếp vào path.

## Khi nào HIGH

- L1 input đi vào file API: `open`, `fs.readFile`, `fs.createReadStream`, `file_get_contents`, `fopen`, `os.path.join`, `Path()` mà KHÔNG normalize + check prefix
- Endpoint trả về nội dung file (đọc) hoặc cho phép upload/ghi file với tên user-supplied
- Có thể đọc file ngoài thư mục được phép

## Khi nào MEDIUM (giảm cấp)

- Có chmod chặn ở mức OS (user app chỉ đọc được 1 dir) — vẫn nên có check ở app
- Filename đã được validate regex chặt (`^[a-zA-Z0-9_-]+\.(jpg|png)$`)
- Endpoint require admin

## Cách reasoning (KHÔNG pattern-match thuần)

1. **Grep** các file API (xem dưới)
2. **Read** function: path xây từ đâu, ghép như nào?
3. **Trace** L1-L4:
   - `req.query.filename`, `req.params.path`, `request.args["file"]`, form upload `filename` → L1
   - Database stored filename (do user upload trước đó) → L1 stored (có thể là `../../`)
4. **Verify mitigation**:
   - Có `path.resolve()` / `os.path.realpath()` rồi check `startsWith(baseDir)` không?
   - Có check `..` / null byte / encoded `%2e%2e%2f` không?
   - Có whitelist filename regex không?
5. Trên Windows chú ý: `\\`, `C:\`, `\\?\` prefix, alternate stream `file.txt:hidden`.

## Search patterns (gợi ý — KHÔNG chạy literal, dùng Grep tool)

### JS/Node

```
fs\.(readFile|readFileSync|createReadStream|writeFile|unlink)\s*\(\s*[^"'`]
path\.join\s*\(\s*[^"'`,]+,\s*req\.
res\.sendFile\s*\(\s*[^"']*req\.
res\.download\s*\(\s*[^"']*req\.
express\.static\s*\(\s*req\.
```

### Python

```
open\s*\(\s*[^"']+(\+|f["']|%|format)
open\s*\(\s*request\.
send_file\s*\(\s*request\.
os\.path\.join\s*\([^)]*request\.
pathlib\.Path\s*\(\s*request\.
```

### PHP

```
file_get_contents\s*\(\s*\$_(GET|POST|REQUEST)
fopen\s*\(\s*\$_(GET|POST|REQUEST)
readfile\s*\(\s*\$_(GET|POST|REQUEST)
include\s*\(\s*\$_(GET|POST|REQUEST)        # cực nguy hiểm — LFI → RCE
require\s*\(\s*\$_(GET|POST|REQUEST)
```

### Encoded payloads (regression test)

```
\.\./|\.\.\\
%2e%2e%2f|%2e%2e/|%252e
\\x00|%00                                    # null byte
```

## Examples

### HIGH — flag

```javascript
// Express — đọc file theo tên user nhập
app.get("/download", (req, res) => {
  const file = path.join("/var/uploads", req.query.name);   // L1
  res.sendFile(file);
});
// Attacker: GET /download?name=../../etc/passwd
```

```python
# Flask
@app.route("/read")
def read():
    filename = request.args.get("f")        # L1
    with open(f"./data/{filename}") as fp:  # ../../etc/passwd
        return fp.read()
```

```php
<?php
// LFI cổ điển → có thể RCE qua log poisoning
$page = $_GET['page'];
include("./pages/" . $page . ".php");   // ?page=../../../../var/log/apache2/access
```

```javascript
// Static file với prefix user
app.use("/static", express.static(req.query.dir));   // !!! cực nguy hiểm
```

```python
# Lưu file upload với tên gốc
@app.route("/upload", methods=["POST"])
def upload():
    f = request.files["file"]
    f.save(f"./uploads/{f.filename}")   # filename có thể là "../../etc/cron.d/x"
```

### NOT high — không flag (hoặc downgrade)

```javascript
// Resolve + check prefix
const safeJoin = (base, userPath) => {
  const target = path.resolve(base, userPath);
  if (!target.startsWith(path.resolve(base) + path.sep)) {
    throw new Error("Path traversal");
  }
  return target;
};
app.get("/download", (req, res) => {
  try {
    const file = safeJoin("/var/uploads", req.query.name);
    res.sendFile(file);
  } catch {
    res.status(400).end();
  }
});
```

```python
# Whitelist regex + basename
import re, os
PATTERN = re.compile(r"^[a-zA-Z0-9_-]+\.(pdf|png|jpg)$")
@app.route("/read")
def read():
    fn = request.args["f"]
    if not PATTERN.match(fn):
        abort(400)
    full = os.path.realpath(os.path.join("./data", fn))
    if not full.startswith(os.path.realpath("./data") + os.sep):
        abort(400)
    return open(full).read()
```

```python
# Lưu upload với UUID, KHÔNG dùng filename gốc
import uuid
ext = os.path.splitext(f.filename)[1].lower()
if ext not in {".png", ".jpg"}: abort(400)
new_name = f"{uuid.uuid4()}{ext}"
f.save(f"./uploads/{new_name}")
```

## Fix recommendation

1. **Normalize + check prefix**:
   ```javascript
   const base = path.resolve("/var/uploads");
   const target = path.resolve(base, userPath);
   if (!target.startsWith(base + path.sep)) throw new Error("traversal");
   ```
   Python:
   ```python
   import os
   base = os.path.realpath("./data")
   target = os.path.realpath(os.path.join(base, user_path))
   if not target.startswith(base + os.sep):
       raise ValueError("traversal")
   ```
2. **Whitelist filename regex**:
   ```python
   import re
   if not re.fullmatch(r"[a-zA-Z0-9_-]+\.(png|jpg|pdf)", filename):
       abort(400)
   ```
3. **Upload**: KHÔNG giữ tên file gốc — đổi sang UUID. Lưu metadata `original_name` riêng trong DB.
4. **Block null byte + encoded `..`**: hầu hết framework đã handle, nhưng nên decode + check một lần:
   ```python
   from urllib.parse import unquote
   decoded = unquote(filename)
   if ".." in decoded or "\0" in decoded:
       abort(400)
   ```
5. **OS-level**: chạy app dưới user ít quyền, chroot/jail, container readonly FS với volume mount cụ thể.
6. **PHP LFI**: KHÔNG bao giờ `include`/`require` với input L1. Dùng dispatcher whitelist:
   ```php
   $pages = ['home','about','contact'];
   $page = in_array($_GET['page'] ?? '', $pages) ? $_GET['page'] : 'home';
   include "./pages/{$page}.php";
   ```

## Cross-references

- Rule `09-ssrf`: `file://` scheme — SSRF có thể đọc file giống path traversal
- Rule `01-hardcoded-secret`: path traversal đọc `.env` → leak secret
- Rule `17-verbose-error-debug-mode`: error "ENOENT: /etc/passwd" confirm exploit thành công
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