Skip to content

tanviet12/vbsec / skills/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`. Auto-delegates to sub-agents for large scans (>20 main-language files OR >30 total OR >14 days). Outputs bilingual reports (vi/en). Optional `--auto-fix` (agentic patch + verify loop) and `--sca` (live CVE lookup via OSV.dev).

FileKindSize
SKILL.mdskill md36.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.mdmarkdown10.5 KB
workflows/small-review.mdmarkdown10.1 KB

rules/languages/go/17-verbose-error-debug-mode.md

View on GitHub
---
id: VERBOSE-ERROR-DEBUG-MODE
severity_max: HIGH
applies_to: go
---

# Verbose Error / Debug Mode (Go)

## Intent

Trong Go web framework, **debug mode để bật** trong production sẽ trả về stack trace, SQL query, env var, route map cho client. Attacker recon nhanh, tìm DB schema (qua GORM error), tìm internal IP / service name, leak secret nằm trong panic message.

Cụ thể:
- `gin.SetMode(gin.DebugMode)` hoặc thiếu `gin.SetMode(gin.ReleaseMode)` → in route map + debug log lúc start, panic dump full stack vào response nếu dùng `gin.Recovery()` cũ.
- `fiber.Config{Debug: true}` → tương tự, in stack trace.
- `c.String(500, err.Error())` hoặc `c.JSON(500, gin.H{"error": err.Error()})` — leak nguyên message gốc (vd: GORM trả về full SQL, file path).
- `slog.SetDefault(slog.New(slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelDebug, AddSource: true})))` chạy production → log file:line lộ ra qua log aggregator hoặc qua `/debug/pprof`.
- `net/http/pprof` import side-effect: `_ "net/http/pprof"` đăng ký `/debug/pprof/*` lên `http.DefaultServeMux`. Public exposure = giveaway full goroutine / heap / cpu profile.

## Khi nào HIGH

- `gin.DebugMode` (default nếu không set ReleaseMode) trong build production
- `fiber.Config{Debug: true}` trong prod
- Error message gốc trả về user qua HTTP response trong handler production
- `net/http/pprof` import được nhưng route không có middleware auth

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

- Debug bật nhưng route bị firewall / VPN gate
- Error trả về sau khi đã `errors.New("internal error")` (đã wrap, nhưng vẫn log raw — leak qua log)
- slog level Info nhưng có `AddSource: true` — leak code path trong log (không phải response)

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

1. **Grep** debug switches: `gin.DebugMode`, `gin.SetMode`, `fiber.Config`, `echo.Debug`, `pprof`, `slog.LevelDebug`
2. **Read** entry point (`main.go`, `cmd/server/main.go`) xem mode set thế nào, có check `os.Getenv("ENV")` không
3. **Trace** error handler:
   - Có middleware central handle error?
   - Trong handler, `err.Error()` có bị return về client raw không?
   - GORM error có sanitize không?
4. **Verify**:
   - `os.Getenv("GIN_MODE")` = "release"? Hoặc code có `if os.Getenv("ENV") == "prod"` rồi set release?
   - pprof endpoint có auth?

## Search patterns (Go-specific)

```
# gin debug mode
gin\.SetMode\s*\(\s*gin\.DebugMode
gin\.SetMode\s*\(\s*"debug"
# nếu không có gin.SetMode(gin.ReleaseMode) trong main → default DebugMode → flag

# fiber
fiber\.Config\s*\{[^}]*Debug:\s*true

# echo
e\.Debug\s*=\s*true

# pprof exposed
import\s+_\s+"net/http/pprof"
"runtime/pprof"

# error leak to response
c\.JSON\s*\([^,]+,\s*[^)]*err\.Error\(\)
c\.String\s*\([^,]+,\s*err\.Error\(\)
http\.Error\s*\(w,\s*err\.Error\(\),

# slog verbose
slog\.LevelDebug
AddSource:\s*true
slog\.NewTextHandler\s*\([^,]+,\s*\&slog\.HandlerOptions\{[^}]*Level:\s*slog\.LevelDebug

# panic trả về response (không recover hoặc recover dump trace)
debug\.Stack\(\)
runtime\.Stack\(
```

## Examples

### HIGH — flag

```go
// main.go — không set release mode
func main() {
    r := gin.Default()  // default DebugMode nếu không SetMode
    r.GET("/users/:id", getUser)
    r.Run(":8080")
}
```

```go
// fiber debug bật
app := fiber.New(fiber.Config{
    Debug: true,
    AppName: "prod-api",
})
```

```go
// leak GORM error
func getUser(c *gin.Context) {
    var u User
    if err := db.First(&u, c.Param("id")).Error; err != nil {
        c.JSON(500, gin.H{"error": err.Error()})
        // err: "ERROR: column \"is_deleted\" does not exist (SQLSTATE 42703)"
        // → leak schema
    }
}
```

```go
// pprof exposed
import (
    "net/http"
    _ "net/http/pprof"  // BAD nếu serve trên public port
)
func main() {
    go http.ListenAndServe(":6060", nil)  // pprof endpoint public
}
```

```go
// slog verbose prod
logger := slog.New(slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
    Level:     slog.LevelDebug,
    AddSource: true,
}))
slog.SetDefault(logger)
```

### NOT critical — safe

```go
// Set ReleaseMode dựa env
func main() {
    if os.Getenv("ENV") == "production" {
        gin.SetMode(gin.ReleaseMode)
    }
    r := gin.New()
    r.Use(gin.Recovery())  // recovery NHƯNG không print stack to response (mặc định không print từ gin v1.8+)
    r.Run(":8080")
}
```

```go
// Error mapping — không leak raw
func getUser(c *gin.Context) {
    var u User
    if err := db.First(&u, c.Param("id")).Error; err != nil {
        slog.Error("db error", "err", err)  // log internal
        if errors.Is(err, gorm.ErrRecordNotFound) {
            c.JSON(404, gin.H{"error": "not found"})
            return
        }
        c.JSON(500, gin.H{"error": "internal error"})
        return
    }
    c.JSON(200, u)
}
```

```go
// pprof on separate port + middleware auth
pprofMux := http.NewServeMux()
pprofMux.HandleFunc("/debug/pprof/", basicAuth(pprof.Index))
go http.ListenAndServe("127.0.0.1:6060", pprofMux)  // localhost only
```

## Fix recommendation

1. **Luôn `gin.SetMode(gin.ReleaseMode)` trong prod** — guard bằng env var.
2. **Fiber/echo**: tắt `Debug` trong build production. Dùng config từ env.
3. **Central error handler**: middleware map error → public message + log internal.
4. **Wrap error trước khi return**: `fmt.Errorf("failed: %w", err)` cho log, nhưng response chỉ trả `"internal error"`.
5. **pprof**: KHÔNG import vào `http.DefaultServeMux` public. Dùng mux riêng + bind `127.0.0.1` + auth.
6. **slog**: dùng `LevelInfo` trong prod, `AddSource: false`. Log tới stdout cho log aggregator, không log secret.
7. **Recover middleware không dump trace**: gin v1.8+ default OK. Custom recover: chỉ log stack server-side, response chỉ "panic" string generic.

## Cross-references

- Rule `01-hardcoded-secret`: secret có thể nằm trong error message (vd: DSN với password) → debug mode leak
- Rule `02-sql-injection`: SQLi + verbose error = attacker exfil DB schema nhanh
- Rule `09-ssrf`: SSRF response body return user — chính là verbose error pattern
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