Skip to content
← Alle Beiträge
· Delta1 Labs LicensingKeyright

Named-User- vs. Geräte-Seats in Keyright

Ein Sitz kann eine Maschine oder eine Person bedeuten, und beide zählen unterschiedlich. So binden, erzwingen und gleichen Sie Geräte- und Named-User-Sitze in Keyright ab, ohne zu überverkaufen oder zahlende Nutzer auszusperren.

Die meisten Lizenzierungsfehler sind nicht kryptografisch. Es sind Zählfehler: Sie haben „fünf Sitze” verkauft und meinten fünf Personen, aber Ihre Durchsetzung zählt fünf Maschinen, sodass der Vertriebsingenieur, der die App auch auf einem Laptop und einer VM laufen lässt, allein drei der fünf Sitze aufbraucht. Niemand hat etwas angegriffen. Die Lizenz zählt einfach ein anderes Substantiv als das auf dem Bestellformular.

Keyright lässt einen Sitz beide Substantive bedeuten. In diesem Beitrag geht es darum, bewusst zwischen beiden zu wählen, eine Aktivierung an die richtige Dimension zu binden, die Obergrenze dagegen zu erzwingen und – der Teil, über den Teams stolpern – die beiden Modelle abzugleichen, wenn Sie von einem zum anderen wechseln müssen, ohne Kunden auszusperren, die nichts falsch gemacht haben.

Zwei Dinge, die ein Sitz bedeuten kann

Ein Sitz ist eine Einheit gleichzeitiger Berechtigung. Die einzige echte Frage ist, was einen verbraucht.

Geräte-Sitze

Ein Geräte-Sitz ist an eine Maschine gebunden. Das SDK berechnet bei der Aktivierung einen stabilen Maschinen-Fingerabdruck, der ausstellende Dienst speichert ihn, und die Sitzobergrenze der Lizenz wird gegen die Anzahl eindeutiger Fingerabdrücke erzwungen. Fünf Geräte-Sitze bedeuten höchstens fünf Maschinen, die gleichzeitig eine lebende Aktivierung halten. Das ist das richtige Modell für gemeinsam genutzte Arbeitsplätze, Kioske, Build-Agenten und alles, wo „wer dort sitzt” irrelevant ist – Sie lizenzieren die Installation, nicht den Menschen.

Der Fehlerfall ist der Power-User mit drei Geräten. Unter Geräte-Sitzen sind das drei Sitze, und wenn auf Ihrer Preisliste „pro Nutzer” stand, fehlen Ihnen nun zwei Sitze für dasselbe Geld.

Named-User-Sitze

Ein Named-User-Sitz ist an eine Identität gebunden – eine E-Mail, ein SSO-Subjekt, eine Mitarbeiter-ID – die als stabile Nutzerreferenz in die Aktivierung getragen wird. Die Sitzobergrenze wird gegen die Anzahl eindeutiger Identitäten erzwungen, und jede Identität darf auf so vielen ihrer eigenen Geräte aktivieren, wie die Lizenz erlaubt. Fünf Named-User-Sitze bedeuten fünf Personen, jede auf ihrem Laptop, Desktop und ihrer VM, ohne Aufpreis. Das entspricht der Art, wie die meiste B2B-Software tatsächlich verkauft wird.

Ihr Fehlerfall ist der geteilte Login: Wenn zehn Personen unter einem einzigen ops@acme.example aktivieren, zählen Sie einen Sitz und verlieren neun. Named-User-Sitze sind nur ehrlich, wenn die Identität eine ist, die der Kunde nicht ohne Weiteres teilen kann – ein SSO-Subjekt, kein geteiltes Postfach.

Geräte-SitzeNamed-User-SitzeLaptopDesktopVM1 Sitz1 Sitz1 Sitz3 Sitze belegtzählt Maschinen: ein Nutzer,drei Fingerabdrücke, drei SitzeLaptopDesktopVMalice@acme1 Sitz belegtzählt Personen: eine Identität,drei Geräte, ein Sitz

Eine Aktivierung an die richtige Dimension binden

Das SDK wird für beide Modelle gleich initialisiert; der Unterschied ist, was Sie an die Aktivierung anhängen. Für eine selbstgehostete Bereitstellung richten Sie den Client auf Ihren ausstellenden Dienst und pinnen den öffentlichen Schlüssel, mit dem die Lizenzen signiert sind:

