TsgcWebSocketServer › Proprietà › Authentication
Abilita e configura l'autenticazione utente/password per le connessioni WebSocket e HTTP in entrata.
property Authentication: TsgcWSAuthenticationServer_Options read FAuthentication write SetAuthentication;Enabled=False
Quando Authentication.Enabled è True, il server autentica ogni connessione in ingresso rispetto all'elenco AuthUsers (formato utente=password per riga). Sono supportati tre schemi predefiniti: Session (il client esegue prima una GET HTTP, riceve un id di sessione e poi apre il WebSocket passando l'id come parametro), URL (nome utente e password vengono inviati nella query string dell'handshake WebSocket) e Basic (HTTP Basic Access Authentication — utilizzata solo da client/server VCL e richieste HTTP). L'evento OnAuthentication consente di aggiungere una propria verifica delle credenziali; OnUnknownAuthentication gestisce schemi non standard come Bearer/JWT. Utilizzare CustomHeaders per aggiungere intestazioni HTTP extra restituite in caso di errori di autenticazione.
Negotiate (Kerberos / SPNEGO, con fallback a NTLM su Windows) si configura nelle sottoproprietà di Authentication.Negotiate e richiede l'edizione Enterprise di sgcWebSockets. Negotiate.Enabled (Boolean, predefinito False) lo attiva e richiede Authentication.Enabled. Negotiate.ServicePrincipal (String) è un SPN facoltativo come HTTP/host.example.com@EXAMPLE.COM; se vuoto, viene accettata qualsiasi chiave presente nel keytab o l'account della macchina. Negotiate.Keytab (String, solo Linux) è il percorso del keytab del servizio; se vuoto, si usa KRB5_KTNAME o il valore predefinito di sistema. Il risultato viene notificato da OnNegotiateAuthentication. Vedere Autenticazione Kerberos e Negotiate.
oServer := TsgcWebSocketServer.Create(nil);
oServer.Authentication.Enabled := true;
oServer.Authentication.Basic.Enabled := true;
oServer.Authentication.AuthUsers.Add('user=secret');
oServer.Active := true;