1. Dokumentinformation

1.1. Syfte

Detta dokument beskriver funktionstest av Lokala Säkerhetstjänster för att verifiera en installation eller uppgradering till version 2.17.

1.2. Sammanfattning

Efter en genomförd installation eller uppgradering av Lokala Säkerhetstjänster ges möjlighet att köra funktionstester mot några av de webbtjänster som ingår i säkerhetstjänster samt manuella tester via GUI . Detta gör det möjligt att verifiera att systemet fungerar tillfredsställande innan driftsättning. Testerna körs med hjälp av SoapUI som är ett verktyg för att testa webbtjänster via ett grafiskt gränssnitt. SoapUI är utvecklat under opensource-licens och finns både i en gratisversion och en utökad betalversion, SoapUI Pro. De tester som är beskrivna här är verifierade med gratisversionen.

2. Förutsättningar

Det förutsätts att vissa kriterier är uppfyllda innan testerna kan starta:

2.1. Automatiska tester:

• SoapUI
• Ett SITHS-funktionscertifkat som används för att testa säkerhetstjänsters webbtjänster
  • Funktionscertifikatet ska vara behörig att använda säkerhetstjänster.
    • Linux: se kapitel behörighet i 2.17 Installation och administration (Linux)
    • Windows: se kapitel behörighet i 2.17 Installation och administration (Windows)
• Dessutom behövs följande uppgifter vid anrop till webbtjänsterna (för t.ex. registrering av spärr)
  • Testanvändare (kan vara samma som användaren i de manuella testerna)
  • Testpatient (Validerade personidentiteter för personnummer, samordningsnummer samt nationellt reservidentitet).
  • Testvårdgivare och testvårdenhet

2.2. Manuella tester

• En användare med SITHS-kort som är upplagt i HSA med minst två stycken medarbetaruppdrag
  • Användaren ska vara behörig att använda säkerhetstjänster enligt:
    • Linux: se kapitel behörighet i  2.17 Installation och administration (Linux) 
    • Windows: se kapitel behörighet i 2.17 Installation och administration (Windows) 
• Testpatient som ska användas vid testerna. (denna bör finnas i Personuppgiftstjänsten (PU-tjänsten) för att namnuppslagning ska kunna ske i GUI)

2.3. Installation av lokala säkerhetstjänster

Testerna nedan är anpassade för att testa lokala säkerhetstjänster 2.17 med alla lokala tjänster installerade (Autentisering, Spärr,Samtycke och Logg/loggrapport). Har man inte installerat alla tjänster kan man köra de specifika testerna för respektive tjänst istället.

3. Automatiska Tester med SoapUI

3.1. Installera SoapUI

Ladda ner och installera SoapUI från http://www.soapui.org/. Bifogat SoapUI-projekt är veriferat med SoapUI 5.3.0.

3.2. Sätta upp SoapUI för funktionstest

I testprojektet används ett antal variabler. Det finns både globala inställningar och projektspecifika inställningar.

3.2.1. Globala inställningar

Följande inställningar måste göras i SoapUI:

1. Klicka på File->Preferences för att öppna fönstret för inställningar.
2. Välj SSL Settings i menyn.
   
   
   
   
3. I fältet KeyStore anges sökväg till det funktionscertifikat som är skapat, genom att klicka på Browse och navigera till filen (*.p12).
4. På samma sida anges certifikatets lösenord i fältet KeyStore Password.
5. Klicka på OK för att spara inställningarna och stänga fönstret.

3.2.2. Projektinställningar

Ladda ner testprojektet här:

Test_lokal_installation-soapUI-2.17-v2.xml

Importera projektet till SoapUI genom att välja File->Import Project i menyn och navigera till den nedladdade filen. De olika testerna använder properties i anropen till de olika webbtjänsterna. Dessa finns både i projektet och i varje enskilt testfall och sätts beroende av uppgifterna för testanvändaren.

1. Högerklicka på projektet i navigationsfönstret, välj Show Project View för att öppna fönstret för projektinställningar.
2. Klicka på Properties i nederkant på fönstret.
3. Ändra till lämpliga värden genom att dubbelklicka i respektive fält i kolumnen Value.

Stäng fönstret och spara om projekt-filen med de nya inställningarna, File->Save All Projects.

3.3. Testsviterna

I projektet finns 7 st testsviter som i ett antal steg verifierar att några grundläggande funktioner i varje tjänst svarar på anrop. Varje testsvit beskrivs mer i detalj under respektive rubrik nedan.

