Validate Key

Validates a license key with the server and creates an authenticated session.

This function must be called after SendHeartbeat() to ensure secure connection is established.

Signature

bool ValidateKey(const std::string& licenseKey);

Parameters

licenseKey

Type: std::string

Description: The license key to validate

Format: "XXXX-XXXX-XXXX-XXXX"

Required: Yes

Returns

Type: bool

Value	Description
true	License is valid and session created
false	License is invalid or validation failed

Basic Example

qPapel::ProtectedAuth auth;
auth.Init(config);
auth.SendHeartbeat();

std::string licenseKey;
std::cout << "Enter license key: ";
std::cin >> licenseKey;

if (auth.ValidateKey(licenseKey)) {
    std::cout << "Valid license" << std::endl;
    std::cout << "Session: " << auth.GetSessionToken() << std::endl;
} else {
    std::cerr << "Invalid: " << auth.GetLastError() << std::endl;
}

Error Handling

Complete Example

if (!auth.ValidateKey(licenseKey)) {
    std::string error = auth.GetLastError();
    
    if (error.find("Invalid") != std::string::npos) {
        std::cout << "License key does not exist" << std::endl;
    }
    else if (error.find("expired") != std::string::npos) {
        std::cout << "License has expired" << std::endl;
    }
    else if (error.find("HWID") != std::string::npos) {
        std::cout << "License bound to another device" << std::endl;
    }
    else if (error.find("suspended") != std::string::npos) {
        std::cout << "License has been suspended" << std::endl;
    }
}

Common Errors

How It Works

All validation requests are encrypted and HWID is hashed before transmission.

The server performs the following checks:

1

License exists

Verify the license key exists in the database.

2

License active

Ensure the license is active (not suspended or expired).

3

HWID check

Confirm HWID matches (if license is bound to hardware).

4

Device limit

Ensure device limit not exceeded.

5

Product access

Verify product access permissions.

If validation succeeds, a session token is generated and stored internally.

Related Functions

• GetSessionToken - Retrieve session token

• GetKeyInfo - Get license details

• SendHeartbeat - Required before validation