Activación del producto

Babel Obfuscator puede usarse en modo de demostración sin necesidad de una licencia. Sin embargo, durante el período de prueba solo se puede utilizar la función de renombrado. Es importante tener en cuenta que los ensamblados ofuscados en modo de demostración dejan de funcionar a partir de una fecha determinada, tal como indica el registro de la ofuscación con el código de advertencia W00000.

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

La presencia de la advertencia W00000 en el registro de compilación indica que el ensamblado ofuscado se ejecuta en modo de demostración y que dejará de funcionar después de la fecha de caducidad indicada. Por lo tanto, estos ensamblados no pueden distribuirse para su uso en producción ni para su venta, ya que están diseñados para dejar de funcionar una vez pasada esa fecha.

Para garantizar que en una compilación comercial o de producción solo se usen ensamblados con licencia completa y sin restricciones, se recomienda configurar Babel para que trate la advertencia W00000 como un error.

Con esta configuración, el proceso de compilación falla si aparece la advertencia, lo que impide publicar ensamblados ofuscados en modo de demostración. Para ello, añada la propiedad WarningsAsErrors a la tarea Babel en su script de compilación, como se muestra más abajo:

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

Al incluir W00000 en WarningsAsErrors, cualquier aparición de esta advertencia se trata como un error y detiene el proceso de compilación. Así, la compilación solo termina correctamente si hay una licencia válida bien instalada, y los ensamblados resultantes no están sujetos a caducidad ni a restricciones de funcionalidad.

Archivo de licencia

Para desbloquear todas las funciones y garantizar un funcionamiento sin interrupciones, es necesario comprar una licencia de Babel Obfuscator.

Al comprar Babel Obfuscator y obtener la licencia, recibirá un archivo llamado «babel.licenses». Este archivo está en formato XML, está firmado digitalmente y contiene la información de licencia correspondiente a la edición del producto que haya comprado.

No modifique el archivo de licencia: un archivo modificado deja de ser válido.

Para instalar la licencia, copie el archivo babel.licenses en la carpeta donde extrajo el paquete zip, junto a babel.exe o babel.dll. Babel lee la licencia desde allí y desbloquea las funciones de la edición que ha comprado, y los ensamblados que ofusca dejan de caducar al terminar el período de prueba.

Para guardar el archivo de licencia en otro lugar, establezca la variable de entorno BABEL_LICENSE_PATH en su ruta completa. Esto funciona en cualquier sistema operativo.

Windows PowerShell, sesión actual:

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

Windows, de forma permanente para el usuario actual:

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

Linux y macOS:

export BABEL_LICENSE_PATH=~/Babel/babel.licenses

En Babel Desktop, abra Configuración, elija Licencia, seleccione Archivo de licencia como origen de la licencia y haga clic en Examinar… para cargar el archivo.

Para consultar la información de su licencia, escriba en una ventana de PowerShell o de terminal:

babel.exe --license

Si se encuentra una licencia válida, se muestra la información de la licencia:

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 no se encuentra el archivo de licencia, aparece el mensaje siguiente:

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

Usar la clave de licencia como secreto

En los servidores de compilación que admiten secretos, la clave de licencia de Babel Obfuscator puede almacenarse y gestionarse de forma segura como un secreto, al que después se accede durante el proceso de compilación. Al configurar la clave de licencia como secreto, la clave queda protegida y solo pueden acceder a ella los usuarios o procesos autorizados. Esto ayuda a mantener la seguridad y la integridad del código y de los recursos de su aplicación.

Babel Obfuscator permite cargar la licencia directamente desde una variable de entorno que contiene la clave de licencia. Para ello, escriba el comando siguiente en la línea de comandos:

babel --license env:BABEL_LICENSE

Aquí, BABEL_LICENSE es la variable de entorno que contiene la clave de licencia de Babel Obfuscator. Con este método, la clave de licencia se guarda de forma segura en una variable de entorno mediante los secretos del servidor de compilación, y Babel Obfuscator accede a ella durante el proceso de ofuscación.

El ejemplo siguiente muestra cómo pasar la variable de entorno BABEL_LICENSE al paso de compilación mediante secrets.BABEL_LICENSE_SECRET, que almacena la clave de licencia.

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 usa el paquete NuGet de Babel Obfuscator en su proyecto, defina la propiedad BabelLicense de la forma siguiente:

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

Al asignar $(BABEL_LICENSE) a la propiedad BabelLicense, Babel Obfuscator carga la clave de licencia desde la variable de entorno BABEL_LICENSE, a la que el paso de compilación asigna el secreto BABEL_LICENSE_SECRET. De este modo, la clave de licencia se almacena y se usa de forma segura en el proceso de compilación. Para más información, consulte el proyecto de ejemplo GitHub Actions.

Clave de activación

Si ha recibido una clave de activación de Babel Obfuscator, como esta:

DWTW3-SPGGH-04DJ4-4K809

puede activar el producto en Babel Desktop:

La activación se guarda en este equipo y se restaura cada vez que se inicia Babel Desktop. Haga clic en Desactivar para liberar la activación de este equipo.

También puede activar la licencia desde la línea de comandos:

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

y liberarla con:

babel --license deactivate

Uso de la licencia flotante

Babel Obfuscator puede funcionar también con un mecanismo de licencia flotante. Resulta especialmente útil en organizaciones o grupos de trabajo en los que varios usuarios necesitan acceder al software, pero no al mismo tiempo. El identificador único con el que se solicita una licencia flotante es una clave de usuario, que tiene un formato similar a este:

P1N1J-EH5VA-VGSFU-7EOK8

Con este sistema de licencia flotante, secrets.BABEL_LICENSE_SECRET se configura para almacenar esta clave de usuario de forma segura. En la configuración de compilación de su proyecto, el elemento XML <BabelLicense> debe tener esta estructura:

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

Con esta configuración, cuando Babel Obfuscator se ejecuta durante el proceso de compilación, reconoce la instrucción floating:$(BABEL_LICENSE) e intenta obtener una licencia flotante con la clave de usuario almacenada en la variable de entorno BABEL_LICENSE.

En Babel Desktop, abra Configuración, elija Licencia, seleccione Licencia flotante como origen de la licencia, introduzca la clave de usuario y haga clic en Solicitar licencia. Marque Solicitar automáticamente al inicio para solicitarla cada vez que se inicie la aplicación. La licencia flotante se libera al salir de Babel Desktop.

Solución de problemas con el archivo de licencia

Si tiene problemas con el archivo de licencia, compruebe los puntos siguientes.

1. Compruebe que el archivo de licencia babel.licenses está junto a babel.exe o babel.dll en la carpeta donde extrajo el paquete zip, o que la variable de entorno BABEL_LICENSE_PATH apunta a él.
2. Compruebe que ha instalado la versión comercial de Babel Obfuscator. La versión DEMO de Babel Obfuscator que se puede descargar en babelfor.net no sirve para ejecutarse con una licencia comercial. Si usa la versión DEMO, sustitúyala por el paquete comercial.
3. El archivo de licencia babel.licenses debe ser exactamente el que recibió con los paquetes binarios de Babel. Cada versión de Babel Obfuscator incluye su propio archivo de licencia. Un archivo de licencia se emite para una versión concreta del producto; también desbloquea las versiones más recientes publicadas mientras su mantenimiento está activo, pero no las publicadas después de que el mantenimiento haya vencido.

La versión de la herramienta babel se puede mostrar con el comando siguiente:

babel --version

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