> 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-datatrans/configurator/web-server.md).

# Web Server

Die Zertifikatsverwaltung erlaubt das Erstellen von Zertifikaten oder Verwenden bereits bestehender Zertifikate.

## Einstellungen

Ein Zertifikat wird benötigt, sobald er JUNE5.DataTrans.WebApi-Server eine verschlüsselte HTTPS Verbindung anbieten soll. Aus Sicherheitsgründen wird eine Verwendung der HTTPS mit einer SSL-Verschlüsselung empfohlen. Für eine einfache HTTP-Verbindung wird kein Zertifikat benötigt, dass somit aber ein Sicherheitsrisiko mit sich bringt.

| Konfigurationen | Beschreibung                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------- |
| Modus           | Bestimmt über De-/ Aktivierung des HTTP/HTTPS-Protokolls. Der Server ist nur unter den jeweiligen Modus erreichbar. |
| HTTP-Port       | Port über den der Webserver per HTTP aufgerufen werden kann                                                         |
| HTTPS-Port      | Port über den der Webserver per HTTPS aufgerufen werden kann                                                        |
| Zertifikat      | SSL-Zertifikat für den HTTPS-Betrieb                                                                                |

## Passwortverschlüsselung

Für die Verschlüsselung der Passwörter wird ebenfalls ein Zertifikat verwenden. Wird das Zertifikat geändert, werden bereits eingetragene Passwörter neu Verschlüsselt, sodass der Anwender keinen weiteren Schritt vornehmen muss. Die Verschlüsselung betrifft die Datenbank in der die Konfiguration der Entitäten vorliegen und der Anmeldeinformation der Dienst angewendet.

#### Selbstsigniertes Zertifikat erstellen:

Nach dem betätigen der Schaltfläche öffnet sich ein Dialog. Der Dialog ermöglicht einen Namen, sowie ein Ablaufdatum für das Zertifikat zu wählen.\
Durch "OK" wird das das gewünschte Zertifikat erstellt.

Lokales Zertifikat auswählen:\
Es wird der "Windows-Sicherheit"-Dialog geöffnet, der es ermöglicht, bereits installierte Zertifikate auszuwählen und für den Betrieb des JUNE5.DataTrans.WebApi-Servers zu verwenden.

#### Anwenden:

Erst durch das "Anwenden" wird das Zertifikat den Programm zugewiesen und die notwendigen Aktionen gestartet. Nach dem erfolgreichen Anwenden des Zertifikates müssen alle Dienste neugestartet werden.

## Erreichbarkeit im Netzwerk

Der JUNE5.DataTrans-Server ist im Netzwerk erreichbar unter den in der Tabelle beschriebenen URLs.

| Protokoll | URL                                                 |
| --------- | --------------------------------------------------- |
| HTTP      | http:\\\\{IP oder Domain des Servers}:{HTTP-Port}   |
| HTTPS     | https:\\\\{IP oder Domain des Servers}:{HTTPs-Port} |

{% hint style="info" %}
Empfohlen wird ein Zertifikat von einer offiziellen Zertifizierungsstelle zu erwerben.
{% endhint %}


---

# 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-datatrans/configurator/web-server.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.