# Active Debug Code (CWE-489)

The product is deployed to unauthorized actors with debugging code still enabled or active, which can create unintended entry points or information leaks.

- Prevalence: 高 频繁被利用
- Impact: 关键 1 条严重级别为关键的规则
- Prevention: 已记录 6 个修复示例

**OWASP:** Security Misconfiguration (A05:2021-Security Misconfiguration) - #5

## Description

Debug code is often written to allow easier testing and debugging. This code is not intended to be shipped to production but is sometimes inadvertently left in the product. Debug code often exposes information about the product's internal structure or creates additional attack surface.

## Prevention

基于 6 条 Shoulder 检测规则的 Active Debug Code 预防策略。

### Python

Load DEBUG from environment variables, defaulting to False in production

Load Flask debug mode from environment variables, defaulting to False

### Go

Disable Echo debug mode in production to prevent stack trace exposure

Disable Fiber debug output and route printing in production

Set Gin to release mode in production to suppress debug output

### JavaScript

Use environment variables for debug configuration instead of hardcoded flags

## Warning Signs

- [HIGH] Flask applications running with debug mode enabled
- [MEDIUM] Debug flag at line ... is hardcoded to true
- [MEDIUM] hardcoded debug flags that expose sensitive information or enable debugging features in production
- [CRITICAL] Django applications with DEBUG = True in settings

## Consequences

- 读取应用程序数据
- 绕过保护机制
- 执行未授权代码

## Mitigations

- 在将产品部署到生产环境之前移除调试代码
- 使用能在生产构建中自动排除调试代码的构建配置
- 在发布前审计代码,查找调试端点和后门

## Detection

- Total rules: 6
- Critical: 1
- Languages: python, go, javascript, typescript

## Rules by Language

### Go (3 rules)

- **Echo Debug Mode in Production** [MEDIUM]: Echo debug mode exposes stack traces and verbose errors in production.
  - Remediation: Disable debug mode in production.

```go
e := echo.New()
e.Debug = false
```

Learn more: https://shoulder.dev/learn/go/cwe-489/debug-mode
- **Fiber Debug Mode in Production** [MEDIUM]: Fiber debug configuration exposes route structure and stack traces.
  - Remediation: Use production configuration to disable debug output.

```go
app := fiber.New(fiber.Config{
    DisableStartupMessage: true,
    EnablePrintRoutes:     false,
})
```

Learn more: https://shoulder.dev/learn/go/cwe-489/debug-mode
- **Gin Debug Mode in Production** [MEDIUM]: Gin debug mode exposes routing info and verbose errors in production.
  - Remediation: Set release mode before creating the router.

```go
gin.SetMode(gin.ReleaseMode)
r := gin.Default()
```

Learn more: https://shoulder.dev/learn/go/cwe-489/debug-mode

### Python (2 rules)

- **Django Debug Mode in Production** [CRITICAL]: Detects Django applications with DEBUG = True in settings. Debug mode exposes
sensitive information including settings, environment variables, SQL queries,
and stack traces. This must NEVER be enabled in production.
  - Remediation: Load DEBUG from environment variables, defaulting to False.

```python
import os

DEBUG = os.getenv('DJANGO_DEBUG', 'False').lower() == 'true'
ALLOWED_HOSTS = ['example.com', 'www.example.com']
```

Learn more: https://shoulder.dev/learn/python/cwe-489/debug-mode
- **Flask Debug Mode in Production** [HIGH]: Detects Flask applications running with debug mode enabled. Debug mode exposes
sensitive information, allows code execution through the interactive debugger,
and should NEVER be enabled in production.
  - Remediation: Load debug mode from environment variables, defaulting to False.

```python
import os
from flask import Flask

app = Flask(__name__)

if __name__ == '__main__':
    debug = os.getenv('FLASK_DEBUG', 'False').lower() == 'true'
    app.run(debug=debug)
```

Learn more: https://shoulder.dev/learn/python/cwe-489/debug-mode

### Javascript (1 rules)

- **Debug Mode Enabled in Production** [MEDIUM]: Detects hardcoded debug flags that expose sensitive information or enable debugging features in production.
  - Remediation: Use environment variables for debug/development mode configuration.

### Typescript (1 rules)

- **Debug Mode Enabled in Production** [MEDIUM]: Detects hardcoded debug flags that expose sensitive information or enable debugging features in production.
  - Remediation: Use environment variables for debug/development mode configuration.