Un listener con tls_disable = 1 en 0.0.0.0 envía cada token y cada secreto por HTTP sin cifrar, una política "break-glass" con path "*" y sudo es la política root con otro nombre, y un vault-init.txt guardado entrega tus claves de unseal y tu token root a cualquiera que tenga el repositorio. Esta skill encuentra esos y los demás errores de Vault que se indican abajo antes de desplegar, y te dice cómo corregir cada uno.

Tu agente ejecuta un escáner sobre las configuraciones del servidor, Agent y Proxy de Vault (HCL y JSON, también dentro de valores de vault-helm, ConfigMaps y VAULT_LOCAL_CONFIG), las políticas ACL (HCL, JSON, heredocs de vault_policy de Terraform, reglas de vault_policy_document, heredocs de vault policy write en scripts y CI) y los archivos que ejecutan Vault o se conectan a él: docker-compose, manifiestos de Kubernetes y anotaciones del injector, valores de vault-helm, unidades systemd, Dockerfiles, jobs de Nomad, archivos .env, scripts de shell, GitHub Actions con vault-action y la salida guardada de vault operator init. Lee HCL con un número de línea para cada clave (también en bloques escritos en una sola línea), conoce los valores predeterminados de Vault (un listener sin dirección se enlaza a 127.0.0.1), la coincidencia de rutas de políticas con + y *, la sintaxis antigua policy = "write" y las referencias env:// y file://, y nunca contacta con Vault ni ejecuta nada. Devuelve BLOCK, REVIEW o NOT FLAGGED, con el archivo, la línea, el motivo y una alternativa más segura. Los secretos nunca se muestran.

Qué comprueba

BLOCK (corrígelo antes de publicar)

• V01: un listener tcp con tls_disable activado mientras escucha más allá de loopback (0.0.0.0, [::], un nombre de host, una IP privada), en una configuración de despliegue (en un archivo compose local, un script docker run o una ruta dev/test es V19)
• V02: un servidor dev (vault server -dev, la imagen hashicorp/vault sin comando, server.dev.enabled) en una unidad systemd, una carga de trabajo de Kubernetes, valores de Helm, un job de Nomad o un archivo compose o Dockerfile con nombre de producción; las palabras de producción en la ruta prevalecen sobre las locales
• V03: una ruta de política que coincide con todas las rutas (* o +/*) con sudo o una capacidad de escritura
• V04: tokens de Vault (hvs., hvb., hvr. y los antiguos s., b., r.), claves de unseal y de recuperación, salida de init guardada, valores literales de VAULT_TOKEN, contraseñas escritas tras vault login y credenciales de seal o de almacenamiento escritas en una configuración (no se notifican los marcadores de posición ni el token root de dev; en los archivos .env.example solo los formatos de token reales)

REVIEW (revísalo antes del lanzamiento)

• V11: disable_mlock = true con un backend de almacenamiento distinto del almacenamiento integrado (comprueba que el swap esté desactivado o cifrado)
• V12: http:// sin cifrar hacia Vault en otro host, o comprobaciones de certificados desactivadas (tls_skip_verify, VAULT_SKIP_VERIFY, skip_tls_verify, tlsSkipVerify, la anotación tls-skip-verify)
• V13: escritura o sudo en un comodín que cubre todo un montaje (secret/*, kv/data/*, auth/*), o lectura en todas las rutas
• V14: permisos que elevan privilegios: la mayor parte de sys/, escribir cualquier política ACL (también las acotadas como app-*), sys/raw, dispositivos de auditoría, montajes de auth, generate-root, rekey, seal, el catálogo de plugins, sudo en auth/token/create, escribir entidades y grupos de identity
• V15: tls_min_version o tls_max_version establecidos en tls10 o tls11
• V16: raw_storage_endpoint, enable_unauthenticated_access, o métricas o pprof sin autenticación en un listener que no es loopback
• V17: ajustes que Vault rechaza o ignora: capacidades desconocidas como write, claves de ruta desconocidas, argumentos definidos dos veces (Vault 2.1), un * antes del final de una ruta, almacenamiento integrado sin disable_mlock (Vault 1.20), un listener TLS sin certificado
• V18: la antigua imagen oficial vault de Docker (última versión 1.13.3) o hashicorp/vault sin etiqueta o con latest
• V19: ajustes solo para desarrollo en un entorno local: TLS desactivado en todas las interfaces en un archivo compose o en una ruta dev/test, o el token root de dev usado mientras VAULT_ADDR apunta a otra máquina

Qué incluye

• El escáner (Python 3.9+, solo biblioteca estándar)
• Una guía de reglas con el motivo, la alternativa más segura y el enlace a la documentación oficial de HashiCorp para cada regla
• Un proyecto de ejemplo arriesgado y otro seguro (configuraciones de servidor y raft, políticas, una configuración de Agent, una unidad systemd, un archivo env, un archivo compose y salida de init guardada), y el informe real que el escáner genera sobre el arriesgado

Limitaciones

Lee los archivos tal como están escritos. Los dispositivos de auditoría, los métodos de autenticación y las políticas que realmente recibe un token residen en el almacenamiento de Vault y no son visibles. Cada ruta de política se evalúa por separado, las rutas con plantillas se tratan como texto fijo y las políticas Sentinel no se leen. La configuración predeterminada del chart vault-helm se ejecuta sin TLS en todas las interfaces, así que V01 salta en ella a propósito (el ejemplo compose de Docker Hub recibe V19); una service mesh que cifra el tráfico no es visible. Si un archivo es de despliegue o de un entorno local se decide por el tipo de archivo y las palabras de su ruta dentro del repositorio. NOT FLAGGED no es una garantía.

Contenido

Un archivo ZIP con 27 archivos: SKILL.md, el escáner en scripts/ (7 archivos Python), references/rules.md (cada regla con su motivo y su alternativa más segura) y examples/ (17 archivos de ejemplo más report.md, la salida real del escáner sobre el ejemplo arriesgado).

Cómo usarlo: Esto es una skill de agente: una carpeta con un archivo SKILL.md y scripts de Python que un agente de programación con IA como Claude Code, Cursor o Codex CLI puede ejecutar. Descomprímela en la carpeta de skills de tu agente (para Claude Code: ~/.claude/skills/) y pide a tu agente que revise tu proyecto. Los scripts también funcionan por sí solos con Python 3.9 o posterior, sin instalar nada. Solo leen tus archivos: sin acceso a la red y sin enviar nada a ningún sitio.