Dimensa Core Banking

Árvore de páginas

Versões comparadas

Versão antiga 6

changes.mady.by.user Rafael Rabassa Silveira

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Heber Davi Salcedo Rodrigues

Gravado em

Chave

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

As suítes de serviços dos produtos financial services TOTVS utilizam para autenticação o protocolo Oauth 2.0. Possuir uma aplicação cliente configurada bem como o tipo de autenticação que será utilizada são pré requisitos para a utilização. Esta configuração prévia é pré-requisito para utilização desta documentação, caso ainda não realizada, clique aqui para ver a documentação de como proceder.

 

O processo de autenticação consiste em um requisição rest para o servidor de autenticação passando parâmetros pré-definidos conforme descrito abaixo. O endereço da aplicação para autenticação sempre seguirá o padrão http://SERVIDOR:PORTA/suite_serviço_utizada/oauth/token, onde SERVIDOR deve ser substituído pelo endereço do servidor JBoss, PORTA pelo número da porta do servidor JBoss e suite_serviço_utizada pelo nome da aplicação contendo os serviços que serão consumidos. Abaixo exemplo de uma URL:

http://192.168.10.10:8080/tfs-credito-service/oauth/token

 

Os parâmetros abaixo devem ser informados em todos os tipos de requisição de autenticação

Para cada grant type selecionado os parâmetros enviados, assim como o retorno, podem sofrer modificações, o quadro abaixo detalha cada um deles.

Deck of Cards
startHiddenfalse
idAutenticações permitidas
Card
labelAutenticação para Usuário

Retorna tokens de acesso e refresh para um usuário e senha informados. Usuário e senha necessitam estar, previamente, cadastrados no sistema de segurança TOTVS.

Para obter o token de acesso utilizando este tipo de autenticação, utilizar os parâmetros e valores abaixo:

grant_type=password

username=USUÁRIO

password=SENHA

Image Added

A figura acima apresenta a requisição e a resposta de um pedido de autorização utilizando o grant_type password.

Card
labelAutenticação para cliente

Para obter autenticação para uma aplicação cliente informar o tipo de grant client_credentials, conforme exemplificado abaixo. Este tipo de tipo de autenticação retorna apenas o token de acesso.

grant_type=client_credentials

Image Added

A figura acima apresenta a requisição e a resposta de um pedido de autorização utilizando o grant_type client_credentials.

Card
labelAtualização Token

Para renovar a autorização e obter um novo token de acesso, a partir de um token de atualização (refresh token). Abaixo detalhes de utilização.

grant_type=refresh_token

refresh_token= REFRESH TOKEN retornado em uma requisição anterior do tipo PASSWORD ou REFRESH_TOKEN.

Image Added]

A figura acima apresenta a requisição e a resposta de um pedido de autorização utilizando o refresh_token.

Para os exemplos de requisição acima foi utilizado o plugin DHC do navegador Chrome.

O token de acesso, retornado de uma das requisições descritas acima, deve ser informado no HEADER, através do parâmetro Authorization, ao consumir os serviços da suite de crédito seguindo os procedimentos descritos abaixo.

Nome do Parâmetro - Authorization

Valor - informar o tipo do token, também retornado na resposta a requisição, mais o valor do token de acesso separados por espaço. Exemplo: 

Image Removed

 

 

Depois de receber o token

Para cada requisição, devemos passar um parâmetro no HEADER:

Nome do parâmetro: Authorization

Valor:  [{token_type} {refre}]

Exemplo (conforme imagem acima):

Authorization=[bearer cf7e583d-0ed7-4ade-a88d-e6aac3dd54ff] e6aac3dd54f

A imagem abaixo destaca a utilização do parâmetro na ferramenta SoapUI, ferramenta está utilizada para consumo de web services em ambientes de desenvolvimento e teste.

Image Modified