Skip to Content
Nuova versione 12 disponibile 🎉
LicensingRiga di comando

Strumenti da riga di comando Server

Lo strumento da riga di comando lic genera, firma, aggiorna e verifica le licenze Babel da un terminale, da uno script o da una build, su Windows, Linux e macOS.

lic è il corrispettivo da riga di comando della generazione delle licenze in Babel Desktop. Riceve l’assembly per cui emetti la licenza, oppure un file di licenza esistente, e un insieme di opzioni che descrivono la licenza: a chi è destinata, per quale prodotto, quando scade, quali funzionalità sblocca, quali restrizioni si applicano e quale chiave la firma. Il risultato è un file di licenza XML oppure una licenza in formato stringa, per esempio un numero di serie. Lo stesso strumento genera coppie di chiavi, esporta chiavi pubbliche, calcola chiavi hardware, verifica firme e aggiorna licenze già esistenti.

Lo strumento è disponibile in due forme, con opzioni identiche:

  • lic nei pacchetti zip di Babel: lic.exe in babel_net472_<version>.zip e lic.dll (da eseguire con dotnet lic.dll) in babel_net80_<version>.zip, babel_net90_<version>.zip e babel_net100_<version>.zip.
  • Babel.Licensing.Tool, un pacchetto di strumento .NET che installa il comando lic su qualsiasi sistema operativo con l’SDK .NET.

Entrambe sono comprese nelle edizioni di Babel Licensing, Server e Data Center.

Avvio rapido

Genera una coppia di chiavi una sola volta, custodisci la chiave privata al sicuro e incorpora la chiave pubblica nella tua applicazione. Lo stesso file PEM firma tutte le licenze che emetti:

lic --keygen rsa --keysize 2048 --keyfile keys.pem
lic --publickey --keyfile keys.pem

Genera una licenza firmata per un assembly. Intestatario, prodotto, date, funzionalità, campi e restrizioni si indicano tutti con opzioni; --sign firma il risultato con la chiave indicata in --keyfile:

lic MyApp.dll --keyfile keys.pem --sign --licensee name="Contoso" --licensee email=info@contoso.com --product name="MyApp" --product version=2.1 --expiredate 365 --feature Pro=1 --field Seats=25 --trial days=30 --output MyApp.licenses --encoding utf-8

Verifica un file di licenza con la chiave pubblica, aggiorna una licenza direttamente nel file, oppure genera un numero di serie al posto di un file XML:

lic MyApp.licenses --verify --keyfile keys.pem
lic MyApp.licenses --update --keyfile keys.pem --sign --field Seats=50
lic MyApp.dll --keyfile ecdsa.pem --sign --format serial --product name="MyApp" --expiredate 30 --output MyApp.serial

Se --sign non è sulla riga di comando la licenza viene scritta senza firma, e una licenza non firmata non supera la convalida nell’applicazione. Passa --sign ogni volta che passi --keyfile o --keyname, oppure usa la proprietà Sign del task MSBuild.

Che cosa puoi fare

AttivitàOpzioni
Creare una coppia di chiavi, esportare la chiave pubblica--keygen, --keysize, --publickey
Descrivere la licenza--id, --type, --sites, --issuedate, --expiredate, --supportexpiredate, --licensee, --product, --component, --assembly
Sbloccare funzionalità e trasportare dati--feature, --field
Limitare l’uso--trial, --hardware, --domain, --usage, --beta, --restriction
Firmare, verificare, aggiornare--keyfile, --keyname, --keypwd, --sign, --verify, --update
Scegliere l’output--output, --format, --encoding, --xmldeclaration, --keyinfo, --logfile
Identificare un computer--hardwareid, --salt, --showhardwareinfo
Usare script e automazione--format json, --quiet, --strict-exit, --project, --makeproject

Ogni opzione è descritta nel Riferimento della riga di comando. Per le pipeline di CI e gli agenti AI, la modalità compatibile con l’AI trasforma l’output in un flusso JSON con versione e con codici di uscita semantici, e lic --help --format json descrive ogni opzione in una forma leggibile dalle macchine.

Fornire la licenza allo strumento

lic richiede una propria licenza di Babel Licensing. Cerca babel.licenses nella sua cartella di installazione, poi nel percorso contenuto nella variabile d’ambiente BABEL_LICENSE_PATH; l’opzione --license prevale su entrambi e indica un file, una cartella in cui cercare, oppure env:VARIABLE per una chiave di licenza conservata in una variabile d’ambiente. lic --license senza argomenti stampa la licenza in uso. Vedi Fornire la licenza allo strumento per la configurazione dello strumento dotnet.

In questa sezione

  • Babel Licensing Tool: installa lic come strumento dotnet globale o locale, forniscigli la licenza ed eseguilo su un server di build.
  • Riferimento della riga di comando: tutte le opzioni, raggruppate come in lic --help, con le coppie chiave-valore accettate da ogni restrizione.
  • Modalità CLI compatibile con l’AI: lo schema di output lic.cli.v1, --quiet, --strict-exit e la tabella dei codici di uscita.
  • Task MSBuild Lic: il task Lic in Babel.Build, le sue proprietà e il file di progetto .lcproj alla base di --project e --makeproject.
Last updated on