TsgcWebSocketServer_HTTPAPIEigenschappen › Authentication

Authentication Eigenschap

Enables and configures user/password authenticatie for inkomend WebSocket and HTTP requests.

Syntaxis

__property TsgcWSAuthenticationServer_Options * Authentication;

Standaardwaarde

Enabled=False

Opmerkingen

Wanneer Authentication.Enabled True is, authenticeert de server elke inkomende verbinding tegen de AuthUsers-lijst (formaat gebruiker=wachtwoord per regel). Drie ingebouwde schema's worden ondersteund: Session (client doet eerst een HTTP GET, ontvangt een sessie-ID en opent vervolgens de WebSocket met de ID als parameter), URL (gebruikersnaam en wachtwoord worden verzonden in de querytekenreeks van de WebSocket-handshake) en Basic (HTTP Basic Access Authenticatie — alleen gebruikt door VCL-clients/servers en HTTP-verzoeken). De OnAuthentication-gebeurtenis laat u uw eigen credentialcontrole inpluggen; OnUnknownAuthentication verwerkt niet-standaard schema's zoals Bearer/JWT. Gebruik CustomHeaders om extra HTTP-headers toe te voegen die worden geretourneerd bij authenticatiefouten.

Voorbeeld


oServer = new TsgcWebSocketServer_HTTPAPI(NULL);
oServer->Authentication->Enabled = true;
oServer->Authentication->Basic->Enabled = true;
oServer->Authentication->AuthUsers->Add("user=secret");
oServer->Active = true;

Terug naar Properties