Licensansökan - Webbapplikation för systemleverantörer
Bilaga till handboken för apoteksaktörer
1. Inledning
1.1 Syfte och avgränsningar
Dokumentet är en instruktion för leverantörer av expedieringssystem som ska använda KLAS-webbapplikation i sina system. Dokumentet förutsätter en grundläggande förståelse av STP-plattformen.
1.2 Begrepp
Begrepp | Förklaring |
STP | E-hälsomyndigheten tjänsteplattform. |
Användare | Den farmaceut som använder KLAS-webbapplikation. |
LIC | Licensansökan. |
| KLAS | Kommunikationslösning för licensansökan. |
1.3 Referenser
Dokument | Beskrivning |
Funktionsspecifikation-GT (gällande version) | Beskriver de tjänster som ingår i STP-komponenten GT |
2. Användning i expeditionssystem
2.1 Övergripande
KLAS-webbapplikation är en webbapplikation som är tillgänglig via en webbläsare. För att öppna KLAS-webbapplikationen måste man länka från expedieringssystemet till en webbläsare som öppnar KLAS-webbapplikationen. För att slippa en manuell inloggning av användaren i KLAS-webbapplikation ska expedieringssystemet anropa en tjänst i STP som returnerar ett sessions-id som expedieringssystemet sedan använder när det öppnar KLAS-webbapplikationen. KLAS-webbapplikation validerar sessions-id, och om det är korrekt loggas användaren in i KLAS-webbapplikationen.
Anropande system ska säkerställa att endast farmaceuter ges åtkomst till KLAS.
2.2 Steg för steg
- Expedieringsssystemet anropar tjänsten GT.SkapaSessionIdService för att få ett sessions-id som används för inloggning i KLAS-webbapplikation (svarsparametern sessionId). Sessions-id är aktuellt i endast tio sekunder, så inloggning i KLAS-webbapplikationen måste ske inom den tidsperioden.
- Expedieringssystemet startar webbläsaren med en URL som adresserar KLAS-webbapplikationen samt det sessions-id som returnerades från tjänsten GT. SkapaSessionIdService. URL:en som används är fördefinierad. Sessions-id läggs till sist i URL:en.
- KLAS-webbapplikationen loggar in farmaceuten och visar en initial söksida för licensärenden.
- Farmaceuten är inloggad i KLAS-webbapplikationen och kan nu arbeta vidare där. Farmaceutens legitimationskod visas i övre högra hörnet.
2.3 Tjänster
Här presenteras ett urval av de berörda tjänsternas parametrar. För en komplett beskrivning av tjänsternas parametrar hänvisas till respektive funktionsspecifikation.
2.3.1 GT.SkapaSessionIdService
Returnerar ett sessions-id som ska anges i URL-en när KLAS-webbapplikationen ska öppnas i webbläsaren.
SkapaSessionId - request
Fält | Typ | Validering | Beskrivning |
|---|---|---|---|
klientinformation | Klientinformation | Information om klienten som anropar tjänsten. | |
attributLista | Attribut[] | Attribut att spara. |
Attribut- request
För att komma in i KLAS webbklient behöver man i SkapaSessionsId skicka med nyckel-värde-par i attributlistan, se nedan.
Legitimationskod
Fält | Typ | Validering | Beskrivning |
|---|---|---|---|
Nyckel | String | 1..64 | Ange "legitimationskod" som nyckel. |
Varde | String | 1..256 | Farmaceutens legitimationskod. |
Förnamn
Fält | Typ | Validering | Beskrivning |
|---|---|---|---|
Nyckel | String | 1..64 | Ange "fornamn" som nyckel. |
Varde | String | 1..256 | Farmaceutens förnamn. |
Efternamn
Fält | Typ | Validering | Beskrivning |
|---|---|---|---|
Nyckel | String | 1..64 | Ange "efternamn" som nyckel. |
Varde | String | 1..256 | Farmaceutens efternamn. |
Klientinformation - request
Fält | Typ | Validering | Beskrivning |
|---|---|---|---|
System | String | 13..13 | GLN-kod för anropande system. |
Anvandare | String | 1..20 | Unikt användarid i anropande system. |
Session | String | 1..62 | Sessionens id i anropande system. |
SkapaSessionId - reply
Fält | Typ | Validering | Beskrivning |
|---|---|---|---|
sessionId | String | 32..32 | Temporärt sessions-id som används för inloggning i KLAS-webbapplikationen. Detta id läggs sist i den URL som anger KLAS-webbapplikationens adress. |
2.4 URL
Adressen till KLAS-webbapplikation ser ut enligt nedan (icke fungerande exempel). Den faktiska adressen beror på vilken miljö hos E-hälsomyndigheten som expeditionssystemet kommunicerar med.
https://10.100.100.100/licensansokan/ansokan
För att bli inloggad måste sessions-id anges efter URL:en enligt följande:
https://10.100.100.100/licensansokan/ansokan?sid=ff80808128b537850128ca66d1c123b6
Sessions-id måste döljas i webbläsarens adressfält.
2.5 Systemkrav
2.5.1 Webbläsare
KLAS stödjer följande webbläsare och vi strävar efter att löpande testa och verifiera senare versioner av dem.
- Google Chrome
- Mozilla Firefox
- Microsoft Internet Explorer
- Microsoft Edge
2.5.2 Operativsystem
Inget speciellt krav.
Versionshistorik
Version | Datum | Kommentar |
|---|---|---|
1.0 | 2014-02-17 | Version 1.0 fastställd |
2.0 | 2014-05-07 | Referens uppdaterad. |
3.0 | 2014-10-01 | 1.2, Förtydligat användare. 1.3, Uppdaterat referens. 2.2, Förtydligat farmaceut. 2.4, Gulmarkering av sekretess. 2.5, Förtydligande av systemkrav. |
| 4.0 | 2017-11-10 | Ändrat LIC-webbapplikation till KLAS-webbapplikation i bilagan 1.2 Lagt till KLAS med förklaring i tabell 2.4 Ändrat från http: till korrekta https: |
| 7.0 | 2020-01-10 | 2.4 Tagit bort gulmarkerade avsnitt |
| 8.0 | 2021-03-11 | 2.1 Förtydligat krav på anropande system. 2.3.1 Redaktionell ändring. 2.5.1 Uppdaterat information om webbläsare. |