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

Elegante Lizenz-Wiederherstellung in einer Desktop-App

Wenn eine Lizenz abläuft, widerrufen wird oder der Dienst kurz nicht erreichbar ist, darf eine Desktop-App nicht auf alle drei Fälle gleich reagieren. Diese Anleitung baut die Zustandsmaschine, die die Oberfläche aus dem Prüfergebnis, einer Kulanzrichtlinie und der Uhr ableitet, damit ein zahlender Kunde in einem instabilen Netz nie den Sperrbildschirm sieht, der für einen widerrufenen Schlüssel gedacht ist.

Eine Desktop-App hat genau eine Aufgabe, wenn eine Lizenz nicht mehr gültig ist: herausfinden, warum, und verhältnismäßig reagieren. Der Fehler, der immer wieder ausgeliefert wird, ist ein einziges if (!license.IsValid) ShowLockout(), das eine abgelaufene Testversion, einen widerrufenen Schlüssel, eine beschädigte Datei und eine zwei Sekunden lange Netzunterbrechung als dasselbe Ereignis behandelt. Der Kunde, dessen VPN kurz ausfiel, bekommt denselben roten Bildschirm wie der Kunde, dessen Schlüssel wegen Nichtzahlung gezogen wurde — und der erste eröffnet ein Support-Ticket mit dem Text „Ihre Software hat mich grundlos ausgesperrt”.

Kernaussage: Die Wiederherstellungs-UX ist eine reine Funktion dreier Eingaben — des Prüfergebnisses, Ihrer Kulanzrichtlinie und der Uhr — abgebildet auf eine kleine Menge von Zuständen, jeder mit seiner eigenen Darstellung und seiner eigenen Wiederherstellungsaktion. Bauen Sie diese Abbildung als einen Reducer, halten Sie transiente Fehler strikt getrennt von einem maßgeblichen negativen Urteil, und der richtige Bildschirm ergibt sich automatisch.

Die eigentliche Frage: auf wie viele Arten kann „ungültig” tatsächlich etwas bedeuten?

„Ungültig” ist nicht ein einziger Zustand. Ein Prüfversuch kann an mindestens sechs materiell verschiedenen Stellen landen, und jede bedeutet etwas anderes zu sagen und eine andere Schaltfläche anzubieten:

public enum LicenseState
{
    Valid,     // verified, inside its term
    Grace,     // tolerated: lapsed-but-recent, or service briefly unreachable
    Expired,   // past term and past grace; no current entitlement
    Revoked,   // an authoritative server verdict: this key is dead
    Tampered,  // signature or clock integrity failed locally
    Missing    // no key installed yet
}

Der wichtige Schnitt verläuft zwischen Zuständen, von denen sich der Benutzer erholen kann, und solchen, von denen er es nicht kann. Expired und Missing behebt die Person an der Tastatur — verlängern oder einen Schlüssel einfügen. Revoked und Tampered nicht; die einzige ehrliche Aktion ist ein Weg zum Support. Grace ist besonders: nichts ist falsch, worauf der Benutzer reagieren müsste, also arbeitet die App weiter und heilt sich selbst. Diese alle in einen Zweig zusammenzufassen ist, was den Aussperren-bei-einem-Flackern-Fehler erzeugt.

Der Mechanismus: ein Reducer vom Ergebnis zur Ansicht

Ein einzelner Prüfaufruf liefert ein Ergebnis zurück, keinen Boolean. Modellieren Sie es, und modellieren Sie die zwei Fehlerarten — ein Urteil (der Server oder die Signatur sagte nein) gegenüber einem Transport-Fehler (wir konnten nicht fragen) — als getrennte Fälle, denn sie dürfen nicht verschmelzen.

public abstract record VerifyOutcome
{
    public sealed record Ok(LicenseClaims Claims) : VerifyOutcome;
    public sealed record Negative(DenyReason Reason) : VerifyOutcome;   // signed verdict
    public sealed record Unreachable(Exception Cause) : VerifyOutcome;  // transport only
}

public enum DenyReason { Expired, Revoked, BadSignature, ClockRollback, NotFound }

Nun ist die gesamte Wiederherstellungsrichtlinie eine reine Funktion. Sie nimmt das Ergebnis, wie lange wir den Dienst schon nicht erreichen, das Kulanzbudget und die Uhr — und gibt den Zustand plus alles zurück, was die Oberfläche zum Rendern braucht. Kein I/O, keine Timer, trivial per Unit-Test prüfbar.

