Ir al contenido
Mastering Claude

El curso175 lecciones

Inicio / Seguridad y datos

Seguridad y datos9 minAplicación

Una guardia por patrón de texto no es una frontera de seguridad

Una guardia que rechaza una palabra en el texto de un comando juzga una escritura y no un efecto: toda escritura que evita esa palabra pasa, e incluso una lista de comandos admitidos por igualdad exacta deja pasar el código que un comando admitido lee en un archivo que el agente puede modificar.

Una guardia rechaza todo comando que contenga la palabra rm. Tres maneras de escribir la misma eliminación la atraviesan, y la demostración siguiente lo comprueba en una carpeta desechable.

La guardia y sus cuatro pruebas

mkdir -p demo-guardia && cd demo-guardia
touch objetivo1.txt objetivo2.txt objetivo3.txt objetivo4.txt
cat > guardia.sh << 'EOF'
#!/bin/bash
cmd="$1"
if echo "$cmd" | grep -qw 'rm'; then
  echo "RECHAZADO: patrón prohibido detectado en el comando escrito"
  exit 1
fi
echo "AUTORIZADO: ningún patrón prohibido encontrado, ejecución"
eval "$cmd"
EOF
chmod +x guardia.sh
./guardia.sh "rm objetivo1.txt"
./guardia.sh "r'm' objetivo2.txt"
./guardia.sh 'A=r; B=m; $A$B objetivo3.txt'
ENC=$(printf 'rm objetivo4.txt' | base64)
./guardia.sh "echo $ENC | base64 -d | bash"
ls -1
RECHAZADO: patrón prohibido detectado en el comando escrito
AUTORIZADO: ningún patrón prohibido encontrado, ejecución
AUTORIZADO: ningún patrón prohibido encontrado, ejecución
AUTORIZADO: ningún patrón prohibido encontrado, ejecución
guardia.sh
objetivo1.txt

La primera prueba se rechaza y objetivo1.txt sobrevive. La segunda corta la palabra con apóstrofos, que el intérprete retira. La tercera ensambla la palabra a partir de dos variables de una letra. La cuarta codifica el comando en base64, que base64 -d | bash decodifica y luego ejecuta.

Por qué corregir caso por caso no cierra nada

Prohibir el apóstrofo, las variables o base64 cierra tres puertas, no las escrituras siguientes. La página de permisos de Claude Code lo dice de sus reglas: una denegación Bash(rm *) detiene rm -rf build/ pero deja pasar /bin/rm -rf build/, y no es una frontera de seguridad (ver una regla de lectura).

La igualdad exacta reduce la superficie sin cerrarla

Una lista de comandos admitidos aguanta mejor cuando exige la igualdad exacta de cadena y no admite ningún programa lanzador, o sea, ninguno que ejecute otro comando que se le pasa: bash, sh -c, eval, find -exec, xargs. Cierra entonces las reescrituras. Deja abierto el código que un comando admitido lee en otra parte. Git lanza el programa nombrado por el ajuste core.fsmonitor del repositorio cuando refresca su índice, al hacer un git status.

mkdir -p demo-fsmonitor && cd demo-fsmonitor
git init -q
git config core.fsmonitor 'echo EJECUTADO_POR_GIT_STATUS > testigo.txt; false'
git status > /dev/null 2>&1
cat testigo.txt
EJECUTADO_POR_GIT_STATUS

Un git status idéntico a la entrada admitida ejecutó lo que un agente puede escribir en .git/config. La otra vía ya no inspecciona el texto: el sandbox, un aislamiento que el sistema operativo impone a los comandos de shell y a sus procesos hijos, acota archivos y red sea cual sea el comando que lanzó el código. Funciona en macOS, Linux y WSL2, no en Windows nativo.

El sandbox no sustituye la petición de autorización. Desde la versión 2.1.325 del registro de cambios, un comando Bash en sandbox sigue por defecto el flujo normal de permisos; sandbox.autoAllowBashIfSandboxed: true restablece la ejecución sin petición.

