Skip to main content

QuantumLock™ Quickstart Guide

Get Started in 5 Minutes​

This guide shows you how to integrate QuantumLock™ into your software quickly.

1. Get Your Credentials​

  1. Go to SoftQuantus Portal
  2. Login or create an account
  3. On the Dashboard, copy your API Key

2. Choose Your Integration Method​

The SDK provides complete integration for Python applications.

from quantumlock.sdk import QuantumLockClient

# Initialize client
client = QuantumLockClient(api_key="your_api_key")

# Generate license for your customer
license = client.generate_license(
    end_customer_id="customer@company.com",
    features=["premium", "api_access"],
    valid_days=365
)

print(f"License: {license['license_key']}")
print(f"Expires: {license['valid_until']}")

Option B: CLI (For Administrators)​

The CLI allows managing licenses via terminal.

# Configure CLI
./quantumlock configure

# Generate license
./quantumlock generate \
    --customer "customer@company.com" \
    --features "premium,api_access" \
    --days 365

# Validate license
./quantumlock validate "QLOCK-XXXX-..." --customer "customer@company.com"

Option C: Direct REST API​

Use the API directly for any programming language.

# Generate license
curl -X POST "https://api.quantumlock.softquantus.com/api/v1/licenses/generate" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "end_customer_id": "customer@company.com",
    "features": ["premium", "api_access"],
    "valid_days": 365
  }'

3. Validate Licenses in Your Software​

from quantumlock.sdk import QuantumLockClient

client = QuantumLockClient(api_key="your_api_key")

# Validate your customer's license
result = client.validate_license(
    license_key="QLOCK-XXXX-...",
    end_customer_id="customer@company.com"
)

if result["valid"]:
    print("✓ License valid!")
    print(f"Features: {result['features']}")
else:
    print("✗ Invalid license!")
    print(f"Reason: {result['message']}")

Offline Validation (For Desktop Software)​

from quantumlock.sdk import LicenseValidator

# Validate license file locally
validator = LicenseValidator()

if validator.validate("/etc/myapp/license.lic"):
    # License is valid!
    if validator.has_feature("premium"):
        enable_premium_features()
else:
    show_license_required_dialog()

4. Protect Features with Decorators​

from quantumlock.sdk import LicenseValidator

validator = LicenseValidator(license_path="/etc/myapp/license.lic")
validator.validate()

# Decorator to protect functions
@validator.require_feature("analytics")
def run_analytics():
    """Only executes if 'analytics' is in the license"""
    return {"data": "analytics results"}

# Decorator to protect FastAPI endpoints
@app.get("/api/premium")
@validator.require_feature("api_access")
def premium_endpoint():
    return {"premium": True}

5. Distribute Licenses to Your Customers​

Via Portal​

  1. Generate the license via API/CLI
  2. Download the .lic file or copy the key
  3. Send to your customer

License File Format​

{
  "license_key": "QLOCK-ABCD-1234-WXYZ",
  "quantum_signature": "abc123...",
  "end_customer_id": "customer@company.com",
  "features": ["premium", "api_access"],
  "valid_until": "2026-12-26T00:00:00Z",
  "quantum_verified": true
}

🔐 Security​

Each QuantumLock™ license includes:

  • Quantum Signature: SHA3-512 derived from quantum circuit
  • Quantum Fidelity: Quantum state quality metric (>99%)
  • Timestamp: Exact moment of generation
  • Fingerprint: Unique customer hash

❓ Next Steps​

🆘 Support​

Having issues? Contact us: