Autenticação

:::caution Produtos não compartilham credenciais KOBANA_TOKEN guarda a credencial de um produto por vez. Um token do Financeiro Inteligente não autentica em nenhum outro produto Kobana, e vice-versa. :::

O token

O Financeiro Inteligente 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.

:::caution O token sozinho não basta O JWT identifica a organização (claim org). Como uma organização pode ter vários espaços de trabalho, a API exige também o cabeçalho X-Workspace-Id dizendo em qual deles agir — sem ele a resposta é 400 WORKSPACE_REQUIRED. Veja Autenticação da API. :::

Coloque o JWT em KOBANA_TOKEN antes de chamar o produto:

export KOBANA_TOKEN=$JWT_FINANCE
kobana finance financial-accounts list --fields "id,name,balance"

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_FINANCE kobana finance financial-accounts list --fields "id,name,balance"

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.finance.kobana.com.br	production (padrão)
Sandbox	api.finance.sandbox.kobana.com.br	sandbox

O Financeiro Inteligente não tem host de desenvolvimento próprio: com --env development o CLI cai em produção.

# Produção (padrão — sem flag)
kobana finance financial-accounts list

# Sandbox
kobana finance financial-accounts list --env sandbox

# Via variável de ambiente
export KOBANA_ENVIRONMENT=sandbox
kobana finance financial-accounts 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.