Workspaces

Een workspace is de container voor alles wat je in SuperSpace doet. Je sites, domeinen, DNS-zones, back-ups, facturatie, en de mensen met wie je samenwerkt leven allemaal binnen een workspace. Je kunt bij meer dan één horen, en je schakelt tussen ze terwijl je werkt.

Workspace = account

"Workspace" is de naam die je in het dashboard ziet. Onder de motorkap — en in de Accounts API — heet hetzelfde een account, en een onderliggende workspace heet een sub-account. De twee termen verwijzen naar hetzelfde object, dus wees niet verbaasd als de API "account" gebruikt waar het dashboard "workspace" zegt.

Wat er in een workspace leeft

Vrijwel alles in SuperSpace behoort tot precies één workspace:

Sites — je WordPress-installaties.
Domeinen en DNS — de domeinen die aan die sites zijn gekoppeld en hun DNS-zones.
Facturatie — het abonnement, de betaalmethode en de facturen die de sites in de workspace betalen.
Mensen en rollen — de gebruikers die toegang hebben tot de workspace en wat elk van hen mag doen.
Contacten — het eigenaars-, facturatie- en technische contact dat voor de workspace is vastgelegd.

Omdat alles tot een workspace behoort, bepaalt de workspace waarin je je momenteel bevindt welke sites en domeinen je in de zijbalk ziet en naar welke facturatie je kijkt. Er is geen gecombineerde weergave van "alle workspaces tegelijk" — je werkt altijd binnen precies één actieve workspace tegelijk, en je schakelt om de andere te zien.

Je workspaces vinden

Om elke workspace te zien waar je bij hoort, open je de accountwisselaar in de zijbalk (de trigger toont de naam van je huidige workspace) en klik je op View All in het Workspaces-paneel dat verschijnt. Dit opent de volledige workspacelijst (met als kop Mijn workspaces), die elke workspace toont op Name naast Your Role daarin, en je laat doorklikken naar elk ervan.

Kolom	Wat het toont
Name	De workspacenaam. Sub-workspaces worden onder hun parent genest.
Your Role	De rol die je in die workspace hebt (bijvoorbeeld Workspace-admin). Een Inherited-badge betekent dat de rol op een parent-workspace is verleend en doorvloeit naar deze.
(actie)	Een Switch To Workspace-knop, of een Active Workspace-badge als het de workspace is waarin je je momenteel bevindt.

Om nog een top-level workspace aan te maken, klik je op New Workspace op deze pagina. (Om een sub-workspace aan te maken onder een workspace die je al beheert, gebruik je in plaats daarvan de Sub-Workspaces-kaart op de pagina van die workspace — zie Sub-workspaces.)

Schakelen tussen workspaces

Je kunt de actieve workspace vanaf twee plekken wijzigen:

De accountwisselaar in de zijbalk. De trigger van de wisselaar toont de naam van je huidige workspace. Wanneer je erop klikt, opent een paneel met als kop Workspaces dat je recente workspaces toont, met een Search workspaces…-veld om ze allemaal op naam te filteren en een View All-link naar de volledige lijst. Als een workspace sub-workspaces heeft, onthult eroverheen bewegen die kinderen in een tweede kolom zodat je direct naar een ervan kunt schakelen.
De pagina Mijn workspaces. Klik op Switch To Workspace naast een willekeurige workspace in de lijst.

Hoe dan ook bevestigt SuperSpace met een "Overgeschakeld naar <workspace name>"-bericht, en de zijbalk weerspiegelt dan de sites, domeinen en facturatie van de workspace waarin je terecht bent gekomen.

Dezelfde login, vele workspaces

Je logt één keer in. Schakelen tussen workspaces logt je niet uit en vereist geen tweede login — het verandert alleen naar welke sites en instellingen van een workspace je kijkt. Je rol kan van de ene workspace tot de andere verschillen, dus wat je mag doen kan veranderen terwijl je schakelt.

De workspacepagina (Instellingen)

Elke workspace heeft zijn eigen instellingenpagina, bereikbaar via Instellingen in de zijbalk. Het is de plek waar je de workspace zelf bekijkt en beheert in plaats van een enkele site. De pagina is georganiseerd in kaarten:

Contacts (subtitel Workspace Contact Details) — het Owner Contact, Billing Contact en Technical Contact dat is vastgelegd, plus eventuele andere contacten die je hebt toegevoegd.
Users (subtitel User Management and Access) — iedereen met toegang tot de workspace en hun rollen, met een Invite-knop om er meer toe te voegen (alleen admins).
Sub-Workspaces — workspaces die onder deze zijn genest, met een Create Sub-Workspace-knop (alleen admins). Het aanmaken van een sub-workspace die de parent beheert en betaalt is een resellerfunctie — zie Sub-workspaces en resellers.
Brands — alleen getoond op reseller-workspaces; behandelt white-label branding (zie Resellers).