Testerna körs antingen parallellt eller sekventiellt, det är också möjligt att köra enskilda testsviter. För att köra samtliga testsviter:

1. Dubbelklicka på projektet i navigationsmenyn för att öppna projekt-vyn.
2. Välj fliken TestSuites.
3. Välj att köra parallellt eller sekventiellt i verktygsraden.
4. Klicka på den gröna pilen för att starta.

För att köra en enskild testsvit:

1. Dubbelklicka på önskad testsvit i navigationsmenyn för att öppna testsvit-vyn.
2. Klicka på den gröna pil-symbolen för att starta.
   
   

3.3.1. Spärr

Spärrtjänstens funktion verifieras i tre steg för respektive version av tjänstekontrakten. Testfallet testar att först registrera en spärr och därefter hämtas en lista på alla spärrar för vårdgivaren. Testet veriferar att spärren finns i listan. Slutligen makuleras spärren.

3.3.2. Samtycke

Testfallet testar att först registrera ett samtycke och därefter hämtas en lista på alla samtycken för vårdgivaren. Testet veriferar att samtycket finns i listan. Slutligen makuleras samtycket. Även här finns två versioner av tjänstekontrakten.

3.3.3. Logg/Loggrapport

Loggtjänsten testas genom att lägga in en loggpost genom webbtjänsten. Därefter anropas loggrapporttjänsten för att läsa in alla loggar för aktuell vårdgivare. Verifiering sker att loggposten finns med i loggrapporten. Här produceras loggen med version 2 och läses av version 1 av tjänstekontrakten.

3.3.4. CommissionService (del av autentiseringstjänsten)

För att testa commission service körs ett testfall i fyra steg:

1. Genom att anropa SetSelectedCommissionForPerson utan uppdragsid så nollställs eventuella tidigare val.
2. En lista på alla tillgängliga medarbetaruppdrag för testanvändaren hämtas.
3. Första uppdraget i listan väljs för testanvändaren.
4. Verifiering av valt uppdrag.

3.4. Testade webbtjänster

4. Manuella tester

De manuella GUI testerna är ett urval av aktiviteter som en viss personal normalt gör i systemet.

• En användare ska kunna logga in i systemet med SITHS-kort och välja medarbetaruppdrag
• Som Vårdpersonal registrerar man normalt Samtycken
• Som Systemadministratör registrerar man normalt Spärrar och tar ut Loggrapporter
• Som Teknisk administratör konfigurerar man systemet

4.1. Inloggning med SITHS-kort

Dessa steg verifierar att det går logga in i Säkerhetstjänster och att val av olika medarbetaruppdrag fungerar.

Exempel med dialogrutor som användaren får, när certifikat väljs och när PIN koden anges i Net iD.

Exempel gällande GUI då användaren väljer medarbetaruppdrag.
 

4.2. Ändra konfiguration för loggning

Följande steg verifierar att en Teknisk administratör kan ändra inställningar i Generell konfiguration. De ändringar som görs i dessa steg är endast temporära och skapar förutsättningar att smidigt ta ut Loggrapporter enligt kap 3.9

Viktigt: Återställ konfigurationen enligt kap 4.8 när testerna är klara.

Exempel gällande GUI för Generell konfiguration.

4.3. Registrera Samtycke

Följande steg verifierar att vårdpersonal med rätt behörighet kan registrera Samtycke.    

Exempel gällande GUI för Samtycke.

4.4. Registrera Spärr

Följande steg verifierar att vårdpersonal med administrationsrättigheter kan registrera Spärrar samt administrera lagda spärrar.  

Exempel gällande GUI för Spärr.

4.5. Kontroll av replikering

När spärrarna är skapade kan en enkel kontroll utföras genom att logga in i admin-GUI, med en användare som har systemrollen Spärradministratör.

Klicka på Spärr-> Administrera spärrar

Fyll i personnumret på önskad testpatient.

Klicka på [Sök].

Nu visas alla spärrar på testpatienten, och i kolumnen "Replikerad" går det att se om spärren blivit replikerad till nationell spärrtjänst. I exemplet ovan är samtliga spärrar replikerade. (OBS.Om det visar sig att en spärr ännu inte blivit replikerad, så vänta 5 minuter och kontrollera på nytt)

4.6. Hämta Loggrapport

Följande steg verifierar att vårdpersonal med rätt behörighet kan ta ut loggrapporter över händelser i Säkerhetstjänster.    

Exempel gällande GUI för Loggrapport.

4.7. Återställning av konfiguration för loggning

Följande steg återställer de konfigurationsförändringar som gjordes i kapitel 4.2.