Skip to content

Security: CardSorting/JoySwordOnline

Security

SECURITY.md

Security Policy & Vulnerability Reporting

The JoySword Online project prioritizes security, network isolation, database integrity, and safe process execution across all components.


πŸ›‘οΈ Supported Versions

We actively provide security updates and SRE sentinel patches for the following project release branches:

Version / Branch Supported Security Maintenance
main (v2.5+) βœ… Yes Active SRE Sentinel & Vulnerability Patching
release/* βœ… Yes Critical Security Hotfixes
< v2.0 ❌ No Unsupported

πŸ”’ Security Architecture & Defensive Boundaries

JoySword Online enforces a multi-layered security strategy:

  1. Defense-in-Depth Network Isolation:

    • Automated network circuit breakers (manage-network-health.ps1) prevent loopback IP binding (159.203.165.171) to physical internet adapters (Ethernet), protecting host network interfaces from lease revocation or DNS corruption.
  2. Zero-Admin Application Proxy:

    • An application-level proxy daemon (socket_proxy.py) operates with non-elevated user privileges on port 9100, removing the requirement for Administrator elevation.
  3. Web Identity & Credential Hashing:

    • The Next.js 14 Web Portal uses Argon2id password hashing and Firebase Auth token verification for REST API endpoints (/api/account/sync).
  4. Cryptographic Schema Drift Defense:

    • Cryptographic schema sentinels (db-schema-sentinel.py) fingerprint SQL catalog tables using SHA-256 baseline hashes to reject unauthorized column injection or schema tampering.
  5. Atomic Anti-Corruption I/O:

    • Staged temporary writes and atomic pointer swaps (os.replace) guarantee zero zero-byte truncated configuration files upon unhandled crashes.

🚨 Reporting a Vulnerability

If you discover a security vulnerability or potential exploit in JoySword Online, please report it privately to our core maintainers before publishing it publicly.

How to Submit a Report

  • Email: Send your vulnerability details to security@joysword.org (or create a private GitHub Security Advisory).
  • Required Information:
    1. Description of the vulnerability and potential impact.
    2. Step-by-step proof-of-concept (PoC) or reproduction script.
    3. Affected components, scripts, or database procedures.

Response Timeline

  • Acknowledgement: Within 48 hours.
  • Triage & Assessment: Within 5 business days.
  • Fix & Disclosure: Hotfix patch released within 14 business days.

There aren't any published security advisories