Delegationsketten lassen Reseller eigene Schlüssel ausstellen
Sie unterschreiben einen Vertriebsvertrag, und die erste Integrationsfrage lautet: „Wie stellen unsere Reseller Schlüssel an Endkunden aus?" Die beiden naheliegenden Antworten sind beide falsch: Geben Sie jedem Reseller Ihren Root-Signaturschlüssel, und ein einziger gestohlener Laptop fälscht Ihren gesamten Katalog; oder leiten Sie jeden Reseller-Verkauf über einen Live-Aufruf an Ihren Ausstellungsdienst, und Ihre Partner können nicht verkaufen, wenn Sie ausfallen. Das Design, das hält, ist eine Delegationskette: Geben Sie jedem Reseller ein signiertes Zertifikat, das seinen eigenen öffentlichen Schlüssel und einen Geltungsbereich trägt, den er nie überschreiten kann, lassen Sie ihn Endkunden-Lizenzen mit der privaten Hälfte signieren, und lassen Sie den Client die gesamte Kette offline gegen einen einzigen angehefteten Root-Schlüssel prüfen. Dieser Artikel baut diese Kette in Keyright: das Delegationszertifikat und seinen Geltungsbereich, wie ein Reseller darin ausstellt, die SDK-Prüfung, die Lizenz → Delegat → Root durchläuft, die Regel, dass sich der Geltungsbereich nur verengen kann, und warum das Widerrufen eines einzigen Zertifikats stillschweigend jeden Schlüssel verfallen lässt, den ein kompromittierter Reseller je ausgestellt hat.
Sie haben gerade Ihren ersten Vertriebsvertrag unterschrieben. Ein Reseller in einer anderen Region wird Ihr .NET-Produkt verkaufen, seine eigenen Kunden betreuen, seine eigenen Lizenzschlüssel ausstellen und Ihnen einen Anteil abführen. Der Vertrag steht; die Integrationsfrage landet am nächsten Morgen: Wie prägen unsere Leute eigentlich die Schlüssel?
Es gibt zwei Antworten, die naheliegend erscheinen und beide Fallen sind.
Die erste besteht darin, dem Reseller Ihren Root-Signaturschlüssel zu geben, damit er ausstellen kann, was er braucht. Nun hält jeder Partner-Laptop den Schlüssel, der Ihre gesamte Produktlinie validiert, und an dem Tag, an dem einer davon per Phishing erbeutet, gestohlen oder einfach auf eine private Maschine kopiert wird, kann der Angreifer einen unbefristeten Schlüssel mit allen Funktionen für jedes Produkt prägen, das Sie verkaufen — und Sie können seine Fälschungen nicht von Ihren eigenen Signaturen unterscheiden, denn sie sind Ihre Signatur.
Die zweite besteht darin, jeden Reseller-Verkauf zurück über Ihren Ausstellungsdienst zu leiten: Der Reseller füllt ein Formular aus, Ihr Dienst signiert den Schlüssel, er reicht ihn weiter. Nichts leckt, aber Sie haben den Verkaufstresen Ihrer Partner von Ihrer Verfügbarkeit und Ihrem Netzwerkpfad abhängig gemacht, und ein Reseller, der Sie nicht erreichen kann, kann keinen Verkauf abschließen.
Das Design, das auf keines von beidem verzichtet, ist eine Delegationskette. Dieser Artikel baut eine in Keyright.
Was eine Delegationskette ist
Übernehmen Sie die Form von der Funktionsweise von TLS-Zertifikaten. Ein Root-Schlüssel, den Sie offline halten, signiert eine kleine Zahl von Zwischenzertifikaten; diese Zwischenzertifikate signieren die Blatt-Zertifikate, die Server tatsächlich präsentieren; und ein Browser vertraut einem Blatt, weil er die Kette bis zu einem Root zurückverfolgen kann, den er anheftet. Der private Root muss fast nie herauskommen.
Auf die Lizenzierung übertragen, reihen sich drei Schlüssel in einer Linie auf:
- Ihr Root-Schlüsselpaar lebt auf Ihrer Keyright-Instanz und signiert nichts, was dem Kunden begegnet. Es signiert Delegationszertifikate und sonst nichts.
- Jeder Reseller besitzt ein Delegat-Schlüsselpaar. Er erzeugt es; er behält die private Hälfte; Sie sehen sie nie. Sie signieren ein Zertifikat, das seine öffentliche Hälfte an einen Geltungsbereich bindet.
- Der Reseller signiert Endkunden-Lizenzen mit seinem privaten Delegat-Schlüssel.
Eine so ausgestellte Lizenz ist kein bloßes Token. Sie ist ein Bündel: die Endlizenz plus das Delegationszertifikat, das sie autorisiert, die zusammen reisen, damit der Client die gesamte Kette mit nichts anderem als dem einen öffentlichen Root-Schlüssel prüfen kann, den er bereits mitbringt.
Ein Delegationszertifikat prägen
Der Reseller erzeugt auf seiner Seite ein Schlüsselpaar und sendet Ihnen nur die öffentliche Hälfte. Sie prägen sein Zertifikat mit der Admin-CLI gegen Ihre Instanz und versehen es mit dem Geltungsbereich, innerhalb dessen er verkaufen darf:
keyright delegate create \
--name "Northwind Distribution GmbH" \
--public-key "MCowBQYDK2VwAyEA9r...kQ=" \
--product acme-suite \
--max-expiry 2027-12-31 \
--allow-entitlement export,max-dpi,seats \
--max-seats 50 \
--not-after 2026-12-31
Lesen Sie den Geltungsbereich sorgfältig, denn jedes Feld ist eine Obergrenze, die der Reseller niemals anheben kann:
--productbindet ihn an eine Produktlinie. Ein Delegat füracme-suitekann keinen Schlüssel füracme-enterprisesignieren.--max-expiryist das am weitesten entfernte Ablaufdatum, das jede von ihm ausgestellte Lizenz tragen darf. Er kann einen Einjahresschlüssel verkaufen; einen unbefristeten kann er nicht verkaufen.--allow-entitlementist die Menge der Berechtigungsnamen, die er gewähren darf. Alles außerhalb davon wird bei der Prüfung verworfen, sodass ein Reseller nicht stillschweigend eine Funktion aktivieren kann, die Sie dem Direktverkauf vorbehalten.--max-seatsbegrenzt die Anzahl der Sitze auf jedem einzelnen Schlüssel, den er ausstellt.--not-afterist das Ablaufdatum des Zertifikats selbst — die Delegation selbst erlischt an diesem Datum, unabhängig von den darunter ausgestellten Schlüsseln, sodass ein abgelaufener Partnervertrag automatisch aufhört, Schlüssel zu prägen.
Der Dienst gibt das signierte Zertifikat zurück. Die Signatur deckt den öffentlichen Schlüssel des Delegaten und den Geltungsbereich zusammen ab, sodass keines von beiden geändert werden kann, ohne sie zu brechen:
HTTP/1.1 201 Created
Content-Type: application/json
{
"delegateId": "del_7Qk2",
"name": "Northwind Distribution GmbH",
"publicKey": "MCowBQYDK2VwAyEA9r...kQ=",
"scope": {
"product": "acme-suite",
"maxExpiry": "2027-12-31T00:00:00Z",
"allowEntitlements": ["export", "max-dpi", "seats"],
"maxSeats": 50
},
"notAfter": "2026-12-31T00:00:00Z",
"signedBy": "root",
"certificate": "eyJ2IjoxLCJkZWxlZ2F0ZUlkIjoiZGVsXzdRazIi...<signed>"
}
Diese certificate-Zeichenkette ist das, was der Reseller in jede von ihm ausgestellte Lizenz einbettet. Sie behalten nichts Geheimes von ihm; er behält nichts Geheimes von Ihnen.
Der Reseller stellt innerhalb des Geltungsbereichs aus
Der Reseller führt seinen eigenen kleinen Ausstellungsschritt aus — eine CLI an seinem Verkaufstresen oder einen eigenen schlanken Dienst — und signiert mit dem privaten Delegat-Schlüssel. Er ruft Ihre Instanz nie an, um einen Verkauf abzuschließen:
keyright issue \
--delegate-cert ./northwind.cert \
--delegate-key ./northwind.key \
--licensee acct_8f21 \
--expiry 2027-03-01 \
--entitlement export=true \
--entitlement seats=10
Die Ausgabe ist das Bündel — Endlizenz und Delegationszertifikat, verkettet zu einem einzigen .lic-Blob, den der Kunde genau wie jeden anderen Schlüssel aktiviert. Wenn der Reseller versucht, über die Stränge zu schlagen — --expiry 2030-01-01, jenseits seines maxExpiry, oder --entitlement watermark=false, das nicht in seiner erlaubten Menge ist — weist der vernünftige Aussteller es lokal zurück. Aber die lokale Zurückweisung ist eine Bequemlichkeit, nicht die Garantie. Die Garantie lebt im Client, der alles erneut prüft, ganz gleich, was das Werkzeug des Resellers zugelassen hat oder nicht.
Der Client prüft die Kette
Auf der Maschine des Kunden ist das SDK mit einer einzigen Sache konfiguriert, die zählt: dem Root-öffentlichen Schlüssel. Nicht dem des Resellers — dem des Roots. Diese eine Anheftung ist es, die dem Client erlaubt, einem Schlüssel zu vertrauen, der von einem Partner signiert wurde, von dem er nie gehört hat.
static readonly KeyrightClient License = KeyrightClient.Initialize(new KeyrightOptions
{
Product = "acme-suite",
RootPublicKeyBase64 = AcmeKeys.RootPublicKey, // the ROOT, pinned in the app
ServiceUrl = "https://licensing.acme.example",
});
LicenseInfo info = License.Validate();
Validate() durchläuft die Kette innerhalb des Bündels:
- Es liest das Delegationszertifikat und prüft die Signatur der Endlizenz gegen den öffentlichen Delegat-Schlüssel, den das Zertifikat trägt.
- Es prüft die Signatur des Delegationszertifikats gegen den angehefteten öffentlichen Root-Schlüssel — und verweigert, wenn das
notAfterdes Zertifikats bereits verstrichen ist. - Es begrenzt dann die Lizenz auf den Geltungsbereich des Zertifikats, bevor es irgendetwas meldet: Das effektive Ablaufdatum ist das frühere von Lizenzablauf und dem
maxExpirydes Delegaten; jede Berechtigung, die nicht inallowEntitlementssteht, gilt als nicht gesetzt; die Sitzanzahl wird aufmaxSeatsgedeckelt.
Nur eine Lizenz, die von einem Delegaten signiert ist, dessen Delegat von Ihrem Root signiert ist, und die vollständig innerhalb ihres Geltungsbereichs liegt, kommt als gültig zurück. Von dort an prüft Ihre Anwendung genau so, wie sie es immer getan hat — info.IsValid, dann die Berechtigungen:
if (!info.IsValid) { RunEvaluation(info); return; }
if (License.IsEnabled("export")) EnableExport();
int seats = (int)License.GetLimit("seats", fallback: 1);
// Who issued it — useful for support and telemetry, never for the gate itself.
Log.Information("Licensed via {Delegate}", info.IssuedBy); // "del_7Qk2"
Der Kunde weiß nie und kümmert sich nie darum, dass ein Reseller seinen Schlüssel signiert hat. Die Kette ist ein Implementierungsdetail des Vertrauens; die Schranke, auf die er trifft, ist dieselbe, auf die ein Direktkunde trifft.
Der Geltungsbereich kann sich nur verengen
Das ist die Eigenschaft, die Delegation sicher macht, und es lohnt sich, es klar zu sagen: Nichts weiter unten in der Kette kann mehr gewähren, als sein Elternteil erlaubt hat. Die Begrenzung in Schritt 3 ist kein Ratschlag — sie ist das gesamte Sicherheitsmodell. Ein Reseller, der seinen Aussteller so bearbeitet, dass er maxExpiry: 2099 auf einen Schlüssel stempelt, gewinnt nichts, weil der Client das Minimum aus Lizenzablauf und dem maxExpiry des Geltungsbereichs nimmt, und der Geltungsbereich steckt im Zertifikat, und das Zertifikat ist von Ihrem Root signiert. Ein einziges geändertes Byte im Geltungsbereich bricht die Signatur des Roots, und die Kette scheitert in Schritt 2 im geschlossenen Zustand.
Das Schlimmste also, was ein vollständig kompromittierter Reseller-Schlüssel tun kann, ist, Schlüssel innerhalb des Geltungsbereichs auszustellen, den Sie ihm bereits gewährt haben — ein Produkt, begrenztes Ablaufdatum, eine feste Berechtigungsmenge, eine Sitz-Obergrenze. Das ist ein schlechter Tag. Es ist keine Katastrophe, und es lässt sich nicht in Ihre anderen Produkte fälschen. Vergleichen Sie das mit der ersten Falle, bei der ein geleakter Root-Schlüssel die Katastrophe schlechthin ist.
Ein Widerruf, der sich fortpflanzt
Weil jede Endlizenz im Feld das Zertifikat trägt, von dem sie abstammt, haben Sie einen Notschalter auf Zertifikatsebene. Wenn der Schlüssel eines Resellers kompromittiert wird — oder der Vertrag endet oder er beim Überausstellen ertappt wird — widerrufen Sie den Delegaten, einen einzigen Eintrag, und jede Lizenz, die dieser Reseller je signiert hat, hört bei ihrer nächsten Neuvalidierung im Kulanzfenster auf zu validieren:
keyright delegate revoke del_7Qk2 --reason "partner contract ended"
Der Client erfährt, dass der Delegat widerrufen ist, auf dieselbe Weise, wie er erfährt, dass ein einzelner Schlüssel es ist — über die Widerrufsliste, die er ohnehin abruft — und lässt die Kette am Delegat-Glied scheitern. Sie müssen nicht wissen, an welche Endkunden dieser Reseller verkauft hat, noch einzelnen Schlüsseln nachjagen; das Kappen des Astes lässt jedes Blatt daran fallen. Für einen sauberen Partnerausstieg würden Sie in der Regel auch notAfter ablaufen lassen, statt hart zu widerrufen, sodass bestehende Kunden ihre Laufzeiten ausschöpfen, während keine neuen Schlüssel mehr geprägt werden können.
Die Kette testen
Der Test, der seinen Platz verdient, ist der Überschreitungstest — nachzuweisen, dass der Client sich weigert, eine Geltungsbereichsverletzung zu honorieren, selbst wenn die Signatur des Resellers vollkommen gültig ist:
[Fact]
public void Client_clamps_a_license_that_exceeds_its_delegate_scope()
{
var root = TestRoot.Create();
var delegate_ = root.MintDelegate(product: "acme-suite",
maxExpiry: new DateTime(2027, 12, 31), maxSeats: 50,
allow: new[] { "export", "seats" });
// A validly-signed key that asks for more than the scope allows.
string bundle = delegate_.Issue(licensee: "acct_8f21",
expiry: new DateTime(2099, 1, 1), // past maxExpiry
entitlements: new() { ["seats"] = 500 }); // past maxSeats
var client = KeyrightClient.Initialize(new KeyrightOptions
{ Product = "acme-suite", RootPublicKeyBase64 = root.PublicKeyBase64,
LicenseBlob = bundle });
var info = client.Validate();
Assert.True(info.IsValid); // chain is well-formed
Assert.True(info.Expiry <= new DateTime(2027, 12, 31)); // expiry clamped to scope
Assert.Equal(50, client.GetLimit("seats", fallback: 1)); // seats clamped to scope
}
Ergänzen Sie ihn durch das Gegenteil — ein Schlüssel innerhalb des Geltungsbereichs validiert und behält seine eigenen, kleineren Zahlen — und durch einen dritten, der den Delegaten widerruft und bestätigt, dass die Kette dann im geschlossenen Zustand scheitert. Ein gefälschter In-Memory-Ausstellungsdienst erlaubt es Ihnen, Test-Roots, -Delegaten und -Blätter zu prägen, ohne Ihre echte Instanz zu berühren.
Das Fazit
Reseller müssen Schlüssel prägen; Sie müssen Ihren Root-Schlüssel niemals herausgeben und Ihre Partner niemals von Ihrer Verfügbarkeit abhängig machen, um zu verkaufen. Eine Delegationskette gibt Ihnen beides. Signieren Sie jedem Reseller ein Zertifikat, das seinen öffentlichen Schlüssel an einen Geltungsbereich bindet, der eine harte Obergrenze ist — ein Produkt, ein maximales Ablaufdatum, eine erlaubte Berechtigungsmenge, eine Sitz-Obergrenze und ein Ablaufdatum für die Delegation selbst. Lassen Sie sie Endkunden-Schlüssel offline mit der privaten Hälfte signieren. Liefern Sie nur den öffentlichen Root-Schlüssel in Ihrer Anwendung aus, und lassen Sie das SDK Lizenz → Delegat → Root durchlaufen und jeden Schlüssel auf seinen Geltungsbereich begrenzen, bevor es ihn als gültig meldet. Der Geltungsbereich kann sich nur verengen, sodass ein kompromittierter Partner begrenzt und nicht katastrophal ist; und weil jeder Schlüssel sein Elternzertifikat trägt, zieht das Widerrufen eines Delegaten jeden Schlüssel darunter zurück, ohne dass Sie je die Kundenliste kennen. So lassen Sie hundert Reseller Schlüssel ausstellen und halten trotzdem genau einen Schlüssel, auf den es ankommt.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.