Space and Time uses biscuits as a self-managing, self-expiring authorization key for accessing private data. Biscuits are created by the owner of a table, signed by the table's private key, so that the biscuit can be verified by the table itself (which holds its own public key).
TDLR; if you want to access private data, you're going to be attaching a biscuit to your request for authorization.
Fortunately, Space and Time Studio has built-in biscuit management, making it an ideal SQL editor for working in the Space and Time network!
If you are a table owner and want to create your own biscuits, check out this page on biscuits. Otherwise, this page assumes you've already been provided a biscuit to use by the table or schema owner.
Adding an existing biscuit to the Space and Time Studio is as simple as:
- Login to Space and Time Studio and click on "My Account" in the upper-right most corner, then "Account Settings" in the context menu.
- On the left panel, under the "Permissions" header, click on "Biscuits".
- The main pane will now show all your existing biscuits. You can see the biscuit name, and all resources (tables, views, etc.) enabled by that biscuit. If you want more detail, click the down-arrow to expand the record.
- Click on "Create Biscuit" at the top of the pane, which will open up a form with three fields. Two of the three data elements should have been provided for you already by the table owner:
- Biscuit Name - this is an arbitrary name to help you remember the biscuit's use. Give it a name you like!
- Biscuit Value - this is the biscuit key itself. A biscuit is Base64 encoded and usually quite long, anywhere from 100 to 500+ characters.
- Public Key - the public key for the private key used to create the biscuit. This Public key is an ED25519 standard, HEX encoded, and so always 64 characters long. This is used for verification purposes only (but is still required).
- Click Add and you're done! Hop over to the "Queries" tab and you should now have access to any resources the biscuit lists out. If it doesn't work immediately, refresh your browser.
|  |
👍
Congrats! You've just added a biscuit to Space and Time Studio!!!
