BE-POS Listener

Installation, Browser- und Azure-Relay-Konfiguration sowie Test und Deinstallation des BE POS Listeners.

Download

Der BE-POS Listener kann hier heruntergeladen werden.

Installation

  1. Anwendung bepos_listener_setup.exe starten.

  2. Zielordner auswählen und mit Weiter fortfahren

image.png Zum Vergrößern anklicken

image.png Zum Vergrößern anklicken

image.png Zum Vergrößern anklicken

  1. Installation mittels Installieren durchführen.

image.png Zum Vergrößern anklicken

  1. Mit Fertigstellen Installation beenden. Der BE-POS Listener kann dadurch direkt gestartet werden.

image.png Zum Vergrößern anklicken

Kommunikation

Es gibt zwei Möglichkeiten, mit dem BE-POS Listener zu kommunizieren, direkt über den Browser oder über Microsoft Azure.

Browser

Konfiguration

  1. In das entsprechende Installationsverzeichnis navigieren und die Anwendung Beterna.Bepos.Listener.Controller.exe starten (alternativ direkt über die Desktop-Verknüpfung).

  2. In den Configurator-Reiter wechseln und ConnectionProvider auf Browser konfigurieren.

image.png Zum Vergrößern anklicken

  1. URL auf https konfigurieren.

image.png Zum Vergrößern anklicken

  1. Über Add Certificate SSL-Zertifikat erzeugen.

image.png Zum Vergrößern anklicken

Das selbst-signierte Zertifikat befindet sich unter Eigene und Vertrauenswürdige Zertifikate und ist 10 Jahre gültig.

image.png Zum Vergrößern anklicken

  1. Unter OriginHeader ist die verwendete BC-Adresse zu hinterlegen.

image.png Zum Vergrößern anklicken

Der exakte Origin-Header kann im Browser über die Entwickler-Tools (F12) des Browsers und einem Aufruf der BE-POS Listener Anwendung ermittelt werden:

image.png Zum Vergrößern anklicken

  1. Gegebenenfalls noch den SecurityKey anpassen.

image.png Zum Vergrößern anklicken

Das verwendete Kennwort muss mit dem im BC unter Geräteeinrichtung -> Listener -> Sicherheitsschlüssel hinterlegten übereinstimmen.

  1. Anschließend über Save Config die Einstellungen speichern.

image.png Zum Vergrößern anklicken

  1. Zum Schluss über Restart Listener die Anwendung BE-POS Listener neustarten und somit die getätigten Einstellungen anwenden.

image.png Zum Vergrößern anklicken

Hinweis: Sollte bei der Ansteuerung im Edge-Browser folgender Fehler auftreten: "Permission was denied for this request to access the unknown address space.":

image.png Zum Vergrößern anklicken

Dann muss der lokale Netzwerkzugriff erlaubt werden. Dazu das Schlosssymbol in der Adresszeile anklicken und den Zugriff erlauben:

image.png Zum Vergrößern anklicken

Hinweis: Sollte bei der Ansteuerung im Edge-Browser ein ERR_CERT_INVALID-Fehler auftreten, muss folgende Einstellung aktiviert werden:

image.png Zum Vergrößern anklicken

Hinweis: Sollte bei der Ansteuerung im Edge-Browser folgender Fehler auftreten: "The request client is not a secure context and the resource is in more-private address space 'local'", muss folgende Einstellung aktiviert werden:

image.png Zum Vergrößern anklicken

Test

  1. In das entsprechende Installationsverzeichnis navigieren und die Anwendung Beterna.Bepos.Listener.Controller.exe starten (alternativ direkt über die Desktop-Verknüpfung).

  2. In den Tester-Reiter wechseln.

image.png Zum Vergrößern anklicken

  1. Einen Testaufruf über Send initiieren.

image.png Zum Vergrößern anklicken

  1. Status muss SUCCESS sein.

image.png Zum Vergrößern anklicken

Azure Relay

Konfiguration

  1. In das entsprechende Installationsverzeichnis navigieren und die Anwendung Beterna.Bepos.Listener.Controller.exe starten (alternativ direkt über die Desktop-Verknüpfung).

  2. In den Configurator-Reiter wechseln und ConnectionProvider auf AzureRelay konfigurieren.

image.png Zum Vergrößern anklicken

  1. URL (endet immer mit .servicebus.windows.net), ConnectionName, SecurityKeyName und SecurityKey entsprechend der in Microsoft Azure getätigten Einrichtungen hinterlegen. Diese sind im entsprechenden Azure-Account an folgenden Stellen zu finden:

URL & ConnectionName:

image.png Zum Vergrößern anklicken

image.png Zum Vergrößern anklicken

SecurityKeyName & SecurityKey:

image.png Zum Vergrößern anklicken

  1. Zu Testzwecken unter ClientSecurityKeyName und ClientSecurityKey ebenfalls die dafür vorgesehenen Parameter eintragen.

  2. Anschließend über Save Config die Einstellungen speichern.

image.png Zum Vergrößern anklicken

  1. Zum Schluss über Restart Listener die Anwendung BE-POS Listener neustarten und somit die getätigten Einstellungen anwenden.

image.png Zum Vergrößern anklicken

Test

  1. In das entsprechende Installationsverzeichnis navigieren und die Anwendung Beterna.Bepos.Listener.Controller.exe starten (alternativ direkt über die Desktop-Verknüpfung).

  2. In den Tester-Reiter wechseln.

image.png Zum Vergrößern anklicken

  1. Einen Testaufruf über Send initiieren.

image.png Zum Vergrößern anklicken

  1. Status muss SUCCESS sein.

image.png Zum Vergrößern anklicken

Deinstallation

[Schritte 1-3 sind nur erforderlich, wenn Verbindungsart Browser verwendet wurde]

  1. In das entsprechende Installationsverzeichnis navigieren und die Anwendung Beterna.Bepos.Listener.Controller.exe starten (alternativ direkt über die Desktop-Verknüpfung).

  2. In den Configurator-Reiter wechseln.

image.png Zum Vergrößern anklicken

  1. Mittels Remove Certificate Zertifikat löschen und SSL-Port-Bindung aufheben.

image.png Zum Vergrößern anklicken

  1. Anschließend Programm BE-POS Listener deinstallieren.

image.png Zum Vergrößern anklicken