39Lizenzschlüssel
zplCore prüft seine Lizenz offline: Der Lizenzschlüssel ist digital signiert und wird lokal anhand der Signatur geprüft. zplCore baut dafür keine Verbindung zu zplCore.com oder Dritten auf – kein „Phone-home“, keine Telemetrie – und funktioniert ohne Internetverbindung, auch in abgeschotteten Netzen.
Ohne Schlüssel: Testmodus
Die NuGet-Pakete sind öffentlich auf nuget.org und laufen ohne Schlüssel – nur für Entwicklung und Test, ohne Support. Alles funktioniert, die Ausgaben sind aber gekennzeichnet:
- Bilder und PDF-Dateien: ein diagonaler Schriftzug zplCore.com TRIAL über jedem Etikett,
- SVG: nur als Rasterbild mit Wasserzeichen (Vektor-SVG gibt es mit Lizenz),
- erzeugtes ZPL (Etikettenmodell, Datenbindung, Batches, Konverter wie EPL → ZPL oder Bild → ZPL): mehrere gedruckte Felder zplCore.com TRIAL auf jedem Etikett,
- Barcodes aus dem Barcode-Generator: ein Streifen evaluation – zplCore.com unter dem Symbol (das Symbol bleibt scannbar),
- Exporte in andere Druckersprachen (EPL, Fingerprint, ESC/POS, PCL).
Wenn Sie vorhandenes ZPL rendern, bleibt dieses ZPL unverändert – gekennzeichnet wird nur das Bild davon. Für eine Evaluierung mit Support erhalten Sie auf Anfrage einen kostenlosen Testschlüssel für 30 Tage; er kennzeichnet die Ausgaben genauso. Mit einem gekauften Lizenzschlüssel entfallen die Kennzeichnungen in allen neuen Ausgaben.
Schlüssel hinterlegen
zplCore sucht den Schlüssel in dieser Reihenfolge:
- im Code, einmal beim Start:
ZplCoreLicense.Register(schlüssel)oderZplCoreLicense.RegisterFile(pfad), - Umgebungsvariable
ZPLCORE_LICENSE(der Schlüssel selbst), - Umgebungsvariable
ZPLCORE_LICENSE_FILE(Pfad einer Datei mit dem Schlüssel), - Datei
zplcore.licenseneben Ihrer Anwendung.
using ZplCore.Licensing;
ZplCoreLicense.Register(builder.Configuration["ZplCore:License"]!);
// oder: ZplCoreLicense.RegisterFile("/run/secrets/zplcore.license");
Register wirft eine ZplLicenseException mit klarer Meldung, wenn der Schlüssel beschädigt oder nicht echt ist. Schlüssel aus der Umgebung oder als Datei halten Ihre Anwendung nie an: Ist ein solcher Schlüssel ungültig, läuft zplCore im Testmodus und nennt den Grund in ZplCoreLicense.Status.Message.
- zplCore Designer: Der Schlüssel muss das Produkt Designer enthalten und eine SDK-Lizenz derselben oder einer höheren Lizenzart. Option
License,ZPLCORE_LICENSE, Containerdocker run -e ZPLCORE_LICENSE=…, Helmlicense.existingSecret. Jede API-Antwort trägt den HeaderX-ZplCore-License. - Kommandozeilenwerkzeug und MCP-Server:
--license <Schlüssel|Datei>oder die Umgebungsvariablen und die Datei oben.
Status prüfen
var status = ZplCoreLicense.Status; // SDK
Console.WriteLine($"{status.State}: {status.Message}");
var designer = ZplCoreLicense.GetStatus(ZplLicenseProduct.Designer);
| Zustand | Bedeutung | Ausgaben gekennzeichnet |
|---|---|---|
Licensed | gültige Lizenz | nein |
Unlicensed | kein Schlüssel gefunden | ja |
Trial | gültiger Testschlüssel | ja |
Expired | Test- oder Abo-Laufzeit beendet | ja |
VersionNotCovered | diese Version erschien nach Ihrem Wartungsende | ja |
ProductNotLicensed | der Schlüssel enthält das Produkt nicht (Designer: keine SDK-Lizenz derselben oder höheren Lizenzart) | ja |
Invalid | Schlüssel beschädigt oder nicht echt | ja |
Wie lange ein Schlüssel gilt
- Dauerlizenz: gilt für alle Versionen, die bis zum Ende der Wartung erschienen sind, und läuft für diese nie ab. Endet die Wartung, laufen Ihre vorhandenen Versionen ohne Kennzeichnung weiter; für spätere Versionen verlängern Sie die Wartung.
- Abonnement: gilt bis zum Ende der Laufzeit; danach läuft zplCore im Testmodus weiter – es hält nicht an.
- Testversion: 30 Tage, danach Testmodus.
Der Schlüssel enthält den Lizenznehmer, die Lizenzart (Developer, Team, OEM/SaaS, Enterprise, Testversion), die Produkte (SDK, Designer), die Zahl der Lizenzplätze und das Ende der Wartung bzw. der Laufzeit. zplCore zählt keine Plätze; die Zahl gehört zu Ihren Lizenzbedingungen.
Hinweis „by zplCore.com“
ZplCoreLicense.Attribution = true schreibt klein by zplCore.com unten rechts in jedes Etikett (Bilder, PDF, SVG und erzeugtes ZPL) und einen Streifen unter Barcodes aus dem Barcode-Generator, auch mit gültiger Lizenz – für öffentliche Dienste, die Etiketten für andere erzeugen.
Schlüssel verloren oder versehentlich bekannt geworden: Schreiben Sie an support@zplcore.com – Sie erhalten einen Ersatzschlüssel.

