Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- edpweb3:installation [23.01.2025 13:45] – [SSL Verschlüsselung] Pascal Niklaus
+++ edpweb3:installation [29.09.2026 19:02] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 1: / Zeile 1: @@
-===== edp:web =====
+====== Installation von edp:web ======
-=== Installation ===
+Diese Seite beschreibt die Installation von **edp:**web und die Grundeinrichtung danach. Dazu gehören die Konfiguration, die SSL-Verschlüsselung, die Lizenzdatei, die Benutzer sowie einige Sonderfälle im Betrieb.
-Mit der Ausführung des Setups werden alle benötigten Dateien von EDPweb auf Ihrem Rechner gespeichert. Hierbei kann EDPweb sowohl auf dem gleichen Rechner wie der EDP-Server als auch auf einem anderen Rechner, beispielsweise einer DMZ, installiert werden.
-Im Rahmen des Setups wird die Anwendung edpweb.exe auf dem betreffenden Rechner
-als Windowsdienst installiert. In der Dienstanwendung von EDPweb sind alle Funktionen des Webservers enthalten.
-Bitte beachten Sie, dass bei einer Updateinstallation alle Template-Dateien im Ordner "templates" aktualisiert werden. Daher sollten eigene Anpassungen an Druckvorlagen und Template-Dateien immer im Ordner "custom" abgelegt werden. Dieser muss - falls nicht vorhanden - manuell erstellt werden.
+===== Installation =====
-=== Grundkonfiguration von EDPweb ===
+Das Setup speichert alle benötigten Dateien von **edp:**web auf Ihrem Rechner. Sie können **edp:**web auf demselben Rechner wie den EDP-Server installieren oder auf einem anderen Rechner, beispielsweise in einer DMZ. Im Rahmen des Setups wird die Anwendung ''edpweb.exe'' auf dem betreffenden Rechner als Windows-Dienst installiert. Die Dienstanwendung von **edp:**web enthält alle Funktionen des Webservers.
-Die Grundeinstellungen von EDPweb werden in der Konfigurationsdatei „EDPweb.ini“
+> **Hinweis:** Bei einer Updateinstallation werden alle Template-Dateien im Ordner ''templates'' aktualisiert. Legen Sie eigene Anpassungen an Druckvorlagen und Template-Dateien daher immer im Ordner ''custom'' ab. Falls dieser Ordner nicht vorhanden ist, müssen Sie ihn manuell anlegen.
-verwaltet. Öffnen Sie diese bitte zunächst im Anschluss an die Installation, um die dort
-notwendigen Anpassungen vorzunehmen.
-Alternativ können Sie auch das mitgelieferte Tool edpkonfig.exe starten. Dort
+===== Grundkonfiguration von edp:web =====
-können Sie direkt die Einstellungen der Ini-Datei verändern sowie die verfügbaren
-Menüpunkte in der Start-Seite und im Menü am oberen Rand der Seite festlegen. Bitte
-beachten Sie allerdings, dass in neueren Windows-Versionen die Ini-Datei in der Regel
-unter C:\Benutzer\... eine benutzerspezifische Ini-Datei angelegt wird. Daher folgen Sie
-für die Konfiguration der Ini-Datei im Zweifelsfall den nun beschriebenen Schritten.
-In der Sektion [Database] geben Sie bitte die Verbindungsdaten zur Datenbank ein. Bitte
-beachten Sie dabei, dass der Pfad der Datenbank, bei dem Wert „Database“ der lokale
-Pfad auf dem Datenbankrechner bzw. Server sein muss.
-In der Sektion [HTTP-Server] können Sie die Einstellungen für den Webserver von
-EDPweb konfigurieren. Als Port geben Sie den gewünschten Port, unter dem der
-Webserver erreichbar sein soll an, an. Bitte beachten Sie, dass für einen Zugriff eine Freigabe für den eingestellten Port
-erfolgen muss. Diese sollte nur innerhalb eines lokalen Netzwerks oder eines VPNs erfolgen. Bei einem Zugriff aus dem Internet kann eine Absicherung über ein Client-Zertifikat erfolgen.
-=== SSL Verschlüsselung ===
+Die Grundeinstellungen von **edp:**web werden in der Konfigurationsdatei ''EDPweb.ini'' verwaltet. Öffnen Sie diese Datei direkt nach der Installation und nehmen Sie die notwendigen Anpassungen vor.
-Bei der Nutzung von EDPweb muss eine aktive SSL-Verschlüsselung (EDPweb verwendet hier nur TLS 1.2) verwendet werden. Dies kann über die Anwendung "EDP Konfiguration" unter "EDPweb" festgelegt werden. EDPweb greift dabei auf die Dateien mit dem Namen "ssl.cer" für die Zertifikatsdatei sowie "ssl.key" für den zugehörigen Schlüssel zu. Diese beiden Dateien müssen im gleichen Ordner wie die Anwendungsdatei edpweb.exe abgelegt sein und sollten gegen eigene Zertifikatsdateien getauscht werden. Nach einem Austausch der Dateien ist ein Neustart des Dienstes erforderlich.
+Alternativ können Sie das mitgelieferte Tool ''edpkonfig.exe'' starten. Dort ändern Sie die Einstellungen der Ini-Datei direkt und legen außerdem fest, welche Menüpunkte auf der Startseite und im Menü am oberen Rand der Seite verfügbar sind. Beachten Sie allerdings, dass neuere Windows-Versionen in der Regel eine benutzerspezifische Ini-Datei unter ''C:\Benutzer\...'' anlegen. Folgen Sie im Zweifelsfall deshalb den unten beschriebenen Schritten zur Konfiguration der Ini-Datei.
-Ein Zertifikat kann auch selbst erstellt werden:
+In der Sektion ''[Database]'' tragen Sie die Verbindungsdaten zur Datenbank ein. Der Pfad der Datenbank beim Wert ''Database'' muss der lokale Pfad auf dem Datenbankrechner bzw. Server sein.
-{{ :edpweb:erstellen_eines_zertifikats.pdf |Anleitung zum Erstellen eines Zertifikats}}
-Möchten sie einen SSL-Proxy für lets Encrypt nutzen, finden sie [[edpweb:ssl-proxy|hier]] weitere Informationen: [[edpweb:ssl-proxy|SSL-Proxy]].
+In der Sektion ''[HTTP-Server]'' konfigurieren Sie den Webserver von **edp:**web. Als ''Port'' geben Sie den Port an, unter dem der Webserver erreichbar sein soll. Für einen Zugriff muss dieser Port freigegeben werden. Die Freigabe sollte nur innerhalb eines lokalen Netzwerks oder eines VPN erfolgen. Bei einem Zugriff aus dem Internet können Sie den Zugang zusätzlich über ein Client-Zertifikat absichern.
-=== Client Zertifikat ===
+===== SSL-Verschlüsselung =====
-Zusätzlich kann ein Root Zertifikat hinterlegt werden, um nur noch einen Zugriff für Clients zu ermöglichen, auf denen ein durch das Root-Zertifikat signiertes Client-Zertifikat installiert ist. Das Root-Zertifikat muss unter dem Namen "root.cer" ebenfalls im Verzeichnis von EDPweb abgelegt werden.
+Für **edp:**web muss eine aktive SSL-Verschlüsselung verwendet werden (**edp:**web verwendet hier nur TLS 1.2). Sie legen dies in der Anwendung "EDP Konfiguration" unter "EDPweb" fest. **edp:**web greift dabei auf die Zertifikatsdatei ''ssl.cer'' und den zugehörigen Schlüssel ''ssl.key'' zu. Beide Dateien müssen im selben Ordner wie die Anwendungsdatei ''edpweb.exe'' liegen und sollten gegen eigene Zertifikatsdateien ausgetauscht werden. Nach dem Austausch der Dateien müssen Sie den Dienst neu starten.
-==== Lizenzdatei ====
+Ein Zertifikat können Sie auch selbst erstellen: {{ :edpweb:erstellen_eines_zertifikats.pdf |Anleitung zum Erstellen eines Zertifikats}}
-EDPweb verfügt nach der Installation noch nicht über eine Lizenzdatei und kann
-dementsprechend noch nicht gestartet werden. Ihre Lizenzdatei für EDPweb haben Sie
-in der Regel per e-Mail erhalten und müssen diese nun ins Grundverzeichnis von
-EDPweb kopieren (gleicher Ordner wie die Anwendung edpweb.exe). Weitere
-Maßnahmen zum Einspielen der EDPweb-Lizenz sind nicht notwendig.
-==== Benutzer ====
+Wenn Sie einen SSL-Proxy für Let's Encrypt nutzen möchten, finden Sie weitere Informationen auf der Seite [[edpweb:ssl-proxy|SSL-Proxy]].
-Für einen Zugriff auf EDPweb ist zunächst eine Anmeldung mit Benutzername und Kennwort notwendig. Dabei wird auf die gleiche Benutzerdatenbank zugegriffen wie im Einsatzleitplatz von EDP. Daher können Sie die Benutzer auch über den EDP Editor verwalten. Dort ist es erforderlich, dass Sie den Haken „Benutzer hat Zugang zu EDPweb“ setzen, wenn der Benutzer mit EDPweb arbeiten darf. Weiterhin muss der Benutzer bei der Anmeldung eine Funktion auswählen. Die Funktionen legen Sie im EDPEditor unter „Funktionen“ an. Es muss zur Nutzung von EDPweb mindestens eine Funktion zur Auswahl stehen. Unfallhilfsstellen werden im EDP-Editor unter „Unfallhilfsstellen“ angelegt und erscheinen dann automatisch aus auswählbare Funktion in EDPweb.
+===== Client-Zertifikat =====
-==== IP-Adressenprüfung ====
+Zusätzlich können Sie ein Root-Zertifikat hinterlegen. Dann ist der Zugriff nur noch von Clients möglich, auf denen ein vom Root-Zertifikat signiertes Client-Zertifikat installiert ist. Legen Sie das Root-Zertifikat unter dem Namen ''root.cer'' ebenfalls im Verzeichnis von **edp:**web ab.
-Nach der Anmeldung wird für diese eine sog. Session erzeugt, unter der der angemeldete Benutzer aktiv ist. Innerhalb dieser Session wird auch die IP-Adresse des Benutzers gespeichert, so dass nur Anfrage von dieser IP-Adresse zugelassen werden. In besonderen Anwendungsfällen (wechselnder Zugriff WLAN / UMTS o.ä.) kann dies zu Problemen führen, da dann im laufenden Betrieb dann mehrfach die IPs des Nutzers der Session ändern und dann kein Zugriff auf die Anmeldung mehr besteht. Durch folgende Ergänzung in der Ini-Datei "edpweb.ini" kann diese Funktion deaktiviert werden:
+===== Lizenzdatei =====
-<code>
+Nach der Installation hat **edp:**web noch keine Lizenzdatei und kann deshalb noch nicht gestartet werden. Ihre Lizenzdatei für **edp:**web haben Sie in der Regel per E-Mail erhalten. Kopieren Sie diese in das Grundverzeichnis von **edp:**web, also in denselben Ordner wie die Anwendung ''edpweb.exe''. Starten Sie anschließend EDPkonfig neu. Danach erscheint in der Lizenzübersicht auch "EDPweb". Weitere Schritte zum Einspielen der **edp:**web-Lizenz sind nicht notwendig.
+===== Benutzer =====
+Für den Zugriff auf **edp:**web ist eine Anmeldung mit Benutzername und Kennwort notwendig. **edp:**web nutzt dafür dieselbe Benutzerdatenbank wie **edp:**desk. Sie können die Benutzer daher auch über den EDPEditor verwalten. Setzen Sie dort den Haken "Benutzer hat Zugang zu EDPweb", wenn der Benutzer mit **edp:**web arbeiten darf.
+Außerdem muss der Benutzer bei der Anmeldung eine Funktion auswählen. Die Funktionen legen Sie im EDPEditor unter "Funktionen" an. Für die Nutzung von **edp:**web muss mindestens eine Funktion zur Auswahl stehen. Unfallhilfsstellen legen Sie im EDPEditor unter "Unfallhilfsstellen" an. Sie erscheinen dann automatisch als auswählbare Funktion in **edp:**web.
+===== IP-Adressenprüfung =====
+Nach der Anmeldung wird eine sogenannte Session erzeugt, unter der der angemeldete Benutzer aktiv ist. In dieser Session wird auch die IP-Adresse des Benutzers gespeichert, sodass nur Anfragen von dieser IP-Adresse zugelassen werden. In besonderen Anwendungsfällen, etwa bei wechselndem Zugriff über WLAN und UMTS, kann das zu Problemen führen. Ändert sich die IP-Adresse des Nutzers im laufenden Betrieb mehrfach, besteht kein Zugriff mehr auf die Anmeldung. Mit folgender Ergänzung in der Ini-Datei ''edpweb.ini'' können Sie diese Prüfung deaktivieren:
+<code ini>
 [Session]
 CheckIP=0
 </code>
