Skip to content

Referencia

Referencia de la CLI

Comandos, opciones y códigos de salida de la herramienta de línea de comandos nebula.

El comando nebula protege ensamblados a partir de una config JSON y ofrece comandos de apoyo para el licenciamiento y los diagnósticos.

Proteger (comando raíz)

nebula --config <file> [options]
OpciónDescripción
--config, -cRuta al archivo de configuración JSON (obligatorio).
--input, -iEnsamblado de entrada a ofuscar; anula inputs en la config. Repetible. Permite que una config compartida “solo de ajustes” (sin inputs) dirija las transformaciones mientras quien la invoca proporciona el ensamblado — lo usa la integración de MSBuild para pasar la salida de cada target framework.
--output, -oAnula el outputDirectory de la config.
--preserve-public-api [true|false]Anula preservePublicApi.
--quiet, -qSuprime el progreso; sigue mostrando advertencias/errores.
--json <file>Escribe un resumen de ejecución legible por máquina (útil en CI).

Claves de configuración

{
  "schemaVersion": 1,
  "inputs": ["bin/Release/net8.0/MyApp.dll"],
  "outputDirectory": "protected",
  "preservePublicApi": true,
  "encryptStrings": true,
  "controlFlowObfuscation": true,
  "encryptResources": true,
  "antiTamper": true,
  "antiDebug": true,
  "metadataHardening": true,
  "verifyOutput": true
}

Otras claves incluyen los filtros exclude / include, excludeNamespaces, controlFlowInclude / controlFlowExclude, encryptStringsInclude / excludeStrings, la firma de nombre seguro (strongNameKeyFile, delaySign) y Authenticode (authenticodeCertFile, authenticodeTimestampUrl).

Otros comandos

nebula inspect <assembly>      # lista métodos y literales de cadena para protección selectiva
nebula register --key LIC-...  # activa una licencia en línea en esta máquina
nebula machine-id              # muestra el id de activación de esta máquina
nebula license                 # muestra la edición / licencia actual
nebula deobfuscate --map <symbols.json> --input <trace.txt>   # traduce una traza de pila
nebula blazor --framework <wwwroot/_framework> [--config <file>] [--assembly <Name> ...]  # protege una app Blazor WASM publicada

Códigos de salida

CódigoSignificado
0Éxito
2Configuración no válida
6Licencia requerida / activación fallida
64Error de uso

Usa el código de salida en CI para hacer fallar una compilación si la protección no tuvo éxito.