Skip to Content
PortcullisDocs

What is Portcullis

Digicom's licensing server for products that customers run on their own infrastructure, online or air-gapped.

Portcullis is Digicom's licensing server for Digicom products that customers run on their own infrastructure (on-prem), whether those servers can reach the internet or are fully air-gapped. It decides:

  • who may run a product (which customer, which product),
  • how much they may use (number of installations, enabled modules, limits such as vehicles or users),
  • until when (contract end, trial end, maintenance end).

Digicom staff issue licenses after a contract is signed. Portcullis does not handle payments.

How it works

  1. Digicom issues a license to a customer for a product and gives the customer a license key.
  2. The product, installed at the customer's site, activates:
    • online, by sending the license key to Portcullis, or
    • offline, by exporting an activation request file that Digicom turns into a license file.
  3. The product receives a signed license file (Ed25519). It verifies the signature locally with a public key compiled into the product, so an edited file or a fake server cannot fool it.
  4. Online installations check in periodically to refresh the file and pick up renewals, upgrades or suspensions. If Portcullis cannot be reached, the product keeps running on its current file until the lease and grace period run out.

Fail open for honest customers, fail closed for forged data

Network trouble and server outages never stop a correctly licensed product within its lease and grace period. Invalid signatures always do. Restricted mode never deletes customer data.

Who these docs are for

Glossary

TermMeaning
ProductAny Digicom software product that can be licensed. OmniFleet is used as the running example.
FeatureA named capability or limit a product understands (module.trips, limit.vehicles).
EntitlementA feature's value on a specific license (limit.vehicles = 500).
LicenseA customer's right to run a product, with policy, entitlements and a key.
License keyHuman-enterable secret identifying a license, used for online activation.
MachineOne activated installation of a product, identified by a fingerprint.
FingerprintStable, product-salted SHA-256 of an installation ID.
License fileSigned document (Ed25519) granting a machine the license's entitlements until a date.
LeaseHow long an online-issued license file is valid before a check-in must refresh it.
GraceExtra time after lease or license expiry during which the product warns but still runs.
Check-inPeriodic online call that refreshes the license file and reports version and usage.
Activation requestFile produced by an offline installation containing its fingerprint and a nonce.
Signing key / kidPer-product Ed25519 key pair; the kid identifies which key signed a file.

On this page