API pública: token da organização
O backend aceita X-Api-Key: wk_… ou Authorization: Bearer wk_… nas rotas públicas. O header X-Api-Key tem precedência quando está presente. A credencial precisa estar ativa e dentro da validade configurada.
O token é emitido por um administrador autorizado em Configurações → API. O valor completo é retornado uma única vez; listagens posteriores mostram apenas o prefixo e os metadados.
Para rotacionar, emita outra credencial, atualize o consumidor, confirme uma leitura e revogue a anterior. Uma credencial revogada não pode continuar autenticando chamadas.
Gestão de credenciais
Estas rotas pertencem à API privada e exigem JWT com a política administrativa WorkAdmin; uma API key não pode emitir outras chaves.
O contrato atual não oferece scopes por operação nem restrição de projeto por token.
Sessão de usuário
A aplicação usa um access token JWT do Nexxo.Auth/Keycloak. No Hub, a sessão é fornecida pelo host; o remote do Órbita não recebe nem renova refresh tokens. O servidor valida assinatura, issuer, audience e organização, além das permissões do recurso.
O fluxo OAuth do MCP tem condições próprias. Consulte MCP.