Autenticación

:::caution Los productos no comparten credenciales KOBANA_TOKEN guarda la credencial de un producto a la vez. Un token del Agente Kadu no autentica en ningún otro producto Kobana, y viceversa. :::

El token

La CLI usa el mismo access token de la Cuenta Kobana que la API (RS256, con aud igual a https://api.kadu.ia.br), leído de KOBANA_TOKEN y enviado como Authorization: Bearer. Las reglas del token, de los scopes y de los permisos son las de la API: vea Autenticación de la API y Permisos. kobana auth login, que es del Gateway Bancario, no produce este token.

export KOBANA_TOKEN=<token>
kobana kadu me list

kobana kadu me list llama a GET /v1/me, la única ruta sin verificación de scope: úselo para probar un token nuevo.

Como la variable es la misma para todos los productos, quien alterna entre ellos en la misma sesión pasa el token por comando:

KOBANA_TOKEN=$TOKEN_KADU kobana kadu executions list

La CLI también lee un archivo .env en la carpeta donde ejecuta el comando y, después, el de ~/.config/kobana/.env (en macOS, ~/Library/Application Support/kobana/.env).

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)

Scopes

Pida solo lo que el uso necesita, como en la API: kadu/executions para quien solo acompaña, kadu/tasks write para quien dispara, delete solo para quien elimina. Un comando fuera del scope responde 403 INSUFFICIENT_SCOPE, y la CLI termina con el código de salida 1.

Entornos

La CLI opera en tres entornos, y cada producto tiene sus propios hosts. Producción es el valor por defecto.

Entorno	API	--env
Producción	api.kadu.ia.br	production (por defecto)
Desarrollo	localhost:3030/api	development

Kadu no tiene sandbox: --env sandbox termina con error, en vez de mandar una prueba a producción. La CLI tampoco apunta a staging; para staging, use la API directamente (https://api.staging.kadu.ia.br/v1). KOBANA_ENVIRONMENT define el entorno por defecto. Un token de un entorno no vale en otro.

# production (default)
kobana kadu tasks list

# development
kobana kadu tasks list --env development

# KOBANA_ENVIRONMENT
export KOBANA_ENVIRONMENT=development
kobana kadu tasks list

Buenas prácticas

• Nunca versione el token ni el .env que lo carga.
• En un agente de IA, entregue un token con los scopes mínimos y de vida corta: la CLI hace todo lo que el token permite.

Próximos pasos

• Uso — sintaxis, recursos, ejemplos.
• Variables de entorno — la referencia completa, incluida configuración y logs.