TsgcWebSocketHTTPServer › Gebeurtenissen › OnAuthentication

OnAuthentication Gebeurtenis

Wordt geactiveerd wanneer authenticatie is ingeschakeld zodat de toepassing de gebruiker en het wachtwoord kan controleren en de verbinding kan accepteren of weigeren.

Syntaxis

__property TsgcWSAuthenticationEvent OnAuthentication;
// typedef void __fastcall (__closure *TsgcWSAuthenticationEvent)(TsgcWSConnection * Connection, UnicodeString aUser, UnicodeString aPassword, bool &Authenticated);

Standaardwaarde

—

Opmerkingen

OnAuthentication wordt gegenereerd elke keer dat de server een authenticatieverzoek van een client ontvangt, op voorwaarde dat Authentication.Enabled True is en de authenticatiemethode een van de ingebouwde schema's is (Basic, Session, URL). De parameters aUser en aPassword bevatten de referenties die door de client zijn opgegeven; stel Authenticated in op True om de verbinding te accepteren of op False om deze te weigeren. Wanneer de referenties hier niet worden gevalideerd, wordt de ingebouwde AuthUsers-lijst gebruikt als terugvaloptie. Voor aangepaste schema's die niet worden herkend door de component (bijvoorbeeld JWT Bearer-tokens) gebruikt u OnUnknownAuthentication in plaats daarvan. De gebeurtenis is van toepassing op zowel WebSocket-upgrades als gewone HTTP-verzoeken.

Voorbeeld

void OnAuthentication(TsgcWSConnection *Connection, string aUser, string aPassword,
  bool &Authenticated)
{
  if ((aUser == "user") && (aPassword == "secret"))
    Authenticated = true;
  else
    Authenticated = false;
}

Terug naar Events