TsgcWebSocketHTTPServerGebeurtenissen › 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 OnAuthentication: TsgcWSAuthenticationEvent;
// TsgcWSAuthenticationEvent = procedure(Connection: TsgcWSConnection; aUser, aPassword: String; var Authenticated: Boolean) of object

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


procedure OnAuthentication(Connection: TsgcWSConnection; aUser, aPassword: string;
  var Authenticated: Boolean);
begin
  if ((aUser = 'user') and (aPassword = 'secret')) then
    Authenticated := True
  else
    Authenticated := False;
end;

Terug naar gebeurtenissen