Skip to Content
Nouvelle version 12 disponible 🎉
LicensingApplication webExécution en local

Exécution en local Data Center

À partir de la version 12.0, l’application web est livrée chiffrée dans le paquet du service et n’est servie que par un Babel Licensing Service doté d’une licence Data Center. Elle ne peut pas être hébergée sur un serveur web statique distinct. Pour gérer un service en édition Server, utilisez la Management API, ou Babel Desktop sur la machine du service.

Le Babel Licensing Service déchiffre les scripts de l’application web en mémoire à l’exécution, et seulement si sa licence comprend la fonctionnalité d’application web. Copier les fichiers du dossier wwwroot du service vers un autre serveur web, par exemple un conteneur nginx, ne donne pas une application web fonctionnelle.

Gérer un service distant

Pour consulter un Babel Licensing Service distant depuis votre machine locale, installez Babel Desktop et ajoutez une connexion de gestion des licences vers l’adresse du service, avec une clé API. Babel Desktop fonctionne avec les éditions Server et Data Center, mais les profils de services distants sont en lecture seule : la création, la modification et la suppression d’enregistrements exigent un profil Test local avec Gestion locale, c’est-à-dire Babel Desktop exécuté sur la machine du service. Pour modifier les données d’un service distant, utilisez la Management API.

Si le service distant exécute l’édition Data Center, vous pouvez aussi ouvrir l’application web directement dans un navigateur, à l’adresse du service.

Exécuter le service en mode API uniquement

Pour exécuter le service en mode API uniquement, sans servir l’application web, réglez EnableWebUI sur false dans le fichier appsettings.json :

"Application": { "EnableWebApi": true, "EnableWebUI": false }

Lorsque EnableWebUI est réglé sur false, le service ne sert pas les fichiers de l’application web. L’API REST, gRPC et, s’ils sont activés, Swagger et le point de terminaison de vérification de l’état restent disponibles, de sorte que Babel Desktop et les autres clients de l’API continuent de fonctionner.

Génération de la clé API

La clé API doit être générée sur le Babel Licensing Service distant. Pour générer une clé API :

  1. Ouvrez l’application web ou Babel Desktop
  2. Accédez à la section « API Keys » (Clés API)
  3. Créez une clé API avec les autorisations appropriées
  4. Copiez la clé générée pour l’utiliser dans la configuration de votre client

Vérifiez que la clé API dispose d’autorisations suffisantes pour les opérations dont vous avez besoin.

Dépannage

Si vous rencontrez des problèmes de connexion au service distant :

  1. Vérifier la connectivité réseau : assurez-vous que votre machine locale peut joindre le serveur distant (essayez ping ou un outil similaire)
  2. Valider la clé API : assurez-vous que la clé API est valide et dispose des autorisations nécessaires
  3. Vérifier SSL/TLS : si vous utilisez HTTPS, vérifiez que le certificat SSL est valide et approuvé
  4. Paramètres du pare-feu : assurez-vous que votre pare-feu autorise les connexions sortantes vers le port du service distant
  5. Vérifier l’état du service : utilisez le point de terminaison de vérification de l’état (/health) du service distant pour vérifier qu’il est opérationnel
  6. Vérifier l’édition : si le navigateur affiche la page de mise à niveau au lieu de l’application web, la licence du service ne comprend pas la fonctionnalité d’application web. Remplacez babel.licenses par une licence Data Center et redémarrez le service.

Considérations de sécurité

Lorsque vous vous connectez à un service de licences distant, appliquez ces bonnes pratiques de sécurité :

  1. Utilisez HTTPS pour sécuriser les communications
  2. Renouvelez régulièrement les clés API
  3. Appliquez le principe du moindre privilège lorsque vous attribuez des autorisations aux clés API
  4. Ne validez pas dans le contrôle de code source des fichiers de configuration qui contiennent des clés API

Avant la version 12.0, les fichiers de l’application web pouvaient être copiés sur un serveur web distinct, par exemple un conteneur Docker nginx, et dirigés vers un service distant au moyen d’un fichier config.js. Cette procédure ne s’applique pas au paquet du service 12.0.

Last updated on