Skip to content

tanviet12/vbsec / skills/codex/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.8 KB
VERSIONother6 B
agents/openai.yamlconfig313 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.9 KB
workflows/small-review.mdmarkdown10.1 KB

rules/generic/09-ssrf.md

View on GitHub
---
id: SSRF
severity_max: HIGH
applies_to: all
---

# Server-Side Request Forgery (SSRF)

## Intent

Server gửi HTTP request đến URL do user nhập (L1). Attacker chỉ định URL kiểu `http://169.254.169.254/latest/meta-data/iam/security-credentials/` để **đọc credential AWS IAM**, hoặc `http://localhost:8080/admin`, `http://internal-db:5432`, `file:///etc/passwd`, `gopher://...` để **đánh vào dịch vụ nội bộ, đọc file local, port-scan VPC, leo lên RCE**.

Feature thường dính: webhook callback, image preview/proxy, RSS reader, OAuth callback verify, "import từ URL", screenshot service, link unfurl.

## Khi nào HIGH

- Endpoint gọi `fetch / axios / requests / curl / file_get_contents / HttpClient` với URL từ L1 mà KHÔNG validate host
- App chạy trên cloud (AWS/GCP/Azure) — có metadata service tấn công được
- App có dịch vụ nội bộ không yêu cầu auth (admin panel, Redis, Elasticsearch trên localhost)

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

- Có validate scheme `http/https` nhưng không chặn IP nội bộ
- App chạy hoàn toàn isolated (no cloud metadata, không có service nội bộ)
- Response không trả về cho user (blind SSRF) — khó exploit hơn nhưng vẫn nguy hiểm (DNS rebinding, port scan timing)

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

1. **Grep** các HTTP client call (xem dưới)
2. **Read** function: URL truyền vào đến từ đâu?
3. **Trace** L1-L4:
   - URL từ `req.body.url`, `req.query.url`, `req.params.callback` → L1 → cần validate
   - URL từ DB nhưng user-controlled (vd: `user.webhook_url` set lúc đăng ký) → L1 stored
   - URL hardcoded → L3, safe
4. **Verify validation**:
   - Có check scheme (chỉ allow `https:`) không?
   - Có resolve DNS rồi check IP không nằm trong: `127.0.0.0/8`, `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`, `169.254.0.0/16`, `::1`, `fc00::/7`?
   - Có allowlist domain không?
   - Có check redirect (302 → internal) không?
5. Chú ý DNS rebinding: lúc validate trả IP public, lúc fetch DNS trả lại 127.0.0.1.

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

### JavaScript / Node

```
fetch\s*\(\s*req\.
fetch\s*\(\s*[a-zA-Z_]+\.url
axios\.(get|post|put|delete|request)\s*\(\s*req\.
axios\.(get|post|put|delete|request)\s*\(\s*[a-zA-Z_]+\.url
http\.request\s*\(\s*\{?\s*host
got\s*\(\s*req\.
```

### Python

```
requests\.(get|post|put|delete|request)\s*\(\s*[a-zA-Z_]+\s*[,)]
urllib\.request\.urlopen\s*\(
urlopen\s*\(
httpx\.(get|post|client)
aiohttp\.ClientSession.*\.get
```

### PHP

```
file_get_contents\s*\(\s*\$
curl_setopt\s*\(.*CURLOPT_URL\s*,\s*\$
fopen\s*\(\s*\$[a-zA-Z_]+\s*,
```

### Go / Java

```
http\.Get\s*\(
http\.Post\s*\(
http\.NewRequest\s*\(
HttpClient.*\.GetAsync                       # .NET
new URL\s*\(                                 # Java
```

### Suspicious schemes / hosts

```
file://|gopher://|dict://|ftp://|ldap://    # phải block
169\.254\.169\.254                           # AWS metadata
metadata\.google\.internal                   # GCP metadata
127\.0\.0\.1|localhost|0\.0\.0\.0
```

## Examples

### HIGH — flag

