Keyright
Software licensing for your app
Erste Schritte
Überblick
Was Keyright ist, wie sich Keyright Cloud und Self-Hosting unterscheiden, und eine Karte dieses Handbuchs — ein Issuing-Service plus native SDKs für Offline-Lizenzdateien und Online-Aktivierung.
Erste Schritte
Der durchgängige Anbieterpfad für Keyright Cloud und Self-Hosting — Issuing-Service bereitstellen, Produkt und Signaturschlüssel anlegen, SDK in die App einbauen, Lizenz ausstellen, in der App prüfen und live gehen.
Sicherheit & das Lease-Modell
Wie Keyright-Lizenzen abgesichert sind: was ein Schlüssel tatsächlich ist, warum eine Einzelplatzlizenz nicht auf zwei Rechnern laufen kann — auch nicht offline —, was „manipulationssicher“ wirklich bedeutet und wie genau der kurzlebige signierte Lease funktioniert — Verlängerung, Offline-Betrieb und warum das Bearbeiten einer Lease-Datei ihn nicht verlängern kann.
Anwendungsfälle
Eine kostenlose Testversion anbieten
Lassen Sie Kunden sich einen zeitlich begrenzten Testschlüssel per Self-Service von Ihrer eigenen Website holen — Keyright stellt ihn aus, sendet ihn per E-Mail, und Ihre App aktiviert ihn genau wie einen bezahlten Schlüssel — oder geben Sie einem netzwerkisolierten (air-gapped) Evaluator eine signierte Offline-Testdatei.
Aktivieren, deaktivieren & Plätze verschieben
Binden Sie einen Schlüssel an eine Maschine, geben Sie diesen Platz frei, damit der Kunde auf eine neue wechseln kann, und tun Sie das für Test-, Jahres- und unbefristete Lizenzen — online, offline/netzwerkisoliert (air-gapped) oder anbieterseitig, wenn eine Maschine nicht mehr existiert — mit genau dem, was Ihre App in jedem Fall sieht.
Entitlements
Entitlements sind signierte Schlüssel/Wert-Zuweisungen, die in jeder Keyright-Lizenz und jedem Lease mitgeführt werden. Verwenden Sie sie, um Funktionszugriff, numerische Kontingente und die Produktversionen zu steuern, die eine Lizenz ausführt — alles aus einem einzigen Signaturschlüsselpaar, sodass Sie eine neue Hauptversion durch erneutes Ausstellen eines Schlüssels ausliefern, nie durch das Rotieren von Schlüsseln und das Ausliefern eines neuen öffentlichen Schlüssels.
Funktionen & Editionen schützen
Schalten Sie Pro-exklusive und editionsspezifische Funktionen direkt aus der signierten Lizenz frei: Definieren Sie Entitlements auf einem Tier, lesen Sie sie offline mit dem SDK aus und ändern Sie, was ein Kunde erhält, ohne neuen Code auszuliefern.
Upgrades verkaufen & Versionen steuern
Legen Sie fest, welche Releases Ihres Produkts jede Lizenz abdeckt — lebenslange Updates, ein Support-Zeitfenster, eine Hauptversion, Upgrade-Schutz, Abonnements mit oder ohne unbefristeten Fallback — und setzen Sie es in Ihrer Anwendung oder auf Ihrer eigenen Download-Seite durch, ohne Reaktivierung, ohne erneute Schlüsseleingabe und mit voller Offline-Unterstützung.
Nutzung abrechnen & Credits verkaufen
Verkaufen Sie Verbrauch zusätzlich zur Lizenzierung — Renderings, API-Aufrufe, KI-Generierungen, Exporte — mit Keyright-Credit-Pools, die an eine Lizenz gebunden sind: Preis pro Aktion festlegen, einen Pool befüllen, dann aus Ihrer Anwendung Guthaben abfragen und Credits verbrauchen, mit Probelauf-Preisberechnung und idempotenten Wiederholungen, online oder aus einem signierten Offline-Block.
Schlüssel automatisch aus einem Shop ausstellen
Verbinden Sie einen Shop oder Merchant-of-Record mit Keyright, sodass eine bezahlte Bestellung automatisch einen Lizenzschlüssel erzeugt und per E-Mail an den Käufer sendet — mit HMAC-verifizierten Events, idempotenten Wiederholungen und Widerruf bei Rückerstattung.
Widerrufen, verlängern & Ablauf behandeln
Zugang beenden, eine Laufzeit ohne neuen Schlüssel verlängern und genau wissen, was die Anwendung beim Ablauf, während der Kulanzfrist und nach dem Widerruf sieht — und wie sich das von einer selbst gehosteten Instanz unterscheidet, die sich selbst lizenziert.
Offline- und netzwerkisolierte Kunden unterstützen
Maschinen ohne Internet lizenzieren: eigenständige Offline-Lizenzdateien, langlebige netzwerkisolierte Leases, der Import eines signierten Abdeckungsblocks per Datei und wann Offline- statt Online-Aktivierung die richtige Wahl ist.
SDK-Integration
.NET-SDK-Integration
Ein vollständiger Rundgang von null bis lizenziert: Produkt in Keyright anlegen, öffentlichen Schlüssel mit Keyright.NET einbetten, Funktionen offline schützen, online aktivieren und Schlüssel an Kunden ausgeben — konstruktionsbedingt fail-closed.
Node.js-SDK-Integration
Keyright-Lizenzierung zu einer Node.js-App hinzufügen: das keyright-Paket installieren, Lizenzen offline prüfen, online aktivieren, Funktionen über Entitlements schützen und Testversionen sowie netzwerkisolierte (air-gapped) Maschinen handhaben — konstruktionsbedingt fail-closed.
Python-SDK-Integration
Fügen Sie Keyright-Lizenzierung zu einer Python-App hinzu: das Paket keyright installieren, Lizenzen offline prüfen, online aktivieren, Funktionen über Entitlements schützen sowie Testversionen und netzwerkisolierte (air-gapped) Maschinen behandeln — konstruktionsbedingt fail-closed.
Java-SDK-Integration
Fügen Sie Keyright-Lizenzierung zu einer Java-App hinzu: die Abhängigkeit com.delta1labs:keyright hinzufügen, Lizenzen offline prüfen, online aktivieren, Funktionen über Entitlements schützen sowie Testversionen und netzwerkisolierte (air-gapped) Maschinen behandeln — konstruktionsbedingt fail-closed.
Die HTTP-API direkt nutzen (beliebige Sprache)
Kein SDK für Ihre Sprache? Rufen Sie die Keyright-Runtime-API über HTTP auf: eine Maschine aktivieren, den signierten Lease selbst offline prüfen (kanonische Payload + RSA/SHA-256), deaktivieren und netzwerkisolierte (air-gapped) Maschinen handhaben — mit kopierbaren Beispielen, die Sie nach Go, Rust, C++, PHP und mehr portieren können.
Self-Hosting
Keyright selbst hosten
Betreiben Sie Keyright in Ihrer eigenen Infrastruktur — Docker, Kubernetes oder Windows/IIS, gegen Ihr eigenes PostgreSQL, bei Bedarf vollständig netzwerkisoliert (air-gapped). Diese Übersicht behandelt die Architektur und die zwei beweglichen Teile; der Rest des Abschnitts Self-Hosting führt Sie durch Bereitstellung, Konfiguration, Lizenzierung, die Anbindung Ihres Produkts und den Betrieb.
Community Edition
Betreiben Sie echte Keyright-Lizenzierung kostenlos als Community Edition mit einem einzelnen Knoten — bis zu 100 aktive Lizenzen und 1 Produkt mit Online-Aktivierung — und stufen Sie dieselbe Instanz anschließend an Ort und Stelle hoch, um die Obergrenzen aufzuheben und Offline-/Air-Gapped-Aktivierung, SSO, White-Label und mehr Knoten hinzuzufügen.
Bereitstellungsleitfaden (Schritt für Schritt)
Ein Schritt-für-Schritt-Rundgang zur Bereitstellung von selbst gehostetem Keyright in Ihrer eigenen Umgebung: Voraussetzungen, Deploy-Kit holen, Secrets erzeugen, PostgreSQL vorbereiten, einen Bereitstellungspfad wählen (Docker Compose, Kubernetes/Helm oder Windows/IIS), Lizenz installieren, prüfen und anmelden — von null zu einer laufenden, lizenzierten Instanz.
Konfigurationsreferenz
Jede Einstellung von selbst gehostetem Keyright: die vollständige Referenz der Umgebungsvariablen, wie Sie die Secrets erzeugen, Datenbankeinrichtung und Verbindungsstrings, White-Label für Dashboard und Portal sowie die Kubernetes-/Helm-Werte, die Sie tatsächlich setzen werden.
Lizenzierung & Editionen
Wie sich eine selbst gehostete Keyright-Instanz selbst lizenziert: das Fail-closed-Modell, die 30-tägige Enterprise-Testversion, der vollständige Lebenszyklus der Schlüsselzustände (Testversion vs. bezahlt, Kulanzfristen, was bei Ablauf passiert), die Editionen Standard, Pro und Enterprise sowie die Installation oder Erneuerung Ihres Schlüssels.
Ihr Produkt mit Ihrer Instanz verbinden
Machen Sie Self-Hosting wirksam: Richten Sie die Apps Ihrer Kunden auf Ihre eigene Keyright-Instanz aus. Produkt anlegen, seinen Signaturschlüssel erzeugen, den öffentlichen Schlüssel und Ihre Basis-URL im SDK einbetten, eine Lizenz ausstellen und aktivieren — dieselben SDKs wie beim gehosteten Keyright, nur mit Ihrem Produktschlüssel und Ihrer URL.
Betrieb & Fehlerbehebung
Betreiben Sie selbst gehostetes Keyright in Produktion: geplante Jobs, Observability, Sicherheitshärtung, Skalierung und Lastverteilung, Backup und Wiederherstellung, Upgrades, vollständig netzwerkisolierter (air-gapped) Betrieb sowie eine Fehlerbehebung/FAQ für das, was bei einem ersten Deployment auftritt.
Referenz
HTTP-API-Referenz
Eine lesbare Übersicht der HTTP-API des Issuing-Service, nach Bereichen gruppiert — Runtime, Admin, Platform, Auth, Plans, Webhooks — mit Methode, Pfad und der jeweiligen Authentifizierung.
Versionshinweise
Was sich in jedem Keyright-Release geändert hat — der Issuing-Service und die SDKs für .NET, Node.js, Python und Java.
Dashboard-Kurzreferenz
Wo Sie jede Aufgabe im Web-Dashboard erledigen — ein Referenzindex, kein Rundgang Bildschirm für Bildschirm.