images/download/attachments/73609234/webinsight-version-3-modificationdate-1655960392635-api-v2.png

Das Modul DataCockpit ist der Nachfolger der Module Web Monitor und Portal. Die Funktionalitäten der alten Module sind im neuen enthalten. Zudem ist die neue Funktionalität Workflows verfügbar. Es ist eine Lizenz nötig für dieses Zusatzmodul.

Log-Suche (Funktionalität des alten Moduls Web Monitor)
Prozess starten (Funktionalität des alten Moduls Web Monitor)
Formulare (Funktionalität des alten Moduls Portal)
Workflows (neue Funktionalität)
Benutzer- und Modul-Einstellungen

Installation

Es gibt zwei Installationsmöglichkeiten für das Modul. Mit und ohne DMZ-Server.

images/download/attachments/73609234/WebInsight_1-version-1-modificationdate-1624608422056-api-v2.png

Installation ohne DMZ-Server

...

Die Konfigurationsdatei ./etc/startup.xml ist folgendermaßen einzurichten.

<Call name="addApplication">
	<Arg>
		<New class="de.lobster.webmon.apps.WebMonitor">
			<Set name="forceSSL">false</Set>
			<Set name="alias">hub</Set>
			<Set name="remoteHost"/>
			<Set name="remotePort">8020</Set>
			<Set name="mailSender">someone@example.com</Set>
			<Set name="mailSenderForPassword">noreply@example.com</Set>
			<Set name="ldapAlias"/>
			<Set name="retainHeaderLogs">90</Set>
			<Set name="cleanUpTime">2</Set>
			<Set name="serverName">Main Server</Set>
		</New>
	</Arg>
</Call>

Zudem muss in der selben Datei ein Mail-Server konfiguriert sein (wenn das nicht bereits der Fall ist).

<!-- mail server settings -->
<Call name="addApplication">
	<Arg>
		<New class="com.ebd.util.net.mail.HubStartupConfiguration">
			<Call name="setMailSettings">
				<!--SMTP via TLS should be used 
                    <Arg>smtps</Arg>
                    -->
				<Arg>localhost</Arg>
				<Arg type="int">25</Arg>
				<Arg>info@example.com</Arg>
                <Arg>my_password_obfuscated</Arg>
			</Call>
			<!-- Uncomment the next line and set with fitting values to change the list of mechanisms to be used for authentication -->
			<!--
                <Set name="sMTPAuthMechanisms">LOGIN PLAIN MD5-DIGEST NTLM</Set>
                -->
		</New>
	</Arg>
</Call>

Installation mit DMZ-Server

...

Logs werden auf dem inneren Integration Server vorgehalten. Auf dem DMZ-Server wird eine weitere Datenbank-Instanz (Schema) installiert und vom inneren Integration Server mit den notwendigen Logs gefüllt (Replikation).

Datei-Inhalte dagegen (Eingangs- und Ausgangsdateien, nicht Konfigurationsdateien) werden nicht repliziert, sondern mittels MessageServices (Defaultport 8020) on demand (über den DMZ-Server) vom inneren Integration Server an den DataCockpit-Client geliefert.

Datenbank aufsetzen (auf DMZ-Server)

...

In diesem Beispiel wird von einer MySQL-Datenbank ausgegangen. Legen Sie als Datenbank-Administrator eine neue Datenbank-Instanz (hier datacockpit) und einen Datenbank-Benutzer (hier myuser) auf dem DMZ-Server an.

./etc/database.xml (auf DMZ-Server)

...

Tragen Sie nun das neu erzeugte Schema in der Konfigurationsdatei ./etc/database.xml auf dem DMZ-Server ein. Diese Datenbank-Instanz muss mittels TCP/IP vom inneren Integration Server aus erreichbar sein und der Datenbank-Benutzer muss entsprechende Rechte haben.

Beispiel:

<Call name="initPool">
    <Arg>
        <New class="com.ebd.hub.services.database.DatabaseSettings">
            <Set name="alias">datacockpit</Set>
            <Set name="allowGrowing">true</Set>
			<Set name="database">jdbc:mysql://localhost:3306/datacockpit?useSSL=false&characterEncoding=UTF8&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=Europe/Berlin&allowPublicKeyRetrieval=true</Set>
            <Set name="driver">com.mysql.cj.jdbc.Driver</Set>
            <Set name="user">myuser</Set>
            <Set name="password">OBF:1wtm1xtz1w8v1xtj1wus</Set>
            <Set name="minSize">2</Set>
			<Set name="maxSize">30</Set>
            <Set name="idleTime">300000</Set>
            <Set name="sqlCommand">select 1 from dual</Set>
            <Set name="rollback">true</Set>
            <Set name="caching">true</Set>
            <Set name="catalogName">datacockpit</Set>
        </New>
    </Arg>
</Call>

./etc/startup_dmz.xml (auf DMZ-Server)

...

Tragen Sie nun bitte folgenden Abschnitt in die Konfigurationsdatei ./etc/startup_dmz.xml ein.

