Bienvenido a la documentación de Vetro

Todo lo que necesitas para integrar Vetro, configurar reglas, usar el API REST y entender el proxy AST determinístico.

1 Descargar la imagen

Descarga la imagen del proxy de Vetro:

$ docker pull ghcr.io/vetro/vetro-proxy:latest

Siguiente: desplegar →

Primeros pasos

Empieza aquí Todo Vetro, de cero a producción La introducción completa: cómo funciona el proxy AST determinístico, cómo conectarlo y cómo proteger tus bases de datos en minutos. Leer la introducción Integración Conecta en menos de 5 minutos Sin cambios en tu código. Proxy TCP o API HTTP, con ejemplos para Docker, Kubernetes, ECS y tu pipeline de CI/CD. Ver la guía

Por qué Vetro

AST · Parsing determinístico

¿Qué es AST y por qué es la mejor opción?

Vetro parsea cada query a su Árbol de Sintaxis Abstracta (AST) — la misma representación estructural que usa tu base de datos, vía libpg_query — en lugar de adivinar con expresiones regulares o heurísticas. Analiza la estructura de la sentencia, no su texto: por eso detecta lo que las listas de permitidos y los regex no ven.

  • Cero falsos positivos. Determinístico: el mismo query siempre produce el mismo veredicto. Sin modelos probabilísticos, sin varianza.
  • Ve lo que otros no. Multi-statement, CTEs data-modifying (WITH … DELETE), subqueries e inyección por tautología (OR 1=1) — todo sobre el AST completo, multi-dialecto.
  • Rendimiento insuperable. La evaluación ocurre in-process en el proxy TCP, sin llamadas de red en el hot path. P99 < 2 ms.

Interceptación en el protocolo wire de PostgreSQL

'P' Parse — prepared statements evaluados en la fase Parse, antes de bindear valores. Protección independiente de los parámetros en runtime. 'Q' Simple Query — la sentencia completa se evalúa inline antes de ejecutarse. El query destructivo nunca llega a la base.
Ver la arquitectura completa

Formas de conectar

Recomendado Despliegue del proxy TCP La forma recomendada: el proxy intercepta el protocolo wire de PostgreSQL. Protección transparente, sin cambios en tu código. Despliégalo como prefieras. Docker Compose Kubernetes CDK / ECS API HTTP para CI/CD Evalúa queries y migraciones vía REST antes de desplegar, sin instalar el proxy. Ideal para validar cambios en tu pipeline. GitHub GitLab CircleCI Jenkins Lenguajes y ORMs Cualquier driver que hable el protocolo de PostgreSQL funciona sin cambios. Ejemplos para los ORMs y lenguajes más usados. Prisma SQLAlchemy TypeORM Drizzle Hibernate

Referencia

Reglas AST Catálogo completo de reglas VETRO-*: qué detectan, severidad, acción y dialectos soportados. VETRO-* Severidad Ejemplos de queries Casos reales lado a lado: qué se bloquea y por qué, qué pasa, y los casos edge más comunes. DELETE DROP Edge cases Reglas personalizadas Extiende el ruleset con condiciones YAML sobre el AST: esquema, tipos de nodo, condiciones, API y previsualización. YAML API REST

Seguridad y comunidad

Seguridad y cumplimiento Arquitectura zero-trust, cifrado y almacenamiento, autenticación, compliance SOC2/ISO 27001 y reporte de vulnerabilidades. Zero-trust SOC2 ISO 27001 Comunidad en Discord Únete a la comunidad de Vetro: resuelve dudas, comparte reglas custom y recibe soporte de otros desarrolladores y del equipo. Unirse al Discord ¿Necesitas ayuda? ¿No encuentras lo que buscas o tienes un caso de uso que la documentación no cubre? Contáctanos por el canal adecuado. Ver contactos