Varmennepalvelu

Tulorekisteri otetaan käyttöön 1.1.2019.

Varmennepalvelu

Tulorekisterin teknisiä rajapintoja käyttävät organisaatiot tunnistetaan käyttämällä tulorekisterin varmennepalvelua. Ratkaisu pohjautuu digitaalisiin varmenteisiin (Public Key Infrastructure).

Varmennepalvelua hyödyntävät kaikki tulorekisteriin aineistoja tuottavat ja sieltä aineistoja noutavat organisaatiot. Varmenne myönnetään organisaatiolle, joka vastaa tietojen toimittamisesta tulorekisteriin tai jolla on oikeus saada tietoja tulorekisteristä. Tulorekisterin varmennepalvelu myöntää varmenteet. Varmenteella tunnistetaan tietoja tuottava tai käyttävä organisaatio sekä varmistetaan aineiston muuttumattomuus. Varmenteet myönnetään käyttötarkoituksen mukaan.

Kun organisaatio on sopinut tulorekisterin kanssa teknisen rajapinnan käyttämisestä voi varmenteen haku ja käsittely alkaa.

  1. Varmennepalvelu – Yleiskuvaus (15.12.2017, versio 1.01)
    • Dokumentti on yleisesitys tulorekisterin varmennepalvelusta.
  2. Varmennepalvelu – Rajapintakuvaus (15.12.2017, versio 1.01)
    • Dokumentissa kuvataan varmennepalvelun Web Service -rajapinnan toteutus järjestelmäintegraation toteuttajan näkökulmasta. 
  3.  Varmennepalvelun tekninen rajapinta – ZIP – Sovelluskehittäjille (15.12.2017, versio 1.01)
    • Palveluiden WSDL-kuvaus ja tietosisällöt XML-skeema -muodossa.

Sidosryhmätestauksen varmennekohtaiset CA-paketit (9.4.2018):

Paketeissa

  • yksinkertainen README englanniksi
  • juurivarmenne
  • välitason varmenne
  • julkaisijan varmenne
  1. Tulorekisterin ja Verohallinnon palvelut: IRServicesTestIssuingCAv1-chain.cacert.zip
  2. Tulorekisterin ulkopuoliset tukipalvelut: IRExternalDataProvidersTestIssuingCAv1-chain.cacert.zip

  3. Tulorekisterin ulkopuoliset tukipalvelut SFTP: IRExternalDataProvidersSFTPTestIssuingCAv1-chain.cacert.zip

  4. Tiedon käyttäjät SFTP: IRIncomeDataUsersSFTPTestIssuingCAv1.cacert.zip

  5. Tiedon käyttäjät: IRIncomeDataUsersTestIssuingCAv1-chain.cacert.zip

  6. Tiedon tuottajat: DataProvidersTestIssuingCAv1-chain.cacert.zip

  7. Tiedon tuottajat SFTP: DataProvidersSFTPTestIssuingCAv1-chain.cacert.zip

Varmennepalvelun testipenkki 

Varmennepalvelun testipenkin tarkoitus on edesauttaa varmennepalvelun rajapintaa käyttävän sovelluksen kehittämistä. Testipenkissä on mahdollista testata varmennepyyntöä, noutoa ja uusimista.

  1. Varmennepalvelu - testipenkki (pdf, 30.4.2018)
  2. Varmennepalvelu - testipenkki - zip (30.4.2018)