Skip to main content

Welcome to CyberLicense

CyberLicense is a complete, production-ready software license management system built with Node.js, Express, EJS, and MongoDB. It provides a robust solution for managing software licenses, customers, products, and integrations with payment gateways.

🎯 What is CyberLicense?​

CyberLicense is a full-featured licensing backend that allows you to:

  • Manage Software Licenses - Create, validate, and manage software licenses with support for multiple license types
  • Control Access - Implement IP and HWID (Hardware ID) restrictions to prevent unauthorized usage
  • Track Revenue - Export and track transactions (BuiltByBit integration available)
  • Automate Workflows - Set up automated actions based on events (expiration, violations, etc.)
  • Monitor Activity - Comprehensive audit logs and analytics to track all system activities
  • Secure Access - Two-factor authentication (2FA) for admin accounts with Discord OAuth integration

🚀 Key Features​

License Management​

  • ✅ Multiple License Types - Fixed duration, trial, consumption-based, and enterprise licenses
  • ✅ IP/HWID Restrictions - Control how many devices can use each license
  • ✅ Master/Child Licenses - Create parent licenses with multiple child licenses
  • ✅ License Validation - Robust API for validating licenses in your applications
  • ✅ Expiration Management - Automatic expiration checking and renewal workflows

Admin Dashboard​

  • ✅ Complete Interface - Manage licenses, products, customers, and transactions
  • ✅ Real-time Notifications - Socket.IO powered in-app notifications
  • ✅ Statistics & Analytics - Comprehensive dashboards with charts and metrics
  • ✅ Export Reports - Export data in CSV and PDF formats
  • ✅ Audit Logs - Track all administrative actions with detailed logs

Security​

  • ✅ 2FA Support - Two-factor authentication using TOTP (Google Authenticator, Authy)
  • ✅ Discord OAuth - Secure authentication using Discord OAuth 2.0
  • ✅ Rate Limiting - Configurable rate limiting to prevent abuse
  • ✅ Panic Mode - Emergency feature to disable all public APIs instantly
  • ✅ Session Management - Secure session handling with MongoDB storage

Integrations​

  • ✅ Discord Integration - Discord OAuth for authentication and bot notifications
  • ✅ Payment Integration - BuiltByBit marketplace integration for automatic license creation
  • ✅ BuiltByBit Integration - Support for BuiltByBit marketplace
  • ✅ Webhooks - Custom webhooks for external integrations

Customer Portal​

  • ✅ Self-Service Dashboard - Customers can view and manage their licenses
  • ✅ Usage Statistics - View license usage, IPs, HWIDs, and validation history
  • ✅ Credit Management - For consumption-based licenses, track credit usage

📚 Documentation Structure​

This documentation is organized into the following sections:

  • FAQ - Frequently asked questions about installation, configuration, and usage
  • API Reference - Complete REST API documentation with examples

🎯 Quick Start​

Prerequisites​

  • Node.js 18 or higher
  • MongoDB 4.4 or higher (local or cloud like MongoDB Atlas)
  • npm or yarn package manager

Installation​

  1. Clone the repository (or extract the project files)

    git clone <repository-url>
    cd CyberLicense

  2. Install dependencies

    npm install

  3. Configure the application

    • Edit config.yml with your MongoDB connection string
    • Configure Discord OAuth credentials (if using Discord authentication)
    • Set up other integrations as needed

  4. Start the server

    # Development mode (with auto-reload)
    npm run dev

    # Production mode
    npm start

  5. Access the application

    • Admin Dashboard: http://localhost:3000/admin
    • Customer Portal: http://localhost:3000/customer
    • API Documentation: See API Reference

Configuration​

All configuration is managed through config.yml. Key configuration sections:

  • MongoDB - Database connection settings
  • Server - Port, theme, and server settings
  • Security - Rate limiting, panic mode, and security settings
  • Integrations - Discord, BuiltByBit configuration
  • Features - Enable/disable features like analytics, webhooks, etc.

For detailed configuration instructions, see the FAQ.

🔧 Technology Stack​

  • Backend: Node.js with Express.js
  • Database: MongoDB with Mongoose ODM
  • Authentication: Discord OAuth 2.0, JWT tokens, 2FA (TOTP)
  • Real-time: Socket.IO for notifications
  • Frontend: EJS templates with Bulma CSS framework
  • Payment Integration: BuiltByBit marketplace integration
  • Logging: Pino and Winston for structured logging

📖 Next Steps​

  1. Read the FAQ - Get answers to common questions about setup and configuration
  2. Explore the API - Check out the API reference to integrate CyberLicense with your applications
  3. Configure Integrations - Set up Discord OAuth and BuiltByBit webhooks
  4. Create Your First License - Use the admin dashboard to create and manage licenses

🤝 Support​

  • Documentation: This documentation covers most use cases
  • FAQ: Check the FAQ section for common questions
  • Issues: Report bugs or request features through the issue tracker

Version: 1.0
Last Updated: 2025 Support: Discord | Documentation