Jede Version aus einem einzigen Schlüsselpaar lizenzieren
Die Signaturschlüssel bei jeder Hauptversion zu rotieren ist die Falle: Es bricht ältere Builds, erzwingt eine Massenmigration und gibt Ihnen keine Kontrolle pro Kunde. Das bessere Modell behält ein einziges Schlüsselpaar für die gesamte Lebensdauer des Produkts und trägt das, was eine Lizenz darf — welche Versionen sie ausführt, welche Funktionen sie freischaltet, wie viel sie nutzen darf — in signierten Entitlements. Dieser Beitrag zeigt die drei Muster mit echtem Code, wie die Freigaben online wie offline fälschungssicher bleiben und wann stattdessen die vollständige Release-Abdeckung angebracht ist.
Es gibt eine verlockende Abkürzung, wenn Sie eine neue Hauptversion eines kostenpflichtigen Produkts veröffentlichen: die Lizenzen der neuen Version mit einem neuen Signaturschlüsselpaar ausstellen, den neuen öffentlichen Schlüssel in den neuen Build einbetten und die alten Schlüssel aufhören lassen zu verifizieren. Das sieht nach einem sauberen Schnitt aus. Es ist eine Falle.
Ein an eine Version gebundenes Schlüsselpaar bricht alles Ältere: Ein 3.x-Build kann eine mit dem 4.x-Schlüssel signierte Lizenz nicht verifizieren und umgekehrt. Sie sind gezwungen, alle zahlenden Kunden auf einmal neu auszustellen und zu migrieren, nach Ihrem Zeitplan, nicht ihrem. Und Sie erhalten keine Granularität: Sie können die Lizenz eines Kunden nicht sowohl 3.x als auch 4.x abdecken lassen, weil der Schlüssel alles oder nichts ist. Das Schlüsselpaar ist der falsche Ort, um eine kommerzielle Entscheidung zu kodieren.
Das Modell: ein Schlüsselpaar, für die gesamte Lebensdauer des Produkts
Behalten Sie ein einziges Signaturschlüsselpaar für das Produkt, für immer. Der in Ihre App eingebettete öffentliche Schlüssel bewegt sich nie: Die Veröffentlichung von 4.0 rührt ihn nicht an. Tragen Sie das, was eine Lizenz darf, in Entitlements: signierte Name → Wert-Freigaben, die in der Lizenz mitfahren und gegen den bereits eingebetteten Schlüssel verifiziert werden.
Ändern Sie, was ein Kunde ausführen, freischalten oder nutzen darf, indem Sie seinen Schlüssel neu ausstellen — niemals indem Sie Schlüssel rotieren und einen neuen öffentlichen Schlüssel ausliefern.
Ein Entitlement wird auf zwei Wegen geliefert, die Ihre App bereits verifiziert: in der Offline-Lizenzdatei und im kurzlebigen Online-Aktivierungs-Lease. Beide sind RSA-signiert und werden gegen Ihren eingebetteten öffentlichen Schlüssel geprüft, sodass ein Kunde keine Freigabe hinzufügen, kein Flag umlegen und keine Zahl anheben kann — jede Bearbeitung bricht die Signatur und das SDK lehnt das gesamte Artefakt ab. Da jedes SDK (.NET, Node, Python, Java) und das rohe HTTP-Format dieselbe signierte Nutzlast verifizieren, werden dieselben Freigaben in einer mehrsprachigen Produktlinie aus einem einzigen öffentlichen Schlüssel gleich gelesen.
Fall 1 — Versionskontrolle, ohne Schlüssel zu rotieren
Ihre App kennt ihre eigene Hauptversion. Die Lizenz trägt die höchste Hauptversion, die sie abdeckt. Führen Sie nur auf oder unter dieser Obergrenze aus:
const int runningMajor = 4; // this build's major version
var raw = info.Entitlements.GetRaw("max_major_version"); // e.g. "3" or "4" (a name you choose)
int ceiling = int.TryParse(raw, out var m) ? m : 3; // absent => your pre-coverage default
if (runningMajor > ceiling)
ShowUpgradeRequired($"Your license covers up to v{ceiling}.x.");
Eine für die 3.x-Linie verkaufte Lizenz trägt max_major_version: "3" — oder nichts, wenn sie dem Schema vorausgeht, in welchem Fall Ihr Code „fehlend” als die letzte Hauptversion vor dem Hinzufügen der Regel behandelt. Veröffentlichen Sie 4.0, und sie lehnt diesen Schlüssel lokal ab, gegen den bereits in der App vorhandenen öffentlichen Schlüssel. Ein Kunde, der das 4.0-Upgrade kauft, erhält seinen Schlüssel mit "4" neu ausgestellt. Eine höhere Obergrenze läuft weiterhin auf älteren Builds, sodass eine 4.x-Lizenz auf 3.x weiter funktioniert. Kein Schlüssel wurde bewegt; kein Build hat einen neuen öffentlichen Schlüssel ausgeliefert.
Fall 2 — eine Funktion freischalten
Eine boolesche Freigabe — ein oder aus. Der Accessor behandelt true, 1, yes oder enabled als ein:
if (info.Entitlements.IsEnabled("feature.pdf_export"))
EnablePdfExport();
Das ist die Freischaltung pro Edition: „Export”, „SSO”, „erweiterte Berichte” schalten sich aus der Lizenz des Kunden ein, offline verifiziert, und Sie ändern, wer was erhält, durch Neuausstellung — kein neuer Build. (Operative Feature-Flags für ein von Ihnen gesteuertes Rollout legen sich innerhalb dessen, was das Entitlement bereits erlaubt; das Entitlement ist stets die harte Schranke.)
Fall 3 — ein numerisches Kontingent durchsetzen
Eine Zahl, für die der Kunde bezahlt hat: Sitze, Projekte, API-Aufrufe, Geräte. Das Limit-Lesen behandelt "unlimited" als praktisch unendlich, und der Rückfallwert ist das, was ein fehlender Wert erhält (fail closed):
long maxProjects = info.Entitlements.GetLimit("max_projects", fallback: 3);
if (currentProjectCount >= maxProjects)
throw new QuotaExceeded($"Your plan allows {maxProjects} projects.");
Das Limit eines Kunden anzuheben ist eine Schlüssel-Neuausstellung mit einem neuen max_projects. Kein Build, keine Schlüsseländerung, und es wird bei seiner nächsten Lease-Erneuerung oder nächsten Offline-Lizenz wirksam.
Die Freigaben festlegen
Hängen Sie Entitlements an, wenn Sie einen Schlüssel ausstellen oder aktualisieren — über das Dashboard oder die Admin-API:
curl -X POST "https://keyright.example.com/admin/licenses" \
-H "X-Admin-Token: $KEYRIGHT_ADMIN_TOKEN" -H "Content-Type: application/json" \
-d '{ "licensee": "Acme Ltd", "product": "your-product", "tier": "pro",
"entitlements": { "max_major_version": "3", "feature.pdf_export": "true", "max_projects": "10" } }'
Besser noch: Legen Sie die Standardwerte auf die Editions-/Tarifvorlage, sodass jeder darunter ausgestellte Schlüssel sie erbt. So funktioniert „ab jetzt automatisch”: Setzen Sie max_major_version heute auf Ihre aktuelle Edition, und wenn Sie die nächste Hauptversion veröffentlichen, heben Sie die Vorlage an (oder fügen Sie eine neue Edition hinzu). Jeder danach geprägte Schlüssel trägt die neue Obergrenze; jeder bereits im Feld befindliche Schlüssel behält das, womit er ausgestellt wurde, und funktioniert weiter.
Wann stattdessen zur Release-Abdeckung greifen
Ein einfaches max_major_version-Entitlement beantwortet „welche Versionen diese Lizenz ausführen darf” auf der Granularität einer Hauptversion. Wenn Sie nach Veröffentlichungsdatum, Wartungsfenstern oder exakten Versionsbereichen verkaufen — „jedes 2.x-Release”, „alles, was im Jahr nach dem Kauf erscheint”, „was immer erscheint, solange das Abonnement aktiv ist” — verwenden Sie die erstklassige Release-Abdeckung von Keyright, die die vollständige Abdeckungsmenge erfasst und signiert und die Berechtigung für jeden konkreten Build beantwortet. Das Entitlement ist die leichtgewichtige, hauptversionsgenaue Variante derselben Idee; die Release-Abdeckung ist die präzise.
Das Fazit
Ihr Signaturschlüsselpaar identifiziert Ihr Produkt, nicht eine Version davon. Halten Sie es für die gesamte Lebensdauer des Produkts stabil und lassen Sie signierte Entitlements die kommerziellen Entscheidungen tragen — welche Versionen eine Lizenz ausführt, welche Funktionen sie freischaltet, wie viel sie nutzen darf. Sie ändern, was ein Kunde darf, indem Sie seinen Schlüssel gegen den bereits ausgelieferten Schlüssel neu ausstellen, und ältere Builds brechen nie, weil sich der öffentliche Schlüssel nie bewegt hat.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.