X-Road Playground

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.

Image 1. X-Road Playground

Image 1. X-Road Playground

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.

  1. Central Server's Security Server:

  2. Service consumer's Security Server:

  3. 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:

http://testcomss01.playground.x-road.global

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.

Feedback and enhancement ideas regarding the Playground can be submitted to the X-Road Service Desk. Sign up for an account and get access to the X-Road Service Desk and X-Road Backlog.