images/download/attachments/73606742/webinsight-version-3-modificationdate-1655960526749-api-v2.png

Das Modul WebInsight ist der Nachfolger der Module Web Monitor und Portal. Die Funktionalitäten der alten Module sind im neuen enthalten. Es ist eine Lizenz nötig für dieses Zusatzmodul.

Zudem wird in der nächsten Version von Lobster_data die neue Funktionalität Workflows verfügbar sein, mit der es möglich sein wird, komplexe Arbeitsabläufe mit einer State Machine (Zustandsmaschine) zu erstellen. Das wird es Ihnen erlauben, in jedem der Zustände, Prozesse (Profile, ASM-Einträge und andere Workflows) zu starten und Formulare zu verwenden.

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 ab der nächsten Version)
Benutzer- und Modul-Einstellungen

Installation

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

images/download/attachments/73606742/WebInsight_1-version-2-modificationdate-1624854188647-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 WebInsight-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 webinsight) 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">webinsight</Set>
            <Set name="allowGrowing">true</Set>
			<Set name="database">jdbc:mysql://localhost:3306/webinsight?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">webinsight</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">webinsight</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">webinsight</Set>

Benutzer

WebInsight hat beim ersten Start automatisch einen Benutzer admin mit Kennwort admin angelegt. Ändern Sie danach bitte das Passwort oder legen Sie einen neuen WebInsight-Benutzer an.

Adresse

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

http(s)://<IP-des-Lobster_data-oder-DMZ>/WebInsight/?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>/WebInsight?token=<Token-String>&user=<user>

Also zum Beispiel: http://localhost/WebInsight?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).