Componenti client

Per aggiungere Babel Licensing alle tue applicazioni e ai tuoi componenti .NET devi installare i componenti client di Babel Licensing. Comprendono il pacchetto NuGet Babel Licensing e il pacchetto NuGet Babel Data, a cui fai riferimento dai tuoi progetti per aggiungere le funzionalità di licenza. Questa pagina spiega come installare i componenti client e a che cosa serve ciascuno.

Pacchetti NuGet di Babel

Babel Licensing (edizioni Server e Data Center) è distribuito con i seguenti pacchetti NuGet:

Pacchetto	Descrizione
Babel.Licensing.Tool.x.y.z.nupkg	Strumento CLI dotnet di Babel Licensing
Babel.Licensing.x.y.z.nupkg	Libreria client di Babel Licensing
Babel.Data.x.y.z.nupkg	Componenti del database di Babel Licensing

Questi pacchetti NuGet non sono disponibili nel repository pubblico di NuGet. Per usarli nei tuoi progetti devi installarli nei tuoi feed NuGet privati o sul tuo computer.

Autenticazione con chiave utente su gRPC

Se la tua applicazione si autentica con la chiave utente (UserKey) di una licenza sul trasporto gRPC (quello predefinito per la maggior parte delle applicazioni client), aggiorna Babel.Licensing alla versione corrente del pacchetto. Le versioni precedenti a questa correzione inviano come nome utente di accesso un identificatore interno del client invece di lasciarlo vuoto, e un Babel Licensing Service in versione 11.7.0 o successiva lo rifiuta con “Invalid username or password”, sia per le chiavi utente esistenti sia per quelle appena generate. Il trasporto HTTP non è interessato.

Se hai molte applicazioni già distribuite e non puoi aggiornarle e ridistribuirle tutte subito, puoi configurare temporaneamente il Babel Licensing Service perché accetti il comportamento dei client precedenti. Vedi EnableLegacyUserKeyFallback in Configurazione > Application.

Sono disponibili diversi feed NuGet privati:

Se non hai un feed NuGet privato, puoi crearne uno sul tuo computer.

Che i tuoi pacchetti siano ospitati su un server o sul tuo computer, puoi accedervi con lo strumento CLI nuget o con Visual Studio .

Creare un feed NuGet locale con dotnet

Se hai installato Visual Studio o l’SDK dotnet, puoi accedere a NuGet direttamente dallo strumento CLI dotnet. Ora devi decidere dove conservare i pacchetti sul tuo computer. In questo esempio creiamo la cartella NuGet nella cartella Documenti dell’utente. Su Linux o macOS puoi creare la cartella nella cartella home dell’utente, ~/NuGet.

Puoi aggiungere i pacchetti al tuo feed locale con il comando dotnet nuget add.

Windows PowerShell o shell DOS:


dotnet nuget add Babel.Licensing.Tool.10.0.0.nupkg -Source %UserProfile%\Documents\NuGet

Linux o macOS:


dotnet nuget add Babel.Licensing.Tool.10.0.0.nupkg -Source ~/NuGet

Lo strumento dotnet dovrebbe segnalare che il pacchetto è stato aggiunto correttamente; da questo momento puoi accedere ai tuoi pacchetti tramite il comando dotnet.

Creare un feed NuGet locale con Visual Studio

Per installare il pacchetto NuGet sul tuo computer, segui questi passi:

Apri le impostazioni delle origini pacchetti

Apri Visual Studio e dal menu Tools seleziona Options. Nel pannello Options cerca NuGet e seleziona il nodo Package Sources sotto la voce NuGet Package Manager dell’albero.

Package Sources nelle opzioni di Visual Studio

Aggiungi l’origine pacchetti Babel

Premi il pulsante con l’icona del segno più, poi inserisci Babel nel campo Name e, nel campo Source, il percorso completo della cartella che contiene i file dei pacchetti NuGet di Babel. Premi il pulsante OK.

Installa il pacchetto Babel.Licensing

Per aggiungere il riferimento al pacchetto NuGet Babel.Licensing, in Solution Explorer fai clic con il pulsante destro sul tuo file di progetto. Seleziona Manage NuGet Packages…

Nella casella combinata Package source seleziona l’origine pacchetti Babel appena aggiunta, poi installa il pacchetto Babel.Licensing.

Gestione pacchetti NuGet di Visual Studio

Copia il file di licenza e ricompila

Copia il tuo file di licenza babel.licenses nella cartella della soluzione e ricompila la soluzione.

Installare lo strumento CLI Lic di Babel Licensing

Quando i pacchetti NuGet di Babel sono nel tuo repository NuGet locale, puoi installare gli strumenti CLI con il comando dotnet tool install.

Installa lo strumento CLI babel

Installa lo strumento CLI di Babel Obfuscator, babel:


dotnet tool install Babel.Obfuscator.Tool -g

Installa lo strumento CLI lic

Installa lo strumento CLI di Babel Licensing, lic:


dotnet tool install Babel.Licensing.Tool -g

Elenca gli strumenti installati

Per vedere le versioni degli strumenti dotnet installati, usa il comando seguente:


dotnet tool list -g
 
Package Id                 Version      Commands
------------------------------------------------
babel.licensing.tool       10.0.0       lic     
babel.obfuscator.tool      10.0.0       babel