Alcance y reglas
Una máquina CLI solo tiene acceso a lo que le hayas dado. El alcance se elige al aprobar y se puede modificar después en Ajustes › Máquinas CLI (o en app.konsolity.com/cli-machines, con la bóveda abierta). Se aplica dos veces: en el servidor, que rechaza cualquier llamada fuera del alcance, y en la propia máquina, que aplica unas reglas cifradas que el servidor no puede leer ni modificar. Ambos rechazan lo que no está permitido.
Ámbitos
| Ámbito | Qué permite |
|---|---|
hosts |
Listar los hosts elegidos; con acceso completo, ejecutar comandos en ellos (konsolity run). |
snippets |
Listar los fragmentos elegidos; con acceso completo y hosts, lanzarlos (konsolity snippet run). |
sessions |
Ver las sesiones CLI en curso en la cuenta y terminarlas (konsolity sessions). |
mcp |
Ofrecer herramientas a los agentes de Claude (konsolity mcp, konsolity serve). |
Por defecto: hosts y snippets.
Solo lectura o acceso completo
- Solo lectura: solo listas y estado. No se puede lanzar ningún comando, ni siquiera mediante un fragmento. Es el acceso por defecto y la opción adecuada para un panel o una supervisión.
- Acceso completo: los comandos están permitidos en los hosts elegidos, dentro de los límites de las reglas de comandos que se describen a continuación.
La bóveda de máquina
La máquina nunca recibe la clave de tu bóveda. Al aprobar, tu dispositivo genera una clave de máquina propia de esa máquina, se la transmite sellada y después copia, cifrados con esa clave, solo los elementos que el alcance permite:
- los hosts elegidos, con sus identidades, sus claves SSH y sus claves de host fijadas;
- los fragmentos elegidos;
- las reglas de la máquina.
El servidor guarda esas copias como bloques opacos. Un host fuera del alcance no tiene ninguna copia: su clave SSH nunca sale de tu bóveda. La máquina no tiene ningún acceso a la bóveda de la cuenta.
- Añadir un host al alcance: un dispositivo con la bóveda abierta escribe su copia.
- Quitar un host: el servidor borra su copia de inmediato.
- Modificar un host en la bóveda (dirección, clave): tus dispositivos actualizan las copias de las máquinas en su siguiente sincronización. Eliminar el host también elimina sus copias.
Solo se pueden usar los hosts cuya clave de host ya está fijada en la bóveda: la CLI nunca acepta una clave de host desconocida (host_key_unknown). Conéctate una primera vez al host desde la app para fijarla.
Reglas de comandos
Con acceso completo, konsolity run (y la herramienta run_command de Claude) solo se permite si el host está en el alcance y el comando, sin sus espacios iniciales y finales, coincide con una regla. Hay tres formas de comparar:
| Tipo | Regla | Ejemplo de patrón | Acepta | Rechaza |
|---|---|---|---|---|
exact |
el comando completo, idéntico | df -h |
df -h |
df -h / |
prefix |
el comando empieza por el patrón | uptime |
uptime -p |
w |
glob |
* sustituye una secuencia de caracteres |
systemctl status * |
systemctl status nginx |
systemctl restart nginx |
Lo que * nunca permite
En un patrón glob, * no puede contener:
;&|(encadenamiento y tubería);`y$((sustitución de comandos);>y<(redirección);- un salto de línea.
Así, systemctl status * no acepta ni systemctl status nginx; rm -rf / ni systemctl status x | sh. Un patrón prefix acepta tal cual lo que sigue al prefijo: resérvalo para comandos sin riesgo.
Cualquier comando
La opción Cualquier comando permite cualquier texto en los hosts elegidos. Pide una confirmación explícita en pantalla y no se recomienda: la máquina pasa a equivaler a un acceso completo al shell. Los comandos destructivos siguen necesitando confirmación (consulta más abajo).
Al activar con acceso completo, no hay ninguna regla marcada y «Cualquier comando» está desactivado: hay que escribir reglas o marcar explícitamente «Cualquier comando»; si no, se rechaza cualquier comando libre. Los fragmentos permitidos, en cambio, se lanzan tal como están guardados.
Tiempo máximo
Cada comando se interrumpe al superar el tiempo máximo: 60 segundos por defecto, 1 hora como máximo. El valor que pidan --timeout o Claude siempre queda limitado por este tiempo.
Comandos destructivos: siempre confirmados
Algunos comandos nunca se lanzan sin tu confirmación explícita en la app o en la consola, sea cual sea el alcance, incluso con «Cualquier comando». Un comando (o el contenido de un fragmento) es destructivo si contiene como palabra aislada, por ejemplo:
- eliminación y borrado:
rm -r,rm -f,rmdir,shred,truncate,dd,mkfs,fdisk,parted,wipefs; - parada:
shutdown,reboot,poweroff,halt,init 0,init 6,systemctl stop,disable,mask,kill,service ... stop,kill -9,killall,pkill; - cuentas y permisos:
userdel,deluser,passwd,chmod -R,chown -R,crontab -r; - cortafuegos:
iptables -F,ufw disable,ufw reset; - bases de datos:
DROP,TRUNCATE,DELETE FROM,ALTER TABLE ... DROP,migrate:fresh,migrate:reset,migrate:rollback; - repositorios e infraestructura:
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; - una redirección
>hacia un disco (/dev/sd*,/dev/nvme*) o hacia/etc/.
La CLI y el servidor aplican la misma lista: un comando destructivo lanzado sin una confirmación aprobada se rechaza en ambos lados. El proceso se describe en Confirmaciones.
Modificar el alcance
- Ampliar (añadir un ámbito, pasar de solo lectura a acceso completo) vuelve a exigir el segundo factor (TOTP o llave de acceso).
- Reducir (quitar un ámbito, volver a solo lectura, quitar un host) es inmediato y no pide nada: las copias fuera del alcance se borran de inmediato.
Las reglas de comandos y el tiempo máximo se pueden modificar en cualquier momento, con la bóveda abierta. Para ver lo que la máquina aplica realmente:
konsolity policy
Ejemplos
Supervisión (solo lectura, hosts + sessions): listas y estado, ningún comando.
Operación diaria (acceso completo, algunos 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
más los fragmentos «Reiniciar nginx» y «Vaciar la caché de la aplicación».
Despliegue desde la CI (token de larga duración, acceso completo, hosts + snippets): un único fragmento «Desplegar» en el host de producción, ninguna regla de comandos libres.