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

Einen geleakten Lizenzschlüssel über alle Clients widerrufen

Ein Schlüssel wurde geteilt, auf einer Paste-Seite veröffentlicht oder aktiviert sich von drei Kontinenten gleichzeitig. Hier ist der praktische Leitfaden: wie Sie ihn in Keyright widerrufen, was Widerruf serverseitig bedeutet und — der Teil, den die meisten Teams falsch machen — wie ausgerollte SDK-Clients es tatsächlich erfahren und aufhören zu funktionieren.

Jedes Lizenzsystem hat einen schlechten Tag, der so aussieht. Ein Support-Ticket erwähnt einen Lizenzschlüssel, den Sie nicht erkennen, auf einem Konto, das Sie kennen. Ihr Missbrauchs-Dashboard leuchtet auf, weil sich ein Schlüssel aus Lissabon aktiviert hat und dann elf Minuten später aus São Paulo. Oder jemand fügt einen Schlüssel direkt in einen öffentlichen Gist ein, mit der Bildunterschrift „funktioniert, viel Spaß”. Der Schlüssel ist echt, er wurde korrekt ausgestellt, und die signierte Lizenzdatei auf jeder Maschine, die ihn hat, validiert noch einwandfrei. Der Ablauf wird Sie nicht retten: Der liegt Monate entfernt. Sie müssen ihn widerrufen, und jeder Client, der ihn hält, muss es erfahren und stoppen.

Dieser Artikel ist der durchgehende Leitfaden: den Missbrauch erkennen, der einen Widerruf rechtfertigt, den Widerruf gegen Ihr Keyright-Deployment ausführen, was der Widerruf serverseitig wirklich ändert und — der Teil, der entscheidet, ob irgendetwas davon zählt — wie ein ausgerollter SDK-Client erfährt, dass sein Schlüssel tot ist, und geschlossen scheitert.

Warum Widerruf ein anderes Problem ist als Ablauf

Es hilft, präzise zu sein, was eine signierte Lizenz ist. Wenn Keyright einen Schlüssel ausstellt, erhält der Client eine Lizenz-Nutzlast, die mit dem privaten Schlüssel Ihres Produkts signiert ist; das SDK verifiziert sie offline gegen den öffentlichen Schlüssel, den Sie anpinnen. Diese Signatur ist der ganze Sinn: Sie bedeutet, dass ein Client einer Lizenz vertrauen kann, ohne bei jedem einzelnen Aufruf nach Hause zu telefonieren. Der Ablauf reist in dieser Nutzlast mit, ein Client setzt ihn also mit null Netzwerk durch.

Der Widerruf bricht dieses bequeme Modell absichtlich. Sie treffen eine Entscheidung nachdem die Lizenz signiert wurde: Dieser spezielle Schlüssel sollte, gültige Signatur und alles, nicht mehr funktionieren. Nichts in den Bytes, die der Client bereits hält, spiegelt das wider. Die Signatur stimmt weiterhin. Die einzige Möglichkeit für einen Client, den Widerruf zu entdecken, ist, die Autorität zu fragen, die die Entscheidung getroffen hat — Ihren issuing service — oder sich auf eine zwischengespeicherte Antwort zu stützen, die veralten darf. Diese eine Tatsache bestimmt alles Folgende, einschließlich warum das Revalidierungsintervall die wichtigste Einstellung ist, die Sie anfassen werden.

Schritt 0: den Missbrauch erkennen, der einen Widerruf verdient

