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:

Playground Status

The hourly updated status of the Playground’s Security Servers can be viewed at http://status.playground.x-road.global. It is possible to view the status of last 7 days of a selected Security Server by clicking the Security Server name on the list.

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.