TsgcWebSocketServer › Événements › OnSSLALPNSelect

OnSSLALPNSelect Événement

Déclenché lors d'un handshake ALPN activé afin que l'application puisse choisir le protocole à négocier.

Syntaxe

property OnSSLALPNSelect: TsgcWSOnSSLALPNSelect;
// TsgcWSOnSSLALPNSelect = procedure(Sender: TObject; aProtocols: TStringList; var aProtocol: String) of object

Valeur par défaut

—

Remarques

Lorsqu'un client annonce la négociation de protocole de couche applicative (ALPN) lors de la négociation TLS, OnSSLALPNSelect est déclenché pour que le serveur puisse décider quel protocole négocier. Le paramètre aProtocols est une TStringList avec les noms annoncés par le client (par exemple « h2 », « http/1.1 ») ; assigner aProtocol à celui que le serveur souhaite utiliser. Renvoyer une chaîne vide laisse le comportement par défaut en place, auquel cas la couche TLS choisit le premier protocole annoncé pris en charge par le serveur.

Exemple

procedure OnSSLALPNSelect(Sender: TObject; aProtocols: TStringList;
  var aProtocol: String);
begin
  if aProtocols.IndexOf('h2') >= 0 then
    aProtocol := 'h2'
  else
    aProtocol := 'http/1.1';
end;

Retour aux événements