Palveluväylä tekninen työpaja

Transkriptio

1 Palveluväylä tekninen työpaja

2 Päivän ohjelma ja harjoitukset palveluvayla.fi Tilaisuudet Tekninen työpaja

3 Esittäytymiset

4 Palveluväylän yleisesittely

5 Mikä on Suomi.fi palveluväylä? Yhteentoimivuuden takaava digitaalisten palveluiden infrastruktuuri Väylään liitettyjen palveluiden välillä tiedonsiirto standardoitua ja turvallista (Vahti ST4) Perustuu Virolaisten kanssa yhteistyössä kehitettävään X-Road 6 teknologiaan Integraatioalusta tukemaan olemassa olevia vyöhykeratkaisuja (esim. KY, VYverkkoja) - se ei tule korvaamaan niitä

6 Yleisesittely Loppukäyttäjälle palveluväylä on läpinäkyvä tiedonvälityskerros Palveluväylän hyödyt syntyvät väylään kytketyistä palveluista Palveluväylän arvo on sen muodostamassa standardoidussa tietojen vaihdon ratkaisumallissa Tiedonvaihto yksityisen että julkisen sektorin palveluiden välillä Tiedonvaihto mahdollista vain toimijoidenvälisten sopimusten kautta. Palveluväylän kautta tarjotut palvelut eivät ole kaikille automaattisesti avoimia

7 Palveluväylä komponentit + liityntäkatalogi

8 Ylläpitovastuu VRK ja CSC vastaavat keskuskomponenttien ylläpidosta VRK vastaa varmennepalvelun ja aikaleimapalvelun toteutuksesta ja ylläpidosta Väylään liittynyt organisaatio : vastaa siitä, että palvelut täyttävät tekniset rajapintavaatimukset vastaa siitä, kuka saa kutsua organisaation liityntäpalvelinta ylläpitää omat palvelunsa ylläpitää oman liityntäpalvelimensa päättää kuka saa käyttää väylään liitettyjä palveluita (kahdenväliset sopimukset)

9 Sanomanvälityksen perusperiaatteet

10 Harjoitus osa 1 1) RHEL liityntäpalvelimen asennus komentoriviltä 2) Selaimessa tehtävät aloituskonfigurointi 3) PIN-koodin syöttö ja aikaleimapalvelun valitseminen

11 Liityntäpalvelimen käyttämät portit

12 Harjoitus osa 2 Allekirjoitus ja autentikointiavaimenten luonti

13 Lounastauko

14 Harjoitus osa 3 Allekirjoitettujen sertifikaattien importointi

15 Termistö Services

16 Muuttujien väliset suhdeluvut

17 Harjoitus osa 4 Alijärjestelmän lisääminen

18 X-Road SOAP protokolla

19 X-Road SOAP Liityntäpalvelimet välittävät ainoastaan tietyn formaatin mukaisia SOAP viestejä SOAP 1.1 document literal palveluja SOAP headereissa pitää olla X-Roadin omat kentät SOAP bodyn rakenteen pitää noudattaa määriteltyjä käytäntöjä

20 X-Road SOAP protokolla, header Header protocolversion id userid client service requesthash Selitys Vakio 4.x Viestin tunniste. Uniikit tunnisteet hyvä käytäntö. Tietyt admin-toiminnot hyödyntävät (viestilokista haku) Toisin kuin Virossa, ei ole loppukäyttäjän tunniste - Kutsujan koordinaatit instanssi/member class/member code/subsystem code - objecttype = SUBSYSTEM Palvelun koordinaatit: instanssi/member class/member code/subsystem code/service code/service version Tiiviste vastausviestille (liityntäpalvelin populoi)

21 X-Road SOAP-protokolla, body Bodyn sisällä oltava tasan yksi, palvelun nimen mukainen elementti Viestejä lokitetaan (kanta, tiedostojärjestelmä) SOAP body voidaan olla lokittamatta (henkilörekisteriasiat) <soapenv:body> <prod:getrandom>foo</prod:getrandom> </soapenv:body>

22 Vastaussanoma Vastauksessa kuuluu olla yksi elementti, <palvelun nimi> + Response Tämän elementin sisällä kuuluisi olla (vain konventioita) Pyynnön *Request-elementin sisältö <request> elementin sisällä Varsinainen vastaus <response> elementin sisällä Vastauksessa tulee olla samat SOAP header elementit kun kutsussa <SOAP-ENV:Body> <ts1:getrandomresponse xmlns:ts1=" <ts1:request/> <ts1:response> <ts1:data>27</ts1:data> </ts1:response> </ts1:getrandomresponse> </SOAP-ENV:Body>

23 Validointi Paljon sääntöjä viestin rakenteelle! Liityntäpalvelimet tarkistavat useimpien käytäntöjen noudattamisen ja kieltäytyvät siirtämästä viestiä jos niitä ei noudatettu SOAP envelope schemavalidoidaan Viestin bodyä ei schemavalidoida Bodynkin kuuluu olla well-formed XML Jotta kaikkiin integroitaviin liittymiin ei tarvitse työläästi toteuttaa X-Roadin vaatimia ominaispiirteitä, kannatta harkita jotain uudelleenkäytettävää adapter service ratkaisua

24 WSDL Esitellään xroadin headerit: <wsdl:message name="requestheader"> <wsdl:part name="client" element="xrd:client" /> <wsdl:part name="service" element="xrd:service" /> <wsdl:part name="userid" element="xrd:userid" /> <wsdl:part name="id" element="xrd:id" /> <wsdl:part name="issue" element="xrd:issue"/> <wsdl:part name="protocolversion" element="xrd:protocolversion" /> </wsdl:message> Tyyli on document / literal: <wsdl:binding name="testservicebinding" type="tns:testserviceporttype"> <soap:binding style="document" transport=" /> <wsdl:operation name="getrandom"> <soap:operation soapaction="" style="document" /> <id:version>v1</id:version> <wsdl:input> <soap:body parts="body" use="literal"/> <soap:header message="tns:requestheader" part="client" use="literal"/>

25 Harjoitus osa 5 Testipalvelun kutsuminen

26 Extra: Sovitinpalvelu

27 Sovitinpalvelu X-Roadin SOAP protokolla vaatii omat headerinsa ja tiettyjen käytäntöjen noudattamista viesteissä Väylään liitettävä palvelu ei tyypillisesti sisällä näitä entuudestaan X-Road protokollaa tulkkaavasta komponentista käytetään termiä sovitinpalvelu (adapter service) Sovitinpalvelu on X-Roadin liityntäpalvelimen ja liitettävän järjestelmän väliin sijoittuva komponentti, joka sovittaa liitettävän järjestelmän tarjoamat palvelut X-Road-tiedonsiirtoprotokollan mukaiseen muotoon.

28

29

30 Extra: Harjoitus osa 6 Oman palvelun lisääminen ja tarjoaminen muiden käyttöön