Page History

...

Federationsplattformens federationsramverk

Federationsplattformen består av ett federationsramverk (benämns fortsättningsvis som "Federationsramverket") som avser att normera och harmonisera teknik, ansvar och roller för olika typer av federationskontexter. Genom en gemensam normering kan interoperabilitet åstadkommas över federationskontexter. 

Om detta dokument

Syftet med detta dokument är att ange vilken version och vilka delar av federationsramverket som tillämpas inom federationskontexten BAS, att specificera de kompletteringar som krävs för att kontexten ska kunna tillämpas i praktiken, samt att ange hur regelverket blir bindande för de parter som deltar.

Detta dokument utgör det som benämns Federationsregelverk BAS.

Regelverkets rättsliga ställning

Vad detta regelverk är

Detta regelverk utgör avtalsvillkor för de parter som tecknar avtal om att nyttja Federationskontext BAS.

Federationsoperatören förvaltar och fastställer avtalsvillkoren i detta dokument. Federationsoperatören får inte omdefiniera federationsplattformens gemensamma begrepp, roller eller tekniska grundprinciper utan dokumenterad, motiverad och konsekvensbedömd ändring som godkänts av ledningsaktören.

Hur bundenhet uppstår

...

Om detta dokument

Detta dokument utgör Federationsregelverk BAS, det vill säga det kontextspecifika regelverket för federationskontexten BAS. Dokumentet anger vilka delar av Federationsramverket som tillämpas inom BAS, de kompletteringar som krävs för att kontexten ska kunna tillämpas i praktiken och hur regelverket blir bindande för de parter som deltar.

Federationsramverkets uppbyggnad, syfte och styrning beskrivs i ramverket självt och återges inte här.

Detta dokument utgör det som benämns Federationsregelverk BAS.

Regelverkets rättsliga ställning

Vad detta regelverk är

Detta regelverk utgör avtalsvillkor för de parter som tecknar avtal om att nyttja Federationskontext BAS.

Federationsoperatören förvaltar och fastställer avtalsvillkoren i detta dokument. 

Hur bundenhet uppstår

En part blir bunden av detta regelverk genom En part blir bunden av detta regelverk genom att i avtal med sin motpart åta sig att följa det.

...

Hänvisning till detta regelverk avser regelverket i den lydelse som gäller från tid till annan, med de begränsningar och det skydd som följer av avsnittet Förändring av detta regelverk.

Hänvisning till ett villkor/villkorsdokument ramverksdokument i Federationsramverket avser den version som vid varje tidpunkt är beslutad av ledningsaktören enligt Bilaga C .

Rangordning

Vid motstridighet gäller följande ordning, med den först nämnda handlingen före den senare:

- Förändringspolicy för federationsplattformen. För tekniska specifikationer och profiler gäller dessutom att hänvisningarna är versionsbestämda enligt Bilaga B - Tekniskt ramverk avsnitt 1, vilket innebär att en ändring hos extern utgivare inte i sig ändrar vad som är bindande.

Hänvisning till en vägledningstext i Federationsramverket medför inte att texten blir bindande. Vägledning är enligt Bilaga A - Definitioner informativ och inför inga nya krav.

Rangordning

Vid motstridighet gäller följande ordning, med den först nämnda handlingen före den senare:

1. Tvingande rätt
2. Federationsramverkets nyttjandevillkor, bilagorna A till D
3. Federationsramverkets krav
4. Detta regelverk med bilagor
5. Tvingande rätt
6. Federationsramverkets nyttjandevillkor, bilagorna A till D
7. Federationsramverkets krav och vägledningar
8. Detta regelverk
9. Det enskilda avtalet

Kommentar: Rangordningen innebär att regelverket går före avtalet. Det är motiverat av enhetlighetsskälet men innebär att parterna inte kan avtala om avvikande villkor i frågor Federationsramverket reglerar. Ska undantag tillåtas, och i så fall för vilka frågor? Se avsnittet Vad som inte får avvikas från.

