Skip to content
← Alle Beiträge
· Delta1 Labs Node-lockingKeyright

Node-Locking von Aktivierungen und Fingerabdruck-Drift überstehen

Eine node-locked Lizenz bindet einen Sitzplatz an eine Maschine. Die Bindung ist ein Maschinen-Fingerabdruck: ein stabiler, gesalzener Hash aus Hardware- und Betriebssystemsignalen, niemals aus rohen Hardware-Kennungen. Diese Analyse zeigt, wie das Keyright-SDK den Fingerabdruck berechnet und in ActivateAsync sendet, wie der Ausgabedienst verschiedene Fingerabdrücke als aktive Geräte zählt und das reale Betriebsproblem des Fingerabdruck-Drifts: Ein VM-Klon, eine neu aufgesetzte Platte, eine getauschte Netzwerkkarte oder ein RAM-Upgrade verändern den Fingerabdruck, die Maschine wirkt neu und die Sitzplätze sind erschöpft. Wir behandeln gewichtete Mehrsignal-Fingerabdrücke, Toleranzabgleich, Deaktivierung und Lease-Ablauf zur Rückgewinnung von Sitzplätzen sowie das Fail-Closed-Gating.

Node-Locking beantwortet eine Frage: Ist dies die Maschine, auf der die Lizenz aktiviert wurde? Es ist das älteste und intuitivste Lizenzmodell — du kaufst drei Sitzplätze, installierst auf drei Maschinen, und jede Installation ist an die Hardware geheftet, auf der sie läuft. Der Heftmechanismus ist ein Maschinen-Fingerabdruck: eine kurze, stabile Kennung, die das SDK aus der Maschine ableitet und bei der Aktivierung an den Ausgabedienst sendet. Der Dienst merkt sie sich, zählt sie als einen belegten Sitzplatz und erwartet fortan, bei jeder Meldung dieser Installation denselben Fingerabdruck zu sehen.

Das Modell ist einfach, bis sich die Hardware ändert. Ein Fingerabdruck ist nur so stabil wie die Signale, aus denen er gebaut ist, und echte Maschinen mutieren: Platten werden neu aufgesetzt, Netzwerkkarten getauscht, VMs geklont, Laptops bekommen mehr RAM. Wenn sich die Signale bewegen, bewegt sich der Fingerabdruck mit, die Maschine wirkt für den Ausgabedienst brandneu, und ein Sitzplatz, der hätte bleiben sollen, wird zweimal ausgegeben. Dieser Fehlermodus — der Fingerabdruck-Drift — ist das eigentliche Thema dieses Artikels. Wir bauen zuerst den Fingerabdruck, verdrahten ihn durch die Keyright-Aktivierung und verbringen dann die meiste Zeit damit, ihn die physische Welt überleben zu lassen.

Was ein Maschinen-Fingerabdruck ist

Ein Fingerabdruck ist ein einzelner Hash, der für eine Maschine steht. Du schickst nie rohe Hardware-Kennungen an den Ausgabedienst — das wäre sowohl ein Datenschutzrisiko als auch ein umkehrbares Dossier über jemandes Hardware. Stattdessen sammelst du eine Handvoll pro Maschine einigermaßen stabiler Signale, kombinierst sie und hashst die Kombination mit einem produktspezifischen Salt:

  • Machine-GUID — die Installationsidentität auf OS-Ebene (MachineGuid unter Windows, /etc/machine-id unter Linux, die IOPlatformUUID unter macOS).
  • Primäre MAC-Adresse — die Hardware-Adresse des Haupt-Netzwerkadapters, wobei virtuelle und Loopback-Adapter herausgefiltert sind.
  • Seriennummer des Systemvolumes — die Seriennummer des Betriebssystem-Volumes.
  • CPU-Kennung — Modell-/Merkmalssignatur des Prozessors.

Keines davon verlässt die Maschine für sich allein. Sie werden verkettet und zu einem einzigen SHA-256-Digest reduziert, gesalzen mit einem für dein Produkt einzigartigen Wert, sodass dieselbe Maschine unterschiedliche Fingerabdrücke für unterschiedliche Produkte erzeugt und der Digest nicht gegen eine Rainbow-Table gängiger Hardware vorberechnet werden kann.

using System.Security.Cryptography;
using System.Text;