```javascript
// Express — webhook fetch không validate
app.post("/api/webhook/test", async (req, res) => {
  const r = await fetch(req.body.url);   // L1 → SSRF
  res.json({ status: r.status, body: await r.text() });
});
// Attacker: { "url": "http://169.254.169.254/latest/meta-data/iam/security-credentials/admin-role" }
```

```python
# Flask — image proxy không validate host
@app.route("/proxy-image")
def proxy_image():
    url = request.args.get("url")   # L1
    r = requests.get(url)
    return r.content, 200, {"Content-Type": r.headers["Content-Type"]}
```

```php
<?php
// PDF generator — fetch URL từ user
$html = file_get_contents($_POST['url']);   // L1
echo render_pdf($html);
```

```javascript
// OAuth callback verify
app.post("/oauth/verify", async (req, res) => {
  const tokenInfo = await axios.get(req.body.introspect_url);   // attacker control URL
});
```

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

```javascript
// Allowlist domain
const ALLOWED = ["images.unsplash.com", "cdn.example.com"];
app.get("/proxy", async (req, res) => {
  const u = new URL(req.query.url);
  if (!ALLOWED.includes(u.hostname)) return res.status(400).end();
  if (u.protocol !== "https:") return res.status(400).end();
  const r = await fetch(u);
  res.set("Content-Type", r.headers.get("content-type"));
  r.body.pipe(res);
});
```

```python
# Validate host + IP
import ipaddress, socket
from urllib.parse import urlparse

BLOCKED_NETS = [
    ipaddress.ip_network("127.0.0.0/8"),
    ipaddress.ip_network("10.0.0.0/8"),
    ipaddress.ip_network("172.16.0.0/12"),
    ipaddress.ip_network("192.168.0.0/16"),
    ipaddress.ip_network("169.254.0.0/16"),
]

def safe_url(url: str) -> bool:
    u = urlparse(url)
    if u.scheme not in {"http", "https"}: return False
    ip = ipaddress.ip_address(socket.gethostbyname(u.hostname))
    return not any(ip in net for net in BLOCKED_NETS)
```

```javascript
// URL hardcoded — L3, OK
await fetch("https://api.stripe.com/v1/charges", { ... });
```

## Fix recommendation

1. **Allowlist domain** — phương pháp mạnh nhất nếu biết trước domain hợp lệ:
   ```javascript
   const ALLOWED_HOSTS = ["api.partner.com", "webhook.example.io"];
   const u = new URL(userUrl);
   if (!ALLOWED_HOSTS.includes(u.hostname)) throw new Error("blocked");
   ```
2. **Validate scheme**: chỉ `http:` và `https:`. Cấm `file:`, `gopher:`, `dict:`, `ldap:`, `ftp:`.
3. **Resolve DNS → check IP không phải private/loopback/link-local**:
   ```python
   import socket, ipaddress
   ip = ipaddress.ip_address(socket.gethostbyname(host))
   if ip.is_private or ip.is_loopback or ip.is_link_local or ip.is_reserved:
       raise SSRFError()
   ```
4. **Chặn redirect** hoặc validate lại URL ở mỗi redirect:
   ```javascript
   fetch(url, { redirect: "manual" });
   ```
5. **Dùng outbound proxy**: cho service chạy qua proxy chỉ allow domain bên ngoài, chặn 127.0.0.1, 169.254.169.254, RFC1918 ranges.
6. **AWS metadata**: bật IMDSv2 (yêu cầu token) — IMDSv1 SSRF trivial:
   ```bash
   aws ec2 modify-instance-metadata-options --http-tokens required ...
   ```
7. **Network policy**: dùng VPC security group / k8s NetworkPolicy chặn outbound đến internal subnet từ service web.

## Cross-references

- Rule `01-hardcoded-secret`: SSRF lấy được IAM role → exfil credentials còn nguy hiểm hơn hardcoded secret
- Rule `10-path-traversal`: cùng họ "URL/file path từ user" — file:// SSRF gần với path traversal
- Rule `17-verbose-error-debug-mode`: error response chứa nội dung fetch → SSRF exfil
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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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