...

• Definitioner enligt Bilaga A
• Roller och ansvar enligt Bilaga D
• Ansvarsmodellen (inkl Ansvarsbegränsningen) enligt avsnittet Ansvar
• Direktkravsrätten enligt avsnittet Direktkravsrätt
• Genomförandeplikten enligt avsnittet Genomförandeplikt

Övriga frågor får kompletteras i avtal, under förutsättning att kompletteringen inte sänker tillitsnivån under vad detta regelverk angerden nivå som följer av Federationsramverket eller av detta regelverk.

Syfte

Federationskontexten BAS ska skapa en gemensam och återanvändbar grund för maskin till maskin-samverkan mellan aktörer.

...

Efter genomförd och utvärderad pilot kommer breddas målgruppen att breddas, i ett första steg för de i takt med att behov identifieras och prövas. Det först identifierade behovet avser aktörer som ska nyttja den nationella digitala infrastrukturen för hälsa, vård och omsorg (NDI), i senare steg för en större målgrupp i andra tillämpningar.

Federationsstruktur

BAS följer den svenska profilen för OpenID Federation, Swedish OpenID Federation Deployment and Interoperability Profile.

. BAS är inte avgränsad till ett enskilt verksamhetsområde.

Vilka parter som får delta under piloten framgår av Bilaga 4, Pilotens omfattning och begränsningar.

Federationsstruktur

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 enligt Federationsramverket och detta regelverk.

BAS federationsstruktur omfattar följande typer av federationsinfrastrukturtjänster:

• a) tillitsankare,
• b) uppslags- och verifieringstjänster, och
• c) anslutningstjänster.

De specifikationer och profiler som är normativa för BAS anges i Bilaga 2, Specifikationer och profiler.

Anslutning

Anslutning av federationsmedlem

...

Anslutning av anslutningsoperatörer till BAS sker enligt Tillämpningskrav vid anslutning av anslutningsoperatörer i Federationsramverket, utan tillägg eller ändringar.

Anslutningstjänster registreras av federationsoperatören enligt följande tillämpningskrav:

Anslutningsoperatören ska därutöver uppfylla Grundläggande krav på federationsinfrastrukturtjänster och styrka detta genom tredjepartsutlåtande enligt det dokumentets avsnitt 3.

Beslut om godkännande av anslutningsoperatör fattas av federationsoperatören.

Anslutningstjänster registreras av federationsoperatören enligt följande tillämpningskrav:

1. Tillämpningskrav och Tillämpningskrav och vägledning för verifiering av organisationskoppling
2. Tillämpningskrav och vägledning för verifiering av uppgiftslämnare
3. Tillämpningskrav och vägledning för verifiering av visningsnamn

...

• a) uppfyller Grundläggande krav på federationsinfrastrukturtjänster,
• b) publicerar  publicerar signerad metadata enligt de specifikationer och profiler som anges i avsnittet Specifikationer och profilerBilaga 2,
• c)
hanterar nyckelmaterial så att privata nycklar skyddas mot obehörig åtkomst och användning, med dokumenterad rutin för generering, förvaring, rotation och återkallelse,
• d) är tillgänglig i minst [ANGE NIVÅ] mätt per kalendermånad, exklusive planerat underhåll,
• e) har dokumenterad rutin för planerat underhåll med varsel om minst [ANGE TID] till federationsoperatören, och
• f) kan genomföra nödåterkallelse och nyckelrotation utan onödigt dröjsmål, dock senast inom [ANGE TID] från det att kompromettering konstaterats eller misstänks.

Anslutningsoperatören SKA utan dröjsmål underrätta federationsoperatören vid misstänkt eller konstaterad kompromettering av nyckelmaterial.

Kommentar: Nivåerna är avsiktligt tomma och beror på hur SLA-kraven definieras. De bör sättas lägre i piloten och kommer med stor sannolikhet vara i högre i senare steg

