Denna checklista innehåller sammanfattande information om vad respektive organisation måste göra med anledning av införandet av SITHS nya autentiseringslösning, vilken även inkluderar Mobilt SITHS. Det är viktigt att du som ansvarig utgivare tar ansvar för detta arbete och planerar samtliga aktiviteter inom din organisation. Om inte dessa aktiviteter genomförs, kommer ni inte att kunna använda Mobilt SITHS för inloggning i tjänster, inte heller någon av de andra autentiseringsmöjligheterna som den nya autentiseringstjänsten innebär.

Observera att denna checklista är ett levande dokument som kommer att uppdateras kontinuerligt.

Vi behöver hjälp att sprida informationen vidare

Vi vill be dig som är ansvarig utgivare att hjälpa oss att sprida informationen vidare till rätt personer inom din organisation samt till eventuella leverantörer, som informationen i checklistan riktar sig till. Tänk också på att om din organisation är SITHS-ombud, har ni ett ansvar att informera organisationer som anslutit till SITHS via er organisation. Inera ansvarar endast för information mot sina direktanslutna kunder.

Huvudsakliga målgrupper för checklistan är

• Ansvariga utgivare

• Tekniskt ansvariga för SITHS, lokal IdP och tjänster anslutna till Ineras IdP

• IT-arkitekter

• IT-säkerhetsansvariga

• ID-administratörer för SITHS

• Leverantörer av funktionalitet som gäller SITHS

Revisionshistorik

Översikt över förberedelser och aktiviteter

1. Utse lokal införande ansvarig och ev. projektorganisation

Utse redan nu en lokal införandeansvarig som ansvarar för införandet av nya autentiseringstjänsten och de autentiseringsmetoder som nya tjänsten innebär bl.a. Mobilt SITHS eID. Lokal införandeansvarig ska tillsammans med ansvarig utgivare ansvara för införandet. Se följande bilaga för rollbeskrivning.  Se bilaga 1 i detta dokument.

2. Teckna anslutningsavtal

För att kunna ansluta er till nya autentiseringsmetoden behövs ett avtal med Inera AB. Avtalet innebär inte nya kostnader för er organisation men reglerar ansvarsfördelningen mellan er organisation och Inera AB. Avtalet ska signeras av firmatecknare i er organisation. Avtalet ska signeras och mailas till oss på Inera. Se bilaga 2 i detta dokument. 

3. Beställ brandväggsöppningar

För att kunna kommunicera med nya Autentiseringstjänsten och Utfärdandeportalen för Mobilt SITHS eID under era integrationstester, vilka kommer utföras mot Ineras Preacceptanstestmiljö, krävs det öppningar från er tekniska miljö enligt:

Sökvägar och brandväggsöppningar - AT

4. Generellt om IdP-inloggning

För att kunna använda SITHS nya autentiseringstjänst måste respektive tjänst som använder SITHS vara ansluten till en IdP. Det kan vara en egen IdP, Ineras IdP eller annan organisations IdP. Oavsett vilken IdP som används, behöver ni kontrollera nedanstående:

• Inventera vilka lokala tjänster inom din organisation som använder SITHS för inloggning, säkerställ sedan att de även är anslutna till en IdP. Om tjänsterna inte är anslutna till en IdP måste de anslutas.

• Om ni vill använda Ineras IdP kontrollera vilka attribut era lokala tjänster behöver och samt om dessa finns i HSA-katalogtjänsten från Inera.

• Om ni använder egen IdP säkerställ att den kan leverera dessa attribut och att dessa attribut finns i er lokala katalogtjänst som ni ämnar använda.

5. Beskrivning av anslutningsmetoder

Lokal tjänst till Ineras IdP

Förutsättningar:

• E-tjänsten ansluts som SP till Inera IdP med via SAML2 eller OIDC-protokollet. Här väljs också vilka autentiseringsmetoder som ska finnas tillgängliga för användare.

• Användarorganisationerna administrerar nödvändiga användarattribut i sin del av HSA-katalogen.

• Användarnas datorer / mobiler förses med programvara för SITHS eID, antingen på dator och/eller mobilt

...

Lokal Idp till Ineras Autentiseringstjänst

I detta fall tillhandahåller organisationens egna IdP de nya autentiseringsmetoderna genom att anropa gemensam Autentiseringstjänst för SITHS.

...

• Egen IdP ansluts till Relying party API för Ineras Autentiseringstjänst, se figur 1 nedan

• E-tjänsten ansluts (är ansluten) som SP till egen IdP. Här väljs också vilka autentiseringsmetoder som ska finnas tillgängliga för användare

• Användarorganisationerna administrerar nödvändiga användarattribut i den aktuella katalogtjänsten.

• Användarnas datorer / mobiler förses med programvara för SITHS eID, antingen på dator och/eller Mobil enhet .

