X-Road v6.24 Release Notes: Appendix 1 - New Security Server API and UI

This release introduces a new web-based user interface, built with Vuejs and Vuetify as well as a REST API backend built on Spring Boot.

In total 102 use-cases were re-implemented in the new UI as well as introducing additional authentication and validation functionality to support the new REST API.

More information about the REST API can be found in the Security Server User Guide.

The full OpenAPI 3 description of the API is available here.

Below is a table containing the use-cases that were implemented as part of this work:

TaskUse caseImplementation
1Log In to the Graphical User Interface
2Log Out of the Graphical User Interface
3View Security Server Clients
4View the Details of a Security Server Member
5View Certificate
6View the Internal Server Settings of a Security Server Member
7Change a Security Server Member's Internal Connection Type
8Add a Security Server Member's Internal TLS Certificate
9Delete a Security Server Member's Internal TLS Certificate
10View a Security Server Member's Internal TLS Certificate Details
11Export the Internal Certificate of the Security Server
12View the Details of a Security Server Client
13View Certificate
14View the Service Clients of a Security Server Clients
15View the Access Rights of a Service Client
16Add a Service Client to a Security Server Client
17Add Access Rights for a Service Client
18Remove Access Rights from a Service Client
19View the Services of a Security Server Client
20View the WSDLs of a Security Server Client
21Add a WSDL to a Security Server Client
22Edit the Address of a WSDL
23Enable a WSDL
24Disable a WSDL
25Refresh a WSDL
26Delete a WSDL
27View the Access Rights of a Service
28Add Access Rights to a Service
29Remove Access Rights from a Service
30Edit the Address of a Service
31Set the Option to Verify TLS Certificate of a Service
32Edit the Timeout Value of a Service
33Apply a Parameter Value of a Service to All the Services in the WSDL
34View the Internal Server Settings of a Security Server Client
35Change a Security Server Client's Internal Connection Type
36Add a Security Server Client's Internal TLS Certificate
37Delete a Security Server Client's Internal TLS Certificate
38View a Security Server Client's Internal TLS Certificate Details
39Export the Internal Certificate of the Security Server
40View the Local Groups of a Security Server Client
41View the Details of a Local Group
42Add a Local Group for a Security Server Client
43Add Members to a Local Group
44Remove Members from a Local Group
45Edit the Description of a Local Group
46Delete a Local Group
47

Add a Client to the Security Server

48

Register a Security Server Client

49Unregister a Security Server Client
50Delete a Security Server Client
51Log a User Out of the Graphical User Interface
52View the List of Tokens, Keys and Certificates
53Log in to a Software Token
54Log Out of a Software Token
55Log in to a Hardware Token
56Log Out of a Hardware Token
57View the Details of a Token
58View the Details of a Key
59Edit the Friendly Name of a Token
60Edit the Friendly Name of a Key
61Generate a Key
62Generate a Certificate Signing Request for a Key
63Import a Certificate from a Local File System
64Import a Certificate from a Security Token
65Activate a Certificate
66Disable a Certificate
67Register an Authentication Certificate
68Delete a Key from the System Configuration
69Delete a Key from a Software Token
70Delete a Key from a Hardware Token
71Unregister an Authentication Certificate
72Delete a Certificate or a Certificate Signing Request from the System Configuration
73Delete a Certificate from Hardware Token
74View the Installed Software Version
75View Timestamping Services
76Add a Timestamping Service
77Delete a Timestamping Service
78View the Details of the Internal TLS Certificate
79View the Internal TLS Certificate of the Security Server
80Generate a New Key and Internal TLS Certificate for the Security Server
81Export the Internal TLS Certificate of the Security Server
82View the List of Configuration Backup Files
83Backup Configuration
84Restore Configuration from a Backup File
85Download a Backup File
86Delete a Backup File
87Upload a Backup File
88View the Configuration Anchor Information
89Download the Configuration Anchor File
90Upload a Configuration Anchor File
91Update Configuration
92View the List of Approved Certificate Authorities
93View the Diagnostics Information
94View the Feedback Information
95Add the Initial Configuration for a new Security Server.
96Create a new API key
97Edit an API key
98List API keys
99Revoke an API key
100Call a REST API
101Import the Internal TLS Certificate of the Security Server
102

Generate a new CSR for the TLS key of the Security Server