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 :
EdDSAsurEd25519. - En-tête :
kididentifie la clé pour la rotation ;cty = maelgard-license. - Taille : quelques centaines d'octets à quelques kilo-octets.
- Transport : fichier texte
.lic, colonnetexten base de données, en-tête HTTP.
Champs du payload
| Champ | Type | Description |
|---|---|---|
license_id | UUID | Identifiant unique, sert à la révocation. |
schema_version | entier | Version du format de licence. |
tenant_id | chaîne | Client destinataire, doit correspondre au tenant du serveur. |
customer_name | chaîne | Raison sociale, pour affichage. |
edition | énum | standard ou advanced. Détermine les fonctions de base. |
seats | entier | Nombre de postes autorisés. |
seat_overage | entier | Tolérance de dépassement avant effet. |
models | tableau | Modèles payés : id et borne de version majeure. |
channels | tableau | Canaux autorisés, si l'offre les restreint. |
features | tableau | Options activées (SIEM, API publique, etc.). |
not_before | date | Début de validité (ISO 8601). |
not_after | date | Fin de validité. |
grace_days | entier | Jours de grâce après not_after (défaut 30). |
offline_days | entier | Jours sans rafraîchissement tolérés avant avertissement. |
hard_stop | booléen | Autorise un effet de blocage. false par défaut : seulement des alertes. |
issued_at | date | Émission, pour anti-rejeu : la plus récente gagne. |
issuer | chaîne | Identifiant 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.
- Vérifier la signature JWS avec la clé publique embarquée correspondant au
kid. - Vérifier que
tenant_idcorrespond au tenant de la configuration locale. - Vérifier
not_before≤ maintenant ≤not_after + grace_days, avec protection d'horloge. - Vérifier l'absence de la licence dans la liste de révocation en cache.
- Choisir, entre plusieurs licences présentes, celle au
issued_atle plus récent. - En déduire les droits effectifs (postes, modèles, canaux, options).
| État | Signification |
|---|---|
valid | Licence effective, droits actifs. |
expired | Au-delà de not_after + grace_days. |
revoked | Inscrite dans la liste de révocation. |
wrong_tenant | Tenant ne correspond pas. |
bad_signature | Signature invalide ou clé inconnue. |
unknown_version | Version majeure non supportée. |
absent | Aucune 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_stopest vrai.
Grace et offline days
| Paramètre | Rôle | Effet |
|---|---|---|
grace_days | Jours après not_after où la licence reste pleinement effective. | Avertissement visible, aucune fonction retirée. Défaut 30. |
offline_days | Jours 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| Code | Signification |
|---|---|
| 0 | Licence importée avec succès. |
| 1 | Fichier illisible ou syntaxe invalide. |
| 2 | Signature invalide ou clé publique inconnue. |
| 3 | Tenant incorrect pour ce poste. |
| 4 | Licence expirée au-delà de la grâce. |
| 5 | Licence révoquée. |
| 6 | Version de schéma non supportée. |
| 7 | Licence 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.tokenDépannage
| Message | Cause probable | Action |
|---|---|---|
| « 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.