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

Warum ist die Lizenz dieses Kunden blockiert?

Ein Support-Ingenieur bekommt ein Ticket, dass sich eine Lizenz „nicht aktivieren lässt", aber der Client scheitert geschlossen und meldet nur „blockiert". Hier ist ein schreibgeschütztes Diagnosewerkzeug, gebaut auf der Keyright-Admin-API, das die gesamte Verifizierungs-Pipeline im Erklärungsmodus abspielt und genau meldet, welche Prüfung fehlschlug — Ablauf, Widerruf, Maschinenbindung, ein Sitz oder ein fehlendes Recht — ohne den Schlüssel je offenzulegen.

Ein Support-Ingenieur öffnet ein Ticket: „Kunde ACME sagt, die App lässt sich nicht aktivieren — sie sagt nur, die Lizenz sei blockiert.” Das ist die gesamte verfügbare Information, denn ein korrekt gebauter Lizenz-Client ist darauf ausgelegt, nichts weiter preiszugeben. Er scheitert geschlossen, verweigert den Zugriff und meldet einen einzigen undurchsichtigen Zustand. Der Ingenieur muss nun herausfinden, ob das Abonnement ablief, der Schlüssel widerrufen wurde, alle Sitze belegt sind, der Kunde auf eine neue Maschine wechselte oder er schlicht in einem Tarif ist, der die Funktion, die er nutzen will, nie enthielt — und das ohne das eine Artefakt, das es trivial und gefährlich zu teilen machen würde: den signierten Schlüssel.

Das ist ein lösbares Problem, und die Lösung ist nicht, den Client gesprächiger zu machen. Es ist ein kleines, schreibgeschütztes Diagnosewerkzeug, das über die Admin-API von Keyright mit dem ausstellenden Dienst spricht und die Verifizierungs-Pipeline in einem Modus abspielt, der erklärt statt durchsetzt.

Der Client beantwortet eine Frage; der Support braucht eine andere

Die Verifizierung im Client ist eine kurzschließende Pipeline. Sie führt eine feste Folge von Prüfungen aus — ist die Signatur echt, liegt das „Jetzt” im Gültigkeitsfenster, steht der Schlüssel auf der Widerrufsliste, ist dies die Maschine, an die die Lizenz gebunden ist, ist ein Sitz frei, gewährt die Lizenz die angefragte Funktion — und sobald eine Prüfung fehlschlägt, hält sie an und verweigert. Sie bewertet die Prüfungen nach dem Fehlschlag nie, weil sie es nicht muss: Die Antwort ist bereits nein.

// Inside the client: fail-closed, short-circuiting, deliberately opaque.
LicenseInfo info = client.Validate();   // offline, never throws
if (!info.IsValid)
    return Gate.Deny("This copy is not licensed. Contact your administrator.");

info.IsValid ist ein einziger boolescher Wert. Der Benutzer sieht „nicht lizenziert”. Das ist das korrekte Verhalten für eine durchgesetzte Binärdatei, und genau deshalb kann der Support nicht damit arbeiten. Die Frage, die der Support beantworten muss, lautet nicht „ist es blockiert” — das weiß er bereits — sondern „welche Prüfung schlug fehl, und warum”. Das zu beantworten bedeutet, dieselbe Pipeline gegen den maßgeblichen Datensatz des ausstellenden Dienstes auszuführen, aber mit abgeschaltetem Kurzschluss, sodass jede Prüfung ihr eigenes Urteil meldet, statt dass der erste Fehlschlag den Rest verschluckt.

Verifizierungs-Pipeline (eine Reihenfolge, zwei Leser)Diagnose-Urteil1 · SignaturRSA über kanonisches PayloadPASSecht2 · DatumsfensternotBefore ≤ now ≤ notAfterPASSnicht abgelaufen3 · Widerrufnicht auf der SperrlistePASSaktiv4 · MaschinenbindungFingerabdruck stimmt übereinPASSgebundener Host5 · Sitzein Sitz ist frei zu belegenFAIL5 von 5 Sitzen belegt6 · Rechtfeature.export gewährtUNKNOWNClient stoppte bei 5hier gibt Validate() Blocked zurück →↑ vom Client nie bewertet

Ein schreibgeschützter Diagnose-Endpunkt

