Escopo e regras

Atualizado em 10 de novembro de 2026

Uma máquina CLI só tem acesso ao que você lhe deu. O escopo é escolhido na aprovação e pode ser alterado depois em Configurações › Máquinas CLI (ou em app.konsolity.com/cli-machines, com o cofre aberto). Ele é aplicado duas vezes: pelo servidor, que recusa qualquer chamada fora do escopo, e pela própria máquina, que aplica regras criptografadas que o servidor não pode nem ler nem alterar. Os dois recusam o que não é permitido.

Domínios

Domínio O que permite
hosts Listar os hosts escolhidos; com acesso completo, executar comandos neles (konsolity run).
snippets Listar os snippets escolhidos; com acesso completo e hosts, executá-los (konsolity snippet run).
sessions Ver as sessões CLI em andamento na conta e encerrá-las (konsolity sessions).
mcp Servir de ferramentas para os agentes Claude (konsolity mcp, konsolity serve).

Por padrão: hosts e snippets.

Somente leitura ou acesso completo

  • Somente leitura: apenas listas e estado. Nenhum comando pode ser executado, nem mesmo por um snippet. É o acesso padrão e a escolha certa para um painel ou um monitoramento.
  • Acesso completo: os comandos são permitidos nos hosts escolhidos, dentro dos limites das regras de comando abaixo.

O cofre de máquina

A máquina nunca recebe a chave do seu cofre. Na aprovação, o seu dispositivo gera uma chave de máquina exclusiva dessa máquina, a transmite selada e depois copia, criptografados com essa chave, somente os itens que o escopo autoriza:

  • os hosts escolhidos, com as suas identidades, as suas chaves SSH e as suas chaves de host fixadas;
  • os snippets escolhidos;
  • as regras da máquina.

O servidor armazena essas cópias como blocos opacos. Um host fora do escopo não tem nenhuma cópia: a chave SSH dele nunca sai do seu cofre. A máquina não tem nenhum acesso ao cofre da conta.

  • Adicionar um host ao escopo: um dispositivo em que o cofre está aberto grava a cópia dele.
  • Remover um host: o servidor apaga a cópia dele imediatamente.
  • Alterar um host no cofre (endereço, chave): os seus dispositivos atualizam as cópias das máquinas na próxima sincronização. Excluir o host também exclui as cópias dele.

Só podem ser usados os hosts cuja chave de host já está fixada no cofre: a CLI nunca aceita uma chave de host desconhecida (host_key_unknown). Conecte-se uma primeira vez ao host a partir do app para fixá-la.

Regras de comando

Com acesso completo, o konsolity run (e a ferramenta run_command do Claude) só é permitido se o host estiver no escopo e se o comando, sem os espaços do início e do fim, corresponder a uma regra. Três formas de comparar:

Tipo Regra Exemplo de padrão Aceita Recusa
exact o comando inteiro, idêntico df -h df -h df -h /
prefix o comando começa pelo padrão uptime uptime -p w
glob * substitui uma sequência de caracteres systemctl status * systemctl status nginx systemctl restart nginx

O que * nunca autoriza

Num padrão glob, * não pode conter:

  • ; & | (encadeamento e pipe);
  • ` e $( (substituição de comando);
  • > e < (redirecionamento);
  • uma quebra de linha.

Assim, systemctl status * não aceita nem systemctl status nginx; rm -rf / nem systemctl status x | sh. Um padrão prefix aceita o que vem depois do prefixo tal como está: reserve-o para comandos sem risco.

Qualquer comando

A opção Qualquer comando autoriza qualquer texto nos hosts escolhidos. Ela pede uma confirmação explícita na tela e é desaconselhada: a máquina passa a equivaler a um acesso shell completo. Os comandos destrutivos continuam sendo confirmados (veja abaixo).

Na ativação com acesso completo, nenhuma regra vem marcada e “Qualquer comando” fica desativado: é preciso escrever regras ou marcar explicitamente “Qualquer comando”; caso contrário, todo comando livre é recusado. Os snippets autorizados, por sua vez, são executados tal como foram salvos.

Tempo limite máximo

Cada comando é interrompido além do tempo limite máximo: 60 segundos por padrão, 1 hora no máximo. O valor pedido por --timeout ou pelo Claude é sempre limitado por esse tempo.

Comandos destrutivos: sempre confirmados

Alguns comandos nunca são executados sem a sua confirmação explícita no app ou no console, qualquer que seja o escopo, mesmo com “Qualquer comando”. Um comando (ou o conteúdo de um snippet) é destrutivo se contiver, como palavra isolada, por exemplo:

  • exclusão e apagamento: rm -r, rm -f, rmdir, shred, truncate, dd, mkfs, fdisk, parted, wipefs;
  • desligamento: shutdown, reboot, poweroff, halt, init 0, init 6, systemctl stop, disable, mask, kill, service ... stop, kill -9, killall, pkill;
  • contas e permissões: userdel, deluser, passwd, chmod -R, chown -R, crontab -r;
  • firewall: iptables -F, ufw disable, ufw reset;
  • bancos de dados: DROP, TRUNCATE, DELETE FROM, ALTER TABLE ... DROP, migrate:fresh, migrate:reset, migrate:rollback;
  • repositórios e infraestrutura: git push --force, git reset --hard, git clean -f, docker rm, docker rmi, docker system prune, docker volume rm, docker compose down -v, kubectl delete, terraform destroy;
  • um redirecionamento > para um disco (/dev/sd*, /dev/nvme*) ou para /etc/.

A mesma lista é aplicada pela CLI e pelo servidor: um comando destrutivo executado sem confirmação aprovada é recusado dos dois lados. O fluxo está descrito em Confirmações.

Alterar o escopo

  • Ampliar (adicionar um domínio, passar de somente leitura para acesso completo) exige de novo o segundo fator (TOTP ou chave de acesso).
  • Reduzir (remover um domínio, voltar para somente leitura, remover um host) é imediato e não pede nada: as cópias fora do escopo são apagadas na hora.

As regras de comando e o tempo limite podem ser alterados a qualquer momento, com o cofre aberto. Para ver o que a máquina aplica de fato:

konsolity policy

Exemplos

Monitoramento (somente leitura, hosts + sessions): listas e estado, nenhum comando.

Operação do dia a dia (acesso completo, alguns hosts):

glob     systemctl status *
exact    df -h
exact    free -m
prefix   uptime
glob     journalctl -u * --since *
glob     tail -n * /var/log/nginx/error.log
exact    docker ps

mais os snippets “Reiniciar o nginx” e “Limpar o cache do aplicativo”.

Implantação a partir da CI (token de longa duração, acesso completo, hosts + snippets): um único snippet “Implantar” no host de produção, nenhuma regra de comando livre.