KS Kunnskap
Innledning
KS Kunnskap (https://ksdigital.no/tjenestene/ks-kunnskap/) er en moderne og brukervennlig plattform for deling og læring basert på Valamis-læringsplattformen. Plattformen bidrar til å øke den kollektive kunnskapen i hele den norske kommunale sektoren, med et felles kurskatalog, individuelle oversikter og robuste rapporteringsløsninger.
KS Kunnskap er en erstatning for KS Læring, og alle norske kommuner vil bli overført fra Læring til Kunnskap. Les mer om denne prosessen her: https://ksdigital.no/tjenestene/ks-kunnskap/slik-flytter-vi-til-ks-kunnskap_v2/.
Synkronisering av bruker- og organisasjonsdata til KS Kunnskap
Se informasjon fra KS Digital her: https://ksdigital.no/tjenestene/ks-kunnskap/slik-flytter-vi-til-ks-kunnskap/teknisk-informasjon/
Dette oppsettet er en to-trinns prosess. Først må brukerkontoer for alle ansatte opprettes i KS Fiks. En nøkkelferdig integrasjon for dette er tilgjengelig i eADM: https://docs.identum.no/eadm/ks-fiks-forberedelser-og-oppsett
Deretter må organisasjonsstrukturen og rollene overføres til KS Kunnskap. Her har du to alternativer: SCIM2 via Entra ID eller en API-basert integrasjon. Du kan utvikle det siste selv, eller benytte eADMs integrasjon med KS Kunnskap.
eADM-integrasjonen med KS Kunnskap automatiserer organisasjonsstrukturen og brukerrollene. Integrasjonen synkroniserer avdelinger og tildeler roller i KS Kunnskap. Roller som «leder» og «ansatt» tildeles automatisk basert på data fra HR-systemet ditt, behandlet gjennom regler konfigurert i eADM. Dette sikrer at brukertilgangen alltid er i samsvar med organisasjonens struktur og HR-data. Roller kan selvfølgelig også tildeles manuelt gjennom veivisere som er tilgjengelige i eADM-brukergrensesnittet.
Sammenligning av SCIM2 og API
Funksjon / Krav | Alternativ 1: SCIM2 via Entra ID | Alternativ 2: Utvikle egen tilkobling til KS Digital API | eADM-integrasjon |
Krever utvikling av kommunen? | Nei | Ja | Nei |
Støtter ansatte i flere avdelinger? | Nei | Ja | Ja |
Støtter flere roller enn bare leder/ikke-leder? | Nei | Ja | Ja |
Kan man bruke avdelingsnavnet fra kommunens organisasjonssystem? | Nei (ledernavnet er definert som avdelingen) | Ja | Ja |
Støtter mer enn én leder per ansatt? | Nei | Ja | Ja |
Minimale krav til oppsett? | Ja | Nei | Ja |
Anbefalt alternativ for størst fleksibilitet med avanserte behov? | Nei | Ja | Ja |
Er det mulig å endre alternativene senere? | Ja | Ja | Ja |
Pålogging og enkel pålogging (SSO)
KS Kunnskap støtter SSO via SAML2 og OIDC. En teknisk gjennomgang av oppsettet finner du her: https://ksdigital.no/tjenestene/ks-kunnskap/slik-flytter-vi-til-ks-kunnskap/teknisk-informasjon/single-sign-on/
Denne siden inneholder også en veiledning for å konfigurere pålogging til KS Kunnskap via Microsoft Entra ID.
KS Kunnskap rollefordeling
Under integrasjonsfasen må vi definere forretningsreglene som styrer hvordan roller (eller «stillinger» i KS kunnskap) tildeles brukere. Denne informasjonen er avgjørende for å konfigurere de riktige regelsettene i eADM.
Som standard vil ledere få rollen «Leder» i KS Kunnskap for avdelingene de leder, i henhold til organisasjonsstrukturen. Alle andre vil få rollen «rapporter» i alle avdelinger der de har en aktiv ansettelseshistorikk.
Hvis denne standard rolletildelingen avviker fra hvordan du ønsker det i din organisasjon, eller hvis du ønsker å tildele flere roller, vennligst gi oss beskjed.
eADM-integrasjonsoppsett
Før integrasjonen kan aktiveres, må du fullføre noen få trinn.
Vær oppmerksom på at eksporten til KS Fiks må være fullført før Identum kan aktivere KS Kunnskap-integrasjonen. Se KS Fiks for mer informasjon.
Sett opp brukersynkronisering til KS Kunnskap fra Fiks sentralt brukerlager.
Først må du sette opp KS Kunnskap til å synkronisere bruker- og organisasjonsdata fra en ekstern kilde.Logg inn på Fiks Forvaltning (https://forvaltning.fiks.ks.no/) med Bank-ID og velg Konfigurasjon.
Naviger til Tjenester → KS Kunnskap
Velg Innstillinger. Under Synkronisering klikker du på Opprett konfigurasjon.
I konfigurasjonsvinduet velger du brukerkilden du opprettet under oppsettet av KS Fiks.
Som kilde for organisasjonsstrukturen velger du Orgstruktur API-alternativet .
Lagre
Konfigurer API-påloggingsinformasjon for Orgstruktur API. For å kunne bruke Orgstruktur API som du aktiverte i forrige trinn, krever eADM påloggingsinformasjon (integrasjonsbrukernavn og passord).
Velg Integrasjoner i toppmenyen der du slapp i trinn 2.
Klikk på Opprett integrasjon.
Skriv inn et beskrivende navn for integrasjonen, f.eks. "Identum eADM org.struktur"
Skriv inn "994479865" som "Autorisert organisasjonsnummer". Dette er Identums organisasjonsnummer i Enhetsregisteret. Ved å legge inn denne informasjonen tillater du Identum å autentisere seg mot KS Fiks ved hjelp av vårt Enterprise-sertifikat gjennom Maskinporten.

Skriv inn en beskrivelse av formålet med denne integrasjonen.
Bekreft og generer et passord. Lagre integrasjons-ID og integrasjonspassord på en sikker måte.

Hvis du blir omdirigert til en sentral "Integrasjoner"-side, navigerer du tilbake til Tjenester → KS Kunnskap → Integrasjoner.
Den nyopprettedeintegrasjonen skal nå væretilgjengelig under "Tilgjengelig integrasjoner" . Klikk Legg til for å autorisere integrasjonen til å få tilgang til Orgstruktur API.

Integrasjonen skal nå være oppført under Tilknyttede integrasjoner , og bryteren for Kan oppdatere Orgstruktur i KS Kunnskap skal være aktivert.

Del API-påloggingsinformasjonen på en sikker måte med Identum-integrasjonskonsulenten din.
Integreringsbrukernavn og passord fra trinn 2
Fiks-organisasjons-ID, som du finner øverst til venstre i Fiks Forvaltning-portalen.

Klar til lansering! Du har fullført oppsettet på din side. Vi vil fullføre oppsettet i eADM-backenden, og deretter gi deg beskjed når vi er klare til å implementere i produksjonen. Vi vil ikke aktivere synkroniseringen før du gir klarsignal.
Konfigurer pålogging. Når vi har aktivert synkroniseringen, må du aktivere Single Sign-On med Entra ID for KS Kunnskap.
Sammendrag for AI og søk
Guide til konfigurering av eADM-integrasjon med KS Kunnskap for norske kommuner: synkroniser brukere og avdelinger fra eADM/KS Fiks, automatiser rolletildeling (Leder, rapporter) fra HR-data, og aktiver Orgstruktur API. Inkluderer forutsetninger, oppsett av Fiks Forvaltning, API-legitimasjon (Identum org.nr. 994479865) og sikker deling av legitimasjon for aktivering.