Segurança do Konsolity CLI

Atualizado em 10 de novembro de 2026

Um token copiado para outra máquina pode ser usado?

Não. Cada chamada envia a impressão digital da máquina, calculada a partir do identificador do sistema. Um token usado a partir de outro computador é recusado, o evento é gravado no registro de segurança e você recebe um alerta. Além disso, o arquivo de segredos local é criptografado com uma chave derivada do identificador da máquina: copiado para outro lugar, ele fica ilegível.

A única exceção: o token de longa duração do konsolity setup-token, feito para máquinas efêmeras, não está vinculado à impressão digital. Guarde-o no gerenciador de segredos da sua CI, dê a ele o escopo mais restrito possível e uma expiração curta.

Para que serve a impressão digital exibida na ativação?

Ela prova que a solicitação que você aprova vem mesmo da máquina à sua frente. Ela é calculada a partir da chave pública da máquina; o seu dispositivo a recalcula por conta própria, sem confiar no servidor. Se as duas impressões digitais forem diferentes, recuse.

O que o servidor Konsolity vê?

O servidor vê o nome da máquina, o sistema dela, o endereço IP, o escopo (domínios, somente leitura ou completo), as sessões e o registro de comandos (texto do comando, host, decisão, código de retorno, duração). Para o conector Claude (konsolity serve), ele também transmite, criptografados em repouso e apagados uma hora após a resposta, os argumentos e os resultados das chamadas do Claude, como no conector Claude.

Ele nunca vê a chave do seu cofre, a chave de máquina, as suas chaves SSH, as suas senhas nem as regras da máquina: as cópias do cofre de máquina são criptografadas de ponta a ponta, e o servidor só as armazena como blocos opacos. A saída dos comandos executados num terminal não passa pelo servidor.

A máquina tem acesso a todo o meu cofre?

Não. Ela nunca recebe a chave do cofre, apenas uma chave de máquina e cópias criptografadas dos hosts e snippets que você escolheu. Um host fora do escopo não tem nenhuma cópia: a chave SSH dele não sai do seu cofre. A máquina não pode nem gravar no cofre, nem alterar o próprio escopo, nem mexer na sua conta ou na sua assinatura.

O que acontece se a máquina for comprometida?

Quem assumir o controle total da máquina pode usar o que ela recebeu: os hosts e as chaves SSH do escopo dela, dentro dos limites das regras. Os comandos destrutivos continuam sujeitos à sua confirmação. Nesse caso:

  1. Revogue a máquina (Configurações › Máquinas CLI): ela é desconectada em menos de 5 segundos e o servidor apaga as cópias do cofre de máquina dela.
  2. Troque as chaves SSH dos hosts que ela podia alcançar.
  3. Revise o registro de comandos dela.
  4. Se a dúvida for sobre a conta, altere a sua senha desconectando os outros dispositivos: todas as máquinas CLI são revogadas.

Para reduzir o risco desde o início: o escopo mais restrito possível, somente leitura quando isso bastar, snippets em vez de comandos livres, nada de “Qualquer comando”, uma expiração curta, uma máquina dedicada e atualizada.

Em quanto tempo uma revogação entra em vigor?

Em menos de 5 segundos. Cada comando em andamento sinaliza a sua presença ao servidor a cada 2 segundos; na revogação, o sinal seguinte é recusado, e a CLI corta as conexões SSH, interrompe o comando, apaga os seus segredos e sai com o código 77.

Perdi o meu celular: o que fazer?

As suas máquinas CLI não dependem do seu celular: elas continuam funcionando. A partir de outro dispositivo ou de app.konsolity.com:

  1. Revogue o celular na lista de dispositivos.
  2. Se o celular tinha o seu app de TOTP ou a sua chave de acesso, use um código de backup e depois cadastre um novo segundo fator em Segurança.
  3. Em caso de dúvida, revogue também as máquinas CLI (Revogar tudo) e ative de novo as que você precisar.

Sem o segundo fator, ninguém pode aprovar uma nova máquina nem ampliar o escopo de uma máquina existente, mesmo com o seu celular desbloqueado.

Por que um segundo fator para aprovar?

Porque uma máquina CLI pode agir nos seus servidores sem ninguém à frente dela. O código TOTP ou a chave de acesso é verificado na mesma solicitação que a aprovação: uma sessão de navegador deixada aberta ou um código de ativação interceptado não bastam. Ele também é pedido para ampliar um escopo; reduzi-lo não pede nada.

Qual é a diferença em relação ao app?

App de computador Konsolity CLI
Interface Gráfica Linha de comando
Acesso ao cofre Cofre completo Apenas os hosts e snippets escolhidos
Precisa ficar aberto Sim Não, konsolity serve como serviço
Aprovação de um comando do Claude “Permitir uma vez”, ou sempre permitir Escopo e regras, confirmação para os comandos destrutivos
Terminal interativo, arquivos Sim Não
Sistemas macOS, Windows, Linux, iOS, Android Linux, macOS, Windows

Não confunda com o relay do terminal remoto, um serviço interno que transporta bytes SSH criptografados entre os seus dispositivos.

Qual plano é necessário?

O plano Studio, ou o seu teste gratuito. O servidor verifica o plano a cada chamada da máquina; a lista de máquinas e a revogação continuam sempre acessíveis. O konsolity serve também usa o conector Claude, incluído no Studio.