Konfiguration

Die Konfiguration des Clients basiert auf unserem Konfigurationssystem. Im einfachsten Fall schreibst du deine Konfiguration in die Datei configuration.xml welche du im Verzeichnis der Anwendung platzierst. Die genauen Details zum Konfigurationssystem findest du im Kapitel Konfigurationssystem.

Schema der Konfiguration

Das folgende Schema zeigt die Struktur der Konfiguration:

Der Wert host

Mit dem Wert host konfigurierst du den Hostnamen oder die IP-Adresse des Session Monitor Servers.

<Module name="Application">
    <Value name="host">host1.example.com</Value>
    <Value name="apiKey">XiV(...)Dw{</Value>
    <Value name="apiSecret">h}_Yy(...)97z</Value>
</Module>

Der Wert port

Mit dem optionalen Wert port gibst du einen eigenen Port für die Verbindung zum Session Monitor Server an. Lässt du diesen Wert weg, wird der Default 17672 verwendet.

<Module name="Application">
    <Value name="host">host1.example.com</Value>
    <Value name="port">12345</Value>
    <Value name="apiKey">XiV(...)Dw{</Value>
    <Value name="apiSecret">h}_Yy(...)97z</Value>
</Module>

Der Wert apiKey

Der Wert apiKey konfiguriert den Schlüssel des Schlüsselpaars für die Authentifizierung am Session Monitor Server.

Das Schlüsselpaar wird mit dem Secret Generator erstellt. Siehe dazu Das Secret System.

<Module name="Application">
    <Value name="host">host1.example.com</Value>
    <Value name="apiKey">XiV(...)Dw{</Value>
    <Value name="apiSecret">h}_Yy(...)97z</Value>
</Module>

Der Wert apiSecret

Der Wert apiSecret konfiguriert das Secret des Schlüsselpaars für die Authentifizierung am Session Monitor Server.

Das Schlüsselpaar wird mit dem Secret Generator erstellt. Siehe dazu Das Secret System.

<Module name="Application">
    <Value name="host">host1.example.com</Value>
    <Value name="apiKey">XiV(...)Dw{</Value>
    <Value name="apiSecret">h}_Yy(...)97z</Value>
</Module>

Beispielkonfiguration

Das folgende Beispiel konfiguriert den Client damit er beim Start eine Verbindung zum Session Monitor Server auf dem Host host1.example.com aufbaut.

<?xml version="1.0" encoding="UTF-8" ?>
<Configuration
    version="1"
    xmlns="http://educateit.ch/software/BlueStone/Configuration/1"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

    <Module name="Application">
        <Value name="host">host1.example.com</Value>
        <Value name="apiKey">XiV(...)Dw{</Value>
        <Value name="apiSecret">h}_Yy(...)97z</Value>
  </Module>
</Configuration>