Federationsoperatörens tjänsteåtaganden

Federationsoperatören SKA tillhandahålla tillitsankartjänst samt uppslags- och verifieringstjänst enligt Bilaga B - Tekniskt ramverk och Grundläggande krav på federationsinfrastrukturtjänster.

Federationsoperatören SKA säkerställa att dessa tjänster är tillgängliga i minst [ANGE NIVÅ] mätt per kalendermånad, exklusive planerat underhåll.

Federationsoperatören SKA varsla om planerat underhåll minst [ANGE TID] i förväg till samtliga anslutningsoperatörers kontaktpunkter.

Federationsoperatören SKA ha dokumenterad plan för återställning vid avbrott, med en målsatt återställningstid om högst [ANGE TID].

Vid misstänkt eller konstaterad kompromettering av tillitsankarets nyckelmaterial SKA federationsoperatören utan dröjsmål underrätta samtliga anslutningsoperatörer, besluta om nödåtgärd och informera om vilka åtgärder anslutna parter ska vidta.

•  uppfyller de tjänstenivåer och driftvillkor som anges i Bilaga 3.

Anslutningsoperatören SKA utan dröjsmål underrätta federationsoperatören vid misstänkt eller konstaterad kompromettering av nyckelmaterial.

Federationsoperatörens tjänsteåtaganden

Federationsoperatörens ansvar följer av Bilaga D — Roller och ansvar avsnitt 3.1. Inom BAS gäller därutöver följande.

Federationsoperatören SKA uppfylla de tjänstenivåer och driftvillkor som anges i Bilaga 3.

Federationsoperatören SKA tillämpa kraven på anslutningsoperatörer lika för samtliga och dokumentera grunden för sina bedömningar.

Vid misstänkt eller konstaterad kompromettering av tillitsankarets nyckelmaterial SKA federationsoperatören utan dröjsmål underrätta samtliga anslutningsoperatörer, besluta om nödåtgärd och informera om vilka åtgärder anslutna parter ska vidta.

Federationsoperatörens åtaganden enligt detta regelverk gäller inom ramen för myndighetens uppdrag. Om uppdraget väsentligen ändras eller upphör SKA federationsoperatören underrätta anslutningsoperatörerna utan dröjsmål, som i sin tur SKA informera sina federationsmedlemmar. Parterna SKA därefter samråda om hur avtalen ska hanteras.

Uppföljning, tillsyn och revision

Federationsoperatörens uppföljning av anslutningsoperatörer sker enligt Tillämpningskrav vid anslutning av anslutningsoperatörer avsnitt 9 och Grundläggande krav på federationsinfrastrukturtjänster avsnitt 3. Detta omfattar periodisk re-verifiering, fysisk revision, händelsestyrd re-verifiering, uppföljning av tredjepartsutlåtande och stickprovsbaserad uppföljning av ärendedokumentation.

Anslutningsoperatören SKA i avtal medge att federationsoperatören, eller den federationsoperatören anlitar, får genomföra fysisk revision i anslutningsoperatörens lokaler samt ge tillgång till relevanta lokaler, personal och dokumentation. Medgivandet SKA framgå av operatörsavtalet.

Revisionsplan och syfte SKA kommuniceras minst [ANGE TID] i förväg, utom vid händelsestyrd revision där kortare varsel får tillämpas.

Vardera part bär sina egna kostnader för revisionen. Om revisionen visar väsentliga avvikelser SKA anslutningsoperatören ersätta federationsoperatörens skäliga kostnader för uppföljande revision.

Uppgifter som federationsoperatören får del av vid uppföljning och revision hanteras enligt avsnittet Offentlighet och sekretess.

