🔐 License System Documentation

মূল ফিচারসমূহ

📦 licenses টেবিল — মূল লাইসেন্স ডেটা

🛡️ stolen_domains টেবিল — চুরি লগ

Endpoint

Request Parameters

Response Fields ব্যাখ্যা

HMAC Signature তৈরি করার নিয়ম

// PHP
$signature = hash_hmac('sha256', $domain, 'your_secret_salt_key');

// উদাহরণ
$domain    = 'example.com';
$signature = hash_hmac('sha256', 'example.com', 'your_secret_salt_key');
// → "a3f9b2c1d4e5f6..."

নতুন লাইসেন্স তৈরি — /admin/licenses

Stolen Reports — Action বাটনসমূহ

রিনিউয়াল অর্ডার ম্যানেজমেন্ট — /admin/license-renewal-orders

User সাইট থেকে renew request করলে এখানে দেখা যাবে।

User লাইসেন্স Actions

কীভাবে কাজ করে

Domain Normalize নিয়ম

কীভাবে চালু/বন্ধ করবেন

উদ্দেশ্য

ক্লায়েন্ট সাইট performance এর জন্য লাইসেন্স ভেরিফিকেশন cache করে রাখতে পারে। Cache Signal ব্যবহার করে Admin যেকোনো সময় ক্লায়েন্ট সাইটের cache মুছতে পারে — সাইটকে সরাসরি access না করেই।

কীভাবে কাজ করে

phpMyAdmin এ চালানোর SQL (সব টেবিল)

SSH না থাকলে এই SQL গুলো phpMyAdmin → SQL ট্যাবে paste করে Execute করুন:

-- ১. stolen_domains এ নতুন column
ALTER TABLE `stolen_domains`
  ADD COLUMN IF NOT EXISTS `cache_signal` varchar(255) DEFAULT NULL,
  ADD COLUMN IF NOT EXISTS `is_blocked` tinyint(1) NOT NULL DEFAULT 0;

-- ২. users টেবিলে free_license_generation
ALTER TABLE `users`
  ADD COLUMN IF NOT EXISTS `free_license_generation` tinyint(1) NOT NULL DEFAULT 0;

-- ৩. generalsettings এ license price
ALTER TABLE `generalsettings`
  ADD COLUMN IF NOT EXISTS `license_generation_price` decimal(10,2) DEFAULT 1000.00;

