Autenticação
Fluxo machine-to-machine de autenticação usado pelas APIs lbdev
As APIs do ecossistema lbdev usam OAuth2 client credentials — um fluxo machine-to-machine, para chamadas feitas por serviço ou aplicação, não login de usuário via navegador. A service account que você cria carrega as permissões definidas no momento da sua criação.
1. Gere uma service account
No dashboard, acesse o menu Organização e a aba Contas de serviço. Clique em Nova conta de serviço, informe um nome e selecione as permissões que a credencial deve ter. Você recebe um client_id e um client_secret.
O client_secret só é exibido uma vez, no momento da criação. Copie e guarde-o com segurança — ele não pode ser recuperado depois.
2. Troque a credencial por um access token
Faça um grant client_credentials contra auth.lbdev.com.br, trocando client_id/client_secret por um access_token:
curl -X POST "https://auth.lbdev.com.br/realms/lbdev/protocol/openid-connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=<seu-client-id>" \
-d "client_secret=<seu-client-secret>"A resposta traz o access_token e seu expires_in, em segundos.
3. Use o access token nas chamadas à API
Envie o access_token no header Authorization de toda chamada à API, contra a URL da API (aqui representada como <url-da-api>):
curl "<url-da-api>/api/v2/chatbridge/..." \
-H "Authorization: Bearer <access_token>"