Status: Utkast
Version: 0.1
Tillämpning: Pilot (i produktion)
Federationskontext: BAS
Federationsoperatör: Myndigheten för digital förvaltning, Digg
"BAS" är ett arbetsnamn som används tills vidare.
Federationskontexten BAS är en planerad första tillämpning av federationsplattformens ramverk inom Samordnad identitet och behörighet. Denna version av regelverket är framtagen för genomförande av pilot och verifiering.
Samordnad identitet och behörighets federationsplattform består av ett antal normativa artefakter som beskrivs i dokumentet Federationsplattform.
Syftet med detta dokument är att beskriva vilka delar av federationsplattformen som tillämpas inom federationskontexten BAS samt att specificera eventuella kompletteringar.
Federationskontexten BAS ska skapa en gemensam och återanvändbar grund för maskin-till-maskin-samverkan mellan aktörer.
BAS behövs eftersom teknisk tillit mellan organisationer i dag ofta etableras separat för varje informationsutbyte, sektor eller samverkanslösning. Det skapar fragmentering, parallella anslutningar och varierande sätt att beskriva, registrera och verifiera tekniska komponenter.
BAS minskar denna fragmentering genom att tillhandahålla en gemensam federationskontext där ett mottagande system kan verifiera:
a) den tekniska komponentens federativa identitet,
b) vilken organisation som ansvarar för komponenten,
c) att komponenten är registrerad enligt tillämpliga krav, och
d) att komponentens metadata och nyckelmaterial är giltigt.
BAS etablerar därmed en grundläggande nivå av teknisk och organisatorisk tillit som kan återanvändas i flera informationsutbyten.
BAS fastställer inte verksamhetsspecifika behörighetsregler, åtkomstbeslut eller villkor för vilken information som får lämnas ut i ett visst informationsutbyte. Sådana frågor hanteras i respektive verksamhetsområde, tjänst, avtal eller samverkansöverenskommelse.
BAS stödjer även användning av egenskapsintyg. Egenskapsintyg används för att uttrycka verifierbara egenskaper hos organisationer, tekniska komponenter eller funktioner inom BAS.
BAS är även ett första införandesteg för Samordnad identitet och behörighet genom att grundläggande delar av federationsplattformen prövas i pilot och förbereds för eventuell senare bredare produktionssättning.
Federationskontext är i första hand till för verksamheter inom välfärdsområdet som helt eller delvis är offentligt finansierade.
Med välfärdsområdet avses här verksamheter där offentliga aktörer, eller aktörer som utför offentligt finansierade uppgifter, behöver säker digital samverkan över organisationsgränser.
Närmare avgränsning av välfärdsområdet och vilka organisationer som för anslutas regleras i anslutningspolicy och tillämpliga avtalsvillkor.
Följande aktörer kan anslutas till BAS efter prövning enligt anslutningspolicy:
a) statliga myndigheter,
b) kommuner,
c) regioner,
d) offentligt styrda organ,
e) kommunala och regionala bolag,
f) organisationer som helt eller delvis bedriver offentligt finansierad verksamhet inom välfärdsområdet, och
g) organisationer som deltar i den tekniska realiseringen av samverkan mellan aktörer enligt ovan - exempelvis leverantörer, agenter och privata utförare.
BAS följer den svenska profilen för OpenID Federation Swedish OpenID Federation Deployment and Interoperability Profile.
Digg är federationsoperatör för BAS och ansvarar för federationskontextens gemensamma infrastrukturkomponenter och övergripande styrning.
Anslutningsoperatörer ansvarar för anslutning av federationsmedlemmar och tillhandahåller anslutningstjänster enligt federationsplattformens regelverk.
Ytterligare anslutningsoperatörer kan tillkomma efter anslutning och godkännande enligt federationsplattformens regelverk och tillämpliga anslutningspolicyer.
BAS federationsstruktur omfattar följande typer av federationsinfrastrukturtjänster:
a) tillitsankare,
b) uppslags och verifieringstjänster,
c) anslutningstjänster, och
d) egenskapsintygstjänster.
En egenskapsintygstjänst används för att utfärda eller möjliggöra verifiering av egenskapsintyg inom BAS enligt detta regelverk, tillämpliga policyer och tekniskt ramverk.
BAS OpenID Federation struktur kan visualiseras enligt bilden nedan
HÄR SKA DET IN EN NY BILD
BAS är utformad för att samverka med andra federationskontexter inom Samordnad identitet och behörighet.
Genom att BAS tillämpar federationsplattformens gemensamma regler för anslutning, registrering och teknisk interoperabilitet kan federationsmedlemmar och tekniska komponenter återanvändas även i andra federationskontexter.
Egenskapsintyg kan användas för att uttrycka ytterligare krav eller egenskaper som en annan federationskontext, samverkanskontext eller tjänst behöver kunna verifiera.
Egenskapsintyg innebär inte att en annan federationskontext automatiskt måste godta en aktör eller teknisk komponent. Den mottagande federationskontexten eller samverkanskontexten ansvarar för att ange vilka egenskapsintyg som krävs och vilken betydelse de har.
Anslutning av federationsmedlemmar BAS sker enligt Krav och vägledning för anslutning av federationsmedlemmar i federationsplattformen utan tillägg eller ändringar.
Anslutning till federationskontexten sker genom anslutningsoperatörer på uppdrag av Federationsoperatören.
Tekniska komponenter registreras av anslutningsoperatör enligt följande tillämpningskrav:
Tillämpningskrav och vägledning för verifiering av organisationskoppling
Tillämpningskrav och vägledning för verifiering av uppgiftslämnare
Tillämpningskrav och vägledning för verifiering av visningsnamn
Registrerade anslutningstjänster framgår vid varje givet tillfälle av federationsoperatörens tillitsankartjänst enligt avsnittet BAS miljöer.
Anslutning av anslutningsoperatörer till BAS sker enligt Krav och vägledning för anslutning av anslutningsoperatörer i federationsplattformen utan tillägg eller ändringar.
Anslutningstjänster registreras av federationsoperatören enligt följande tillämpningskrav:
Tillämpningskrav och vägledning för verifiering av organisationskoppling
Tillämpningskrav och vägledning för verifiering av uppgiftslämnare
Tillämpningskrav och vägledning för verifiering av visningsnamn
BAS stödjer användning av egenskapsintyg.
Egenskapsintyg används för att uttrycka en verifierbar egenskap hos en organisation, teknisk komponent eller funktion. Det kan till exempel handla om att en teknisk komponent är godkänd för ett visst ändamål, omfattas av ett visst avtal, uppfyller en viss kravprofil eller är betrodd inom en viss samverkanskontext.
Egenskapsintyg är inte verksamhetsdata. Egenskapsintyg beskriver inte den information som utbyts efter att identitet, metadata, nyckelmaterial eller behörighet har verifierats.
Egenskapsintyg är inte heller åtkomstbeslut. Den mottagande parten ansvarar för att avgöra vilken betydelse ett egenskapsintyg ska ha i ett konkret informationsutbyte.
Egenskapsintyg realiseras tekniskt som trust marks enligt OpenID Federation.
Ett trust mark är ett signerat och maskinellt verifierbart intyg i federationsmetadata. Det används för att visa att en viss organisation, teknisk komponent eller funktion har en viss egenskap.
Egenskapsintyg ska kunna verifieras genom federationsinfrastrukturen. Verifieringen ska minst kunna avse:
a) vilken egenskap intyget uttrycker,
b) vilken organisation, teknisk komponent eller funktion intyget avser,
c) vem som har utfärdat intyget,
d) att intyget är signerat av behörig utfärdare, och
e) att intyget är giltigt.
BAS stödjer federationsbetrodda egenskapsintyg.
Med federationsbetrodda egenskapsintyg avses egenskapsintyg som utfärdas av en utfärdare som är betrodd inom BAS eller inom federationsplattformen enligt tillämpligt regelverk.
Federationsbetrodda egenskapsintyg kan användas när egenskapen har betydelse för BAS som federationskontext eller för återanvändning mellan flera federationskontexter.
Ett federationsbetrott egenskapsintyg kan till exempel visa att en teknisk komponent har registrerats enligt en viss kravprofil eller att en aktör uppfyller krav som gäller inom BAS.
BAS stödjer samverkansbetrodda egenskapsintyg.
Med samverkansbetrodda egenskapsintyg avses egenskapsintyg som accepteras inom en viss samverkan, tjänst, sektor eller samverkanskontext.
Samverkansbetrodda egenskapsintyg kan utfärdas av andra utfärdare än de som är federationsbetrodda, om utfärdaren accepteras inom den aktuella samverkanskontexten.
Ett samverkansbetrott egenskapsintyg kan till exempel visa att en teknisk komponent är betrodd av en viss aktör eller inom en viss tjänst.
I denna version av BAS stödjer regelverket både federationsbetrodda och samverkansbetrodda egenskapsintyg.
Det innebär att BAS kan bära och möjliggöra verifiering av egenskapsintyg oberoende av om de utfärdas av:
a) federationsanknutna utfärdare, eller
b) andra utfärdare som accepteras inom en samverkanskontext.
Den aktör eller samverkanskontext som kräver ett egenskapsintyg ansvarar för att ange:
a) vilket egenskapsintyg som krävs,
b) vem som får utfärda egenskapsintyget,
c) vilken teknisk komponent, organisation eller funktion intyget får avse,
d) vilken betydelse intyget har i samverkan, och
e) hur intyget ska kontrolleras.
Egenskapsintyg inom BAS avser inte i sig en medarbetares juridiska behörighet, yrkesroll, fullmakt, delegation eller rätt att agera i ett enskilt ärende.
Sådana uppgifter ska hanteras genom behörighetsintyg, behörighetshandlingar eller andra former av behörighetsgrundande information enligt tillämpliga regelverk, avtal eller verksamhetsspecifika villkor.
Egenskapsintyg kan däremot användas som ett underlag i en samlad åtkomstbedömning, tillsammans med annan information som den mottagande parten har rätt att använda.
Utfärdaren av ett egenskapsintyg ansvarar för att intyget har utfärdats enligt de krav som gäller för den aktuella intygstypen.
Den federationsmedlem som lämnar uppgifter som underlag för ett egenskapsintyg ansvarar för att uppgifterna är korrekta och aktuella.
Den mottagande parten ansvarar för hur egenskapsintyget används i ett informationsutbyte, en åtkomstbedömning eller annan samverkansbedömning.
Federationsoperatören ansvarar inte för det materiella innehållet i ett egenskapsintyg, om inte federationsoperatören själv är utfärdare av det aktuella egenskapsintyget.
Följande egenskapsintyg kan användas inom BAS.
| Egenskapsintyg | Utfärdare | Innebörd |
|---|---|---|
| EHDS tillgångstjänst | EHM | Intygar att komponenten är en av EHM betrodd tillgångstjänst (ref: https://...) |
| ... | ... | ... |
BAS tillämpas i denna version för pilot och verifiering. Deltagande i piloten förutsätter särskild pilotöverenskommelse mellan berörda parter. Pilotöverenskommelsen ska minst reglera:
a) vilka parter som deltar och i vilka roller,
b) vilken miljö som används,
c) tillåten användning av data,
d) incidentrapportering och kontaktvägar,
e) ansvar för registrerad metadata och nyckelmaterial,
f) hantering av felaktig publicering, återkallelse och avstängning,
g) avveckling och exit, samt
h) hur lärdomar från piloten återförs till federationsplattformens regelverk,
i) vilka egenskapsintyg som används inom piloten,
j) vem som får utfärda, återkalla och verifiera egenskapsintyg inom piloten, och
k) vilken betydelse egenskapsintygen ska ha inom pilotens informationsutbyte.
BAS tillhandahålls i separata miljöer för olika ändamål. Varje miljö har egen metadata, egna nycklar och eget tillitsankare. Miljöerna är logiskt separerade från varandra men följer samma federationsregler och tekniska specifikationer.
Följande miljöer ingår i BAS.
Syfte: Test och utveckling.
Tillitsankarets identitet: https://fed.sandbox.ena-infrastructure.se/ta
Adress för upptäckt av federationsentiteter: https://fed.sandbox.ena-infrastructure.se/ta/discovery
Adress för hämtning av federationsmetadata: https://fed.sandbox.ena-infrastructure.se/ta/fetch
Adress för upplösning av förtroendekedjor: https://fed.sandbox.ena-infrastructure.se/ta/resolve
Adress för listning av underordnade federationsentiteter: https://fed.sandbox.ena-infrastructure.se/ta/subordinate_listing
Tillitsankarets federationsnycklar:[anges senare]
Tillämpning: Ej produktionsdata, om inte annat särskilt anges.
URL: [anges senare]
Syfte: Verifiering inför produktionssättning.
Tillämpning: Begränsad verifiering enligt fastställda villkor.
URL: [anges senare]
Syfte: Skarp användning av BAS.
Tillämpning: Produktion enligt detta federationsregelverk och tillämpliga avtal.
BAS bygger på ett antal tekniska specifikationer och profiler som tillsammans skapar förutsättningar för interoperabel användning av OpenID Federation, OAuth 2.0.
Specifikationerna och profilerna definierar hur metadata ska struktureras, publiceras och verifieras, hur protokollentiteter ska samverka samt vilka krav som gäller för interoperabilitet inom federationskontexten.
Följande specifikationer och profiler är normativa för BAS.
Swedish OpenID Federation Deployment and Interoperability Profile 1.0 - draft 01
OpenID Federation Organization Identifier Metadata Parameter 1.0 - draft 01
OpenID Federation Registration Policy 1.0 - draft 01
Ena OAuth 2.0 Interoperability Profile
OpenID Federation Trust Marks enligt tillämplig profil
Omfattningen av BAS tillämpning av Ena OAuth 2.0 Interoperability Profile är inte slutligt fastställd och kommer att preciseras i det fortsatta pilotarbetet]