Software-Lizenzierung

Mit hostware kannst Du Softwareprodukte ganz einfach verkaufen und mit kostenpflichtiger Lizenzierung versehen. Aktiviere dafür das Modul HwLicensing in der Modulliste.

Lizenzierungsfunktion aktivieren

Die Lizenzierungsfunktion ist standardmäßig ausgeblendet. Um sie zu aktivieren, füge den folgenden String in Deine .env-Datei unter /var/www/hostware ein:

HOSTWARE_ENABLE_SOFTWARE_PRODUCTS=true

Cache neu laden:

cd /var/www/hostware && php artisan optimize

Danach kannst Du das Lizenzierungsmodul aktivieren.

Softwarepakete verwalten

In der Administrations-Seitenleiste findest Du den neuen Menüeintrag „Software“. Hier kannst Du ein oder mehrere Softwarepakete verwalten. Jedes Paket kann mehrere Versionen mit einem passenden Changelog und Download-Link haben.

Außerdem kann jede Version sowohl eine verschlüsselte als auch eine Open-Source-Version enthalten.

Softwareprodukt konfigurieren

Bei der Produkterstellung kannst Du jetzt den Typ „SOFTWARE“ auswählen. Wähle wie gewohnt für die Bereitstellung das Modul „HwLicensing“ aus.

Im Tab „Software“ kannst Du dann das gewünschte Softwarepaket auswählen, das für dieses Produkt verfügbar sein soll.

API zur Validierung

hostware bietet einen REST-API-Endpunkt, um die Gültigkeit einer bestimmten Lizenz zu prüfen.

Validieren (JSON)

POST/api/v1/license/{licenseKey}/verify

Ersetze den Lizenzschlüssel in der URL.

Header

Antwort

{
    "license": {
        "product_hosting_number": "VN-11605",
        "module_name": "HwLicensing",
        "status": "ACTIVE",
        "product_options": {
            "204": {
                "id": 204,
                "label": "250 Kunden-Accounts",
                "value": 250
            }
        },
        "created_at": "2026-05-06T20:14:49.000000Z"
    },
    "product": "keyhelp-whmcs-modul-leased",
    "product_data": {
        "id": 1133,
        "name": "Keyhelp WHMCS Modul",
        "description": "-"
    },
    "customer": "hostware GmbH",
    "company": "hostware GmbH",
    "full_name": "Max Mustermann",
    "email": "[email protected]",
    "service_data": {
        "renew_next": "2026-05-09T20:20:46.000000Z",
        "renew_last": "2026-05-06T20:20:46.000000Z",
        "period_name": "Monatlich",
        "period_price": 50,
        "monthly_price": 50
    }
}

{
    "error": "License not found"
}

{
    "error": "License is not active (installing)"
}

Validieren (WHMCS-Stil)

Unsere Kunden können ganz einfach von WHMCS zu hostware migrieren. Der lokale Code zur Lizenzprüfung muss nicht angepasst werden, Du musst nur die URL ändern. hostware gibt die Daten 1:1 im gleichen Stil wie WHMCS zurück, damit Deine Integration nicht kaputtgeht.

POST/api/v1/license/whmcs-verify

Body

Antwort

Erfolgreich

hostware gibt dieselbe Struktur zurück, die vom WHMCS-Verification-Endpunkt verwendet wird. So werden bestehende Integrationen nicht beeinträchtigt.

<status>Active</status>
<registeredname>Max Mustermann</registeredname>
<companyname>hostware GmbH</companyname>
<email>[email protected]</email>
<serviceid>VN-11605</serviceid>
<productid>1133</productid>
<productname>Keyhelp WHMCS Modul</productname>
<regdate>2026-05-06T20:14:49.000000Z</regdate>
<nextduedate>2026-05-09T20:20:46.000000Z</nextduedate>
<billingcycle>Monatlich</billingcycle>
<validdomain>-</validdomain>
<validip>-</validip>
<validdirectory></validdirectory>
<configoptions>Amount of accounts=250</configoptions>
<customfields></customfields>
<addons></addons>
<md5hash></md5hash>