Inledning

Denna sida beskriver administrativa processer vid anslutning till federationen samt vilka avtal som måste upprättas.  Processerna skiljer beskriver det som sker mellan operatörer som bygger upp federationen och federationsmedlemmar som nyttjar federationen.

Det finns också övergripande information om teknisk påverkan utan att gå in på detaljer.

Summering

Processbeskrivningarna följer följande mönster i separata processer där för varje process beskrivs vilken teknisk påverkan det medför och hur det påverkar avtalssituationen:

• Ledningsaktören utser en Federationsoperatör som i sin tur utser övriga operatörer
• Godkännande av organisation där organisation antingen kan vara operatör eller federationsmedlem
• Revokering av organisation
• Godkännande av en organisations roll
• Revokering av en organisations roll
• Godkännande av komponenter som tillförs federationen
• Revokering av komponenter
• Utfärdande av tillitsmärken
• Revokering av tillitsmärken

Hantering av federationsmedlemmars godkännande och komponenter sker alltid via en anslutningsoperatör och en tillitsoperatör.

Avtalen  som tecknas mellan parterna ska  beskriva rättigheter och skyldigheter i federationen. Detta beskrivs mera i detalj i Avtalsstruktur.

...

För att bättre förstå hur federationsstrukturen är uppbyggd och de roller och begrepp som används här, se Federationsinfrastruktur och Termer och begrepp. Sidan börjar med dock med en sammanfattning av de principer som gäller för federationsinfrastrukturen och hur den kan nyttjas.

Sammanfattning

Tjänster och ansvar i Ena

Detta avsnitt sammanfattar vilka tjänster som gäller generellt för alla federationer av typen OpenID federation men tar även upp specifika roller som finns inom Ena.

Vi skiljer på aktörer som hanterar infrastruktutjänster och federationsmedlemmar som nyttjar federationsinfrastrukturen.

Diagrammet nedan visar på hur det ser ut om ledningsaktören (Ena-specifik roll) hanterar alla roller och tillhandahåller alla infrastrukturtjänster i federationen utan den skalbarhet som delegering innebär. Federationsmedlemmarna svarar för sina egna tjänster i form av komponenter.

Ledningsaktören är ansvarig för federationsinfrastrukturen men kan delegera vissa uppgifter till andra organisationer som agerar aktörer inom infrastrukturen. Vilka uppgifter som måste finnas hos ledningsaktören och vilka som kan delegeras beskrivs i Federationsinfrastruktur. Nedan en bild på hur delegeringen ser ut principiellt.

Tillitsankartjänst, tillitsmärkestjänst, anslutningstjänst och uppslags- och verifieringstjänst är infrastrukturtjänster inom federationsinfrastrukturen. Dessa tjänster bygger upp tillitskedjan i federationen.

Tillitskedjan möjliggör teknisk verifiering av tilliten från en komponent, till exempel en Auktorisationstjänst,  till tillitsankare i en hierarkisk struktur. Se diagram nedan för hur tjänstestrukturen är uppbyggd (från Federationsinfrastruktur)

...

...

...

Innehållsförteckning

Avgränsningar

Utanför denna beskrivning är

• Vilka vilka tillitsankare som kommer att finnas.
• Vilka vilka specifika krav som gäller för varje anslutningsprocess. 
• Vilka vilka tillitsmärken som kan utfärdas.
• Vilka vilka typer av komponenter som kommer att finnas.

...

• vilka stödsystem en organisation behöver för att upprätta sin funktion i federationen
• detaljer vad gäller teknisk påverkan vid anslutning
• detaljer i avtal mellan organisationer

Processbeskrivningar för anslutningar

Tillitsoperatör skapar tillitsankare

• Tillitsankarets metadata kommer aldrig att ha tillitsmärke men kan innehålla specika attribut för som är unika för just det tillitsankaret
• Rotcertifikatet som finns i tillitsankarets i publicerad metadata är grunden för tillit för alla federationsmedlemmar.
• Borttag av ett tillitsankare bryter tilliten i kedjan och påverkar samtliga anslutna operatörer och federationsmedlemmar

...

Ledningsaktör utser federationsoperatör

lyft upp detaljer i text.

Processbeskrivningarna följer följande mönster i separata processer där för varje process beskrivs vilken teknisk påverkan det medför och hur det påverkar avtalssituationen:

