DVV

Suomi.fi e-Authorizations

Subsystem information

Service bus identifier

FI.GOV.0245437-2.RolesAuthsService

Description

What does the e-Authorizations service offer?

Suomi.fi e-Authorizations is a service that enables an organisation to verify the mandates of a person or a company to act online on behalf of another person or a company they represent.

When verifying the mandates, the organisation's e-service enquiries the e-Authorizations service in order to determine whether the party is entitled to act on behalf of another party. The e-Authorizations service retrieves the data from the basic data registers and/or the authorisation register and returns the response in real time to the e-service.

For more information about Suomi.fi e-Authorizations, visit Suomi.fi Service Management at: https://palveluhallinta.suomi.fi/fi/sivut/valtuudet/esittely

Service levels

Suomi.fi e-Authorizations is available for end users and customer organisations 24/7/365 without disruptions. New organisations can be connected to Suomi.fi e-Authorizations without it causing any harm to the customer organisations that have joined earlier.

The Digital and Population Data Services Agency is responsible for providing a scalable service solution in which increasing volumes do not affect the availability of the service. The service is available in Finnish, Swedish and English.

Interfaces

  • The Authorization interface is used to check whether the agent has the right to manage a specific matter on behalf of the principal.
  • The AuthorizationList interface is used to check which matters the agent has the right to act on behalf of the principal.
  • The OrganizationalMandates interface is used to check whether the company has the right to act on behalf of another company and in what types of matters.
  • The OrganizationalRoles interface is used to check whether a person has the right to act on behalf of a company and what kind of role they have in relation to the company.

What do I need to deploy the e-Authorizations service?

Before using the e-Authorizations service, the organisation must have a strong identification service in use.

Public administration and private sector actors can connect to and use the e-Authorizations service free of charge. However, the customer organisation will bear all costs resulting from the implementation of the service.

How can you start using the e-Authorizations service?

Deploying the Suomi.fi e-Authorizations service requires that you connect to the e-Authorizations service interface. The connection can be made either via the Suomi.fi Data Exchange Layer (Security Server interface) or the public Internet (Web API).

The most suitable connection method for the e-service is selected on the basis of use cases. The customer organisation builds an interface in its information system in order to send a mandate check query and receive a response message.

To agree on the deployment, please contact Suomi.fi customer service: organisaatiopalvelut@dvv.fi

For more information on the deployment of the service, see Suomi.fi Service Management at: https://palveluhallinta.suomi.fi/fi/sivut/valtuudet/kayttoonotto/vaiheet

Services

Additional Info

Field Value
Description

What does the e-Authorizations service offer?

Suomi.fi e-Authorizations is a service that enables an organisation to verify the mandates of a person or a company to act online on behalf of another person or a company they represent.

When verifying the mandates, the organisation's e-service enquiries the e-Authorizations service in order to determine whether the party is entitled to act on behalf of another party. The e-Authorizations service retrieves the data from the basic data registers and/or the authorisation register and returns the response in real time to the e-service.

For more information about Suomi.fi e-Authorizations, visit Suomi.fi Service Management at: https://palveluhallinta.suomi.fi/fi/sivut/valtuudet/esittely

Service levels

Suomi.fi e-Authorizations is available for end users and customer organisations 24/7/365 without disruptions. New organisations can be connected to Suomi.fi e-Authorizations without it causing any harm to the customer organisations that have joined earlier.

The Digital and Population Data Services Agency is responsible for providing a scalable service solution in which increasing volumes do not affect the availability of the service. The service is available in Finnish, Swedish and English.

Interfaces

  • The Authorization interface is used to check whether the agent has the right to manage a specific matter on behalf of the principal.
  • The AuthorizationList interface is used to check which matters the agent has the right to act on behalf of the principal.
  • The OrganizationalMandates interface is used to check whether the company has the right to act on behalf of another company and in what types of matters.
  • The OrganizationalRoles interface is used to check whether a person has the right to act on behalf of a company and what kind of role they have in relation to the company.

What do I need to deploy the e-Authorizations service?

Before using the e-Authorizations service, the organisation must have a strong identification service in use.

Public administration and private sector actors can connect to and use the e-Authorizations service free of charge. However, the customer organisation will bear all costs resulting from the implementation of the service.

How can you start using the e-Authorizations service?

Deploying the Suomi.fi e-Authorizations service requires that you connect to the e-Authorizations service interface. The connection can be made either via the Suomi.fi Data Exchange Layer (Security Server interface) or the public Internet (Web API).

The most suitable connection method for the e-service is selected on the basis of use cases. The customer organisation builds an interface in its information system in order to send a mandate check query and receive a response message.

To agree on the deployment, please contact Suomi.fi customer service: organisaatiopalvelut@dvv.fi

For more information on the deployment of the service, see Suomi.fi Service Management at: https://palveluhallinta.suomi.fi/fi/sivut/valtuudet/kayttoonotto/vaiheet

Keywords
Maintainer Digi- ja väestötietovirasto
Maintainer Email organisaatiopalvelut@dvv.fi
Maintainer phone number
Visibility
Allowed Organizations
Valid since
Valid until
Data Exchange Layer environment (X-Road instance) FI
Organisation type (X-Road member class) GOV
Organisation code (Business ID, X-Road member code) 0245437-2
Organisation code (Business ID, X-Road member code) RolesAuthsService