Innehållsförteckning

Behörigheter: guide för administratörer

Den här guiden förklarar hur du som administratör styr vad användarna får se och göra i Orbiq: vilka menyer, vilka byggnader och vilka system (resurser). Behörigheterna styrs av grupper. Grupperna ger roller (vilka funktioner) samt behörighet till områden, objekt och resurser (vilka byggnader och system).

Du behöver tillgång till Administration → Användare, Administration → Objekt och översikt och Administration → Resurser.

Är du användare och undrar varför du ser, eller inte ser, något? Läs Vad ser jag i Orbiq, och varför?

I korthet

Vad användaren ser

Användarna kan inte själva se vilka grupper de är med i. Sidan Vad ser jag i Orbiq, och varför? förklarar för dem vad som styr det de ser och vad de ska be dig om. Länka gärna dit när användare frågar.

Begrepp

Begrepp Vad det är Var det administreras
Område En indelning av fastighetsbeståndet, till exempel en region eller ett förvaltningsområde. Områden kan ha underområden. Administration → Objekt och översikt → Områden
Objekt En byggnad eller fastighet. Ett objekt hör till ett eller flera områden. Administration → Objekt och översikt → Objekt
Resurs Ett system som öppnas från Orbiq, till exempel en DUC/PLC, ett styrsystem, ett passersystem eller en webbsida. Resursen kopplas till objekt och/eller områden. Administration → Resurser
Grupp En samling användare med samma behörigheter. Gruppen bestämmer roller, områden, objekt och resurser. Administration → Användare → Grupper
Roll En uppsättning rättigheter som avgör vilka funktioner användaren får använda och vad hen får göra i dem. Administration → Användare → Roller

Så hänger det ihop

