WolfSuite Workspace · Documentation
Administer a hosted workspace
A hosted workspace has administrators and members. Administrators see every agent token and can delete the workspace; members manage their own tokens and the guests on their documents. 1 2 3
Sign-in
- People sign in with a link sent by email. Each link works once; a second use is refused and starts no session. 4
- An expired link is refused and starts no session. 5
- Asking for a link gives the same answer for an address with an account, one without and one that is disabled, so the page does not reveal who has an account. Only the address with an active account is sent an email. 6
- Signing out clears the session cookie and ends the session. 7
- Disabling an account ends its sessions for good. After it is enabled again, the person needs a new sign-in link. 8
Agent tokens
An administrator sees every agent token on the account. A member sees only its own. 1
Token names are unique among the tokens that are not revoked. Revoking a token frees its name. 9
An agent can connect with a device code: it is told the code to show the person, where to send them and how long the code lasts. 10
Guests on a document
A member sees the guests on a document with each guest's id, address, name and the date they were added, and the most guests a document takes. Guests, visitors and agent tokens do not see the list. 3 11
Removing a guest takes effect at once: the guest's session and its agent stop working. 12
Plan
Completing checkout moves the account to the plan paid for and ends the trial's clock. 13
A workspace over its plan limits becomes read-only: every change is refused with LICENSE_LIMIT, and the message names the reason and the way to upgrade. 14
Delete the workspace
- The account page offers deletion to an administrator. A member is refused with
NOT_OWNER. 2 - While a paid plan is in good standing, deletion is refused with
PLAN_RUNNINGand nothing is deleted. Cancel the plan first; once it has lapsed, the administrator can delete. 15 16 - An administrator's deletion takes effect at once. The workspace's backups expire 30 days later. 17
- A member, a disabled administrator and an administrator of another account are refused, and nothing is deleted. 18
- A workspace on a paid plan in good standing is never deleted automatically. 19
Evidence
Each numbered reference above points to the test that exercises the statement or to a recorded observation of the hosted service at workspace.wolfsdk.com. Test paths are relative to the WolfSuite repository.
- Test
sdk/web/packages/control-plane/test/account-routes.test.ts: “a member is told it sees its own tokens, an administrator that it sees every token” - Test
sdk/web/packages/control-plane/test/deletion-wiring.test.ts: “is offered to an administrator and not to a member, who is refused NOT_OWNER” - Test
sdk/web/packages/control-plane/test/guests.test.ts: “is shown to a member with each guest's id, address, name and date, and the most a document takes” - Test
sdk/web/packages/control-plane/test/hosted-accounts.test.ts: “signs the account in once: the second use is refused and sets no session” - Test
sdk/web/packages/control-plane/test/hosted-accounts.test.ts: “is refused once it has expired, and it sets no session” - Test
sdk/web/packages/control-plane/test/hosted-accounts.test.ts: “gets the same answer for an address with an account, one without, and one that is disabled, and only the first is mailed” - Test
sdk/web/packages/control-plane/test/hosted-accounts.test.ts: “ends at sign-out: the cookie is cleared and the session no longer works” - Test
sdk/web/packages/control-plane/test/hosted-accounts.test.ts: “ends for good when the account is disabled, and a new link is needed after it is enabled” - Test
sdk/web/packages/control-plane/test/agent-tokens.test.ts: “is unique among the customer's tokens that are not revoked, and free again once revoked” - Test
sdk/web/packages/control-plane/test/connect.test.ts: “is told the code to show and where to send the person, and the time it has” - Test
sdk/web/packages/control-plane/test/guests.test.ts: “is not shown to a guest, to a visitor, to an agent token or to a request that names no document” - Test
sdk/web/packages/control-plane/test/guests.test.ts: “takes the guest out at once: its session and its agent stop working, and a member gets no content back” - Test
sdk/web/packages/control-plane/test/billing.test.ts: “a checkout puts the customer on the plan it paid for and ends the trial's clock” - Test
sdk/web/packages/server/test/read-only.test.ts: “is LICENSE_LIMIT with a stable reason, and a message with the reason and the upgrade path verbatim” - Test
sdk/web/packages/control-plane/test/deletion-wiring.test.ts: “shows the PLAN_RUNNING refusal on the page while a paid plan runs, and deletes nothing” - Test
sdk/web/packages/control-plane/test/deletion.test.ts: “a paid plan in good standing is cancelled first; once it lapsed the owner can delete” - Test
sdk/web/packages/control-plane/test/deletion.test.ts: “an active admin deletes the workspace at once; its backups expire 30 days later” - Test
sdk/web/packages/control-plane/test/deletion.test.ts: “a member, a disabled admin, another customer's admin and an unknown customer are refused, and nothing is deleted” - Test
sdk/web/packages/control-plane/test/deletion.test.ts: “a workspace on a paid plan in good standing is never deleted”