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
Datum | Författare | Version | Vad har förändrats |
2020-05-25 | Hasanein Alyassiri | 0.97 | Upprättande av detta dokument. |
2020-05-28 | Team autentiseringsprojeket | 0.98 | Uppdatering av checklistan |
2020-06-09 | Team autentiseringsprojeket | 0.985 | Uppdatering av checklistan |
2020-06-18 | Team autentiseringsprojeket | 1.0 | Uppdatering av checklistan |
Ö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.
Användarflödet blir i princip samma som för lokal tjänst till Ineras IdP , men denna gång är det egen IdP som tillhandahåller användargränssnittet.
Förutsättningar:
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:
befinner sig på nätverk med aktuella brandväggsöppningar
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:
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.
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
Mobila enheter måste ha tillgång till Internet och aktuella brandväggsöppningar.
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
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.
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:
Gör en anmälan till: hasanein.alyassiri@inera.se och magnus.vallstedt@inera.se
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/
Maila nedan uppgifter till hasanein.alyassiri@inera.se
Undertecknat anslutningsavtal, (OBS! måste undertecknas av behörig representant för organisationen)
Kontaktuppgifter till lokal införandeansvarig
1a. Anslut egen lokal tjänst till Ineras IdP
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
Hämta IdP:ns metadata Metadata-URL: https://idp-oob.preacctest.ineratest.org/saml
Ta reda på följande information om er lokala miljö
Er tjänsts (SPs) metadata
Bestäm vilka attribut er tjänst vill hämta från Ineras IdP, se https://confluence.cgiostersund.se/display/ST/Attributlista
Utökad läsning om attributsstyrning inom Ineras IdP: Attributstyrning SAMLv2 och Attributsstyrning OIDC
Utökad lösning om de profiler som används inom Ineras IdP: SAMLv2 profil och OIDC-profil
Vilka autentiseringsmetoder ni vill ha:
SITHS-kort med hjälp av Net iD
SITHS eID på samma enhet (Både Mobilt SITHS eID och SITHS-kort)
SITHS eID på annan enhet (Primärt usecase för Mobilt SITHS eID)
Maila in uppgifterna under punkt 5 ovan till: hasanein.alyassiri@inera.se och/eller magnus.vallstedt@inera.se
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.
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)
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.
IdP:n kommer initialt att utfärda identitetsintyg på tillitsnivå 2 för Mobilt SITHS eID
Framgent kan detta komma att justeras.
Installera tillit till utfärdaren av det certifikat som används för signering av Identitetsintyget från Ineras IdP i Preacctestmiljö:
1b. Förberedelser inför tiden efter den initialperioden - Anslutning av tjänst till förvaltningens miljöer
För att använda Ineras IdP behöver ni beställa IdP och fylla i en förstudie.
Anmäl att ni vill denna förstudie till hasanein.alyassiri@inera.se och magnus.vallstedt@inera.se
Gå igenom följande: https://confluence.cgiostersund.se/pages/viewpage.action?pageId=178366663#GuidetillIdP-Adresserochportar (guide IDP)
2. Anslut egen lokal IdP
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
Ta reda på följande information om er lokala miljö
Beställ ett funktionscertifikat för test från TEST SITHS eID och ta reda på dess HSA-id
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):
Ta reda på den IP-adress er IdP kommer presentera mot SITHS eID Autentiseringstjänst
Information om kapacitetsbehov
Maila HSA-id, IP-adress och kapacitetsbehov till: hasanein.alyassiri@inera.se och/eller magnus.vallstedt@inera.se
Säkerställ att er IdP har relevanta brandväggsöppningar för åtkomst till SITHS eID Autentiseringstjänst Relying Party API
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=
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å:
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).
Dock kommer detta att ändras under hösten enligt: https://confluence.cgiostersund.se/pages/viewpage.action?pageId=210942615.
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 som tilllitsnivå 2
8. Frågor och svar
Vilka av Ineras tjänster använder Inera IdP?
Det är flera tjänster men främst, Pascal, NPÖ, Intygtjänsterna, Personuppgiftstjänsterna, Sebra, Infektionsverktyget, Svevac, Hitta Jämför Vård, säkerhetstjänster, Pascal Admin , 1177 Admin och säkerhetstjänsterna.Vi har Android-telefoner som inte finns på er lista, kommer dessa att fungera med Mobilt SITHS eID?
Det är inte möjligt att testa testa alla mobila enheter på marknaden men finns de på Google Enterprise lista kommer de med stor sannolikhet att fungeraKommer det behövas en ny enrollment när en användare tar över mobilen/enheten från en annan användare?
Ja, en enrollment behövs.Finns användarguide för utäfärdandet av Mobilt SITHS?
Ja, den finns här Utfärda Mobilt SITHS - AnvändarguideFinns användarguide på hur en autentisering går till?
Ja, den finns här: Autentisering - Användarguide
Bilaga 1
Rollbeskrivning: Lokalt införandeansvarig för ny autentiseringsmetod
Inera levererar idag, via identifieringstjänsten SITHS, utgivning av certifikat på smarta kort samt autentiseringslösning till alla regioner, kommuner, privata utförare, tjänsteleverantörer och några myndigheter. Totalt finns det över 550 000 användare av tjänsten.
Inera arbetar för närvarande med framtagande och införande av en ny autentiseringslösning baserad på en så kallad Out of Band-teknik, vilken kommer att läggas till den befintliga SITHS-tjänsten. Denna lösning omfattar autentiseringsklienter för Windows, Android samt IOS och skapar bland annat förutsättningar för införande av mobil autentisering. Lösningen kommer under en övergångsperiod finnas parallellt med befintlig autentiseringslösning.
SITHS-tjänsten kommer att vidareutvecklas [HA39] med bl.a. följande komponenter:
Ny mobil klient för SITHS e-id för autentisering och underskrift mha mobilklient
Ny desktopklient för SITHS e-id för autentisering och underskrift som eliminerar beroendet till Internet Explorer 11 vid autentisering och underskrift och på sikt ersätter Net id Enterprise
Nya funktioner baserat på regionernas prioriteringar
Lokalt införande av ny autentiseringsmetod
Beroende på hur den lokala IAM-infrastrukturen är utformad kan införandet av den nya autentiseringsmetoden ge mer eller mindre påverkan. Detta är något som behöver utredas och en plan anpassad till den lokala situationen behöver tas fram samt genomföras.
Inera rekommenderar att en lokalt införandeansvarig utses samt leder förstudie, planering samt genomförande av erforderliga lokala införandeaktiviteter i syfte att säkerställa att övergången till ny autentiseringsmetod sker så snart som möjligt samt med minimala störningar hos den egna organisationen.
Ett införande kan komma att påverka både användare, personal som arbetar med eID-utgivning, IT-organisationen och systemförvaltare.
Resursen ska tillsammans med ansvarig utgivare:
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.