<Call name="addApplication"><Arg>
    <New class="de.lobster.webmon.apps.WebMonitor">
		<Set name="forceSSL">false</Set>
        <Set name="alias">datacockpit</Set>
        <Set name="remoteHost">192.168.0.99</Set>
        <Set name="remotePort">8020</Set>
        <Set name="mailSender">some_user@example.com</Set>
		<Set name="mailSenderForPassword">some_user@example.com</Set>
		<Set name="ldapAlias"/>
        <Set name="retainHeaderLogs">999</Set>
        <Set name="cleanUpTime">2</Set>
		<Set name="serverName">Main Server</Set>
    </New>
</Arg></Call>

Parameter	Beschreibung
remoteHost	Hier muss die IP/URL des inneren Integration Servers eingetragen werden.
remotePort	Siehe Parameter remoteHost.
retainHeaderLogs	Bestimmt die Vorhaltezeit der Logeinträge in Tagen. Detail-Logs werden so lange vorgehalten, wie es von Lobster_data (profilabhängig) vorgegeben wird.
cleanUpTime	Bestimmt die Uhrzeit (24 Stunden, ganzzahlig), wann veraltete Log-Einträge gelöscht werden sollen.

Zudem muss in der selben Datei ein Mail-Server konfiguriert sein (wenn das nicht bereits der Fall ist).

<!-- mail server settings -->
<Call name="addApplication">
	<Arg>
		<New class="com.ebd.util.net.mail.HubStartupConfiguration">
			<Call name="setMailSettings">
				<!--SMTP via TLS should be used 
                    <Arg>smtps</Arg>
                    -->
				<Arg>localhost</Arg>
				<Arg type="int">25</Arg>
				<Arg>info@example.com</Arg>
                <Arg>my_password_obfuscated</Arg>
			</Call>
			<!-- Uncomment the next line and set with fitting values to change the list of mechanisms to be used for authentication -->
			<!--
                <Set name="sMTPAuthMechanisms">LOGIN PLAIN MD5-DIGEST NTLM</Set>
                -->
		</New>
	</Arg>
</Call>

./etc/database.xml (auf innerem Server)

...

Diese Datei muss wie auf dem DMZ-Server angepasst werden, allerdings muss beim Connection-String (Parameter database) die IP/URL des DMZ-Servers verwendet werden (siehe <Set name="dmzHost">DMZ_IP_Address</Set> in Konfigurationsdatei ./etc/startup.xml des inneren Integration Servers).

./etc/startup.xml (auf innerem Server)

...

Diese Datei muss wie auf dem DMZ-Server (./etc/startup_dmz.xml) angepasst werden, allerdings muss der Parameter remoteHost leer bleiben!

Zudem muss folgende Zeile einkommentiert werden, für die Replikation der Logs und die On-Demand-Lieferung von Datei-Inhalten.

<Set name="webMonitorAlias">datacockpit</Set>

Benutzer

Das DataCockpit hat beim ersten Start automatisch einen Benutzer admin mit Kennwort admin angelegt. Ändern Sie danach bitte das Passwort oder legen Sie einen neuen DataCockpit-Benutzer an. Siehe auch Abschnitte SSO (Benutzer) und Zwei-Faktor-Authentisierung (Benutzer).

Adresse

http(s)://<IP-des-Lobster_data-oder-DMZ>/DataCockpit

http(s)://<IP-des-Lobster_data-oder-DMZ>/DataCockpit/?user=<user>&password=<password>&language=de

Hinweis: Siehe Abschnitt Hinzufügen eines HTTPS-Listeners.

Sprachcodes

...

Sprache	Code
Deutsch	de
Englisch	en
Spanisch	es
Französisch	fr
Italienisch	it
Dänisch	da
Niederländisch	nl

Anmeldung mit Token

...

http(s)://<IP-oder-URL-des-Lobster_data-oder-DMZ>/webmonitor/Interceptor?user=<user>&password=<password>&language=de

Als Antwort erhalten Sie einen Token-String folgender Art. Die Gültigkeitsdauer ist 15 Minuten.

1661755355467005731743:33703602516:533663474105103177626

In einem weiteren Aufruf, der den Token-String verwendet, erfolgt dann die eigentliche Anmeldung.

http(s)://<IP-oder-URL-des-Lobster_data-oder-DMZ>/DataCockpit?token=<Token-String>&user=<user>

Also zum Beispiel: http://localhost/DataCockpit?token=1661755355467005731743:33703602516:533663474105103177626&user=myuser

Wichtiger Hinweis: Beachten Sie bitte, dass manche Zeichen in einer URL reserviert sind. Eine Lösung wäre, diese Zeichen nicht im Benutzer oder im Passwort zu verwenden. Allerdings haben Sonderzeichen natürlich zur Sicherheit auch ihren Sinn in Passwörtern. Alternativ können Sie Ihr Passwort dann davor URL-kodieren, bevor Sie es in der URL eintragen. Siehe z. B. Funktion URL-encode(text a, encoding b, space-handling c).