Árvore de páginas


01. DADOS GERAIS

Linha de Produto:Datasul
Segmento:Tecnologia
Módulo:Framework
Função:APIs
Ticket:DFWKTOOLS-2307


02. SITUAÇÃO/REQUISITO

Ao efetuar uma requisição de tipo diferente de GET, ou seja, POSTPUT ou DELETE em contextos que ainda não tenham usuário do produto autenticado, em algumas situações, ocorrem inconsistências no redirecionamento entre a autenticação Josso e o endpoint de destino.

03. SOLUÇÃO

Foi desenvolvido um endpoint para realizar a autenticação de usuário no produto Datasul e retornar seus respectivos tokens para acesso posterior.



Efetuar uma requisição GET à URL http://[SERVIDOR]:[PORTA]/josso/signon/auth.do com a "Header Autorization" configurada para autenticação do tipo Basic, informando um usuário e senha válidos no produto Datasul.


Dica

O formato padrão para o envio das informações em Header Autorization Basic é [usuario]:[senha] convertido em base64.

Exemplo:

     [usuario]:[senha] → super:super@123

     Header Value     → Basic c3VwZXI6c3VwZXJAMTIz


Caso o usuário seja autenticado com sucesso no produto Datasul, no resultado desta requisição REST retornará, além do STATUS de retorno HTTP com o código 200, o valor da chave JOSSO_SESSIONID para ser utilizado em outras requisições REST de acesso ao sistema, enquanto esta sessão (JOSSO_SESSIONID) for válida no sistema.



Efetuar a requisição ao endpoint desejado juntamente com um parâmetro na sessão HEADERS nomeado como cookie preenchido com o valor do JOSSO_SESSIONID que é o TOKEN de acesso do usuário do produto recuperado na requisição anterior.



Dica

Como a autenticação já foi realizada na requisição anterior, não é necessário enviá-la novamente em Header Autorization.


04. DEMAIS INFORMAÇÕES

IMPORTANTE!

Para a utilização desta funcionalidade é necessária a atualização do artefato <b>datasul-sso-ear-[VERSAO]-SNAPSHOT.ear</b>