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.

MétodoRota relativa a /api/v1/organizations/{orgId}
POST/api-tokens com name e expiresAt opcional
GET/api-tokens
DELETE/api-tokens/{id}

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.