Widerruf ist eine Reaktion, also zählt der Auslöser. Einige Signale rechtfertigen ihn zuverlässig:

  • Übernutzung nebenläufiger Sitze. Ein für eine Handvoll Sitze lizenzierter Schlüssel validiert gleichzeitig von Dutzenden unterschiedlicher Maschinenidentitäten. Keyrights Aktivierungsdatensätze liefern Ihnen die Anzahl distinkter Knoten pro Lizenz; wenn sie die berechtigte Sitzzahl weit übersteigt und dort bleibt, ist der Schlüssel entkommen.
  • Unmögliche Reise. Zwei Aktivierungen desselben Schlüssels, getrennt durch mehr Zeitzonen als Minuten. Ein Schlüssel kann nicht in einer Viertelstunde in Lissabon und São Paulo sein; zwei Kopien davon schon.
  • Öffentliche Exposition. Der Schlüssel taucht auf einer Paste-Seite, in einer versionierten .env, einem Support-Thread, einem Forum auf. Sobald ein Schlüssel öffentlich ist, kommt die Sitzzählung nicht mehr mit: Sie widerrufen und stellen neu aus.

Sie können das von Hand im Dashboard beobachten oder sich auf die Aktivierungs- und Validierungsereignisse stützen, die der issuing service bereits aufzeichnet. In jedem Fall liegt die Entscheidung zum Widerruf bei Ihnen; die Mechanik unten ist dieselbe, sobald sie getroffen ist.

Schritt 1: den Schlüssel widerrufen

Ein Anbieter widerruft eine Lizenz auf eine von zwei gleichwertigen Arten. Öffnen Sie im Dashboard die Lizenz und wählen Sie Revoke — optional mit einem Grund und der Wahl, sofort oder nach einem kurzen Kulanzfenster zu sperren. Zur Automatisierung — etwa ein Antibetrugs-Job, der bei einem Rückbuchungs-Webhook widerruft — rufen Sie die admin API direkt auf:

POST /v1/admin/licenses/lic_7c1f9a/revoke HTTP/1.1
Host: your-keyright-deployment.example.com
Authorization: Bearer ${KEYRIGHT_ADMIN_TOKEN}
Content-Type: application/json

{
  "reason": "leaked_public",
  "effective": "immediate"
}

Ein erfolgreicher Aufruf gibt die aktualisierte Lizenz mit ihrem neuen Zustand zurück:

{
  "licenseId": "lic_7c1f9a",
  "product": "acme-suite",
  "status": "revoked",
  "reason": "leaked_public",
  "revokedAtUtc": "2026-11-14T09:30:02Z",
  "graceUntilUtc": null
}

Stattdessen "effective": "grace" zu setzen würde graceUntilUtc mit einem Zeitstempel in naher Zukunft füllen: mehr zu diesem Kompromiss weiter unten.

Schritt 2: was Widerruf serverseitig bedeutet

Serverseitig tut der Widerruf zwei Dinge. Erstens schaltet er den maßgeblichen Status der Lizenz in den Datensätzen Ihres issuing service auf revoked, mit Zeitstempel und Grund: Das ist die Quelle der Wahrheit, die jede Online-Prüfung nun liest. Zweitens wird der Schlüssel auf eine denylist gesetzt: eine kompakte, schnell abzufragende Menge widerrufener Lizenzkennungen, die der Validierungspfad prüft, bevor er ein Urteil zurückgibt. Die denylist existiert, damit der Widerruf nichts erneut lesen oder neu signieren muss; die Signatur eines Schlüssels bleibt für immer mathematisch gültig, und die denylist ist das, was sie außer Kraft setzt.

Entscheidend: Der issuing service honoriert den Schlüssel für nichts Neues mehr: keine neuen Aktivierungen, keine Verlängerungen, keine Sitz-Leases. Eine widerrufene Lizenz ist ein geschlossenes Konto.

Schritt 3: wie ausgerollte Clients es erfahren

Hier gewinnen Teams oder scheitern still. Sie haben den Server umgeschaltet; jetzt muss jede Kopie des SDK im Feld aufholen. Es gibt zwei Populationen, und sie verhalten sich unterschiedlich.

