Activation du produit

Babel Obfuscator peut être utilisé en mode d’évaluation, sans licence. Pendant la période d’essai, les utilisateurs ne peuvent toutefois utiliser que la fonctionnalité de renommage. Notez que les assemblies obfusqués en mode d’évaluation cessent de fonctionner après une date précise, que le journal d’obfuscation signale par le code d’avertissement W00000.

Warning [W00000]: This is an evaluation version; the obfuscated assembly will no longer work after 15/08/2024 17:16:27

La présence de l’avertissement W00000 dans le journal de build indique que l’assembly obfusqué fonctionne en mode d’évaluation et cessera de fonctionner après la date d’expiration indiquée. Ces assemblies ne peuvent donc pas être distribués pour une utilisation commerciale ou en production, puisqu’ils sont conçus pour cesser de fonctionner après l’expiration.

Pour garantir que seuls des assemblies sous licence complète et sans restriction sont utilisés dans un build commercial ou de production, il est recommandé de configurer Babel pour qu’il traite l’avertissement W00000 comme une erreur.

Avec cette configuration, le build échoue dès que l’avertissement apparaît, ce qui empêche de publier des assemblies obfusqués en mode d’évaluation. Pour cela, ajoutez la propriété WarningsAsErrors à la tâche Babel de votre script de build, comme ci-dessous :

<Babel WarningsAsErrors="W00000" ... />

Lorsque WarningsAsErrors contient W00000, toute occurrence de cet avertissement est traitée comme une erreur et interrompt le build. Le build ne réussit donc que si une licence valide est correctement installée, et les assemblies produits ne sont soumis ni à une expiration ni à des restrictions de fonctionnalités.

Fichier de licence

Pour déverrouiller toutes les fonctionnalités et garantir un fonctionnement sans limite de durée, il est nécessaire d’acheter une licence Babel Obfuscator.

Après l’achat de Babel Obfuscator et l’obtention de la licence, vous recevez un fichier nommé « babel.licenses ». Ce fichier au format XML est signé numériquement et contient les informations de licence de l’édition du produit que vous avez achetée.

Ne modifiez pas le fichier de licence : un fichier modifié n’est plus valide.

Pour installer la licence, copiez le fichier babel.licenses dans le dossier où vous avez extrait l’archive zip, à côté de babel.exe ou de babel.dll. Babel y lit la licence et déverrouille les fonctionnalités de l’édition que vous avez achetée, et les assemblies qu’il obfusque n’expirent plus après la période d’essai.

Pour conserver le fichier de licence ailleurs, réglez la variable d’environnement BABEL_LICENSE_PATH sur son chemin complet. Cette méthode fonctionne sur tous les systèmes d’exploitation.

Windows PowerShell, session en cours :

$env:BABEL_LICENSE_PATH = "C:\Babel\babel.licenses"

Windows, de façon permanente pour l’utilisateur actuel :

setx BABEL_LICENSE_PATH "C:\Babel\babel.licenses"

Linux et macOS :

export BABEL_LICENSE_PATH=~/Babel/babel.licenses

Dans Babel Desktop, ouvrez les Paramètres, choisissez Licence, sélectionnez Fichier de licence comme source de la licence et cliquez sur Parcourir… pour charger le fichier.

Pour afficher les informations de votre licence, saisissez dans une fenêtre PowerShell ou un terminal :

babel.exe --license

Si une licence valide est trouvée, les informations de votre licence s’affichent :

License Id: licC2A87385
   issued: 19 Dec 2022

Product: Babel Obfuscator Ultimate 10.0.0.0
   Babel Obfuscator for .NET Framework

Licensed to: babelfor.NET
   contact info: sales@babelfor.net

Fields: ultimate

Si le fichier de licence est introuvable, le message suivant s’affiche :

Error: A valid license could not be found. Please contact http://www.babelfor.net  for assistance.

Utiliser une clé de licence stockée dans un secret

Sur les serveurs de build qui prennent en charge les secrets, la clé de licence Babel Obfuscator peut être stockée et gérée de façon sécurisée sous forme de secret, puis lue pendant le build. Une clé de licence définie comme secret est protégée et n’est accessible qu’aux utilisateurs et aux processus autorisés. La sécurité et l’intégrité du code et des ressources de votre application sont ainsi préservées.

Babel Obfuscator peut charger la licence directement à partir d’une variable d’environnement qui contient la clé de licence. Pour cela, saisissez la commande suivante sur la ligne de commande :

babel --license env:BABEL_LICENSE

Ici, BABEL_LICENSE est la variable d’environnement qui contient la clé de licence Babel Obfuscator. Avec cette méthode, la clé de licence est stockée de façon sécurisée dans une variable d’environnement grâce aux secrets du serveur de build, et Babel Obfuscator la lit pendant l’obfuscation.

