Offline activation
Support air-gapped sites with activation request files and license file import.
Required if your product is sold to sites without internet access. The product's admin screen offers two actions: Generate activation request and Import license file.
Flow
- The operator clicks Generate activation request. The product writes
<host>.req. - The operator sends the file to Digicom support.
- Digicom staff upload it in the Portcullis console. Portcullis checks the product, enforces
max_machines, records the machine (methodoffline), and returns a signed.licfile withmode: "offline"and the request's nonce echoed. Itsexpis normally the license end date. - The operator clicks Import license file. The product verifies it and stores it.
Request file
The .req file is the base64 encoding of this JSON (unsigned):
{
"v": 1,
"type": "activation_request",
"productCode": "omnifleet",
"fingerprint": "<64 hex chars>",
"nonce": "<random 16 bytes base64url, also stored locally as pending>",
"hostname": "omf-prod-01",
"platform": "linux-x64",
"productVersion": "3.4.0",
"createdAt": "2026-11-14T09:00:00Z",
"licenseKeyHint": "3ZC8D"
}- Store the nonce locally as the pending request nonce so you can match the returned file.
licenseKeyHintis optional: the last 5 characters of the license key, which helps Digicom find the right license.- Times are RFC 3339 UTC strings.
import { randomBytes } from 'node:crypto';
import os from 'node:os';
export function createActivationRequest(fingerprint: string, keyHint?: string): string {
const nonce = randomBytes(16).toString('base64url');
savePendingNonce(nonce); // persist in the data directory
const request = {
v: 1,
type: 'activation_request',
productCode: PRODUCT_CODE,
fingerprint,
nonce,
hostname: os.hostname(),
platform: `${process.platform}-${process.arch}`,
productVersion: PRODUCT_VERSION,
createdAt: new Date().toISOString(),
...(keyHint ? { licenseKeyHint: keyHint } : {}),
};
return Buffer.from(JSON.stringify(request), 'utf8').toString('base64');
}Importing a license file
Use the same verification as for online files, with the offline nonce rule:
- accept the file if
claims.noncematches the pending request nonce, or - accept it if it is for the same fingerprint and its
iatis newer than the stored file'siat.
The second rule allows offline renewal: Digicom can issue a new file for an existing offline machine without a new request (the fingerprint is already known). The operator just imports it.
After a successful import, store the file atomically, clear the pending nonce, and re-evaluate the state.
Deactivation
Offline machines are deactivated by Digicom staff in the console, on the customer's request.