Autenticación y claves de API

Subaya admite dos modos de autenticación contra la misma API.

Claves de API — SUBAYA_API_KEY (agentes y CI)

El camino más sencillo, y el que se debe usar para agentes de IA y canalizaciones de CI. Define la variable de entorno y todo comando suya (y la API de la plataforma) la recoge:

export SUBAYA_API_KEY="sk_..."
suya auth whoami      # confirm the identity the key resolves to

Sin navegador, sin paso interactivo: ideal para entornos sin interfaz gráfica. Emite y gestiona las claves desde la consola.

Inicio de sesión con OAuth en el navegador (personas)

Para uso interactivo en una estación de trabajo:

suya auth login                 # opens a browser (loopback redirect)
suya auth login --no-browser    # manual-code fallback for remote/headless shells

La CLI almacena el token resultante localmente (en ~/.config/suya/). Compruébalo o bórralo:

suya auth status    # local status, without calling the server
suya auth logout    # log out and revoke the local token

Precedencia

Cuando hay más de una credencial presente, suya resuelve en este orden:

1. El indicador global --token
2. SUBAYA_API_KEY
3. El token de OAuth almacenado localmente (~/.config/suya/auth.json)

Apuntar a un host diferente

Todos los comandos aceptan --host (predeterminado https://subaya-dev.com) si necesitas apuntar a un endpoint de API no predeterminado.

Siguientes pasos

• Inicio rápido — ejecuta tu primera simulación.
• CLI: auth — la referencia completa de suya auth.