-Da es sich dabei um das Deaktivieren einer Sicherheitsfunktion handelt, sollte dies nur nach eingehender Prüfung und nur in Ausnahmefällen erfolgen.
+> **Hinweis:** Damit deaktivieren Sie eine Sicherheitsfunktion. Tun Sie das nur nach eingehender Prüfung und nur in Ausnahmefällen.
-==== Automatisches Speichern der Patientenprotokolle ====
+===== Automatisches Speichern der Patientenprotokolle =====
-Für die Nutzung des UHS-Moduls kann ein automatisches Speichern der Patientenprotokolle nach Entlassung eines Patienten aktiviert werden. Dazu ist folgender Eintrag in die Ini-Datei edpweb.ini erforderlich:
+Für das UHS-Modul können Sie das automatische Speichern der Patientenprotokolle nach Entlassung eines Patienten aktivieren. Dazu ist folgender Eintrag in der Ini-Datei ''edpweb.ini'' erforderlich:
-<code>
+<code ini>
 [UHS]
 ;Pfad in dem die Protokolle gespeichert werden sollen
@@ Zeile 73: / Zeile 62: @@
 </code>
-Bitte beachten Sie in diesem Zusammenhang, dass EDPweb als Dienst in Windows unter dem Systembenutzer ausgeführt wird und dieser u.U. keinen Zugriff auf Netzlaufwerke besitzt. Daher sollte das Speichern in einen lokalen Pfad erfolgen.
+**edp:**web läuft als Windows-Dienst unter dem Systembenutzer, und dieser hat unter Umständen keinen Zugriff auf Netzlaufwerke. Speichern Sie die Protokolle daher in einem lokalen Pfad.
+===== Hinweis bei Verwendung eines Reverse-Proxys =====
+Einige Module von **edp:**web, u.a. das ELW-Modul, verwenden eine Websocket-Verbindung. Wenn Sie **edp:**web über einen Reverse-Proxy bereitstellen, ist im Proxyserver in der Regel eine Konfiguration erforderlich, die ein Upgrade auf eine Websocket-Verbindung erlaubt.