Lizenz-Entitlements vs. Feature Flags
Ein Feature Flag ist ein operativer Schalter, den Sie steuern; ein Lizenz-Entitlement ist eine signierte kommerzielle Berechtigung, für die der Kunde bezahlt hat. Verwechselt man beides, schaltet ein Kunde ein Flag um und schaltet frei, was er nie gekauft hat. Dieser Beitrag zieht die Grenze, zeigt die Fehlerbilder des falschen Werkzeugs, liefert eine Entscheidungstabelle und verdrahtet die kombinierte Keyright-Architektur: Entitlements als harte Schranke, Feature Flags darüber für das Rollout innerhalb dessen, worauf der Kunde Anspruch hat.
Greifen Sie zu einem Feature-Flag-System, um eine kostenpflichtige Funktion abzusichern, und der Code sieht am ersten Tag richtig aus. flags.IsEnabled("advanced-reports") umschließt den Export-Button, der Schalter ist für Gratisnutzer aus und für zahlende an, und die Demo läuft. Dann öffnet ein Kunde den Flag-Speicher, den Sie ihm überlassen haben, legt den Schalter um und erhält eine Funktion, die er nie gekauft hat – oder Ihr Rollout-Dienst hat einen schlechten Nachmittag, der Client fällt auf seinen Standardwert zurück, und jede Installation schaltet auf einmal zu viel oder zu wenig frei. Nichts wurde gehackt. Das Werkzeug war schlicht das falsche: Ein Feature Flag ist ein operativer Schalter, und Sie haben damit eine kommerzielle Grenze gezogen.
Dieser Beitrag zieht die Grenze zwischen den beiden, zeigt, was bricht, wenn man sie überschreitet, und verdrahtet sie dann richtig in einer mit Keyright lizenzierten .NET-Anwendung: Entitlements als harte Schranke, Flags darüber für das Rollout innerhalb dessen, worauf der Kunde Anspruch hat.
Zwei Werkzeuge, die sich ähneln und es nicht sind
Beide beantworten eine Ja/Nein-Frage, ob eine Fähigkeit laufen soll, daher sind sie leicht zu verwechseln. Der Unterschied liegt darin, wer die Antwort steuert und ob die Antwort vertrauenswürdig ist.
Ein Feature Flag ist ein veränderlicher Schalter, den Sie steuern. Sie setzen ihn, ändern ihn, rollen ihn auf 5 % der Konten und dann auf alle aus, entfernen ihn, wenn ein Experiment endet. Es ist ein Betriebs- und Auslieferungsmechanismus. Er hat keine kryptografische Integrität, weil er sie nicht braucht: Wer das Flag liest (Ihre App) und wer es setzt (Sie), stehen auf derselben Seite.
Ein Lizenz-Entitlement ist eine signierte, manipulationssichere Berechtigung, gebunden an das, wofür der Kunde bezahlt hat. Der Kunde hält die Lizenz; Sie halten den privaten Schlüssel, der sie signiert hat. Die App prüft die Signatur gegen einen eingebetteten öffentlichen Schlüssel, sodass der Entitlement-Satz von der Partei, die er einschränkt, weder gefälscht noch bearbeitet werden kann. Es ist eine kommerzielle Grenze, und ihr ganzer Wert liegt darin, dass die Person auf der anderen Seite sie nicht selbst umlegen kann.
Fehlerbild 1 — Flags für die Lizenzierung
Sichern Sie eine kostenpflichtige Fähigkeit mit einem Flag ab, und Sie erben drei Probleme auf einmal.
Trivial umgangen. Was auch immer das Flag speichert – eine Konfigurationsdatei, eine lokale Datenbank, ein Cache, den das SDK auf die Platte schreibt – ist für den Kunden erreichbar. Keine Signatur deckt es ab, also hat das Bearbeiten keine erkennbare Folge. Die „Grenze” ist ein Boolean, den die eingeschränkte Partei auf true setzen kann.
Keine Offline-Geschichte. Ein gehosteter Flag-Dienst antwortet über das Netzwerk; ist er nicht erreichbar, liefert der Client einen Standardwert. Ein Standardwert ist eine gute Antwort auf „soll dieses Experiment an sein?” und eine schlechte auf „hat dieser Kunde das gekauft?”. Sie landen bei der Wahl zwischen offen scheitern (kostenpflichtige Funktionen während eines Ausfalls verschenken) und geschlossen scheitern (Funktionen kaputt machen, die Ihr Kunde rechtmäßig bezahlt hat, weil Ihr Dienst geblinzelt hat).
Keine Integrität, also kein Audit. Entsteht ein Streit darüber, worauf ein Kunde Anspruch hatte, ist eine signierte Lizenz ein Beweis: Sie sagt, was gewährt wurde, von wem, bis wann, und die Signatur belegt, dass sie nicht verändert wurde. Ein Flag-Wert ist nur eine Zeile, die jemand geschrieben haben könnte.
Fehlerbild 2 — Entitlements für ein gestaffeltes Rollout
Der umgekehrte Fehler ist subtiler. Angenommen, Sie liefern eine neue Report-Engine aus und wollen sie montags für 5 % der berechtigten Kunden einschalten, mittwochs für 50 %, freitags für alle – ein klassisches Rollout. Modellieren Sie das mit dem Entitlement, ist jede Stellung des Reglers eine Neuausstellung: eine neue signierte Lizenz, ein Durchlauf durch Ihre kommerzielle Pipeline, eine Neuaktivierung beim Kunden. Entitlements sind bewusst teuer zu ändern, weil sie Geld darstellen; dieser Preis ist genau der falsche für einen operativen Knopf, den Sie dreimal pro Woche drehen wollen. Sie würden außerdem kommerzielle Berechtigungen für eine Entscheidung prägen, die nichts damit zu tun hat, wofür jemand bezahlt hat, und so genau das verschmutzen, dessen ganzer Wert darin besteht, nur den Kauf abzubilden.
Die Entscheidungstabelle
| Dimension | Feature Flag | Lizenz-Entitlement |
|---|---|---|
| Integrität | Keine – ein veränderlicher Wert, ohne Signatur | Kryptografisch signiert, manipulationssicher |
| Wer steuert es | Sie (der Anbieter), zur Laufzeit | Von Ihnen gewährt, beim Kunden gehalten, von der App geprüft |
| Offline-Verhalten | Fällt auf einen Standardwert zurück; braucht oft das Netzwerk | Lokal gegen den eingebetteten öffentlichen Schlüssel validiert; scheitert geschlossen |
| Änderungslatenz | Sekunden – umlegen und es ist live | Eine Neuausstellung: neue Signatur, Neuaktivierung |
| Zielgruppe | Eine Kohorte Ihrer Wahl (Prozentsatz, Ring, Konto) | Der konkrete Kunde und was er gekauft hat |
| Richtiger Einsatz | Rollout, Experimente, Notschalter, Betriebsschalter | Kommerzielle Grenzen: Editionen, Sitzplatzgrenzen, kostenpflichtige Fähigkeiten |
Lesen Sie die Tabelle als eine einzige Regel: Muss die Antwort einen feindseligen Kunden und ein ausgefallenes Netzwerk überstehen, ist es ein Entitlement; müssen Sie sie schnell ändern und sollten der Einzige sein, der es kann, ist es ein Flag.
Entitlements in Keyright
Ein Keyright-Entitlement wird aus einer lokal validierten Lizenz gelesen. Sie initialisieren den Client einmal mit Ihrem Produktnamen und Ihrem nur zur Prüfung dienenden öffentlichen Schlüssel und validieren dann – offline, gegen den eingebetteten Schlüssel.
using Keyright;
static readonly KeyrightClient License = KeyrightClient.Initialize(new KeyrightOptions
{
Product = "acme-analytics",
PublicKeyBase64 = "MIIBIjANBgkq...", // verify-only; ships in the binary
ServiceUrl = "https://keyright.example.com", // only needed to activate online
});
// Local, no network: verifies signature, expiry, node-lock and the entitlement set.
// Never throws for license state; fails closed to Community Edition.
LicenseInfo info = await License.ValidateAsync();
bool canExport = info.Entitlements.IsEnabled("advanced-reports");
info.Entitlements ist der signierte Satz, für den der Kunde bezahlt hat. IsEnabled ist ein reiner lokaler Lesevorgang – kein Rundlauf – und da die Validierung geschlossen scheitert, löst sich eine fehlende, abgelaufene oder manipulierte Lizenz zur Community Edition auf, wobei das Entitlement false liest. Das ist die harte Schranke: Die Fähigkeit ist nicht verfügbar, es sei denn, die signierte Berechtigung sagt etwas anderes, und nichts, was der Kunde bearbeiten kann, ändert diese Antwort.
Ein Flag mit einem Entitlement komponieren
Nun die eigentliche Architektur: die beiden Werkzeuge geschichtet, nicht ersetzt. Das Entitlement entscheidet, ob dieser Kunde die Fähigkeit überhaupt je haben darf; das Flag entscheidet, ob wir sie für ihn schon eingeschaltet haben. Die Reihenfolge ist nicht verhandelbar: Das Entitlement schrankt, das Flag grenzt nur ein.
public sealed class ReportService
{
private readonly IFeatureFlags _flags; // your rollout system (OpenFeature, homegrown…)
public ReportService(IFeatureFlags flags) => _flags = flags;
public async Task<IActionResult> RunAdvancedReport(ReportRequest req)
{
LicenseInfo info = await License.ValidateAsync();
// 1. Hard gate: did the customer PAY for this capability? Signed, offline, fail-closed.
if (!info.Entitlements.IsEnabled("advanced-reports"))
return Forbid("advanced-reports is not part of your plan");
// 2. Rollout narrowing: is the new engine turned on for this account yet?
// This can only withhold a paid feature during rollout — never grant an unpaid one.
if (!_flags.IsEnabled("advanced-reports-v2-rollout"))
return await RunLegacyReport(req);
return await RunReportV2(req);
}
}
Lesen Sie die beiden Prüfungen. Die Entitlement-Prüfung ist tragend: Entfernen Sie sie, erreicht jedes Konto die Funktion. Die Flag-Prüfung ist einschränkend: Entfernen Sie sie, bekommen berechtigte Kunden einfach alle v2 auf einmal – eine Rollout-Entscheidung, nie eine Sicherheitsentscheidung. Da das Flag innerhalb des Erfolgszweigs des Entitlements sitzt, ist es strukturell unmöglich, dass ein Flag eine unbezahlte Fähigkeit freischaltet. Das Schlimmste, was ein falsch konfiguriertes Flag tun kann, ist, einen zahlenden Kunden eine Weile auf dem alten Pfad zu halten.
Dieselbe Komposition drückt ein gestaffeltes Rollout einer brandneuen kostenpflichtigen Fähigkeit aus. Berechtigen Sie sie, sobald sie verkauft ist, und schützen Sie dann das tatsächliche Einschalten hinter einem Prozent-Flag, um den Wirkungsradius zu steuern – ohne das Flag je zu dem werden zu lassen, was entscheidet, ob der Kunde sie gekauft hat.
if (info.Entitlements.IsEnabled("live-collaboration")
&& _flags.IsEnabled("collab-ga-rollout"))
{
EnableCollaboration();
}
Das && liest sich von links nach rechts, und das ist der ganze Entwurf: das Entitlement zuerst, weil es die kommerzielle Wahrheit ist, das Flag danach, weil es der operative Knopf ist. Tauschen Sie die Operanden, und Sie haben Fehlerbild 1 nachgebaut.
Wo numerische Grenzen hineinpassen
Dieselbe Aufteilung gilt für quantitative Grenzen. Eine Sitzplatzgrenze ist kommerziell – sie steht in der signierten Lizenz – also gehört sie zur Entitlement-Seite:
long maxSeats = info.Entitlements.GetLimit("max-seats", defaultValue: 1);
if (activeSeats >= maxSeats)
return Forbid("seat limit reached for your plan");
Ein Flag könnte dann steuern, wie Sie eine Überschreitung während eines Rollouts durchsetzen – harte Sperre gegen Kulanzbanner – aber die Zahl selbst, das an Geld Gebundene, bleibt im Entitlement, wo sie signiert und offline prüfbar ist.
Die Regel, in einer Zeile
Sichern Sie, wofür der Kunde bezahlt hat, mit einem Keyright-Entitlement: signiert, manipulationssicher, offline geprüft, nur durch eine bewusste Neuausstellung geändert. Sichern Sie, wie und wann Sie es ausrollen, mit einem Feature Flag: schnell, Ihres, wegwerfbar. Halten Sie das Flag strikt innerhalb des Ja des Entitlements, und die beiden verstärken sich, statt dass eines das andere stillschweigend aushebelt.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.