Versões comparadas

Chave

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

...

B. M.
Painel
borderColorgrey
borderStylesolid
Image Removed
Image Added  

Token API -

Implementação

Consumo de Terceiros




Painel
borderColorgrey
titleColorWhite
borderWidth1px
titleBGColor#AB0047
titleObjetivo

O que é?

  • Este documento tem como objetivo demonstrar as funcionalidades da API Login que foi desenvolvida para permitir autenticação por token nas APIs.

Quando implementar?

  • Em todo cliente que esteja na versão 08/2021 ou superior e utilize APIs.
Painel
borderColorgrey
titleColorWhite
borderWidth1 px
titleBGColor#AB0047
titleFuncionalidade
  • API Login  tem como funcionalidade gerar o token que será utilizado nas demais APIs
, foi
  • . Foi implementada para trazer mais segurança aos nossos clientes, visto que é necessário ter login no
solus
  • Solus e fazer a geração do token periodicamente.

1 - Para a autenticação por token ser utilizada o cliente tem que estar no conceito pessoa.

Estrutural > Configurações > Parametrizações do sistema

Image Removed

Obs: Agendar com o suporte a migração para o conceito pessoa, caso ainda não use.

2 - Criar a pessoa SOLUS (CNPJ) com os dados da SOLUS que será utilizado na criação do operador no passo seguinte.

Image Removed

3 - Criar o operador SOLUS que será vinculado em todas as APIs cadastradas.

Image Removed

Obs: Campo “Nome de login” é de escolha livre.

4 - Verificar se todas as APIs que a Operadora usa estão cadastradas e com as apiKey preenchidas.

Adm > Configurações > Cadastro de API’s

Image Removed

5 - Vincular o operador SOLUS em todas as APIs.

Adm > Configurações > Cadastro de API’s

Image Removed

6 - Obtendo o accessToken do usuário SOLUS.

Adm > Configurações > Cadastro de API’s

Image Removed

7 - Usararotainstallparagerarotokenprimário.

7.1 - Colar o accessToken obtido no passo anterior na aba “Body”;

Image Removed

7.2 - Na aba “authorization “ configurar a opção type para “Bearer Token“;

Image Removed

7.3 - Copiar somente o conteúdo do campo “accessToken”;

Image Removed

7.4 - Colar no campo “Token” na aba “Authorization” o conteúdo copiado no passo anterior;

Image Removed

7.5 - Podemos efetuar a requisição clicando em “Send” e assim teremos o token primário.

Image Removed

8 - Cadastrartokenretornadodarotainstallem"ConfiguraçãousoAPI-Solus".

Image Removed

em casos que terceiros consomem as APIs do Solus, precisamos seguir os passos abaixo.

Painel
borderColorgrey
titleColorWhite
borderWidth1px
titleBGColor#AB0047
titleOperacionalização

Para a implementação do token temos dois fluxos, um para atender as requisições do SOLUS e outro para fornecedores terceiros.
Necessariamente precisamos fazer primeiro o "Uso das APIs - SOLUS" para conseguirmos fazer o "Uso das APIs - Terceiros".

Expandir
titleUso das APIs - SOLUS
Expandir
titleUso das APIs - Terceiros

1 - Para a autenticação por token ser utilizada o cliente tem que estar no conceito pessoa.

Estrutural > Configurações > Parametrizações do sistema

Image Removed

Obs: Agendar com o suporte a migração para o conceito pessoa, caso ainda não use.

2 - Criar a pessoa para o fornecedor que será usada na criação do operador no passo seguinte.

Image Removed

3 - Criar o operador para o fornecedor que será vinculado nas APIs que ele utiliza.

Image RemovedImage Added

Obs: Campo “Nome de login” é de escolha livre.


4 2 - Verificar se todas as APIs que o fornecedor usa estão cadastradas e com as apiKey preenchidas.

Adm > Configurações > Cadastro de API’s

Image RemovedImage Added


5 3 - Vincular o operador nas APIs necessárias e determinar o mesmo tempo (Token expira (minutos)) acordado em cada uma delas.

Adm > Configurações > Cadastro de API’s

Image RemovedImage Added


6 4 - Obter accessToken do usuário "fornecedor".

Adm > Configurações > Cadastro de API’s

Image RemovedImage Added


7 5 - Usar a rota install para gerar o token primário.

75.1 - Colar o accessToken obtido no passo anterior na aba “Body”;

Image RemovedImage Added


75.2 - Na aba “authorization “ configurar a opção type para “Bearer Token“;

Image RemovedImage Added


75.3 - Copiar somente o conteúdo do campo “accessToken”;

Image RemovedImage Added


75.4 - Colar no campo “Token” na aba “Authorization” o conteúdo copiado no passo anterior;

Image RemovedImage Added


75.5 - Podemos efetuar a requisição clicando em “Send” e assim teremos o token primário.

Image RemovedImage Added


8 6 - Usar a rota login por usuário e senha para obter o token que será usado nas demais APIs (secundário).

86.1 - Em login e senha informar  os valores obtidos no acessToken;

Image RemovedImage Added


86.2 - Preencher o campo “Token” na aba “Authorization” com o token que obtivemos na rota install (primário);

Image RemovedImage Added


86.3 - Podemos efetuar a requisição clicando em “Send” e assim teremos o Token para uso nas demais APIs (secundário).

Image RemovedImage Added

Informações
titleInformações

Dúvidas sobre o processo de token para APIs.

  • O que fazer quando o token do fornecedor terceiro expirar?

R: Repetir Repetir o passo 8 6 do tópico para fornecedores terceiros.


  • Aonde descobrimos o tempo de validade do token?

R: No cadastro de APIs (Adm > Configurações > Cadastro de API’s) configuramos o tempo no campo "Token expira (minutos)" que é calculado por minutos e definido por usuário.

  • Porque temos uma rotina para o Solus e outra para os fornecedores terceiros?

R: Quando deixamos cadastrado o token da Solus no “Configuração uso API-Solus” a web e módulos já tem previsto na programação o processo de autenticação para obter o token secundário, e também revalidam quando expirado.


  • O que é token primário?

R: É o token usado apenas na API login, para autenticar a geração do token secundário.


  • O que é token secundário?

R: É o token usado para autenticar no uso das rotas normais.


  • O que fazer quando for adicionado uma nova API?

R: Temos que refazer o processo a partir do passo 6 4 no primeiro fluxo (SOLUS)  e também no segundo fluxo (fornecedor) caso tenha fornecedor que usará essa nova API.


  • Porque temos duas rotas para chegar no token secundário?

R: Por motivos de segurança. Caso o acesstoken usado na primeira rota (install) seja exposto após a sua utilização, não trará riscos, pois só pode ser usado uma única vez.

Aviso
titleAtenção

Documentação elaborada com base na versão vigente do sistema.



Editado por:
Bruno Moura 29 de set
B. M.
2021