var keyright = new KeyrightClient(new KeyrightOptions
{
    Product         = "acme-suite",
    PublicKeyBase64 = EmbeddedPublicKey,                 // pinnt, wem Sie beim Signieren vertrauen
    ServiceUrl      = "https://license.acme.example"     // Ihre selbstgehostete Instanz
});

Für ein Produkt mit Geräte-Sitzen aktivieren Sie nur mit dem Maschinen-Fingerabdruck. Das SDK leitet ihn aus stabilen Hardware- und Betriebssystemsignalen ab; Sie berechnen ihn nicht von Hand.

// Gerätegebunden: der Sitz ist die Maschine. Es wird keine Identität gesendet.
var result = await keyright.ActivateAsync(licenseKey);
if (result.Status == ActivationStatus.SeatsExhausted)
    ShowUpgradePrompt(result.SeatsUsed, result.SeatCeiling);

Für ein Named-User-Produkt übergeben Sie zusätzlich eine stabile Nutzerreferenz. Machen Sie sie zur manipulationssichersten Identität, die Sie haben – ein SSO-Subjekt (sub-Claim) ist ideal, weil der IdP des Kunden selbst dafür bürgt und ein Nutzer keine zweite prägen kann, um die Zählung zu umgehen.

// Named-User: der Sitz ist die Person. Der Fingerabdruck reist weiter für Gerätelimits mit.
var result = await keyright.ActivateAsync(licenseKey, new ActivationContext
{
    UserRef = currentUser.Subject                        // z. B. der „sub"-Claim aus OIDC
});

Der Fingerabdruck begleitet eine Named-User-Aktivierung weiterhin, und genau das erlaubt Ihnen, Geräte pro Nutzer zu begrenzen (etwa „Named-User, bis zu 5 Geräte je”) – eine zweite Obergrenze, die der ausstellende Dienst unabhängig von der Nutzerzählung erzwingt. Beide Bindungen bei jeder Aktivierung zu senden, macht auch die untenstehende Migration schmerzlos: Eine Aktivierung, die beide trägt, kann in beide Richtungen gezählt werden.

Die Obergrenze am richtigen Ort erzwingen

Die Sitzzählung ist eine serverseitige Entscheidung – man kann einem Client nicht zutrauen, seine eigene Population zu zählen – aber die lizenzierte App muss Funktionen dennoch lokal einschränken und fail-closed scheitern. Die beiden Aufgaben trennen sich sauber.

Der ausstellende Dienst besitzt die Zählung. Wenn eine Aktivierung eintrifft, projiziert er die Anfrage auf die konfigurierte Dimension der Lizenz und vergleicht sie mit der Obergrenze. Im Pseudocode ist die Regel für beide Modelle gleich; nur der Schlüssel ändert sich:

// Innerhalb des ausstellenden Dienstes, vereinfacht.
string seatKey = license.SeatModel switch
{
    SeatModel.Device    => request.Fingerprint,          // ein Sitz pro Maschine
    SeatModel.NamedUser => request.UserRef               // ein Sitz pro Identität
        ?? throw new MissingUserRefException(),          // Named-User braucht eine Identität
    _ => throw new UnreachableException()
};

var distinct = await _seats.CountDistinctAsync(license.Id, license.SeatModel);
bool alreadyHeld = await _seats.HoldsAsync(license.Id, seatKey);
if (!alreadyHeld && distinct >= license.SeatCeiling)
    return ActivationResult.SeatsExhausted(distinct, license.SeatCeiling);

await _seats.UpsertAsync(license.Id, seatKey, request.Fingerprint);

Beachten Sie, dass das erneute Aktivieren einer Identität (oder einer Maschine), die bereits einen Sitz hält, idempotent ist: alreadyHeld kürzt die Obergrenzen-Prüfung ab, sodass Alice, die ihren dritten Laptop unter Named-User-Sitzen hinzufügt, nie „Sitze erschöpft” auslöst, während eine sechste eigenständige Person es tut.

Die App ihrerseits zählt nie etwas. Sie validiert die signierte Lizenz, die sie besitzt, und schränkt anhand der Berechtigungen fail-closed ein, damit ein Netzausfall nie stillschweigend eine Funktion freischaltet:

var info = await keyright.ValidateAsync();
if (!info.IsValid || !info.Entitlements.Has("reporting"))
    throw new FeatureLockedException("reporting");       // lokal, offline-sicher, jedes Mal

Geräte-Sitze zu Named-User-Sitzen abgleichen