Figur 1 - Lokal IdP ansluts direkt till Relying party API för Ineras Autentiseringstjänst

...

Mo

Mo

6. Förberedelser för att kunna använda SITHS Autentiseringsklient

SITHS eID Autentiseringsklient på Windows 10

Detta måste ni göra för att kunna använda den nya Autentiseringstjänsten med SITHS eID-kort på Windows 10. Säkerställ att användarnas datorer:

1. befinner sig på nätverk med aktuella brandväggsöppningar

2. har SITHS eID Preacctest klienten för Windows 10 installerad: Nedladdningssida för SITHS eID app till Windows 10

SITHS eID Autentiseringsklient på Mobila enheter (Mobilt SITHS eID)

Detta måste ni göra för att kunna använda Mobilt SITHS eID:

1. OBS! För integrationstester i Preacctestmiljön krävs att användaren har tillgång till ordinarie SITHS TEST-kort  med TEST SITHS eID certifikat på tillitsnivå 3. Anledningen till detta är att det initialt bara kommer gå att utfärda Mobilt SITHS efter autentisering av användaren på tillitsnivå 3.

2. Införskaffa mobila enheter enligt Ineras kravlista. Se följande sida för krav och supportade Mobila enheter Mobila enheter och OS som uppfyller kraven för SITHS eID version 1.0

3. Mobila enheter måste ha tillgång till Internet och aktuella brandväggsöppningar.

4. Säkerställ att användarnas datorer har SITHS eID Preacctest klienten för Windows 10 installerad: Nedladdningssida för SITHS eID app till Windows 10

5. Säkerställt att användarna har appen för SITHS eID Preacctest installerad på sina mobiltelefoner eller surfplattor. Appen ligger dold i nuläget, men kommer vara tillgänglig för betatestning via direktlänkar till appbutiken för  iOS respektive Android.

6. Hänvisa era användare till nedladdning av Mobilt SITHS eID via följande länk https://enrollment.preacctest.ineratest.org

7. Förberedelser för att kunna använda SITHS Autentiseringstjänst

Generella förberedelser

Oavsett vilken anslutningsmetod ni använder behöver följande aktiviteter genomföras:

1. Gör en anmälan till: hasanein.alyassiri@inera.se och magnus.vallstedt@inera.se

2. Behörig representant för kunden måste teckna Kundavtal 2 (”ramavtal med Inera”) om detta inte redan finns, se: https://www.inera.se/kundservice/bli-kund/

3. Maila nedan uppgifter till hasanein.alyassiri@inera.se

   1. Undertecknat anslutningsavtal, (OBS! måste undertecknas av behörig representant för organisationen)

   2. Kontaktuppgifter till lokal införandeansvarig

1a. Anslut egen lokal tjänst till Ineras IdP

1. Säkerställ att era användare har tillgång till aktuella versioner av SITHS eID Autentiseringsklient och även har hämtat Mobilt SITHS eID om detta ska ingå i era tester, se: Förberedelser för att kunna använda SITHS eID Autentiseringsklient

2. Hämta IdP:ns metadata Metadata-URL:  https://idp-oob.preacctest.ineratest.org/saml

3. https://www.inera.se/kundservice/dokument-och-lankar/tjanster/identifieringstjanst-siths/siths-funktionscertifikat/

4. Ta reda på följande information om er lokala miljö

   1. Er tjänsts (SPs) metadata

   2. Bestäm vilka attribut er tjänst vill hämta från Ineras IdP, se https://confluence.cgiostersund.se/display/ST/Attributlista

      1. Utökad läsning om attributsstyrning inom Ineras IdP: Attributstyrning SAMLv2 och Attributsstyrning OIDC

      2. Utökad lösning om de profiler som används inom Ineras IdP: SAMLv2 profil och OIDC-profil

   3. Vilka autentiseringsmetoder ni vill ha:

      1. SITHS-kort med hjälp av Net iD

      2. SITHS eID på samma enhet (Både Mobilt SITHS eID och SITHS-kort)

      3. SITHS eID på annan enhet (Primärt usecase för Mobilt SITHS eID)

5. Maila in uppgifterna under punkt 5 ovan till: hasanein.alyassiri@inera.se och/eller magnus.vallstedt@inera.se

6. Samtliga SITHS-kort som har SITHS-certifikat på sig kommer gå att använda för inloggning med Inera Autentiseringstjänst och SITHS eID Autentiseringsklient på Windows 10.

   1. IdP:n kommer initialt utfärda identitetsintyg på tillitsnivå 3 för alla typer av SITHS-certifikat på SITHS-kort. Ineras IdP gör idag tolkningar enl. https://confluence.cgiostersund.se/display/ST/Guide+till+IdP#GuidetillIdP-Tillitsniv%C3%A5(LoA)

   2. Dock kommer detta att ändras i preacctestmiljö under hösten och linjera med TEST/QA miljöerna för Ineras IdP enligt: https://confluence.cgiostersund.se/pages/viewpage.action?pageId=210942615.

