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 har mandat att utse ö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.

...

.

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

Ledningsaktör utser tillitsankare

• Ledningsaktören utser tillitsankare och bestämmer vilka entitetstyper som ska gälla för det specifika tillitsankaret
• 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 metadata är grunden för tillit för alla federationsmedlemmar, som publiceras.
• Borttag av ett tillitsankare bryter tilliten i kedjan och påverkar samtliga anslutna operatörer och federationsmedlemmar

...

Ledningsaktör utser operatö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 federationsinfrastukturaktörerfederationsoperatö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 operatör 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 federationinfrastruktursaktö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
  operatören
  • federationsaktören sägs upp
  Federationsmedlemmar som blivit godkända av operatören förlorar sin medlemsstatus och metadata revokeras.
  •  tillitskedjan bryts för samtliga underliggande parter

Ledningsaktör utser operatör

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

• Federationsoperatören Ledningsaktören godkänner ansökan om ansökan är giltig och om den ansökande organisationen är en operatör och uppfyller tillitsankarets krav
Den ansökande organisationens metadata uppdateras med tillitsmärke
• uppfyller kraven
• Den ansökande 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
• Ledningsaktören är tillitsmärkesägare
• Om ansökan kommer från av ledningsaktörens godkänd operatör kan ansökan utvärderas
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
• 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ärkesutdelaren
• tillitsmärkesägaren inte kan motbevisa så fråntas
tillitsmärkesutdelaren
• organisationen sin status som
tillitsmärkesutdelare och tillitsmärket tas bortSamtliga tillitsmärken som tillitsmärkesutdelaren tidigare har gett ut blir nu ogiltiga och måste revokeras
• tillitsmärkesägare och avtalet sägs upp.

Tillitsmärkesutfärdare utfärdar tillitsmärken

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.
• Under förutsättning att ansökan kommer från en federationsmedlem kan ansökan om tilldelning av tillitsmärke granskas
• Uppfyller ansökan kraven från tillitsmärkesägaren efter eventuella kompletteringar kan tillitsmärket utfärdas och metadata skapas
• 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

Tillitsmärkesutfärdare revokerar tillitsmärke

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

• Tillitsmärkesägaren
Tillitsmärkesutfärdaren
• identifierar vilken organisation som gjort överträdelsen
• Om bevisen för överträdelsen är tillräckliga och om
tillitsmärkesinnehavaren
• tillitsoperatören inte kan motbevisa så fråntas
tillitsmärkesinnehavaren tillitsmärket
• 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

ENA-SAML-federation

Ledningsaktör i rollen som federationsoperatör godkänner ny federationsmedlem i ENA-SAML-federationen

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

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

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

• Federationsoperatören 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 dess metadata blir invalida.
• Samtliga tillitsmärken som tillitsoperatören tidigare har gett 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
• 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 federationsmedlemmar
Ansökan granskas av ledningsaktören och kan leda till ett godkännande med ett avtal mellan ledningsaktören och den nyblivna federationsmedlemmen upprättas eller alternativt kan ansökan underkännas på grund av att kraven inte uppfylls

Ledningsaktör i rollen som federationsoperatör revokerar medlem i ENA-SAML-federationen

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
• Ledningsaktören identifierar vilken federationsmedlem som behöver utredas för överträdelse
• Om inte medlemmen kan redovisa svar som är acceptabla inleds en revokeringsprocess
Metadata tas bort från det aggregerade metadatat

Ledningsaktören i rollen som federationsoperatör godkänner federationsmedlemmars SAML-entiteter

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 uppdateras
• 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
• En federationsmedlems SAML-entitet av typen Service Provicer eller Identity Provider kan bli godkänd av ledningsaktören genom en ansökan
• Den första kontrollen är om den ansökande organisationen är medlem i ENA-SAML-federationen
• Ledningsaktören kontrollerar om ansökan kan godkännas, inklusive metadata, det vill säga att samtliga krav är uppfyllda
• Om ansökan godkänns kan metadata signeras av ledningsaktören
• Då den ansökande organisationen redan är medlem i ENA-SAML-federationen behöver inget nytt avtal tecknas vid ett godkännande eller sägas upp om ansökan underkänns

Ledningsaktören i rollen som federationsoperatör revokerar federationsmedlemmars SAML-entiteter

• Vid misstanke om att en redan godkänd SAML-entitet inte längre uppfyller villkoren som ledningsaktören har ställt upp så måste en utredning göras för identifierad federationsmedlem
• Skulle utredningen fastslå att SAML-entiteten inte längre uppfyller kraven, måste SAML-entiteten tas bort från aggregerad metadata
• Ingen påverkan på avtalssituationen

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

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