Sur cette page
Licences avec vos propres clés (BYOK)
Le BYOK vous permet de garder la garde de votre propre clé de signature dans Patrii Cloud et d'émettre pour votre produit des licences inviolables et vérifiables hors ligne. La clé privée est créée dans le service sécurisé de secrets et ne quitte jamais la garde.
Vous créez un émetteur, qui détient une paire de clés de signature dans le coffre sécurisé de secrets de votre projet. La plateforme signe les licences en votre nom avec la moitié privée, de sorte que votre matériel de clé ne quitte jamais la garde et n'est jamais exposé à votre produit ni à vos clients.
La moitié publique vous appartient : publiez-la. Vous l'épinglez dans le vérificateur de votre produit afin qu'il valide une licence entièrement hors ligne, sans appel au serveur. Comme les signatures sont vérifiées avec une clé que vous contrôlez, une licence ne peut être ni falsifiée ni altérée en silence.
Concepts clés
Émetteur — Une identité de signature nommée, adossée à une paire de clés détenue dans votre coffre de secrets.
Clé publique — La moitié vérifiable de la clé de l'émetteur; épinglez-la dans votre vérificateur pour contrôler les licences.
Clé de licence — La chaîne de licence signée et encodée que vous livrez à un client. Elle est affichée une seule fois à l'émission.
Plan / fonctionnalités — Le code de plan, la liste de fonctionnalités, la limite de sièges et l'expiration que la signature atteste.
Vérification hors ligne — La validation d'une licence avec la clé publique épinglée, sans aucun appel réseau.
Avant de commencer
- Un projet ayant accès au service sécurisé de secrets.
- Un code de plan et les droits que chaque licence doit accorder.
- Un endroit où épingler la clé publique de l'émetteur dans votre produit.
Étape par étape
- Ouvrez les licences BYOK
Allez dans Sécurité > Secrets et choisissez Licences BYOK en haut du coffre. Les licences se gèrent dans la console ou par l'API; la CLI Patrii n'a pas de commandes de licence.
Capture d'écran — L'en-tête de la page Licences BYOKL'en-tête de la page Licences BYOK - Créez un émetteur
Donnez un nom à l'émetteur (habituellement le nom de votre produit). La paire de clés de signature est créée et conservée dans votre coffre de secrets; la clé privée ne sort jamais.
Capture d'écran — Le formulaire Créer un émetteurLe formulaire Créer un émetteur - Copiez la clé publique à épingler
Copiez la clé publique de l'émetteur et intégrez-la au vérificateur de votre produit pour qu'il valide les licences hors ligne.
Capture d'écran — Le panneau d'information montrant la clé publique à épingler dans votre vérificateurLe panneau d'information montrant la clé publique à épingler dans votre vérificateur - Émettez une licence
- Renseignez le code de plan, les codes de fonctionnalités facultatifs, le nombre de sièges, la date d'expiration et le nom du client.
- Soumettez pour générer une licence signée. La clé de licence est affichée une seule fois : copiez-la et livrez-la au client.
Capture d'écran — Le formulaire Émettre une licence avec l'alerte de clé de licence à usage uniqueLe formulaire Émettre une licence avec l'alerte de clé de licence à usage unique - Testez la vérification
Collez une clé de licence dans la carte de validation pour confirmer qu'elle se vérifie et rapporte le plan et l'émetteur attendus avant de la livrer.
Capture d'écran — La carte de validation montrant un résultat ValideLa carte de validation montrant un résultat Valide
Exemples
curl -X POST -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
https://api.patrii.cloud/licensing/issuers/<issuer-id>/licenses \
-d '{"plan_code": "pro", "features": ["reports", "api"],
"user_limit": 25, "expiry_date": "2027-01-01",
"customer_name": "Example Inc."}'
# La license_key de la réponse n'est affichée qu'une fois : conservez-la.curl https://api.patrii.cloud/licensing/issuers/<issuer-id>/pubkey # Intégrez la valeur public_pem au vérificateur de votre produit.
Limites et caractéristiques
Ce qu'une licence atteste :
| Champ | Signification |
|---|---|
plan_code | Le plan ou palier que la licence accorde. |
features | Codes de fonctionnalités facultatifs activés par cette licence. |
user_limit | Nombre de sièges; utilisez -1 pour illimité. |
expiry_date | La date après laquelle la licence n'est plus valide. |
customer_name | Le client à qui la licence a été émise. |
Bonnes pratiques
- Utilisez un émetteur par produit pour pouvoir faire pivoter ou révoquer la confiance de façon indépendante.
- Épinglez la clé publique dans votre vérificateur et validez hors ligne; ne faites jamais confiance à une licence non vérifiée.
- Fixez une expiration sur chaque licence et réémettez plutôt que de prolonger de façon informelle.
- Copiez la clé de licence au moment de l'émission; elle est affichée une seule fois et ne peut être récupérée ensuite.
- Gardez stables le nom de l'émetteur et les codes de plan pour que les vérificateurs et les rapports restent cohérents.
Questions fréquentes
Où est stockée ma clé privée ?
Mes clients doivent-ils être en ligne pour utiliser une licence ?
J'ai perdu une clé de licence. Puis-je la récupérer ?
Pour aller plus loin
Tout ce que vous faites ici dans la console est aussi disponible via l'API Patrii Cloud pour l'automatisation et les scripts.