public static class MachineFingerprint
{
    // Per-product salt — distinct per Keyright product, kept out of logs.
    private const string ProductSalt = "keyright:acme-cad:v1";

    public static string Compute()
    {
        // Each signal is collected best-effort; a missing signal yields "".
        var signals = new[]
        {
            HardwareSignals.MachineGuid(),      // OS install identity
            HardwareSignals.PrimaryMac(),       // main NIC, virtual adapters excluded
            HardwareSignals.VolumeSerial(),     // OS volume serial
            HardwareSignals.CpuId(),            // processor signature
        };

        // Order matters: a fixed order makes the digest reproducible.
        var material = ProductSalt + "|" + string.Join("|", signals);

        var hash = SHA256.HashData(Encoding.UTF8.GetBytes(material));
        return Convert.ToHexString(hash).ToLowerInvariant(); // opaque, one-way
    }
}

Die Ausgabe sieht etwa aus wie 9f2c…a1, und das ist alles, was der Ausgabedienst je zu sehen bekommt. Es gibt keinen Weg vom Digest zurück zur MAC oder zur Volume-Seriennummer: Der Hash ist einseitig, und der Salt bedeutet, dass der Fingerabdruck einer bekannten Maschine ohne das Salt des Produkts nicht reproduziert werden kann. Das ist der Datenschutzvertrag: Fingerabdrücke werden gehasht und gesalzen, sind nie rohe PII und nie zu Hardware-Kennungen umkehrbar.

Einen Sitzplatz bei der Aktivierung binden

Das SDK sendet den Fingerabdruck in ActivateAsync. Die Initialisierung gibt dem Client das Produkt, den öffentlichen Signaturschlüssel und die Service-URL deiner Bereitstellung; die Aktivierung sendet eine Anfrage mit dem Lizenzschlüssel plus dem berechneten Fingerabdruck an POST /v1/activate.

KeyrightClient.Initialize(new KeyrightOptions
{
    Product         = "acme-cad",
    PublicKeyBase64 = "MCowBQYDK2VwAyEA...",       // verifies signed responses
    ServiceUrl      = "https://license.acme.example",
});

var client = KeyrightClient.Current;

// The fingerprint is attached to the activation request automatically,
// but you can inspect or override it for testing.
var result = await client.ActivateAsync(licenseKey);

if (!result.IsValid)
{
    // Fail CLOSED: no seat, no licensed functionality.
    ShowActivationError(result.Reason);   // e.g. SeatsExhausted, InvalidKey
    return;
}

Auf der Dienstseite erfasst /v1/activate das Paar (Lizenzschlüssel, Fingerabdruck). Das Sitzplatz-Zählwerk ist die Anzahl verschiedener Fingerabdrücke, die an diesen Schlüssel gebunden sind: Ein mit drei Sitzplätzen verkaufter Schlüssel akzeptiert drei verschiedene Fingerabdrücke und weist den vierten mit einem SeatsExhausted-Ergebnis ab. Den gleichen Fingerabdruck erneut zu aktivieren ist idempotent — es bindet die bereits bekannte Maschine neu und verbraucht keinen zusätzlichen Sitzplatz. Deshalb muss der Fingerabdruck stabil sein: Die gesamte Vorstellung des Dienstes von „wie viele Maschinen” ist „wie viele verschiedene Fingerabdrücke habe ich gesehen”.

Jeder nachfolgende Lauf ruft ValidateAsync auf, das den Fingerabdruck neu berechnet und vorlegt. Stimmt er mit einer lebenden Bindung überein, gelingt die Validierung und das SDK legt die Lizenzdetails und Entitlements offen:

var v = await client.ValidateAsync();
if (!v.IsValid)
{
    EnterReadOnlyMode();     // fail closed on any validation failure
    return;
}

Console.WriteLine($"Licensed to {v.LicenseInfo.Owner}, seat bound to this machine.");

if (client.HasEntitlement("export.dwg"))
    EnableDwgExport();

Das Drift-Problem

Hier trifft das saubere Modell auf die Hardware-Realität. Betrachte das Diagramm unten: Die Signale einer Maschine speisen den Hash, der Hash wird zu einem Fingerabdruck, und der Fingerabdruck belegt einen Sitzplatz beim Ausgabedienst. Der untere Pfad zeigt, was der Drift anrichtet: Ein Signal ändert sich, der Hash ändert sich, und der Dienst sieht eine neue Maschine, die um einen neuen Sitzplatz konkurriert, während die alte Bindung weiterhin zählt.

