TsgcWebSocketHTTPServerÉvénements › OnUnknownAuthentication

OnUnknownAuthentication Événement

Se déclenche lorsque l'authentification est activée et que la méthode d'authentification n'est pas reconnue par le serveur.

Syntaxe

property OnUnknownAuthentication: TsgcWSUnknownAuthenticationEvent;
// TsgcWSUnknownAuthenticationEvent = procedure(Connection: TsgcWSConnection; AuthType, AuthData: String; var aUser, aPassword: String; var Authenticated: Boolean) of object

Valeur par défaut

Remarques

OnUnknownAuthentication est déclenché lorsque le client présente un en-tête Authorization qui ne correspond à aucun des schémas intégrés (Basic, Session, URL), par exemple un jeton JWT Bearer ou un schéma personnalisé. Le paramètre AuthType contient le nom du schéma et AuthData contient les informations d'identification brutes envoyées par le client ; l'application peut les analyser, renseigner les paramètres de sortie aUser et aPassword (afin que la session soit étiquetée avec un nom d'utilisateur) et enfin définir Authenticated à True pour accepter la connexion ou à False pour la rejeter. S'applique aux mises à niveau WebSocket et aux requêtes HTTP lorsque Authentication.Enabled est True.

Exemple


procedure OnUnknownAuthentication(Connection: TsgcWSConnection; AuthType, AuthData: string;
  var aUser, aPassword: string; var Authenticated: Boolean);
begin
  if AuthType = 'Bearer' then
  begin
    if AuthData = 'jwt_token' then
      Authenticated := True
    else
      Authenticated := False;
  end
  else
    Authenticated := False;
end;

Retour aux événements