public static LicenseView Reduce(
    VerifyOutcome outcome,
    TimeSpan sinceLastGoodCheck,
    GracePolicy policy,
    DateTimeOffset now) => outcome switch
{
    VerifyOutcome.Ok ok when ok.Claims.NotAfter > now
        => LicenseView.Active(ok.Claims),

    // Term elapsed, but still inside the post-expiry grace budget.
    VerifyOutcome.Ok ok when now - ok.Claims.NotAfter <= policy.PostExpiry
        => LicenseView.InGrace(ok.Claims, expiresIn: policy.PostExpiry - (now - ok.Claims.NotAfter)),

    // We simply could not reach the service: never a lockout while we have grace left.
    VerifyOutcome.Unreachable when sinceLastGoodCheck <= policy.Offline
        => LicenseView.InGrace(reason: "Reconnecting…", expiresIn: policy.Offline - sinceLastGoodCheck),

    VerifyOutcome.Unreachable
        => LicenseView.Expired(recoverable: true, message: "Offline too long — reconnect to continue."),

    // Authoritative negatives. Each gets its own screen and its own action.
    VerifyOutcome.Negative n => n.Reason switch
    {
        DenyReason.Expired      => LicenseView.Expired(recoverable: true),
        DenyReason.NotFound     => LicenseView.Missing(),
        DenyReason.Revoked      => LicenseView.Blocked(DenyReason.Revoked),       // no self-service fix
        DenyReason.BadSignature => LicenseView.Blocked(DenyReason.BadSignature),
        DenyReason.ClockRollback=> LicenseView.Blocked(DenyReason.ClockRollback),
        _                       => LicenseView.Blocked(n.Reason),
    },

    _ => LicenseView.Blocked(DenyReason.NotFound),
};

Lesen Sie die Reihenfolge der Fälle: ein Unreachable-Ergebnis kann niemals bis zu einer harten Sperre durchfallen, solange noch Offline-Kulanz übrig ist. Der einzige Weg zu Blocked ist ein Negative — ein signiertes, eindeutiges Urteil — oder ein Manipulationssignal. Diese eine Reihenfolgeregel ist die gesamte Verteidigung dagegen, gute Kunden in einem schlechten Netz auszusperren.

Ergebnis → Zustand → WiederherstellungsaktionValidGracearbeitet weiter, versucht erneutUnreachableExpiredAktion: VerlängernMissingAktion: Schlüssel eingebenKulanz aufgebrauchtRevokedTamperedAktion: Support kontaktierennur signiertes Urteil
Die Wiederherstellungs-Zustandsmaschine. Transiente Unreachable-Ergebnisse bleiben in Grace und heilen; nur ein signiertes negatives Urteil wechselt in die Hartsperr-Zustände rechts.

Es an ein View-Model binden, das sich selbst heilt

Der Reducer ist rein, also ist das View-Model darum herum dünn: die Prüfung in einem Takt erneut ausführen, das Ergebnis durch Reduce schicken und das resultierende LicenseView veröffentlichen. Die Oberfläche bindet an eine einzige Eigenschaft und enthält nie ein eigenes Lizenz-if.

public sealed class LicenseStatusViewModel : INotifyPropertyChanged
{
    private LicenseView _view = LicenseView.Checking();
    public LicenseView View { get => _view; private set { _view = value; OnChanged(); } }

    public async Task RefreshAsync(CancellationToken ct)
    {
        VerifyOutcome outcome = await _license.VerifyAsync(ct);   // local Ed25519 + optional revalidation
        if (outcome is VerifyOutcome.Ok ok)
            _clockGuard.RecordTrustedTime(ok.Claims.IssuedAt);    // advance the high-water mark

        View = Reduce(outcome, _clockGuard.SinceLastGood, _policy, DateTimeOffset.UtcNow);

        // Heal automatically: while in Grace, keep retrying on a short backoff.
        if (View.State == LicenseState.Grace)
            _retry.Schedule(() => _ = RefreshAsync(ct));
    }
}

_clockGuard ist, was den Uhr-zurückstellen-Trick stoppt. Es persistiert den höchsten jemals geprüften Zeitstempel, und liest die lokale Uhr einen früheren um mehr als die Abweichungstoleranz, gibt VerifyAsync Negative(ClockRollback) zurück, das der Reducer direkt nach Blocked leitet. Wie Sie diese Toleranz gegen legitime Sommerzeit- und Zeitzonenwechsel bemessen, zeigt der Keyright-Artikel zu Clock-Skew und NotBefore-Toleranz.

