Publishing a service

You publish services and give access in the X-Road admin UI of your security server.

Before you start

Your service must have a public address. It must listen on TCP port 80 or 443.

Private addresses and other ports do not work.

Open the admin UI

1. Open your server in securityserver.io.
2. Select Open admin UI.
3. Log in as xroad-admin with the admin password from the server page.

Add a service description

1. Select Clients, then your subsystem.
2. Select the Services tab.
3. Add the description:
   • REST or OpenAPI 3: select Add REST. Select the URL type. Enter the URL and a service code.
   • SOAP: select Add WSDL. Enter the URL of the WSDL.
4. Turn on the switch next to the new description. A new description is off.

Set the address and timeout

1. Open the service.
2. Enter the Service URL of your backend.
3. Enter the Timeout in seconds.
4. Select Verify TLS certificate only if your backend uses HTTPS and you added its certificate to the security server.
5. Select Save.

Give access

1. Open the service.
2. Select the Service Clients tab, then Add Subjects.
3. Find the organisation. You can pick a subsystem, a member or a global group.
4. Select it, then Add Selected.

Remove access

1. Open the service.
2. Select the Service Clients tab.
3. Select Remove next to the organisation.

When you delete a service description, its access rights are removed too.

Next

Admin UI and access