Tjenestebeskrivelse for NHN-EDI med opsjon FTPS

Transkript

1 Tjenestebeskrivelse fr NHN-EDI med psjn FTPS Fr sending g mttak av stre meldinger Versjnskntrll: Dkumentstatus Versjn Status Ansvarlig Dat 1.15 Gdkjent Trnd Utne Larsen

2 1 Innhld 1 Innhld 2 2 Generelt 3 3 Tjenester sm inngår 4 4 Tekniske frutsetninger 4 5 Oppsett g bruk av tjenesten 4 6 Tekniske frklaring Bruk av tjenesten Beskrivelse av verføringsprtkll Filmrådet Navngiving av filer g adresseringer Oppsummering g knkretisering Leveransegaranti Oppbevaring av filer på tjener 9 7 Ansvars- g ppgavefrdeling mellm Kunde g Nrsk Helsenett AS 9 8 Servicenivå 9 9 Brukerstøtte 9 10 Hvrdan få tilgang til tjenesten Priser fr etablering g bruk Ytterligere infrmasjn 10 Side 2 av 10

3 2 Generelt Dette dkumentet gir en beskrivelse av tjenesten NHN-EDI med psjn FTPS, sm dekker EDI-løsningen fr sending g mttak av stre EDI-meldinger. Dkumentet frteller hvrdan tjenesten kan brukes, g beskriver nødvendige tiltak fr å nyttegjøre seg tjenesten. Målgruppe fr dkumentet er EDI-ansvarlige (avsnitt 4-5) g teknikere sm er ansvarlig fr knfigurasjn av de tjenere g systemer sm skal benytte seg av tjenesten (avsnitt 4-6). FTPS er en psjn til tjenesten NHN-EDI sm er en løsning fr utveksling av større datasett. Dataene transprteres via prtkllen FTPS (FTP ver eksplisitt TLS/SSL). Større datafiler kan være rapprteringsdata (eks. NPR-recrd) eller en serie med røntgenbilder. Tjenesten er freløpig kun bygd etter behv fr rapprtering til NPR. Før bruken kan utvides til andre mråder må tilgjengelighet g ytelse til tjenesten tilpasses i frhld til økte krav sm stilles i frhld til endret bruk av løsningen. Nrsk Helsenett kan derfr p.t. ikke supprtere annen bruk enn rapprtering til NPR på løsningen, men åpner fr testing av fr eksempel sending av røntgenbildeserier etter avtale. Nrsk Helsenett gjør ppmerksm på at kstnader kan tilkmme på annen bruk av tjenesten enn rapprtering til NPR. Fr NPR løsningen er ebxml rammeverket benyttet g det må være etablert på kmmunikasjnsmdulene. Fr sending g mttak av sensitive pasientdata i helsenettet, sm labsvar, henvisninger, epikriser sv. benyttes tjenesten NHN-EDI, sm er EDI-løsningen fr sending g mttak av EDI-meldinger mindre enn 10 MB. Denne tjenesten er beskrevet i egen tjenestebeskrivelse. Figur 1 - Prinsippskisse Side 3 av 10