Die schwierige Migration geht von Gerät zu Named-User, denn die Zählungen sind nicht austauschbar, und eine nachlässige Umstellung überverkauft entweder (Sie gewähren einen Sitz pro Gerät, nun gratis) oder sperrt aus (Sie gewähren einen Sitz pro Nutzer, aber manche Nutzer überschreiten plötzlich ihre alte Gerätezahl). Der sichere Weg sind drei geordnete Schritte, und der erste verschafft Ihnen Zeit.

1. Beginnen Sie, die Identität mitzuführen, bevor Sie das Modell ändern. Liefern Sie eine Version aus, die UserRef bei der Aktivierung sendet, während die Lizenz noch Geräte zählt. Für den Kunden ändert sich nichts, aber jede neue Aktivierung erfasst nun, welche Person jede Maschine besitzt. Lassen Sie das reifen, bis die meisten lebenden Aktivierungen eine Identität tragen.

2. Gleichen Sie ab, dann dimensionieren Sie die neue Lizenz. Gruppieren Sie die erfassten Geräte-Aktivierungen nach ihrer UserRef. Jede Gruppe ist ein künftiger Named-User-Sitz; die Gruppengröße sagt Ihnen, wie viele Geräte dieser Nutzer betreibt. Die Anzahl der Gruppen ist die Zahl der Named-User-Sitze, die der Kunde tatsächlich braucht – fast immer weniger als seine Gerätezahl, und das ist das Verkaufsargument für die Umstellung.

// Fasst Geräte-Aktivierungen zu Named-User-Sitzen zusammen.
var seatsNeeded = activations
    .Where(a => a.UserRef is not null)
    .GroupBy(a => a.UserRef)
    .Select(g => new NamedUserSeat(g.Key!, devices: g.Count()))
    .ToList();

int newCeiling = seatsNeeded.Count;                      // Personen, keine Maschinen
int maxDevices = seatsNeeded.Max(s => s.Devices);        // dimensioniert die Geräte-pro-Nutzer-Grenze

3. Stellen Sie eine neue Lizenz aus, die Nutzer zählt, bemessen am Abgleich. Setzen Sie die Obergrenze auf newCeiling (plus den Spielraum, den Sie verkaufen) und die Geräte-pro-Nutzer-Grenze auf mindestens maxDevices, damit kein bestehender Nutzer rückwirkend über dem Limit liegt. Da Apps im Feld gegen die signierte Lizenz validieren, die sie erhalten werden, ist die Umstellung für sie unsichtbar: Sie laufen weiter, der ausstellende Dienst beginnt einfach, ein anderes Substantiv zu zählen. Aktivierungen, die nie eine UserRef gemeldet haben, sind Ihre Aufräumliste: veraltete Maschinen, die Sie auslaufen lassen, oder Nutzer, denen Sie eine Identität abringen.

Die umgekehrte Migration, von Named-User zurück zu Gerät, ist einfacher und selten gewünscht: Jeder bereits vorhandene eindeutige Fingerabdruck wird zu einem Geräte-Sitz, sodass Sie nur eine Obergrenze brauchen, die mindestens so groß ist wie die aktuelle Zahl eindeutiger Geräte.

Wählen Sie das Substantiv, dann zählen Sie es

All dies läuft auf eine Disziplin hinaus: Entscheiden Sie, ob ein Sitz eine Maschine oder eine Person ist, bevor Sie die Lizenz bepreisen, binden Sie die Aktivierung genau an dieses Substantiv und lassen Sie den ausstellenden Dienst diese eine Dimension zählen. Geräte-Sitze für Installationen, Named-User-Sitze für Personen, und eine nicht teilbare Identität, wenn es um Personen geht. Führen Sie beide Bindungen bei jeder Aktivierung mit, und das Modell wird zu einer serverseitigen Einstellung, die Sie – mit einem Abgleichslauf – ändern können, statt zu einer Entscheidung, die in Ihrer Feldpopulation eingefroren ist.

Beide Sitzmodelle laufen auf selbstgehostetem Keyright, einschließlich der kostenlosen Community Edition für ein einzelnes Produkt und eine moderate Lizenzzahl; Multi-Produkt-Flotten und größere Sitz-Pools sind ein Upgrade auf eine kostenpflichtige Self-License. In jedem Fall ist die Zählregel dieselbe, und das Einzige, was je einen zahlenden Nutzer aussperrt, ist, einen Sitz an das falsche Substantiv zu binden.

Nebula.NET testen

Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.