STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO

Licenciamento e núcleo privado

Componentes e responsabilidades

Titan Arch Developer é a central de documentação. Titan Continuum é o software composto por núcleo e plugins. Titan Architect Studio é a extensão oficial do VS Code, idealizada e liderada por Wenderson Dias, integrada ao Architect SDK V2 e compatível com o protocolo v1 do host.

O Studio é distribuído pelo Visual Studio Marketplace. O núcleo proprietário não acompanha o VSIX 0.3.0. Ele é entregue pelo https://license.zerotrusted.net somente após autorização. O SDK e o compilador TypeScript continuam no pacote da extensão.

Ativar e preparar

  1. Instale a versão atualizada do Studio no lado Linux do VS Code: Linux local, WSL2 ou Remote SSH.
  2. Execute Titan Architect: Ativar licença e informe a chave no campo oculto.
  3. Execute Preparar ambiente Linux. Leia o diagnóstico; a instalação de pacotes exige digitar INSTALAR no terminal.
  4. Execute Iniciar núcleo Titan local. O Studio solicita um ticket temporário, valida o manifesto assinado e baixa o núcleo para seu armazenamento privado.
  5. Abra o Titan no painel ou use Abrir Titan no navegador. No primeiro acesso, defina sua senha pelo fluxo original do núcleo.

O identificador da instalação é um valor aleatório transformado em SHA-256; não é um inventário de hardware. Em WSL/Remote SSH cada host de extensão tem armazenamento próprio e pode consumir uma ativação diferente.

Credenciais e verificação

A chave comercial é enviada por HTTPS durante a ativação e não é salva pela extensão. O token de renovação e a autorização assinada ficam no SecretStorage do VS Code. Não os coloque no manifesto, em .env, em screenshots ou no Git.

O servidor assina autorizações e manifestos com Ed25519. O Studio contém apenas a chave pública. Cada autorização dura no máximo 24 horas, limitada também pela validade comercial da licença. Em uma falha de rede, a extensão aceita somente uma autorização assinada ainda válida. Uma recusa explícita HTTP 401/403 invalida o cache e bloqueia a operação; a extensão não trata revogação como indisponibilidade.

Hosts em execução são revalidados a cada minuto. Quando o servidor fica inacessível, uma revogação só pode ser descoberta no próximo contato ou no vencimento da autorização local. Não há promessa de revogação instantânea offline nem de execução offline ilimitada.

Download e integridade

O ticket de download vale 120 segundos e é vinculado à ativação. O endpoint verifica a ativação e a licença novamente. Tokens vão no cabeçalho Authorization, nunca na URL. Uma transferência interrompida pode ser retomada por Range; a extensão confere tamanho e SHA-256 antes da extração.

A extração ocorre em staging privado. São recusados caminhos absolutos, travessia de diretórios, links, arquivos especiais, duplicatas e pacotes acima dos limites. O inventário identifica todos os arquivos entregues. O núcleo só é promovido depois da validação, sem executar scripts do ZIP.

O licenciamento controla a distribuição e a autorização de uso; não impede completamente a extração do PHP depois de um download autorizado. As licenças de bibliotecas de terceiros continuam aplicáveis.

Renovar, trocar de máquina e encerrar

A renovação comercial é feita pelo administrador no License Server. A chamada de renovação do cliente apenas revalida a autorização; ela não estende uma licença vencida. Use Desativar licença desta instalação antes de abandonar um ambiente para liberar sua ativação. A desativação requer contato com o servidor; se a máquina foi perdida, solicite intervenção administrativa.

Versões anteriores

As versões 0.2.x incluíam código do Core. O portal deixou de oferecer os VSIX antigos diretamente. Isso não apaga cópias já baixadas nem retira automaticamente versões históricas do Marketplace. O responsável pelo publisher deve revisar a retenção dessas versões no painel oficial.

API independente

Endpoint HTTPS Método Autorização Resultado
/v1/activate POST Chave no corpo + installation Token de renovação e lease assinado
/v1/validate POST Bearer de renovação + installation Lease atualizado
/v1/renew POST Bearer de renovação + installation Revalidação, sem estender licença comercial
/v1/deactivate POST Bearer de renovação + installation Revoga a ativação atual
/v1/core/ticket POST Bearer de renovação + installation Ticket e manifesto assinado
/v1/core/package GET Bearer do ticket ZIP privado; suporta Range: bytes=N-
/health GET Público Saúde do serviço independente

Erros são objetos JSON com error. Não há fallback para uma cópia pública do núcleo. O License Server não consulta o banco operacional do Titan e não usa suas contas.

Central de gerenciamento de chaves

Acesse https://license.zerotrusted.net/admin. A central possui cinco áreas:

Área Uso
Licenças Indicadores, busca por cliente/ID, filtros, emissão e gerenciamento
Instalações Ambientes associados, licença, última validação e revogação individual
Auditoria Ações administrativas, ativações, downloads e revogações em ordem cronológica
Distribuição Versão atual do núcleo, tamanho, SHA-256 e regras do canal privado
Equipe Contas independentes, administradores e operadores de consulta

Emitir uma licença

Clique em Nova licença, informe o cliente ou organização, selecione uma data/hora de validade e o limite de instalações. As datas administrativas são em UTC, indicado no formulário. A chave aparece uma única vez, com opção de copiar. Entregue-a ao titular por um canal privado. Não há uma função de recuperar o texto de uma chave antiga: somente seu hash é armazenado.

Gerenciar o ciclo de vida

Use Gerenciar na linha da licença. Você pode editar o cliente, atualizar a validade e a capacidade, suspender, reativar ou revogar. Ao reduzir a capacidade, revogue antes as instalações excedentes. Suspender bloqueia a autorização mantendo o registro das instalações; revogar também encerra as ativações existentes.

Reemitir chave invalida a chave anterior e encerra todas as ativações. O titular deverá usar a nova chave. Esse recurso atende perda ou comprometimento da chave; a nova chave também aparece somente uma vez.

Arquivar organiza o histórico sem apagar registros: uma licença precisa estar revogada antes de ser arquivada. Use o filtro Arquivadas para consultá-la. A auditoria permanece disponível. A exportação CSV contém metadados das licenças, sem chaves comerciais ou hashes de credenciais.

Controlar ambientes e equipe

Em Instalações, revogue apenas o ambiente selecionado quando uma máquina for perdida, substituída ou deixar de ser autorizada. A autorização efetiva considera também a situação e a validade da licença. Identificadores de instalação são pseudônimos; a central não inventaria o hardware da estação.

Administradores podem gerenciar chaves e criar contas administrativas. Operadores têm acesso de consulta e não podem alterar licenças. Todas as ações de alteração exigem sessão autenticada, origem válida e token CSRF. O painel não reutiliza o login do Titan.