| name | supabase-policy-security-auditor |
| description | Audita RLS, políticas de Storage, Auth/JWT y Edge Functions/Realtime de Supabase self-hosted en modo lectura sin mutar la base de datos ni revelar secretos. |
Supabase Policy Security Auditor
Usa esta skill cuando el usuario quiera revisar la postura de seguridad de las políticas de una instancia Supabase self-hosted: Row Level Security, Storage, Auth/JWT y Edge Functions/Realtime. Confirma host, usuario, alcance y ventana antes de inspeccionar.
Alcance
Cubre cuatro dominios de políticas, siempre en modo lectura:
- Row Level Security (RLS): tablas con y sin RLS, políticas por tabla, comandos (
SELECT/INSERT/UPDATE/DELETE), roles, condiciones USING/WITH CHECK, funciones SECURITY DEFINER y políticas force/permissive.
- Storage: buckets públicos/privados, políticas de Storage, reglas MIME/tamaño y permisos por objeto.
- Auth/JWT: proveedores habilitados, expiración y algoritmo de JWT, claves de firma (nombre, nunca valor), roles
anon/authenticated/service_role y sesiones.
- Edge Functions/Realtime: funciones desplegadas, secrets/config (nombre, nunca valor), permisos JWT de Edge Functions y políticas de Realtime.
Reglas de seguridad
- Solo ejecuta consultas
SELECT de lectura contra catálogos (pg_catalog, information_schema, pg_policies, storage.buckets, storage.policies, vistas de supabase_functions).
- No ejecutes
INSERT, UPDATE, DELETE, ALTER, DROP, TRUNCATE, GRANT, REVOKE, CREATE POLICY, DROP POLICY, ni supabase CLI que cree/modifique/borre recursos.
- No leas valores de secretos, JWT firmados, claves de firma (
JWT_SECRET, anon key, service_role key), contraseñas ni Authorization. Reporta solo la presencia/nombre y la expiración cuando sea observable.
- Redacta tokens, contraseñas, URLs con credenciales, headers
Authorization y cualquier secret/config de Edge Functions.
- No reinicies servicios, no edites
.env, Compose, migraciones, ni políticas durante una auditoría.
- Marca como
WARNING/CRITICAL cualquier valor no verificable sin convertirlo en un secreto visible.
- No consulta datos reales de tablas de usuario; solo metadatos de políticas y buckets.
Flujo
- Verifica el alias SSH, usuario, cliente
psql/ssh, clave y known_hosts mediante el plugin VPS SSH Manager; identifica el contenedor de Postgres y el rol de conexión de solo lectura.
- Lista tablas del esquema
public y auth y determina cuáles tienen RLS habilitado.
- Inspecciona
pg_policies y catálogos para obtener políticas por tabla, comando, rol, qual/with_check y función SECURITY DEFINER.
- Inspecciona
storage.buckets y storage.policies para buckets públicos y reglas; reporta exposición sin leer objetos.
- Verifica proveedores de Auth, presencia de
JWT_SECRET/claves (nombre, no valor) y algoritmos/expiración cuando sea observable sin firmar tokens.
- Lista Edge Functions desplegadas y su
config/secrets (nombres), y políticas de Realtime; no invocas funciones ni publicas eventos.
- Resume hallazgos por dominio con timestamp UTC, recurso, control, evidencia redactada, severidad y remediación propuesta. Para remediar, genera un plan separado y pide confirmación explícita.
Consultas permitidas
SELECT n.nspname, c.relname, c.relrowsecurity, c.relforcerowsecurity
FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
WHERE n.nspname IN ('public','auth') AND c.relkind = 'r';
SELECT schemaname, tablename, policyname, permissive, roles, cmd, qual, with_check
FROM pg_policies WHERE schemaname IN ('public','auth');
SELECT n.nspname AS schema, p.proname, p.prosecdef
FROM pg_proc p JOIN pg_namespace n ON n.oid = p.pronamespace
WHERE n.nspname IN ('public','auth','storage') AND p.prosecdef = true;
SELECT id, name, public, file_size_limit, allowed_mime_types FROM storage.buckets;
SELECT policyname, tablename, policyname AS storage_policy, cmd, qual FROM storage.policies;
No ejecutes docker exec contra PostgreSQL para leer .env, no uses supabase functions deploy/serve, no firmes ni valides JWT con claves reales y no alteres políticas desde esta skill.
Validación
Ejecuta python scripts/validate_policy_security_scope.py --command-file <archivo> cuando se prepare una lista de comandos/SQL. Debe terminar con PASSED; cualquier sentencia mutante, secreto en texto plano o CLI que cree/modifique/borre queda bloqueado.
