Guía de seguridad / Aplicaciones Next.js

Checklist de seguridad de Next.js para Server Actions y APIs

Revisa los Server Actions, los route handlers, la autorización, las fronteras con el cliente y la exposición de secretos en Next.js antes de tu próxima release con App Router.

Por Bryxe Shield · Actualizado · Política editorial

¿Están realmente protegidos mis Server Actions?

Trata cada Server Action o route handler invocable como un punto de entrada que necesita su propia validación y sus propias comprobaciones de permisos. Revisa la frontera entre servidor y cliente y luego prueba si un usuario sin autenticar o una cuenta distinta puede llegar a datos o mutaciones protegidos.

Para quién es: Equipos con Next.js App Router que lanzan dashboards, funciones de IA, suscripciones y portales de clientes.

PASO 01

Identifica los endpoints por su comportamiento, no por el nombre de la carpeta

Una página puede exigir inicio de sesión mientras una mutación relacionada acepta peticiones sin comprobar quién llama. Haz una lista de las acciones que cambian roles, exportan datos, crean sesiones de checkout o actualizan los ajustes de la cuenta. Para cada una, identifica la función de acceso a datos que invoca. Centralizar las comprobaciones de permisos facilita esa revisión, pero sigue haciendo falta probar en el punto de entrada.

Prueba esto: Elige una operación sensible y pruébala sin sesión, con una cuenta normal y con una cuenta autorizada.

PASO 02

Devuelve solo los datos que necesita la interfaz

Revisa los objetos que pasan del código de servidor a los componentes de cliente. Una consulta cómoda que devuelve el registro completo de una cuenta puede exponer campos que la UI nunca muestra. Separa los datos públicos de la vista de los campos internos, como tokens, identificadores de facturación y flags de administración. Comprueba tanto las respuestas de error como las de éxito.

Prueba esto: Inspecciona la respuesta real de una página sensible y confirma que contiene solo los campos previstos.

PASO 03

Revisa la configuración como parte de la release

Un cambio en el código fuente es solo una de las entradas del build de una aplicación. Las variables de entorno, las versiones de las dependencias, las decisiones de caché y los ajustes de despliegue influyen en el comportamiento expuesto. Sigue la versión de Next.js instalada y sus actualizaciones de seguridad. Haz la revisión sobre el build de la release para que las suposiciones propias de desarrollo no oculten un problema de producción.

Prueba esto: Acompaña los hallazgos del código fuente con un smoke test del artefacto de la release y una auditoría de dependencias de las versiones de paquetes resueltas.

Tu checklist de revisión

  • Autentica y autoriza cada acción y handler sensible.
  • Valida las entradas no confiables antes de operaciones de base de datos o de red.
  • Selecciona solo los campos necesarios en las respuestas de cara al cliente.
  • Mantén las credenciales del servidor fuera de las variables de entorno públicas.
  • Prueba con dos cuentas el acceso a respuestas en caché o específicas de cada tenant.
  • Revisa las dependencias, la configuración de despliegue y el build de la release.

Qué puede revisar Bryxe

Bryxe incluye comprobaciones de patrones compatibles de JavaScript y TypeScript, credenciales expuestas y operaciones de riesgo en proyectos web modernos. Su herramienta específica de código es útil mientras revisas un handler o un Server Action.

Lo que aún debes verificar

Los hallazgos estáticos necesitan el contexto de la aplicación. Un escáner no puede deducir todos tus permisos de negocio ni verificar cada frontera de caché desplegada. Las protecciones del framework no sustituyen a las pruebas de autorización a nivel de aplicación.

Preguntas frecuentes

¿use server convierte una acción en privada?

No. Trata los Server Actions invocables como operaciones accesibles desde fuera y comprueba la identidad y los permisos de quien llama antes de realizar trabajo sensible. Una frontera de ejecución en el servidor no es una política de autorización.

¿Basta con proteger una página para proteger su API?

Revisa la API por separado. Quien llama puede llegar al endpoint sin usar tu página. Confirma que la capa de acceso a datos o el handler aplican el permiso que tu UI da por supuesto.

¿Con qué versión de Next.js debo auditar?

Usa la versión instalada en tu proyecto y su documentación correspondiente. Revisa los avisos de seguridad oficiales y prueba las actualizaciones antes de la release. No copies suposiciones de una guía escrita para otra versión mayor.

Documentación y lecturas adicionales

Estas fuentes primarias explican el comportamiento de la plataforma descrito arriba. Consulta la documentación de las versiones y la configuración que usas.

Continúa tu revisión de seguridad