Attivazione del prodotto

Babel Obfuscator può essere usato in modalità demo senza una licenza. Durante il periodo di prova, però, puoi usare solo la funzionalità di ridenominazione. Tieni presente che gli assembly offuscati in modalità demo smettono di funzionare dopo una data precisa, indicata nel log dell’offuscamento dal codice di avviso W00000.

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

La presenza dell’avviso W00000 nel log della build indica che l’assembly offuscato funziona in modalità demo e smetterà di funzionare dopo la data di scadenza indicata. Di conseguenza questi assembly non possono essere distribuiti per l’uso in produzione o commerciale, perché sono fatti per smettere di funzionare dopo la scadenza.

Per garantire che in una build commerciale o di produzione vengano usati solo assembly con licenza completa e senza restrizioni, è consigliabile configurare Babel in modo che tratti l’avviso W00000 come un errore.

Con questa configurazione la build fallisce quando l’avviso viene emesso, e impedisce così il rilascio di assembly offuscati in modalità demo. Per ottenerlo aggiungi la proprietà WarningsAsErrors al task Babel nel tuo script di build, come mostrato di seguito:

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

Se WarningsAsErrors include W00000, ogni occorrenza di questo avviso viene trattata come un errore e interrompe la build. In questo modo la build riesce solo se è installata correttamente una licenza valida, e gli assembly prodotti non sono soggetti a scadenza né a restrizioni delle funzionalità.

File di licenza

Per sbloccare tutte le funzionalità e garantire il funzionamento nel tempo, è necessario acquistare una licenza di Babel Obfuscator.

Dopo aver acquistato Babel Obfuscator e ottenuto la licenza, riceverai un file chiamato “babel.licenses”. Il file è in formato XML, è firmato digitalmente e contiene le informazioni di licenza relative all’edizione del prodotto che hai acquistato.

Non modificare il file di licenza: un file modificato non è più valido.

Per installare la licenza, copia il file babel.licenses nella cartella in cui hai estratto il pacchetto zip, accanto a babel.exe o babel.dll. Babel legge la licenza da lì e sblocca le funzionalità dell’edizione che hai acquistato, e gli assembly che offusca non scadono più al termine del periodo di prova.

Per tenere il file di licenza in un’altra posizione, imposta la variabile d’ambiente BABEL_LICENSE_PATH sul suo percorso completo. Funziona su qualsiasi sistema operativo.

Windows PowerShell, sessione corrente:

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

Windows, in modo permanente per l’utente corrente:

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

Linux e macOS:

export BABEL_LICENSE_PATH=~/Babel/babel.licenses

In Babel Desktop apri Impostazioni, scegli Licenza, seleziona File di licenza come origine della licenza e fai clic su Sfoglia… per caricare il file.

Puoi consultare le informazioni della tua licenza digitando in una finestra di PowerShell o del terminale:

babel.exe --license

Se viene trovata una licenza valida, vengono mostrate le informazioni della licenza:

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

Se il file di licenza non viene trovato, viene mostrato il messaggio seguente:

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

Usare la chiave di licenza come segreto

Sui server di build che supportano i segreti puoi conservare e gestire in modo sicuro la chiave di licenza di Babel Obfuscator come segreto, e accedervi poi durante la build. Configurando la chiave di licenza come segreto hai la garanzia che sia protetta e accessibile solo a utenti o processi autorizzati. Questo aiuta a mantenere la sicurezza e l’integrità del codice e delle risorse della tua applicazione.

Babel Obfuscator può caricare la licenza direttamente da una variabile d’ambiente che contiene la chiave di licenza. Per farlo, inserisci il comando seguente nella riga di comando:

babel --license env:BABEL_LICENSE

Qui BABEL_LICENSE è la variabile d’ambiente che contiene la chiave di licenza di Babel Obfuscator. Con questo metodo la chiave di licenza viene conservata in modo sicuro in una variabile d’ambiente tramite i segreti del server di build, e Babel Obfuscator vi accede durante l’offuscamento.

L’esempio seguente mostra come passare la variabile d’ambiente BABEL_LICENSE al passo di build usando secrets.BABEL_LICENSE_SECRET, che contiene la chiave di licenza.

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 }}

Se nel tuo progetto usi il pacchetto NuGet di Babel Obfuscator, definisci la proprietà BabelLicense come segue:

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

Impostando la proprietà BabelLicense su $(BABEL_LICENSE), Babel Obfuscator carica la chiave di licenza dalla variabile d’ambiente BABEL_LICENSE, che nel passo di build è impostata sul segreto BABEL_LICENSE_SECRET. In questo modo la chiave di licenza viene conservata e usata in modo sicuro durante la build. Per saperne di più, vedi il progetto di esempio GitHub Actions.

Chiave di attivazione

Se hai ricevuto una chiave di attivazione per Babel Obfuscator, come:

DWTW3-SPGGH-04DJ4-4K809

puoi attivare il prodotto in Babel Desktop:

L’attivazione viene salvata su questo computer e ripristinata a ogni avvio di Babel Desktop. Fai clic su Disattiva per rilasciare l’attivazione da questo computer.

Puoi attivare la licenza anche dalla riga di comando:

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

e rilasciarla con:

babel --license deactivate

Utilizzo della licenza flottante

Babel Obfuscator può funzionare anche con un meccanismo di licenza flottante. È particolarmente utile per le organizzazioni o i team in cui più utenti hanno bisogno di usare il software, ma non contemporaneamente. L’identificatore univoco con cui si richiede una licenza flottante è una chiave utente, in un formato simile a:

P1N1J-EH5VA-VGSFU-7EOK8

Quando usi la licenza flottante, secrets.BABEL_LICENSE_SECRET viene configurato per conservare in modo sicuro questa chiave utente. Nella configurazione di build del tuo progetto, l’elemento XML <BabelLicense> va strutturato così:

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

Con questa configurazione, quando Babel Obfuscator viene eseguito durante la build riconosce l’istruzione floating:$(BABEL_LICENSE) e prova a ottenere una licenza flottante con la chiave utente contenuta nella variabile d’ambiente BABEL_LICENSE.

In Babel Desktop apri Impostazioni, scegli Licenza, seleziona Licenza floating come origine della licenza, inserisci la chiave utente e fai clic su Richiedi licenza. Seleziona Richiedi automaticamente all’avvio per richiederla a ogni avvio dell’applicazione. La licenza flottante viene rilasciata alla chiusura di Babel Desktop.

Risoluzione dei problemi del file di licenza

Se hai problemi con il file di licenza, controlla i punti seguenti.

1. Assicurati che il file di licenza babel.licenses si trovi accanto a babel.exe o babel.dll nella cartella in cui hai estratto il pacchetto zip, oppure che la variabile d’ambiente BABEL_LICENSE_PATH punti a quel file.
2. Assicurati di aver installato la versione commerciale di Babel Obfuscator. La versione DEMO di Babel Obfuscator scaricabile da babelfor.net non è adatta a funzionare con una licenza commerciale. Se stai usando la versione DEMO, sostituiscila con il pacchetto commerciale.
3. Il file di licenza babel.licenses deve essere esattamente quello che hai ricevuto con i pacchetti binari di Babel. Ogni versione di Babel Obfuscator ha il proprio file di licenza. Un file di licenza è emesso per una versione specifica del prodotto; sblocca anche le versioni più recenti rilasciate mentre la sua manutenzione è attiva, ma non quelle rilasciate dopo la scadenza della manutenzione.

La versione dello strumento babel si può visualizzare con il comando seguente:

babel --version

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