Der ausstellende Dienst besitzt bereits den maßgeblichen Datensatz jeder Lizenz: ihr Gültigkeitsfenster, ob sie widerrufen wurde, an welche Maschine sie gebunden ist und wie viele ihrer Sitze gerade verleast sind. Die Admin-API stellt eine schreibgeschützte Diagnoseansicht dieses Datensatzes bereit. Sie nimmt einen nicht geheimen Bezeichner — eine Lizenz-ID oder einen kurzen Schlüssel-Fingerabdruck, den der Kunde auf seinem „Über”-Bildschirm ablesen kann — und optional einen vom Kunden gemeldeten Maschinen-Fingerabdruck, damit auch die Knotenbindungsprüfung bewertet werden kann.

GET /v1/admin/licenses/lic_7f3a9c2e/diagnose?machine=fp_9b21c4 HTTP/1.1
Host: licensing.example.com
Authorization: Bearer {admin_read_token}

Die Antwort ist die Pipeline, vollständig bewertet. Jede Prüfung trägt ihr eigenes Urteil — pass, fail oder unknown — und ein fail trägt einen maschinenlesbaren code plus ein menschliches detail. Entscheidend: Nichts schließt kurz — der fail bei der Sitzprüfung hindert die Rechteprüfung nicht daran, zu melden, außer dort, wo eine Prüfung serverseitig echt nicht bewertet werden kann.

{
  "licenseId": "lic_7f3a9c2e",
  "keyFingerprint": "KR…c4e1",
  "product": "acme-suite",
  "edition": "pro",
  "overall": "blocked",
  "checks": [
    { "gate": "signature",  "verdict": "pass" },
    { "gate": "dateWindow", "verdict": "pass", "expiresOn": "2027-03-01T00:00:00Z" },
    { "gate": "revocation", "verdict": "pass" },
    { "gate": "machine",    "verdict": "pass", "detail": "Reported fingerprint matches the bound host." },
    { "gate": "seat",       "verdict": "fail", "code": "seats_exhausted",
      "detail": "5 of 5 seats are leased. Oldest lease expires in 00:11:42." },
    { "gate": "entitlement","verdict": "unknown",
      "detail": "Not reached by the client; not evaluated without a requested feature." }
  ]
}

Das Lese-Token ist das wichtige Wort. Dieser Endpunkt ist nur GET, und der Token-Geltungsbereich gewährt nichts außer Lesevorgängen — er kann weder widerrufen noch neu binden, verlängern oder einen Sitz freigeben. Ein Support-Ingenieur, der diagnostizieren kann, sollte nicht dadurch auch stillschweigend freie Kapazität ausgeben können. Die Behebung ist eine separate, geprüfte Aktion hinter einem anderen Geltungsbereich.

Das Support-Werkzeug

Mit einem schreibgeschützten Endpunkt ist das Werkzeug selbst schlank: die Diagnose abrufen, die Prüfliste darstellen und mit der ersten fehlschlagenden Prüfung beginnen — denn das ist die, bei der der Client tatsächlich anhielt, und die, an die der Kunde stößt.

public sealed class LicenseDoctor(HttpClient admin)
{
    public async Task<Diagnosis> LookUpAsync(string handle, string? machine, CancellationToken ct)
    {
        var url = $"/v1/admin/licenses/{Uri.EscapeDataString(handle)}/diagnose";
        if (machine is not null) url += $"?machine={Uri.EscapeDataString(machine)}";
        return (await admin.GetFromJsonAsync<Diagnosis>(url, ct))!;
    }

    public static void Print(Diagnosis d)
    {
        Console.WriteLine($"License {d.KeyFingerprint}  ({d.Product}/{d.Edition})  →  {d.Overall.ToUpper()}");
        foreach (var c in d.Checks)
        {
            var mark = c.Verdict switch
            {
                "pass"    => "[ok]  ",
                "fail"    => "[FAIL]",
                _         => "[?]   ",
            };
            Console.WriteLine($"  {mark} {c.Gate,-12} {c.Detail}");
        }

        var cause = d.Checks.FirstOrDefault(c => c.Verdict == "fail");
        if (cause is not null)
            Console.WriteLine($"\nRoot cause: {cause.Gate} — {cause.Code}\n{cause.Detail}");
    }
}

public sealed record Diagnosis(string LicenseId, string KeyFingerprint, string Product,
    string Edition, string Overall, IReadOnlyList<Check> Checks);
