From d2baeb2dc21b73fee4736ba2a8213eed214e3ea5 Mon Sep 17 00:00:00 2001 From: erlendoksvoll Date: Fri, 25 Sep 2026 13:11:29 +0200 Subject: [PATCH 01/16] site: landing page for docs.data.altinn.no A dedicated front page instead of the sidebar layout: a navy band in the portal's colour (#022F51) with the all-white data.altinn.no lockup, a short lead, "Kom i gang med API" and "Se datasettene" buttons and the site search; three Designsystemet cards (Kom i gang, Tilgang og samtykke, Tjenester og datasett) whose links come from data/landing.yaml and resolve through .Site.GetPage; a tinted "Hva er data.altinn.no?" section; and a contact row (GitHub, Slack, e-mail). The design element at the band's edge is the emblem's circle-and-square shape in the profile's graphic colours. Designsystemet is vendored (theme digdir 1.11.0, css 1.22.0, the parts used) and loaded only on the home page; --ds-size-base is rescaled because the legacy stylesheet sets html to 10px. The former home-page text moved to a new "Om data.altinn.no" page (first in the sidebar); the home page keeps its aliases. The theme's is now a shared head.html partial, and custom-head.html receives the page context so it can branch on .IsHome. Co-Authored-By: Claude Fable 5.1 --- content/_index.md | 38 +- content/om/_index.md | 42 + data/landing.yaml | 36 + layouts/index.html | 114 ++ layouts/partials/custom-head.html | 6 +- layouts/partials/topbar.html | 8 +- static/css/designsystemet.css | 1178 +++++++++++++++++ static/css/landing.css | 183 +++ static/images/dan-logo-white.svg | 22 + static/images/digdir-emblem-white.svg | 1 + .../layouts/partials/head.html | 33 + .../layouts/partials/header.html | 33 +- 12 files changed, 1624 insertions(+), 70 deletions(-) create mode 100644 content/om/_index.md create mode 100644 data/landing.yaml create mode 100644 layouts/index.html create mode 100644 static/css/designsystemet.css create mode 100644 static/css/landing.css create mode 100644 static/images/dan-logo-white.svg create mode 100644 static/images/digdir-emblem-white.svg create mode 100644 themes/hugo-theme-altinn/layouts/partials/head.html diff --git a/content/_index.md b/content/_index.md index 35165fa..3f1963f 100644 --- a/content/_index.md +++ b/content/_index.md @@ -1,8 +1,7 @@ --- title: data.altinn.no -description: data.altinn.no (DAN) er laget for å kunne forenkle deling av data fra virksomheter, med formål om å gjenbruke informasjon direkte fra kilden. +description: data.altinn.no (DAN) er laget for å kunne forenkle deling av data fra virksomheter, med formål om å gjenbruke informasjon direkte fra kilden. weight: 100 -toc: true aliases: - /guides/nadobe/ - /guides/dokumentasjonsbevis/ @@ -10,37 +9,8 @@ aliases: - /utviklingsguider/data.altinn.no/ebevis --- -## Innledning +data.altinn.no (DAN) gjør det enklere å komme i gang med datadeling, både for datakilder og konsumenter. Gjennom ett generisk API kan ulike _datasett_ hentes rett fra kilden på en måte som sikrer konfidensialitet, integritet og tilgjengelighet. -data.altinn.no (DAN) gjør det enklere å komme i gang med datadeling både for datakilder og konsumenter. Gjennom et enkelt, generisk API kan ulike _datasett_ utveksles på en måte som sikrer konfidensialitet, integritet og tilgjengelighet - selv for datakilder som mangler kapabilitetene som kreves for å kunne dele data med mange konsumenter. +All uthenting skjer i kontekst av en _tjeneste_, som regulerer hvem som får hente hva og på hvilket grunnlag: hjemmel, samtykke fra en representant for virksomheten i Altinn, eller en kombinasjon. Løsningen brukes i dag av blant annet eBevis for leverandørkvalifisering i offentlige anskaffelser og Tilda for deling av tilsynsdata. -Gjennom å sikre tilganger til ulike konsumentgrupper gjennom rike autorisasjonsregler, f.eks. ved bruk av [Altinns samtykkeløsning](https://altinn.github.io/docs/utviklingsguider/samtykke/), vil informasjonen kunne hentes direkte fra datakilden sikkert og effektivt. - -Løsningen er generisk og vil kunne brukes på ulike forretningsområder, med nye tilknyttede registre og nye brukergrupper. - -Denne dokumentasjonen dekker den tekniske bruken av data.altinn.no. Informasjon om kostnader, vilkår, bruksstatistikk og utviklingsplan finner du på [data.altinn.no på Samarbeidsportalen](https://samarbeid.digdir.no/altinn/dataaltinnno/1929), Digdirs felles nettsted for fellesløsningene. - -## Tjenester på data.altinn.no - -All uthenting av datasett tilgjengeliggjort på data.altinn.no gjøres i kontekst av en _tjeneste_. Tjenestene forteller noe om hvilken sammenheng datauthentingen gjøres i, og regulerer bl.a. autorisasjon. Et eksempel på en slik tjeneste på data.altinn.no er eBevis, som forenkler kvalifisering av leverandører i forbindelse med offentlige anskaffelser. - -Ulike tjenester kan benytte de samme datasettene, men være underlagt andre regler for uthentingen av dataene. F.eks. vil det i noen _tjenestekontekster_ være nødvendig å innhente et samtykke, mens det i andre foreligger hjemmel til å kunne hente dataene direkte. - -## Datakilder og datasett - -Løsningen baseres på at en aktør kan sende forespørsler på én eller flere _datasett_ (tidligere kalt _beviskoder_). Datasettene er en informasjonspakke som kan inneholde ett eller flere felter med strukturert eller ustrukturert informasjon. Forespørsler inneholder 1) hvem som spør, 2) hvem forespørselen gjelder, og 3) hvilke datasett spørres det om. - -## Sikring av data og tilgangskontroll - -Løsningen er tilrettelagt for formidling av også ikke-åpne data og personopplysninger. Behandlingsgrunnlaget som kreves for å hente disse dataene oppstår gjennom at konsumenten har en hjemmel til å hente informasjonen, eller at det innhentes samtykke fra en bemyndiget representant for parten det innhentes opplysninger om. - -data.altinn.no tilbyr ulike mekanismer som gjør det mulig for konsumenten å dokumentere at behandlingsgrunnlag foreligger, f.eks. gjennom Altinns samtykkeløsning, gjennom et spesifikt token fra Maskinporten, gjennom et strukturert verifiserbart vedlegg i forespørselen, gjennom å verifisere identiteten til den som utfører forespørselen - eller en kombinasjon av disse. - -I de tilfellene hvor datakilder avgir personopplysninger eller andre data som er underlagt taushetsplikt eller andre restriksjoner, kreves det at Digitaliseringsdirektoratet inngår databehandleravtaler med de partene som har behandlingsansvar. - -## Bruk av samtykke - -Datasettene som krever samtykke vil igangsette en samtykkeprosess i Altinn. I de tilfeller hvor det skal hentes ut informasjon om en juridisk person, må en representant fra virksomheten, med tilstrekkelig tilgangsnivå, logge seg inn i Altinn-portalen og aktivt samtykke til at dataene skal tilgjengeliggjøres. Varsel om samtykkeforespørsel sendes som en melding til den aktuelle innboksen i Altinn, og inneholder en lenke som lar representanten ta stilling til om samtykke skal gis eller ikke. - -* [Mer informasjon om samtykkeprosessen](/samtykkeprosessen) -* [Rollekrav i Altinn for samtykketjenestene](/rollekrav-i-altinn) \ No newline at end of file +Denne dokumentasjonen dekker den tekniske bruken. Kostnader, vilkår, bruksstatistikk og utviklingsplan finner du på [data.altinn.no på Samarbeidsportalen](https://samarbeid.digdir.no/altinn/dataaltinnno/1929). diff --git a/content/om/_index.md b/content/om/_index.md new file mode 100644 index 0000000..2ebdbfb --- /dev/null +++ b/content/om/_index.md @@ -0,0 +1,42 @@ +--- +title: Om data.altinn.no +linktitle: Om løsningen +description: Hva data.altinn.no er, og hvordan tjenester, datasett, tilgangskontroll og samtykke henger sammen. +weight: 5 +toc: true +--- + +## Innledning + +data.altinn.no (DAN) gjør det enklere å komme i gang med datadeling både for datakilder og konsumenter. Gjennom et enkelt, generisk API kan ulike _datasett_ utveksles på en måte som sikrer konfidensialitet, integritet og tilgjengelighet - selv for datakilder som mangler kapabilitetene som kreves for å kunne dele data med mange konsumenter. + +Gjennom å sikre tilganger til ulike konsumentgrupper gjennom rike autorisasjonsregler, f.eks. ved bruk av [Altinns samtykkeløsning](https://altinn.github.io/docs/utviklingsguider/samtykke/), vil informasjonen kunne hentes direkte fra datakilden sikkert og effektivt. + +Løsningen er generisk og vil kunne brukes på ulike forretningsområder, med nye tilknyttede registre og nye brukergrupper. + +Denne dokumentasjonen dekker den tekniske bruken av data.altinn.no. Informasjon om kostnader, vilkår, bruksstatistikk og utviklingsplan finner du på [data.altinn.no på Samarbeidsportalen](https://samarbeid.digdir.no/altinn/dataaltinnno/1929), Digdirs felles nettsted for fellesløsningene. + +## Tjenester på data.altinn.no + +All uthenting av datasett tilgjengeliggjort på data.altinn.no gjøres i kontekst av en _tjeneste_. Tjenestene forteller noe om hvilken sammenheng datauthentingen gjøres i, og regulerer bl.a. autorisasjon. Et eksempel på en slik tjeneste på data.altinn.no er eBevis, som forenkler kvalifisering av leverandører i forbindelse med offentlige anskaffelser. + +Ulike tjenester kan benytte de samme datasettene, men være underlagt andre regler for uthentingen av dataene. F.eks. vil det i noen _tjenestekontekster_ være nødvendig å innhente et samtykke, mens det i andre foreligger hjemmel til å kunne hente dataene direkte. + +## Datakilder og datasett + +Løsningen baseres på at en aktør kan sende forespørsler på én eller flere _datasett_ (tidligere kalt _beviskoder_). Datasettene er en informasjonspakke som kan inneholde ett eller flere felter med strukturert eller ustrukturert informasjon. Forespørsler inneholder 1) hvem som spør, 2) hvem forespørselen gjelder, og 3) hvilke datasett spørres det om. + +## Sikring av data og tilgangskontroll + +Løsningen er tilrettelagt for formidling av også ikke-åpne data og personopplysninger. Behandlingsgrunnlaget som kreves for å hente disse dataene oppstår gjennom at konsumenten har en hjemmel til å hente informasjonen, eller at det innhentes samtykke fra en bemyndiget representant for parten det innhentes opplysninger om. + +data.altinn.no tilbyr ulike mekanismer som gjør det mulig for konsumenten å dokumentere at behandlingsgrunnlag foreligger, f.eks. gjennom Altinns samtykkeløsning, gjennom et spesifikt token fra Maskinporten, gjennom et strukturert verifiserbart vedlegg i forespørselen, gjennom å verifisere identiteten til den som utfører forespørselen - eller en kombinasjon av disse. + +I de tilfellene hvor datakilder avgir personopplysninger eller andre data som er underlagt taushetsplikt eller andre restriksjoner, kreves det at Digitaliseringsdirektoratet inngår databehandleravtaler med de partene som har behandlingsansvar. + +## Bruk av samtykke + +Datasettene som krever samtykke vil igangsette en samtykkeprosess i Altinn. I de tilfeller hvor det skal hentes ut informasjon om en juridisk person, må en representant fra virksomheten, med tilstrekkelig tilgangsnivå, logge seg inn i Altinn-portalen og aktivt samtykke til at dataene skal tilgjengeliggjøres. Varsel om samtykkeforespørsel sendes som en melding til den aktuelle innboksen i Altinn, og inneholder en lenke som lar representanten ta stilling til om samtykke skal gis eller ikke. + +* [Mer informasjon om samtykkeprosessen](/samtykkeprosessen) +* [Rollekrav i Altinn for samtykketjenestene](/rollekrav-i-altinn) diff --git a/data/landing.yaml b/data/landing.yaml new file mode 100644 index 0000000..8a342fa --- /dev/null +++ b/data/landing.yaml @@ -0,0 +1,36 @@ +# Landing page (layouts/index.html): the three link groups under the hero. +# `page` is a content path resolved with .Site.GetPage, so titles follow the +# front matter (linktitle, then title) unless `title` overrides it here. +groups: + - title: Kom i gang + icon: fa-plug + text: Integrer systemet ditt med API-et, følg flyten steg for steg og prøv det ut i testmiljøet. + links: + - page: /api + title: Kom i gang med API + - page: /api/steg-for-steg + title: Fra forespørsel til data, steg for steg + - page: /api/oas + title: OpenAPI-spesifikasjon + - page: /testing + title: Testing mot data.altinn.no + - title: Tilgang og samtykke + icon: fa-lock + text: Hjemmel, samtykke og fullmakt gir tilgang til data. Her står hva som kreves i Altinn, og hvordan apper kan bruke løsningen. + links: + - page: /samtykkeprosessen + - page: /rollekrav-i-altinn + title: Rollekrav i Altinn + - page: /altinnstudio + - title: Tjenester og datasett + icon: fa-database + text: Tjenestene som henter data gjennom data.altinn.no, og datasettene som er tilgjengelige i prod og test. + links: + - page: /tjenester + title: Alle tjenester + - page: /tjenester/ebevis + title: eBevis + - page: /tjenester/tilsynsdata + title: Tilda + - page: /datasett + - page: /ofte-stilte-spørsmål diff --git a/layouts/index.html b/layouts/index.html new file mode 100644 index 0000000..aefb05c --- /dev/null +++ b/layouts/index.html @@ -0,0 +1,114 @@ +{{- /* Landing page for docs.data.altinn.no. Standalone skeleton (no sidebar): shares and the + top bar with the doc pages, uses Designsystemet (static/css/designsystemet.css) for cards, + buttons and type, and static/css/landing.css for layout. Link groups come from data/landing.yaml. */ -}} + + + + {{ partial "head.html" . }} + + + {{ partial "topbar.html" . }} + +
+ +
+
+

