Autenticação
:::caution Produtos não compartilham credenciais
KOBANA_TOKEN guarda a credencial de um produto por vez. Um token do Faturamento Automático não autentica em nenhum outro produto Kobana, e vice-versa.
:::
O token
O Faturamento Automático autentica com um JWT assinado em RS256 pelo servidor de autorização da Kobana, enviado como Authorization: Bearer <jwt>. Veja Autenticação da API para como esse token é emitido e quais escopos ele carrega — kobana auth login, que é do Gateway Bancário, não produz esse token.
Coloque o JWT em KOBANA_TOKEN antes de chamar o produto:
export KOBANA_TOKEN=$JWT_BILLING
kobana billing subscriptions list --fields "id,status,plan_id"
Como a variável é a mesma para todos os produtos, exporte-a por comando (ou use um .env por projeto) se você alterna entre produtos na mesma sessão:
KOBANA_TOKEN=$JWT_BILLING kobana billing subscriptions list --fields "id,status,plan_id"
Prioridade de resolução
| Prioridade | Método | Configuração |
|---|---|---|
| 1 | Token direto | KOBANA_TOKEN |
| 2 | Arquivo de credenciais | KOBANA_CREDENTIALS_FILE |
| 3 | Credenciais salvas | kobana auth login (só Gateway Bancário) |
Ambientes
O CLI opera em três ambientes, e cada produto tem os seus próprios hosts. Produção é o padrão.
| Ambiente | API | --env |
|---|---|---|
| Produção | api.billing.kobana.com.br | production (padrão) |
| Sandbox | api.billing.sandbox.kobana.com.br | sandbox |
O Faturamento Automático não tem host de desenvolvimento próprio: com --env development o CLI cai em produção.
# Produção (padrão — sem flag)
kobana billing subscriptions list
# Sandbox
kobana billing subscriptions list --env sandbox
# Via variável de ambiente
export KOBANA_ENVIRONMENT=sandbox
kobana billing subscriptions list
Os tokens são diferentes entre ambientes — um token de sandbox não funciona em produção, e vice-versa.
Próximos passos
- Uso — sintaxe, recursos, exemplos.
- Variáveis de ambiente — a referência completa, incluindo configuração e logs.