TsgcHTTPServer › Eigenschaften › Authentication

Authentication Eigenschaft

Aktiviert und konfiguriert die Benutzer-/Passwort-Authentifizierung für eingehende HTTP-Verbindungen.

Syntax

property Authentication: TsgcWSAuthenticationServer_Options read FAuthentication write SetAuthentication;

Standardwert

Enabled=False

Hinweise

Wenn Authentication.Enabled auf True gesetzt ist, authentifiziert der Server jede eingehende Verbindung gegen die AuthUsers-Liste (Format user=password pro Zeile) mit dem Schema Basic (HTTP Basic Access Authentication). Die auf TsgcWebSocketHTTPServer dokumentierten Schemata Session und URL hängen die Anmeldeinformationen an den WebSocket-Handshake an und haben auf TsgcHTTPServer keine Wirkung, da diese Komponente niemals ein Upgrade einer Verbindung durchführt. Mit dem Ereignis OnAuthentication können Sie Ihre eigene Anmeldeinformationsprüfung einbinden; OnUnknownAuthentication behandelt nicht standardmäßige Schemata wie Bearer/JWT/OAuth2/WebAuthn. Verwenden Sie CustomHeaders, um zusätzliche HTTP-Header hinzuzufügen, die bei Authentifizierungsfehlern zurückgegeben werden.

Beispiel


oServer := TsgcHTTPServer.Create(nil);
oServer.Authentication.Enabled := true;
oServer.Authentication.Basic.Enabled := true;
oServer.Authentication.AuthUsers.Add('user=secret');
oServer.Active := true;

Zurück zu Properties