Teknisk dokumentasjon

+

Bygg på data.altinn.no

+

{{ .Site.Params.description }}

+
+ Kom i gang med API + Se datasettene +
+ {{- if not .Site.Params.noSearch }} +
+ {{ partial "search.html" . }} +
+ {{- end }} +
+ {{- /* Design element: the emblem's circle-and-square interaction, in the profile's graphic + colours, placed at the right edge and low on the surface as the profile prescribes. */ -}} + +
+ +
+
+

Finn fram i dokumentasjonen

+
+ {{- range .Site.Data.landing.groups }} +
+
+ +

{{ .title }}

+

{{ .text }}

+
+
+
    + {{- range .links }} + {{- $title := .title }} + {{- with $.Site.GetPage .page }} +
  • {{ $title | default .LinkTitle }}
    • + {{- else }} + {{- warnf "landing.yaml: page %q not found" .page }} + {{- end }} + {{- end }} +
+
+
+ {{- end }} +
+
+
+ +
+
+
+

Hva er data.altinn.no?

+
{{ .Content }}
+
+
+

Les mer

+ +
+
+
+ +
+
+

Spør oss, eller bidra

+

Dokumentasjonen er åpen kildekode. Fant du en feil, eller savner du noe? Opprett en sak, still spørsmål i Slack-kanalen vår, eller send en e-post.

+
+ Opprett en sak på GitHub + #produkt-data-altinn-no på Slack + dan@altinn.no +
+
+
+ +
+ + {{- partial "footer-content.html" . }} + {{- partial "custom-footer.html" . }} + + diff --git a/layouts/partials/custom-head.html b/layouts/partials/custom-head.html index 107c56d..4473129 100644 --- a/layouts/partials/custom-head.html +++ b/layouts/partials/custom-head.html @@ -1,3 +1,7 @@ - \ No newline at end of file + +{{- if .IsHome }} + + +{{- end }} diff --git a/layouts/partials/topbar.html b/layouts/partials/topbar.html index 0f4ebee..8e50eb8 100644 --- a/layouts/partials/topbar.html +++ b/layouts/partials/topbar.html @@ -5,11 +5,13 @@ -
+