VEDLEGG. Vedlegg 2 til kravspesifikasjon AUTENTISERING OG TILGANGSKONTROLL

Transkript

1 VEDLEGG Vedlegg 2 til kravspesifikasjon AUTENTISERING OG TILGANGSKONTROLL

2 Innhold Vedlegg 2 til kravspesifikasjon: Autentisering og tilgangskontroll 1. Bakgrunn Autentisering Tilgangskontroll (bruker/rolle-modell) Administrasjon av brukerkontoer og rolletilhøringhet Datamodell bruker/rolle/etat/felttilgang Tabeller Eksempeldata i tabeller Tabeller i Fagdatasett Tilgangskontroll REST API eksempel UseCase UseCase Side 1 av 11

3 1. Bakgrunn Vedlegg 2 til kravspesifikasjon: Autentisering og tilgangskontroll Miljødataseksjonen (TMI) benytter Identity Manager for håndtering av alle operasjoner relatert til autentisering /identitetshåndtering. Vi har også et eget API for styring og sjekk av tilgang til ressurser basert på rolle- og etatstilhørighet. 2. Autentisering Identity manager håndterer følgende operasjoner relatert til autentisering: Pålogging. Brukernavn/passord verifiseres mot tabeller i en database med fellesressurser for alle fagdatasett. Utløpsdato for konto skal kontrolleres. Avlogging (automatisk etter 60 minutter). Single sign-on støtte for andre applikasjoner som skal benytte samme brukerdatabase. 3. Tilgangskontroll (bruker/rolle-modell) Dagens versjon av Naturbase har en relativt omfattende bruker- og rollemodell. Hver enkelt applikasjon tilknyttet Naturbase har egen styring av tilgangskontrollen, men alle baserer seg på felles underliggende bruker- og rollemodell. Kort forklart: Brukere tilhører en etat og har en eller flere roller. Geografisk tilgang tildeles per etat (f.eks. har etaten Fylkesmannen i Nordland kun lov til å skrive til objekter i Nordland). Rolletilhørighet avgjør tilgangsnivå til de ulike fagdatasettene som til sammen utgjør Naturbase. Ulike roller gir tilgang til redigering av egenskaper, kartimport og egenskapsimport. Spesialtilfeller har til nå blitt håndtert i programkode der dette har vært nødvendig. Vi tar med oss alt dette videre, men gjør modellen litt mer fleksibel: I tillegg til at en skal kunne tildeles skrivetilgang til et helt fagdatasett vil det være mulig å styre på tabell- og feltnivå hva hver rolle har tilgang til. Det vil være mulig å gi tre ulike nivå for tilgang til hvert felt: ingen, les og skriv (0,1,2). For å unngå at hver enkelt applikasjon må implementere egen kode for å tolke bruker- og rollemodellen er funksjonaliteten skilt ut i en frittstående applikasjon som kan benyttes av flere applikasjoner (saksbehandlerapplikasjon, redigering av kart og egenskaper, importapplikasjon osv.). Det blir mulig å skille mellom tilgang til å redigere egenskapstabeller og kartdata. De ulike fagdatasettene i Naturbase deles opp i flere frittliggende databaser, men bruker- og rolle-modellen blir liggende i en samlet database med fellesressurser. Side 2 av 11

4 For å løse dette har vi gjort følgende: Rolle-tabellen er utvidet slik at den i tillegg til å bestemme hvilket fagdatasett rolleinnehaveren har tilgang til, også holder styr på tilgangen til de ulike feltkategoriene. Tilgang til å redigere kartobjekt bestemmes av et nytt felt i Rolle-tabellen. Rolle avgjør nå også tilgangsnivået til ulike kategorier felt (0 = ingen, 1=les, 2=les/skriv). Ny tabell FeltTilgang definerer hvilken kategori hvert felt tilhører. Gyldige kategorier er kje (kjernefelt), utv (utvidete felt),sen (sensitive felt) og sys (systemfelt). En nærmere beskrivelse av APIet er inkludert i dette dokumentt. 3.1 Administrasjon av brukerkontoer og rolletilhøringhet Applikasjonen vil etter hvert få funksjonalitet for å behandle brukerkontoer og rolletilhøringhet: - For administrator: o Opprette, aktivere eller deaktivere brukerkontoer o Endre utløpsdato og egenskaper for brukerkontoer o Endre rolletilhøringhet for brukerkontoer - For brukere: o Endre eget passord o Sette nytt passord om det det eksisterende er glemt o Endre egenskaper tilknyttet egen brukerkonto (telefonnr, e-postadresse etc.) Side 3 av 11

5 3.2 Datamodell bruker/rolle/etat/felttilgang Tabeller Eksempeldata i tabeller Bruker-tabellen har brukernavn/passord, etatid (FK) og en dato som viser om konto er aktiv. For å ivareta historikk sletter vi aldri brukerkontoer. Side 4 av 11