4 3 Tjenester sm inngår Grunntjeneste EDI-FTPS Grunntjeneste SAN Grunntjeneste Databaser FTPS løsningen verfører data mellm knter i systemet minimum en gang i timen. Dataene mellmlagres på SAN-løsningen i påvente av at den lastes ned. Backup av data : Det er en frutsetning at EDI meldinger er lagret på avsendernivå g det anbefales sterkt bruk av applikasjnskvitteringer i kmmunikasjnsløsningene. Nrsk Helsenett garanterer derfr ikke at data sm mellmlagres på våre SAN-løsninger blir sikkerhetskpiert, men vi tar rutinemessig autmatiske backuper av alle data knyttet til EDI løsningene. 4 Tekniske frutsetninger Fr å få tilgang til tjenesten må følgende være på plass: Eksisterende tilknytning til helsenettet Eksisterende EDI-knt i helsenettet med kjent adresse, brukernavn g passrd Leveringsbekreftelse fr tjenesten NHN-EDI med psjn FTPS med versikt ver tjenere sm skal benyttes. Tilstrekkelig åpninger i lkale brannmurer. Tjenesten benytter seg av passiv FTP, g benytter prt 21 fr initiell ppkbling mt tjeneren samt at en dynamisk prt i mrådet til benyttes fr sekundær datakanal. Man har en applikasjn sm kan benytte tjenesten. Følgende Applikasjner (versjner) er hittil testet fr bruk av tjenesten NHN-EDI med psjn FTPS: NPR-Recrd DIPS (Well) Cmmunicatr, versjn 6 (med ebxml g FTPS aktivert) 5 Oppsett g bruk av tjenesten Fr ppsett g bruk av tjenesten via dedikerte applikasjn bør det tas kntakt med applikasjnsleverandør fr veiledning i frhld til hvrdan en gjør dette. Tjenesten kan benyttes direkte ved å sette seg inn i separat dkument fr infrmasjn m hvrdan en kan integrere seg mt tjenesten, men i praksis så vil dette være infrmasjn sm kun vil være relevant fr applikasjnsleverandører g sm sluttbruker er dette infrmasjn sm må skaffes fra prgramvareleverandør. Side 4 av 10

5 6 Tekniske frklaring 6.1 Bruk av tjenesten Tjenesten fungerer på en slik måte at brukeren hele tiden frhlder seg til sin egen hjemmekatalg på tjeneren g kan utveksle filer med andre knter i systemet ved å frhlde seg til de etablerte prsedyrer fr utveksling av filer via tjenesten NHN-EDI med psjn FTPS. Påfølgende underkapitler beskriver hvrdan dette gjennmføres ved å beskrive verføringsprtkller, filstrukturer samt prsedyrer fr utveksling av filer Beskrivelse av verføringsprtkll Sm nevnt innledningsvis så benyttes det i tjenesten prtkllen FTPS sm bæreprtkll mellm klient g tjener. Det er utenfr dette dkumentets rekkevidde å beskrive hvrdan FTP-prtkllen fungerer i detalj utver å skissere at prtkllen skisserer ett sett med kmmander sm kan utveksles mellm tjener g klient. Ett punkt sm er nødvendig å bemerke seg med denne prtkllen er at den til frskjell fra andre velkjente prtkller ikke utveksler kmmander g ren data ver en enkelt kmmunikasjnskanal, g det etableres en separat kanal fr henhldsvis kmmander g data. FTPS fungerer tilnærmet identisk med FTP med de endringer at kmmandkanalen er ende-til-ende kryptert ved bruk av SSL, g på denne måten beskytter brukernavn g passrd. Av sikkerhetshensyn så benyttes det kun såkalt passiv FTP, g det vil ikke bli gitt tilgang til bruk av andre kmmander på tjeneren enn de sm er nødvendig fr bruk av tjeneren. Følgende kmmander er tillatt på tjeneren: READ CWD XCWD CDUP LIST NLST APPE* STOR* DELE* RNFR* RNTO* * Disse kmmandene er kun tilgjengelig på spesifikke mråder av filstrukturen. Side 5 av 10

6 6.1.2 Filmrådet Hver knt har ett eget filmråde innenfr EDI-systemet, g dette vil alltid ha en struktur slik sm illustrert i figur 2 nedenfr. Disse tre katalgene på tjeneren representerer brukerens grensesnitt mt det underliggende system, g ved interaksjn med disse kan det utveksles filer mellm ulike knter. Figur 3. Katalgstruktur incming Denne katalgen innehlder filer sm er mttatt fra andre knter i systemet, g innhldet her kan lastes ned. Vet utsendelse av meldinger er det lagt inn rutiner fr å generere ett kryptgrafisk fingeravtrykk av alle filer sm sendes dette fingeravtrykket er vedlagt i en separat fil med samme filnavn, men med endelsen.hash. Dette fingeravtrykket kan benyttes fr å verifisere at filen er krrekt verført fra tjener til klient. Det frventes at klienten sletter disse filene etter mttak. utging Denne katalgen innehlder filer sm skal sendes fra klienten til en annen knt i systemet. Klienten kan laste pp filer i denne katalgen, g ved brudd i verføring kan en gjenppta pplastingen fra det punktet der bruddet ppst. Legg merke til at filen skal alltid lastes pp med endelsen.partial, g ved fullført verføring fjernes denne endelsen ved at filen gis ett nytt navn. undeliverable Dersm det underliggende systemet ikke er i stand til å verføre en fil til den spesifiserte mttakeren, eksempelvis ved at knten ikke eksisterer eller er deaktivert, så vil filene bli flyttet hit, g flere frsøk på verlevering vil bli fretatt. Ved ønske m enklere deteksjn av feil sm fører til at filer havner her anbefales det at det tas i bruk applikasjnskvitteringer fr garantert leveranse. Det frventes at klient med jevne mellmrm sjekker dette mrådet, laster ned eventuelle filer fr så å slette filene sm blir liggende her slik at dette gjøres på en kntrllert måte. Side 6 av 10