Node-Locking: von Signalen zum Sitzplatz, und was der Drift kaputtmacht Maschinensignale Machine-GUID MAC · Volume-Serie CPU-ID SHA-256 + product salt Fingerabdruck 9f2c…a1 Sitz 1 gebunden Drift: ein Signal ändert sich (Neuaufsetzen · getauschte NIC · VM-Klon) Geänderte Signale neue MAC nach Kartentausch anderer Hash gleiche Maschine! Fingerabdruck 7b4e…c3 wirkt brandneu Sitz 2 vergeudet veralteten Sitzplatz zurückgewinnen: DeactivateAsync (sofort) oder Lease-Ablauf (automatisch)

Die Ursachen sind alltäglich und häufig: Eine neu aufgesetzte Platte erzeugt die OS-Machine-GUID neu; ein getauschter oder vom Dock abhängiger Netzwerkadapter ändert die MAC; das Klonen einer VM-Vorlage dupliziert — oder, schlimmer, randomisiert — jedes Signal; ein Firmware-Update ändert eine Volume-Seriennummer. Jede davon kippt den Digest. Ein einziges Alles-oder-nichts-Signal ist brüchig; die Lösung ist, den Fingerabdruck nicht länger als einen einzelnen brüchigen Wert zu behandeln.

Minderung: mehrere Signale gewichten

Statt alles in einen einzigen unerbittlichen Digest zu hashen, berechne einen Fingerabdruck aus gewichteten Komponenten und akzeptiere eine Übereinstimmung, wenn genug Gewicht übereinstimmt. Das SDK sendet die Komponentenmenge; der Ausgabedienst entscheidet, ob die vorgelegte Menge einer bekannten Bindung nahe genug ist, um dieselbe Maschine zu sein.

public sealed record FingerprintComponent(string Name, string Value, int Weight);

public static IReadOnlyList<FingerprintComponent> Components() => new[]
{
    new FingerprintComponent("machineGuid",  Hash(HardwareSignals.MachineGuid()), 40),
    new FingerprintComponent("volumeSerial", Hash(HardwareSignals.VolumeSerial()), 25),
    new FingerprintComponent("cpuId",        Hash(HardwareSignals.CpuId()),        20),
    new FingerprintComponent("primaryMac",   Hash(HardwareSignals.PrimaryMac()),   15),
};

static string Hash(string s) =>
    Convert.ToHexString(SHA256.HashData(Encoding.UTF8.GetBytes("keyright:acme-cad:v1|" + s)))
           .ToLowerInvariant();

Jede Komponente wird einzeln gesalzen und gehasht — das rohe Signal verlässt die Maschine weiterhin nie. Der Dienst speichert die bei der Aktivierung gebundenen Komponenten und bewertet bei jeder Validierung die vorgelegte Menge gegen sie. Tragen die übereinstimmenden Komponenten mindestens einen konfigurierten Anteil des Gesamtgewichts, ist es dieselbe Maschine; eine einzelne geänderte MAC (15 von 100) kippt die Identität nicht, aber eine vollständige Änderung schon.

Toleranzabgleich auf dem Dienst

match score = Σ weight(component) where presented.value == bound.value
same machine  if  match score >= tolerance threshold (e.g. 70 of 100)
re-bind       if  same machine and some components changed  (heal the drift)
new machine   if  match score < threshold                    (count a seat)

Ein Toleranzschwellwert fängt gewöhnlichen Drift ab. Stimmt eine Maschine über dem Schwellwert überein, haben sich aber einige Komponenten geändert — die MAC hat sich bewegt, etwa — behandelt der Dienst sie als denselben Sitzplatz und bindet neu an die neue Komponentenmenge, heilt den Drift, sodass die nächste Validierung sauber übereinstimmt. Erst wenn sich zu viel geändert hat, zählt er eine neue Maschine. Wähle den Schwellwert bewusst: zu locker, und verschiedene Maschinen kollidieren auf einem Sitzplatz; zu streng, und gewöhnliche Upgrades erschöpfen Sitzplätze.

Sitzplätze zurückgewinnen: Deaktivierung und Lease-Ablauf

