Innehållsförteckning
Revisionshistorik
Version | Datum | Kommentar |
---|---|---|
0.9.1 RC1 | 2021-06-08 | Första version som underlag för tjänsteleverantörer att genomföra integrationstester mot SDK Öppen testmiljö för tjänsteleverantörer. |
0.9.1 RC1 | 2022-02-21 | Generell genomlysning av dokumentet |
1.0 (2022) | 2022-02-28 | Beslutad version 1.0 för Tjänsten Säker digital kommunikation. |
1.1 (2022) | 2022-06-07 | Uppdateringar: |
1. Inledning
Detta dokument innehåller testinstruktioner för tjänsteleverantörer som ska genomföra integrationstester i SDK Öppen testmiljö för tjänsteleverantörer (SDK ÖTM), samt för att genomföra tester enligt ‘SDK Självdeklaration för tjänsteleverantörer’ (se ref. R5).
Testinstruktionen förutsätter att tjänsteleverantörens tjänst är ansluten till SDK ÖTM och att tjänsteleverantören har access till SDK Adressbok (se ref. R1) och SDK Testklient (se ref. R2).
Testinstruktionen beskriver konfiguration som är nödvändig i SDK Adressbok för genomförande av integrationstesterna.
1.1 Referenser
1.1.1 Stödjande externa dokument
Ref | Dokument-id | Dokument länk |
---|---|---|
R1 | SDK Adressbok | |
R2 | SDK Testklient | |
R3 | SDK Innehållsspecifikation Meddelande | |
R6 | SDK Anslutningsblankett - Öppen testmiljö för tjänsteleverantörer | |
R4 | DIGGs Miljöspecifikation för Testfederation i Testmiljö | DIGGs informationspaket kan erhållas genom en förfrågan till DIGG via info@digg.se |
R5 | SDK Självdeklaration för Tjänsteleverantörer | |
R6 | SDK Testinstruktioner för anslutningstester |
2. Testdata
2.1 Tjänsteleverantörens organisationsinformation i SDK Adressbok
Inera ansvarar för att lägga upp tjänsteleverantörens organisation i SDK Adressbok tillsammans med behörighet för tjänsteleverantören att redigera sin organisation och funktionsadresser.
En starkt autentiserad och behörig användare hos tjänsteleverantören ansvarar för att redigera information om sin organisation och funktionsadresser i SDK Adressbok.
Följande ska konfigureras upp i SDK Adressbok för att kunna genomföra tester (sedan finns många fler frivilliga fält där tjänsteleverantören styr hur dessa fylls i för att kunna genomföra tester):
Tjänsteleverantören | Värde |
---|---|
Identifierare (unik organisationsidentifierare för organisationen) | T.ex. "0203:testkommun.se" |
Namn (organisationens formella namn) | T.ex. "Test kommun" |
Beskrivning (hjälpande beskrivning av organisationen) | T.ex. "Test kommun är en..." |
Funktion #1 | Värde |
Organisation (den organisation som funktionsadressen skall tillhöra) | T.ex. "Test kommun" |
Identifierare (teknisk identifierare för funktionsadressen, unik inom organisationen) | T.ex. "barnoungdom.0203:testkommun.se" |
Namn (namn på funktionsadressen för att t.ex. lätt kunna söka på den) | T.ex. "Barn- och ungdomsmottagningen Test kommun" |
Beskrivning (hjälpande beskrivning av funktionsadressen) | T.ex. "Barn- och ungdomsmottagningen handhar..." |
2.2 Tjänsteleverantörens organisationsinformation i SDK ÖTM
Inera ansvarar för de fiktiva organisationer som är del av konfigurationen i SDK ÖTM och som tjänsteleverantörer kan genomföra tester emot.
2.2.1 Organisation#1 (SDK ÖTM)
En organisation som är upplagd i SDK Adressbok och som huvudsakligen används under testerna.
Organisation#1 | Värde |
---|---|
Organisationsidentifierare | 0203:otm-sdk.inera.se |
Organisationsnummer | 999999-0002 |
Organisationsnamn | SDK Öppen testmiljö - Inera AB |
Organisationsbeskrivning | SDK Öppen testmiljö utgör ett stöd för tjänsteleverantörers kvalitetssäkring av tjänsten. |
Publikt namn | SDK Öppen testmiljö |
Land | SE |
Funktion#<organisationsidentifierare> | Värde |
Funktionsadress | sdk.otm.<organisationsidentifierare> |
Funktionsnamn | SDK Öppen testmiljö <organisationsidentifierare> |
Funktionsbeskrivning | Funktionsadress för att adressera till <organisationsnamn> |
Kategori | Test |
2.2.2 Organisation#2 (ej kontaktbar)
En organisation som är upplagd i SDK Adressbok, men som är okontaktbar.
Den EndpointURI som är kopplad till organisationen i SMP pekar på en felaktig URI.
Organisation#2 | Värde |
---|---|
Organisationsidentifierare | 0203:org002.otm-sdk.inera.se |
Organisationsnummer | 999999-0002 |
Organisationsnamn | SDK Öppen testmiljö - Organisation#2 |
Funktion#1 | Värde |
Funktionsadress | testfunktion.0203:org002.otm-sdk.inera.se |
Funktionsnamn | Testfunktion |
Funktionsbeskrivning | SDK Öppen testmiljö - Testfunktion |
Kategori | Test |
3 Integrationstester
Integrationstester genomförs av tjänsteleverantören för att verifiera dess anslutning till SDK ÖTM. Testfallen verifierar endast grundläggande funktionalitet.
SDK Testklients transportlager (AP)
Verifierar alltid förseglingen, kontrollerar dokumenttyp och skickar avslutningsvis en transportkvittens på inkommande meddelanden med följsamhet till regelverk specificerade i eDelivery miljöspecifikation (se ref. R4)
SDK Testklients meddelandelager (MT)
Kontrollerar duplikat
Verifierar mottagna XHE-meddelandens signatur
Schema- och schematron-validerar alltid mottagna XHE-meddelanden
Schema- och schematron-validerar alltid mottagna SDK-meddelanden och meddelandekvittenser
Meddelanden och meddelandekvittenser som helt bryter mot grundläggande xml struktur loggas internt i SDK Testklient.
SDK Testklient returnerar meddelandekvittens på mottaget meddelande som bryter mot schema eller schematron, med beskrivning på det först påträffade regelbrottet.
SDK Testklient vidarebefordrar (om möjligt) felaktiga meddelanden vidare till organisationens funktionsbrevlåda där användare kan ta del av samtliga regelbrott i meddelandet
SDK Testklients verksamhetslager (MK) ger användaren möjlighet att
Ta del av meddelanden/meddelandekvittenser för sin organisations funktionsbrevlåda
Felsöka baserat på de stateförändringar och eventuella fel som presenteras i SDK Testklient
Tjänsteleverantören ska i första hand kontakta sin AP-operatör som i sin tur kontaktar DIGG om det finns behov för vidare felsökning som rör transportlagret (accesspunkten).
Tjänsteleverantören kan kontakta Inera (SDK federationsoperatör) om det finns behov för vidare felsökning som rör meddelande- eller verksamhetslager (anslutande system), t.ex. om meddelanden eller meddelandekvittenser som förväntas komma fram till SDK Testklient, helt enkelt inte visas i användargränssnittet för SDK Testklient.
3.1 Förutsättningar
Tjänsteleverantörens AP-operatör är ansluten till DIGGs Testmiljö
Tjänsteleverantören är konfigurerad som deltagare i SMP (av tjänsteleverantörens AP-operatör)
Tjänsteleverantören har skickat in SDK anslutningsblankett till Inera för anslutning till SDK ÖTM (se ref. R6).
Tjänsteleverantören har fått en användare med rollen som administratör och med behörighet till den egna organisationen i SDK Adressbok
(gör det möjligt för tjänsteleverantören att själva redigera organisationsuppgifter och registrera funktionsadresser under den egna organisationen)Tjänsteleverantören har registrerat funktionsadresser för den egna organisationen i SDK Adressbok (se ref. R1).
Tjänsteleverantören har fått en användare till SDK Testklient (se ref. R2)
(gör det möjligt att skicka och ta emot meddelanden och meddelandekvittenser)
3.3 Meddelandetjänst (meddelandelagret)
TF 2.0.1 - INTEGRATIONSTEST - Meddelandetjänsten tar del av meddelande från SDK Testklient
Syfte
Kontrollera hur tjänsteleverantörens meddelandetjänst hanterar ett inkommande meddelande och vidarebefordrar meddelandet till meddelandeklienten.
Teststeg
Skicka ett meddelande från SDK Testklient adresserat till en funktion i den egna organisationen.
Tjänsteleverantörens meddelandetjänst validerar meddelandet och genererar en meddelandekvittens automatiskt.
Meddelandeklienten tar del av meddelandet på ett korrekt sätt
Kontrollera att innehållet stämmer överens med vad som angivits i SDK Testklient
Kontrollera att SDK Testklient tagit emot en meddelandekvittens
Kommentar
Tjänsteleverantörens meddelandetjänst förväntas validera utgående meddelandekvittenser.
TF 2.0.2 - INTEGRATIONSTEST - Meddelandetjänsten skickar meddelande till SDK Testklient
Syfte
Kontrollera att meddelandeklienten kan skicka meddelande via organisationens meddelandetjänst till SDK Testklient och att att paketering av meddelandet genomförs på ett korrekt sätt.
Teststeg
Meddelandeklienten skickar ett meddelande via tjänsteleverantörens meddelandetjänst till SDK Testklient.
SDK Testklient tar emot meddelandet
Kontrollera resultatet i SDK Testklient
Kontrollera att meddelandekvittensen når meddelandeklienten
Kommentar
Tjänsteleverantörens meddelandetjänst förväntas validera utgående meddelanden.
Här har tjänsteleverantören stor frihet att bygga upp meddelanden på olika sätt som de skickar för att kunna forcera andra beteenden är det normala (utforskande testning).
3.4 Meddelandeklient (verksamhetslagret)
TF 3.0.1 - INTEGRATIONSTEST - Meddelandeklienten tar del av meddelande från SDK Testklient
Syfte
Kontrollera hur tjänsteleverantörens meddelandeklienten hanterar ett inkommande meddelande som är adresserat till en funktion i den egna organisationen.
Teststeg
Skicka ett krypterat och signerat meddelande från SDK Testklient adresserat till en funktion i den egna organisationen
Användare av meddelandeklienten tar del av meddelandet på ett korrekt sätt
Kontrollera att innehållet stämmer överens med vad som angivits i SDK Testklient (angivna fält presenteras, samtliga bilagor är nåbara och att formateringen är korrekt)
Kommentar
Inera genomför även testet mot tjänsteleverantörens systemlösning i samband med beslut om ‘SDK-godkänd MT och MK’.
TF 3.0.2 - INTEGRATIONSTEST - Meddelandeklienten skickar meddelande till SDK Testklient
Syfte
Kontrollera att användare av meddelandeklienten kan skicka meddelande via tjänsteleverantörens meddelandeklient till SDK Testklient och att en funktion kan adresseras genom att hämta uppgifter från SDK Adressbok.
Teststeg
Användare av meddelandeklienten skickar SDK meddelande via tjänsteleverantörens meddelandeklient till SDK Testklient och organisationens egna funktionsbrevlåda genom att adressera funktionen Funktion#1 (under Organisation#1) som hämtas från SDK Adressbok
SDK Testklient tar emot meddelandet
Kontrollera resultatet i SDK Testklient
Kommentar
Tjänsteleverantören ska även skicka ett meddelande till Inera och SDK-förvaltningens funktionsbrevlåda enligt ‘SDK Självdeklaration för tjänsteleverantörer’ (ref. R5). Meddelandet kontrolleras av Inera och är en förutsättning för Ineras övriga tester i samband med beslut om ‘SDK-godkänd MT och MK’.
4 Systemtest
Anslutningstesterna består även av systemtester som genomförs efter integrationstesterna.
Systemtester genomförs för att verifiera funktionaliteten mer ingående.
SDK Testklient verifierar meddelanden och meddelandekvittenser på samma sätt som i integrationstesterna (se kap. 3).
4.1 Förutsättningar
Integrationstester genomförda för de lager som ska systemtestas.
4.2 Meddelandetjänst (meddelandelagret)
TF 2.1.1 - Meddelandetjänsten tar del av meddelande från SDK Testklient (minimal)
Se TF 2.1.1 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
TF 2.1.2 - Meddelandetjänsten tar del av meddelande från SDK Testklient (maximal)
Se TF 2.1.2 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
TF 2.2.1 - Mottaget meddelande innehåller okänd referens till meddelande
Se TF 2.2.1 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
SDK Testklient saknar stöd att generera felaktigt meddelande, lämpligast att utföra som en del av interna utvecklingstester.
TF 2.3.1 - Meddelande som ska skickas överskrider storleksbegränsning
Se TF 2.3.1 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
TF 2.4.1 - Felhantering - Schemavalidering på mottaget meddelande som innehåller felaktig datatyp
Se TF 2.4.1 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
SDK Testklient saknar stöd att generera felaktigt meddelande, lämpligast att utföra som en del av interna utvecklingstester.
TF 2.4.2 - Felhantering - Schematronvalidering på mottaget meddelande innehåller felaktigt kodverk för elementet 'senderId'
Se TF 2.4.2 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
SDK Testklient saknar stöd att generera felaktigt meddelande, lämpligast att utföra som en del av interna utvecklingstester.
TF 2.4.4 - Felhantering - Mottagna meddelandets identitet är ej unikt
Se TF 2.4.4 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
SDK Testklient saknar stöd att generera felaktigt meddelande, lämpligast att utföra som en del av interna utvecklingstester.
TF 2.4.5 - Felhantering - Mottaget meddelande innehåller felaktig funktionsadress
Se TF 2.4.5 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
SDK Testklient saknar stöd att generera felaktigt meddelande, lämpligast att utföra som en del av interna utvecklingstester.
TF 2.4.6 - Felhantering - Mottaget meddelande kan inte dirigeras vidare
Se TF 2.4.6 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
TF 2.4.8 - Felhantering - Mottaget meddelande överskrider storleksbegränsning
Se TF 2.4.8 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Stöd finns i SDK Testklient att skicka meddelanden med bilagor där sammanlagd storlek är något över 30 MB (max 35 MB).
Kommentar
Inera genomför testet mot tjänsteleverantörens systemlösning i samband med beslut om ‘SDK-godkänd MT och MK’.
TF 2.4.9 - Felhantering - Mottaget meddelande har XHE kuvert som inte speglar adresseringen i SDK meddelandets header
Se TF 2.4.9 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
SDK Testklient saknar stöd att generera felaktigt meddelande, lämpligast att utföra som en del av interna utvecklingstester.
TF 2.5.1 - Felhantering - Utgående meddelande kan inte skickas till otillgänglig deltagare
Se TF 2.5.1 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
TF 2.5.2 - Felhantering - Utgående meddelande kan inte skickas till användarorganisationens accesspunkt
Se TF 2.5.2 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
TF 2.6.2 - Felhantering - Meddelandekvittens REJECTED (maximal)
Se TF 2.6.2 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
TF 2.6.3 - Felhantering - Meddelandekvittens saknas
Se TF 2.6.3 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
TF 2.6.4 - Felhantering - Signatur på inkommande meddelande kan inte verifieras på grund av att cert-pub inte kan nås
Se TF 2.6.4 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
TF 2.6.5 - Felhantering - Signering på inkommande meddelande stämmer inte med publik nyckel
Se TF 2.6.5 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
TF 2.6.6 - Felhantering av inkommande krypterat meddelande där meddelande inte kan dekrypteras
Se TF 2.6.6 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
TF 2.6.7 - Felhantering av inkommande okrypterat meddelande
Se TF 2.6.7 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Lämpligast att utföra som en del av interna utvecklingstester.
4.3 Meddelandeklient (verksamhetslagret)
TF 3.1.1 - Meddelandeklienten tar del av meddelande från SDK Testklient (minimal)
Se TF 3.1.1 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Kommentar
SDK Testklient gör ingen skillnad på TF 2.1.1 och detta testfall.
Inera genomför testet mot tjänsteleverantörens systemlösning i samband med beslut om ‘SDK-godkänd MT och MK’.
TF 3.1.2 - Meddelandeklienten tar del av meddelande från SDK Testklient (maximal)
Se TF 3.1.2 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Kommentar
SDK Testklient gör ingen skillnad på TF 2.1.2 och detta testfall.
Inera genomför testet mot tjänsteleverantörens systemlösning i samband med beslut om ‘SDK-godkänd MT och MK’.
TF 3.1.3 - Meddelandeklienten tar del av ett sekretessmarkerat meddelande från SDK Testklient
Se TF 3.1.3 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
TF 3.2.1 - Meddelandeklienten besvarar mottaget meddelande
Se TF 3.2.1 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Kommentar
Frivillig funktionalitet. Tjänsteleverantören kan i samma konversation som ett mottaget meddelande, skicka ett svar till Inera och SDK-förvaltningens funktionsbrevlåda. Meddelandet kontrolleras av Inera.
TF 3.2.2 - Meddelandeklienten tar del av besvarat meddelande
Se TF 3.2.2 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Kommentar
Inera genomför även testet mot tjänsteleverantörens systemlösning i samband med beslut om ‘SDK-godkänd MT och MK’. Svaret baseras på meddelandet som togs emot i TF-3.0.2.
TF 3.3.1 - Meddelandeklienten kompletterar skickat meddelande
Se TF 3.3.1 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Kommentar
Frivillig funktionalitet. Tjänsteleverantören kan i samma konversation som ett skickat meddelande, skicka en komplettering till Inera och SDK-förvaltningens funktionsbrevlåda. Meddelandet kontrolleras av Inera.
TF 3.3.2 - Meddelandeklienten tar del av kompletterat meddelande
Se TF 3.3.2 i ‘SDK Testinstruktioner för anslutningstester’ (se ref. R6).
Kommentar
Inera genomför även testet mot tjänsteleverantörens systemlösning i samband med beslut om ‘SDK-godkänd MT och MK’. Kompletteringen baseras på meddelandet som skickades i TF-3,0.1