website logo
⌘K
Getting Started
Introduction
Basic Concepts
Opening an Account
Creating & Configuring Products
Integrating SDK and Configuring License Fulfillment
Activate a Key-Based License
Vendor Platform
Issuing New Licenses
License Detail View
Order Detail View
Customer Detail View
Metadata
Analytics
Settings
Product Configuration
Product Features
Product Custom Fields
Product Versioning
License Policies
Product Bundles
License Entitlements
License Types
Activations & Device Transfers
Features
Custom Fields
License Start Date
License Note
Maintenance Period
Trial Licenses
Floating Licenses
License Activation Types
Portals
End-User Portal
Offline Portal
Air-Gapped Portal
License API
License API Authorization
License Activation/Deactivation
License Check
Consumption
Floating
Trial Key
Product Details
Device Variables
Changing Password
Management API
Making API Requests
Management API Authorization
Customer
Product
Order
License
Device
Analytics
SDKs
Tutorials
.NET/C# SDK
.NET/C# Management SDK
C++ SDK
Java SDK
Python SDK
Go SDK
Delphi SDK
Swift/Objective-C SDK
Android SDK
Unity SDK
Errors and Response Codes
Floating Server
API Reference
Deployment
Configuration
Floating Server UI
Securing the Server
Whitelabeling
FAQ
Floating Server Changelog
Integrations
Salesforce
FastSpring
Stripe
Shopify
Common Scenarios
Single Sign On (SSO)
Glossary
General
SDK Glossary
Vendor Platform
Product Configuration Glossary
License Configuration
Postman Collections
Frequently Asked Questions
Changelog
License API changelog
Platform changelog
Docs powered by
Archbee
Product Configuration
License Policies

Air-Gapped License Policy

8min

Air-gapped licenses allow ISVs to node-lock licenses on computers in air-gapped environments, where files are not allowed to leave the network once the software application has been deployed.

Instead, the software is deployed alongside license policy files, which can then be selected, and node-locked through a series of code exchanges (instead of http requests or file exchanges).

Creating Air-Gap License Policies:

On the product page ( saas.licensespring.com/{companyID}/products/{productID} ) go to license policies tab and click on a add license policy button.

To mark policy as air-gapped switch the set as air-gapped switcher under the title to true.

Setting Policy as Air-Gapped
Setting Policy as Air-Gapped


Creating Air-Gapped License Files

You can either download the license file from the product license policy, or, if a license was set as "air-gapped", you can download the license policy file from the license detail page.

Locating Air-Gap License Policy
Locating Air-Gap License Policy

Download License Policy File
Download License Policy File


Activating an Air-Gapped License

The air-gap portal for license activation is available on this public URL: airgap.licensespring.com

Process of activation is done in 4 steps including actions on server (portal) and SDK:

Step 1: Generate an Initialization Code

To start the license activation process, the user needs to enter the license key on the portal to initialize the air-gap license activation. This will create a one-time initialization code.

Initialize Air-Gap Activation
Initialize Air-Gap Activation

Initialization Code
Initialization Code


The initialization code needs to be imported to the SDK alongside with the license key. The SDK will verify the initialization code and return the activation code and hardware_id.

The initialization will generate a QR code containing the JSON with a license_key and an initialization_code included. This can help and remove the need for copy pasting or manually entering the codes.

Step 2: Generate Confirmation Code

When attempting to activate an air-gapped license, the SDK should be configured to activate activate an Air-gapped license. It will accept the license_key as well as the initialization_code and return the hardware_id as well as an activation code along with the license key. Go back to the air-gapped portal and click on "Enter air-gap activation code" and enter them in order to receive a confirmation code.

Entering Air-Gap Activation Code
Entering Air-Gap Activation Code

Entering Air-Gap Activation Code Pop-up
Entering Air-Gap Activation Code Pop-up

License Has Been Activated Pop-up
License Has Been Activated Pop-up


The license key, hardware ID, policy ID and this new signature confirmation code need to be input into the SDK. The SDK validates the code using company account public air-gap key which is also previously embedded in to the SDK. If successful, the SDK will use the policy ID to retrieve the license entitlements and use this as a local license file.

Generated QR code contains the JSON with license_key, hardware_id, policy_id and confirmation_code included which you can scan and then send or save. This can help and remove the need for manually copy pasting the codes.

Updated 05 Sep 2023
Did this page help you?
PREVIOUS
License Policies
NEXT
Product Bundles
Docs powered by
Archbee
TABLE OF CONTENTS
Creating Air-Gap License Policies:
Creating Air-Gapped License Files
Activating an Air-Gapped License
Step 1: Generate an Initialization Code
Step 2: Generate Confirmation Code
Docs powered by
Archbee