Configuration

CustomHeader

Custom Header

Die Custom-Header werden an den HTTP-Request der Browser-Moduls angehangen. Sollte die Zielanwendung diese benötigen, können Sie sie hier setzen. Es ist auch hier möglich Platzhalter einzusetzen.

Beispielsweise: {User.UserName} für den Benutzernamen des aktuellen Benutzers.

Dies ist eine Experteneinstellung

AvailableParameter

Verfügbare Parameter

Dies sind die Parameter, welche Sie in den Custom Headern und der Url verwenden können. Die Auswahl der Parameter unterscheidet sich zwischen den verschiedenen auszuwählenden Typen der Konfiguration.

Die Parameter werden bereits so vorbereitet, dass sie direkt verwendet werden können. Die Werte können mit den Kopier-Button in die Zwischenablage übernommen werden.

Beispielsweise könnte eine Uri: http://google.de/search?q={Company} lauten.

GridImage

Bild

Das ist das Bild, welches den Benutzer im Reiter angezeigt wird. Sie können hier sowohl ein SVG, als auch ein PNG einsetzen. Wir empfehlen SVG.

Achtung: Sollten Sie die Bilder ändern, dauert es bis zu einen Tag, bis es auch im Client geändert wird. Um es zu forcieren, können den Cache im Client unter Einstellungen > Einstellungen > Browser-Modul leeren.

ActionImage

Bild

Das ist das Bild, welches den Benutzer in der Aktion angezeigt wird. Sie können hier sowohl ein SVG, als auch ein PNG einsetzen. Wir empfehlen SVG.

Achtung: Sollten Sie die Bilder ändern, dauert es bis zu einen Tag, bis es auch im Client geändert wird. Um es zu forcieren, können den Cache im Client unter Einstellungen > Einstellungen > Browser-Modul leeren.

Title

Titel

Der Titel des Reiters , welcher den Benutzer angezeigt wird. Ein Zugriff auf Parameter ist hier nicht möglich.

ActionTitle

Titel

Der Titel, welcher den Benutzer angezeigt wird. Ein Zugriff auf Parameter ist hier nicht möglich.

Authentication

Authentifizierung

Hiermit stellen Sie die Authentifizierung des Reiters ein. Für diese Einstellung müssen Sie die einzubindende Seite untersuchen und feststellen, um welchen Typen es sich handelt. Dafür sind erweiterte Netzwerk Kentnisse notwendig.

Browser: Bei dieser Authentication übernimmt der Browser. Sie werden als Benutzer auf eine Login-Seite geleitet und müssen sich anmelden. Diese wird - je nach Anwendung - gespeichert, sodass beim nächsten Mal die Anmeldung nicht notwendig ist. Dies ist die Standardeinstellung.

Basic: Bei der Basic-Authentifizierung verwenden Sie Benutzername und Passwort.

JWT: Diese Einstellung ist experimentell und für WebApps ausgelegt. Wird diese aktiviert, aktiviert sich in der Unteransicht mehrere Einstellungen. Dieser Typ der Authentifizierung erzeugt einen einstellbaren Http Aufruf für für Authentifizierung. Dort werden die Login-Daten (meistens als JSON) mitgegeben. Das Ergebnis ist ein JWT-Token, welches aus der Antwort extrahiert wird. Das Token wird im Anschluss in den LocalStorage der Anwendung geschrieben und ist durch die WebApp nutzbar.

UserAuth

UserAuth

Mit dieser Einstellung können Sie die Authentifizierung zwischen Global und Benutzer umstellen.

Ist diese Einstellung deaktiviert, werden die Authentifizierungsdaten im Administrator unter “Browser-Modul > Authentifizierung” abgefragt

Ist diese Einstellung aktiviert, müssen sie im Client unter Einstellungen > Einstellungen > Browser-Modul” durch den Benutzer eingegeben werden.

URLTemplate

URL

Dies ist die wichtigste Einstellung. Hier stellen Sie die URL ein, welche durch den Browser im konfigurierten Tab angezeigt wird. Je nach Typ können Sie dabei auf verschiedene Parameter zugreifen, welche in {geschweiften Klammern} gesetzt werden.