KOMMENTAR: Federationsoperatören genomför inte revision hos federationsmedlemmar, eftersom något avtalsförhållande inte finns. Uppföljningen av medlemmar sker enligt Tillämpningskrav vid anslutning av federationsmedlemmar avsnitt 7 och utförs av anslutningsoperatören. Frågan om federationsoperatören ska kunna nå en federationsmedlem direkt vid misstanke om allvarlig brist behöver diskuteras.Kommentar: Tillitsankaret är enskild felkälla för samtliga parter i kontexten, även här bör nivårna sättas lägre i pilot för att med stor sannolikhet höjas i senare steg

Kontaktpunkter och meddelanden

...

Underrättelse SKA lämnas även när utredning pågår och orsaken ännu inte är fastställd.

Samordning

Federationsoperatören samordnar hanteringen av incidenter som berör flera parter i kontexten och beslutar Federationsoperatörens samordning av incidenter följer av Bilaga D - Roller och ansvar avsnitt 3.1.2.4. Beslut om åtgärder på federativ nivå fattas enligt avsnittet Återkallelse, begränsning och avstängning.

Återkallelse, begränsning och avstängning

...

Beslut om begränsning, avstängning och uppsägning på federativ nivå fattas av federationsoperatören, i enlighet med Bilaga D - Roller och ansvar avsnitt 3.1.2.3.

Anslutningsoperatören SKA vidta de åtgärder federationsoperatören beslutar om och får inte utan federationsoperatörens godkännande besluta om avstängning eller uppsägning av en federationsmedlem.

Med avstängning eller uppsägning enligt föregående stycke avses federativ avstängning, det vill säga att federationsmedlemmens deltagande i federationskontexten upphör eller begränsas. Anslutningsoperatörens rätt att säga upp sitt eget avtal med federationsmedlemmen på kommersiell grund berörs inte. Anslutningsoperatören SKA i sådant fall underrätta federationsoperatören utan dröjsmål och medverka till att federationsmedlemmen kan byta anslutningsoperatör enligt avsnittet Avveckling och operatörsbyte.

Anslutningsoperatören FÅR utan föregående godkännande vidta Anslutningsoperatören FÅR utan föregående godkännande vidta åtgärd enligt b ovan när det krävs för att avvärja en akut risk, och SKA i så fall underrätta federationsoperatören utan dröjsmål.

...

• a) använda federationsoperatörens namn, logotyp eller andra kännetecken på ett sätt som inte uttryckligen medgivits,
• b) framställa det som att federationsoperatören eller ledningsaktören rekommenderar, godkänner eller står bakom partens tjänster utöver den roll parten faktiskt innehar,
• c) använda uttryck som ger intryck av att parten företräder federationsoperatören, eller
• d) fortsätta att ange sin roll i federationskontexten efter det att anslutningen upphört.

Federationsoperatören FÅR publicera uppgift om vilka parter som är anslutna och i vilka roller.

Vid begränsning eller avstängning SKA parten på federationsoperatörens begäran upphöra med kommunikation som anger den aktuella rollen.

Kommentar: Skyddet för statliga myndigheters namn och kännetecken följer delvis av särskild lagstiftning(?) Även frågan om användning av benämningen "BAS" som är ett arbetsnamn bör hanteras.

Förändring av detta regelverk

Ändringskompetens

Federationsoperatören beslutar om ändringar i Federationsregelverk BAS.

Klassificering

Mindre ändring: ändring som inte i sak skärper parts åtaganden, påverkar etablerad tillit eller kräver teknisk eller organisatorisk anpassning hos anslutna parter.

Väsentlig ändring: ändring som inför nya krav, skärper befintliga krav, förändrar ansvarsfördelning eller kräver teknisk eller organisatorisk anpassning hos anslutna parter.

Brådskande ändring: ändring som krävs för att hantera allvarlig säkerhetsrisk, uppfylla tvingande rätt eller följa myndighetsbeslut och som inte kan avvakta normal ändringsprocess.

Samråd

