Certificate service's stakeholder testing
Organisations using the Incomes Register's technical interfaces are identified by using the Incomes Register's certificate service. The solution is based on digital certificates (Public Key Infrastructure).
All organisations providing data to and retrieving data from the Incomes Register via the technical interface use the certificate service. A certificate is issued to an organisation that is responsible for submitting data to the Incomes Register, or that has the right to receive data from the Incomes Register. The certificate is used to identify the organisation providing or using the data and to ensure the integrity of the records. Certificates are issued in accordance with the purpose of use.
Read more about the documentation on testing certificates
The Incomes Register's technical interface and certificate can be tested before deployment. The testing takes place in the Incomes Register's stakeholder testing environment.
Read more about stakeholder testing
Address of the certificate service's stakeholder testing environment: https://pkiws-testi.vero.fi/2017/10/CertificateServices
Once an organisation has agreed on the testing of the technical interface with the Incomes Register, certificate retrieval and its processing in the Incomes Register's stakeholder testing environment can begin.
Certificate-specific CA packages for stakeholder testing:
Packages include
- a simple README in English
- root certificate
- intermediate level certificate
- publisher certificate
- Services of the Incomes Register and the Finnish Tax Administration: IRServicesTestIssuingCAv1-chain.cacert.zip
- Support services outside the Incomes Register: IRExternalDataProvidersTestIssuingCAv1-chain.cacert.zip
- Support services outside the Incomes Register SFTP: IRExternalDataProvidersSFTPTestIssuingCAv1-chain.cacert.zip
- Data users SFTP: IRIncomeDataUsersSFTPTestIssuingCAv1.cacert.zip
- Data users: IRIncomeDataUsersTestIssuingCAv1-chain.cacert.zip
- Providers of earnings payment data: DataProvidersTestIssuingCAv1-chain.cacert.zip
- Providers of earnings payment data SFTP: DataProvidersSFTPTestIssuingCAv1-chain.cacert.zip
- Providers of benefits payment data: IRBenefitDataProvidersTestIssuingCAv1-chain.cacert.zip (27.3.2019)
- Providers of benefits payment data SFTP: IRBenefitDataProvidersSFTPTestIssuingCAv1-chain.cacert.zip (27.3.2019)
Certificate service test bench
The purpose of the certificate service test bench is to facilitate the development of the application that uses the certificate service interface. The test bench allows the testing of certificate requests, certificate retrieval, and certificate renewal.
- Certificate Service - Test Bench (pdf) 18 September 2020, version 1.02
- Certificate Service - Test Bench - (ZIP) 30 April 2018