DocumentationModèle de licence

Modèle de licence

Modèle de licence

Format JWS Ed25519 des licences MaelGard, vérification hors ligne par l'agent et le serveur, grace et offline days, révocation. Jamais de dépendance réseau pour vérifier un droit.

Une licence MaelGard est un jeton signé par l'éditeur, que l'agent et le serveur vérifient localement, sans réseau. Le service de licence éditeur n'émet et ne révoque. Son indisponibilité n'empêche jamais de démarrer ni de protéger.

Format du jeton

  • Enveloppe : JWS compact (RFC 7515).
  • Algorithme : EdDSA sur Ed25519.
  • En-tête : kid identifie la clé pour la rotation ; cty = maelgard-license.
  • Taille : quelques centaines d'octets à quelques kilo-octets.
  • Transport : fichier texte .lic, colonne text en base de données, en-tête HTTP.

Champs du payload

Payload JSON d'une licence MaelGard (spec section 3.1).
ChampTypeDescription
license_idUUIDIdentifiant unique, sert à la révocation.
schema_versionentierVersion du format de licence.
tenant_idchaîneClient destinataire, doit correspondre au tenant du serveur.
customer_namechaîneRaison sociale, pour affichage.
editionénumstandard ou advanced. Détermine les fonctions de base.
seatsentierNombre de postes autorisés.
seat_overageentierTolérance de dépassement avant effet.
modelstableauModèles payés : id et borne de version majeure.
channelstableauCanaux autorisés, si l'offre les restreint.
featurestableauOptions activées (SIEM, API publique, etc.).
not_beforedateDébut de validité (ISO 8601).
not_afterdateFin de validité.
grace_daysentierJours de grâce après not_after (défaut 30).
offline_daysentierJours sans rafraîchissement tolérés avant avertissement.
hard_stopbooléenAutorise un effet de blocage. false par défaut : seulement des alertes.
issued_atdateÉmission, pour anti-rejeu : la plus récente gagne.
issuerchaîneIdentifiant de la clé de signature utilisée.

Exemple de payload

{
  "license_id": "a3f1b2c4-5d6e-4f78-9a0b-1c2d3e4f5a6b",
  "schema_version": 1,
  "tenant_id": "banque-exemple",
  "customer_name": "Banque Exemple S.A.",
  "edition": "advanced",
  "seats": 1000,
  "seat_overage": 100,
  "models": [
    { "id": "pii", "max_major_version": 1 },
    { "id": "health", "max_major_version": 0 },
    { "id": "finance", "max_major_version": 2 }
  ],
  "channels": ["web", "desktop", "api", "code_assistant"],
  "features": ["siem_export", "public_api"],
  "not_before": "2026-10-01",
  "not_after":  "2027-09-30",
  "grace_days": 30,
  "offline_days": 60,
  "hard_stop": false,
  "issued_at": "2026-09-15T10:00:00Z",
  "issuer": "mgl-2026"
}

Vérification côté agent

L'agent et le serveur utilisent la même crate partagée maelgard-license, pour éviter toute divergence. La vérification se fait en six étapes.

  1. Vérifier la signature JWS avec la clé publique embarquée correspondant au kid.
  2. Vérifier que tenant_id correspond au tenant de la configuration locale.
  3. Vérifier not_before ≤ maintenant ≤ not_after + grace_days, avec protection d'horloge.
  4. Vérifier l'absence de la licence dans la liste de révocation en cache.
  5. Choisir, entre plusieurs licences présentes, celle au issued_at le plus récent.
  6. En déduire les droits effectifs (postes, modèles, canaux, options).
États d'une licence après vérification.
ÉtatSignification
validLicence effective, droits actifs.
expiredAu-delà de not_after + grace_days.
revokedInscrite dans la liste de révocation.
wrong_tenantTenant ne correspond pas.
bad_signatureSignature invalide ou clé inconnue.
unknown_versionVersion majeure non supportée.
absentAucune licence importée, mode d'évaluation.

Protection de l'horloge

