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
- Digicom issues a license to a customer for a product and gives the customer a license key.
- 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.
- 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.
- 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
Product engineers
Digicom developers adding licensing to a product over the REST client API.
Customer IT operators
People installing and running a Digicom product on-prem: activation, moving servers, troubleshooting.
Concepts
Licenses, entitlements, machines, fingerprints, leases and grace.
Reference
Client API, license file format and error codes.
Glossary
| Term | Meaning |
|---|---|
| Product | Any Digicom software product that can be licensed. OmniFleet is used as the running example. |
| Feature | A named capability or limit a product understands (module.trips, limit.vehicles). |
| Entitlement | A feature's value on a specific license (limit.vehicles = 500). |
| License | A customer's right to run a product, with policy, entitlements and a key. |
| License key | Human-enterable secret identifying a license, used for online activation. |
| Machine | One activated installation of a product, identified by a fingerprint. |
| Fingerprint | Stable, product-salted SHA-256 of an installation ID. |
| License file | Signed document (Ed25519) granting a machine the license's entitlements until a date. |
| Lease | How long an online-issued license file is valid before a check-in must refresh it. |
| Grace | Extra time after lease or license expiry during which the product warns but still runs. |
| Check-in | Periodic online call that refreshes the license file and reports version and usage. |
| Activation request | File produced by an offline installation containing its fingerprint and a nonce. |
| Signing key / kid | Per-product Ed25519 key pair; the kid identifies which key signed a file. |