Server Settings
This section contains an overview of the yunIO server settings in the Settings menu. Any changes made in this menu only take effect after clicking [Save] and restarting the yunIO Windows service.
Services Endpoint
Service URL Kind
The Service URL Kind defines the URL that is used to connect to yunIO services.
| Service URL Kind | Description |
|---|---|
| Default | If TLS is active, the first Subject Alternative Name provided by the X.509 certificate is used as the hostname, see Transport Layer Security. |
| Custom | Allows you to enter a custom hostname. Enter the hostname in the field Custom Hostname and click [Save] to update the OpenAPI definitions of all existing services. |
| Azure Relay Hybrid Connection | When an Azure Relay Hybrid Connection is set up, yunIO services use an Azure Relay address to become accessible to applications running in the Azure cloud. For more information on Azure Relay, see Establish an Azure Relay Hybrid Connection to yunIO. |
Note
Wildcard certificates are supported. Enter the hostname of the certificate as a custom endpoint.
Tip
To set up multiple endpoints, use multiple yunIO servers, one for each endpoint.
OpenAPI Target Kind
The OpenAPI Target Kind defines properties that can be added to the Swagger/OpenAPI json file of yunIO services.
| OpenAPI Target Kind | Description |
|---|---|
| Default | If this option is active, the Swagger/OpenAPI json file contains no additional properties. |
| Nintex Gateway | Select this option when integrating yunIO services with the Nintex Gateway. Nintex properties are added to into Swagger/OpenAPI json file and there is no need to manually change the swagger definition. For more information, see Integrate a yunIO Service via Nintex Gateway. |
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 about the X.509 certificate setup, see Install an X.509 Certificate.
Note
Depending on whether yunIO is hosted on a local server or a cloud environment, the procedure for certificate creation differs. Refer to the documentation available on the internet or contact your network administrators.
For more information on TLS, see Microsoft: Transport Layer Security Protocol.
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.
Services, Designer and WebSockets
In the subsections Services, Designer and WebSockets the ports for service consumption, Designer access and WebSocket configurations are defined.
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. |
Usage Data
To improve yunIO and better cater to customer needs, yunIO collects usage data, e.g., the components that are in use, referenced SAP objects, statistics about data extractions, etc. For more information, refer to our privacy policy.
Collect Usage Data
When this checkbox is active, usage data is stored in your local installation directory. If this checkbox is deactivated, no usage data is collected.
Upload Usage Data
When this checkbox is active, usage data is sent to Theobald Software for analysis. An internet connection is required to use this option.
Transfer SAP Object Names
When this checkbox is active, the names of the SAP objects used in extractions are included in the usage data upload.