Histórico da Página
CONTEÚDO
Informações | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
01. VISÃO GERAL
O objetivo desta tela é efetuar o cadastro dos parâmetros a serem utilizados no serviço de login com OAuth2 no qual propões duas etapas para o acesso a um determinado endpoint, a autenticação e autorização.
- A autenticação é a validação do usuário / senha, caso o mesmo seja válido, um token JWT é retornado para uso posterior.
- Com o token JWT, o mesmo deve ser enviado a cada requisição para que seja autorizado o acesso aos endpoints.
A parametrização é conforme o tipo a ser utilizado: Client Credentials ou Resource Owner Password Credentials (RO Credentials).
Dica | ||
---|---|---|
| ||
O modelo Client Credentials é utilizado em integrações que possuem acesso direto aos endpoints, no qual consideram as conexões entre máquinas, ou seja, o M2M (Machine to Machine) Comunications. Exemplo; AppServer, Mingle, Apps, entre outros Já o modelo RO Resource Owner Password Credentials é utilizado em integrações que possuem que fazem uso de navegador, com a autenticação conforme o produto TOTVS - Linha Datasul. Exemplo: Portais |
02. EXEMPLO DE UTILIZAÇÃO
Para acessar a área de Propriedades OAuth2, basta acessar a tela de Propriedades do produto pelo menu (digitando: propriedades) ou pela engrenagem na barra superior - - em seguida pesquisar no campo de busca por OAuth2 ou procurar na tela o Card Propriedades OAuth2:
03. TELA - OAuth2
A seguir é apresentada a tela de parâmetros do modelo OAuth2:
Client Credentials
b. RO Credentials
Principais Campos e Parâmetros
Informar o nome do portal.
Exemplo:
Informações | ||
---|---|---|
| ||
O ID para a o relacionamento com o método de autenticação é gerado automaticamente após o cadastro. |
Informar o método de autenticação.
Exemplo:
Informações | ||
---|---|---|
| ||
|
Informar o escopo.
Exemplo:
Informações | ||
---|---|---|
| ||
Os portais podem efetuar acesso a diversos endpoints, analisar o uso do portal com o intuito de parametrizar a melhor necessidade de utilização do escopo. A validação segue a mesma regra do modelo Client Credentials, apresentada anteriormente, |
Nota |
---|
Ao finalizar o cadastro, basta clicar em "Exibir detalhes completamente" para apresentar o ID que será utilizado no modelo de autenticação. |
Nota | ||
---|---|---|
| ||
O modelo Resource Owner Password Credentials (ROPC) não necessita ser cadastrado pois utiliza as credenciais do ERP Datasul. Para mais informações quanto a sua utilização, consulte o link: https://tdn.totvs.com/pages/releaseview.action?pageId=696121515 |