webserver.js Konfiguration

Der Konfigurationsabschnitt [webserverjs]

webserver.js wird über den Abschnitt [webserverjs] in der Projektkonfigurationsdatei konfiguriert. Die verfügbaren Konfigurationsoptionen entsprechen weitgehend denen von webclient_http.ctl und dashboard.ctl, müssen jedoch im Abschnitt [webserverjs] anstelle von [wssServer] oder [httpServer] eingetragen werden. Dashboard-bezogene Einstellungen, die sich bisher in [httpServer] befanden, sind ebenfalls nach [webserverjs] zu verschieben.

Portkonfiguration

Der von webserver.js verwendete HTTPS-Port wird über den Eintrag httpsPort festgelegt:

[webserverjs]
httpsPort = 8443

Der Standardwert ist 8443. Dieser Wert ist zu ändern, wenn der Port bereits von einem anderen Dienst verwendet wird oder die Installation einen anderen Port erfordert.

Indexseite

Mit dem Eintrag indexPage wird definiert, welche Seite als Standard-Startseite bereitgestellt wird. Zur Bereitstellung des WinCC OA Dashboard wird konfiguriert:

[webserverjs]
indexPage = "data/dashboard-wc/index.html"

Parallelbetrieb mit webclient_http.ctl

Wenn sowohl webserver.js als auch der HTTP Server mit webclient_http.ctl aktiv sind, sind zwei HTTP-Server auf unterschiedlichen Ports erreichbar. In dieser Konfiguration kann das Dashboard über beide Ports geöffnet werden. Dies kann jedoch zu inkonsistenten Ergebnissen führen, wenn die Server unterschiedlich konfiguriert sind oder verschiedene Anpassungen verwenden. Es ist stets der für webserver.js konfigurierte Port zu verwenden, wenn das Dashboard geöffnet wird.

ULC-UX-Weiterleitung

ULC UX-Anfragen können von webserver.js an den Handler webclient_http.ctl weitergeleitet werden. Dies ist erforderlich, damit ULC UX funktioniert, wenn webserver.js als Backend eingesetzt wird.

Zur Aktivierung der ULC-UX-Weiterleitung werden dem Abschnitt [webserverjs] die folgenden Einträge hinzugefügt:

[webserverjs]
ulcUxPort = 443
ulcUxHost = "localhost"
allowExternalResources = 1

ulcUxPort und ulcUxHost geben Port und Host der HTTP-Server-Instanz an, die webclient_http.ctl ausführt.

Der Eintrag allowExternalResources muss auf 1 gesetzt werden, um das Einbetten des ULC-UX-Frames von einem anderen Host und/oder Port in das Dashboard zu ermöglichen.

Auf der HTTP-Server-Seite muss CORS (Cross-Origin Resource Sharing) konfiguriert werden, damit Anfragen vom webserver.js-Origin zugelassen werden. Dem Abschnitt [httpServer] sind die folgenden Einträge hinzuzufügen:

[httpServer]
accessControlAllowOrigin = "https://localhost:8443"
httpHeader = "Content-Security-Policy: frame-ancestors 'self' https://localhost:8443"
XFrameOptions = none

Die Serveradresse und Portnummer in diesen Einträgen ist an den für webserver.js konfigurierten httpsPort anzupassen.