Autenticação por Login (usuário + senha → token)
Auth não-OAuth pra APIs próprias: o Lefia faz login (POST usuário+senha), recebe um token no corpo e passa a mandá-lo como Bearer. Configurável no form REST.
Autenticação por Login (usuário + senha → token)
Auth não-OAuth pra APIs próprias/custom que expõem um endpoint de login: o Lefia faz um POST com
{usuário, senha}, recebe um token no corpo da resposta e passa a mandá-lo como Authorization: Bearer <token> nas chamadas seguintes.Quando usar
- API própria do cliente (PHP/Laravel, Node/Express) com rota tipo
/auth/login - APIs que não falam OAuth mas devolvem um token (JWT ou opaco) no login
- Ambientes de dev atrás de túnel (ngrok/Cloudflare) com login simples
Como configurar
No form de conexão, em REST, escolha
Autenticação = Login (user+password) e preencha:| Campo | Exemplo |
|---|---|
| Login URL | https://api.parceiro.com/auth/login |
| Usuário | svc_user |
| Senha | •••••••• (criptografado) |
| Campo do usuário (avançado) | username (padrão) — troque se a API espera user, email, etc. |
| Caminho do token (avançado) | vazio = auto-detecta token/access_token/jwt; use se vier aninhado, ex.: data.access_token |
O Lefia gerencia o token automaticamente:
- Primeira chamada → POST no Login URL com
{<campo do usuário>: usuário, password: senha}. - Token extraído do corpo (auto-detecção ou pelo Caminho do token informado).
- Token criptografado e cacheado em
oauth_tokenspor connection. - Próximas chamadas reusam; renova via novo login quando necessário.
O login pode devolver um objeto (
{"token": …}) ou o próprio token como texto (a API do Meu Cliente declara string): os dois funcionam sem configurar o Caminho do token. Sem expires_in na resposta, a validade vem do exp do JWT. Token opaco (sem expires_in nem JWT com exp): preencha Validade fixa do token (segundos); sem ela, vale 1 hora. Se o destino recusar o token com 401 antes disso, o Lefia faz o login de novo e reenvia uma vez.Dicas de troubleshooting
- 401 com "Authorization obrigatório" → a conexão não está mandando token; confirme que salvou este tipo de auth.
- 403 → o token está indo mas é rejeitado (inválido/expirado); confira usuário/senha e validade.
- Token aninhado no JSON → use Caminho do token (ex.:
data.token).
Tickets relacionados
- #664 implementação do connector, #671 exposição no formulário.
Histórico de versões
- 1.1.0
Login por usuário e senha: campo "Validade fixa do token (segundos)" para a API que devolve um token opaco, sem expires_in nem JWT com exp. A validade passa a ser, nesta ordem: o expires_in da resposta, o exp do JWT, a validade fixa da conexão e, sem nenhum, 1 hora.
08/10/2026 · updated
- 1.0.1
O login por usuário e senha agora aceita a API que devolve o token como texto (puro ou entre aspas), como o Meu Cliente declara, além do objeto com o campo token. Sem expires_in na resposta, a validade do token vem do próprio JWT (antes valia 1 hora mesmo que o token durasse 15 minutos). Quando o destino recusa o token com 401 antes do vencimento, o Lefia faz o login de novo e reenvia uma vez, no envio e na consulta de confirmação.
08/10/2026 · updated
- 1.0.0
Auth "Login (user+password)" (token_login) agora configurável no formulário REST. O connector já suportava (#664) mas não havia porta na UI. Adicionada a opção + campos condicionais (Login URL + Usuário/Senha + avançado: Campo do usuário, Caminho do token). i18n PT/EN/ES.
09/07/2026 · new