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_KEYis not set on the server or the license proxy, or the key is from a different organization.- The package cannot reach Reducto. See Firewalls.
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 throwsReductoLicenseError (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 throwsundelivered 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.