Configuration de la licence

Le open core ne nécessite aucune clé de licence — chaque fonctionnalité de base est active dès la sortie de la boîte. Une clé déverrouille le module complémentaire Pro pour l'auto-hébergement (WAF géré, Redis distribué, tableau de bord d'équipe, OpenTelemetry) ou porte les droits Enterprise / OEM. Si vous en avez un, configurez-le comme ci-dessous.

Obtenir une clé#

Achetez Pro chez bext.dev/tarification ; Les clés Entreprise et OEM sont émises dans le cadre de votre accord ( bext.dev/partenaires ). Vous recevrez une clé commençant par BEXT-PRO-, BEXT-ENT- ou BEXT-OEM-.

Configuration#

Option 1 : fichier de configuration (recommandé)#

Ajoutez une section [license] à votre bext.config.toml :

toml

[license]
key = "BEXT-PRO-eyJ0aWVy..."

Option 2 : variable d'environnement#

bash

export BEXT_LICENSE_KEY="BEXT-PRO-eyJ0aWVy..."
bext-server run .

Si les deux sont définies, la variable d'environnement est prioritaire, ce qui est utile pour garder les clés hors des fichiers de configuration dans CI/CD.

Option 3 : fichier.env#

bash

# .env
BEXT_LICENSE_KEY=BEXT-PRO-eyJ0aWVy...

bext charge automatiquement .env au démarrage.

Vérifier une clé#

bash

bext-server license

Sortir:

code

bext license

  Plan:       Pro
  Org:        Acme Corp
  Expires:    2027-04-03
  Remaining:  365 days
  Servers:    5
  Add-ons:    waf-managed, redis-cluster, dashboard-team, otel

Comportement de démarrage#

Lorsque le serveur démarre, il valide toute clé configurée et enregistre le résultat :

code

INFO License: Pro (Acme Corp)

Le noyau ouvert fonctionne avec ou sans clé. Si un module complémentaire Pro est configuré mais qu'aucune clé n'est présente, le serveur enregistre un message d'information et continue de fonctionner :

code

INFO Managed WAF rules configured but require Pro — using the base WAF

Il ne refuse jamais de démarrer.

Comment fonctionnent les clés#

Les clés de licence sont des charges utiles JSON signées Ed25519 et codées en Base64 :

code

BEXT-PRO-{base64_payload}.{base64_signature}

La charge utile contient votre forfait, votre organisation, la limite du serveur, l'expiration et les modules complémentaires. La vérification utilise une clé publique intégrée dans le binaire — aucun appel réseau n'est jamais effectué.

Expiration#

Les clés ont une date d'expiration fixée à l'achat
Après l'expiration, il y a un délai de grâce de 14 jours avec un avertissement enregistré
Après la période de grâce, les modules complémentaires Pro se désactivent et le noyau ouvert continue de fonctionner
Le renouvellement génère une nouvelle clé ; mets simplement à jour ta configuration

En rapport#

Aperçu des licences — noyau ouvert vs Pro
FAQ sur les licences — clés, expiration et Cloud
Configuration → bext.config.toml — où réside la section [license]