Documentation 3DIS License Platform

Prérequis et installation

1. Téléversez le ZIP officiel depuis Extensions et activez 3DIS License Platform.
2. Vérifiez la présence des menus Produits, Formules, Versions, E-mails et Licences.
3. Contrôlez la création des tables et la page de santé ou les diagnostics disponibles.
4. Configurez la signature et l’e-mail avant toute émission réelle.
5. Créez un produit et un plan de test avant d’intégrer un client commercial.

Créer un produit

Ouvrez 3DIS DEV puis Produits. Le code immuable identifie le produit dans les licences, l’API et les mises à jour. Choisissez un identifiant court, en minuscules et stable, par exemple mon-plugin. Ne le remplacez pas après la diffusion des clients. Le nom commercial peut évoluer sans modifier le contrat technique.

Renseignez le slug WordPress lorsque le produit est un plugin, sa description, son statut, le préfixe des clés, la durée d’essai, la politique d’activation, le type de paquet, le canal par défaut et les URL de documentation, d’assistance, de vente et de téléchargement. Une fiche complète permet aux clients de licence de recevoir les bonnes informations sans conditions spécifiques dans le code.

Choisir la politique d’activation

La politique « Site WordPress » utilise le site ou le réseau selon la configuration multisite. Elle convient aux plugins. La politique « Sujet opaque + installation » permet à un logiciel ou à une intégration de transmettre un identifiant de contexte et un identifiant d’installation sans imposer la notion de domaine. Le Générateur XML peut ainsi associer l’activation à un poste et à un SIRET selon son contrat client.

Le serveur ne doit pas interpréter chaque métier dans son cœur. Il valide la requête normalisée, applique la politique sélectionnée et enregistre l’activation. Les données propres au produit restent documentées par le client et le plan.

Créer une formule

Ouvrez Formules et choisissez le produit. Le code de formule est lui aussi stable : solo, business, unlimited ou trial. Renseignez le nom public, le type payant ou essai, la durée, la limite d’activation, les droits de mise à jour, le canal et la période de grâce.

Associer la vente au produit de licence

Le profil 3DIS PAYMENT active l’émission de licence, indique l’endpoint du serveur, le code produit et la classe du champ qui contient le plan. Après confirmation du paiement, il transmet l’acheteur, le produit, la formule et la quantité. Ces valeurs doivent correspondre aux codes présents dans License Platform.

Un produit public ne doit pas utiliser un profil de recette. Créez un profil `ACHAT` dédié et testez d’abord son équivalent de recette. Si plusieurs quantités sont vendues, définissez clairement si la quantité multiplie le nombre de licences ou les activations d’une seule licence. Le comportement doit être identique dans le formulaire, le paiement et la plateforme.

Créer un pack à licence unique

1. Créez chacun des composants comme produit simple.
2. Créez le produit de pack avec son propre code immuable.
3. Dans Produits inclus, sélectionnez les composants couverts par la clé du pack.
4. Créez les plans du pack avec leurs limites d’activation.
5. Créez la fiche commerciale, le formulaire et le profil de paiement utilisant le code du pack.
6. Testez la même clé sur chaque composant inclus et vérifiez qu’elle est refusée par un produit non inclus.

Émettre et gérer une licence

Une licence peut être émise automatiquement après paiement ou manuellement par un administrateur. Vérifiez le client, son e-mail, le produit, le plan, la quantité, la date d’expiration et le statut. L’émission automatique doit utiliser une clé d’idempotence liée à la transaction afin qu’un webhook répété ne crée pas plusieurs licences.

Depuis Licences, vous pouvez consulter les activations et l’historique. Une suspension bloque temporairement les nouveaux contrôles ou activations selon la politique. Une révocation invalide définitivement la clé. L’expiration est calculée à partir du plan. La désactivation d’un site ou poste libère une activation sans supprimer l’historique.

Essai de 15 jours

Créez un plan de type essai avec une durée de 15 jours et une activation. Le service d’essai doit limiter les demandes répétées selon l’identité prévue par la politique. Une licence d’essai donne accès au canal configuré et doit être identifiable dans l’administration. À l’achat, le client reçoit le plan payant correspondant sans perdre inutilement ses réglages locaux.

Configurer les e-mails

Le modèle global peut être complété par un modèle produit. Utilisez les variables documentées pour le nom, le produit, la formule, la date, la clé, le téléchargement et l’assistance. L’expéditeur doit appartenir au domaine et exister réellement. Ne placez pas l’adresse de l’acheteur dans le champ De ; utilisez-la comme destinataire et, si nécessaire, comme Reply-To dans un message administratif.

Le bouton « Renvoyer la licence » réutilise la licence existante. Il doit enregistrer la tentative et son résultat. Un état « envoyé » confirme l’acceptation par le système de messagerie, pas la remise en boîte de réception. Consultez les journaux SMTP et les réponses du fournisseur pour diagnostiquer un message absent.

Ajouter et publier une version

1. Ouvrez Versions et choisissez le produit.
2. Saisissez un numéro sémantique cohérent avec le manifeste du plugin ou du logiciel.
3. Choisissez le canal stable, bêta ou développement.
4. Téléversez le type de paquet attendu par la fiche produit : ZIP, MSI, EXE ou autre format pris en charge.
5. Ajoutez des notes de version compréhensibles et cochez « critique » uniquement si nécessaire.
6. Créez le brouillon, vérifiez l’empreinte SHA-256 puis publiez la version.

Une version retirée n’est plus proposée comme mise à jour ordinaire. Une version bloquée doit être refusée lorsqu’elle présente un risque. Ne publiez pas un simple dossier de sources comme installateur commercial : l’artefact doit être construit, testable et compatible avec le type déclaré.

Intégrer un client WordPress

Le client contient le code produit, l’URL de la plateforme et la clé publique ou l’empreinte de confiance requise. Il expose une page de saisie de licence, active le domaine, conserve un état local limité et renouvelle périodiquement le contrôle. Le vérificateur de mise à jour interroge le canal autorisé et affiche la nouvelle version dans WordPress.

Le téléchargement s’effectue avec une autorisation temporaire vérifiée par le serveur. Le client contrôle ensuite l’intégrité attendue. Une panne temporaire du serveur ne doit pas détruire immédiatement les réglages ou les données ; la politique de cache et de grâce doit être documentée.

Intégrer un logiciel Windows

Le logiciel utilise la politique opaque + installation ou une politique compatible. Il transmet le code produit, le plan et les identifiants normalisés prévus. La clé privée du serveur n’est jamais incluse dans l’application. Le client vérifie les réponses signées à l’aide de la clé publique.

Pour une mise à jour Windows, publiez l’installateur correspondant au type configuré. Le logiciel recherche la version stable, compare les numéros, vérifie les droits de la licence et télécharge l’artefact. L’installation du fichier reste soumise aux contrôles de sécurité du système.

API, sécurité et diagnostic

Les routes d’activation, contrôle, désactivation, essai, émission et mise à jour valident les paramètres, l’horodatage, la signature et la fréquence des requêtes. Les messages d’erreur distinguent une donnée invalide, une licence expirée, une limite atteinte et un incident temporaire. Ne désactivez pas les contrôles pour contourner une erreur : consultez l’audit et le contexte normalisé.

Protégez les sauvegardes, clés de signature, secrets d’émission et artefacts privés. Limitez les rôles WordPress pouvant gérer les licences. Après une mise à jour, exécutez le contrôle de santé, une activation de test, une désactivation et une recherche de version.

FAQ