auditoria-de-seguridad
Skill1 starsChanged 5 months agoMITView on GitHub
Auditoria de seguridad ofensiva y defensiva de tu app Next.js + Supabase. Piensa como ATACANTE: intenta romper los candados (secretos expuestos, RLS debil, IDOR/escalacion de privilegios, headers faltantes, inyeccion XSS/SQLi/SSRF, endpoints de prueba olvidados, webhooks sin auth, dependencias vulnerables, inyeccion de prompts en agentes IA), caza lo que se escapo, y lo ARREGLA en un loop caza-arregla-revalida con triage por severidad. Activar cuando el usuario dice: auditoria de seguridad, busca huecos de seguridad, pentest, red team, /auditoria-de-seguridad. OBLIGATORIA antes de un lanzamiento publico o entrega a cliente, y ante cualquier cambio que toque auth/RLS/secrets/pagos.
- Reads credentials
In this repository5 other files it gives its agents.
- auditoria-performanceSkill
- auditoria-profundaSkill
- publicarSkill
- save-statusSkill
- validacion-visualSkill
The file
Files
Auditoria de seguridad — El cazador adversario
"La app funciona, respeta la configuracion, va rapida y se ve bien. Aun asi, una tabla puede tener una policy
USING(true)que deja a cualquiera con la llave publica (que esta en el HTML) leer los datos de todos los usuarios. Nadie lo vio porque la app funciona. Esa es la clase de hueco que esta skill caza — pensando como el atacante, no como el usuario."
Esta skill es el complemento ofensivo de validacion-visual: aquella prueba que la app funciona; ésta intenta romperla. Recorre 7 dimensiones de ataque, asigna severidad a cada hallazgo, y arregla en un bucle caza-arregla-revalida.
Las 7 dimensiones
D1 — Secretos y exposición
¿Hay credenciales filtradas en el código, en el bundle que ve el navegador, o en git?
- Grep del repo por patrones de secreto:
eyJ(JWT),sk-,service_role,SECRET,PRIVATE_KEY,password\s*=,BEGIN.*PRIVATE KEY. - Confirmar que
.env.local/.env*están en.gitignorey nunca se commitearon (git log --all -- .env*). - Llave maestra en el cliente: grep de
SUPABASE_SERVICE_ROLE_KEYocreateAdminClienten archivos'use client'→ CRÍTICO si aparece. NEXT_PUBLIC_*que filtra: solo deben ser públicas la URL de Supabase, la anon key y sitekeys de captcha. Cualquier otro secreto con ese prefijo se filtra al navegador.- Buscar secretos en el bundle de producción (
.next/static/**/*.jsy el HTML servido). La anon key es pública por diseño; cualquier OTRO secreto = CRÍTICO.
D2 — Base de datos / Supabase (RLS, grants, funciones)
- Los advisors de seguridad de Supabase → 0 errores (los warnings se evalúan caso a caso).
- RLS habilitado en TODAS las tablas públicas:
SELECT relname FROM pg_class WHERE relnamespace='public'::regnamespace AND relkind='r' AND relrowsecurity=false; -- debe estar vacío - Ninguna policy
USING(true)/WITH CHECK(true)sin justificación explícita:SELECT tablename, policyname, cmd, qual, with_check FROM pg_policies WHERE schemaname='public' AND (qual='true' OR with_check='true'); - Funciones
SECURITY DEFINERinvocables por anon/authenticated sin justificación → revisarREVOKE. - Funciones con
search_pathmutable (riesgo de schema hijack). - Tablas server-only con
REVOKE ALL FROM anon, authenticated; buckets de Storage privados salvo justificación.
D3 — Control de acceso ofensivo (IDOR, escalación, bypass)
Con dos usuarios de prueba A y B:
- IDOR: B intenta acceder a recursos de A por ID directo en URL y en cada API (
GET/PATCH/DELETE /recurso/[id_de_A]). Debe dar 403/404, nunca el recurso. - Bypass de middleware: pegar URLs protegidas sin sesión; confirmar que la protección es server-side, no solo un guard de cliente. Probar también las server actions y route handlers directamente.
- Escalación de privilegios: un usuario normal intenta acciones de admin (endpoints, server actions, paneles
/admin/*). Manipular el rol en el cliente y confirmar que el server lo re-valida. - Manipulación de sesión: alterar la cookie/JWT, usar uno expirado, reusar el de otro usuario.
- Multi-tenant: si hay
organization_id, cruzar tenants.
D4 — Headers de seguridad y CSP
curl -I contra producción + revisar next.config:
- Presencia y valor de
Strict-Transport-Security,X-Frame-Options(oframe-ancestors),X-Content-Type-Options: nosniff,Referrer-Policy,Permissions-Policy,Content-Security-Policy. - CSP:
object-src 'none',frame-ancestors,base-uri 'self'. (Next.js suele requerirunsafe-inline/unsafe-evalpara hidratar — documentarlo como aceptado, no como bug.) - Cookies de auth con
Secure+HttpOnly+SameSite; HTTPS forzado.
D5 — Inyección y validación de entrada
- XSS: grep de
dangerouslySetInnerHTML,innerHTML, render de input sin escapar. Probar payloads<script>,"><img onerror>en campos y parámetros de URL. - SQLi: PostgREST parametriza por defecto; el riesgo real es SQL crudo (
rpcmal construido, interpolación de strings en queries). Grep de concatenación en queries. - SSRF: endpoints que hacen
fetcha una URL derivada de input del usuario (proxies de imagen, webhooks). Verificar allowlist de hosts. - Path traversal en Storage / manejo de archivos (
../, paths absolutos). - Mass assignment: server actions que hacen
update(body)con todo el body sin allowlist → un atacante setearole: 'admin'o unuser_idajeno.
D6 — Endpoints públicos, webhooks y supply chain
- Endpoints de prueba olvidados: grep de
/api/public/dev-*,/api/debug,/api/test,dev-magic-session. (Las skills de QA crean endpoints temporales; confirmar que se borraron.) Probar en producción. - Webhooks: todos los
/api/webhooks/*deben verificar origen (HMAC, signature, secret-per-request). Webhook sin secret → debe dar 401/400. - Rate limiting: login/signup/forgot-password y endpoints con LLM deben limitar intentos (fuerza bruta + abuso de tokens). Ráfaga → 429 o captcha.
- Métodos HTTP: endpoints que solo aceptan POST rechazan GET/PUT/DELETE (405).
- CORS: sin
Access-Control-Allow-Origin: *en endpoints con datos. - Supply chain:
npm audit --omit=dev→ revisar críticas/altas. Lockfile commiteado.
D7 — Seguridad de IA (solo si el proyecto tiene agente/LLM)
Auto-detección: si hay un asistente/chat con LLM, activar; si no, omitir y aclararlo.
- Prompt injection: "ignora tus instrucciones", pedir que revele su system prompt o su stack técnico.
- Guardrails: confirmar que el asistente rechaza usos fuera de su función.
- Exfiltración: intentar que devuelva datos de otros usuarios vía su herramienta de búsqueda o tools.
- Sanitizer de salida: que filtre datos sensibles antes de mostrarlos.
- Límite de gasto: rate limit del chat para que nadie drene tu presupuesto de tokens.
Triage por severidad (esto define qué bloquea la publicación)
| Severidad | Definición | Efecto |
| Crítico | Explotable hoy, expone datos/credenciales o da acceso no autorizado (secret en cliente, IDOR, RLS off sobre datos sensibles, endpoint dev en prod) | BLOQUEA la publicación. |
| Alto | Explotable con esfuerzo, o defensa importante ausente (sin CSP, webhook sin auth) | Bloquea entrega/lanzamiento. Se arregla. |
| Medio | Riesgo real pero acotado | No bloquea; se arregla si es barato. |
| Bajo | Higiene / defensa en profundidad | Recomendación documentada. |
Autonomía: se pausa por IMPACTO, no por dificultad técnica
Arreglar al momento (reversible con git): código, headers, CSP, validaciones, guards, sanitización, allowlists, RLS/policies/grants faltantes (verificando que no se deje fuera ningún acceso legítimo), borrar endpoints de prueba, npm audit fix sin breaking.
Pausar y preguntar (decisión de negocio): rotar una credencial (puede tumbar una integración viva — el cuándo lo decide el dueño), tocar datos reales de producción, un cambio que podría dejar fuera a usuarios reales, algo con costo o irreversible, o un crítico que requiere rediseño.
Modulación por tráfico: app sin usuarios → autonomía máxima. App con clientes reales → más cuidado con lo que toca acceso/datos/sesiones; ante la duda, verificar antes de cerrar.
El flujo
- Mapear la superficie de ataque: rutas, API routes, webhooks, server actions, páginas admin, tablas, si hay agente IA (activa D7), si hay pagos. Detectar si la app tiene usuarios reales en producción (modula la autonomía).
- Setup (si hay auth): crear dos usuarios de prueba A y B; borrarlos al final.
- Ejecutar las 7 dimensiones en orden. Cada hallazgo: severidad + evidencia + causa raíz.
- Loop caza-arregla-revalida: arreglar lo de bajo impacto al momento (y re-probar el vector); pausar lo que es decisión de negocio. Un crítico sin resolver bloquea.
- Limpieza OBLIGATORIA: borrar usuarios de prueba, registros y payloads de prueba (NUNCA dejar un
<script>de prueba persistido en la base), endpoints temporales; cerrar el navegador. - Reporte + autorización: resumen por severidad (encontrados / arreglados / pausados). El push/deploy SIEMPRE lo autoriza el dueño.
Reglas duras
- Scope estrictamente defensivo: solo TUS apps. Nunca targets externos.
- Mentalidad adversaria real (intentar romper, no marcar checkboxes) pero sin causar daño (no DoS real, no borrar datos, payloads inertes).
- Se pausa por impacto de negocio, no por dificultad técnica.
- Un crítico bloquea la publicación. Sin excepción.
- Cada hallazgo lleva severidad — sin severidad no hay triage.
- Todo cambio de RLS se re-valida contra los flujos reales, para confirmar que no rompió acceso legítimo.
- NUNCA dejar payloads de prueba persistidos en la base o el Storage.
- Secretos jamás al chat, logs o screenshots. Los scripts leen
.env.localy no imprimen secretos. - El push/deploy final SIEMPRE lo autoriza el dueño.
- Si una dimensión no aplica (sin auth, sin IA, sin pagos), aclararlo — no saltarla en silencio.
Anti-patrones (prohibidos)
- "Corrí el advisor y dio 0, listo." → El advisor es solo D2. Faltan IDOR, headers, inyección, endpoints, supply chain, IA.
- "Pausé el fix porque era complejo." → Se pausa por consecuencia de negocio, no por dificultad.
- "Arreglé la policy RLS y seguí sin probar." → Todo cambio de RLS se re-valida contra los flujos reales.
- "Dejé el payload
<script>de prueba en la base." - "Encontré un crítico pero el resto estaba bien, aprobé." → Un crítico sin resolver BLOQUEA.
- "La app no tiene pagos, así que omití todo." → Solo se omite la dimensión que no aplica; las demás corren.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

