Administração
Licença e conectividade
Licença online ou offline, o que é enviado à Aptabit e instalação em rede isolada.
Nesta página
A licença da Aptabit Platform é emitida para a sua organização e validada de uma de duas formas: online, por check-in no Aptabit Manager, ou offline, por arquivo. Esta página descreve o que cada modo exige e exatamente o que sai da instalação.
Modos de licença
| Aspecto | Online | Offline |
|---|---|---|
| Validação | Check-in no Aptabit Manager pelo menos a cada 6 horas. | Arquivo de licença emitido para a instalação. |
| Sem conexão | Continua funcionando pela tolerância da concessão: 7 dias por padrão, definida por licença. | Não depende de conexão. |
| Validade | Renovada a cada check-in. | Até 120 dias por arquivo, renovável pelo mesmo processo. |
| Contato com a Aptabit | Check-ins e telemetria, conforme o nível da licença. | Nenhum. |
Identidade da instalação
Cada instalação gera, na própria máquina, um par de chaves Ed25519. O Aptabit Manager guarda apenas a chave pública, e toda chamada da instalação ao Aptabit Manager é assinada com a chave privada. A identidade fica em <instalacao>/identity/, montada somente para leitura no container da API, e não é copiada pelo backup.
O que uma licença online envia
Todo check-in envia: versão da plataforma, estado de saúde, impressão digital da máquina (em hash), hash do binário, arquitetura da CPU, indicadores de integridade, token de encadeamento e a declaração de proveniência das imagens.
O restante depende do nível de telemetria, definido pela Aptabit em cada licença (padrão standard):
| Nível | Conteúdo adicional |
|---|---|
off e basic |
Nenhum dado de uso. |
standard |
Contagens agregadas: pessoas, organizações, workspaces, agentes, fluxos, integrações, provedores, modelos, documentos, bytes armazenados, tokens e agendamentos, além do total de avaliações positivas e negativas. |
full |
Também um retrato do hardware (CPU, memória, GPUs, discos e servidores de inferência locais) e do ambiente (nome do servidor, sistema operacional, kernel, tempo ligado e runtime de containers). |
Em nenhum nível são enviados prompts, documentos, conversas, arquivos, tabelas ou embeddings.
O nível de telemetria é definido no Aptabit Manager, por licença, e não é alterado pela interface da plataforma. Defina com a Aptabit o nível adequado à política da sua organização.
Relatórios de falha do CLI
Quando um comando do CLI falha, ele avisa o Aptabit Manager até onde o nível da licença permite:
| Nível | O que é enviado |
|---|---|
off |
Nada. |
basic |
Código, ID e título da falha, comando, versões e sistema operacional. |
standard |
Também as linhas que definiram o diagnóstico e o fim do log da execução, sem segredos, e o relatório da máquina após install e update. |
full |
Também o relatório da máquina a cada falha. |
O envio é limitado a 30 relatórios por hora por licença. Os comandos de diagnóstico (check, status, doctor e support-bundle) não geram relatório, e uma instalação offline nunca envia.
Outras conexões de saída
Fora do licenciamento, a instalação só se conecta a serviços externos que o operador aciona ou configura:
- verificação de atualizações e atualização do CLI;
- download de imagens: registry privado da Aptabit, imagens base públicas e imagens dos runtimes de modelos;
- Hugging Face, para os pesos dos modelos locais gerenciados;
- provedores externos de modelos cadastrados;
- busca na web do chat, quando ativada em uma mensagem;
- exportação OpenTelemetry para o coletor da organização;
- provedor de identidade do SSO;
- sistemas cadastrados em Integrações.
A aplicação web não carrega CDNs nem ferramentas de análise de terceiros.
Instalação isolada
Uma máquina sem acesso ao Aptabit Manager instala a partir de imagens copiadas e recebe a licença por arquivo:
-
Em uma máquina conectada, com a mesma versão do CLI, salve as imagens:
Shellaptabit images save -o aptabit-images-<versao>.tar -
Copie o arquivo e o CLI da mesma versão para a máquina isolada e carregue as imagens:
Shellaptabit images load aptabit-images-<versao>.tar -
Instale em modo offline. O CLI confere se todas as imagens estão presentes antes de gravar qualquer arquivo:
Shellaptabit check --offline aptabit install --offline -
Gere a solicitação de licença e envie o arquivo à Aptabit. Ele não contém segredos, apenas a identificação da instalação, assinada por ela:
Shellaptabit license request -o solicitacao.json -
Aplique o arquivo de licença emitido pela Aptabit. A API reinicia para carregá-lo, e o primeiro acesso em
/setupé liberado:Shellaptabit license apply licenca.lic
A plataforma avisa duas semanas antes do fim do arquivo. A renovação repete os passos 4 e 5, e a instalação mantém o mesmo assento. O license apply recusa arquivos emitidos para outra instalação ou mais antigos que o instalado.
O pacote de imagens contém apenas a stack da plataforma. Imagens de runtimes e pesos de modelos locais precisam ser preparados à parte, ou a instalação pode usar um servidor de inferência compatível com OpenAI disponível na rede local.
Fim da licença
Uma licença vencida ou suspensa bloqueia o uso da plataforma, mas nunca remove containers nem dados: tudo permanece na máquina. Depois do vencimento, há um período de carência de 7 dias por padrão.
Comandos
| Comando | Função |
|---|---|
aptabit license |
Mostra a licença, a concessão e a situação da instalação. Com --json, para scripts. |
aptabit license request |
Gera a solicitação de licença de uma máquina sem acesso ao Aptabit Manager. |
aptabit license apply |
Instala o arquivo de licença emitido pela Aptabit. |
aptabit license upgrade |
Migra uma instalação antiga, por token, para a identidade de instalação, no mesmo assento. |
Modelo comercial
Você paga apenas pelos fluxos publicados em produção. Não há cobrança por usuário, por token, por armazenamento ou por uso.
