TsgcWebSocketProxyServer › Eigenschaften › Authentication

Authentication Eigenschaft

Aktiviert und konfiguriert die Benutzer-/Passwort-Authentifizierung für eingehende WebSocket-Clients, die sich mit dem Proxy verbinden.

Syntax

property Authentication: TsgcWSAuthenticationServer_Options read FAuthentication write SetAuthentication;

Standardwert

Enabled=False

Hinweise

Wenn Authentication.Enabled auf True gesetzt ist, authentifiziert der Proxy jede eingehende nachgelagerte Verbindung gegen die AuthUsers-Liste (Format user=password pro Zeile), bevor er den passenden Link zum vorgelagerten Server öffnet, der in Proxy definiert ist. Drei integrierte Schemata werden unterstützt: Session (der Client führt zuerst ein HTTP-GET aus, empfängt eine Session-ID und öffnet dann den WebSocket unter Übergabe der ID als Parameter), URL (Benutzername und Passwort werden im Query-String des WebSocket-Handshakes gesendet) und Basic (HTTP Basic Access Authentication). Das Ereignis OnAuthentication ermöglicht es Ihnen, Ihre eigene Anmeldedatenprüfung einzubinden; OnUnknownAuthentication behandelt nicht standardmäßige Schemata wie Bearer/JWT. Die Authentifizierung wird nur auf der nachgelagerten Seite durchgeführt; der Proxy leitet Anmeldedaten nicht automatisch an den vorgelagerten Server weiter.

Beispiel


oProxy := TsgcWebSocketProxyServer.Create(nil);
oProxy.Authentication.Enabled := true;
oProxy.Authentication.Basic.Enabled := true;
oProxy.Authentication.AuthUsers.Add('user=secret');
oProxy.Proxy.Host := 'upstream.example.com';
oProxy.Proxy.Port := 8080;
oProxy.Active := true;

Zurück zu Properties