Air-Gapped Licensing

11min
﻿Air gap licensing is a useful feature for isolated environments. The concept is similar to offline license management. 
The main difference is that in regular offline activation we exchange files and and in air-gapped environments we cannot use files so we have to rely on exchanging strings.
In this guide you will find the instructions for implementing air-gap licensing using LicenseSpring SDK.
Prerequisites
Completed the Getting Started﻿ Tutorial, specifically:
Initialized LicenseManager (or LicenseHandler) with your configuration using the appropriate settings.
Activated a key-based license of any type.
Air-Gap Configuration
The air-gap public key is necessary to verify the confirmation code obtained from the air-gap activation portal. The public key can be found on the LicenseSpring portal under Settings->Keys. 
﻿
If the air-gap public key is not set correctly in the configuration, the activation process will raise an AirGapActivationException with the message "Confirmation code is invalid."
To set the air-gap public key in the configuration use:
C++
C#
Swift
Python
from licensespring.licensefile.config import Configuration

conf = Configuration(product="your_product_key",api_key="your_api_key",
                   shared_key="your_shared_key",file_key=key,file_iv=iv,
                   is_guard_file_enabled=True,
                   air_gap_public_key="your_air_gap_public_key")
from licensespring.licensefile.config import Configuration

conf = Configuration(product="your_product_key",api_key="your_api_key",
                   shared_key="your_shared_key",file_key=key,file_iv=iv,
                   is_guard_file_enabled=True,
                   air_gap_public_key="your_air_gap_public_key")
﻿
To secure the air-gap activation, make sure that guard file option is not set to false. This feature is enabled by default and ensures that the license will not be activated multiple times with the same data, enhancing security and reliability. 
C++
C#
ExtendedOptions.ProtectOfflineActivation = true;
ExtendedOptions.ProtectOfflineActivation = true;
﻿
License Activation
To activate a license, follow these steps:
Open the air-gap activation portal and enter the license key. It will display the key and initialization code. 
﻿
﻿
Use the GetAirGapActivationCode method to get the activation code, passing the key and initialization code as parameters. Additionally, retrieve the hardware ID from the SDK configuration.
C++
C#
Swift
Python
from licensespring.hardware import HardwareIdProvider
from licensespring.licensefile.license_manager import LicenseManager

initialization_code = "Q/MWfwp1NWAYARl8Q7KSo5Cg2YKqS2QLlnQ3nEeSBsk="
license_key = "UFF3-E9GA-VUJQ-GMLK"

manager = LicenseManager(conf)
activation_code = manager.get_air_gap_activation_code(initialization_code=initialization_code, license_key=license_key)

print("Activation code:",activation_code)
print("hardware id:",HardwareIdProvider().get_id())
from licensespring.hardware import HardwareIdProvider
from licensespring.licensefile.license_manager import LicenseManager

initialization_code = "Q/MWfwp1NWAYARl8Q7KSo5Cg2YKqS2QLlnQ3nEeSBsk="
license_key = "UFF3-E9GA-VUJQ-GMLK"

manager = LicenseManager(conf)
activation_code = manager.get_air_gap_activation_code(initialization_code=initialization_code, license_key=license_key)

print("Activation code:",activation_code)
print("hardware id:",HardwareIdProvider().get_id())
﻿
Enter the license key, hardware ID, and activation code in the activation portal. It will provide the policy ID and confirmation code and make the license active on the platform.
﻿
﻿
Download the policy file from the licensing platform.
﻿
Use the ActivateAirGapLicense method, passing the policy ID, key, confirmation code, and the path to the policy file or the location of multiple policy files. This will activate the license on the device.
C++
C#
Swift
Python
confirmation = "ERbQBuE8giIjqMPj972Skipehqn0szQ8TH56INyo3OdtMHO1SuTVsoCOSnJWB6rml98PJ6SjybTPymOVZTG4hQ=="
policy_id = "998"
license_key = "UFF3-E9GA-VUJQ-GMLK"
policy_path = "path_to_air_lic"

manager = LicenseManager(conf)
license = manager.activate_air_gap_license(
                confirmation_code=confirmation, policy_path=policy_path, license_key=license_key, policy_id=policy_id
            )
confirmation = "ERbQBuE8giIjqMPj972Skipehqn0szQ8TH56INyo3OdtMHO1SuTVsoCOSnJWB6rml98PJ6SjybTPymOVZTG4hQ=="
policy_id = "998"
license_key = "UFF3-E9GA-VUJQ-GMLK"
policy_path = "path_to_air_lic"

manager = LicenseManager(conf)
license = manager.activate_air_gap_license(
                confirmation_code=confirmation, policy_path=policy_path, license_key=license_key, policy_id=policy_id
            )
﻿
Air-Gap license fields
License data contains the information if the license was activated using air-gap approach and the license policy id, 
To get the corresponding fields use:
C++
C#
Swift
Python
print("is air gapped:",license.is_air_gapped())
print("policy id:",license.policy_id())
print("is air gapped:",license.is_air_gapped())
print("policy id:",license.policy_id())
﻿
License deactivation
The air-gap deactivation process is similar to the air-gap activation. It contains the following steps:
Open the air-gap activation portal and switch to license deactivation. Enter the license key, it will display the key and initialization code. 
﻿
﻿
Use the GetAirGapDeactivationCode method to get the deactivation code, passing the key and initialization code as parameters. Additionally, retrieve the hardware ID from the SDK configuration.
C++
C#
Python
deactivation_code = license.get_deactivation_code(initialization_code)

print("Deactivation code:",deactivation_code)
print("hardware id:",HardwareIdProvider().get_id())
deactivation_code = license.get_deactivation_code(initialization_code)

print("Deactivation code:",deactivation_code)
print("hardware id:",HardwareIdProvider().get_id())
﻿
Enter the license key, hardware ID, and deactivation code in the activation portal. It will provide the confirmation code and make the license inactive on the platform.
﻿
﻿
Use the DectivateAirGapLicense method, passing the confirmation code. This will deactivate the license on the device and remove the local license file.
C++
C#
Python
confirmation_code="your_confirmation_code"
license.deactivate_air_gap(confirmation_code)
confirmation_code="your_confirmation_code"
license.deactivate_air_gap(confirmation_code)
﻿
Errors
During air-gap activation, various exceptions may occur, including those encountered during regular activation. Additionally, in .NET, not all versions are supported. In such cases, a LicenseSpringException with the message "Air gap feature is not supported on .NET Framework 3.5-4.6" may be thrown. 
AirGapActivationException can be thrown during license activation and deactivation in case confirmation code verification failed.
User-Based Licensing
License Type Options