• Organisationen godkänns i en roll  av en annan organisation, detta leder ibland till ett avtal och ibland till någon form av teknisk förändring.
• Teknisk förändring i form av hantering av metadata beskrivs i detalj i Federationsinfrastruktur
• Avtalen  som tecknas mellan parterna ska  beskriva rättigheter och skyldigheter i federationen. Detta beskrivs mera i detalj i Avtalsstruktur Open ID federation.
• Processen beskrivs i textformat och i ett enklare flödesdiagram.

Ledningsaktör godkänner federationsoperatör: avtal, tillitsankartjänst, metadata

• Ledningsaktören tar emot ansökan från den ansökande organisationen Ledningsaktören tar emot ansökan och kontrollerar om den är komplett, annars begär ledningsaktören mer information
• Ledningsaktören kontrollerar om den ansökande organisationen tillhör en kategori av organisationer som tillåts vara federationsoperatör
• Ansökan granskas av ledningsaktören och kan leda till ett godkännande då metadata kan skapas och ett avtal för att se om kraven uppfylls
• Om kraven uppfylls kan organisationen godkännas som federationsoperatör:
  • Avtal mellan ledningsaktören och den nyblivna
operatören upprättas eller alternativt kan ansökan underkännas på grund av att kraven inte uppfylls
• • federationsoperatören upprättas
  • Federationsoperatören upprättar tillitsankartjänsten
  • Federationsoperatören upprättar en uppslags- och verifieringstjänst
  • Federationsoperatören lägger upp sin egen metadata
  • Federationsoperatören kan nu agera som tillitsankare i federationen
  • Federationsoperatören kan godkänna anslutningsoperatörer och godkänna tillitsoperatörer
  • Federationsoperatören kan revokera anslutningsoperatörer och revokera tillitsoperatörer
• Om den ansökande organisationen inte uppfyller kraven eller inte tillhör kategorin av organisationer som tillåts vara federationsoperatörer, avslås ansökan.

Ledningsaktör revokerar federationsoperatör och tillitsankartjänst

• När en federationsoperatör blir godkänd börjar en process för att övervaka dess kravuppfyllnad
• Om det upptäcks att kraven inte uppfylls så behöver beslutet att godkänna organisationen omprövas och utvärderas igen
• Om avvikelserna inte kan åtgärdas så revokeras federationsoperatörens status och dess metadata tas bort samt avtalet innebär det att
  •  federationsoperatörens status revokeras och tillitsankaret tas bort
  •  avtalet mellan ledningsaktören och
  federationsoperatören
  • federationsaktören sägs upp
  Anslutningsoperatörer, Tillitsopertörer och Federationsmedlemmar som blivit godkända eller indirekt godkända  av federationsoperatören förlorar sin medlemsstatus och metadata revokeras.
  •  tillitskedjan bryts för samtliga underliggande parter

Federationsoperatör

...

godkänner anslutningsoperatör: avtal, anslutningstjänst, metadata

• Federationsoperatören godkänner ansökan om ansökan är giltig och om den ansökande organisationen uppfyller kraven
• Den ansökande
organisationens metadata uppdateras med tillitsmärke
• organisationen kan upprätta en anslutningstjänst i egenskap av anslutningsoperatör efter avtal med federationsoperatören
• Denna operation kan sägas vara en delegering av ansvar från federationsoperatören och innebär, förutom en anslutningstjänst hos anslutningsoperatören, ett antal åtgärder i metadata hos federationsoperatörens tillitsankartjänst och anslutningsoperatörens anslutningstjänst
• Anslutningsoperatören kan nu utföra dessa operationer:
  • Godkänna federationsmedlemmar
  • Godkänna federationsmedlemmars komponenter
  • Revokera federationsmedlemmar
  • Revokera federationsmedlemmars komponenter

...

Federationsoperatör revokerar

...

anslutningsoperatör och anslutningstjänst

• Ledningsaktören Federationsoperatören identifierar vilken operatör anslutningsoperatör som behöver utredas för överträdelse
• Om inte operatören anslutningsoperatören kan redovisa svar som är acceptabla inleds en revokeringsprocess och tillitsmärket tas bort.anslutningsoperatörens metadata blir invalida i federationen.
• Detta får konsekvenser för de  De federationsmedlemmar som blivit godkända via operatören förlorar sin medlemsstatus och deras metadata blir invalida i federationenanslutningsoperatören.

...

 Anslutningsoperatör godkänner federationsmedlem: avtal