-- ৪. unauthorized_logs টেবিল তৈরি
CREATE TABLE IF NOT EXISTS `unauthorized_logs` (
  `id`           bigint(20) UNSIGNED NOT NULL AUTO_INCREMENT,
  `domain`       varchar(255) NOT NULL,
  `ip`           varchar(255) DEFAULT NULL,
  `reason`       text NOT NULL,
  `url`          text DEFAULT NULL,
  `attempted_at` timestamp NOT NULL,
  `kill_switch`  tinyint(1) NOT NULL DEFAULT 0,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- ৫. license_renewal_orders টেবিল তৈরি
CREATE TABLE IF NOT EXISTS `license_renewal_orders` (
  `id`         bigint(20) UNSIGNED NOT NULL AUTO_INCREMENT,
  `user_id`    bigint(20) UNSIGNED NOT NULL,
  `license_id` bigint(20) UNSIGNED NOT NULL,
  `amount`     decimal(10,2) NOT NULL DEFAULT 1000.00,
  `invoice_id` varchar(255) DEFAULT NULL,
  `status`     varchar(255) NOT NULL DEFAULT 'pending',
  `paid_at`    timestamp NULL DEFAULT NULL,
  `notes`      text DEFAULT NULL,
  `created_at` timestamp NULL DEFAULT NULL,
  `updated_at` timestamp NULL DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

SSH থাকলে (Terminal)

php artisan migrate
php artisan config:cache
php artisan route:cache
php artisan cache:clear

সহজ পদ্ধতি (Legacy — পুরনো সাইটের জন্য)

<?php
function verifyLicense($domain, $licenseKey, $serverUrl) {
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL            => $serverUrl . '/api/verify-license',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query([
            'domain'      => $domain,
            'license_key' => $licenseKey,
            'url'         => (isset($_SERVER['HTTPS']) ? 'https' : 'http')
                             . '://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'],
        ]),
        CURLOPT_TIMEOUT => 10,
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

$result = verifyLicense(
    'example.com',
    'LIC-ABCD-EFGH-IJKL',
    'https://yourserver.com'
);

if ($result['status'] === 'valid') {
    if ($result['action'] === 'wipe_out') {
        die('Site disabled by administrator.');
    }
    // cache_signal চেক
    $saved = @file_get_contents('license_signal.txt');
    if ($saved !== $result['cache_signal']) {
        clearLocalCache(); // নিজের cache clear function
        file_put_contents('license_signal.txt', $result['cache_signal']);
    }
    // ✅ স্বাভাবিক কাজ চালিয়ে যান
} else {
    die('License invalid or domain blocked.');
}

উন্নত পদ্ধতি (HMAC — নতুন সাইটের জন্য)

<?php
define('LICENSE_SERVER', 'https://yourserver.com');
define('LICENSE_DOMAIN',  'example.com');
define('LICENSE_KEY',     'LIC-ABCD-EFGH-IJKL');
define('HMAC_SALT',       'your_secret_salt_key'); // server এর HMAC_SALT

function verifyLicenseHmac() {
    $domain    = LICENSE_DOMAIN;
    $signature = hash_hmac('sha256', $domain, HMAC_SALT);

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL            => LICENSE_SERVER . '/api/verify-license',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query([
            'domain'      => $domain,
            'license_key' => LICENSE_KEY,
            'signature'   => $signature,
            'url'         => (isset($_SERVER['HTTPS']) ? 'https' : 'http')
                             . '://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'],
        ]),
        CURLOPT_TIMEOUT        => 10,
        CURLOPT_SSL_VERIFYPEER => false,
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

$result = verifyLicenseHmac();

if (!$result || $result['status'] !== 'valid') {
    die('License verification failed.');
}

if ($result['action'] === 'wipe_out') {
    die('This installation has been remotely deactivated.');
}

// Cache signal চেক
$cacheFile   = __DIR__ . '/.license_signal';
$savedSignal = file_exists($cacheFile) ? trim(file_get_contents($cacheFile)) : '';
if ($result['cache_signal'] && $savedSignal !== $result['cache_signal']) {
    if (function_exists('opcache_reset')) opcache_reset();
    file_put_contents($cacheFile, $result['cache_signal']);
}

// ✅ লাইসেন্স valid — কাজ চালিয়ে যান

সমস্যা ১: পুরনো সাইট কাজ করছে না (HTTP 500)

সমাধান: phpMyAdmin এ রান করুন:

CREATE TABLE IF NOT EXISTS `unauthorized_logs` (
  `id` bigint(20) UNSIGNED NOT NULL AUTO_INCREMENT,
  `domain` varchar(255) NOT NULL,
  `ip` varchar(255) DEFAULT NULL,
  `reason` text NOT NULL,
  `url` text DEFAULT NULL,
  `attempted_at` timestamp NOT NULL,
  `kill_switch` tinyint(1) NOT NULL DEFAULT 0,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

সমস্যা ২: সাইট blocked কিন্তু লাইসেন্স valid

সমাধান:

UPDATE stolen_domains SET is_blocked = 0 WHERE domain_name = 'example.com';

অথবা Admin → Stolen Reports → 🔓 Unblock বাটন

সমস্যা ৩: Kill Switch বন্ধ করা যাচ্ছে না

UPDATE unauthorized_logs SET kill_switch = 0 WHERE domain = 'example.com';

সমস্যা ৪: kill_switch column নেই

ALTER TABLE `unauthorized_logs` ADD COLUMN `kill_switch` tinyint(1) NOT NULL DEFAULT 0;

সমস্যা ৫: Domain normalize এর কারণে লাইসেন্স পাচ্ছে না

Public (Authentication ছাড়া)

Admin Routes

User Routes