Se rendre au contenu
Open Beta — managed Kubernetes, DNS & more are live.
🗝️

Licences avec vos propres clés (BYOK)

Updated 2026-11-20
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.

Capture d'écran — La page Licences BYOK avec la clé publique de l'émetteur à épingler et le tableau des licences émises
La page Licences BYOK avec la clé publique de l'émetteur à épingler et le tableau des licences émises

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

  1. 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 BYOK
    L'en-tête de la page Licences BYOK
  2. 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 émetteur
    Le formulaire Créer un émetteur
  3. 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érificateur
    Le panneau d'information montrant la clé publique à épingler dans votre vérificateur
  4. É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 unique
    Le formulaire Émettre une licence avec l'alerte de clé de licence à usage unique
  5. 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 Valide
    La carte de validation montrant un résultat Valide

Exemples

Émettre une licence (API)
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.
Récupérer la clé publique de l'émetteur à épingler (API)
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 :

ChampSignification
plan_codeLe plan ou palier que la licence accorde.
featuresCodes de fonctionnalités facultatifs activés par cette licence.
user_limitNombre de sièges; utilisez -1 pour illimité.
expiry_dateLa date après laquelle la licence n'est plus valide.
customer_nameLe 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 ?
Dans le coffre sécurisé de secrets de votre projet. La plateforme signe en votre nom; la clé privée n'est jamais retournée ni à vous, ni à votre produit, ni à vos clients.
Mes clients doivent-ils être en ligne pour utiliser une licence ?
Non. La vérification se fait avec la clé publique épinglée, donc votre produit peut valider une licence entièrement hors ligne.
J'ai perdu une clé de licence. Puis-je la récupérer ?
La clé signée est affichée une seule fois à l'émission et n'est pas récupérable ensuite. Émettez plutôt une nouvelle licence pour ce client.

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.

Cet article vous a-t-il été utile?
Merci de votre rétroaction. Toujours bloqué? Écrivez-nous