TsgcWebSocketServer › É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 pas à l'un des schémas intégrés (Basic, Session, URL), par exemple un jeton Bearer JWT 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.

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