• Operatören Anslutningsoperatören tar emot ansökan och kontrollerar om den är komplett, annars begär operatören mer information
• Operatören Anslutningssoperatören kontrollerar om den ansökande organisationen tillhör en kategori av organisationer som tillåts vara federationsmedlem
• Ansökan granskas av operatören anslutningsoperatören och kan leda till ett godkännande då metadata kan skapas och signeras och kundregistret hos anslutningsopertören uppdateras och ett avtal mellan operatören anslutningsoperatören och den nyblivna federationsmedlemmen upprättas eller alternativt kan ansökan underkännas på grund av att kraven inte uppfyllsuppfylls

...

Anslutningsoperatör revokerar federationsmedlem och avtalet sägs upp

• När en federationsmedlem blir godkänd börjar en process för att övervaka dess kravuppfyllnad
• Om det upptäcks att kraven inte uppfylls så behöver beslutet att godkänna organisationen omprövas och utvärderas igen
• Om avvikelserna inte kan åtgärdas så revokeras federationsmedlemen status och dess signerade metadata tas bort samt avtalet mellan operatören och federationsmedlemen sägs upp

...

Anslutningsoperatör godkänner federationsmedlemmars komponenter: metadata

• En federationsmedlems komponent av typen RP, OP, AS, API eller API-klient kan bli godkänd av en operatör anslutningsoperatör genom en ansökan
• Den första kontrollen är om den ansökande organisationen är en federationsmedlemfederationsmedlem och är kund hos anslutningsoperatören
• Federationsoperatören Operatören kontrollerar om ansökan kan godkännas , inklusive metadata som signerasom komponenten uppfyller federationens tekniska ramverk, komponentens metadata godkänns i federationen, det vill säga att samtliga krav är uppfyllda
• Om
ansökan godkänns kan metadata signeras av operatören
• federationsmedlemmens metadata inte uppfyller federationens tekniska ramverk, kan anslutningsoperatören begära in nya metadata. Federationsmedlemmen bör ha möjligheten att göra en teknisk validering av metadata innan ansökan skickas in.
• Om komponenten blir godkänd, uppdaterar anslutningsopertören sin egen metadata och federationsmedlemmen uppdaterar metadata för sin komponent
• Då den ansökande organisationen redan är federationsmedlem behöver inget nytt avtal tecknas vid ett godkännande eller sägas upp om ansökan underkänns

...

Anslutningsoperatör revokerar federationsmedlemmars komponenter: metadata

• Vid misstanke om att en redan godkänd komponent inte längre uppfyller villkoren som operatören anslutningsoperatören har ställt upp så måste en utredning göras för identifierad federationsmedlem
• Skulle utredningen fastslå att komponenten inte längre uppfyller kraven, måste operatörens signatur tas bort från komponentens metadataser anslutningsoperatören till att komponentens metadata inte längre är godkända i federationen
• Ingen påverkan på avtalssituationen
• Federationsinfrastrukturen svarar för att tekniskt kommunicera förändringen

Ledningsaktör godkänner tillitsmärkesägare: avtal

• Om det behövs, inhämtas mer information från den ansökande organisation
• Om kraven från tillitsmärkesägaren uppfylls, kan organisationen godkännas som tillitsmärkesägare och

...

• avtal kan upprättas.
• Tillitsmärkesägaren kan nu hantera kraven på tillitsmärken

Ledningsaktör revokerar tillitsmärkesägare: avtal sägs upp

• Ledningsaktören identifierar vilken organisation som gjort överträdelsen
• Om bevisen för överträdelsen är tillräckliga och om tillitsmärkesägaren inte kan motbevisa så fråntas organisationen sin status som tillitsmärkesägare och avtalet sägs upp.

Tillitsmärkesägaren godkänner tillitsoperatör: avtal

• Om det behövs, inhämtas mer information från den ansökande organisation
• Om kraven från tillitsmärkesägaren uppfylls, kan organisationen godkännas som tillitsoperatör och avtal kan upprättas mellan tillitsmärkesägaren och tillitsoperatören.
• Innan tillitsoperatören kan upprätta en tillitsmärkestjänst och utfärda tillitsmärken, måste tillitsoperatören godkännas av federationsoperatören.

Tillitsmärkesägaren revokerar tillitsoperatören: avtal sägs upp

