Escopo e regras
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.