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:

  1. Em uma máquina conectada, com a mesma versão do CLI, salve as imagens:

    Shell
    aptabit images save -o aptabit-images-<versao>.tar
  2. Copie o arquivo e o CLI da mesma versão para a máquina isolada e carregue as imagens:

    Shell
    aptabit images load aptabit-images-<versao>.tar
  3. Instale em modo offline. O CLI confere se todas as imagens estão presentes antes de gravar qualquer arquivo:

    Shell
    aptabit check --offline
    aptabit install --offline
  4. 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:

    Shell
    aptabit license request -o solicitacao.json
  5. Aplique o arquivo de licença emitido pela Aptabit. A API reinicia para carregá-lo, e o primeiro acesso em /setup é liberado:

    Shell
    aptabit 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.

Documentaçãov3.7