Linkkipolku
Olet sivulla:: Etusivu / Yhteiset palvelut / Asiointitili / Tekninen rajapinta
Navigointi
Tekninen rajapinta
Tältä sivulta löydät asiointitilin teknisen rajapinnan kuvauksen ja siihen liittyvät materiaalit.
Tekniset infot
Palveluiden liittämisestä asiointitiliin järjestettiin kaksi teknistä infotilaisuutta 15.9.2010 ja 16.9.2010. Tilaisuuksissa käytiin läpi asiointitilin teknisiä vaatimuksia ja palveluiden liittämisprosessia.
- Asiointitilin yleisesittely ja liittymisen hallinnollinen puoli
- Integraatioarkkitehtuurin ja rajapintakuvausten esitys
Tekninen kuvaus
Alla on kuvattu asiointitilipalvelun julkiset rajapinnat.
- Asiointitilin integraatiodokumentti (versio 1.0.2)
Dokumentissa kuvataan, millaisia ja millä periaatteilla toimivia liityntöjä viranomaisjärjestelmiin tulee rakentaa, jotta ne voivat liittyä asiointitilipalvelun käyttäjiksi. Dokumentti päivitetty 28.9.2011.
- Asiointitilin rajapinnat (versio 1.0.2)
- Asiointitilin testaus- ja tuotantoympäristöjen kuvaus
Dokumentissa kuvataan Asiointitilin eri testausympäristöt sekä tuotantoympäristö. Päivitetty 2.1.2012.
- Asiointitilin testausohje v 1.0.2
Viranomainen suorittaa asiointitilin liittymistestauksen asiointitilin testiympäristöä vasten. Ohjeistusta testauksen tekemisestä ja tarvittavista testihenkilötunnuksista. Päivitetty 15.12..2011.
- Tunnetut järjestelmäkohtaiset ohjelmointiohjeet Asiointitilin liittymärajapintoihin
Dokumentissa kuvataan Asiointitilin liittymärajapintojen ohjelmoinnin järjestelmäkohtaiset ohjemointiohjeet. Päivitetty 1.11.2011.
- Järjestelmäkohtaiset ohjelmointiohjeiden config-tiedostot
Järjestelmäkohtaiset ohjelmointiohjeiden config-tiedostot zip-pakattuna tiedostona. Pura tiedosto omalle koneellesi. Päivitetty 19.10.2011.
Liittyminen valtion yhteisen integraatioalustan (VIA) kautta
Alla olevissa dokumenteissa on kuvattu lyhyesti ne tiedot ja toimenpiteet, jotka ovat välttämättömiä viranomaisjärjestelmille, jotta ne voivat ryhtyä käyttämään Asiointitiliä VIA:n tarjoamien palveluiden avulla.
- VIA:n Asiointitili-liittymien käyttöönotto
Ohje liittymien käyttäjille. Päivitetty 1.11.2011.
- Tarkistuslista VIA:n Asiointitili-liittymien käyttöönottoon
WSDL-dokumentit
Asiointitilipalvelun WSDL-kuvaukset.
Esimerkkisanomat: Viranomaispalvelut
Esimerkkisanomat: Viranomaispaluukanava
Vetuma-palvelu ja SAML 2.0 -rajapinta
Mikäli asiointitiliin liitetään tunnistamista vaativa sähköinen asiointipalvelun, palvelu voidaan liittää kertakirjautumisen luottamusverkostoon. Kertakirjautuminen mahdollistaa pääsyn asiointitiliin ja siihen liitettyihin palveluihin kertakirjautumisella. Kertakirjautumisen käyttö edellyttää Vetuma-palvelun 3.0 -version ja siinä olevan SAML 2.0 -rajapinnan käyttöönottoa asiointipalvelussa. Kertakirjautumisen tarjoaminen kansalaisille edellyttää sopimusta Valtiokonttorin kanssa.
Lisätietoja Vetuma-palvelusta ja SAML 2.0 -rajapinnasta löydät Vetuma-palvelun sivuilta.
