Skip to main content
The package checks your license with Reducto. Reducto does not bill for checks. Two rules apply: one before the first document opens, and one after that.

Before the first document opens

A copy opens its first document only after Reducto answers that the license is good and that the Reducto API key belongs to the license’s organization. Opening a document (WordDocument.open, or a drop or file pick in the editor) waits up to 10 seconds for that answer. Without it, the open fails with ReductoLicenseError (unconfigured): “Your package isn’t configured properly.” This happens when:
  • The copy has no license: it was not installed with a Studio install token, and the server sets no REDUCTO_LICENSE.
  • REDUCTO_API_KEY is not set on the server or the license proxy, or the key is from a different organization.
  • The package cannot reach Reducto. See Firewalls.
A browser editor with no license proxy opens no document either: it fails with unproxied. See Set up. There is no offline start. The first open always needs a good answer.

After the first good check

The package checks again about every hour, in the background. Document calls do not wait for these checks. Each good check keeps the package working for 65 minutes. If a check gets no answer (offline, timeout, server error), the package keeps working until 65 minutes after the last good check. After that, each call on an open document throws ReductoLicenseError (unverified), and opening a document waits up to 10 seconds for a good answer, then fails with unconfigured. The package keeps trying, and it works again after the next good check. A document that is already open stops at its next call.

What an answer does

Usage reports

When a document starts a new Session, the package reports it to Reducto. If Reducto answers checks but does not confirm the report within 30 seconds, each call throws undelivered until a check confirms it. A short outage does not cause this: while no check gets an answer, the report waits.

Signed answers

Reducto signs each license answer. A proxy or another system on the network cannot change an answer or send an old one again.

Revoke a token or a license

For retry timing, request bodies and the limits on queued reports, see Check protocol.