7. IdP:n kommer initialt att utfärda identitetsintyg påtillitsnivå 2 för Mobilt SITHS eID

   1. Framgent kan detta komma att justeras.

8. Installera tillit till utfärdaren av det certifikat som används för signering av Identitetsintyget från Ineras IdP i Preacctestmiljö:

   • http://aiapp.siths.se/testsithseidrootcav2.cer

   • http://aiapp.siths.se/testsithseidfunctioncav1.cer

1b. Förberedelser inför tiden efter den initialperioden - Anslutning av tjänst till förvaltningens miljöer

1. För att använda Ineras IdP behöver ni beställa IdP och fylla i en förstudie.

   1. Anmäl att ni vill denna förstudie till hasanein.alyassiri@inera.se och magnus.vallstedt@inera.se

2. Gå igenom följande: https://confluence.cgiostersund.se/pages/viewpage.action?pageId=178366663#GuidetillIdP-Adresserochportar (guide IDP)

2. Anslut egen lokal IdP

1. Säkerställ att era användare har tillgång till aktuella versioner av SITHS eID Autentiseringsklient och även har hämtat Mobilt SITHS eID om detta ska ingå i era tester, se: Förberedelser för att kunna använda SITHS eID Autentiseringsklient

2. Ta reda på följande information om er lokala miljö

3. Beställ ett funktionscertifikat för test från TEST SITHS eID och ta reda på dess HSA-id

   1. Om ni inte kan beställa SITHS-funktionscertifikat på egen hand finns det möjlighet att beställa SITHS-funktionscertifikat från Inera. Kan beställas via följande länk (obs prod just nu i väntan på beslut om miljöer):

4. Ta reda på den IP-adress er IdP kommer presentera mot SITHS eID Autentiseringstjänst

5. Information om kapacitetsbehov 

6. Maila HSA-id, IP-adress och kapacitetsbehov till: hasanein.alyassiri@inera.se och/eller magnus.vallstedt@inera.se

7. Säkerställ att er IdP har relevanta brandväggsöppningar för åtkomst till SITHS eID Autentiseringstjänst Relying Party API

8. Anpassa er lokala IdP till Autentiseringstjänstens Relying Party API: https://as.preacctest.ineratest.org/openapi/swagger-ui/index.html?url=/v3/api-docs&validatorUrl=

9. Kommunikationen mellan Lokal IdP och Inera Autentiseringstjänst skyddas av ömsesidig TLS (MTLS) med certifikat från följande utfärdare som er IdP måste lita på:

   • http://aiapp.siths.se/testsithseidrootcav2.cer

   • http://aiapp.siths.se/testsithseidfunctioncav1.cer

10. Avgör vilken tillitsnivå ni vill att respektive typ av SITHS-certifikat ska få i er lokala IdP’s identitetsintyg. Ineras IdP gör idag tolkningar enl. https://confluence.cgiostersund.se/display/ST/Guide+till+IdP#GuidetillIdP-Tillitsniv%C3%A5(LoA).

    1. Dock kommer detta att ändras under hösten enligt: https://confluence.cgiostersund.se/pages/viewpage.action?pageId=210942615.

    2. Observera att Mobilt SITHS eID ännu inte är godkänt av DIGG och inte återfinns i IdP:ns matris. I IdP:n i projektets testmiljöer kommer vi dock att klassa Mobilt SITHS eID somtilllitsnivå 2

Bilaga 1

Rollbeskrivning: Lokalt införandeansvarig för ny autentiseringsmetod

...

• Genomföra förstudie och kartlägga och föreslå förberedelseaktiviteter som ska leda fram till lyckat införande

• Leda övergången till ny autentiseringsmetod inom egen organisation

• Samla in förbättringsförslag och förmedla dessa till ansvarig utgivare och till Inera enligt instruktion från Inera

• Rollen omfattar följande Ansvarsområden:

  • Organisera och leda genomförandet av införandeaktiviteter både inom verksamheten och IT-organisationen

  • Samverka samt ge löpande stöd till ansvarig utgivare under införandet

  • Hantera kommunikation till berörda parter inom organisationen

  • Vid behov utbilda berörd personal t.ex. IT Helpdesk eller Kundtjänst

  • I samråd med ansvarig utgivare ta fram instruktioner och utbildningsmaterial

  • Följa upp införande och anslutningsgraden inom organisationen

  • Kanalisera frågeställningar och förbättringsförslag till både ansvarig utgivare och Inera

  • Agera som single point of contact för eventuella projekt i organisationen

  • Stöd i samband med att organisationen börjar använda en ny komponent

 Bilaga 2

Anslutningsavtal.

...