public sealed record Check(string Gate, string Verdict, string? Code = null, string? Detail = null);

Gegen das ACME-Ticket ausgeführt, druckt es die ganze Geschichte auf einen Blick:

License KR…c4e1  (acme-suite/pro)  →  BLOCKED
  [ok]   signature
  [ok]   dateWindow    expires 2027-03-01
  [ok]   revocation
  [ok]   machine       Reported fingerprint matches the bound host.
  [FAIL] seat          5 of 5 seats are leased. Oldest lease expires in 00:11:42.
  [?]    entitlement   Not reached by the client; not evaluated without a requested feature.

Root cause: seat — seats_exhausted
5 of 5 seats are leased. Oldest lease expires in 00:11:42.

Das Ticket ist nun in einer Zeile beantwortet: ACME ist weder kaputt noch abgelaufen noch im falschen Tarif — es hat schlicht alle gekauften Sitze belegt, und ein Lease wird in elf Minuten frei. Der Ingenieur sagt ihnen, sie sollen warten, eine Sitzung schließen oder mehr Sitze kaufen, und niemand verbringt einen Nachmittag mit der Jagd nach einem Ablauf, der nie das Problem war.

Die Rechteprüfung lesen

Die einzige Prüfung, die standardmäßig unknown meldet, ist die des Rechts, und der Grund verdient klare Worte: Rechte werden gegen eine Funktion bewertet, die die App angefragt hat. Die Diagnoseansicht weiß nicht, welche Funktion der Kunde suchte, und kann daher nicht sagen, ob diese bestimmte Gewährung vorliegt, bis Sie es ihr mitteilen. Übergeben Sie den Funktionsschlüssel, und es löst sich auf:

GET /v1/admin/licenses/lic_7f3a9c2e/diagnose?feature=feature.export HTTP/1.1
{ "gate": "entitlement", "verdict": "fail", "code": "not_granted",
  "detail": "This license grants max_projects=10 but not feature.export (Standard edition)." }

Diese Schlüssel — feature.export, max_projects, max_major_version — sind die eigenen Rechtenamen des Anbieters, in der signierten Gewährung getragen und wörtlich angezeigt. Die Diagnose liest sie direkt aus dem maßgeblichen Datensatz, sodass sich „der Kunde schwört, er habe für den Export bezahlt” sofort in „seine Edition enthält ihn nicht” auflöst — ein Vertriebsgespräch, kein Fehler.

Vorbehalte, und die Linie, die das Werkzeug nicht überschreiten darf

Drei Grenzen halten das ehrlich. Erstens ist das Werkzeug per Vertrag schreibgeschützt: Diagnose und Behebung sind verschiedene Geltungsbereiche, sodass die Fähigkeit, eine Blockade zu erklären, nie die Fähigkeit ist, sie stillschweigend aufzuheben. Zweitens hängen zwei Prüfungen von Tatsachen ab, die der Server nicht besitzt — der Maschinen-Fingerabdruck und die lokale Uhr leben auf dem Host des Kunden, sodass die Diagnose sie nur dann pass/fail markieren kann, wenn der Kunde sie meldet, und andernfalls unknown zurückgibt. Ein gesunder Server-Datensatz neben einem blockierten Kunden ist die Art, wie das Werkzeug genau auf diese zwei Dinge zeigt: eine verschobene Maschine oder eine abweichende Uhr. Drittens ist die Diagnose eine Momentaufnahme zu dem Zeitpunkt, zu dem der Support sie ausführt — ein um 14:02 erschöpfter Sitz kann um 14:05 frei sein — sodass die gedruckten Lease-Zeiten Orientierung sind, keine Garantie.

Und die Linie, die es nicht überschreiten darf: Der Schlüssel betritt den Fluss nie. Das Werkzeug identifiziert eine Lizenz per ID oder Fingerabdruck, die Antwort gibt nur einen Fingerabdruck zurück, und das Support-Protokoll, das das Ticket überdauert, trägt nichts, womit ein Leser aktivieren könnte. Ein Diagnosewerkzeug existiert, um „es sagt nur blockiert” in „Sitze erschöpft, wird in elf Minuten frei” zu verwandeln — um den geschlossen scheiternden Client für einen Menschen lesbar zu machen — und gibt dabei genau so wenig preis wie der Client selbst.

Nebula.NET testen

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