Online-Clients. Jeder Client, der Ihr Deployment erreichen kann, erfährt es bei seiner nächsten Validierung. Das ValidateAsync des SDK konsultiert den maßgeblichen Status, sieht den Treffer in der denylist und gibt ein Ergebnis zurück, das nicht mehr gültig ist. Wenn Ihre App beim Start und periodisch revalidiert — was sie sollte —, beträgt das Fenster zwischen Ihrem Widerruf und dem geschlossenen Scheitern des Clients ein Revalidierungsintervall, meist Minuten. Für einen öffentlich geleakten Schlüssel ist das praktisch sofort.

Zwischengespeicherte und Offline-Clients. Das SDK speichert sein letztes gutes Urteil zwischen, damit die App kurze Netzaussetzer übersteht, ohne den Benutzer zu nerven. Dieser Cache wird vom Revalidierungsintervall gesteuert: wie lange ein zwischengespeichertes „gültig” bestehen darf, bevor das SDK erneut gegen den issuing service prüfen muss. Ein widerrufener Schlüssel funktioniert auf einem Offline-Client bis genau zu dem Moment weiter, in dem dieses Intervall abläuft und die nächste Prüfung als widerrufen zurückkommt. Das Intervall ist damit ein direkter Regler Ihrer Exposition: Ein Intervall von 30 Tagen bedeutet, dass ein widerrufener Schlüssel bis zu 30 Tage offline weiterlaufen kann; ein Intervall von 6 Stunden deckelt es bei 6 Stunden. Für Produkte mit hohem Risiko wählen Sie ein kurzes Intervall und nehmen den zusätzlichen Prüfverkehr in Kauf: Das ist der Preis schneller Propagierung.

Die folgende Sequenz verbindet die ganze Kette: Missbrauch wird erkannt, der Anbieter widerruft, die nächste Online-Prüfung scheitert geschlossen, und der Offline-Cache läuft an seiner Revalidierungsgrenze ab.

Missbrauchserkennung Anbieter / admin API Issuing service SDK-Clients unmögliche Reise / Sitz-Übernutzung POST /revoke status=revoked, denylist++ ValidateAsync (online) revoked → IsValid=false App scheitert geschlossen Offline-Client: zwischengespeichert gültig bis Intervallende das Revalidierungsintervall begrenzt die Offline-Exposition

Schritt 4: das clientseitige Gating-Muster, das wirklich geschlossen scheitert

Nichts von der Serverarbeit zählt, wenn die App eine fehlgeschlagene Validierung als Achselzucken behandelt. Die Regel ist unverblümt: Wenn die Validierung nicht eindeutig erfolgreich ist, verweigern Sie die Funktion. Kein „bei Fehler erlauben”, kein „erlauben, wenn wir unsicher sind”: verweigern. Hier ist die Form, mit echten Idiomen des Keyright-SDK.

using Keyright;

KeyrightClient.Initialize(new KeyrightOptions
{
    Product = "acme-suite",
    PublicKeyBase64 = "MCowBQYDK2VwAyEA...",          // zur Compile-Zeit angepinnt
    ServiceUrl = "https://your-keyright-deployment.example.com",
    RevalidationInterval = TimeSpan.FromHours(6)       // kurz = schnelle Widerruf-Propagierung
});

var client = KeyrightClient.Current;

public async Task<bool> TryUnlockPremiumExportAsync()
{
    var result = await client.ValidateAsync();

    // Scheitere GESCHLOSSEN: der einzige Weg zu „true" ist eine explizit gültige, nicht widerrufene Lizenz.
    if (!result.IsValid)
    {
        if (result.Status == LicenseStatus.Revoked)
        {
            // Maßgeblich: der Schlüssel wurde widerrufen. Sperre die Funktion und zeige eine klare Meldung.
            _log.Warning("License {Id} revoked ({Reason}); locking premium export.",
                result.LicenseInfo?.LicenseId, result.RevocationReason);
            ShowRevokedNotice(result.RevocationReason);
        }
        else
        {
            // Abgelaufen, manipuliert, unerreichbar mit veraltetem Cache usw. Trotzdem verweigert.
            _log.Warning("License not valid ({Status}); denying premium export.", result.Status);
        }
        return false;
    }

    // Gültiger Schlüssel: jetzt am konkreten Entitlement gaten, nicht nur an „hat eine Lizenz".
    if (!client.HasEntitlement("premium-export"))
        return false;

    var info = result.LicenseInfo;
    _log.Information("Premium export unlocked for {Customer}.", info?.CustomerRef);
    return true;
}

