Organisaties beheren in de console¶
Het concept achter organisaties staat in Organisaties en klanten.
Op het scherm Organisaties maak je een organisatie voor een klant aan, vind je een organisatie, controleer je haar status en open je haar instellingen. Je gebruikt het wanneer je een nieuwe klant inricht, en wanneer je een bestaande organisatie wilt verwijderen. Opschorten doe je op de instellingen van de organisatie.
Je hebt een beheerdersaccount nodig. Een organisatie aanmaken kan onder elke organisatie die je beheert; een hoofdorganisatie maakt je operator aan. Hetzelfde doe je met een sleutel in Organisaties beheren via de API.
Je ziet de organisaties die je beheert en alles wat daaronder valt. Selecteer een naam om de organisatie te openen. De zijbalk wordt dan de navigatie van die organisatie; met de keuzelijst boven de onderdelen wissel je van organisatie. Het paneel heeft een zoekveld dat op naam zoekt over al je organisaties, ook die je nog niet had opengeklapt, en Alle organisaties brengt je terug naar dit scherm.
Ben je operator, dan staat bij één rij Operatororganisatie: de eigen supportorganisatie van het platform, waarvan de agents de logs van elke organisatie lezen. Alleen operators zien en openen hem; voor elke andere beheerder bestaat hij niet.
De boom¶
Een organisatie kan onder een andere hangen. De tabel toont dat: onderliggende organisaties staan ingesprongen onder hun bovenliggende, en een rij met organisaties eronder krijgt een pijltje om die in of uit te klappen en zegt hoeveel er direct onder hangen. Onderliggende rijen hebben een lichte achtergrond en een vertakkingsicoon in plaats van het gebouw. Zodra je zoekt of filtert wordt de lijst vlak — dan staat onder elke naam wat erboven hangt, want een boom van alleen de gevonden rijen klopt niet meer. Vanaf het overzicht van een organisatie kom je met het aantal Onderliggende organisaties op dezelfde lijst, beperkt tot die tak.
Organisatiegegevens¶
| Kolom | Wat die zegt |
|---|---|
| Organisatie | de naam, hoeveel organisaties er direct onder hangen, en het tenant-id waar haar sleutels bij horen |
| Isolatie | hoe haar rijen gescheiden worden, Gedeeld of Schema. Wordt bij het aanmaken gekozen en nooit meer gewijzigd |
| Status | Actief, Opgeschort, Wordt ingericht of Wordt verwijderd |
| Capabilities | het plafond voor elke sleutel die ze heeft: Volledig plafond als ze elke capability mag geven, anders hoeveel van het totaal, met een balkje. Wijs de cel aan voor de capability-id's, zoals Core ze noemt |
| Aangemaakt | de datum waarop ze is aangemaakt |
In een smaller venster toont de lijst minder kolommen (eerst vervallen Isolatie en Aangemaakt, daarna Capabilities); de eigen pagina van een organisatie toont ze altijd.
De eigen pagina van een organisatie zegt ook op welke database ze leeft — de eigen database van Core, of een eigen database — een apart gegeven van de isolatie: een organisatie kan elke isolatie kiezen op de eigen database van Core, of op een eigen database, en een onderliggende organisatie leeft standaard op dezelfde database als haar bovenliggende, tenzij een operator haar een eigen database gaf.
Zoek op naam of id, kies een statusknop of filter op isolatie. Elke knop toont hoeveel organisaties die status hebben. Alle organisaties worden in één keer geladen; de regel onder de tabel zegt hoeveel organisaties de lijst bevat, ook die in ingeklapte takken, en hoeveel daarvan hoofdorganisaties zijn.
Op een telefoon wordt de tabel een lijst kaarten met naam, status en isolatie, en schuiven de statusknoppen zijdelings.
Organisatiestatus¶
| Status | Een sleutel van deze organisatie krijgt |
|---|---|
| Actief | gewone antwoorden |
| Opgeschort | een weigering, tot de organisatie weer geactiveerd is |
| Actief, onder een opgeschorte organisatie | een weigering, tot de organisatie erboven weer geactiveerd is |
| Wordt ingericht | "nog niet klaar" — probeer het zo opnieuw |
| Wordt verwijderd | "nog niet klaar"; en dat wordt het ook niet |
"Een weigering" is 403. "Nog niet klaar" is 409 met de detail The tenant is not ready. en
zonder header Retry-After, dus de aanroeper bepaalt zelf hoe lang hij wacht. Is een verwijderde
organisatie eenmaal weg, dan zijn haar sleutels ook weg en antwoorden ze 401, zoals elke sleutel
die Core niet kent.
Een nieuwe organisatie heeft even tijd nodig om gereed te worden. Je kunt tijdens het inrichten sleutels registreren. Ze werken zodra de status Actief is.
Een organisatie aanmaken¶
Kies Organisatie aanmaken, of in het rijmenu van een organisatie Onderliggende organisatie aanmaken — dan staat de bovenliggende organisatie al ingevuld. Vul verder in:
| Veld | Wat je invult |
|---|---|
| Naam | hoe ze hier heet |
| Bovenliggende organisatie | waaronder ze komt te hangen, gekozen uit de organisaties die je beheert. Een hoofdorganisatie -- een die onder niets hangt -- maakt Artific aan |
| Isolatie | Gedeeld of Schema. Kies je één keer, bij het aanmaken — later wijzigen kan niet. Elke organisatie kiest dit zelf, ongeacht wat haar bovenliggende koos |
| Database | kies je niet zelf: een organisatie leeft standaard op dezelfde database als haar bovenliggende, hier read-only getoond zodra je die kiest. Alleen je operator kan een organisatie een eigen database geven -- een hoofdorganisatie of een onderliggende -- en alles wat daaronder wordt aangemaakt neemt die dan op zijn beurt over. Verbindingsgegevens komen nooit in deze schermen |
| Toegestane capabilities | het plafond voor elke sleutel die deze organisatie krijgt. Later aan te passen |
Gebruik Gedeeld tenzij je organisatie een andere isolatie vereist.
Toegestane capabilities staat dichtgeklapt onderaan het formulier, en alles wat de nieuwe organisatie mag hebben staat al aan. Open het alleen om iets weg te halen; laat je het dicht, dan begint de organisatie met alles wat de organisatie erboven zelf mag aanzetten.
Je maakt zelf organisaties aan, onder een organisatie die je beheert, en kiest daarbij vrij tussen Gedeeld en Schema. Elke organisatie die je aanmaakt is een onderliggende, dus die leeft standaard op de database van haar bovenliggende; een hoofdorganisatie, en een eigen database noemen -- voor een hoofdorganisatie of voor een onderliggende -- zijn van je operator. Je kunt niet meer capabilities aanzetten dan de bovenliggende organisatie zelf mag.
Een organisatie verwijderen¶
Kies Verwijderen in het rijmenu en typ de organisatienaam ter bevestiging. Core blokkeert de sleutels en verwijdert de gegevens op de achtergrond. De beheerauditgeschiedenis blijft bewaard.
Zolang er nog een onderliggende organisatie bestaat, wordt verwijderen geweigerd; het venster blijft open en zegt waarom. Verwijder of verplaats eerst wat eronder hangt. Verwijderen doet de beheerder van de organisatie erboven, nooit de beheerder van de organisatie zelf; hangt er niets boven, vraag het dan je operator.
Bij een organisatie op een eigen database wordt de inhoud verwijderd, maar blijft de database zelf bestaan.
Verwijderen is definitief.
Verwijderde organisaties¶
Alleen voor operators. Naast Organisatie aanmaken opent de knop Verwijderde organisaties een overzicht van elke organisatie die is gewist en waarvan het verbruik nog wordt bewaard. Een rij toont de naam en het id van de organisatie, de organisatie waaronder ze hing, haar isolatie en database, wanneer ze is aangemaakt en verwijderd, haar tokens en kosten in euro over de hele looptijd, hoeveel verbruiksregels geen prijs hadden en de datum tot wanneer het verbruik wordt bewaard. Een juridische bewaarplicht ten tijde van het verwijderen is gemarkeerd, want die houdt het verbruik langer vast dan die datum.
Open een rij om het verbruik te zien zoals het grootboek het bewaart. De periodekeuze, de tegels en de uitsplitsing per soort, model en tool werken zoals in het onderdeel Gebruik van een organisatie. Er is geen cijfer voor opslag, traces, threads of berichten, geen tabel per persoon en geen sleutelfilter: die hoorden bij gegevens die zijn gewist, en het grootboek kent geen personen.
De pagina draagt de naam van de organisatie als titel, met het id eronder. Een onderdeel Juridische bewaarplicht laat zien of het verbruik van de organisatie onder een bewaarplicht valt, en Bewaarplicht instellen of Bewaarplicht opheffen wijzigt dat na een bevestiging. Een bewaarplicht houdt het verbruik vast na de bewaardatum totdat iemand haar opheft; bij opheffen wist de eerstvolgende bewaarronde wat de datum voorbij is. Het overzicht markeert een organisatie met bewaarplicht.