Linha Datasul

Árvore de páginas

Matriz de Evolução

Versão/ReleaseFuncionalidade
12.1.31
  • Liberação da geração do Token JWT para utilização em licenciamento.

Configuração

A partir da release 12.1.31, foi implementado no produto TOTVS Datasul a geração de um Token JWT que pode ser utilizado para efetuar o controle de licenças por aplicativos, sem ter a necessidade de utilizar um Gateway (exemplo: Mingle). 

Para isto, não é necessário efetuar configurações adicionais pois os endpoints estão disponibilizados nativamente no produto.

Funcionamento

A seguir, são apresentados os conceitos de requisição com a utilização do Postman, no qual devem ser adaptadas de acordo com a tecnologia desejada:

Passo 1

Criar uma requisição POST para /api/accesskey, com um usuário e senha do produto TOTVS Datasul (Basic Auth).

Dica

O endpoint de geração do Token JWT também está disponível em /dts/datasul-rest/resources/prg/accesskey

Passo 2

Enviar no corpo da requisição um objeto Json que contém a estrutura abaixo:

Body
{
    "issuer": "datasul",
    "nome-app": "appTeste",
    "x-totvs-app": "111"
}

AtributoValor
issuerdatasul (valor fixo, necessário para identificar que é um Token JWT utilizado para licenciamento).
nome-appNome do aplicativo
x-totvs-appCódigo do aplicativo a ser enviado para o License Server.

Passo 3

Resgatar o Token JWT que será retornado no corpo da resposta.

Passo 4

Enviar o Token JWT gerado no passo anterior como parâmetro (x-totvs-appcode) na Header para o endpoint desejado:

Nota

Caso o atributo x-totvs-appcode não seja enviado ou possuir falhas na sua decodificação (Token expirado ou chave inválida), o código da licença a ser consumida ficará de responsabilidade do License TOTVS I

Documentos relacionados