• Tillitsmärkesägaren identifierar vilken organisation som gjort överträdelsen
• Om bevisen för överträdelsen är tillräckliga och om tillitsoperatören inte kan motbevisa så fråntas organisationen sin status som tillitsoperatör och avtalet sägs upp.
• De av tillitsoperatören utfärdade tillitsmärkena påverkas
• Tillitsoperatören kan inte längre utfärda tillitsmärken

Federationsoperatör godkänner tillitsoperatör: avtal, tillitsmärkestjänst

...

• Om det behövs, inhämtas mer information från den ansökande
operatören
• organisation
• Om kraven från tillitsmärkesägaren uppfylls, kan
federationinfrastrukturaktören
• organisationen godkännas som
tillitsmärkesutfärdare och få motsvarande tillitsmärke i sitt metadata
• tillitsoperatör och avtal kan upprättas. En förutsättning är att tillitsmärkesägaren har tidigare godkänt tillitsoperatören.
• Federationsoperatör godkänner vilka tillitsmärken som tillitsoperatören kan utfärda
• Tillitsoperatören kan nu
  • Upprätta en tillitsmärkestjänst 
  • Utfärda tillitsmärken
  • Revokera tillitsmärken

draw.io Board Diagram
border false diagramName Tillitsankaer utser tillitsmärkesutdelareFederationsoperatör godkänner tillitsoperatör simpleViewer false width links auto tbstyle inline lbox true diagramWidth 900694 height 1254763 revision 75

Ledningsaktör och tillitsmärkesägare revokerar tillitsmärkesutfärdare

Federationsoperatör revokerar tillitsoperatör: avtal sägs upp

• Federationsoperatören Ledningsaktören identifierar vilken organisation som gjort överträdelsen
• Om bevisen för överträdelsen är tillräckliga och om tillitsmärkesutdelaren tillitsoperatören inte kan motbevisa så fråntas tillitsmärkesutdelaren organisationen sin status som tillitsmärkesutdelare och tillitsmärket tas borttillitsoperatör och dess metadata blir invalida.
• Samtliga tillitsmärken som
tillitsmärkesutdelaren
• tillitsoperatören tidigare har gett
ut blir nu ogiltiga och måste revokeras
• påverkas

Tillitsoperatör godkänner federationsmedlem: avtal, kan få tillitsmärke

• För att en federationsmedlem ska kunna få tillitsmärke på sina komponenter behöver federationsmedlemmen avtal med en tillitsoperatör
• Om ansökan uppfyller alla kraven, upprättas ett avtal mellan federationsmedlemmen och tillitsoperatören
• Nu kan federationsmedlemmen få ett tillitsmärke

Tillitsoperatör revokerar federationsmedlem: avtal sägs upp

• Tillitsoperatören identifierar vilken organisation som gjort överträdelsen
• Om inte federationsmedlemmen kan rätta avvikelserna sägs avtalet upp
• Status för federationsmedlemmens komponenter i federationen påverkas

...

Tillitsoperatör utfärdar tillitsmärken: tillitsmärke

• Under förutsättning att ansökan kommer från en federationsmedlem kan ansökan om tilldelning av tillitsmärke för den specifika komponenten granskas
• Uppfyller ansökan kraven från tillitsmärkesägaren efter eventuella kompletteringar kantillitsmärket utfärdas och metadata skapasuppdateras
• Om eventuella kompletteringarna inte anses fullständiga, avslås ansökan
• Då ansökande organisation redan är federationsmedlem krävs ingen förändring av avtalet, oavsett reslutat av granskningen

...

...

Tillitsoperatör revokerar tillitsmärke: ogiltigt tillitsmärke

• Tillitsmärkesutfärdaren Tillitsoperatören identifierar vilken organisation som gjort överträdelsen
• Om bevisen för överträdelsen är tillräckliga och om tillitsmärkesinnehavaren inte kan motbevisa så fråntas tillitsmärkesinnehavaren blir tillitsmärket ogiltigt.

Alternativt skrivsätt

Diagrammen i processbeskrivningarna är förenklade med tanke på målgruppen. Sekvensdiagram är ett mera lämpligt sätt att beskriva detaljer i processen så att de som ska förvalta federationsinfrastrukturen förstår vilka steg som krävs. Nedan ett exempel på ett sekvensdiagram då en ledningsaktör godkänner en federationsoperatör, fullständiga beskrivningar behöver tas fram senare i utvecklingsarbetet för samtliga processer.