7 Utveksling av filer mellm knter via de ulike katalgene i de ulike kntenes hjemmemråder fregår i henhld til det frenklede flytskjemaet gjengitt nedenfr. Figur 4: Flytskjema, utveksling av fil mellm knter Navngiving av filer g adresseringer FTP-prtkllen, eller FTPS-prtkllen fr den saks skyld, er i utgangspunktet ikke designet fr utvekslet av filer mellm knter den er designet fr utveksling av filer mellm en klient g en tjener. Det dette vil si er at prtkllen i seg selv ikke har har nen frståelse fr hvilken mttaker sm etter hvert skal mtta filen, g en kan si at den i seg selv ikke har nen funksjnalitet fr adressering av infrmasjnen sm skal utveksles. Fr å kmme rundt denne begrensningen så er det skissert spesielle frmateringsregler i henhld til hvrdan filnavnet på filene sm utveksles skal bygges pp. Filnavnene er delt pp i frskjellige seksjner, adskilt med semikln, der enkelte av feltene endrer funksjn etter kntekst. Filnavnene bygges pp etter følgende frmat: ID;Adresse;Beskrivelse Beskrivelse av de ulike feltene ID Dette feltet benyttes kun på innkmmende filer. Feltet legges på av det underliggende systemet fr å unngå verlapping av filnavn mellm avsendere g mttakere. Adresse Dette feltet endrer betydning etter kntekst, g må være en gyldig EDIadresse. Ved filer plassert i katalgen incming så beskriver dette feltet avsenderens adresse. Ved filer plassert i katalgen utging eller undeliverable så beskriver dette feltet ønsket mttakers adresse Side 7 av 10

8 Beskrivelse Dette feltet er pp til brukeren av tjenesten å skissere struktur på selv m vi på det sterkeste anbefaler en unik identifikatr på hver fil fr å unngå at en med ett uhell verskriver egen data på katalgen utging på kntens eget hjemmemråde. Det ikke skal benyttes spesialtegn utver bindestrek g punktum da flere spesialtegn har annen betydning på filsystemnivå, g dermed ikke skal benyttes. Av stabilitetsårsaker i henhld til knvertering mellm ulike tegnsett så skal det kun benyttes alfanumeriske tegn i rekken A-Z, a-z samt 0-9. Eksempler på navngiving g adressering: 1. Utgående fil sendt fra legekntr-b@edi.nhn.n : Fil plassert i utging-katalgen på FTPS-tjeneren med følgende filnavn: legekntr-a@edi.nhn.n;readme.txt Mttaker Beskrivelse legekntr-a@edi.nhn.n README.txt 2. Innkmmende fil mttatt fra legekntr-a@edi.nhn.n: Fil plassert i incming-katalgen på FTPS-tjeneren med følgende filnavn: C F083E399E8707FF0;legekntr-b@edi.nhn.n;README.txt Unik ID Avsender Beskrivelse C F083E399E8707FF0 legekntr-b@edi.nhn.n README.txt Oppsummering g knkretisering Utveksling av filer vil fregå i henhld til den navngiving sm er definert i dette dkumentet ved at en laster pp/ned filer g mdifiserer dem i henhld til den beskrivelsen av katalgstrukturen sm er gitt det er dette sm menes med prsedyrer fr bruk av tjenesten NHN-EDI med psjn FTPS. Oppsummert så vil en utveksling av filer i hvedtrekk fregå på følgende måte (tar utgangspunkt i at filen README.txt sendes fra legekntr-b@edi.nhn.n til legekntrb@edi.nhn.n): Knt legekntr-b@edi.nhn.n sender fil: 1. Knten genererer ett filnavn fr versendelsen basert på det definerte frmatet g ender pp med navnet edi-legekntr-a@edi.nhn.n;readme.txt. 2. Kbler seg pp mt tjenesten NHN-EDI med psjn FTPS, g starter med pplastingen av filen til katalgen /utging med filendelsen.partial. 3. Signaliserer til tjeneren at filen er kmplett ved å gi ett nytt navn på filen ved å fjerne endelsen.partial. Filen vil nå bli verlevert mttakeren ved neste anledning. Side 8 av 10

