Produktaktivierung

Babel Obfuscator lässt sich im Evaluierungsmodus ohne Lizenz verwenden. Während des Testzeitraums steht von den Verschleierungsfunktionen jedoch nur die Umbenennung zur Verfügung. Beachten Sie, dass im Demomodus verschleierte Assemblys nach einem bestimmten Datum nicht mehr funktionieren. Das Verschleierungsprotokoll weist mit dem Warncode W00000 darauf hin.

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

Die Warnung W00000 im Buildprotokoll zeigt an, dass die verschleierte Assembly im Evaluierungsmodus läuft und nach dem angegebenen Ablaufdatum nicht mehr funktioniert. Solche Assemblys können daher nicht für den Produktiveinsatz oder den Verkauf ausgeliefert werden, denn sie sind darauf ausgelegt, nach dem Ablauf nicht mehr zu funktionieren.

Damit in einem Verkaufs- oder Produktionsbuild nur vollständig lizenzierte Assemblys ohne Einschränkungen verwendet werden, empfiehlt es sich, Babel so zu konfigurieren, dass die Warnung W00000 als Fehler behandelt wird.

Mit dieser Konfiguration schlägt der Build fehl, sobald die Warnung auftritt, sodass keine im Evaluierungsmodus verschleierten Assemblys veröffentlicht werden. Fügen Sie dazu in Ihrem Buildskript der Aufgabe Babel die Eigenschaft WarningsAsErrors hinzu, wie unten gezeigt:

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

Wenn WarningsAsErrors den Code W00000 enthält, wird jedes Auftreten dieser Warnung als Fehler behandelt, und der Build bricht ab. Der Build gelingt damit nur, wenn eine gültige Lizenz ordnungsgemäß installiert ist, und die erzeugten Assemblys unterliegen weder einem Ablaufdatum noch Funktionseinschränkungen.

Lizenzdatei

Um alle Funktionen freizuschalten und den dauerhaften Betrieb sicherzustellen, müssen Sie eine Lizenz für Babel Obfuscator erwerben.

Nach dem Kauf von Babel Obfuscator erhalten Sie mit der Lizenz eine Datei namens „babel.licenses“. Diese Datei liegt im XML-Format vor, ist digital signiert und enthält die Lizenzinformationen der Produktedition, die Sie erworben haben.

Ändern Sie die Lizenzdatei nicht: Eine geänderte Datei ist nicht mehr gültig.

Um die Lizenz zu installieren, kopieren Sie die Datei babel.licenses in den Ordner, in den Sie das Zip-Paket entpackt haben, neben babel.exe oder babel.dll. Babel liest die Lizenz von dort und schaltet die Funktionen der erworbenen Edition frei. Die Assemblys, die Babel verschleiert, laufen dann nach dem Testzeitraum nicht mehr ab.

Wenn die Lizenzdatei an einem anderen Ort liegen soll, setzen Sie die Umgebungsvariable BABEL_LICENSE_PATH auf ihren vollständigen Pfad. Das funktioniert unter jedem Betriebssystem.

Windows PowerShell, aktuelle Sitzung:

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

Windows, dauerhaft für den aktuellen Benutzer:

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

Linux und macOS:

export BABEL_LICENSE_PATH=~/Babel/babel.licenses

Öffnen Sie in Babel Desktop die Einstellungen, wählen Sie Lizenz, legen Sie Lizenzdatei als Lizenzquelle fest und klicken Sie auf Durchsuchen…, um die Datei zu laden.

Ihre Lizenzinformationen rufen Sie ab, indem Sie in einem PowerShell- oder Terminalfenster eingeben:

babel.exe --license

Wird eine gültige Lizenz gefunden, erhalten Sie Ihre Lizenzinformationen:

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

Wird die Lizenzdatei nicht gefunden, erhalten Sie die folgende Meldung:

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

Lizenzschlüssel als Geheimnis verwenden

Auf Buildservern, die Geheimnisse (Secrets) unterstützen, können Sie den Lizenzschlüssel von Babel Obfuscator sicher als Geheimnis speichern und verwalten und während des Builds darauf zugreifen. Wenn Sie den Lizenzschlüssel als Geheimnis einrichten, ist er geschützt und nur für berechtigte Benutzer oder Prozesse zugänglich. Das trägt dazu bei, die Sicherheit und Integrität des Codes und der Ressourcen Ihrer Anwendung zu wahren.

Babel Obfuscator kann die Lizenz direkt aus einer Umgebungsvariablen laden, in der der Lizenzschlüssel gespeichert ist. Geben Sie dazu den folgenden Befehl in der Befehlszeile ein:

babel --license env:BABEL_LICENSE

