Core concepts
Products and environments
A product is one app you sell. Each product has a sandbox environment for testing and a production environment for real customers. They are separate: nothing in the sandbox affects production.
Policies
A policy sets the rules for new licences of a product:
- Installation limit: how many devices one licence may be active on, from 1 to 100.
- Trial: 1 to 90 days (default 14, set by the policy), counted from the original start. A trial cannot be extended or restarted, and its offline grants never outlive it.
- Offline days: how long a paid licence keeps working without contacting the server, up to 21 days.
A new policy version applies to new licences only; existing licences keep the rules they were issued under.
Licences and licence keys
A licence is the right to use a product, with a paid-through date. A licence key is a secret string you give your customer so they can activate the licence in your app. Treat keys like passwords: keep them out of URLs and logs.
Installations
Activating a licence on a device creates an installation, which uses one slot of the installation limit. Releasing the installation frees the slot, for example when a customer moves to a new computer.
Signed offline grants
When an app activates or refreshes, PermitPlane returns a signed grant that the app verifies on the device. Offline access ends at the earlier of the policy's offline cap and the licence's paid-through date. If the device clock looks wrong, the app must check online again; it never silently extends access.
Entitlements
Entitlements say what a licence unlocks. They are boolean features (on or off), numeric limits, or explicitly unlimited, and your app reads them from the verified grant.