Sovelluksen liittäminen hyvinvointisovellusten rajapintaan

Sovellukset ja digitaaliset asiointipalvelut voivat hakea potilastietoja Kannasta, kun ne liitetään hyvinvointisovellusten rajapintaan.

Sovelluksen liittäminen rajapintaan etenee vaiheittain ja kestää arviolta noin 2-3 kuukautta.

Sovelluksilla pitää olla luotetussa ympäristössä toimiva taustapalvelu. Taustapalvelu hoitaa liikennöinnin rajapinnan kanssa.

Hyvinvointisovelluksen liittäminen rajapintaan

Tutustu Terveyden ja hyvinvoinnin laitoksen määräyksiin (thl.fi)(avautuu uuteen ikkunaan) kehittäessäsi hyvinvointisovellusta:

  • THL:n määräys 4/2024
  • THL:n määräys 5/2024
  • Asiakastietoja käyttävä hyvinvointisovellus -profiili.

Tutustu myös

Rajapinnan käytölle löydät tukea seuraavista paikoista:

Ilmoittaudu asiakastestiympäristöön toimittamalla Kanta-palveluihin seuraavat lomakkeet: 

Lähetä lomakkeet sähköpostilla osoitteeseen kanta@kanta.fi.

Kun Kela on hyväksynyt hakemuksesi, hae hyvinvointisovellustestipalveluvarmenne Digi- ja väestötietovirastosta (DVV).

  • Palvelinpohjaiset sovellukset tarvitsevat asiakastestiympäristöön sekä yhteistestausta varten DVV:n hyvinvointisovellusten testipalveluvarmenteen.
  • Voit hakea testipalveluvarmenteen vasta, kun sovellus on hyväksytty asiakastestiympäristöön ja Kela on antanut sovellustoimittajalle sovelluskohtaisen organisaation OID-koodin.
  • Lähetämme Kelasta tarkemmat ohjeet varmenteen hakemiseen erillisessä ohjeessa.
  • Palveluvarmenne ja sovellus kytketään toisiinsa palveluvarmenteen Subject-osion serialNumber-kentään merkityllä OID-tunnuksella.
    • OID-tunnus on järjestelmätoimittajan sovellukselle hakema yksilöivä OID-tunnus.
Lue lisää asiakkuudesta ja asiakastestiympäristöstä.

Hyvinvointisovelluksen sertifiointi sisältää Kanta-palvelujen yhteistestauksen, Traficomin hyväksymän arviointilaitoksen suorittaman tietoturvallisuuden arvioinnin ja sovelluksen rekisteröimisen Valviran rekisteriin.

Tutustu sertifiointiin ja olennaisiin vaatimuksiin

Vaaditut toiminnallisuudet on kuvattu THL:n määräyksen 5/2024 liitteessä 3h (thl.fi)(avautuu uuteen ikkunaan).

Yhteistestauksella tarkoitetaan sovelluksen sisäisen testauksen todentamista ja toimivuuden varmentamista Kanta-palvelujen asiakastestiympäristöä vasten. Yhteistestaus on tarkoitettu kehitystyön loppuvaiheen testaukseen.

Tutustu yhteistestausprosessiin

Sovellustoimittaja vastaa siitä, että sovellukseen liittyvä muu testaus tehdään riittävällä laajuudella sekä laadullisesti hyvällä tasolla. 

Osapuolet ja vastuut yhteistestauksessa

Ilmoittaudu yhteistestaukseen toimittamalla Kelaan hakemuslomake Hyvinvointisovellusten rajapinta potilastietoihin –palvelun ilmoittautumislomake. Lähetä lomake sähköpostilla osoitteeseen kanta@kanta.fi(avautuu uuteen ikkunaan).

Hyvinvointisovellusten on läpäistävä Traficomin hyväksymän tietoturvallisuuden arviointilaitoksen suorittama tietoturvallisuuden arviointi. 

Lue lisää tietoturvallisuuden arvioinnista
  1. Ilmoita hyvinvointisovellus Valviran Tietojärjestelmien rekisteriin (valvira.fi)(avautuu uuteen ikkunaan). Varmista, että hyvinvointisovellus löytyy rekisteröitymisen jälkeen Astori-rekisteristä(avautuu uuteen ikkunaan).
  2. Ilmoita tarve tuotantokäytön aloittamiselle Kelaan (kanta@kanta.fi). Kela lähettää toimittajalle palvelun tekniseen rekisteröitymiseen tarvittavat dokumentit (vaiheet 4 ja 5) sekä toimittaa tuotantovalmiustiedon THL:n Koodistopalvelun sovellusrekisteriin.
  3. Hanki DVV:n tuotantopalvelinvarmenne (dvv.fi)(avautuu uuteen ikkunaan). Palvelinpohjaiset sovellukset tarvitsevat tuotantoa varten DVV:n hyvinvointisovellusten palveluvarmenteen.
    • Palveluvarmenne ja sovellus kytketään toisiinsa palvelinvarmenteen Subject-osion serialNumber-kentään merkityllä OID-tunnuksella.
    • Kanta-palveluihin liitetään Hyvinvointisovelluksen taustajärjestelmä eli järjestelmätoimittajan palvelimella toimiva palvelinsovellus. Palvelulle määritettyjen IP-osoitteiden pitää olla kiinteitä ja kuulua julkiseen IP-osoiteavaruuteen.
    • Hyvinvointisovellusten tietoliikenne kulkee julkisen internetin kautta Kanta-palveluihin.
  4. Hyväksy hyvinvointisovellusten rajapinnan toimitusehdot ja palvelukuvaus allekirjoittamalla sitoumusdokumentti ja toimittamalla sitoumus Kelaan.
  5. Toimita julkaistavan sovelluksen tiedot Kelaan (kanta@kanta.fi) tietojen ilmoittamiseen tarkoitetulla lomakedokumentilla. Kela lähettää ilmoituksen hyväksymisestä palvelun käyttäjäksi ja toimittaa sovellustoimittajalle tuotantokäyttöön tarvittavat tekniset tiedot. 
    • Sovellus rekisteröidään teknisesti Kanta-palveluissa rajapintapalveluun. Edellytyksenä tekniselle rekisteröinnille on, että hyvinvointisovellus on julkaistu Valviran rekisterissä.
    • Sovellus lisätään kanta.fi-sivustolla olevaan sovellusluetteloon kahden viikon kuluttua teknisestä rekisteröinnistä.
  6. Varmista tuotannon toimivuus ja ilmoita yhteyden toimivuudesta Kelaan (kanta@kanta.fi). Sovelluksen tuotantokäyttö voidaan tämän jälkeen aloittaa.

Ilmoita havaitsemistasi virhe- ja häiriötilanteista hyvinvointisovelluksessa tai sovellusten rajapinnassa Kelaan (kanta@kanta.fi). Virhetilanteen selvittämiseksi viestiin on liitettävä haku- ja vastaussanomat, joista on Access Token ja henkilötunnus anonymisoitu. Molemmat sanomat toimitetaan kokonaisuudessaan (header ja body).

Jatkossa yhteistestauksessa käytettyjä testihetuja ei saa käyttää omissa testauksissa.

Sovelluksen käyttäjät saavat potilastietonsa hyvinvointisovellukseen antamalla sovellukselle käyttöoikeudet potilastietoihinsa ja hyväksymällä informoinnin potilastietojen saamisesta hyvinvointisovellukseen (pdf)(avautuu uuteen ikkunaan).
 

Ilmoita muutoksista lähettämällä muutosilmoituslomake sähköpostilla osoitteeseen kanta@kanta.fi.