TsgcWebSocketClient | Client Authentication

O cliente TsgcWebSocket suporta 4 tipos de Autenticações:

 

• Basic: envia um Header HTTP durante o HandShake WebSocket com User e Password codificados como Basic Authentication.
• Token: envia um Token como um Cabeçalho HTTP durante o HandShake do WebSocket. Defina o token necessário em Authentication.Token.AuthToken conforme exigido pelo servidor.
• Session: primeiro o cliente solicita uma sessão HTTP do servidor e, se o servidor retornar uma sessão, ela é passada no GET HTTP Header do HandShake WebSocket. (* método de Autenticação próprio da biblioteca sgcWebSockets).
• URL: o cliente solicita autorização usando o cabeçalho HTTP GET do HandShake WebSocket. (* método de Autenticação próprio da biblioteca sgcWebSockets).

 

Authentication Basic

Este é um método de autorização simples no qual usuário e senha são codificados e passados como um Header HTTP. Basta definir o User e a Password e habilitar apenas o tipo de Authorization Basic para utilizar este método.

oClient := TsgcWebSocketClient.Create(nil);
oClient.Authentication.Enabled := true;
oClient.Authentication.Basic.Enabled := true;
oClient.Authentication.User := 'your user';
oClient.Authentication.Password := 'your password';
oClient.Authentication.Token.Enabled := false;
oClient.Authentication.URL.Enabled := false;
oClient.Authentication.Session.Enabled := false;
oClient.Active := True;

 

Token de autenticação

Permite que você autorize usando JWT. Isso exige que você obtenha um token usando uma ferramenta externa (por exemplo: uma conexão HTTP, OAuth2, etc.).

Se você anexar um componente OAuth2, pode obter este token automaticamente. Leia mais sobre OAuth2.

Você deve definir seu AuthToken e habilitar a Token Authentication.

oClient := TsgcWebSocketClient.Create(nil);
oClient.Authentication.Enabled := true;
oClient.Authentication.Token.Enabled := true;
oClient.Authentication.Token.AuthToken := 'your token';
oClient.Authentication.Basic.Enabled := false;
oClient.Authentication.URL.Enabled := false;
oClient.Authentication.Session.Enabled := false;
oClient.Active := True;

 

Sessão de Autenticação

Primeiro o cliente conecta-se ao servidor utilizando uma conexão HTTP solicitando uma nova Session. Em caso de sucesso, o servidor retorna um SessionId e o cliente envia este SessionId no GET HTTP Header do HandShake WebSocket.

Requer a definição de UserName e Password e a habilitação da Session Authentication.

oClient := TsgcWebSocketClient.Create(nil);
oClient.Authentication.Enabled := true;
oClient.Authentication.Session.Enabled := true;
oClient.Authentication.User := 'your user';
oClient.Authentication.Password := 'your password';
oClient.Authentication.Basic.Enabled := false;
oClient.Authentication.URL.Enabled := false;
oClient.Authentication.Token.Enabled := false;
oClient.Active := True;

 

Authentication URL

Este método de autenticação passa o nome de usuário e a senha no cabeçalho HTTP GET do handshake WebSocket.

 

oClient := TsgcWebSocketClient.Create(nil);
oClient.Authentication.Enabled := true;
oClient.Authentication.URL.Enabled := true;
oClient.Authentication.User := 'your user';
oClient.Authentication.Password := 'your password';
oClient.Authentication.Basic.Enabled := false;
oClient.Authentication.Session.Enabled := false;
oClient.Authentication.Token.Enabled := false;
oClient.Active := True;