Före väsentlig ändring SKA federationsoperatören genomföra dokumenterat samråd med anslutningsoperatörerna. Samrådstiden SKA vara skälig i förhållande till ändringens komplexitet och konsekvenser, dock minst [ANGE TID].

Avisering

Beslutad ändring SKA publiceras på fastställt publiceringsställe och aviseras till anslutningsoperatörernas kontaktpunkter. Anslutningsoperatören SKA vidarebefordra aviseringen till sina federationsmedlemmar.

Aviseringen SKA minst ange vilken del av regelverket som ändras, tidigare och ny version, ändringsklass, anpassningstid och ikraftträdande, eventuell övergångsperiod, huvudsakliga konsekvenser samt eventuell uppsägningsrätt.

Anpassningstid och övergångsperiod

Vid väsentlig ändring SKA en övergångsperiod tillämpas under vilken både tidigare och ny lydelse kan tillämpas. Övergångsperioden SKA vara minst lika lång som anpassningstiden.

Uppsägningsrätt

Part som inte accepterar en väsentlig ändring har rätt att säga upp sitt avtal inom den frist som anges i aviseringen, dock minst tre månader från aviseringstidpunkten. Uppsägningen befriar inte parten från skyldigheten att medverka till ordnad avveckling.

Ändringar i Federationsramverket

Ändringar i federationsramverket hanteras enligt Bilaga C - Förändringspolicy för federationsramverket. Federationsoperatören ansvarar för att vidarebefordra avisering till anslutningsoperatörerna, som ansvarar för att informera federationsmedlemmarna.

Kommentar: Detta avsnitt speglar Bilaga C men på kontextnivå. Anpassningstiderna i Bilaga C avsnitt är för tillfället tomma. Övergångsperioden ska vara minst lika lång som anpassningstiden.

Versionshantering och spårbarhet

Varje ändring av detta regelverk SKA dokumenteras med versionsnummer före och efter, datum för beslut och ikraftträdande, beskrivning, motivering, ändringsklass och eventuellt samrådsunderlag.

Tidigare versioner SKA hållas tillgängliga så att det i efterhand kan fastställas vilken lydelse som gällde vid en viss tidpunkt.

Kommentar: Även Federationsramverket behöver versionshanteras och i detta regelverk bör övervägas att låsa vid en bestämt version för att få ett mer förutsägbart sammanhållet avtal och villkor mellan parterna

Miljöer

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 men följer samma federationsregler och tekniska specifikationer.

Sandbox

• 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.

QA

[anges senare om tillämpligt - i dagsläget inte planerat]

• Syfte: verifiering inför produktionssättning.
• Tillämpning: begränsad verifiering enligt fastställda villkor.

Produktion

[anges senare]

• Syfte: skarp användning av BAS.
• Tillämpning: produktion enligt detta regelverk och tillämpliga avtal.

Kommentar: Uppgifterna behöver finnas innan avtal tecknas. Sen kan man överväga om de tekniska detaljer ska brytas ut till en egen bilaga

Specifikationer och profiler

Följande specifikationer och profiler är normativa för BAS.

Kommentar: Ena OAuth 2.0 Interoperability Profile behöver slutligt fastställas till en v.1.0.

Pilotens omfattning och begränsningar

Denna version av regelverket tillämpas för pilot och verifiering.

Piloten genomförs i produktion med verkliga system. Att verksamheten benämns pilot innebär inte att parternas ansvar är begränsat i annan utsträckning än vad som följer av detta regelverk och tillämpliga avtal.

Deltagande i piloten förutsätter avtal mellan berörda parter. Avtalen 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.

• att ange sin roll i federationskontexten efter det att anslutningen upphört.

Federationsoperatören FÅR publicera uppgift om vilka parter som är anslutna och i vilka roller.

Vid begränsning eller avstängning SKA parten på federationsoperatörens begäran upphöra med kommunikation som anger den aktuella rollen.

