Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


01. DADOS GERAIS

Produto:

Solucoes_totvs
SolucaoTOTVS Logística Recintos Aduaneiros

Solucoes_totvs_cross
SolucaoCross

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVS

Linha de Produto:

Linhas_totvs
SegmentoDistribuição
RegionConstrução Projetos
LinhaLinha Logix

Segmento:

Segmentos_totvs
SegmentoLogística

Módulo:Serviço de autenticação OAuth2
Função:Serviço de autenticação OAuth2
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :
  1. DLOGPORTOS-15862
  2. DLOGPORTOS-16153


02. SITUAÇÃO/REQUISITO

Para atendimento da demanda de autenticação, para o produto TOTVS Recintos Aduaneiros, através do protocolo OAuth2 foi estabelecida a componentização da classe de login a ser realizado na aplicação.

03. SOLUÇÃO

A classe depende do componente de conexão desenvolvido para o processo de login sob o protocolo OAuth2.

Totvs custom tabs box
tabsMétodos exportados,Exemplos de uso,Tabela de erros
idsmetodos,exemplos,tabelaerros
Totvs custom tabs box items
defaultyes
referenciametodos

São métodos exportados pela classe:

  • doLogin(usuario, senha, clientID, clientSecret)
Totvs custom tabs box items
defaultno
referenciaexemplos

Para utilização da classe em aplicações Node.JS, seguem exemplos de uso deste componente.


Execução da ação de login:

Bloco de código
languagejs
titleExecução da ação de login
console.log('Performing login action...');
let login = require('./components/login');
let user = '00000000191';
let password = 'User@1234567';
let clientID = 'de3af1da1717b2c768aadbcae8b94f33';
let clientSecret = '0c02d8b3073e519a363f675497a8d943';
console.log('User: %s', user);
console.log('Password: %s', password);
console.log('Client ID: %s', clientID);
console.log('Client Secret: %s', clientSecret);
login.doLogin(user, password, clientID, clientSecret).then(result => {
    console.log(result);
});

Resultado esperado:

Bloco de código
languagejs
titleResultado esperado
{
  codigo: 1,
  login: true,
  alterarSenha: true,
  clientID: true,
  clientSecret: true
}

Os valores dos campos login, alterarSenha, clientID e clientSecret são do tipo boolean indicando, respectivamente, sucesso na ação de login, se o usuário deve alterar sua senha, se o valor de Client ID fornecido está correto e se o valor de Client Secret fornecido está correto.

Totvs custom tabs box items
defaultno
referenciatabelaerros

O campo código, no objeto de retorno, indica um possível erro no processamento do evento de login, segundo a seguinte tabela:

CódigoConstanteMensagem
0x0000RESULT_OKProcessamento sem falhas.
0x0001CHANGE_PASSWORDProcessamento sem falhas, mas usuário deve alterar a sua senha.
0x0002

LOGIN_FAIL

Falha no processamento do login (usuário ou senha inválidos).
0x0004CLIENT_ID_FAILClient ID fornecido difere do valor parametrizado na aplicação.
0x0008CLIENT_SECRET_FAILClient Secret fornecido difere do valor parametrizado na aplicação.


04. DEMAIS INFORMAÇÕES

Por ser dependente do componente de conexão com o banco de dados, este também deve estar presente no projeto ao ser utilizado.

05. ASSUNTOS RELACIONADOS

...