.NET SDK Configuration and Usage

this guide will walk you through the step by step process of configuring your licensespring license using the licensespring net sdk as you advance through this tutorial, you'll gain the expertise to activate, deactivate, and verify licenses directly from your net application throughout this tutorial, functions and methods employed may throw exceptions to address potential issues for more information about these, see error handling docid 0tnmm6shdrcmlpx4tuoo configuration to initialize the sdk, you must fill in your application name and version, licensespring api key, shared key and product code both the api key and shared key can be found on your licensespring account under settings >keys api and shared key location your product code is located in your product list under "configure products" product code location please, keep in mind that the product code field is case sensitive when you have the necessary values, create the configuration as shown below var configuration = new licensespring configuration( apikey "api key", sharedkey "shared key", productcode "product short code", appname "app name", appversion "version"); // or use oauth instead of api keys oauthcredentials oauth = new oauthcredentials("client id", "client secret"); // don't forget to provide your cryptoprovider key if you will use the default crypto provider if you will provide your own icryptoprovider implementation you can skip this oauth cryptoproviderkey = "my secret crypto key "; configuration = new licensespring configuration( oauthcredentials oauth, productcode "product short code", appname "app name", appversion "version"); now you can initialize licensemanager using this configuration object var licensemanager = licensemanager getinstance(); licensemanager initialize(configuration); license activation the license keys are located in "licenses" section on the vendor platform license key location to implement user based licensing please refer to user based licensing docid\ xepx04m3oh f6s8ylf6mz to activate a license, create a licenseid using the given key and call activation method try { licenseid licenseid = licenseid fromkey( licensekey ); var license = licensemanager activatelicense( licenseid ); } catch( licenseactivationexception e ) { // } note activatelicense returns the activated license object if the activation is successful activatelicense can throw many different exceptions, for information on why they're thrown and how to handle them, see error handling docid 0tnmm6shdrcmlpx4tuoo invalidoperationexception can occur due to incorrect use of the activatelicense function this function has two overloads for a regular license activation, it takes only licenseid the overload that takes strings is used for sso for more information, see single sign on docid\ fwgt 4dz4ziewel1nosxq license deactivation deactivating a license unbinds the device from the license, and decrements the number of total activations depending on the license transfer policy, this usually means that the license is freed up to be activated onto a new device deactivating is done using the following method var isdeactivated = license deactivate(); note deactivate() has an optional boolean parameter that can be passed to determine whether the local license and folders created by the sdk should also be removed this parameter is false by default note deactivate() returns true if successfully deactivated and false otherwise it also returns true if the license is already inactive local license the local license is a copy of the license information that is saved on the end user's local computer users who have not activated the license on their end before will not have a local license by default, the local license is stored %userprofile%\appdata\local\licensespring\”product code”\license key see local license file docid\ fkfzhha n838tznrzu0sz for more information if a device already has a license, and you try to activate another license on that device, for the same product, that newly activated license will override the existing license, deleting it from the device this will be on the developer to make sure that they check if a license exists on the device before a new activation the current license can be retrieved with var currentlicense = licensemanager currentlicense(); note if no active license is available, currentlicense will be set to null license check it is recommended to perform a local license check at application start to confirm that the local license file belongs to the current device and has not been transferred a local license check is performed in the net sdk with license localcheck(); note it is also useful to check whether the local license file has been tampered with and whether the local license is still valid online license check refreshes the local license with the data from licensespring backend are done with var installationfile = license check(); this method also returns the most recent installationfile available for the license which can be useful for managing software updates for more information about managing software updates, see handling product versions docid\ zvfcf4 5cq4uj4dnsovbb you can also check for active, valid, enabled, and expired licenses using isactive , isvalid , isenabled , and isexpired methods respectively note that an active license does not necessarily mean a license is valid a valid license means the license is active, enabled, and not expired an active license means that the license is bound to a device, but may also be disabled or expired full code sample below you can find a code sample that initializes the sdk, retrieves a local license or activates a new one, and performs the necessary checks var configuration = new licensespring configuration( apikey "api key", sharedkey "shared key", productcode "product short code", appname "app name", appversion "version"); try { var licensemanager = licensemanager getinstance(); licensemanager initialize(configuration); var currentlicense = licensemanager currentlicense(); if( currentlicense == null ) { licenseid licenseid = licenseid fromkey( licensekey ); currentlicense = licensemanager activatelicense( licenseid ); } currentlicense localcheck(); currentlicense check(); } catch (const licensespringexception& ex ) { console writeline("exception encountered"); }