Autenticação e chaves de API

O Subaya suporta dois modos de autenticação contra a mesma API.

Chaves de API — SUBAYA_API_KEY (agentes e CI)

O caminho mais simples, e o que deve ser usado para agentes de IA e pipelines de CI. Defina a variável de ambiente e todo comando suya (e a API da plataforma) a utiliza:

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

Sem navegador, sem etapa interativa — ideal para ambientes headless. Emita e gerencie chaves a partir do console.

Login OAuth pelo navegador (humanos)

Para uso interativo em uma estação de trabalho:

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

A CLI armazena o token resultante localmente (em ~/.config/suya/). Verifique-o ou limpe-o:

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

Precedência

Quando mais de uma credencial está presente, o suya resolve nesta ordem:

1. A flag global --token
2. SUBAYA_API_KEY
3. O token OAuth armazenado localmente (~/.config/suya/auth.json)

Apontar para um host diferente

Todos os comandos aceitam --host (padrão https://subaya-dev.com) se você precisar mirar um endpoint de API não padrão.

Próximos passos

• Início rápido — execute sua primeira simulação.
• CLI: auth — a referência completa de suya auth.