4- Autenticação

Agora que você já conhece o pacote Mingle e sua configuração inicial já está funcionando, vamos utilizar o MingleService para realizar a autenticação do usuário ao backend do cliente ( Protheus, Datasul, Logix, Smart).

Pré requisitos: 

• Usuário e senha de autenticação do backend
• ALIAS

Considere o arquivo: login.component.ts

Importe a classe MingleService

import { MingleService } from '@totvs/mingle';

Na função login(), utilizamos o método mingleService.auth.login(usuário, senha, alias).

import { MingleService } from '@totvs/mingle';

export class LoginComponent implements OnInit {

 constructor(private mingleService: MingleService) { }
 
 ngOnInit(): void {}
 
 login() {
   this.mingleService.auth.login("login",
     "password",
     "alias")
     .subscribe((dataLogin) => {
       console.log("Login com sucesso - dados do login", dataLogin);
      
       this.route.navigate(['home']);
     }, (authError) => {
       console.log(authError);
       console.error('Falha na autenticação');
     });
    }
}

Observe que os valores "login" e "password" geralmente são preenchidos pelo usuário do aplicativo através de uma página de autenticação.

Após executar o Login no aplicativo, o retorno de sucesso será parecido com este: 

{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9Mug...",
"muser":{"_id":"5ffda7bdaacb0685f34d59e2","login":"exemplo"},
"set":{"_id":"5fbe5712d8ccbf002cf443f3","alias":"TOTVS"},
"params_values":[{"_id":"5fbe5712d8ccbf002cf443f2","key":"EMPRESA","value":"123"}],
"client":{"_id":"5eeb67edeb62740029b1f03f","name":"TOTVS_TDN"},
"wso2":{},
"refresh_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoi...","
auth_driver":"protheus"}

A chave access_token é armazenada no storage do navegador pelo mingleService para ser utilizada em outras etapas do aplicativo que requerem comprovação de autenticação, como por exemplo uma chamada de gateway. O access_token tem um prazo de validade de acordo com cada ambiente e requer uma nova autenticação quando expirar. 

Quando se utiliza um access_token expirado, o Mingle retornará para o aplicativo o status 401 do protocolo HTTP.

O desenvolvedor pode seguir dois caminhos para obter um novo access_token:

1- Solicitar ao usuário do aplicativo um novo login.

2- Utilizar a chave refresh_token obtida no login inicial e realizar uma autenticação transparente para o usuário, sem que ele tenha que realizar login novamente. 

Refresh Token

Para obter os dados de autenticação atualizados, você pode utilizar o serviço Refresh Token do Mingle.

Considere o código de exemplo abaixo:

 refreshToken(){
    const bodyRefreshToken = this.mingleService.getBodyToRefreshTokenAPI();
    const urlRefreshTOken = this.mingleService.getRefreshTokenURL();
    
    this.http.post(urlRefreshTOken, bodyRefreshToken).subscribe(resultAuth => console.log(resultAuth))
  }

O MingleService prepara o body que deve ser enviado para o serviço Refresh Token através do método mingleService.getBodyToRefreshTokenAPI();

Logo após obter o body que deve ser enviado para o Mingle, obtenha a URL do serviço através do método mingleService.getRefreshTokenURL();

E para obter os novos dados de autenticação, realize um POST com os parâmetros encontrados anteriormente. 

LOGOUT

Para realizar o logout utilize o nosso método mingleService.auth.logout();

this.mingleService.auth.logout().subscribe(() => {
     console.log("Usuário deslogado");
     this.route.navigate(['login']);
})