9 Knt laster ned nye filer: 1. Kbler seg pp mt tjenesten EDI-FTPS, g ser at det er kmmet inn t nye filer i incmmingkatalgen ved navn C F083E399E8707FF0;legekntrb@edi,nhn.n;README.txt g C F083E399E8707FF0;legekntrb@edi.nhn.n;README.txt.hash. 2. Filene lastes ned fra tjeneren, g en kan nå freta en integritetssjekk på filen ved å validere fingeravtrykket sm er lagt ved i.hash -filen. 3. Filene slettes fra incming-katalgen på tjeneren Leveransegaranti I utgangspunktet gis det ingen leveransegaranti på ende til ende kmmunikasjn ved bruk av tjenesten NHN-EDI med psjn FTPS, g fr å dekke inn dette behvet så skal det i de situasjner der det påkreves benyttes applikasjnskvitteringer via den rdinære EDIinfrastrukturen Oppbevaring av filer på tjener Tjenesten er ikke skalert fr langtidsppbevaring av filer g den skal dermed ikke benyttes fr langvarig ppbevaring av filer filer sm blir liggende lengre enn en gitt tidsperide vil kunne bli fjernet g det er dermed viktig at applikasjnene tar hensyn til dette. 7 Ansvars- g ppgavefrdeling mellm Kunde g Nrsk Helsenett AS Kunden har ansvaret fr: kmmunikasjnsløsningen lkalt Integrasjn mellm sine systemer g kmmunikasjnsløsningen Oppsett mt eksterne kmmunikasjnsparter, herunder PKI g Applikasjnskviteringer Nrsk Helsenett har ansvar fr: WAN nettverksløsningene Sentrale EDI systemer, herunder SAN g Databaser 8 Servicenivå Standard servicenivå fr tjenesten er en dekningsperide fra 08:00 17:00 på alle virkedager, respnstid fr påbegynt feilsøking er da maksimum 30 minutter etter innmelding, tilbakemelding til kunde senest 2 timer etter innmelding, g en tilgjengelighet fr tjenesten på 99,5% per kvartal. 9 Brukerstøtte Alle henvendelser fra kunde skal skje til Nrsk Helsenetts Kundesenter på telefn 02017, eller med e-pst til kundesenter@nhn.n Side 9 av 10

10 10 Hvrdan få tilgang til tjenesten Tjenesten bestilles ved å fylle ut bestillingsskjema NHN-EDI med psjn FTPS. Nrsk Helsenetts kundeansvarlige er behjelpelige med utfylling av dette. Skjemaet må være signert av den sm har fullmakt til å freta bestilling. Etter at Nrsk Helsenett har mttatt signert avtale eller bestilling, vil det systemmessig bli åpnet fr tilgang til tjenesten. 11 Priser fr etablering g bruk Gjeldende priser fr etablering g bruk er gitt i gjeldende bestillingsskjema. 12 Ytterligere infrmasjn Dersm det ønskes ytterligere infrmasjn m tjenesten, sm funksjnalitet, krav til kundes utstyr, sikkerhet g pris, ta kntakt med Nrsk Helsenetts Kundesenter på telefn 02017, eller med en e-pst til: kundesenter@nhn.n Side 10 av 10