Varmennepalvelu

Hakemuksen teknisen rajapinnan käyttöönottamiseksi voi tehdä tulorekisterin sähköisessä asiointipalvelussa 1.11.–14.12. arkisin klo 9–15.

Huom.! Varmennetta ei voi hakea 15.12.2018–1.1.2019 käyttökatkosta johtuen.

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.

Teknisen rajapinnan käyttöönotto on jaettu kahteen vaiheeseen:

  1. Hakemus teknisen rajapinnan käyttöönottamiseksi ja varmennetilaus
  2. Varmenteen noutaminen

Tiedon tuottamiseen tarvittavien teknisten rajapintojen käyttöönotto edellyttää, että tehdään hakemus teknisen rajapinnan käyttöönottamiseksi tulorekisterin sähköisessä asiointipalvelussa. Hakijan pitää hyväksyä Verohallinnon ja tulorekisterin rajapintapalveluiden käyttöehdot. Hakemus käynnistää varmennetilauksen. Hakemuksessa nimetty varmenteen tekninen yhteyshenkilö saa ilmoitettuun sähköpostiosoitteeseen ja matkapuhelinnumeroon tiedot varmenteen noutamiseksi. Lue lisää varmenteesta. 

Tiedon käyttäjät tekevät hakemuksen teknisen rajapinnan käyttöönottamiseksi täyttämällä tulorekisterin tiedon käyttäjän ilmoituksen tietolupaa varten. Tietoluvan toimeenpano käynnistää varmennetilauksen.

Kun organisaatio on sopinut tulorekisteriyksikön kanssa teknisen rajapinnan käyttöönotosta, varmenteen noutaminen voi alkaa.

Varmennepalvelun Web Service -rajapinnan tuotanto-osoite:
https://pkiws.vero.fi/2017/10/CertificateServices (TCP portti 443)

Tuotantoympäristön varmennekohtaiset CA-paketit (1.11.2018):

HUOM! Tuotantoympäristön 1.11.2018 päivitetyt varmennekohtaiset CA-paketit tarvitaan varmenteen käyttöä varten. Nämä CA-paketit korvaavat 15.10.2018 julkaistut CA-paketit. Suosittelemme CA-pakettien päivittämistä uusiin hyvissä ajoin ennen tulorekisterin käyttöönottoa 1.1.2019.

Paketeissa

  • yksinkertainen README englanniksi
  • juurivarmenne
  • välitason varmenne
  • julkaisijan varmenne
  1. Tulorekisterin ja Verohallinnon palvelut: IRServicesIssuingCAv1-chain.cacert.zip
  2. Tulorekisterin ulkopuoliset tukipalvelut: IRExternalDataProvidersIssuingCAv1-chain.cacert.zip
  3. Tulorekisterin ulkopuoliset tukipalvelut SFTP: IRExternalDataProvidersSFTPIssuingCAv1-chain.cacert.zip

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

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

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

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

Tee hakemus teknisen rajapinnan käyttöön