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

Maschinengebundene Schlüssel auf Floating-Lizenzen migrieren

Ein bereits ausgeliefertes .NET-Produkt von maschinengebundenen Aktivierungen auf einen Pool gleichzeitiger Floating-Plätze umzustellen ist eine Protokolländerung, kein bloßer Konfigurationsschalter – falsch umgelegt, verliert jede bestehende Installation ihren Platz oder wird doppelt gezählt. Dieser Leitfaden zeigt das Dual-Mode-SDK, den Seat-Model-Claim und die atomare serverseitige Abstimmung, mit denen die Umstellung gelingt, ohne auch nur einen Kunden zu zerbrechen.

Ein Floating-Lizenzpool sieht aus wie eine Servereinstellung: „25 gleichzeitige Benutzer statt 25 benannter Maschinen erlauben”. Das ist er nicht. Das Modell nach Maschinenzahl und das Modell gleichzeitiger Plätze sind zwei verschiedene Gespräche zwischen Client und Dienst, und die bereits installierten Clients können nur eines davon führen. Stellen Sie den Server um, bevor das Feld bereit ist, und Sie bekommen den schlimmsten Lizenzfehler überhaupt – einen, bei dem zahlende Kunden ausgesperrt sind und das Dashboard weiterhin meldet, alles sei in Ordnung.

Kernaussage: Behandeln Sie den Wechsel von gebunden zu Floating als rollende Protokollmigration. Legen Sie einen seat.model-Claim pro Schlüssel in die Lizenz, rollen Sie ein Dual-Mode-SDK aus, das ihn liest, lassen Sie dieses SDK das Feld zuerst erreichen, und beginnen Sie erst dann, Floating-Schlüssel auszustellen. Der Server stimmt die alte Aktivierung jeder Maschine atomar in den neuen Pool ein, sodass die gemeinsame Obergrenze durchgehend hält.

Die eigentliche Frage: Wer entscheidet das Modell, und wann?

Bei der Maschinenbindung bindet ein Client eine Lizenz an einen stabilen Maschinen-Fingerabdruck und validiert sie lokal; der Dienst führt eine Aktivierung pro Maschine und begrenzt die Zahl. Beim Floating besitzt der Client nichts Dauerhaftes – er ruft beim Start ClaimSeatAsync auf, erneuert eine kurze Lizenz per Heartbeat, und der Platz kehrt in den Pool zurück, wenn der Client beendet wird oder die Erneuerung einstellt.

Das sind unvereinbare Standardverhalten. Ein gebundener Client fordert nie einen Platz an; ein Floating-Client erwartet nie eine dauerhafte Bindung. Die Entscheidung kann also kein globales, zur Validierungszeit gelesenes Serverflag sein – sie muss in jeder Lizenz reisen, wo sowohl Server als auch Client sie lesen können, bevor sie einen Pfad wählen.

{
  "lic": "KR-7F3A-...",
  "product": "acme-suite",
  "seat": { "model": "floating", "max": 25, "leaseTtl": "00:05:00" },
  "exp": "2027-03-01T00:00:00Z"
}

Der seat-Claim wird als Teil der Lizenznutzlast signiert, ein Client kann sich also nicht von gebunden zu Floating fälschen, und das Modell ist eine Tatsache über den Schlüssel statt über die aktuelle Laune des Servers. Alte Schlüssel behalten "model": "node-locked"; erneuerte und neue Schlüssel erhalten "model": "floating".

Schritt 1: ein SDK ausrollen, das beide spricht

Das erste Lieferobjekt ist ein Client, der den Claim liest und verteilt. Das ist das Stück, das das Feld erreichen muss, bevor sich irgendein Schlüssel ändert, denn es ist die einzige Version, die nicht zerbricht, wenn sie auf einen Floating-Schlüssel trifft.

public async Task<SeatResult> AcquireAsync(CancellationToken ct = default)
{
    LicenseClaims claims = _verifier.Verify(_storedKey);   // Ed25519 check, fully local
    if (!claims.IsValid)
        return SeatResult.Invalid;

    return claims.Seat.Model switch
    {
        SeatModel.NodeLocked => BindToMachine(claims),              // legacy path, untouched
        SeatModel.Floating   => await ClaimFloatingSeatAsync(claims, ct),
        _                    => SeatResult.Invalid,                 // unknown model: fail closed
    };
}

Der gebundene Zweig ist der Code, den Sie bereits ausliefern, unverändert. Der Floating-Zweig fordert einen Platz an und hält ihn dann, indem er bei der Hälfte der Lizenz-TTL erneuert, sodass ein verpasster Heartbeat noch einen weiteren Versuch hat, bevor der Platz eingezogen wird.

async Task<SeatResult> ClaimFloatingSeatAsync(LicenseClaims claims, CancellationToken ct)
{
    SeatGrant seat = await _service.ClaimSeatAsync(claims.LicenseId, _fingerprint, ct);
    if (seat.Status == SeatStatus.PoolExhausted)
        return SeatResult.Denied("all seats in use");

    var half = claims.Seat.LeaseTtl / 2;
    _heartbeat = new Timer(_ => _ = _service.RenewSeatAsync(seat.Token, ct), null, half, half);
    return SeatResult.Granted(seat.Token, seat.ExpiresAtUtc);
}

Entscheidend ist, dass dieses SDK gegen beide Schlüsseltypen korrekt ist. Ein Kunde, der heute aktualisiert, arbeitet mit seinem gebundenen Schlüssel ohne jede Verhaltensänderung weiter. Das macht die Umstellung sicher: Die SDK-Migration und die Schlüsselmigration sind entkoppelt.

