| Version | Supported |
|---|---|
| 2.1.x | ✅ Actively supported |
| < 2.0 | ❌ No longer supported |
If you discover a security vulnerability in ARGUS, please report it responsibly:
- Do NOT open a public GitHub issue for security vulnerabilities
- Email: security@argus-agent.dev (or open a private advisory)
- Include a detailed description with reproduction steps
- Allow up to 72 hours for an initial response
ARGUS implements defense-in-depth with the following security controls:
- All WebSocket payloads are validated with Pydantic V2 strict models
- Command text is sanitized (null bytes, ANSI escapes, control characters removed)
- URL schemes are restricted to
http://andhttps://only - Base64 payloads are validated for size and encoding correctness
- Image dimensions are capped at 4096×4096 pixels
- Optional API key authentication on WebSocket connections
- Constant-time key comparison using HMAC to prevent timing attacks
- Keys sourced from Google Cloud Secret Manager in production
- Per-client IP rate limiting with configurable window
- Token-bucket algorithm with automatic cleanup of expired entries
- Default: 60 requests/minute per client
- Zero
shell=Truein the entire codebase - URL opening uses
webbrowser.open()instead of subprocess - No string interpolation in system commands
- PyAutoGUI actions use coordinate-based interaction only
Content-Security-Policy: script-src 'strict-dynamic' 'self'X-Frame-Options: DENYX-Content-Type-Options: nosniffReferrer-Policy: strict-origin-when-cross-originPermissions-Policy: camera=(), microphone=(), geolocation=()
- Production credentials loaded via Google Cloud Secret Manager
.envfiles used only for local development- No secrets committed to version control
.envlisted in.gitignore
- Docker image runs as non-root user (
appuser) - Minimal base image (
python:3.11-slim) - No unnecessary system packages installed
- Health check endpoint for container orchestration
- Screenshots are stored in Google Cloud Storage with default encryption
- Firestore data is encrypted at rest by Google Cloud
- Action logs use append-only JSONL (no mutation of existing records)
- Dependencies pinned with minimum version constraints
- Security linting via
ruffwithflake8-banditrules enabled - Type checking via
mypy --strictto catch unsafe patterns
The test suite includes dedicated security tests:
tests/test_security.py— Rate limiting, auth, sanitization, URL validationtests/test_vulnerabilities.py— ReDoS resistance, command injection prevention, path traversal blocking, XSS payload rejection- All tests run in CI before deployment
This security policy follows the OWASP Top 10 (2021) framework for web application security risk assessment.