Met de Edit-knop bovenaan de pagina kan een admin de workspace hernoemen en een aantal van de instellingen wijzigen, zoals de contacten en notificatie-webhooks.

Gebruikers en rollen in één oogopslag

Elke persoon in een workspace heeft daar precies één rol, en die rol bepaalt wat ze kunnen zien en doen. Dezelfde persoon kan een andere rol hebben in een andere workspace — admin zijn in de ene workspace maakt je niet overal admin.

SuperSpace heeft vijf ingebouwde rollen, van minste tot meeste toegang:

Rol	Waar het voor is
Facturatiemanager	Alleen-lezen op sites, plus leestoegang tot facturatie en prijzen. Goed voor een financieel contact dat facturen en kosten moet zien.
Site-viewer	Alleen sitedetails bekijken.
Site-manager	Sites bekijken en bewerken.
Site-admin	Alles wat een site-manager kan, plus sites aanmaken en verwijderen, en facturatie beheren.
Workspace-admin	Volledige controle: alles hierboven, plus gebruikers uitnodigen en beheren en sub-workspaces aanmaken.

Twee namen voor de hoogste rol

De krachtigste rol heet op sommige plekken Account Admin en op andere Workspace-admin — het is dezelfde rol. Alleen deze rol kan gebruikerstoegang beheren (mensen uitnodigen, rollen wijzigen, gebruikers verwijderen) en sub-workspaces aanmaken.

Mensen uitnodigen, hun rollen wijzigen en ze verwijderen zijn taken voor workspacebeheer in plaats van concepten — voor de stapsgewijze handleiding, zie Gebruikers uitnodigen en rollen beheren.

Overgeërfde rollen cascaderen naar beneden

Als een workspace sub-workspaces heeft, vloeit een rol die op de parent is verleend automatisch door naar de kinderen, waar hij wordt getoond met een Inherited-badge. Je wijzigt een overgeërfde rol op de parent waar hij is verleend, niet op het kind.

Sub-workspaces en resellers

Een workspace kan sub-workspaces bevatten — onderliggende workspaces die eronder zijn genest. Sub-workspaces zijn een reseller-functie: een reseller maakt er één per klant aan zodat de sites en facturatie van elke klant gescheiden blijven terwijl de reseller ze allemaal beheert. De parent-workspace moet een reseller zijn om sub-workspaces erdoorheen te laten factureren, dus als je workspace geen reseller is, krijg je niet het volledige sub-workspace-gedrag dat hier wordt beschreven.

Twee instellingen bepalen hoe een sub-workspace zich gedraagt:

Inherit Billing — aangeboden wanneer de parent een reseller is. Wanneer aan, wordt de sub-workspace aan zijn parent gefactureerd: de parent betaalt voor het gebruik van het kind, en mensen in de kind-workspace zien geen apart facturatiedashboard. Wanneer uit, heeft de sub-workspace zijn eigen betaalmethode en wordt hij onafhankelijk gefactureerd.
Overgeërfde rollen — zoals hierboven opgemerkt, cascadeert een rol op de parent naar het kind.

Reseller- en white-label-brandingfuncties worden in detail behandeld op de Resellers-pagina.

Trial-workspaces

Een workspace kan een trial zijn. Een trial-workspace is beperkt vergeleken met een betaalde — zo heeft hij geen facturatiedashboard, en word je gevraagd te upgraden voordat je facturatie kunt beheren of de functies kunt gebruiken die een trial niet bevat.

Een workspace verlaten

Als je geen toegang meer tot een workspace nodig hebt, kun je jezelf eruit verwijderen met de Leave Workspace-actie op je eigen rij in de Users-kaart. Een paar beveiligingen gelden:

Je kunt een workspace niet verlaten als je de enige overgebleven gebruiker bent, of als het de enige workspace is waar je bij hoort.
Je kunt niet vertrekken via een rol die is overgeërfd van een parent-workspace — die moet op de parent worden gewijzigd.

Verlaten verwijdert je toegang

Zodra je een workspace verlaat, verlies je de toegang ertoe, en een andere admin zou je opnieuw moeten uitnodigen om hem terug te krijgen. Een workspace verlaten verwijdert de workspace of zijn sites niet — het verwijdert alleen jou eruit.

Werken met workspaces vanuit de API

In de API is een workspace een account. De meeste account-scoped verzoeken nemen een X-Auth-Account-header die aangeeft op welke workspace het verzoek van toepassing is — het API-equivalent van de actieve workspace die je in het dashboard kiest. Om bijvoorbeeld elke workspace op te sommen die je credentials kunnen bereiken:

curl -H "Authorization: Bearer $SUPERSPACE_TOKEN" \
  https://control.superspace.nl/api/accounts

Endpoints voor accountbeheer (workspaces aanmaken, gebruikers beheren en dergelijke) zijn niet beschikbaar via OAuth — ze vereisen een sessie- of API-sleutel-credential. Zie de Accounts API voor de volledige request- en responsvormen.