> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# Autenticação e tokens

## 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étodo | Rota 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](https://developers.orbita.nexxo.tec.br/integracoes/mcp.md).
