Skip to content

Security: ehgzao/DungeonScoundrel

SECURITY.md

๐Ÿ›ก๏ธ Security Policy - Dungeon Scoundrel

Thank you for helping to keep Dungeon Scoundrel and its community safe! We take security seriously and appreciate your efforts to responsibly disclose vulnerabilities.


๐Ÿ”’ Supported Versions

We actively maintain and provide security updates for the following versions:

Version Supported Status
1.6.x โœ… Yes Current stable release
1.5.x โš ๏ธ Limited support Critical fixes only
< 1.5 โŒ No Please upgrade

Recommendation: Always use the latest version available at https://dungeonscoundrel.com/


๐Ÿ› Reporting a Vulnerability

Where to Report

If you discover a security vulnerability, please report it via one of the following methods:

  1. GitHub Security Advisories (Preferred)

  2. Email (Alternative)

    • Use the in-game bug report feature (encrypted via EmailJS)
    • Or open a GitHub issue with [SECURITY] prefix if non-critical
  3. GitHub Issues (For non-critical issues only)

What to Include

Please provide as much information as possible:

  • Description of the vulnerability
  • Steps to reproduce the issue
  • Impact assessment (what can an attacker do?)
  • Affected versions (if known)
  • Potential fix (if you have suggestions)
  • Proof of concept (code, screenshots, video)

Response Timeline

  • Initial Response: Within 48 hours
  • Status Updates: Every 5-7 days until resolved
  • Fix Timeline:
    • Critical: 1-3 days
    • High: 1-2 weeks
    • Medium: 2-4 weeks
    • Low: Next release cycle

What to Expect

โœ… If Accepted:

  • We'll confirm the vulnerability and its severity
  • We'll work on a fix and keep you updated
  • You'll be credited in the security advisory (optional)
  • We'll release a patch and publish a security advisory
  • We may award a "Security Researcher" badge in-game ๐Ÿ›ก๏ธ

โŒ If Declined:

  • We'll explain why it's not considered a vulnerability
  • We may still implement improvements based on your report
  • You're welcome to discuss the decision

๐ŸŽฏ Security Scope

In Scope:

These areas are considered in scope for security reports:

High Priority:

  • ๐Ÿ” Authentication bypass (Firebase Auth)
  • ๐Ÿ’‰ Injection vulnerabilities (XSS, HTML injection, etc.)
  • ๐Ÿ—„๏ธ Data leaks (LocalStorage, IndexedDB, Firebase)
  • ๐Ÿ”“ Authorization issues (accessing other players' data)
  • ๐ŸŽฎ Game integrity (cheating, save manipulation)
  • ๐Ÿ“Š Leaderboard manipulation (fake scores)
  • ๐ŸŒ Cross-Site Scripting (XSS)
  • ๐Ÿ”’ Insecure storage of sensitive data
  • ๐Ÿšจ Service Worker vulnerabilities

Medium Priority:

  • โšก Denial of Service (DoS) (client-side only)
  • ๐Ÿช Cookie/session issues
  • ๐Ÿ“ง Email system abuse (EmailJS)
  • ๐ŸŽจ UI redressing / Clickjacking
  • ๐Ÿ”‘ Exposed API keys (Firebase, EmailJS)

Low Priority:

  • ๐Ÿ“ฑ Mobile PWA issues
  • ๐ŸŽต Audio system exploits
  • ๐ŸŽจ CSS injection (cosmetic only)

Out of Scope:

These are not considered security vulnerabilities:

  • โŒ Social engineering attacks
  • โŒ Physical access to unlocked devices
  • โŒ Outdated browser warnings (we support modern browsers only)
  • โŒ Performance issues without security impact
  • โŒ UI/UX bugs without security implications
  • โŒ Theoretical vulnerabilities without proof of concept
  • โŒ Third-party service issues (Firebase, Netlify, EmailJS)
  • โŒ DDoS attacks (handled by Netlify)
  • โŒ Issues in dependencies (report to the library maintainer)

๐Ÿ” Security Best Practices

For Players:

  1. Don't share save files from untrusted sources
  2. Keep your browser updated (Chrome, Firefox, Safari, Edge)
  3. Use strong passwords if syncing with Firebase
  4. Report suspicious activity in leaderboards
  5. Don't trust modified versions of the game

For Contributors:

  1. Never commit secrets (API keys, credentials)
  2. Use environment variables for sensitive config
  3. Sanitize user input before rendering
  4. Validate all data from Firebase/IndexedDB
  5. Follow OWASP Top 10 guidelines
  6. Use Content Security Policy headers
  7. Enable SRI for external scripts
  8. Test XSS vectors in user-generated content

๐Ÿ› ๏ธ Security Features

Dungeon Scoundrel implements the following security measures:

Authentication:

  • โœ… Firebase Anonymous Auth (no passwords stored)
  • โœ… Google Sign-In (OAuth 2.0)
  • โœ… Firestore security rules

Data Protection:

  • โœ… Client-side encryption for saves (optional)
  • โœ… IndexedDB with same-origin policy
  • โœ… No sensitive data stored in LocalStorage
  • โœ… HTTPS-only (enforced by Netlify)

Frontend Security:

  • โœ… Content Security Policy (CSP)
  • โœ… Subresource Integrity (SRI) for CDN scripts
  • โœ… Input sanitization
  • โœ… XSS protection
  • โœ… Service Worker with secure caching

Infrastructure:

  • โœ… Netlify CDN with DDoS protection
  • โœ… Automatic HTTPS (Let's Encrypt)
  • โœ… Security headers (HSTS, X-Frame-Options, etc.)
  • โœ… Firebase security rules

๐Ÿ“œ Known Issues

Current (v1.6.25):

  • None reported

Fixed in Previous Versions:

  • v1.6.24: Fixed infinite weapon durability bug
  • v1.5.x: Improved Firebase security rules

See CHANGELOG.md for full history.


๐Ÿ† Security Hall of Fame

We recognize security researchers who have helped improve Dungeon Scoundrel:

Researcher Vulnerability Date Severity
Be the first! - - -

Want to be listed? Report a valid vulnerability!


๐Ÿค Responsible Disclosure Policy

We follow coordinated vulnerability disclosure:

  1. Report privately to us first (not publicly)
  2. Give us time to fix (90 days before public disclosure)
  3. Don't exploit the vulnerability maliciously
  4. Don't access other users' data
  5. Don't disrupt the service (DoS attacks)

In return, we promise:

  • โœ… Acknowledge your report within 48 hours
  • โœ… Keep you updated on fix progress
  • โœ… Credit you in the security advisory (optional)
  • โœ… Not take legal action for good-faith research

๐Ÿ“ž Contact


๐Ÿ“š Resources


๐Ÿ“„ License

This project is licensed under the MIT License. Security issues are handled separately from the open-source license.


Last Updated: 2025-11-12 | Version: 1.6.25

Thank you for helping keep Dungeon Scoundrel secure! ๐Ÿ›ก๏ธโš”๏ธ

There arenโ€™t any published security advisories