The following section contains an overview of the yunIO server settings in the Settings menu.
To save any changes made in the Settings menu, click [Save].

Note: All server setting changes require a yunIO service restart. All Swagger/OpenAPI definitions must be updated manually on server settings change by saving the service once more.

Server-Settings

Anonymous Access #

Anonymous Access is only available if users are defined, see Transport Layer Security.
If Anonymous Access is active, anyone can access the Designer. If this option is deactivated, only defined users have access.

Transport Layer Security #

Transport Layer Security (TLS) protocol allows the user to communicate with the respective service in a secure way by encrypting the communication with that service (HTTPS). This requires the installation of an X.509 certificate. For more information on TLS, see Microsoft: Transport Layer Security Protocol.

Pick Certificate

Click [Pick Certificate] and select an X.509 certificate from the list of available certificates.
If the certificate is not listed in the menu or in the Windows certificate store, install the X.509 certificate.

Note: Depending on whether yunIO is hosted on a local server or a cloud environment, the procedure for certificate creation differs. Please refer to the documentation available on the internet or contact your network administrators.

TLS enabled

Once a certificate is selected, the option TLS enabled is available.
Enable or disable the usage of transport encryption for the web server.

Note: To access the Designer via TLS, restart the yunIO server and connect to the Designer using the following URL pattern: https://[host]:[port]. If you cannot access the designer. because of problems with the TLS certificate, delete the tls.json file in the installation directory of yunIO e.g., C:\Program Files\Theobald Software\yunIO\config\servers\tls.json. Restart the yunIO server.

Allowed Origins (CORS) #

Warning! Cross-Origin Request Blocked When encountering a CORS error, the URL of your origin is not authorized to send requests to yunIO. Add the URL of your origin to the list of allowed origins.

Enter URLs that are allowed to run cross-origin requests on yunIO.
Example: To allow a tool like Swagger Inspector to load and execute a yunIO service, the URL https://inspector.swagger.io must be added to the list of allowed origins.

Note: For testing purposes you can use ( * ) to allow all URLs. When first installing yunIO this is set by default.

Services, Designer and WebSockets #

Define the ports for service consumption, Designer access and WebSocket configurations. Valid port numbers range from 1-65535. It is not recommended to use ports below 1000, because they are often already taken and using them with different services can lead to service disruptions.

Default Ports
Service Name Http Https Description
Services 8075 8175 This port is used by the web server, which handles the requests to invoke a service.
Designer 8077 8177 This port is used to open the yunIO Designer on a client machine.
WebSockets 8076 8176 This port is used by the yunIO Designer to read and write configurations, services, etc.