Technical Architecture
This client-side agent separates licensing logic entirely from the main core codebase, enabling seamless drops into any future DigitalSaman backend services.
Folder Structure Overview
config/ # Security settings & environmental initialization controllers/ # Handles view-rendering & posting auth/license states helpers/ # Machine ID fingerprinter (uses CPU, OS, Disk, MAC) & loggers middleware/ # License validation & route protection middleware models/ # Abstract structures routes/ # HTTP request handlers & API routing table services/ # Cryptographic license managers (AES-256 encrypt/decrypt) views/ # EJS layout engine files logs/ # license.log event audits (Pings, Checks, Activations) storage/ # Encrypted license.dat and validation meta license.json
Cryptographic Core
Uses standard AES-256-CBC node algorithms with dynamic salts derived from user secrets. The raw text license payload is never stored plain, completely eliminating configuration hijacking.
72-Hour Offline Guard
Ensures user productivity when remote servers are down. Allows local execution using cached keys for up to 72 hours before gracefully redirecting to the licensing page.
Machine ID Fingerprinting
Retrieves standard host credentials including the primary disk serial number, processor properties, platform descriptors, and MAC interfaces to form a cryptographic SHA256 signature preventing license transfers.
System Audits
Every system check, heartbeat failure, version check, or activation attempt is recorded directly with timestamps inside /logs/license.log for auditing purposes.