Autenticación
:::caution Los productos no comparten credenciales
KOBANA_TOKEN guarda la credencial de un producto por vez. Un token de Finanzas Inteligentes no autentica en ningún otro producto Kobana, y viceversa.
:::
El token
Finanzas Inteligentes autentica con un JWT firmado en RS256 por el servidor de autorización de Kobana, enviado como Authorization: Bearer <jwt>. Mira Autenticación de la API para saber cómo se emite ese token y qué scopes lleva — kobana auth login, que es del Gateway Bancario, no lo produce.
:::caution El token por sí solo no basta
El JWT identifica la organización (claim org). Como una organización puede tener varios espacios de trabajo, la API exige además la cabecera X-Workspace-Id indicando en cuál actuar — sin ella la respuesta es 400 WORKSPACE_REQUIRED. Mira Autenticación de la API.
:::
Pon el JWT en KOBANA_TOKEN antes de llamar al producto:
export KOBANA_TOKEN=$JWT_FINANCE
kobana finance financial-accounts list --fields "id,name,balance"
Como la variable es la misma para todos los productos, expórtala por comando (o usa un .env por proyecto) si alternas entre productos en la misma sesión:
KOBANA_TOKEN=$JWT_FINANCE kobana finance financial-accounts list --fields "id,name,balance"
Prioridad de resolución
| Prioridad | Método | Configuración |
|---|---|---|
| 1 | Token directo | KOBANA_TOKEN |
| 2 | Archivo de credenciales | KOBANA_CREDENTIALS_FILE |
| 3 | Credenciales guardadas | kobana auth login (solo Gateway Bancario) |
Ambientes
El CLI opera en tres ambientes, y cada producto tiene sus propios hosts. Producción es el valor por defecto.
| Ambiente | API | --env |
|---|---|---|
| Producción | api.finance.kobana.com.br | production (por defecto) |
| Sandbox | api.finance.sandbox.kobana.com.br | sandbox |
Finanzas Inteligentes no tiene host de desarrollo propio: con --env development el CLI cae en producción.
# Producción (por defecto — sin flag)
kobana finance financial-accounts list
# Sandbox
kobana finance financial-accounts list --env sandbox
# Vía variable de ambiente
export KOBANA_ENVIRONMENT=sandbox
kobana finance financial-accounts list
Los tokens son diferentes entre ambientes — un token de sandbox no funciona en producción, y viceversa.
Próximos pasos
- Uso — sintaxis, recursos, ejemplos.
- Variables de ambiente — la referencia completa, incluyendo configuración y logs.