Die Wiederherstellungsaktionen — eine pro Zustand, mehr nicht

Jeder Zustand außer Valid bietet genau eine primäre Aktion, und die Aktion passt zu dem, der sie tatsächlich beheben kann:

  • Grace — keine Schaltfläche. Ein ruhiges, nicht-modales Banner („Offline arbeitend — Neuverbindung…”). Die App heilt sich, ohne dass der Benutzer etwas tut.
  • Expired — eine nicht-blockierende „Verlängern”-Aufforderung, die den Kauf- oder Verlängerungsfluss öffnet, und ein Feld „Neuen Schlüssel eingeben”. Die App bleibt offen; wo sinnvoll, stuft sie in den Nur-Lese-Modus oder zur kostenlosen Community Edition-Oberfläche herab, statt auszugehen.
  • Missing — der Aktivierungsbildschirm beim ersten Start: Schlüssel einfügen, prüfen drücken, RefreshAsync läuft erneut.
  • Revoked / Tampered — dies sind die einzigen Zustände, die einen harten Stopp rechtfertigen. Zeigen Sie in klarer Sprache warum und einen einzigen „Support kontaktieren”-Weg. Kein Selbstbedienungsfeld, denn der Benutzer kann einen widerrufenen Schlüssel wirklich nicht selbst beheben; ihn an den Support zu verweisen ist der ehrliche Schritt. Die Suche, die Ihr Support-Team ausführt, ist der Warum-ist-das-gesperrt-Fluss.

Beachten Sie, dass es keine Wiederholen-Schaltfläche in den Hartsperr-Zuständen gibt. Einen widerrufenen Schlüssel erneut zu prüfen liefert nur dasselbe Negative(Revoked); „Erneut versuchen” anzubieten trainiert den Benutzer, es durchzuhämmern und trotzdem ein Ticket zu eröffnen.

Vorbehalte: wo es schmerzt

Das Kulanzbudget ist ein Kompromiss, kein freier Parameter. Zu großzügig, und ein wirklich abgelaufener Kunde läuft wochenlang; zu knapp, und ein Laptop, der über ein Wochenende schläft, begrüßt den Benutzer am Montag mit einer Sperre. Bemessen Sie policy.Offline an Ihrem echten Nutzungsmuster — der Artikel zum Kulanzfenster bei transienten Ausfällen deckt die Rechnung ab.

Herunterstufen auf Nur-Lese ist eine Produktentscheidung, keine Lizenzentscheidung. Der Reducer kann Ihnen sagen, dass eine Lizenz Expired ist; er kann Ihnen nicht sagen, welche Funktionen sicher aktiv bleiben können. Diese Abbildung lebt in Ihrer Berechtigungsschicht, und sie falsch zu machen — einen bezahlten Export nach Ablauf aktiv zu lassen — macht den ganzen Sinn zunichte.

Der Reducer ist nur so ehrlich wie VerifyAsync. Verschluckt die Prüfung einen Signaturfehler und gibt Unreachable zurück, versteckt sich ein manipulierter Schlüssel für immer im Kulanzzustand. Signatur- und Uhrprüfungen sind lokal und müssen nach Negative scheitern, nie nach einem Transportfehler. Halten Sie diese Grenze scharf.

Eine Hintergrund-Neuprüfung darf die Arbeit nie unterbrechen. Führen Sie RefreshAsync außerhalb des UI-Threads aus und lassen Sie den Zustand die Rahmung ändern — ein Banner, einen deaktivierten Menüpunkt — statt einen Modal über das zu werfen, was der Benutzer gerade tippt.

Fazit

Behandeln Sie die Wiederherstellung als reine Abbildung, nicht als Streuung von if-Anweisungen. Modellieren Sie das Prüfergebnis als Ok / Negative / Unreachable, halten Sie den Transportfehler strikt aus dem Sperrpfad heraus, und reduzieren Sie das Ganze auf einen von sechs Zuständen, jeder mit einer Darstellung und einer einzigen Aktion, die zu dem passt, der sie beheben kann. Tun Sie das, und der Kunde mit instabilem Netz heilt still in Grace, während der widerrufene Schlüssel den Stopp bekommt, den er verdient, und keiner sieht je den Bildschirm des anderen. Keyrights Community Edition ist ein solides Herabstufungsziel für abgelaufene Desktop-Apps; das vollständige Wiederherstellungs- und Berechtigungsrezept steht in der Keyright-Dokumentation.

Nebula.NET testen

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