Air-Gapped License Activation

our concept for air gap license activations is similar to the offline activation process, with the added constraint that files cannot leave the private network after the licensable software has been installed/deployed only key based licenses can be activated as air gapped licenses for now general workflow for issuing & activating air gapped licenses add the air gapped api key to the client sdk create an air gapped license (either from a license policy or overriding an existing one) generate an initialization code with the license key from the air gapped portal enter the license key and initialization code in the client application generate an activation code using the sdk generate a confirmation code from the air gapped portal complete the activation process by entering the confirmation code in the sdk the air gapped activation portal can be found here airgap licensespring com https //airgap licensespring com/ contact us to white label the air gapped portal for your own subdomain! creating air gapped private/public keys the key pairs can be regenerated, however the new public key would need to be re entered into the sdk the air gapped public key should be obfuscated inside of the sdk the key algorithm used for air gap company account keys and air gap license keys is ecdsa you can find the air gapped private and public keys under "account settings" > "keys" this step is essential for air gapped licenses generating new key pair generated air gapped keys create a license policy for air gapped licenses on the product detail page, go to the license policies tab and click on the "add license policy" button to mark policy as air gapped switch the "set as air gapped" toggle air gap license policies cannot be edited or deleted after they are created the same is true for any air gapped license that has been issued setting license policy as air gapped issuing air gapped license keys through the vendor platform start the process as you would with any license click on the licenses tab in the left navigation > "issue licenses" when adding a product to the order, toggle "set as air gapped" all of the policies selectable from the drop down will only be the policies defined as air gapped setting licenses as air gapped the air gapped license is now created air gapped license details activating an air gapped license the air gap portal for license activation can be found at airgap licensespring com https //airgap licensespring com/ the process of activation is done in 3 steps including actions on server (portal) and sdk step 1 generate an initialization code from the air gap portal navigate to the air gap portal, and click "initialize air gapped activation", enter the license key initializing air gap activation the portal will return an initialization code which, along with the license key needs to be entered in the sdk there is a qr code available to make the process of copying this information easier initialization code { 	license key "gqxr 94ac qkak b4gp", initialization code "+48wk6fqiwamfcto6ru8yhix849wckilmbh149sn9yo=" } step 2 generate activation code from the sdk this initialization code must be imported to the sdk alongside with the license key the sdk will verify the initialization code and if successful will return the activation code , along with the hardware id values to the user so that user can take those strings back to the server step 3 generate confirmation code from the air gap portal on the air gap portal, click "enter air gapped activation code" enter the license key, hardware id , and activation code entering air gap activation code pop up to enter activation code the portal will return a policy id and a confirmation code, as well as a qr code to make it easy to copy/paste this information at this point, licensespring will consider this license has been fully activated, even if the confirmation code and policy id were not entered into the client application important if incorrect data (e g , an invalid policyfilepath) is entered into the client application during the confirmation step, the licensespring sdk will throw an error, and no local license file will be created on the device however, the license will still appear as "active" in the licensespring portal because the server cannot verify the device's state in an air gapped environment to prevent losing a license due to such errors, we recommend saving the qr code or json data provided during the confirmation step this allows users to re enter the correct data in the client application if the first attempt fails double checking all inputs (license key, policy file path, activation code) before proceeding with the activation process in the sdk final pop up confirming activation enter this information into the client application, and the activation process should be complete! airgap deactivation follows the same flow, you just need to toggle the initial view to deactivation airgap deactivation frequently asked questions 1\ what happens if the activation process fails on the end device? if an air gapped license activation fails on the device (e g , due to an incorrect policyfilepath or confirmation code), the sdk will throw an error, and no local license file will be created however, the license will still appear as "active" in the licensespring portal this behavior is due to the offline nature of the device and the inability of the server to validate the device's state ensure all inputs are correct before submitting the activation request 2\ can i reset or reuse a license that failed to activate locally? currently, licenses marked as "active" in the licensespring portal cannot be reactivated unless they are deactivated first for this reason, it is critical to safeguard the json data or qr code provided during the activation process so you can re enter it into the client application if an error occurs