6 Etat inneholder detaljinformasjon for hver etat. EtatGeografi inneholder kommunenummer for alle kommuner en etat har tilgang til å redigere data for. Rolle definerer tilgang (0=ingen, 1=les, 2=les/skriv) for hver rolle pr fagdatasett og type felt (kjerne, utvidete og sensitive) samt om rollen gir tilgang til å redigere geometri. FeltTilgang definerer hvilken type data hvert felt inneholder (kje=kjernedata, utv=utvidete, sen=sensitive) Side 5 av 11

7 BrukerRolle viser hvilke roller en bruker er tildelt. KommuneOppslag inneholder koordinater for utstrekning for hver kommune. Kan benyttes til hurtig filtrering av geometriobjekter og automatisk zoom i kartapplikasjoner Tabeller i Fagdatasett Eksempel fra Statlig sikra friluftslivsområder: SikraFO_Kommune (Fra fagdatasett Sikra Friluftsliv) har oversikt over hvilke(n) kommun(er) de Sikra friluftslivsområdene ligger i. Alle fagdatasett har en tilsvarende tabell. Sikrafriluftslivsomraade er et eksempel på innhold i en annen fagdatatabell (ref FeltTilgang-tabellen). Side 6 av 11

8 4. Tilgangskontroll REST API eksempel Siden sjekk mot en slik bruker- og rollemodell må gjøres fra flere ulike applikasjoner skilles koden som håndterer kontroll av bruker/rolle/tilgang i en egen REST API-applikasjon. På den måten slipper man å utvikle samme funksjonalitet flere ganger. Eksempel: - Medlemmer i Fagansvar_FS har følgende rettigheter til datasett FS: o o Les/skriv til alle standard felt, utvidede felt (f.eks. ID-felt) og sensitive felt. Les til systemfelt. De kan redigere kartobjekt. - Medlemmer i Komm_FS har følgende rettigheter til datasett FS: o o Les/skriv til alle standard felt, Les til utvidete- og systemfel og ingen tilgang til sensitive felt. De kan ikke redigere kartobjekt Under følger eksempler på spørringer/svar mot et slikt API (bruker fiktive data i datamodellen over): Side 7 av 11

9 4.1 UseCase 1 (bruker nilber og fagdatasett FS) Spørsmål: Kan bruker nilber gjøre endringer i objekt med FriluftslivID FS ? Svar: Han kan skrive til FS fordi minst en av rollene han tilhører har skrivetilgang til alle kommunene som objekt FS dekker (i dette tilfellet kun en, men for andre datasett kan det være flere). Han kan også gjøre endringer kart (geometri). Eksempel på URL: /api/objekttilgang?brukerid=nilber&objektid=fs Spørsmål: Hvilke kommuner har bruker nilber tilgang til å endre data i (merk dette sier ingenting om hvilket fagdatasett det gjelder) Svar: Siden nilber er medlem i Miljodir har han tilgang til å endre data i alle kommuner (ingen er listet siden dette er en spesialrolle). Eksempel på URL: Spørsmål: Over fant vi ut at bruker nilber har skrivetilgang til fagdatasett FS og til objektet med ID FS Hvilken tilgang har nilber til de ulike feltene i tabellen SikraFriluftslivsomraade (som er en del av fagdatasett FS)? Svar: nilber har skrivetilgang (verdi 2) til alle kategorier felt (kje (kjerne) og utv (utvidet) unntatt sys (system) der han kun kan lese. Ingen felt er av typen sen (sensitiv), men det er mulig å gi tilgang til dette også. Side 8 av 11

10 Eksempel på URL: e=fs. <forkortet> 4.2 UseCase 2 (bruker frifos og fagdatasett FS): Spørsmål: Kan bruker frifos gjøre endringer i objekt med FriluftslivID FS ? Svar: Han kan skrive til FS fordi minst en av rollene han tilhører har skrivetilgang til alle kommunene som objekt FS dekker (i dette tilfellet kun en, men for andre datasett kan det være flere). Frifos kan ikke gjøre endringer i kartdata (geometri). Eksempel på URL: Side 9 av 11

11 Spørsmål: Hvilke kommuner har bruker frifos tilgang til å endre data i (merk dette sier ingenting om hvilket fagdatasett det gjelder) Svar: Siden frifos er medlem i etaten bergenfrad har han tilgang til å endre data i kommunene 1201 og 1223 (forkortet eksempelliste). Eksempel på URL: Spørsmål: Over fant vi ut at bruker frifos har skrivetilgang til fagdatasett FS og til objektet med ID FS Hvilken tilgang har frifos til de ulike feltene i tabellen SikraFriluftslivsomraade (som er en del av fagdatasett FS)? Svar: frifos har skrivetilgang (verdi 2) til alle felt som er av type kje (kjerne), lesetilgang (verdi 1) til felt av type utv (utvidet) og sys (system). Eksempel på URL: e=fs Side 10 av 11

12 <forkortet> Side 11 av 11