L’exemple suivant montre comment transmettre la variable d’environnement BABEL_LICENSE à l’étape de build à l’aide de secrets.BABEL_LICENSE_SECRET, qui contient la clé de licence.

name: dotnet package
 
on: [push]
 
jobs:
  build:
 
    runs-on: ubuntu-latest
    strategy:
      matrix:
        dotnet-version: [ '3.1.x', '7.0.x' ]
 
    steps:
      - uses: actions/checkout@v3
      - name: Setup .NET Core SDK ${{ matrix.dotnet-version }}
        uses: actions/setup-dotnet@v3
        with:
          dotnet-version: ${{ matrix.dotnet-version }}
      - name: Install dependencies
        run: dotnet restore
      - name: Build
        run: dotnet build --configuration Release --no-restore
        env:
          BABEL_LICENSE: ${{ secrets.BABEL_LICENSE_SECRET }}

Si vous utilisez le package NuGet Babel Obfuscator dans votre projet, définissez la propriété BabelLicense comme suit :

<PropertyGroup>
  <BabelLicense>$(BABEL_LICENSE)</BabelLicense>
</PropertyGroup>

Lorsque la propriété BabelLicense vaut $(BABEL_LICENSE), Babel Obfuscator charge la clé de licence à partir de la variable d’environnement BABEL_LICENSE, à laquelle l’étape de build affecte le secret BABEL_LICENSE_SECRET. Cette approche permet de stocker et d’utiliser la clé de licence de façon sécurisée pendant le build. Pour en savoir plus, consultez le projet d’exemple GitHub Actions.

Clé d’activation

Si vous avez reçu une clé d’activation pour Babel Obfuscator, par exemple :

DWTW3-SPGGH-04DJ4-4K809

vous pouvez activer votre produit dans Babel Desktop :

L’activation est enregistrée sur cette machine et rétablie à chaque démarrage de Babel Desktop. Cliquez sur Désactiver pour libérer l’activation de cette machine.

Vous pouvez aussi activer la licence depuis la ligne de commande :

babel --license activate:DWTW3-SPGGH-04DJ4-4K809

et la libérer avec :

babel --license deactivate

Utilisation d’une licence flottante

Babel Obfuscator peut aussi fonctionner avec une licence flottante. Ce mécanisme est particulièrement utile aux organisations et aux équipes dont plusieurs utilisateurs ont besoin du logiciel, mais pas en même temps. L’identifiant unique qui sert à demander une licence flottante est une clé utilisateur, dont le format ressemble à ceci :

P1N1J-EH5VA-VGSFU-7EOK8

Avec ce système de licence flottante, secrets.BABEL_LICENSE_SECRET est configuré pour stocker cette clé utilisateur de façon sécurisée. Dans la configuration de build de votre projet, l’élément XML <BabelLicense> doit se présenter ainsi :

<PropertyGroup>
  <BabelLicense>floating:$(BABEL_LICENSE)</BabelLicense>
</PropertyGroup>

Avec cette configuration, lorsque Babel Obfuscator s’exécute pendant le build, il reconnaît l’instruction floating:$(BABEL_LICENSE) et tente d’obtenir une licence flottante avec la clé utilisateur stockée dans la variable d’environnement BABEL_LICENSE.

Dans Babel Desktop, ouvrez les Paramètres, choisissez Licence, sélectionnez Licence flottante comme source de la licence, saisissez la clé utilisateur et cliquez sur Demander une licence. Cochez Demander automatiquement au démarrage pour la demander à chaque démarrage de l’application. La licence flottante est libérée à la fermeture de Babel Desktop.

Dépannage du fichier de licence

Si vous rencontrez des problèmes avec le fichier de licence, vérifiez les points suivants.

1. Vérifiez que le fichier de licence babel.licenses se trouve à côté de babel.exe ou de babel.dll dans le dossier où vous avez extrait l’archive zip, ou que la variable d’environnement BABEL_LICENSE_PATH pointe vers lui.
2. Vérifiez que vous avez installé la version commerciale de Babel Obfuscator. La version DEMO de Babel Obfuscator téléchargeable sur babelfor.net n’est pas prévue pour fonctionner avec une licence commerciale. Si vous utilisez la version DEMO, remplacez-la par le paquet commercial.
3. Le fichier de licence babel.licenses doit être exactement celui que vous avez reçu avec les paquets binaires de Babel. Chaque version de Babel Obfuscator est fournie avec son fichier de licence. Un fichier de licence est établi pour une version précise du produit ; il déverrouille aussi les versions plus récentes publiées tant que sa maintenance est active, mais pas celles publiées après l’expiration de la maintenance.

La version de l’outil babel s’affiche avec la commande suivante :

babel --version

Assembly version: 10.0.0.0
Product version: 10.0.0.0
File version: 10.0.0.0