Histórico da Página
...
- Realize uma requisição POST ao endpoint http(s)://{dominio}:{porta}/api/connect/token/ via Postman, SoapUi, ou outro programa que realize requisições HTTP REST.
- No corpo da requisição envie um JSON explicitando usuário e senha do RM para qual a autenticação está sendo direcionada:
• username
• password
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
curl -X POST --location 'http://localhost:8051/api/connect/token' --header 'Content-Type: application/json' --data '{"grant_type": "password","username": "mestre","password": "totvs"}' |
A requisição deve parecer com a abaixo
...
Informações | ||
---|---|---|
| ||
Caso o ambiente esteja configurado com multitenancy e a "subdomainMask" seja diferente da URL, o token não será gerado. |
Duração do Token
A duração do token de acesso pode ser visualizada na resposta da API de geração de token. Sua duração padrão é de 5 minutos, e pode ser alterada, através da tag JWTTokenExpireMinutes, que pode ser inserida no RM.Host.exe.config, podendo ser configurada entre 1 e 43200 minutos (30 dias).
Já o refresh token tem a duração padrão de 16 horas, e também pode ser alterada, mas através da tag JWTRefreshTokenExpireMinutes, podendo ser configurada entre 1 e 129600 minutos (90 dias).
Nota |
---|
A alteração da duração do token somente está disponível no RM a partir da versão 12.1.2310. |
Renovação do Token
Exemplo de utilização - Sucesso:
...