zplCore.comzplCore.com

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:

  1. im Code, einmal beim Start: ZplCoreLicense.Register(schlüssel) oder ZplCoreLicense.RegisterFile(pfad),
  2. Umgebungsvariable ZPLCORE_LICENSE (der Schlüssel selbst),
  3. Umgebungsvariable ZPLCORE_LICENSE_FILE (Pfad einer Datei mit dem Schlüssel),
  4. Datei zplcore.license neben 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, Container docker run -e ZPLCORE_LICENSE=…, Helm license.existingSecret. Jede API-Antwort trägt den Header X-ZplCore-License.
  • Kommandozeilenwerkzeug und MCP-Server: --license <Schlüssel|Datei> oder die Umgebungsvariablen und die Datei oben.
Behandeln Sie den Schlüssel vertraulich wie ein Passwort – im Secret Store, als CI-Secret oder in einer Umgebungsvariable. Er gehört nie in öffentliche Repositories, Pakete oder Beispiele.

Status prüfen

var status = ZplCoreLicense.Status;                                  // SDK
Console.WriteLine($"{status.State}: {status.Message}");
var designer = ZplCoreLicense.GetStatus(ZplLicenseProduct.Designer);
ZustandBedeutungAusgaben gekennzeichnet
Licensedgültige Lizenznein
Unlicensedkein Schlüssel gefundenja
Trialgültiger Testschlüsselja
ExpiredTest- oder Abo-Laufzeit beendetja
VersionNotCovereddiese Version erschien nach Ihrem Wartungsendeja
ProductNotLicensedder Schlüssel enthält das Produkt nicht (Designer: keine SDK-Lizenz derselben oder höheren Lizenzart)ja
InvalidSchlüssel beschädigt oder nicht echtja

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.