Filling in the user permit application for Data Exchange Layer

Your organisation must complete and submit a user permit application before your organisation can join the Data Exchange Layer. You must fill in and send a separate user permit for the test and production environment.

Please note the following things before you submit a user permit application for the Data Exchange Layer:

1. The security server is named in compliance with the Data Exchange Layer instructions and the FQDN of the Security Server is in a public name service and your organisation owns the domain name. Read more about how to name a security server.
2. The security server has RHEL 8 or Ubuntu 24.04LTS operating system installed, or if using a containerised security server, a Linux platform with Docker installed.

You need the security server name (FQDN) and IPv4 address for the user permit application. You can obtain this information from the security server administrator. Please note that you will not be able to submit a user permit application until your organisation has a platform on which the security server software will be later installed. In practice, this means an RHEL or Ubuntu host server or a Linux platform with Docker software installed.

How to fill in the user permit application

Start by applying for a user permit to the test environment. When you are ready to transfer your service to production, apply for a user permit to the production environment.

To fill in the application form, you need the following information:

• contact details of the administrative and technical persons in charge: name, email address (note that the email address should be general and static), as well as the organisation's name and Business ID if different from the organisation applying for the user permit
• information about the Security Server from the Security Server's administrator
• the right to accept the terms and conditions of use of the Data Exchange Layer

1. Select Fill in an application for a user permitOpens in a new window..
2. Register as a Service Management user if you have not done so before. Start the registration by identifying yourself strongly. You need a Business ID to register. For more information about registering, see the Service Management instructions. The registration can be performed by anyone from your organisation.
3. Fill in the user permit application for the environment of your choice. Some of the information has been pre-filled based on the information on the customer account in Service Management. Verify that the information is correct and, if necessary, edit it.

The form is divided into four sections. Select Mark complete to mark sections completed. If necessary, you can invite other persons to fill in the licence application, for example a technical contact person to complete the Security Server information.

When all sections are marked as complete, select Submit Application. See the list below for help filling out the form.

• First select whether you are applying for a permit for a test environment (FI-TEST) or production (FI). The application for a user permit is similar for both environments.

Picture: Select either Test environment or Production environment as environment type

Show larger picture

• Intended purpose of the service: If your organisation provides information through the Data Exchange Layer, select Service Provider. If your organisation plans only to use information others provide, select Data retrieval. If your organisation acts as both a service provider and a consumer, select Service Provider. The role is not binding and you can change it later without notice.

Picture: Select either Service provider or Data retrieval as the intended purpose of the service

Show larger picture

• Security Server details: Select I will join the security server of an external party if you are joining an existing Security Server in another organisation or a Security Server provided by an external service provider.

Picture: For Security Server details you can select 'I'm setting up a new security server.', 'I'm using my own existing security server.' or 'I'm joining a security server of an external party.'

Show larger picture

• FQDN Name: The server must be correctly named to accept the user permit application. The name must contain the name or official abbreviation of your organisation, and it must be written entirely in lowercase letters. The name must also be added in the public domain service (Whois-service) before you can join Data Exchange Layer. Read more on how to name a security server.

Picture: Enter the server FQDN and IPv4 address. Multiple addresses allowed.

Show larger picture

• Public IPv4 address: The public IP address of the Host server. The IP address must be static, i.e. it must not change. Please note! If there are different IP addresses for incoming and outgoing traffic, enter both under Public IPv4 address.
• API Catalogue administrator's details: The API Catalogue administrator is responsible for describing the services connected to the Data Exchange Layer in the API CatalogueOpens in a new window..
• Accept the terms and conditions: Once all other sections have been marked as complete, accept the Suomi.fi services user permit and the Terms and conditions of use of the Data Exchange Layer (terms and conditions available in pdf-format below). Please note that you must have a permission to accept the Terms of Use in your organisation. If necessary, ask another person to accept the terms and conditions.

Suomi.fi Data Exchange Layer Terms and Conditions of Use (PDF, 473.41 kB)Opens in a new window.

The processing of a user permit application usually takes a few days. Once the application has been processed, you will receive installation instructions for joining the test/production environment from palveluvayla@palveluvayla.fiOpens in a new window.. If the form contains errors or problems, the Data Exchange Layer administrators may ask you to make changes to the Security Server.

Invite other persons to fill in the user permit application

You can invite members of other organisations to fill in your organisation’s user permit application by sending an email invitation. For example, this allows a technical operator to complete the Security Server information. To do this, you need administrator privileges.

1. Make sure that a member of the organisation has registered for Suomi.fi Service Management. If necessary, ask the user to register.
2. Invite the user to join your organisation following Service Management's instructions.
3. Once the user has registered, give the invited user the access rights to the Suomi.fi Data Exchange Layer. Read more about user management in Service Management's instructions.

After this, the invited user can also fill in your organisation’s user permit application.