Skip to main content

​
Autenticação

A API do Promete utiliza autenticação baseada em tokens JWT (JSON Web Tokens) para garantir que apenas usuários autorizados acessem os recursos do sistema.

​
Fluxo de Autenticação

1

Login

O cliente envia credenciais (email e senha) para o endpoint de autenticação.
2

Token

O servidor valida as credenciais e retorna um par de tokens (access token e refresh token).
3

Requisições

O cliente inclui o access token no header Authorization de todas as requisições subsequentes.
4

Renovação

Quando o access token expira, o cliente utiliza o refresh token para obter um novo par de tokens.

​
Headers

Authorization: Bearer <access_token>
Content-Type: application/json

​
Controle de Acesso (RBAC)

O sistema implementa controle de acesso baseado em perfis (Role-Based Access Control). Cada endpoint possui permissões específicas associadas aos perfis de usuário:
PerfilPermissões
adminAcesso total a todos os recursos
political_agentLeitura completa, escrita em comunicação e prometrômetro
advisorLeitura e escrita em gabinete, relacionamento e comunicação
viewerApenas leitura em dashboards e relatórios
Os perfis e permissões detalhados serão definidos durante o desenvolvimento. A tabela acima é uma proposta inicial.