Une vérification hors ligne dépend de l'heure locale, qu'un utilisateur peut reculer. La vérification se protège sans jamais exiger le réseau.

  • Repère monotone : le produit mémorise l'horodatage le plus récent observé d'une source fiable (ancre d'intégrité, battement serveur).
  • Maximum : l'heure retenue pour la vérification est le maximum entre horloge système et repère.
  • Détection : un recul au-delà d'un seuil est signalé comme manipulation, sans bloquer la protection.
  • Avancer sans effet : avancer l'horloge ne procure aucun avantage, l'expiration ne retire des fonctions que si hard_stop est vrai.

Grace et offline days

Deux fenêtres distinctes.
ParamètreRôleEffet
grace_daysJours après not_after où la licence reste pleinement effective.Avertissement visible, aucune fonction retirée. Défaut 30.
offline_daysJours sans rafraîchissement avant avertissement.Avertissement administrateur, aucune incidence sur la protection.

Révocation

  • L'éditeur produit une liste de révocation signée (JWS, cty = maelgard-license-revocations), horodatée, incrémentale.
  • La liste est distribuée aux clients par le serveur d'agrégation, et par fichier pour les sites isolés.
  • Un client hors ligne qui n'a jamais reçu de révocation continue d'honorer sa dernière licence valide, jusqu'à réception.
  • La révocation sert la fraude ou la résiliation, pas la gestion courante. Le levier normal reste l'échéance.

CLI administrateur

Côté agent et serveur, les opérations courantes passent par l'outil dlpia-admin sur le poste et par la console du serveur. Côté éditeur, l'outil maelgard-license émet, vérifie et révoque.

# État de licence sur un poste
dlpia-admin license status

# Import local (fichier poussé par GPO ou Intune)
dlpia-admin license import C:\ProgramData\DLPIA\licenses\banque.lic

# Purge du cache de licence (revient à l'évaluation ou à l'absence)
dlpia-admin license purge

# Vérification locale d'un fichier
maelgard-license verify banque.lic --public-key keys/mgl-2026.pub
Codes de sortie de dlpia-admin license import.
CodeSignification
0Licence importée avec succès.
1Fichier illisible ou syntaxe invalide.
2Signature invalide ou clé publique inconnue.
3Tenant incorrect pour ce poste.
4Licence expirée au-delà de la grâce.
5Licence révoquée.
6Version de schéma non supportée.
7Licence plus ancienne qu'une licence déjà présente.

Émission côté éditeur

L'émission signe le jeton avec la clé privée de licence conservée en HSM (OpenBao Transit). La clé ne quitte jamais le HSM.

maelgard-license issue \
  --tenant banque-exemple \
  --edition advanced \
  --seats 1000 \
  --seat-overage 100 \
  --models pii@1,health@0,finance@2 \
  --channels web,desktop,api,code_assistant \
  --features siem_export,public_api \
  --not-before 2026-10-01 \
  --not-after  2027-09-30 \
  --grace-days 30 \
  --offline-days 60 \
  --out banque-2026.lic
  • Chaque licence émise est enregistrée (identifiant, client, périmètre, dates) dans un registre pour le suivi et l'audit.
  • Le service valide la cohérence d'une commande avec le catalogue d'offres avant d'émettre.
  • La clé de signature est différente de celles de Authenticode, du catalogue et de la CA des postes. Sa compromission ne compromet qu'elle.

Rotation de la clé publique

L'agent et le serveur embarquent la clé courante et la précédente. Les deux sont acceptées pendant la transition. L'en-tête du jeton porte le kid de la clé utilisée.

# Rotation côté éditeur (OpenBao)
bao write -f transit/keys/maelgard-license/rotate

# Puis publier la nouvelle clé publique aux équipes agent et serveur
maelgard-license-service signer current-public-key \
  --token-file deploy/prod/secrets/keyadmin.token

Dépannage

Messages d'erreur courants à l'import.
MessageCause probableAction
« Licence pas authentique »Clé publique embarquée ne correspond pas au kid du jeton.Mettre à jour l'agent ou le serveur avec la nouvelle clé publique.
« Tenant invalide »Le tenant_id du jeton ne correspond pas à la configuration du poste.Vérifier la propriété MSI TENANT_ID ou le tenant du serveur.
« Licence expirée »Date dépassée au-delà de not_after + grace_days.Demander une nouvelle licence à l'éditeur.
« Licence révoquée »Le license_id est dans la liste de révocation en cache.Contacter le support éditeur.
« Version de schéma non supportée »Le jeton utilise une schema_version plus récente que le binaire.Mettre à jour l'agent ou le serveur.
« Licence plus ancienne »Le issued_at est antérieur à la licence déjà en cache.Importer la licence la plus récente.
« Horloge en avance »Le repère monotone est supérieur à l'horloge système.Resynchroniser l'horloge et attendre la prochaine vérification.

Mode d'évaluation

Avant tout import, le produit fonctionne en évaluation : édition de base, 10 postes, modèles gratuits, 30 jours, affiché clairement. La fin de l'évaluation suit la même règle que l'expiration : jamais d'exposition, retrait des fonctions payantes et alertes.