ISBLicenseServer 1.6.0

isb.connect.nuget

Bei dem Projekt handelt es sich um ein NuGet-Paket für .NET 6 oder höher. Mit dem Projekt lassen sich Lizenzen von isb.connect überprüfen und auswerten.

Lizenzserver der ISB Solutions GmbH

Das NuGet-Paket isb.connect.nuget stellt Klassen und Methoden zur Verfügung mit denen sich Lizenzabfragen durchführen lassen und mit denen man Lizenzen auswerten kann:

• Eine Lizenz kann schnell und einfach abgefragt und validiert werden
• Es ist möglich eine Lizenz vom Lizenzserver zu laden und dann mit den Lizenzinformationen zu arbeiten.

Benötigt wird dazu immer die Kundennummer (companyNumber) des Kunden und der Name des Produktes (appName), zu dem man die Lizenz abrufen möchte. <br> Mit diesen Lizenzen können die Anpassungen und Programme der ISB Solutions GmbH lizensiert werden.

Installation des NuGet-Pakets

Das NuGet-Paket kann, wie jedes NuGet-Paket, über Visual Studio heruntergeladen werden. <br> Dabei gibt es 2 Möglichkeiten:

Installation über die NuGet-Paketverwaltung

• Die NuGet-Paketverwaltung über “Projekt” im oberen Hauptmenü öffnen.
• Unter Durchsuchen nach „ISBLicenseServer“ suchen und das Paket installieren.

Installation über die Paket Manager Konsole

• Die Paket Manager Konsole über “Ansicht” im oberen Hauptmenü unter dem Unterpunkt „Andere Fenster“ öffnen.
• Das NuGet-Paket mit dem folgenden Befehl installieren:

Install-Package ISBLicenseServer

Anwendung

Mit dem Produkt isb.connect kann eine Lizenz zum einen abgefragt und geprüft werden und zum anderen kann die Lizenz vom Lizenzserver geladen und eingesehen werden. So ist es dann unteranderem möglich die Lizenzinformationen weiter zu verwenden.

Lizenz Prüfen / abfragen

Um eine Lizenz schnell und einfach abzufragen und zu validieren, gibt es die statische Methode "CheckLicense". Die Methode überprüft, ob eine Lizenz mit den übergebenen Werten ("CompanyNumber“ und "AppName“) existiert und gibt im Ergebnis einen Statuscode zurück. Die Bedeutung dieses Statuscodes kann im unteren Teil der ReadMe im Teilbereich „Lizenz validieren“ nachgelesen werden.

Bedeutung der Statuscods

var result = await License<LicenseItem>.CheckLicense("CompanyNumber", "AppName")

Lizenz laden

Mit der Methode "GetLicense" kann man eine Lizenz vom Lizenzserver laden, um dann mit den Lizenzinformationen weiter arbeiten zu können. Damit man die Methode benutzen kann muss man zuerst eine Instanz der Klasse „Licence“ erstellen. Anhand der mitgegebenen Werte ("CompanyNumber" und "AppName") werden dann die Lizenzinformationen ermittelt und im Ergebnis gespeichert.

var license = new License<LicenseItem>("CompanyNumber", "AppName");
var result = await license.GetLicense();

Lizenz validieren

Hat man bereits die Lizenzinformationen zu einer Lizenz geladen kann man die Lizenz mit der Methode "ValidateLicense" überprüfen und validieren. Dazu muss man der Methode die Lizenzinformationen mitgeben. Nach Ausführung der Methode kann man die folgenden Ergebnisse bekommen: <br>

var license = new License<LicenseItem>(companyNumber, appName);
var item = await license.GetLicense();
var result = license.ValidateLicense(item);

Klasse License

Um eine Instanz dieser Klasse "License" zu erstellen, muss man die Kundennummer (companyNumber) und den Namen des Programmes (appName), zu der man die Lizenzinformationen ermitteln möchte, beim Erstellen der Instanz mitgeben. Die Serverinformationen werden dabei vom NuGet verwaltet. Bei der Erstellung einer Instanz der Klasse kann auch eine andere URL zum Lizenzserver angegeben werden, dies ist aber optional und nur bei der Nutzung von mehreren Lizenzservern notwendig. Die Klasse verfügt über die Methoden "CheckLicense" und "ValidateLicense" zum Validieren und Überprüfen von Lizenzen und die Methode "GetLicense" um die Lizenzinformationen vom Lizenzserver zu laden.

Klasse LicenseItem

Die Klasse “LicenseItem“ wird zum Zwischenspeichern der Lizenzinformationen verwendet und wird beim Erstellen einer Instanz der Klasse "License" miterstellt. Zu jeder Lizenz werden die folgenden Informationen im “LicenseItem“ gespeichert:

• Die ID der Lizenz (handle)
• Den Lizenzschlüssel der Lizenz (key)
• Der Zeitpunkt des Abrufes der Lizenz (cacheTimestamp)
• Die Gültigkeit der Lizenz (validFrom)
• Die Laufzeit der Lizenz (ValidTo)
• Der Name und die Kundennummer des Kunden zu dem die Lizenz gehört (company)
• Der Name des Produkts zu dem die Lizenz gehört (app)