Familiarise and plan
Deployment
The deployment of the Data Exchange Layer is divided into administrative and technical deployment, and the instructions for those can be found on their own pages. Please note that the planning for the deployment must be done in close cooperation with all the persons and entities participating in the deployment process.
This section contains an overview of the deployment process, showing both the administrative and technical deployment phases. The deployment process of the Data Exchange Layer usually takes about 1–3 months, but the duration of the process can also be shorter. Therefore, familiarise yourself with the specific cases before starting the deployment.
Please note, that your organisation must first join the test environment of the Data Exchange Layer and after that you can proceed to the production environment. If you wish, you can also test the operation of the Data Exchange Layer in the separate development environment.
In the API CatalogueOpens in a new window., you can check if your organisation already uses the Data Exchange Layer. If the Data Exchange Layer is already in use, read instructions how to deploy a single service.
Deployment process of the Data Exchange Layer
Administrative planning
Technical design
Familiarise and plan
- Familiarise yourself with the necessary technical starting points
- Get to know the Data Exchange Layer’s different environments
- Agree on contact persons
- Determine the most appropriate Security Server solution
- Plan the technical starting point of your services: SOAP or REST
- Plan the possible adapter service
Select your Security Server solution for the Data Exchange Layer
Select the most appropriate Security Server solution with your technical implementer
Your options are:
- Your own Security Server
- A shared Security Server
- An outsourced Security Server
Read more about selecting the security server solution.
If you intend to implement your own Security Server, remember to make the necessary technical preparations to your Hosting Server
Apply for an access permit to the Data Exchange Layer’s test environment
The Digital and Population Data Services Agency grants access to the test environment
The Digital and Population Data Services Agency grants your organisation access to the Data Exchange Layer’s test environment and sends the installation instructions to your technical contact person.
Join the Data Exchange Layer’s test environment
Once your access permit application has been approved, your organisation can begin the technical process for joining the test environment. Follow the instructions you receive:
- Open your firewalls
- Install the Security Server Software
- Configure your Security Server
- Add a subsystem
- Connect the service client to the security server
- If you have any services, add them to the Security Server
- Enable the Adapter Service, if necessary
Read more about joining the test environment.
Describe your services in the Test API Catalogue
Describe your organisation and the services you provide in the Data Exchange Layer’s Test API CatalogueOpens in a new window..
Conduct technical tests in the Data Exchange Layer’s test environment
Once your organisation has successfully joined the test environment, test your connection to the Data Exchange Layer:
- Test your connection to the Data Exchange Layer
- Test thread functionality
- Test messaging with meta aervices
- Fix any errors detected during the testing process
Read more about testing.
Apply for an access permit to the Data Exchange Layer’s production environment
Once you have completed your tests in the test environment and fixed the errors you detected, you can proceed to the production environment.
The Digital and Population Data Services Agency grants access to the production environment
The Digital and Population Data Services Agency grants your organisation access to the Data Exchange Layer’s production environment and sends the installation instructions to your technical contact person.
Initiate your technical transfer to the Data Exchange Layer’s production environment
Once the access permit to the production environment has been granted, repeat the same technical procedures as when you joined the test environment.
Read more about joining the production environment.
Describe your services in the API Catalogue
Describe your organisation and the services you provide in the Data Exchange Layer’s API CatalogueOpens in a new window..
The deployment process is now complete
Updated: 24/9/2025