Skip to content

Security: SMSerg2000/LockWall

Security

SECURITY.md

Security Policy

Reporting a Vulnerability

LockWall is an independently maintained project, and its security is taken seriously. If you discover a security vulnerability, please do not open a public GitHub issue.

How to Report

Please report security vulnerabilities via email:

πŸ“§ support@lockwall.app

What to Include

A good vulnerability report includes:

  1. Description β€” what the vulnerability is
  2. Impact β€” what an attacker could do
  3. Reproduction steps β€” how to reliably trigger it
  4. Affected versions β€” which LockWall versions are vulnerable
  5. Proof of concept β€” code or commands demonstrating the issue (if applicable)
  6. Suggested fix (optional) β€” how it could be addressed
  7. Your contact info β€” email or PGP key for follow-up
  8. Disclosure preference β€” credited or anonymous?

What to Expect

We follow a responsible disclosure approach:

Step Timeline
Acknowledgement Within 48 hours
Initial assessment Within 7 days
Status updates Every 7 days
Fix release Depending on severity (Critical: ASAP; High: 30 days; Medium: 60 days; Low: next release)
Public disclosure After fix release + 90 days (or earlier with reporter consent)

Severity Classification

πŸ”΄ Critical

  • Remote code execution
  • Authentication bypass leading to full system access
  • SQL injection allowing data exfiltration
  • Privilege escalation to admin without auth

🟠 High

  • Authentication bypass with limited access
  • Persistent XSS in web UI
  • Disclosure of password hashes / API tokens
  • DoS that crashes the service
  • Path traversal allowing arbitrary file read

🟑 Medium

  • Reflected XSS
  • CSRF on sensitive endpoints
  • Information disclosure (non-sensitive data)
  • Denial of service requiring authentication
  • Insecure default configurations

🟒 Low

  • Missing security headers
  • Information disclosure of public information
  • Issues requiring physical access

Supported Versions

Security updates are provided for the latest version:

Version Supported
2.1.x βœ… Supported
2.0.x ❌ Not supported β€” upgrade for free
1.x / pre-public builds ❌ Not supported

Security Best Practices for Users

Mandatory

  1. βœ… Change default password immediately (forced on first login)
  2. βœ… Whitelist your trusted networks before exposing the service
  3. βœ… Don't expose port 8880 externally without an HTTPS reverse proxy
  4. βœ… Run as the Windows Service under LocalSystem, not as a user

Recommended

  1. πŸ›‘οΈ HTTPS reverse proxy (nginx, Caddy, IIS) for any external access
  2. πŸ›‘οΈ Multiple admin accounts (in case one loses access)
  3. πŸ›‘οΈ Review the Audit Log regularly for suspicious admin activity
  4. πŸ›‘οΈ Monitor the Health page for early problem detection
  5. πŸ›‘οΈ Keep LockWall updated β€” subscribe to GitHub releases
  6. πŸ›‘οΈ Back up config.yaml and data\lockwall.db regularly
  7. πŸ›‘οΈ Use API tokens with least privilege (Viewer role when possible)
  8. πŸ›‘οΈ Rotate API tokens periodically

Don't

  • ❌ Run LockWall with host: 0.0.0.0 without HTTPS in front
  • ❌ Disable the whitelist in production
  • ❌ Share API tokens via insecure channels

Cryptography

  • Password hashing: werkzeug.security (scrypt by default)
  • API token storage: SHA-256 hash of high-entropy random tokens; the raw token is never stored
  • Session keys: signed via a persistent per-install secret
  • Random tokens: 256 bits of entropy from a CSPRNG

Out of Scope

The following are not considered security vulnerabilities for this policy:

  • Issues requiring physical access to the server
  • Issues in third-party dependencies (report to upstream)
  • Social engineering or phishing
  • Network-level (volumetric) DDoS that floods the host independently of authentication failures β€” this is outside LockWall's scope (it acts on failed-login events, not raw traffic volume)
  • Missing best-practice headers when LockWall runs behind a reverse proxy that handles them

Acknowledgement

Thank you for helping keep LockWall and its users safe! πŸ›‘οΈ


LockWall | support@lockwall.app

There aren't any published security advisories