Histórico da Página

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

...

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

Considere o arquivo: login.component.ts

...

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

Na sua função de login(), utilize utilizamos o método mingleService.auth.login(usuário, senha, alias)Lembrando que os dados de autenticação, usuário e senha, serão enviados para a autenticação do seu host (Protheus, Logix, Datasul, etc...)

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

export class LoginComponent implements OnInit {

 constructor(private mingleService: MingleService,
   private configService: ConfigService,
   private route: Router,
   private poNotification: PoNotificationService) { }
 
 ngOnInit(): void {}
 
 login(formulario) {
   this.mingleService.auth.login(formulario."login",
     formulario."password",
     this.configService.getAlias()"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');
     });
    }
}

No caso deste tutorial o valor do parâmetro Alias foi obtido através de um método "getAlias" que criamos no aplicativo de demonstração, mas o parâmetro pode ser passado como stringObserve 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..eyJ1c2VyX2lkIjoiNWZmZGE3YmRhYWNiMDY4NWYzNGQ1OWUyIiwic2V0X2lkIjoiNWZiZTU3MTJkOGNjYmYwMDJjZjQ0M2YzIiwiY2xpZW50X2lkIjoiNWVlYjY3ZWRlYjYyNzQwMDI5YjFmMDNmIiwiYXBwX2lkIjoiNWZiMmFlMmE1NzVhZTgwMDRhN2QxZmY1Iiwib3JpZ2luIjoibW9iaWxlIiwidXR5cGUiOiJQcm94eVVzZXIiLCJ0dHlwZSI6InIiLCJpYXQiOjE2MTA0NTkwNjksImV4cCI6MTYxMDU1OTA2OSwiYXVkIjoibWluZ2xlIiwiaXNzIjoid2VidGVzdGluZzogTGludXggeDg2XzY0In0.CO9WF84Z3LmpauISeEPyDxVn4BA3jiWlRtVo68_7av8","
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();

...