Kommentar: Skyddet för statliga myndigheters namn och kännetecken följer delvis av särskild lagstiftning(?) Även frågan om användning av benämningen "BAS" som är ett arbetsnamn bör hanteras.

Förändring av detta regelverk

Ändringskompetens

Federationsoperatören beslutar om ändringar i Federationsregelverk BAS.

Klassificering

Mindre ändring: ändring som inte i sak skärper parts åtaganden, påverkar etablerad tillit eller kräver teknisk eller organisatorisk anpassning hos anslutna parter.

Väsentlig ändring: ändring som inför nya krav, skärper befintliga krav, förändrar ansvarsfördelning eller kräver teknisk eller organisatorisk anpassning hos anslutna parter.

Brådskande ändring: ändring som krävs för att hantera allvarlig säkerhetsrisk, uppfylla tvingande rätt eller följa myndighetsbeslut och som inte kan avvakta normal ändringsprocess.

Samråd

Före väsentlig ändring SKA federationsoperatören genomföra dokumenterat samråd med anslutningsoperatörerna. Samrådstiden SKA vara skälig i förhållande till ändringens komplexitet och konsekvenser, dock minst [ANGE TID].

Avisering

Beslutad ändring SKA publiceras på fastställt publiceringsställe och aviseras till anslutningsoperatörernas kontaktpunkter. Anslutningsoperatören SKA vidarebefordra aviseringen till sina federationsmedlemmar.

Aviseringen SKA minst ange vilken del av regelverket som ändras, tidigare och ny version, ändringsklass, anpassningstid och ikraftträdande, eventuell övergångsperiod, huvudsakliga konsekvenser samt eventuell uppsägningsrätt.

Anpassningstid och övergångsperiod

Vid väsentlig ändring SKA en övergångsperiod tillämpas under vilken både tidigare och ny lydelse kan tillämpas. Övergångsperioden SKA vara minst lika lång som anpassningstiden.

Uppsägningsrätt

Part som inte accepterar en väsentlig ändring har rätt att säga upp sitt avtal inom den frist som anges i aviseringen, dock minst tre månader från aviseringstidpunkten. Uppsägningen befriar inte parten från skyldigheten att medverka till ordnad avveckling.

Ändringar i Federationsramverket

Ändringar i federationsramverket hanteras enligt Bilaga C - Förändringspolicy för federationsramverket. Federationsoperatören ansvarar för att vidarebefordra avisering till anslutningsoperatörerna, som ansvarar för att informera federationsmedlemmarna.

Kommentar: Detta avsnitt speglar Bilaga C men på kontextnivå. Anpassningstiderna i Bilaga C avsnitt är för tillfället tomma. Övergångsperioden ska vara minst lika lång som anpassningstiden.

Versionshantering och spårbarhet

Varje ändring av detta regelverk SKA dokumenteras med versionsnummer före och efter, datum för beslut och ikraftträdande, beskrivning, motivering, ändringsklass och eventuellt samrådsunderlag.

Tidigare versioner SKA hållas tillgängliga så att det i efterhand kan fastställas vilken lydelse som gällde vid en viss tidpunkt.

Kommentar: Även Federationsramverket behöver versionshanteras och i detta regelverk bör övervägas att låsa vid en bestämt version för att få ett mer förutsägbart sammanhållet avtal och villkor mellan parterna

Bilagor till detta regelverk

Följande bilagor utgör en del av detta regelverk:

• Bilaga 1, Miljöer och tekniska adresser
• Bilaga 2, Specifikationer och profiler
• Bilaga 3, Tjänstenivåer och driftvillkor
• Bilaga 4, Pilotens omfattning och begränsningar

Ändring av bilaga klassificeras och hanteras enligt avsnittet Förändring av detta regelverk. Att en bestämmelse är placerad i bilaga innebär alltså ingen lättnad i ändringsförfarandetPunkterna d till g regleras i huvudsak i detta regelverk. Avtalen kompletterar med det som är partsspecifikt.