X-Road Playground is a pre-configured X-Road environment for trying out X-Road and it is publicly accessible to any individual and organization for free of charge. X-Road Playground provides an easy way to look into X-Road, access Security Server UIs and try out consuming and producing services.
About the Playground
X-Road Playground is a fully functional X-Road environment that consists of:
Central Server (CS)
Security Servers (SS) x3
Test services (IS)
Trust services (CA, OCSP, TSA)
There are three registered member organisations in the environment:
NIIS - X-Road operator
Test company - service consumer
Test agency - service provider
Each organization is an owner of one Security Server in the environment.
Accessing Security Servers
The three Security Servers in the environment have different roles: Central Server's Security Server (1), service consumer's Security Server (2) and service provider's Security Server (3). NIIS is the owner of Security Server #1, Test company is the owner of Security Server #2 and Test agency the owner of Security Server #3. The test services are published on Security Server #3 and they can be consumed via Security Server #2.
Central Server's Security Server:
Service consumer's Security Server:
Service provider's Security Server:
Username for the UI is "xrd" and password is "secret". When logging in for the first time there’s a warning message, because the self-signed certificate of the Security Server UI needs to be accepted.
N.B.! The credentials are read-only - it is not possible update Security Servers' configuration.
Trying Out Test Services
The test services are published on Security Server #3 and they can be consumed via Security Server #2. There are two test services available: getRandom and helloService. GetRandom does not take any parameters and it returns a random number between 1 and 100 (example request). HelloService takes a name as a parameter and returns a greeting with the given name (example request). The test services can be invoked through Security Server's #2 SOAP interface at:
The test services can be invoked in multiple ways, e.g. command line using curl, Firefox RESTClient addon. Requests must be submitted using HTTP POST method and content-type must be "text/xml". The examples below illustrate how the test services and listMethods meta service can be invoked using curl.
curl -d @getRandom.xml --header "Content-Type: text/xml" -X POST http://testcomss01.playground.x-road.global curl -d @helloService.xml --header "Content-Type: text/xml" -X POST http://testcomss01.playground.x-road.global curl -d @listMethods.xml --header "Content-Type: text/xml" -X POST http://testcomss01.playground.x-road.global
Example requests can be downloaded at:
Feedback and Questions
Please note that NIIS does not provide any support or training regarding the Playground. Please consult the X-Road documentation in case of questions. More information about the resources is available in the resources section.