Merge pull request #60 from statisticsnorway/change-dapla-team

Added chapter about Dapla Ctrl

dapla-manual/_quarto.yml

@@ -73,6 +73,9 @@ website:
           - text: 'DaplaHub (POC)'
             href: https://datahub.external.staging.ssb.cloud.nais.io/explore
             icon: database-fill
+          - text: 'Dapla Ctrl'
+            href: https://ctrl.dapla.ssb.no/
+            icon: controller
       - icon: github
         href: https://github.com/statisticsnorway/dapla-manual-internal
         aria-label: Dapla-manual GitHub repository
@@ -121,6 +124,7 @@ website:
             - statistikkere/dapla-pseudo.qmd
             - statistikkere/transfer-service.ipynb
             - statistikkere/statistikkbanken.qmd
+            - statistikkere/dapla-ctrl.qmd
         - section: "Appendix"
           href: statistikkere/dashboard.qmd
           contents:

dapla-manual/faq.qmd

@@ -140,4 +140,34 @@ Husk at det er kun [data-admins](./statistikkere/hva-er-dapla-team.html#data-adm
 
 ### Atlantis feiler når jeg skrur på en *feature*. Hva gjør jeg? 
 
-Når man skrur på en *[feature](./features.html)* på Dapla, så er det verktøyet **Atlantis** som ruller ut infrastrukturen på GCP. I mange tilfeller kan det hjelpe å skrive `atlantis plan` i kommentarfeltet til PR'en, slik at Atlantis får kjørt planen en gang til. Hvis den da ikke viser noen feil, så kan du skrive `atlantis apply` i kommentarfeltet og endringene vil bli effektuert. Får du fortsatt feilmeldinger etter å ha kjørt `atlantis plan` på nytt, så bør du kontakte Kundeservice for hjelp. 
+Når man skrur på en *[feature](./features.html)* på Dapla, så er det verktøyet **Atlantis** som ruller ut infrastrukturen på GCP. I mange tilfeller kan det hjelpe å skrive `atlantis plan` i kommentarfeltet til PR'en, slik at Atlantis får kjørt planen en gang til. Hvis den da ikke viser noen feil, så kan du skrive `atlantis apply` i kommentarfeltet og endringene vil bli effektuert. Får du fortsatt feilmeldinger etter å ha kjørt `atlantis plan` på nytt, så bør du kontakte Kundeservice for hjelp.
+
+### Jeg får meldingen *Account already exists* når jeg prøver å logge meg inn på Dapla. Hvordan løser jeg det?
+
+:::: {.columns}
+
+::: {.column width="47.5%"}
+Det hender at man får melding om at *Account already exists* når man logger seg inn på en Dapla-tjeneste. For å løse dette gjør man følgende:
+
+1. Velg *Add to existing account* som vist i @fig-add-existing-account.
+2. Velg *Google* slik som vist i @fig-authenticate.
+
+I @fig-authenticate skal du IKKE fylle inn *Username or email* og *Password*. Du skal kun trykke på *Google*-knappen. 
+
+Meldingen om at *Account already exists* forekommer svært sjelden, og typisk skjer det første gang man logger seg inn på en tjeneste. 
+
+:::
+
+::: {.column width="5%"}
+<!-- empty column to create gap -->
+:::
+
+::: {.column width="47.5%"}
+
+![](./images/account-already-exist.png){#fig-add-existing-account}
+
+![](./images/account-authenticate-link.png){#fig-authenticate}
+
+:::
+
+::::

dapla-manual/statistikkere/dapla-ctrl.qmd

@@ -0,0 +1,188 @@
+# Dapla Ctrl
+
+Dapla Ctrl^[Navnet Dapla Ctrl er valgt for å kommunisere at målsetning med appen er å gi SSB-ere kontroll over tilgangsstyring på Dapla på en effektiv måte.] er tjeneste for tilgangsstyring på Dapla. Formålet med appen er at det skal være lett å få oversikt og administrere tilganger knyttet til Dapla-team.
+
+## Innlogging
+
+Alle som jobber i SSB kan logge seg inn på <https://ctrl.dapla.ssb.no/> for å bruke tjenesten.
+
+## Funksjonalitet
+
+Alle SSB-ansatte som logger seg inn i Dapla Ctrl får tilgang til å se informasjon om Dapla-team og tilganger. I tillegg kan de som er i tilgangsgruppen [managers](./hva-er-dapla-team.html#managers) legge til, fjerne og endre medlemmer i teamet de har denne rollen. Seksjonsledere har tilgang til å opprette nye team.
+
+### Teamoversikt
+
+<br>
+
+![Bilde av forsiden med oversikt over *Mine team* i Dapla Ctrl.](../images/dapla-ctrl-teamoversikt.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-teamoversikt}
+
+
+@fig-dapla-ctrl-teamoversikt viser landingssiden/forsiden som først møter den som logger seg inn i Dapla Ctrl. den. Her får den som er innlogget oversikt over hvilke Dapla-team man er medlem av, og følgende informasjon om teamene:
+
+- Teknisk teamnavn
+- Teamets eierseksjon
+- Antall teammedlemmer
+- Managers for teamet
+
+Man kan også bytte fane fra **Mine team** til **Alle team** for å se samme informasjon om alle team som finnes på Dapla.
+
+### Teamvisning
+
+<br>
+
+![Bilde av oversikten over et enkelt-team i Dapla Ctrl.](../images/dapla-ctrl-teamvisning.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-teamvisning}
+
+Fra [Teamoversikten](./dapla-ctrl.html#teamoversikt) kan man trykke seg inn på et spesifikt team og få en oversikt slik som vist i @fig-dapla-ctrl-teamvisning. 
+
+På toppen av siden får man se følgende informasjon:
+
+- teamets visningsnavn
+- teamets tekniske kortnavn
+- eierseksjonens seksjonsleder
+- eierseksjonens seksjonsnavn
+- autonomitetsnivået til teamet
+
+Videre ser vi at det er en fane for **Teammedlemmer** og en for **Delte Data**. Under fanen for **Teammedlemmer** ser man følgende informasjon om alle medlemmene av teamet:
+
+- navn på medlem
+- hvilken seksjons de jobber på
+- hvilken tilgangsgruppe de tilhører på teamet
+- e-postadresse med brukerens kortnavn
+
+Under fanen **Delte data** får man en oversikt over hvilke bøtter teamet har opprettet for å dele data med andre team. 
+
+![Bilde av oversikten over hvilke bøtter teamet har opprettet for å dele data med andre team.](../images/dapla-ctrl-delte-data.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-delte-data}
+
+@fig-dapla-ctrl-delte-data viser hvilken informasjon man får over teamets delte data. Følgende informasjon vises:
+
+- kortnavnet på bøttene
+- tekniske navnet til bøttene
+- hvor mange team som har tilgang
+- hvor mange personer som har tilgang^[**Antall personer** som har tilgang til en delt-bøtte viser hvor mange personer det er som har tilgang fra de teamene som har tilgang. Som regel vil det være slik at kun noen tilgangsgrupper i et team får tilgang til andre sine delte data, og ikke hele teamet.]
+
+### Delte data
+
+<br>
+
+![Bilde av oversikten over hvilke personer som har tilgang til en delt-bøtte.](../images/dapla-ctrl-delt-bucket.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-delt-bucket}
+
+Fra [Teamvisningen](./dapla-ctrl.html#teamvisning) kan man velge fanen **Delte data** og trykke seg på en av teamets delte-bøtter. @fig-dapla-ctrl-delt-bucket viser informasjon man får se i denne visningen. På toppen av siden får man se kortnavnet til bøtta, det tekniske navnet på bøtta, hvilket team som eier bøtta og hvilken eierseksjon teamet har. I tabellen som vises kan man undersøke hvilke personer som har tilgang til bøtta og få følgende informasjon om de:
+
+- navn
+- hvilken seksjon de jobber på
+- hvilket team-medelemskap de har tilgang i kraft av
+- hvilken tilgangsgruppe de er i på teamet de har tilgang i kraft av
+
+Fra tabellen kan man velge å se nærmere på personen som har tilgang, f.eks. se hvilke andre tilganger denne personen har, eller man kan se nærmere på teamet som personen har tilgang i kraft av. Ved å undersøke teamet nærmere kommer man inn på [Teamvisningen](./dapla-ctrl.html#teamvisning) som er beskrevet over, mens visning av [Teammedlemmer](./dapla-ctrl.html#medlemsvisning) forklares under.
+
+### Teammedlemmer
+
+<br>
+
+![Bilde av oversikten over hvilke personer som med i dine team.](../images/dapla-ctrl-teammedlemmer.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-teammedlemmer}
+
+@fig-dapla-ctrl-teammedlemmer viser oversikt over teammedlemmer. Øverst på siden kan man velge mellom en fane for **Mine teammedlemmer** og **Alle teammedlemmer**. Førstnevnte viser hvilke andre medlemmer som er i de teamene den innloggede er med i, mens sistnevnte viser alle teammedlemmer i SSB^[Alle teammedlemmer vil i praksis si alle ansatte i SSB, siden teamet **Dapla Felles** alltid legger til alle ansatte i SSB. Formålet med dette er å la alle ansatte få tilgang til testdata i en bøtte.]. I tabellen under får man følgende informasjon om teammedlemmene:
+
+- navn
+- hvilken seksjons de jobber på
+- hvor mange team de er medlem av
+- hvor mange team de har tilgangsrollen [data-admins](./hva-er-dapla-team.html#data-admins)
+- navn på personens seksjonsleder
+
+### Medlemsvisning
+
+<br>
+
+![Bilde av oversikten over hvilke team en person er medlem av.](../images/dapla-ctrl-medlemsvisning.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-medlemsvisning}
+
+@fig-dapla-ctrl-medlemsvisning viser hva man ser når går inn på en enkeltperson, enten via [Teamoversikten](./dapla-ctrl.html#teamoversikten) eller [Teammedlemmer](./dapla-ctrl.html#teammedlemmer). Øverst på siden står navnet til personen, hvorvidt de har arbeidssted i Oslo eller Kongsvinger^[Hvorvidt arbeidssted er Oslo eller Kongsvinger indikeres med henholdsvis **O** eller **K** før seksjonsnummeret.], hvilken seksjon de jobber på og e-postadressen deres. 
+
+Tabellen i @fig-dapla-ctrl-medlemsvisning får man en oversikt over hvilke team personen er medlem av, samt følgende detaljer:
+
+- teamets tekniske kortnavn
+- seksjonseier av teamet
+- hvilke tilgangsgrupper personen er med i
+- hvem som er managers for teamet
+
+Videre kan man gå videre inn på et av teamene og se nærmere på hvem som er medlemmer og hvilke data de deler. 
+
+### Opprette team
+
+:::: {.columns}
+
+::: {.column width="70%"}
+
+Hvis en seksjonsleder logger seg inn i Dapla Ctrl så vil knappen i @fig-dapla-ctrl-opprett-team-button vises i [Teamoversikt](./dapla-ctrl.html#teamoversikt)-siden. Det er kun seksjonsleder som kan opprette nye Dapla-team, og denne seksjonen blir da eierseksjon for teamet. 
+
+:::
+
+::: {.column width="10%"}
+<!-- empty column to create gap -->
+:::
+
+::: {.column width="20%"}
+![Bilde av knappen som vises for seksjonsledere.](../images/dapla-ctrl-opprett-team-button.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-opprett-team-button}
+:::
+
+::::
+
+::: {.callout-note}
+# Under arbeid
+Siden for å opprette nye Dapla-team er under arbeid. Foreløpig tas brukeren inn i den gamle løsningen for å opprette team; [Dapla Start](https://start.dapla.ssb.no/). Snart vil dette også være integrert i Dapla Ctrl. 
+:::
+
+### Legge til medlemmer
+
+:::: {.columns}
+
+::: {.column width="70%"}
+
+Hvis man som medlem av tilgangsgruppen [managers](./hva-er-dapla-team.html#managers) logger seg inn Dapla Ctrl, vil man få tilgang til å legge til medlemmer i teamet man er i managers-gruppa for. Går man inn på [Teamvisning](./dapla-ctrl.html#teamvisning) vil man se knappen i @fig-dapla-ctrl-opprett-add-members.
+
+:::
+
+::: {.column width="10%"}
+<!-- empty column to create gap -->
+:::
+
+::: {.column width="20%"}
+![Bilde av knappen som vises for managers.](../images/dapla-ctrl-add-members.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-opprett-add-members}
+:::
+
+::::
+
+Trykker man på knappen så får man opp en side for å legge til nye medlemmer i teamet, slik som vist @fig-dapla-ctrl-opprett-add-members-site. Man kan søke opp alle ansatte i SSB, og man kan velge å legge de til i en eller flere tilgangsgrupper. Når man har valgt person, og hvilke tilgangsgrupper de skal legges i, så avslutter man med å trykke på **Legg til medlem** for å effektuere endringen. 
+
+
+![Bilde av siden for å legge til medlemmer.](../images/dapla-ctrl-add-members-site.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-opprett-add-members-site}
+
+Det kan ta mellom 1-2 minutter før tilgangen er aktivert og klar til bruk. 
+
+### Endre eller fjerne medlemmer
+
+Hvis man som medlem av tilgangsgruppen [managers](./hva-er-dapla-team.html#managers) logger seg inn Dapla Ctrl, vil man få tilgang til å fjerne og endre medlemmer i teamet man er i managers-gruppa for. Går man inn på [Teamvisning](./dapla-ctrl.html#teamvisning) så vil man se **Endre**-knapp for hver person i teamet. 
+
+![Bilde av Teamvisning som vises for personer i tilgangsgruppen managers.](../images/dapla-ctrl-change-member.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-change-member}
+
+:::: {.columns}
+
+::: {.column width="70%"}
+
+Av @fig-dapla-ctrl-change-member ser vi at hvert medlem i teamet har en Endre-knapp. Trykker man på den så får man opp bilde som vises i @fig-dapla-ctrl-change-member-site. 
+
+Ønsker man å fjerne et medlem fra teamet, så kan man bare trykke på **Fjern fra teamet**. Da vil man bli spurt om å bekrefte at personen skal gjernes, og velger man ok så effektureres endringen ila et par minutter. 
+
+Ønsker man endre hvilken tilgangsgruppe en person er med i, så gjør man det ved å enten fjerne eller legge til tilganger som listet under dropdown-menyen for *Tilgangsgruppe(r)*. For eksempel hvis en person ligger som både *data-admins* og *developers*, slik som eksempelet i @fig-dapla-ctrl-change-member-site, så trykker man bare på X-ikonet for den tilgangen, og til slutt effektuerer man endringen ved å velge **Oppdater tilgang**.
+
+:::
+
+::: {.column width="10%"}
+<!-- empty column to create gap -->
+:::
+
+::: {.column width="20%"}
+![Bilde av siden for å endre eller fjerne medlemmer.](../images/dapla-ctrl-change-member-site.png){fig-alt="A drawing of an elephant." #fig-dapla-ctrl-change-member-site}
+:::
+
+::::
+

dapla-manual/statistikkere/hva-er-dapla-team.ipynb

@@ -16,17 +16,20 @@
    "source": [
     "# Hva er Dapla-team?\n",
     "\n",
-    "For å kunne jobbe på Dapla må man være en del av et **Dapla-team**. Et Dapla-team er en gruppe personer som har tilgang til spesifikke ressurser på Dapla. Ressursene kan være data, kode eller tjenester. Følgelig er teamet helt sentral for tilgangsstyringen på Dapla. Derfor er det viktig at alle som jobber på Dapla gjør seg godt kjent med innholdet i dette delen.\n",
+    "For å kunne jobbe på Dapla må man være en del av et **Dapla-team**. Et Dapla-team er en gruppe personer som har tilgang til spesifikke ressurser på Dapla. Ressursene kan være data, kode eller tjenester. Følgelig er teamet helt sentral for tilgangsstyringen på Dapla. Derfor er det viktig at alle som jobber på Dapla gjør seg godt kjent med innholdet i denne delen.\n",
     "\n",
     "## Opprette Dapla-team\n",
     "\n",
+    "Alle Dapla-team tilhører en seksjon og opprettes av seksjonslederen i den seksjonen. Dapla-team opprettes i [applikasjonen Dapla-Ctrl](https://ctrl.dapla.ssb.no/). \n",
+    "\n",
     "Dapla-team opprettes av dataeier for teamets kildedata. I de fleste tilfeller vil dette være en seksjonsleder i SSB. Selve opprettelsen av teamet gjøres i **Manager-portalen**.\n",
     "\n",
     "::: {.callout-warning}\n",
-    "# Manager-portalen er under arbeid\n",
-    "Manager-portalen er under arbeid og vil være klar i 1. kvartal 2024. I mellomtiden kan man bruke den [gamle portalen for å opprette Dapla-team](https://start.dapla.ssb.no/).\n",
+    "# Under arbeid\n",
+    "Dapla-Ctrl er under arbeid og foreløpig . I mellomtiden kan man bruke den [gamle portalen for å opprette Dapla-team](https://start.dapla.ssb.no/).\n",
     ":::\n",
     "\n",
+    "\n",
     "## Roller i teamet\n",
     "\n",
     "Medlemskap i et Dapla-team gir tilgang på spesifikke ressurser på Dapla. Men siden kildedataene til alle team er klassifisert som *sensitive*, så kan ikke alle på teamet ha lik tilgang til alle ressurser. Av den grunn er det definert 3 ulike roller på et team. To av disse, **data-admins** og **developers**, er forbeholdt de som jobber med data på teamet. Mens den tredje, **managers**, skal innehas av de som er ansvarlige for teamet. I de fleste tilfeller vil **managers** være seksjonslederen som er ansvarlige for statistikkproduktene teamet leverer. Under forklarer vi nærmere hva de ulike rollene innebærer.\n",
@@ -200,7 +203,8 @@
     "|                       | ssb-skatt-naering-data-tilsky-prod       |\n",
     "| skatt-naering-kilde-t | ssb-skatt-naering-data-kilde-test        |\n",
     "| skatt-naering-t       | ssb-skatt-naering-data-produkt-test      |\n",
-    ": Navnestruktur for teamet **Skatt næring** sine bøtter {#tbl-navn-buckets}"
+    ": Navnestruktur for teamet **Skatt næring** sine bøtter {#tbl-navn-buckets}\n",
+    "\n"
    ]
   },
   {
@@ -226,7 +230,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.6"
+   "version": "3.11.8"
   },
   "orig_nbformat": 4
  },