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, POST, PUT 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
Para a utilização desta funcionalidade é necessária a atualização do artefato <b>datasul-sso-ear-[VERSAO]-SNAPSHOT.ear</b>IMPORTANTE!