Una guardia demasiado estricta también rechaza por error

Una guardia que rechaza todo lo que se parece a una escritura enseña a rodearla: bloquea una redirección a un archivo nuevo, un heredoc de puros datos, un grep cuyo patrón cita un comando peligroso. Corrígela con exenciones estrechas y un banco de pruebas que conserve un testigo: una brecha conocida detectada, todos los rechazos mantenidos. No actives sandbox.allowNestedUserNamespaces: permite a comandos aislados en Linux esquivar las protecciones de archivos del sandbox.

Medir la guardia, vigilar de qué depende

Registra cada rechazo y lo que le sigue: un rechazo levantado al repetir idéntico el comando no evitó nada. Prefiere una guardia limitada al efecto destructivo, borrado o sobrescritura, en lugar de una palabra del texto.

Una guardia que se apoya en un indicador de Claude Code se rompe en silencio si una actualización lo renombra. Un centinela, lanzado desde un hook SessionStart, muestra los indicadores ausentes de claude --help. Su testigo, un indicador inexistente, debe señalarse, si no el detector está roto.

Figura 1

Una corrección más frente a una lista por igualdad exacta

Guardia por patrón, una corrección más
Añadido: rechazar también el apóstrofo aislado.
Elusión siguiente: dos variables pegadas, sigue autorizado.
Lista por igualdad exacta
Autorizado: git status
Rechazado: bash -c 'git status'
Sigue abierto: el programa que core.fsmonitor nombra en .git/config
A la izquierda, cada corrección deja abierta la siguiente. A la derecha, las reescrituras del comando se rechazan, y el comando admitido ejecuta todavía lo que la configuración del repositorio le hace lanzar.
Figura 2

Tres elusiones, lo que la guardia ve, lo que se ejecuta

ElusiónLo que la guardia veLo que se ejecuta realmente
Corte con apóstrofos, r'm'Las letras r y m separadas por un apóstrofo, ninguna palabra rm enteraLa eliminación, una vez retirados los apóstrofos por el intérprete
Concatenación de variables, $A$BDos variables de una letra, nunca r y m juntas en el textoLa eliminación, una vez ensambladas las variables en la ejecución
Codificación base64Una sucesión de caracteres sin relación visible con la palabra prohibidaLa eliminación, una vez decodificada y transmitida al intérprete
Para cada una de las tres elusiones ejecutadas, el texto que la guardia inspeccionó y el comando realmente lanzado una vez interpretado.
Calíbralo tú mismo

Un administrador escribe una guardia que rechaza ejecutar todo comando que contenga la palabra rm, para impedir que un script automatizado elimine archivos. La prueba con el comando rm notes.txt, que se rechaza. Despliega después la guardia en su sistema de producción.

Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.

Lo que hay que recordar
  • Una guardia que busca una palabra en el texto de un comando juzga una escritura, no el efecto que producirá el intérprete.
  • Cada elusión corregida deja abiertas las escrituras que la corrección no ha previsto.
  • Una lista admitida por igualdad exacta, sin programa lanzador, cierra las reescrituras de un comando pero no el código que ese comando lee en su configuración.
  • El sandbox acota archivos y red mediante el sistema operativo, sea cual sea el comando que lanzó el código, y sus comandos Bash pasan por la petición de autorización salvo que configures autoAllowBashIfSandboxed.
  • Una guardia demasiado estricta rechaza por error y enseña a rodearla: se corrige con exenciones estrechas, se mide registrando sus rechazos, y un centinela de indicadores, probado con un indicador inexistente, avisa de la avería silenciosa.
Hazlo ahora

Repite la demostración core.fsmonitor en una carpeta nueva y comprueba que testigo.txt contiene la línea esperada. Escribe después una guardia de unas pocas líneas que rechace un comando que contenga una palabra de tu elección, pruébala con esa palabra escrita tal cual y luego cortada con apóstrofos, y anota cuál de las dos pruebas deja pasar.

Verificar en la fuente

Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.