CloudPDF
DocsPricing
Start building

Grants and tokens

Who opens the document decides how they get in. Ask one question: does your app know who they are?

  • No: anyone may open it. A reader of your website, a client you send a link, a visitor scanning a QR code. Make a grant in the dashboard.
  • Yes: they’re signed in to your app. Your server knows who they are and what they may see. Give them a token.
A grantA token
Who opens itAnyone with the link, or on your websiteOne of your signed-in users
Made byYou, in the dashboard (or your server)Your server, with an API key, for each user
Says who they areNo: everyone is a visitor, who may answer a few questionsYes: your user’s id and name
LastsUntil you pause or end it, or it expiresAs long as your server sets, then it makes the next
You change it byEditing it: every link and embed followsMaking the next token differently
Needs a serverNoYes: the route that makes tokens

Both end the same way#

Neither a grant nor a token is what the viewer keeps. When a document opens, CloudPDF gives the viewer a short pass for that one document, with the permissions you chose, and checks every page, search and change against it:

  • With a grant, the viewer trades the grant for the pass, and trades again before the pass runs out. Change the grant, and the next trade follows it.
  • With a token, the token is the pass. Your token function gives the viewer the next one before it runs out.

So permissions read the same everywhere: a grant’s Comment and a token with the Comment list in its scope are the same thing.

One document, both ways#

A document can have grants and tokens at the same time. The brochure on your website opens with a grant, and your sales team opens the same file in your app with tokens, with their own names on their comments. Ending the grant doesn’t touch the tokens, and the other way round.

Visitors and users#

A grant’s visitors are people CloudPDF remembers, but doesn’t know. Their browser keeps who they are between visits, so what they add stays theirs, and a grant can ask their name or email before they start. Visitors shows who came.

Your app’s users are people you know. The token carries their id and name, so everything they add says who added it, in your words.