Console de Licences

La section Licences de la Console d’Administration te permet de créer des politiques, d’émettre et gérer des clés, de configurer l’automatisation et de surveiller l’utilisation — le tout sans écrire de code.

Accèdes-y depuis la barre latérale : Licensing → Policies | Keys | Usage | Automation.

Politiques

Les politiques définissent les règles d’une licence : quelles fonctionnalités sont incluses, combien de sièges/appareils sont autorisés, quand elle expire et comment la validation fonctionne.

Créer une politique

1. Va dans Licensing → Policies et clique sur New Policy
2. Étape 1 — Entre un nom (ex. “Pro Plan”) et un slug (ex. pro-plan)
3. Étape 2 — Configure les dimensions :
   • Key Format — Personnalise le préfixe, le jeu de caractères, le nombre/longueur de segments et le séparateur. Un aperçu en direct montre le format généré (ex. VIG-XXXX-XXXX-XXXX-XXXX)
   • Seats — Active pour limiter les utilisateurs simultanés. Définis un maximum par défaut
   • Devices — Active pour limiter les appareils activés. Définis un maximum par défaut
   • Features — Active pour définir un ensemble de drapeaux de fonctionnalités (ex. analytics, export, api-access)
   • Expiry — Active pour définir une expiration par défaut en jours
4. Étape 3 — Choisis le mode de validation :
   • Online — Chaque validation interroge l’API (idéal pour le SaaS)
   • Hybrid — En ligne d’abord, fallback JWT hors connexion (idéal pour les applications de bureau)
   • Offline — JWT uniquement, pas de réseau nécessaire (idéal pour les environnements isolés)

Modifier une politique

Depuis la liste des politiques, clique sur le menu ⋮ → Edit. Tu peux modifier le nom, le mode de validation, les dimensions, la période de grâce hors connexion et le TTL de révocation.

Afficher les détails d’une politique

Clique sur ⋮ → View pour voir la page de détail complète, incluant :

• Statut, mode de validation et résumé des dimensions
• Configuration de la politique (grâce hors connexion, TTL de révocation, sièges/appareils/expiration par défaut)
• Aperçu du format de clé
• Toutes les clés émises sous cette politique

Clés

Émettre une clé

1. Va dans Licensing → Keys et clique sur Issue Key
2. Sélectionne une politique
3. Choisis le type de titulaire (USER, ORG, DEVICE)
4. Entre éventuellement un ID de titulaire et des notes
5. Clique sur Issue Key

La clé est générée en utilisant le format défini dans la politique (ex. VIG-A8BC-D3EF-G4HJ-K5LM).

Fonctionnalités de la liste des clés

• Recherche — Filtrer par chaîne de clé ou ID de titulaire
• Filtre de statut — Afficher uniquement les clés actives, suspendues, expirées ou révoquées
• Alertes d’expiration — Les clés expirant dans les 7 jours affichent un badge orange “Expiring soon”
• Export CSV — Télécharger la liste complète des clés en CSV
• Pagination — Naviguer dans les grands ensembles de clés

Actions sur les clés

Depuis le menu ⋮ de chaque clé :

Page de détail d’une clé

Clique sur View pour voir la page de détail complète avec trois onglets :

• Entitlements — Informations du titulaire, fonctionnalités, expiration, sièges, politique, date de création
• Seats — Voir les utilisateurs assignés, assigner de nouveaux sièges, libérer des sièges
• Devices — Voir les appareils activés, supprimer des appareils

Testeur de validation

Clique sur Validate Key sur la page des clés pour ouvrir le testeur de validation. Colle n’importe quelle clé pour la tester via l’API — vérifie si elle est valide et consulte ses fonctionnalités, son statut et son expiration.

Utilisation

La page Licensing → Usage affiche les statistiques agrégées :

• Cartes KPI : Total des politiques, total des clés, actives, révoquées, suspendues, expirées
• Répartition par politique : Combien de clés sont émises par politique
• Clés récentes : Les dernières clés émises avec badges de statut

Automatisation

Les règles d’automatisation connectent les événements de paiement aux actions de licence. Quand un client paie, une clé est automatiquement émise.

Créer une règle

1. Va dans Licensing → Automation et clique sur New Rule
2. Entre un nom de règle
3. Choisis le fournisseur (Stripe, PayPal ou Manual)
4. Sélectionne l’événement déclencheur (ex. Checkout Completed)
5. Sélectionne l’action (ex. Issue Key)
6. Lie éventuellement une politique (obligatoire pour l’action Issue Key)

Fournisseurs et événements supportés

Configuration des webhooks

Pour que l’automatisation fonctionne, tu dois configurer les webhooks dans ton fournisseur de paiement :

Stripe :

1. Va dans le tableau de bord Stripe → Developers → Webhooks
2. Ajoute l’endpoint : https://your-auris-domain/api/licensing/webhooks/stripe
3. Sélectionne les événements : checkout.session.completed, invoice.paid
4. Copie le secret de signature dans STRIPE_LICENSING_WEBHOOK_SECRET

PayPal :

1. Va dans le tableau de bord développeur PayPal → Webhooks
2. Ajoute l’endpoint : https://your-auris-domain/api/licensing/webhooks/paypal
3. Configure PAYPAL_LICENSING_WEBHOOK_SECRET et PAYPAL_LICENSING_WEBHOOK_ID