| Linha de Produto: | Datasul |
|---|
| Segmento: | Tecnologia |
|---|
| Módulo: | Framework |
|---|
| Função: | APIs |
|---|
| Ticket: | DFWKTOOLS-2307 |
|---|
Ao efetuar uma requisição diferente de GET (POST, PUT, DELETE) em contextos onde 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 destino.
Foi desenvolvido um endpoint para realizar a autenticação de usuário no produto Datasul e retornar seus respectivos tokens para acesso posterior.
...
| Totvs custom tabs box |
|---|
| tabs | Passo 01, Passo 02, Passo 03, Passo 04 |
|---|
| ids | passo1,passo2,passo3 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
|
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 |
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
|
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.
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
|
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. |
|
|
| Card documentos |
|---|
| Informacao | Para a utilização desta funcionalidade é necessária a atualização do artefato <b>datasul-sso-ear-[VERSAO]-SNAPSHOT.ear</b> |
|---|
| Titulo | IMPORTANTE! |
|---|
|
...