flowchart LR U["Användare"] --> G["Grupp"] G --> R["Roller
(vilka funktioner och menyer)"] G --> A["Områden tillåtna att se"] G --> O["Objekt tillåtna att se"] G --> S["Resurser tillåtna att se
(resurslås)"] A -->|"alla byggnader i området
och dess underområden"| B["Byggnader användaren ser"] O --> B B -->|"resurser kopplade till byggnaden
eller dess område"| X["Resurser användaren når"] S -->|"krävs om resursen är låst"| X

Roller

Vad roller gör

En roll är en samling rättigheter. Rollerna avgör vilka funktioner och menyer användaren får använda, till exempel om menyn Översikt eller Larmhantering syns. De avgör också vad användaren får göra: om hen bara får titta eller också får ändra, till exempel kvittera och blockera larm, spara paneler eller redigera objekt. Rollerna avgör därmed också om användaren ser några byggnader och resurser alls. Vilka byggnader och resurser användaren ser styrs sedan av gruppens områden, objekt och resurser.

Rollerna och grupperna samverkar alltså. Användaren behöver både roller som ger tillgång till funktionen (till exempel Översikt) och grupper som ger behörighet till byggnaderna.

Roller ges alltid till en grupp. Det går inte att ge en roll direkt till en användare. Alla medlemmar i gruppen får gruppens roller.

Rollerna administreras under Administration → Användare → Roller. En roll kan ärva rättigheter från andra roller (kolumnen Ärver rättigheter från). I bilden nedan ärver iqalarm_user alla rättigheter från basic_user.

Rollistan

Öppna en roll för att se dess Rättigheter och vilka roller den ärver från:

Rollen iqbuilding_user

Standardrollerna

I en standardinstallation av Orbiq finns de här rollerna. Er installation kan ha fler eller anpassade roller.

Roll Ger
basic_user Grundläggande rättigheter som alla användare behöver. Ingår i de flesta andra roller.
iqbuilding_user Menyn Översikt: kartan, objektlistan och byggnadsportalerna.
iqalarm_user Menyn Larmhantering: se, kvittera och blockera larm. Behövs också för att resurserna i byggnadsportalen ska visas.
iqanalysis_user Spara paneler och diagram i analysverktyget.
…_publisher Rättighet att skapa och ändra innehåll inom respektive del, till exempel spara ändringar på objekt (iqbuilding_publisher).
…_admin Administrationsmenyerna för respektive del, till exempel Objekt och översikt eller Resurser. Se även nedan.
superadmin Alla administratörsroller.

Viktigt om administratörsroller

Tänk på standardgruppen basic_user_group

Gruppen basic_user_group har från start Alla under både Områden tillåtna att se och Objekt tillåtna att se. Den som läggs i den gruppen ser alltså alla byggnader. Använd den inte för användare som ska ha begränsad åtkomst.

Områden

Hur områden fungerar

Områden delar in fastighetsbeståndet. Ett område kan ha ett överordnat område, så att det bildas en hierarki. I exemplet nedan är Söder och Norr underområden till Region Stockholm. Under Administration → Objekt och översikt → Områden kan du växla mellan Lista och Hierarki.

Områdeshierarki

Ge en grupp åtkomst till ett område

  1. Gå till Administration → Användare → Grupper och öppna gruppen.
  2. Under Områden tillåtna att se, välj området i listan Välj ett område och klicka på Lägg till.
  3. Klicka på Uppdatera.

Välj Alla i listan för att ge gruppen åtkomst till samtliga områden, även sådana som skapas senare.

Du kan i stället göra kopplingen från områdets sida: öppna området under Administration → Objekt och översikt → Områden och lägg till gruppen under Grupper. Det räcker att göra kopplingen på ett av ställena. Båda ändrar samma inställning, och kopplingen syns sedan på båda ställena.

Hur områden påverkar vad användaren ser

Objekt

Begränsa åtkomst till specifika objekt

Om en användare bara ska se enstaka byggnader ger du gruppen behörighet till just de objekten i stället för till ett område:

  1. Öppna gruppen under Administration → Användare → Grupper.
  2. Under Objekt tillåtna att se, välj objektet i listan Välj ett objekt och klicka på Lägg till. Upprepa för varje objekt.
  3. Klicka på Uppdatera.

Välj Alla i listan för att ge gruppen åtkomst till samtliga objekt.

Du kan i stället göra kopplingen från objektets sida. Det räcker att göra den på ett av ställena: båda ändrar samma inställning, och kopplingen syns sedan på båda ställena. Öppna objektet under Administration → Objekt och översikt → Objekt och lägg till gruppen under Grupper:

Grupper i objektformuläret

Hur objekt kopplas till områden och grupper

Användaren ser en byggnad om någon av användarens grupper har behörighet till

Vilket område ett objekt hör till anger du i objektets formulär under Överordnade områden.

Överordnade objekt

Objekt kan också ligga i en hierarki, till exempel en fastighet med flera byggnader. Det anger du i objektets formulär under Överordnat objekt. Listan visar bara objekt av en objekttyp som ligger en nivå högre i objekttypernas hierarki (Administration → Objekt och översikt → Objekttyper).

Behörighet till ett objekt ärvs nedåt till dess underordnade objekt. Den som har behörighet till fastigheten ser alltså också dess byggnader.

Resurser som sitter på ett underordnat objekt visas dock bara i byggnadsportalen för grupper som har behörighet till just det objektet eller dess område. Ska gruppen se resurserna, lägg till det underordnade objektet (eller området) i gruppen.

Resurser

Vad är en resurs?

Orbiq använder resurser som samlingsnamn för allt som kan öppnas från en byggnad: DUC/PLC, styr- och övervakningssystem, passersystem, webbsidor med mera. Resurser kan öppnas via länk, via Orbiqs proxy eller via fjärranslutning (RDP/VNC). Resurser administreras under Administration → Resurser.

Koppla resursen till objekt och områden

I resursens formulär, under fliken Bindings, anger du var resursen hör hemma:

Fliken Bindings i resursformuläret

Användare som har behörighet till byggnaden eller området ser resursen i byggnadsportalen.

En resurs som är kopplad till ett område visas i byggnadsportalerna för grupper som har behörighet till just det området eller ett överordnat område. Den visas inte via alternativet Alla under Områden tillåtna att se. Ska en sådan grupp se resursen, lägg till området (eller ett överordnat område) i gruppen.

Lås resursen till vissa grupper (resurslås)

Ibland ska bara en del av dem som ser byggnaden få öppna ett visst system. Då låser du resursen till en eller flera grupper. Det kan du göra på två ställen. Det räcker att göra det på ett av dem, eftersom båda ändrar samma inställning:

Resursen DUC Ljusgården är låst till två grupper

Regeln för åtkomst till en resurs

En användare kommer åt en resurs när båda villkoren nedan är uppfyllda:

  1. Byggnad eller område: användaren har behörighet till ett objekt eller område som resursen är kopplad till. Om resursen inte är kopplad till något objekt eller område gäller inte detta villkor.
  2. Resurslås: om resursen är låst till grupper måste användaren tillhöra någon av dem, eller en grupp med Alla resurser. Om resursen inte är låst gäller inte detta villkor.
Kopplad till byggnad/område Låst till grupper Vem kommer åt resursen?
Ja Nej Alla som har behörighet till byggnaden/området
Ja Ja De som har behörighet till byggnaden/området och tillhör en av de låsta grupperna (eller en grupp med Alla resurser)
Nej Ja De som tillhör en av de låsta grupperna (eller en grupp med Alla resurser)
Nej Nej Alla inloggade användare

Samma regel gäller när resursen öppnas via Orbiqs proxy och via fjärranslutning (RDP/VNC). En resurs som inte är kopplad till någon byggnad eller något område syns inte i någon byggnadsportal, men kan nås via proxy och fjärranslutning enligt tabellen.

Viktigt:

Skapa och hantera grupper

Skapa en ny grupp

  1. Gå till Administration → Användare och välj fliken Grupper.
  2. Klicka på nere i högra hörnet.
  3. Fyll i Namn och gärna en Beskrivning som förklarar vad gruppen ger åtkomst till.
  4. Under Roller, lägg till de roller som gruppen ska ha. Minst en roll krävs. För en vanlig användare som ska se byggnader och öppna resurser behövs i en standardinstallation basic_user, iqbuilding_user och iqalarm_user. Se Roller.
  5. Under Användare, lägg till de användare som ska ingå i gruppen.
  6. Lägg till behörigheter under Områden tillåtna att se, Objekt tillåtna att se och Resurser tillåtna att se.
  7. Klicka på Skapa.

Gruppformuläret

Koppla områden, objekt och resurser till en grupp

De tre sista avsnitten i gruppformuläret styr vad gruppens medlemmar ser:

Avsnitt Ger åtkomst till Alternativet ”Alla”
Områden tillåtna att se Alla byggnader i valda områden och deras underområden Alla: samtliga områden
Objekt tillåtna att se Valda byggnader Alla: samtliga objekt
Resurser tillåtna att se Gruppen läggs till i de valda resursernas lås (se Resurslås). Kräver fortfarande behörighet till byggnaden/området. Alla resurser: samtliga låsta resurser

Ta bort en koppling med papperskorgen och klicka på Uppdatera.

Tilldela användare en eller flera grupper

Det finns två sätt att lägga en användare i en grupp:

Grupper i användarformuläret

Om er organisation använder Microsoft Entra ID kan Orbiq hämta gruppmedlemskap därifrån. Synkroniseringen måste först aktiveras för er installation, så kontakta iQuest om ni vill använda den. När den är aktiverad kopplar du en Orbiq-grupp till en Entra-grupp så här:

  1. Markera Katalogmappning i gruppformuläret.
  2. Ange Entra-gruppens ID i Katalog ID.
  3. Markera Katalogen styr borttagning av grupper i Orbiq om användare också ska tas bort ur Orbiq-gruppen när de inte längre är med i Entra-gruppen. Annars läggs användare bara till.

Gruppens roller, områden, objekt och resurser ställer du fortfarande in i Orbiq.

När en användare tillhör flera grupper

Behörigheterna från alla grupper läggs ihop:

Därför kan man bygga behörigheter av små, tydliga grupper, till exempel en grupp per område och en grupp per leverantör, och kombinera dem per användare.

Praktiska exempel

Exemplen bygger på det här fastighetsbeståndet. Alla grupper i exemplen har rollerna basic_user, iqbuilding_user och iqalarm_user.

Område Objekt Resurser
Region Stockholm → Söder Kontorshuset Ljusgården DUC Ljusgården (låst till Ljusgården förvaltning och Drifttekniker Söder), Larmia styrsystem (låst till Leverantör Larmia)
Region Stockholm → Söder Lagerhuset Granen Ventilation Granen (inte låst)
Region Stockholm → Norr Skolan Björken Larmia styrsystem (låst till Leverantör Larmia)

Exempel 1: En användare som bara ska se en byggnad och dess resurser

Anna förvaltar Kontorshuset Ljusgården och ska inte se något annat.

Gruppen Ljusgården förvaltning:

Gruppen Ljusgården förvaltning

Resultat: Anna ser bara Kontorshuset Ljusgården och resursen DUC Ljusgården. Larmia styrsystem syns inte, eftersom den är låst till en annan grupp.

Annas vy

Exempel 2: En drifttekniker med åtkomst till flera byggnader i ett område

David är drifttekniker för alla byggnader i området Söder.

Gruppen Drifttekniker Söder:

Gruppen Drifttekniker Söder

Resultat: David ser Kontorshuset Ljusgården och Lagerhuset Granen, men inte Skolan Björken som ligger i Norr. Han når DUC Ljusgården (låst till hans grupp) och Ventilation Granen (inte låst). Byggnader som läggs till i Söder blir automatiskt synliga för honom.

Davids vy

Exempel 3: En extern leverantör som bara ska nå ett visst styrsystem

Lena arbetar hos leverantören av Larmia och ska bara kunna öppna Larmia styrsystem i de byggnader där det finns.

Gruppen Leverantör Larmia:

Gruppen Leverantör Larmia

Resultat: Lena ser de två byggnaderna, men bara resursen Larmia styrsystem. DUC Ljusgården syns inte för henne, eftersom den är låst till andra grupper.

Lenas vy

Tänk på:

Exempel 4: En administratör med åtkomst till alla områden, objekt och resurser

Adam ska kunna se och öppna allt.

Gruppen Alla behörigheter:

Gruppen Alla behörigheter

Resultat: Adam ser alla byggnader och alla resurser som är kopplade till byggnader, även låsta, och även byggnader och resurser som läggs till senare. Resurser som bara är kopplade till ett område ser han i byggnadsportalen först när områdena läggs till i gruppen, se Koppla resursen till objekt och områden.

Adams vy

Tänk på: Gruppen ovan ger inga administratörsrättigheter. Ska Adam också administrera Orbiq lägger du till administratörsroller. Behåll ändå gruppens områden, objekt och resurser. Administratörsrollerna ger nämligen ingen åtkomst via proxy eller fjärranslutning, se Viktigt om administratörsroller.

Felsökning

Problem Trolig orsak och åtgärd
Ett område, objekt, en resurs eller användare som du nyss skapat finns inte att välja i en lista Listorna hämtas när sidan laddas. Ladda om sidan (F5) och öppna formuläret igen.
Användaren ser inga menyer och kan inte använda Orbiq Användaren är inte med i någon grupp, eller grupperna saknar roller.
Menyn Översikt saknas Användarens grupper saknar en roll som ger Översikt, till exempel iqbuilding_user.
Användaren ser inga byggnader Användarens grupper saknar områden och objekt. Lägg till dem under Områden tillåtna att se eller Objekt tillåtna att se.
Översikt visar ”Visar 0 objekt” fast gruppen har områden eller objekt Kontrollera rättigheterna i användarens roller. Har någon roll rättigheten Använda listor behöver användaren också rättigheten Se listor (eller ingen av dem). I vissa versioner av Orbiq heter den ”See listor”.
Byggnadsportalen visar till exempel ”Resurser (1)” men listan är tom Användarens grupper saknar en roll med larmrättigheter, till exempel iqalarm_user.
Användaren ser byggnaden men inte resursen Resursen är låst till grupper som användaren inte tillhör. Lägg till användarens grupp under Rättigheter → Grupper i resursen. Kontrollera också att resursen är kopplad till byggnaden under Bindings.
Användaren är med i resursens grupp men ser ändå inte resursen Gruppen saknar behörighet till byggnaden eller området där resursen sitter. Lägg till objektet eller området i någon av användarens grupper.
Användaren ser resurser den inte borde se Resursen är inte låst. Lås den till de grupper som ska ha åtkomst. Kontrollera också om användaren är med i en grupp med Alla resurser, eller i basic_user_group.

Se även