FT-CONNECTOR-TOKEN-LOGIN-UI· 1.0.0Integrações
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.
Atualizado em 8/6/2026
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.
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.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.
7/9/2026 · new