Schritt 2: jede Maschine beim Übergang abstimmen

Hier zählt eine naive Umstellung doppelt. Eine Maschine, die bereits eine gebundene Aktivierung hält und dann ihren ersten Floating-Platz anfordert, würde zwei Kapazitätseinheiten belegen – eine alte Aktivierung, die der Pool nicht sieht, plus einen aktiven Platz. Über eine ganze Flotte überverkauft das still die Obergrenze und beginnt, legitime Plätze zu verweigern.

Die Lösung lebt auf dem Server und muss atomar sein. Bei der ersten Floating-Anforderung von einem Fingerabdruck, der auf derselben Lizenz noch eine gebundene Aktivierung hält, zieht Keyright die Aktivierung zurück und gibt den Platz in einer einzigen Transaktion aus.

Grenze = 25Vorhergebunden25 AktivierungenUmstellungDual-Mode10 geb.15 FloatingDanachFloating-Pool25 gleichzeitige Plätze
Eine Obergrenze über die ganze Migration. Jede Maschine wechselt atomar von einer gebundenen Einheit zu einem Floating-Platz, sodass gebunden + Floating nie das Limit überschreitet.

Die administratorseitige Operation ist ein einziger idempotenter Aufruf, sodass eine nach einem Netzausfall wiederholte Anforderung nicht zweimal umwandelt:

# Server reconciles on first floating claim; the SDK triggers it transparently.
# To audit a license mid-migration, read its occupancy:
keyright seats show --license KR-7F3A-... --breakdown-by-model
#   model=node-locked  held=10
#   model=floating     active=15
#   ceiling=25  overcommit=0

Solange overcommit bei null bleibt, ist die Obergrenze intakt und Sie können weiter umwandeln, im Tempo, in dem das Feld aktualisiert.

Schritt 3: Schlüssel bei der Erneuerung umlegen, nicht alle auf einmal

Sie müssen nicht alle zu einem Stichtag migrieren. Weil das Modell pro Schlüssel gilt, folgt die sauberste Umstellung dem Erneuerungszyklus: Wenn ein gebundener Schlüssel erneuert wird, prägen Sie den Ersatz als Floating. Flotten, die das Dual-Mode-SDK vollständig übernommen haben, lassen sich en bloc umlegen; der Rest wandelt sich natürlich um, sobald sein Zeitraum abläuft.

keyright license reissue --license KR-7F3A-... \
    --seat-model floating --seat-max 25 --lease-ttl 00:05:00

Der Client übernimmt das neue Modell bei seiner nächsten Lizenzaktualisierung und ruft AcquireAsync über den Floating-Zweig auf – ohne Neuinstallation, ohne erneute Schlüsseleingabe, ohne Support-Ticket.

Vorbehalte: wo es wehtut

Die Reihenfolge ist nicht verhandelbar. Erreicht ein Floating-Schlüssel eine Maschine, die noch das alte Ein-Modell-SDK ausführt, trifft dieser Client auf ein unbekanntes Modell und kann sich – wenn er nicht so geschrieben wurde, dass er auf dem gebundenen Pfad geschlossen ausfällt – fehlverhalten. Rollen Sie die SDK-Adoptionstelemetrie aus und bestätigen Sie sie, bevor Sie einen einzigen Schlüssel neu ausstellen. Der Seat-Claim lässt beide Modelle genau deshalb koexistieren, damit Sie warten können.

Ein Absturz hält einen Platz bis zum Ablauf der Lizenz. Floating-Kapazität wird nur zurückgewonnen, wenn die Lizenz-TTL ohne Heartbeat abläuft; siehe Lizenz-Heartbeat und Lease-Einzug, um die TTL an Ihrem realen Beendigungsverhalten zu bemessen. Zu lang, und ein Laptop, der mitten in der Sitzung schlafen geht, blockiert einen Platz; zu kurz, und ein langsames Netz sperrt einen aktiven Benutzer aus.

Offline-Installationen gehören nicht in einen Pool. Floating braucht den Heartbeat-Umlauf. Halten Sie wirklich vom Netz getrennte Maschinen gebunden, mit einem begrenzten Offline-Kulanzfenster, und lassen Sie den seat.model-Claim diese Unterscheidung pro Kunde tragen, statt der ganzen Basis ein Modell aufzuzwingen.

Die Abstimmung muss atomar sein, sonst überverkaufen Sie. Das Zurückziehen-und-Gewähren muss eine einzige, mit einem Idempotenz-Token versehene Transaktion sein. Tun Sie es in zwei Schritten, wandelt eine wiederholte Anforderung dieselbe Maschine zweimal um und frisst still einen Platz aus der Obergrenze.

Fazit

Der Wechsel von gebunden zu Floating ist eine Migration, kein Schalter. Legen Sie das Modell in einen pro Schlüssel signierten seat-Claim, rollen Sie ein Dual-Mode-SDK aus, das danach verteilt und das Feld zuerst erreicht, stimmen Sie die alte Aktivierung jeder Maschine atomar in den Pool ein, und legen Sie die Schlüssel bei der Erneuerung um. In dieser Reihenfolge ausgeführt, hält die gemeinsame Obergrenze bei jedem Schritt, und kein Kunde bemerkt je, dass sich das Modell unter ihm geändert hat. Die Community Edition von Keyright führt den gebundenen Pfad kostenlos aus; Floating-Pools und Modellabstimmung gehören zu den kostenpflichtigen Stufen. Das vollständige Migrationsrezept lebt in der Keyright-Dokumentation.

Nebula.NET testen

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