Un système de clés de licence logicielle pour du code source remplit trois fonctions : il prouve qu’un acheteur a acquis le produit, il enregistre l’endroit où le produit est installé, et il permet à votre code d’adapter son comportement à l’édition que possède l’acheteur. Il ne rend pas impossible la copie d’un code source lisible, et vouloir lui faire jouer ce rôle pénalise généralement davantage les acheteurs honnêtes que les pirates. L’approche qui fonctionne le mieux pour la plupart des vendeurs est simple : demander la clé une seule fois dans l’installateur, la vérifier côté serveur auprès d’une API de licence, la lier au domaine de l’installation, puis ne plus intervenir.
Ce guide explique comment cela fonctionne et comment l’ajouter à votre produit. Il fait partie de notre guide plus large sur la vente du code source de votre application web ou SaaS. Sur AppTrovo, chaque vente génère automatiquement une clé de licence, avec activation par domaine et une API de vérification de licence : vous n’avez donc pas à construire vous-même le serveur de licences, seulement la petite vérification côté client dans votre installateur.
Si vous voulez uniquement la référence de l’API, rendez-vous directement au guide d’intégration des licences. Poursuivez la lecture pour le raisonnement, les compromis et un plan de test.
Que peut réellement protéger une clé de licence ?
Lorsque vous vendez du code source lisible, une personne déterminée peut toujours supprimer une vérification de licence. Le reconnaître honnêtement vous aide à concevoir quelque chose d’utile plutôt que quelque chose d’agaçant.
| Un système de clés de licence peut | Un système de clés de licence ne peut pas |
|---|---|
| Confirmer qu’un acheteur dispose d’un achat valide avant l’installation | Empêcher quelqu’un de supprimer la vérification dans un code lisible |
| Enregistrer les domaines sur lesquels une licence est activée | Empêcher un acheteur de partager un fichier ZIP |
| Indiquer à votre code quelle édition possède l’acheteur | Remplacer un contrat de licence clair |
| Montrer si le support et les mises à jour sont actifs | Garantir le paiement dans tous les cas |
| Vous fournir un historique propre pour gérer le support ou les litiges | Compenser un produit auquel les acheteurs ne font pas confiance |
Voyez la clé de licence comme un reçu portant une adresse, pas comme un cadenas. La plupart des acheteurs de logiciels professionnels sont honnêtes et veulent rester en conformité avec la licence, surtout lorsque les mises à jour et le support en dépendent. La clé rend le chemin honnête le plus facile.
Faut-il obfusquer ou encoder votre code ?
Certains vendeurs tentent de protéger leurs scripts PHP en les encodant ou en les obfusquant. Pour une place de marché de code source, c’est généralement une erreur :
- Les acheteurs paient pour le code source. S’ils choisissent une application auto-hébergée, c’est pour pouvoir la lire, l’auditer et la modifier. Des fichiers encodés suppriment cette valeur.
- Les encodeurs ajoutent des exigences d’hébergement, comme des chargeurs spécifiques, qui provoquent des échecs d’installation et des tickets.
- L’obfuscation vous cache aussi les bugs, et rend impossible tout audit de sécurité par l’acheteur.
- Elle arrête rarement le piratage. Des copies piratées de produits encodés circulent de toute façon.
Consacrez plutôt vos efforts à ce qui rend le paiement intéressant : mises à jour, support, documentation et fonctionnalités de l’édition Commerciale. C’est précisément ce qu’une copie piratée n’obtient jamais.
Comment fonctionne l’activation par domaine
L’activation par domaine lie une clé de licence aux endroits où le produit est installé. Sur AppTrovo, le processus se déroule ainsi :
- L’acheteur achète le produit et reçoit une clé de licence unique (un UUID).
- Pendant l’installation, votre installateur envoie depuis le serveur la clé et le domaine de l’installation à l’API de vérification de licence.
- Si la clé est valide et qu’un emplacement d’activation est libre, le domaine est enregistré sur la licence et la réponse le confirme.
- Relancer l’installateur sur le même domaine ne consomme pas d’emplacement supplémentaire.
- Si l’acheteur passe à un nouveau serveur ou domaine, il désactive l’ancien domaine depuis son tableau de bord et active le nouveau. Voir la gestion des activations de domaine.
Chaque licence dispose d’un nombre limité d’emplacements d’activation, et la réponse de vérification vous indique combien sont utilisés (activations_used) et disponibles (activations_limit). Cette limite permet à un acheteur de faire tourner un site de production et une copie de préproduction sans vous solliciter, tout en décourageant les installations sur des dizaines de domaines sans lien entre eux. Ce que la licence autorise juridiquement est défini par les conditions de licence, et non par le nombre d’emplacements.
Vérifier une seule fois ou contacter le serveur en permanence ?
Il existe trois stratégies courantes pour déterminer quand votre code vérifie la licence. Ce choix compte plus que toute autre décision de licence, car il détermine si la gestion des licences peut faire tomber le site de production d’un acheteur.
| Stratégie | Fonctionnement | Risque pour les acheteurs | Recommandation |
|---|---|---|---|
| Vérification unique à l’installation | L’installateur vérifie la clé ; l’application fonctionne ensuite normalement | Très faible ; un problème réseau n’affecte que l’installateur | Choix par défaut recommandé |
| Revérification périodique | Une tâche planifiée vérifie la clé chaque jour ou chaque semaine | Moyen ; pannes, pare-feu ou limites de débit peuvent déclencher de faux échecs | À éviter sauf raison sérieuse |
| Vérification à chaque requête | Chaque chargement de page interroge le serveur de licences | Élevé ; ralentit chaque page et fait de votre serveur un point de défaillance unique | À proscrire |
Le guide d’intégration d’AppTrovo recommande la vérification unique : une fois l’installateur terminé avec succès, le produit écrit un marqueur « installé » et n’appelle plus jamais l’API. L’application de production d’un acheteur ne devrait jamais cesser de fonctionner parce qu’un serveur de licences était injoignable lors d’un incident réseau.
Comment ajouter une vérification de licence à votre installateur
L’API de vérification se résume à une seule requête GET vers /api/v1/licenses/verify avec la license_key et, en option, votre product_slug et le domain de l’installation. L’envoi du slug du produit est recommandé, car il garantit que la clé appartient bien à votre produit et non à un autre. Voici le déroulement de l’installateur, étape par étape :
- Demandez la clé. Ajoutez à votre installateur web une étape de licence avec un seul champ. L’acheteur ne devrait pas avoir à saisir un nom de produit ni à modifier des fichiers de configuration ; définissez le slug de votre produit dans votre propre configuration avant d’empaqueter le ZIP.
- Vérifiez côté serveur. Appelez l’API depuis votre backend avec un délai d’expiration court et la vérification SSL activée. Ne vérifiez jamais depuis du JavaScript dans le navigateur, et ne placez jamais de secrets dans du code côté client.
- Envoyez le domaine. Transmettez l’hôte de l’installation pour que l’activation soit enregistrée à son nom.
- Traitez la réponse. Si
validvaut true, stockez localement ce dont vous avez besoin : l’édition indiquée parlicense_type, le nom du titulaire de la licence et les dates de support si votre espace d’administration les affiche. Si la valeur est false, affichez lafailure_reasonen langage clair et laissez l’acheteur réessayer. - Marquez l’installation comme terminée. Écrivez le marqueur d’installation et poursuivez avec les étapes de base de données et d’utilisateur administrateur. La fonction PHP version_compare() vous sera aussi utile plus tard si votre espace d’administration compare la version installée à la dernière version publiée. À partir de là, plus aucun code de licence ne s’exécute.
Pour les produits Laravel, il existe un SDK d’installateur prêt à l’emploi, avec un contrôleur d’installation tout fait et un petit middleware qui vérifie uniquement la présence du marqueur d’installation. La liste complète des paramètres, des champs de réponse et des motifs d’échec figure dans l’article sur l’API de vérification de licence et dans le guide d’intégration. L’API est soumise à une limite de débit (120 requêtes par minute et par IP au moment de la rédaction), ce qui est une raison de plus de ne pas vérifier à chaque requête.
Stockez le résultat en toute sécurité
Traitez la clé de licence comme n’importe quel autre identifiant sensible : gardez-la hors des répertoires publics, hors des journaux et hors du frontend. L’OWASP Secrets Management Cheat Sheet fournit des recommandations générales sur la gestion des clés et des jetons dans les applications.
Limitez les fonctionnalités selon l’édition, pas selon le domaine
Les produits AppTrovo existent en exactement deux éditions : une édition Community gratuite aux fonctionnalités limitées (les acheteurs peuvent l’utiliser en production, sans support de l’auteur) et une Licence Commerciale payante qui débloque l’ensemble des fonctionnalités. Il n’existe pas de troisième niveau. La réponse de vérification vous indique laquelle possède l’acheteur dans license_type (community ou commercial, plus developer pour vos propres clés de test).
- Basez vos restrictions sur
license_type, et non sur le slug de l’objet édition. Le slug interne de l’édition Commerciale est un identifiant permanent qui ne contient pas « commercial » ;license_typeest donc le champ prévu pour cet usage. - Enregistrez l’édition pendant l’installation dans votre table de paramètres et lisez-la localement à l’exécution.
- Définissez clairement ce que comprend chaque édition et indiquez-le sur la fiche produit. Des limites cachées qui apparaissent après l’installation ressemblent à un piège.
La réponse inclut aussi product.retired. Si vous retirez un jour un produit, les licences existantes continuent d’être validées, et votre espace d’administration peut afficher un avis discret indiquant qu’aucune autre mise à jour n’est prévue.
Gérez le développement, la préproduction et les changements de serveur
Une gestion des licences qui ignore les usages réels génère des tickets. Prévoyez ces cas :
- Développement local. Les acheteurs installent d’abord sur
localhostou sur un domaine.test. Décidez si votre installateur compte cela comme une activation ; beaucoup de vendeurs omettent le domaine pour les hôtes locaux. - Copies de préproduction. Les emplacements d’activation existent pour qu’un site de préproduction ne nécessite pas une seconde licence. Mentionnez-le dans votre documentation.
- Migrations de serveur. Documentez les étapes : désactiver l’ancien domaine dans le tableau de bord, déplacer les fichiers, relancer l’étape de licence ou l’installateur sur le nouveau domaine.
- Agences installant pour leurs clients. Expliquez quel domaine doit être activé et qui doit détenir la clé. Renvoyez aux conditions de licence pour l’utilisation au profit de clients.
Testez votre intégration avant de soumettre
Vous ne possédez pas de licence payante pour votre propre produit ; AppTrovo permet donc à chaque auteur de générer une licence de test développeur gratuite depuis la page d’édition du produit. Elle ne s’active que sur des domaines locaux comme localhost, 127.0.0.1 ou des hôtes se terminant par .test ou .local, expire au bout de 30 jours et peut être prolongée. Les nouveaux auteurs qui n’ont pas encore de produit peuvent utiliser une licence sandbox pour essayer le processus. Testez ces scénarios :
| Scénario | Comment le déclencher | Résultat attendu |
|---|---|---|
| Clé valide, nouveau domaine | Installation neuve sur localhost | L’installateur continue et enregistre l’édition |
| Clé valide, même domaine à nouveau | Relancer l’installateur sur le même hôte | L’installateur continue ; aucune activation supplémentaire consommée |
| Aucun emplacement libre | Activer le nombre maximal de domaines locaux, puis un de plus | Message clair expliquant comment désactiver un domaine |
| Clé invalide | Saisir un UUID aléatoire | Erreur claire ; l’installateur reste sur l’étape de licence |
| Clé expirée | Utiliser une clé de test expirée | Message clair « la licence a expiré » |
| Panne réseau | Bloquer l’hôte de l’API sur votre machine | Erreur conviviale avec un bouton pour réessayer, pas une page blanche |
Avant l’empaquetage, supprimez tous les indicateurs de contournement ajoutés pendant les tests, et vérifiez que l’URL de base de l’API pointe vers la production.
Rédigez l’étape de licence pour des humains
L’écran de licence est souvent la première chose qu’un acheteur voit après avoir téléversé vos fichiers. Quelques détails le rendent convivial :
- Indiquez aux acheteurs où trouver leur clé (pour les acheteurs AppTrovo, dans la section Licences de leur tableau de bord).
- Acceptez la clé avec ou sans espaces autour, et supprimez-les.
- Traduisez les motifs d’échec de l’API en actions concrètes : « Cette clé n’a plus d’emplacement d’activation libre. Désactivez dans votre tableau de bord un domaine que vous n’utilisez plus, puis réessayez. »
- Ajoutez un lien vers votre page de dépannage des erreurs de licence. Notre guide sur une documentation qui réduit les tickets de support montre comment rédiger ces entrées.
Questions fréquentes
Dois-je construire mon propre serveur de licences pour vendre du code ?
Pas sur AppTrovo. Chaque vente génère une clé de licence, les acheteurs gèrent leurs activations de domaine depuis leur tableau de bord, et vous vérifiez les clés via l’API de vérification de licence. Votre travail se limite à une petite étape de licence dans votre installateur. Si vous vendez aussi sur votre propre site, il vous faudra une solution de licences distincte pour ces ventes.
Une clé de licence peut-elle empêcher le piratage de scripts PHP ?
Aucune vérification de licence ne peut totalement empêcher quelqu’un de modifier un code source lisible. Elle permet en revanche de confirmer les achats, d’enregistrer les installations et de relier les acheteurs aux mises à jour et au support. La meilleure réponse au piratage consiste le plus souvent à rendre le produit payant nettement plus intéressant, grâce aux mises à jour, au support et aux fonctionnalités Commerciales.
Que se passe-t-il si le serveur de licences est indisponible pendant l’installation ?
Avec le modèle de vérification unique, seul l’installateur est concerné. Affichez une erreur conviviale avec une option pour réessayer et conservez les informations saisies par l’acheteur. Une fois l’installation faite, l’application ne dépend plus jamais du serveur de licences ; une panne ultérieure ne peut donc pas l’affecter.
Comment un acheteur transfère-t-il sa licence vers un nouveau domaine ?
Il désactive l’ancien domaine depuis son tableau de bord, ce qui libère l’emplacement d’activation, puis exécute l’étape de licence sur le nouveau domaine. Documentez-le dans votre guide d’installation ou de migration pour que les acheteurs n’aient pas besoin de vous contacter.
L’édition Community doit-elle exiger une clé de licence ?
Les licences Community ont elles aussi des clés, et la réponse de vérification les signale comme community. Utiliser le même processus d’installation pour les deux éditions simplifie votre code et vous permet d’activer les fonctionnalités Commerciales lorsqu’un acheteur achète ensuite la Licence Commerciale et saisit la nouvelle clé.