> For the complete documentation index, see [llms.txt](https://docs.videc.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videc.de/june5-3.7/en/konfigurator/webserver.md).

# Web Server

The JUNE5 server is a service with an HTTP interface that can provide its functions both encrypted and unencrypted in the network (HTTP/HTTPS). The API functions are only callable after authentication. For this purpose, a token-based security concept has been implemented, which is based on the OAuth standard.

The JUNE5 server provides its interface and web pages to the network. It is the web server that JUNE5 works with. A connection for testing purposes with an already configured JUNE5 server is available at <http://portal.videc.info>. Username and password are *admin*.

## Configuring the Web Server

In the JUNE5 Configurator under the Web Server tab, the following settings are possible:

* Enabling and disabling the HTTP/HTTPS protocol
* Setting the HTTP/HTTPS port
* Use of the SSL certificate
* Adjustment of the Token certificate
* Creation of the Data Source Encryption certificate
* Setting the Token lifetime
* Setting the Cache Item lifetime

### Cache Item Lifetime

This value refers to the objects (users, permissions, Named Access, etc.) of user management in the application cache. Normally not to be adjusted.

### Accessibility in the Network

The JUNE5 server is accessible in the network by default via the URLs described in the table.

| Protocol | Url                                          |
| -------- | -------------------------------------------- |
| HTTP     | http\://{IP or Domain of the Server}:20000/  |
| HTTPS    | https\://{IP or Domain of the Server}:20001/ |

In principle, the address of the JUNE5 server can be determined as follows:

| • | {Protocol (http/https)}://{IP or Domain of the Server}:{configured Port (http-Port/HTTPS-Port)}/ |
| - | ------------------------------------------------------------------------------------------------ |

{% hint style="info" %}
To ensure secure communication, it is recommended to operate the application via the secure HTTPS protocol.
{% endhint %}

## Authentication and Security

The security concept is based on the OAuth standard. Retrieving data is only possible with a security token, which is issued by the JUNE5 server after successful user authentication. The JUNE5 server checks the token for validity with each request. A token has a preset lifetime of 15 minutes. If the token is not used for communication with the server for longer than its lifetime, it becomes invalid. This then requires a new token request from the server with user authentication. The figure below shows the sequence diagram of an HTTP request without authentication on the left and the sequence diagram of an HTTP request with prior authentication on the right.

![](/files/LzT7bVh0SVwfGWGjYMCQ)

## HTTPS and SSL

For secure communication between server and client (web browser), the HTTPS protocol can be used. The data is sent through an encrypted communication channel. The encryption is performed by an SSL certificate, which can be selected or generated in the JUNE5 Configurator. It is recommended to purchase a certificate from an official certification authority. In the JUNE5 Configurator, an SSL certificate can be selected or created. This is done via the *SSL Configuration* button.

Under the *Select from Store* button, a certificate can be selected from the certificate store. The certificate store is located in the Windows tool "Manage Computer Certificates" under "Local Computer/Personal Certificates". It is recommended to obtain a certificate from an official certification authority and integrate it via the Configurator.

Furthermore, under the *Create Self-Signed Certificate* button, an SSL certificate for Intranet SSL use can be generated. For this, the Intranet IP address or domain name of the host computer must be entered in the certificate name.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.videc.de/june5-3.7/en/konfigurator/webserver.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