Die verfügbaren Parameter erhalten Sie, indem Sie in der Zeile auf das '+' klicken. Dort sind sie bereits kopierbereit abgelegt. Ein Beispiel für eine Google Suche nach der Firma lautet

http://google.de/search?q={Company}

AktionUriTemplate

URL

Dies ist die wichtigste Einstellung. Hier stellen Sie die URL ein, welche im Browser geöffnet werden soll. Je nach Typ können Sie dabei auf verschiedene Parameter zugreifen, welche in {geschweiften Klammern} gesetzt werden.

http://google.de/search?q={Company}

Type

Typ

Hier stellen Sie den Typen ein, an welchen der Reiter angehängt werden soll. Dies kann sowohl ein Flexobjekt oder ein Kontakt sein.

Diese Auswahl beeinflusst die Parameter, welche Sie in der URL zugreifen können.

ActionType

Typ

Hier stellen Sie den Typen ein, an welchen die Aktion angezeigt werden soll. Dies kann sowohl ein Flexobjekt oder ein Kontakt sein.

Diese Auswahl beeinflusst die Parameter, welche Sie in der URL zugreifen können.

JWTMethod

Method

Die Methode, mit welchen der JWT-Call ausgeführt werden soll. Üblicherweise POST.

JWTUri

JWT-Uri

Hier wird die URL hinterlegt, mit welchen das JWT-Token abgerufen wird. Dies ist normalerweise eine URL, welche aus den DevTools des Browser herausgelesen werden kann.

Hier können keine Parameter verwendet werden

JWTPayload

JWT-Payload

Dies ist der Body, welcher im JWT-Request verschickt werden soll. Üblicherweise enthält dieser die Anmeldedaten der Anwendung, an welche sich angemeldet werden soll in JSON.

Dieser Payload enthält die Daten, die der Benutzer eingeben muss. Da diese von Anwendung zur Anwendung unterschiedlich ist, können hier Variablen eingefügt werden. Diese werden mit einem vorgestellten '$' angeben. z.B. $Username oder $Password. Erkannte Variablen werden im rechten Feld angezeigt.

Zusätzlich ist es möglich einfache Transformationen auf den Variablen anzuwenden, welche mit einem ':' angefügt werden. Die Transformationen werden ebenfalls angezeigt. Ein Beispiel lautet. “$Password:SHA512”

JWTJsonPath

JSON Path

Dieser JSON Path Ausdruck dient dazu aus der erhaltenen Antwort den JWT Token zu extrahieren. Eine Antwort beinhaltet oft auch zusätzliche Informationen wir Benutzername oder Gültigkeit.

Um diesen herauszufinden, können Sie die Antwort kopieren und im verlinkten Online Evaluator kopieren. Dort können Sie den Ausdruck erzeugen und hier einfügen. Ein Beispiel : ‘$.Token'

Online Evaluator

JWTLocalVariable

Lokale Variable (optional)

Hier können Sie den Namen der Variable setzen, in welche das Ergebnis des JWT-Requests unter Berücksichtigung des JSON Pathes geschrieben wird. Der Wert wird im Browser im LocalStorage abgelegt. Von dort kann die enthaltende WebAnwendung diese weiterverarbeiten.

Variables

Definierten Variablen

Die Variablen, welche hier angezeigt werden, werden durch den Request-Payload definiert. Alle dort gefundenen Variablen werden in der Listbox angezeigt.

Diese Variablen werden dem Benutzer angezeigt, wenn er seine Authenfizierungsdaten im Client angiebt.

Hinweis: Es wird ein Passwortfeld als solches erkannt und angezeigt, wenn es “pass” enthält.

Transformations

Verfügbare Transformationen

Die Transformationen sind nützlich, wenn die durch den Benutzer eingegebenen Werte nicht direkt zum Server verschickt werden. Beispielsweise kann das Passwort gehashed werden.

Um eine Transformation zu verwenden, wird diese mit einem “:” hinter der Variable angegeben. Beispielsweise

{ “Password”: “$Password:SHA512” }