Zum Inhalt

Fix: Salto Local IO Bridge — Port 8102 Freigabe

Datum: 19. Februar 2026 Server: Salto-Server (10.128.40.6) Betrifft: SALTO ProAccess Space 6.12.2.3

Problembeschreibung

Nach der Restrukturierung der Serverlandschaft (Migration auf den neuen Windows Server 10.128.40.6) funktionierte die Salto Local IO Bridge nicht mehr. PPD (Portable Programming Device) und Keylaser konnten von Client-PCs aus nicht über den Browser bedient werden.

Symptom

  • Salto Web-Interface (http://10.128.40.6:8100) war vom Client erreichbar
  • Local IO Bridge auf dem Client konnte keine Verbindung zum Server aufbauen
  • PPD und Keylaser wurden vom Browser nicht erkannt
  • Workaround im Einsatz: USB Network Gate (Electronic Team, Inc.) für USB-over-Network auf Client und Server; Benutzer musste sich per RDP auf den Server anmelden, um Salto zu bedienen

Architektur der Local IO Bridge

┌─────────────────────────────────────────────┐
│ CLIENT-PC                                   │
│                                             │
│  Browser ──HTTP──→ http://Server:8100       │  ← Web-Interface (funktionierte)
│     ↕                                       │
│  localhost:50000-51000                       │
│     ↕                                       │
│  Local IO Bridge Service                    │
│     ↕                    ↕                  │
│  USB-Port          TCP──→ Server:8102       │  ← WebSocket (BLOCKIERT)
│     ↕                                       │
│  PPD / Keylaser                             │
└─────────────────────────────────────────────┘

┌─────────────────────────────────────────────┐
│ SERVER (10.128.40.6)                        │
│                                             │
│  ProAccess Space Service                    │
│     ├── Port 8100 (Web-Frontend)    ✓ offen │
│     ├── Port 8102 (WebSocket/Bridge) ✗ ZU   │  ← URSACHE
│     └── Port 8099 (SOAP)                    │
└─────────────────────────────────────────────┘

Die Local IO Bridge auf dem Client baut zwei Verbindungen auf: 1. Lokal: Browser ↔ Bridge über localhost:50000-51000 (funktioniert immer) 2. Remote: Bridge ↔ Server über TCP Port 8102 (war blockiert)

Ohne die Verbindung auf Port 8102 kann die Bridge keine USB-Geräte-Daten an den Server übermitteln.

Ursache

Die Windows Firewall auf dem Server hatte keine eingehende Regel für Port 8102 (TCP).

Bei der Einrichtung des Servers wurde nur eine Firewall-Regel für den Web-Zugang erstellt:

Regel Port Status
"salto web" 8100/TCP ✓ Vorhanden
(fehlte) 8102/TCP ✗ Nicht vorhanden

Der Salto-Dienst (ProAccessSpaceService.exe, PID 11432) lauschte korrekt auf Port 8102, aber eingehende Verbindungen von Clients wurden von der Windows Firewall verworfen.

Nachweis

Port-Scan von extern vor der Änderung:

Port 8100: OFFEN    (Salto Web-Interface)
Port 8102: GESCHLOSSEN (WebSocket/Local IO Bridge)

Salto-Konfiguration (C:\SALTO\ProAccess Space\conf\service.ini):

[Web]
WebPortsEnabled=1
SaltoAuthPort=8100
SaltoAuthPortEnabled=1
WebSocketPort=8102       ← konfiguriert und aktiv

Durchgeführte Änderung

Firewall-Regel hinzugefügt

Befehl:

netsh advfirewall firewall add rule name="Salto WebSocket Bridge (Port 8102)" dir=in action=allow protocol=TCP localport=8102 profile=domain,private

Ergebnis:

Regelname:    Salto WebSocket Bridge (Port 8102)
Aktiviert:    Ja
Richtung:     Eingehend
Profile:      Domäne, Privat
Protokoll:    TCP
Lokaler Port: 8102
Aktion:       Zulassen

Verifizierung

Port-Scan von extern nach der Änderung:

Port 8100: OFFEN    (Salto Web-Interface)
Port 8102: OFFEN    (WebSocket/Local IO Bridge) ← BEHOBEN

Test — Erfolgreich

Getestet am 19.02.2026:

  1. Browser auf Client-PC → http://10.128.40.6:8100 → Salto Web-Interface erreichbar
  2. Local IO Bridge auf Client neu gestartet (System Tray → Stop/Start Service)
  3. PPD per USB am Client angeschlossen → wird im Browser erkannt
  4. Türkonfiguration über PPD erfolgreich übertragen

Ergebnis: Local IO Bridge funktioniert wieder vollständig. Der direkte Zugriff auf PPD und Keylaser über den Browser ist wiederhergestellt.

Aufräumen des Workarounds

Bisheriger Workaround

Als Übergangslösung war USB Network Gate (Electronic Team, Inc.) auf Client und Server im Einsatz. Diese Software leitet USB-Geräte über das Netzwerk weiter und ermöglichte die PPD/Keylaser-Nutzung, allerdings nur über eine RDP-Sitzung auf dem Server.

Auf dem Server laufen noch folgende Dienste für den nicht mehr benötigten Workaround:

Dienst Software Funktion
flexihub Electronic Team FlexiHub USB-over-Network Management
UsbService Electronic Team USB Network Gate USB-Geräte-Sharing Server
hhdvusbsrv HHD Virtual USB Tools Server USB-Virtualisierung
hhdvusbcli HHD Virtual USB Tools Client USB-Virtualisierung

Empfehlung

  • USB Network Gate und FlexiHub können auf Server und Client deinstalliert werden
  • Die USB Network Gate Lizenz (Electronic Team, Inc.) kann ggf. für macOS umgewidmet werden (Plattformwechsel über Electronic Team Support: support@electronic.us)
  • HHD Virtual USB Tools können ebenfalls entfernt werden

Zusätzliche Ports (falls benötigt)

Falls Salto-IP-Geräte (Online-Türcontroller, Gateways) im Einsatz sind, müssen ggf. weitere Ports freigegeben werden:

Port Protokoll Funktion
8099 TCP SOAP (Grafik-Mapping)
1100 UDP Gateways/Controller v1
4433 UDP Encoder v2
5001-10000 UDP IP-Peripherie-Kommunikation

Erstellt: 19.02.2026