Toleranz reduziert Drift, kann aber nicht alles abfangen — ein vollständiges Neuaufsetzen oder ein ausgemusterter Laptop hinterlässt tatsächlich eine veraltete Bindung, die einen Sitzplatz belegt. Zwei Mechanismen geben ihn zurück.

Explizite Deaktivierung. Bevor eine Lizenz außer Betrieb genommen oder verschoben wird, gibt der Client seinen Sitzplatz frei. Das sendet eine Anfrage an POST /v1/deactivate, und der Sitzplatz kehrt sofort zurück.

// Freeing a seat so it can be re-used elsewhere.
var released = await client.DeactivateAsync();
if (released.IsValid)
    Console.WriteLine("Seat released; this machine no longer counts.");

Lease-Ablauf. Die Deaktivierung funktioniert nur, solange die Maschine noch da ist, um sie aufzurufen — eine tote Platte deaktiviert sich nie. Deshalb trägt jede Bindung zusätzlich ein Lease mit einem Ablauf, den der Client bei jedem ValidateAsync erneuert. Eine Maschine, die aufhört zu validieren — ausgemustert, neu aufgesetzt, dauerhaft offline — hört auf zu erneuern; sobald ihr Lease verfällt, gewinnt der Ausgabedienst den Sitzplatz automatisch zurück. Die Deaktivierung ist der saubere, sofortige Weg; der Lease-Ablauf ist der Rückhalt für Maschinen, die verschwunden sind. Bei der Reaktivierung (der Nutzer installiert neu oder verschiebt den Schlüssel auf Ersatz-Hardware) berechnet das SDK einfach den aktuellen Fingerabdruck, und ActivateAsync bindet ihn an den nun freien Sitzplatz.

Immer Fail-Closed

Die nicht verhandelbare Regel: Wenn die Aktivierung abgelehnt wird, die Validierung fehlschlägt oder die Sitzplätze erschöpft sind, muss die Anwendung Fail-Closed reagieren — die lizenzierte Funktionalität verweigern, statt guten Willen zu unterstellen. Node-Locking ist nur dann sinnvoll, wenn das Gatter hält, wenn die Antwort „nein” lautet:

var v = await client.ValidateAsync();

bool licensed = v.IsValid
             && v.LicenseInfo is { } info
             && !info.IsExpired;

if (!licensed)
{
    // Seat exhausted, fingerprint unknown, lease lapsed, or offline past grace:
    // do NOT enable paid features. Degrade, don't default-open.
    EnterReadOnlyMode();
    return;
}

EnableLicensedFeatures();

Container und kurzlebige Identität

Node-Locking setzt eine dauerhafte Maschine voraus. Ein Container hat keine: Jeder frische Container berechnet einen anderen Fingerabdruck und würde bei jedem Start einen Sitzplatz verbrennen, das Zählwerk fast sofort erschöpfen. Für wegwerfbare oder autoskalierte Workloads ist Node-Locking das falsche Werkzeug; du willst stattdessen ein Modell für Kurzlebiges geeigneter Identität — sehr kurze Leases, die innerhalb von Minuten zurückgewonnen werden, oder ein Concurrency-Modell, das die gleichzeitige Nutzung statt verschiedener Maschinen zählt. (Dieses Modell behandeln wir separat in unserem Beitrag über Floating-, Lease-gezählte Sitzplätze.) Behalte Node-Locking für dauerhafte Arbeitsplätze und Server vor, wo ein stabiler Fingerabdruck ein Vorteil statt eines Kampfes ist.

Zusammenfassung

Node-Locking bindet einen Sitzplatz über einen gesalzenen, einseitigen Fingerabdruck an eine Maschine — stabil genug zum Zählen, privat genug, um nie Hardware-Kennungen offenzulegen. Der Fehlermodus, der in der Produktion beißt, ist der Drift: Gewöhnliche Hardware-Änderungen verschieben den Fingerabdruck und verdoppeln stillschweigend den Sitzplatzverbrauch. Die Heilung ist kein einzelner brüchiger Hash, sondern ein gewichteter Mehrsignal-Fingerabdruck mit einem Toleranzschwellwert, der sich durch kleine Änderungen neu bindet, gestützt durch explizite Deaktivierung und Lease-Ablauf, um Sitzplätze von Maschinen zurückzugewinnen, die weg sind. Sichere das Ganze Fail-Closed ab und halte kurzlebige Workloads auf einem Identitätsmodell, das für sie gemacht ist.

Nebula.NET testen

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