4.3 Descriptions of services and how to find them

4.3.1 Finding/obtaining WSDL descriptions of services from security server

Service descriptions are located in WSDL files, which in turn are located in the security server of the authority providing the relevant service. The procedure for obtaining these WSDL descriptions of services is described below.

Downloading WSDL description. Service clients can download WSDL files of the service by submitting a HTTP GET request to the security server of the client. URI is either http://SECURITYSERVER/wsdl or https://SECURITYSERVER/wsdl. Instead of the word SECURITYSERVER, the actual address of the security server must be entered. The client must specify service identifiers by using the following parameters:

  • xRoadInstance– X-Road set (see 4.1.4.1. Explanations of elements of header fields);
  • memberClass – member class (see 4.1.4.1. Explanations of elements of header fields);
  • memberCode – X-Road member code (see 4.1.4.1. Explanations of elements of header fields);
  • subsystemCode (optional) – identification code of the subsystem of the member (see 4.1.4.1. Explanations of elements of header fields);
  • serviceCode – service code (see 4.1.4.1. Explanations of elements of header fields);
  • version (optional) – service version.

Example of a HTTP request:

http://10.239.255.100/wsdl?xRoadInstance=ee-dev&memberClass=COM&memberCode=11333578&subsystemCode=DEVTRAINING_10_A&serviceCode=personList&version=v1

WSDL descriptions for central services can be obtained in similar way. In such a case, the request parameters must be:

  • xRoadInstance – X-Road set (see 4.1.4.1. Explanations of elements of header fields);
  • serviceCode – service code (see 4.1.4.1. Explanations of elements of header fields).

4.3.2 Descriptions of services from RIHA

Services registered on X-Road must be described also in RIHA environment (the management system of the state information system) at the address: https://riha.eesti.ee/riha/main and meet precisely the descriptions of services used in security servers.

In order to find services in RIHA, select ‘State information system’ at the top, and then ‘Services’ in the left column. Service search is displayed. Service search enables the user to find services registered in RIHA.

First, service search is displayed partially open and only major filter fields are visible. A user can use also make a request with an expanded filter. In order to open hidden filter fields, the user must point the reference ‘open expanded search’ in the request window.

In order to submit a request, fill in the required filter fields and click the display button ‘Search’. If services corresponding to the entered filter were found, their list is displayed. A detailed description of how to find necessary information on RIHA page is provided in RIHA training materials https://moodle.ria.ee/course/view.php?id=3#section-9.

RIHA is currently being updated. Therefore, we recommend to watch for new guidelines.

Viimati muudetud: teisipäev, 16. mai 2017, 13:15