Drei Details tragen das Gewicht. Erstens der einzige Erfolgspfad: Die Steuerung erreicht die Freischaltung nur, wenn IsValid wahr ist und das Entitlement vorhanden ist. Jeder andere Zweig gibt false zurück. Zweitens dient die explizite Prüfung auf LicenseStatus.Revoked der Benutzererfahrung, nicht der Durchsetzung: Ein widerrufener Schlüssel verdient eine klarere Meldung als ein generischer Fehlschlag, aber selbst wenn Sie diesen Zweig löschten, würde die Funktion trotzdem gesperrt, weil das äußere !result.IsValid sie bereits verweigert hat. Drittens leistet das kurze RevalidationInterval stille Arbeit: Es ist die Obergrenze dafür, wie lange ein zwischengespeichertes „gültig” einen Widerruf überleben kann.

Ein Hinweis, wo man nicht geschlossen scheitern soll: Lassen Sie nicht die ganze App bei einem vorübergehenden Netzwerkfehler hart abstürzen. Das Modell des zwischengespeicherten Urteils existiert gerade deshalb, damit ein kurzer Ausfall einen zahlenden Kunden nicht lahmlegt. Scheitern Sie geschlossen bei der Funktion, halten Sie die App am Laufen und lassen Sie die nächste erfolgreiche Revalidierung den Zugriff wiederherstellen — oder den Widerruf bestätigen.

Sofortige Sperre gegen Kulanz

Widerruf mit "effective": "immediate" setzt den Schlüssel jetzt auf die denylist; die nächste Prüfung, wo auch immer, scheitert geschlossen. Das ist richtig bei Betrug, Rückbuchungen und öffentlichen Leaks, wo der Wert in dieser Minute aufhören soll zu fließen.

Kulanz ist für den Fall des ehrlichen Fehlers. Ein guter Kunde hat seinen Schlüssel in ein öffentliches Repository eingecheckt; Sie wollen diesen Schlüssel töten, aber seine Arbeit nicht unterbrechen, während er auf einen Ersatz umstellt. Widerruf mit einem kurzen graceUntilUtc lässt Online-Clients bis zu diesem Zeitstempel weiter validieren und scheitert sie dann geschlossen — und in der Zwischenzeit händigen Sie dem Kunden einen frisch ausgestellten Schlüssel aus. Der Kompromiss ist real: Jede Minute Kulanz ist eine Minute, in der der geleakte Schlüssel noch für jeden anderen funktioniert, der ihn auch hat. Reservieren Sie Kulanz für Situationen mit geringem Risiko und koppeln Sie sie an sofortige Neuausstellung; im Standard wählen Sie die sofortige Sperre für alles, was nach Missbrauch riecht.

Die Ein-Absatz-Version

Widerruf ist eine Entscheidung nach der Ausstellung, die eine gültige Signatur nicht ausdrücken kann, Clients müssen ihn also durch Nachfragen erfahren. Sie widerrufen über das Dashboard oder die admin API; serverseitig schaltet der Lizenzstatus auf revoked und der Schlüssel tritt einer denylist bei, die der Validierungspfad konsultiert. Online-Clients scheitern bei ihrem nächsten ValidateAsync geschlossen; Offline-Clients laufen nur bis zum Ablauf des Revalidierungsintervalls weiter, stellen Sie dieses Intervall also für Schlüssel mit hohem Risiko kurz ein. Machen Sie in der App den Verweigerungspfad zum Standard und die Freischaltung zur einzigen schmalen Ausnahme. Tun Sie das, und ein geleakter Schlüssel ist ein kurzer Vorfall statt eines offenen Hahns.

Nebula.NET testen

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