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..9333578 --- /dev/null +++ b/layouts/index.html @@ -0,0 +1,123 @@ +{{- /* 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 + Steg for steg + Se datasettene +
+ {{- if not .Site.Params.noSearch }} +
+ {{ partial "search.html" . }} +
+ {{- end }} +
+
+ {{- /* Band art: the data.altinn.no market icon (white, as the profile requires on dark + surfaces) with the design element beside it: the emblem's circle-and-square shape in + the profile's graphic colours, at the right edge and low on the surface. */ -}} + +
+
+ +
+
+

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, send en e-post, eller rett det selv.

+
+ Opprett en sak på GitHub + #produkt-data-altinn-no + dan@altinn.no + Bidra med endringer +
+
+
+ +
+ + {{- partial "footer-content.html" . }} + {{- partial "custom-footer.html" . }} + + diff --git a/layouts/partials/custom-head.html b/layouts/partials/custom-head.html index 107c56d..bcff12f 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/footer-content.html b/layouts/partials/footer-content.html index d5dd078..bd1a08b 100644 --- a/layouts/partials/footer-content.html +++ b/layouts/partials/footer-content.html @@ -36,13 +36,13 @@ Telefon: --> - + - + - + diff --git a/layouts/partials/topbar.html b/layouts/partials/topbar.html index 0f4ebee..e61e1ed 100644 --- a/layouts/partials/topbar.html +++ b/layouts/partials/topbar.html @@ -1,15 +1,20 @@ -