Ein Lizenzschlüsselsystem für Quellcode erfüllt drei Aufgaben: Es belegt, dass ein Käufer das Produkt erworben hat, es erfasst, wo das Produkt installiert ist, und es ermöglicht Ihrem Code, sein Verhalten an die Edition anzupassen, die der Käufer besitzt. Es macht lesbaren Quellcode nicht unkopierbar, und der Versuch, genau das zu erreichen, schadet ehrlichen Käufern meist mehr als Raubkopierern. Der Ansatz, der für die meisten Verkäufer am besten funktioniert, ist einfach: Fragen Sie den Schlüssel einmal im Installer ab, prüfen Sie ihn serverseitig über eine Lizenz-API, binden Sie ihn an die Domain der Installation – und halten Sie sich danach im Hintergrund.
Dieser Ratgeber erklärt, wie das funktioniert und wie Sie es in Ihr Produkt einbauen. Er ist Teil unseres umfassenderen Ratgebers dazu, wie Sie den Quellcode Ihrer Web-App oder Ihres SaaS verkaufen. Auf AppTrovo erzeugt jeder Verkauf automatisch einen Lizenzschlüssel, mit Domain-Aktivierung und einer Lizenzprüfungs-API. Sie müssen den Lizenzserver also nicht selbst bauen, sondern nur die kleine clientseitige Prüfung in Ihrem Installer.
Wenn Sie nur die API-Referenz benötigen, gehen Sie direkt zum Leitfaden zur Lizenzintegration. Lesen Sie weiter, wenn Sie die Hintergründe, die Abwägungen und einen Testplan kennenlernen möchten.
Was kann ein Lizenzschlüssel tatsächlich schützen?
Wenn Sie lesbaren Quellcode verkaufen, kann eine entschlossene Person eine Lizenzprüfung immer entfernen. Wer das ehrlich anerkennt, entwirft etwas Nützliches statt etwas Lästiges.
| Ein Lizenzschlüsselsystem kann | Ein Lizenzschlüsselsystem kann nicht |
|---|---|
| vor der Installation bestätigen, dass ein gültiger Kauf vorliegt | verhindern, dass jemand die Prüfung aus lesbarem Code löscht |
| erfassen, auf welchen Domains eine Lizenz aktiviert ist | verhindern, dass ein Käufer eine ZIP-Datei weitergibt |
| Ihrem Code mitteilen, welche Edition der Käufer besitzt | eine klare Lizenzvereinbarung ersetzen |
| anzeigen, ob Support und Updates aktiv sind | in jedem Fall die Zahlung garantieren |
| Ihnen bei Support-Anfragen oder Streitfällen einen sauberen Nachweis liefern | ein Produkt ausgleichen, dem Käufer nicht vertrauen |
Betrachten Sie den Lizenzschlüssel als Quittung mit einer Adresse darauf, nicht als Schloss. Die meisten Käufer von Unternehmenssoftware sind ehrlich und möchten sich an die Lizenz halten, vor allem wenn Updates und Support davon abhängen. Der Schlüssel macht den ehrlichen Weg zum einfachen Weg.
Sollten Sie Ihren Code verschleiern oder verschlüsseln?
Manche Verkäufer versuchen, PHP-Skripte durch Kodierung oder Verschleierung zu schützen. Für einen Marktplatz für Quellcode ist das meist ein Fehler:
- Käufer bezahlen für den Quellcode. Der Grund, warum sie sich für eine selbst gehostete App entscheiden, ist die Möglichkeit, den Code zu lesen, zu prüfen und zu ändern. Kodierte Dateien nehmen ihnen genau diesen Wert.
- Encoder bringen zusätzliche Hosting-Anforderungen mit, etwa spezielle Loader, die zu fehlgeschlagenen Installationen und Support-Tickets führen.
- Verschleierung verbirgt auch vor Ihnen Fehler und macht eine Sicherheitsprüfung durch den Käufer unmöglich.
- Sie stoppt Raubkopien nur selten. Raubkopien kodierter Produkte sind trotzdem im Umlauf.
Investieren Sie die Mühe lieber in das, was das Bezahlen lohnenswert macht: Updates, Support, Dokumentation und Funktionen der kommerziellen Edition. Genau das bekommt eine Raubkopie nie.
So funktioniert die Domain-Aktivierung
Die Domain-Aktivierung bindet einen Lizenzschlüssel an die Orte, an denen das Produkt installiert ist. Auf AppTrovo sieht der Ablauf so aus:
- Der Käufer erwirbt das Produkt und erhält einen eindeutigen Lizenzschlüssel (eine UUID).
- Während der Installation sendet Ihr Installer den Schlüssel und die Domain der Installation vom Server aus an die Lizenzprüfungs-API.
- Ist der Schlüssel gültig und ein Aktivierungsplatz frei, wird die Domain bei der Lizenz hinterlegt, und die Antwort bestätigt dies.
- Wird der Installer erneut auf derselben Domain ausgeführt, wird kein weiterer Platz belegt.
- Zieht der Käufer auf einen neuen Server oder eine neue Domain um, deaktiviert er die alte Domain in seinem Dashboard und aktiviert die neue. Siehe Domain-Aktivierungen verwalten.
Jede Lizenz hat eine begrenzte Anzahl an Aktivierungsplätzen, und die Antwort der Prüfung teilt Ihnen mit, wie viele belegt (activations_used) und verfügbar (activations_limit) sind. Dieses Limit erlaubt es einem Käufer, eine Produktivseite und eine Staging-Kopie zu betreiben, ohne Sie fragen zu müssen, und hält gleichzeitig von Installationen auf Dutzenden unabhängiger Domains ab. Was die Lizenz rechtlich erlaubt, legen die Lizenzbedingungen fest, nicht die Anzahl der Plätze.
Einmal prüfen oder nach Hause telefonieren?
Es gibt drei gängige Strategien dafür, wann Ihr Code die Lizenz prüft. Diese Wahl ist wichtiger als jede andere Lizenzentscheidung, denn sie bestimmt, ob die Lizenzierung die Produktivseite eines Käufers lahmlegen kann.
| Strategie | Funktionsweise | Risiko für Käufer | Empfehlung |
|---|---|---|---|
| Einmalige Prüfung bei der Installation | Der Installer prüft den Schlüssel; danach läuft die App normal | Sehr gering; ein Netzwerkproblem betrifft nur den Installer | Empfohlener Standard |
| Regelmäßige Nachprüfung | Ein geplanter Job prüft den Schlüssel täglich oder wöchentlich | Mittel; Ausfälle, Firewalls oder Ratenbegrenzungen können Fehlalarme auslösen | Vermeiden, sofern Sie keinen triftigen Grund haben |
| Prüfung bei jeder Anfrage | Jeder Seitenaufruf kontaktiert den Lizenzserver | Hoch; verlangsamt jede Seite und macht Ihren Server zum Single Point of Failure | Nicht verwenden |
Der Integrationsleitfaden von AppTrovo empfiehlt die einmalige Prüfung: Nach erfolgreicher Installation schreibt das Produkt eine „installiert“-Markierung und ruft die API nie wieder auf. Die Produktiv-App eines Käufers sollte niemals ausfallen, weil ein Lizenzserver während eines Netzwerkproblems nicht erreichbar war.
So bauen Sie eine Lizenzprüfung in Ihren Installer ein
Die Prüf-API ist eine einzelne GET-Anfrage an /api/v1/licenses/verify mit dem license_key sowie optional Ihrem product_slug und der domain der Installation. Es wird empfohlen, den Produkt-Slug mitzusenden, denn so ist sichergestellt, dass der Schlüssel zu Ihrem Produkt gehört und nicht zu einem anderen. Hier ist der Ablauf im Installer Schritt für Schritt:
- Fragen Sie den Schlüssel ab. Fügen Sie Ihrem Web-Installer einen Lizenzschritt mit einem einzigen Feld hinzu. Der Käufer sollte weder einen Produktnamen eingeben noch Konfigurationsdateien bearbeiten müssen; legen Sie Ihren Produkt-Slug in Ihrer eigenen Konfiguration fest, bevor Sie das ZIP packen.
- Prüfen Sie auf dem Server. Rufen Sie die API aus Ihrem Backend mit einem kurzen Timeout und aktivierter SSL-Prüfung auf. Prüfen Sie niemals aus JavaScript im Browser heraus, und legen Sie niemals Geheimnisse in clientseitigen Code.
- Senden Sie die Domain mit. Übergeben Sie den Host der Installation, damit die Aktivierung dafür erfasst wird.
- Verarbeiten Sie die Antwort. Ist
validwahr, speichern Sie lokal, was Sie benötigen: die Edition auslicense_type, den Namen des Lizenznehmers und die Support-Daten, falls Ihr Admin-Bereich sie anzeigt. Ist der Wert falsch, zeigen Sie denfailure_reasonin verständlicher Sprache an und lassen Sie den Käufer es erneut versuchen. - Markieren Sie die Installation als abgeschlossen. Schreiben Sie die „installiert“-Markierung und fahren Sie mit den Schritten für Datenbank und Admin-Benutzer fort. PHPs version_compare() ist später ebenfalls nützlich, wenn Ihr Admin-Bereich die installierte Version mit dem neuesten Release vergleicht. Ab hier läuft kein Lizenzcode mehr.
Für Laravel-Produkte gibt es ein Installer-SDK zum direkten Einbinden, mit einem fertigen Installer-Controller und einer kleinen Middleware, die nur prüft, ob die „installiert“-Markierung vorhanden ist. Die vollständige Parameterliste, die Antwortfelder und die Fehlergründe finden Sie im Artikel zur Lizenzprüfungs-API und im Integrationsleitfaden. Die API ist ratenbegrenzt (zum Zeitpunkt der Erstellung 120 Anfragen pro Minute und IP) – ein weiterer Grund, nicht bei jeder Anfrage zu prüfen.
Speichern Sie das Ergebnis sicher
Behandeln Sie den Lizenzschlüssel wie jede andere Zugangsinformation: Halten Sie ihn aus öffentlichen Verzeichnissen, aus Logs und aus dem Frontend heraus. Das OWASP Secrets Management Cheat Sheet enthält allgemeine Hinweise zum Umgang mit Schlüsseln und Tokens in Anwendungen.
Schalten Sie Funktionen nach Edition frei, nicht nach Domain
AppTrovo-Produkte gibt es in genau zwei Editionen: einer kostenlosen, im Funktionsumfang eingeschränkten Community-Edition (Käufer dürfen sie produktiv einsetzen, ohne Support durch den Autor) und einer kostenpflichtigen Kommerziellen Lizenz, die den vollen Funktionsumfang freischaltet. Eine dritte Stufe gibt es nicht. Die Antwort der Prüfung teilt Ihnen in license_type mit, welche der Käufer besitzt (community oder commercial, dazu developer für Ihre eigenen Testschlüssel).
- Schalten Sie anhand von
license_typefrei, nicht anhand des Slugs des Editionsobjekts. Der interne Slug der kommerziellen Edition ist eine dauerhafte Kennung, die nicht „commercial“ lautet, daher istlicense_typedas Feld, das für die Freischaltung vorgesehen ist. - Speichern Sie die Edition während der Installation in Ihrer Einstellungstabelle und lesen Sie sie zur Laufzeit lokal aus.
- Legen Sie klar fest, was jede Edition umfasst, und schreiben Sie es in das Angebot. Versteckte Einschränkungen, die erst nach der Installation auftauchen, wirken wie ein Trick.
Die Antwort enthält außerdem product.retired. Wenn Sie ein Produkt einmal einstellen, werden bestehende Lizenzen weiterhin bestätigt, und Ihr Admin-Bereich kann einen dezenten Hinweis anzeigen, dass keine weiteren Updates geplant sind.
Entwicklung, Staging und Serverumzüge berücksichtigen
Eine Lizenzierung, die reale Arbeitsabläufe ignoriert, erzeugt Tickets. Planen Sie für diese Fälle:
- Lokale Entwicklung. Käufer installieren zuerst auf
localhostoder einer.test-Domain. Entscheiden Sie, ob Ihr Installer das als Aktivierung zählt; viele Verkäufer lassen die Domain bei lokalen Hosts weg. - Staging-Kopien. Aktivierungsplätze gibt es, damit eine Staging-Seite keine zweite Lizenz benötigt. Erwähnen Sie das in Ihrer Dokumentation.
- Servermigrationen. Dokumentieren Sie die Schritte: alte Domain im Dashboard deaktivieren, Dateien verschieben, Lizenzschritt oder Installer auf der neuen Domain erneut ausführen.
- Agenturen, die für Kunden installieren. Erklären Sie, welche Domain aktiviert werden sollte und wer den Schlüssel verwahren sollte. Verweisen Sie für die Nutzung durch Kunden auf die Lizenzbedingungen.
Testen Sie Ihre Integration vor der Einreichung
Für Ihr eigenes Produkt besitzen Sie keine bezahlte Lizenz, daher kann bei AppTrovo jeder Autor auf der Bearbeitungsseite des Produkts eine kostenlose Entwickler-Testlizenz erzeugen. Sie lässt sich nur auf lokalen Domains wie localhost, 127.0.0.1 oder Hosts mit der Endung .test oder .local aktivieren, läuft nach 30 Tagen ab und kann verlängert werden. Neue Autoren, die noch kein Produkt haben, können eine Sandbox-Lizenz verwenden, um den Ablauf auszuprobieren. Spielen Sie diese Szenarien durch:
| Szenario | So lösen Sie es aus | Erwartetes Ergebnis |
|---|---|---|
| Gültiger Schlüssel, neue Domain | Neuinstallation auf localhost | Der Installer läuft weiter und speichert die Edition |
| Gültiger Schlüssel, erneut dieselbe Domain | Installer auf demselben Host erneut ausführen | Der Installer läuft weiter; keine zusätzliche Aktivierung belegt |
| Keine freien Plätze | Die maximale Anzahl lokaler Domains aktivieren, dann eine weitere | Klare Meldung, die erklärt, wie man eine Domain deaktiviert |
| Ungültiger Schlüssel | Eine zufällige UUID eingeben | Klare Fehlermeldung; der Installer bleibt beim Lizenzschritt |
| Abgelaufener Schlüssel | Einen abgelaufenen Testschlüssel verwenden | Klare Meldung „Lizenz ist abgelaufen“ |
| Netzwerkausfall | Den API-Host auf Ihrem Rechner blockieren | Freundliche Fehlermeldung mit Schaltfläche zum erneuten Versuch, keine leere Seite |
Entfernen Sie vor dem Packen alle Umgehungsschalter für die Entwicklung, die Sie beim Testen hinzugefügt haben, und stellen Sie sicher, dass die Basis-URL der API auf die Produktivumgebung zeigt.
Gestalten Sie den Lizenzschritt für Menschen
Der Lizenzbildschirm ist oft das Erste, was ein Käufer nach dem Hochladen Ihrer Dateien sieht. Ein paar Details machen ihn benutzerfreundlich:
- Sagen Sie Käufern, wo sie ihren Schlüssel finden (bei AppTrovo-Käufern im Bereich „Lizenzen“ ihres Dashboards).
- Akzeptieren Sie den Schlüssel mit oder ohne umgebende Leerzeichen, und entfernen Sie diese.
- Übersetzen Sie die Fehlergründe der API in nächste Schritte: „Für diesen Schlüssel sind keine Aktivierungsplätze mehr frei. Deaktivieren Sie in Ihrem Dashboard eine Domain, die Sie nicht mehr nutzen, und versuchen Sie es dann erneut.“
- Verlinken Sie Ihre Seite zur Fehlerbehebung bei Lizenzfehlern. Unser Ratgeber zu Dokumentation, die Support-Tickets reduziert, zeigt, wie Sie solche Einträge schreiben.
Häufig gestellte Fragen
Muss ich einen eigenen Lizenzserver bauen, um Code zu verkaufen?
Auf AppTrovo nicht. Jeder Verkauf erzeugt einen Lizenzschlüssel, Käufer verwalten Domain-Aktivierungen in ihrem Dashboard, und Sie prüfen Schlüssel über die Lizenzprüfungs-API. Ihre Aufgabe ist ein kleiner Lizenzschritt in Ihrem Installer. Wenn Sie zusätzlich auf Ihrer eigenen Website verkaufen, benötigen Sie für diese Verkäufe eine separate Lizenzierungslösung.
Kann ein Lizenzschlüssel Raubkopien von PHP-Skripten verhindern?
Keine Lizenzprüfung kann vollständig verhindern, dass jemand lesbaren Quellcode bearbeitet. Sie bestätigt jedoch Käufe, erfasst Installationen und verbindet Käufer mit Updates und Support. Auf die meisten Raubkopien antwortet man besser, indem man das bezahlte Produkt durch Updates, Support und kommerzielle Funktionen deutlich wertvoller macht.
Was passiert, wenn der Lizenzserver während der Installation nicht erreichbar ist?
Beim Muster der einmaligen Prüfung ist nur der Installer betroffen. Zeigen Sie eine freundliche Fehlermeldung mit einer Option zum erneuten Versuch an und behalten Sie die Eingaben des Käufers bei. Nach der Installation hängt die App nie mehr vom Lizenzserver ab, sodass ein späterer Ausfall sie nicht beeinträchtigen kann.
Wie überträgt ein Käufer seine Lizenz auf eine neue Domain?
Er deaktiviert die alte Domain in seinem Dashboard, wodurch der Aktivierungsplatz frei wird, und führt dann den Lizenzschritt auf der neuen Domain aus. Dokumentieren Sie das in Ihrer Installations- oder Migrationsanleitung, damit Käufer Sie nicht kontaktieren müssen.
Sollte die Community-Edition einen Lizenzschlüssel erfordern?
Auch Community-Lizenzen haben Schlüssel, und die Antwort der Prüfung meldet sie als community. Wenn Sie für beide Editionen denselben Installer-Ablauf verwenden, bleibt Ihr Code einfacher, und Sie können kommerzielle Funktionen freischalten, sobald ein Käufer später die Kommerzielle Lizenz erwirbt und den neuen Schlüssel eingibt.