Dabei ist BABEL_LICENSE die Umgebungsvariable, die den Lizenzschlüssel von Babel Obfuscator enthält. Auf diese Weise lässt sich der Lizenzschlüssel über die Geheimnisse des Buildservers sicher in einer Umgebungsvariablen ablegen, und Babel Obfuscator greift bei der Verschleierung darauf zu.

Das folgende Beispiel zeigt, wie die Umgebungsvariable BABEL_LICENSE dem Buildschritt über secrets.BABEL_LICENSE_SECRET übergeben wird, in dem der Lizenzschlüssel gespeichert ist.

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

Wenn Sie in Ihrem Projekt das NuGet-Paket von Babel Obfuscator verwenden, definieren Sie die Eigenschaft BabelLicense wie folgt:

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

Wenn Sie die Eigenschaft BabelLicense auf $(BABEL_LICENSE) setzen, lädt Babel Obfuscator den Lizenzschlüssel aus der definierten Umgebungsvariablen BABEL_LICENSE, die im Buildschritt auf das Geheimnis BABEL_LICENSE_SECRET gesetzt wird. So lässt sich der Lizenzschlüssel im Build sicher speichern und verwenden. Weitere Informationen finden Sie im Beispielprojekt GitHub Actions.

Aktivierungsschlüssel

Wenn Sie einen Aktivierungsschlüssel für Babel Obfuscator erhalten haben, zum Beispiel:

DWTW3-SPGGH-04DJ4-4K809

können Sie Ihr Produkt in Babel Desktop aktivieren:

Die Aktivierung wird auf diesem Rechner gespeichert und bei jedem Start von Babel Desktop wiederhergestellt. Mit Deaktivieren geben Sie die Aktivierung auf diesem Rechner wieder frei.

Sie können die Lizenz auch über die Befehlszeile aktivieren:

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

und mit diesem Befehl wieder freigeben:

babel --license deactivate

Verwendung einer Floating-Lizenz

Babel Obfuscator lässt sich flexibel mit einer Floating-Lizenz betreiben. Das ist besonders für Organisationen oder Teams nützlich, in denen mehrere Benutzer die Software benötigen, aber nicht gleichzeitig. Die eindeutige Kennung, mit der eine Floating-Lizenz angefordert wird, ist ein Benutzerschlüssel in einem Format wie diesem:

P1N1J-EH5VA-VGSFU-7EOK8

Bei diesem Floating-Lizenzsystem wird secrets.BABEL_LICENSE_SECRET so konfiguriert, dass es diesen Benutzerschlüssel sicher speichert. In der Buildkonfiguration Ihres Projekts sieht das XML-Element <BabelLicense> so aus:

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

Mit dieser Konfiguration erkennt Babel Obfuscator, wenn es im Build läuft, die Anweisung floating:$(BABEL_LICENSE) und versucht, mit dem Benutzerschlüssel aus der Umgebungsvariablen BABEL_LICENSE eine Floating-Lizenz zu beziehen.

Öffnen Sie in Babel Desktop die Einstellungen, wählen Sie Lizenz, legen Sie Floating-Lizenz als Lizenzquelle fest, geben Sie den Benutzerschlüssel ein und klicken Sie auf Lizenz anfordern. Aktivieren Sie Beim Start automatisch anfordern, damit die Lizenz bei jedem Start der Anwendung angefordert wird. Die Floating-Lizenz wird freigegeben, wenn Babel Desktop beendet wird.

Probleme mit der Lizenzdatei beheben

Wenn Probleme mit der Lizenzdatei auftreten, prüfen Sie die folgenden Punkte.

1. Stellen Sie sicher, dass die Lizenzdatei babel.licenses in dem Ordner, in den Sie das Zip-Paket entpackt haben, neben babel.exe oder babel.dll liegt oder dass die Umgebungsvariable BABEL_LICENSE_PATH auf sie zeigt.
2. Stellen Sie sicher, dass Sie die Vollversion von Babel Obfuscator installiert haben. Die DEMO-Version von Babel Obfuscator, die auf babelfor.net zum Download bereitsteht, eignet sich nicht für den Betrieb mit einer gekauften Lizenz. Wenn Sie die DEMO-Version verwenden, ersetzen Sie sie durch das Paket der Vollversion.
3. Die Lizenzdatei babel.licenses muss genau die Datei sein, die Sie mit den Binärpaketen von Babel erhalten haben. Jede Version von Babel Obfuscator wird mit ihrer eigenen Lizenzdatei ausgeliefert. Eine Lizenzdatei wird für eine bestimmte Version des Produkts ausgestellt. Sie schaltet auch neuere Versionen frei, die während der laufenden Wartung erscheinen, nicht aber Versionen, die nach dem Ablauf der Wartung veröffentlicht wurden.

Die Version des Tools babel zeigt der folgende Befehl an:

babel --version

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