Autenticación
:::caution Los productos no comparten credenciales
KOBANA_TOKEN guarda la credencial de un producto por vez. Un token de Facturación Automática no autentica en ningún otro producto Kobana, y viceversa.
:::
El token
Facturación Automática 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.
Pon el JWT en KOBANA_TOKEN antes de llamar al producto:
export KOBANA_TOKEN=$JWT_BILLING
kobana billing subscriptions list --fields "id,status,plan_id"
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_BILLING kobana billing subscriptions list --fields "id,status,plan_id"
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.billing.kobana.com.br | production (por defecto) |
| Sandbox | api.billing.sandbox.kobana.com.br | sandbox |
Facturación Automática no tiene host de desarrollo propio: con --env development el CLI cae en producción.
# Producción (por defecto — sin flag)
kobana billing subscriptions list
# Sandbox
kobana billing subscriptions list --env sandbox
# Vía variable de ambiente
export KOBANA_ENVIRONMENT=sandbox
kobana billing subscriptions 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.