Tu SaaS permite que cada cliente descargue sus facturas. En la guía anterior enviamos fotos públicas directamente a Vercel Blob; copiar ese patrón para facturas sería una mala decisión. Una URL pública puede circular fuera de tu app. Para documentos de clientes, Vercel ofrece Blob privado: el archivo requiere autenticación en el almacenamiento y tu aplicación decide qué usuario puede leerlo.
La decisión de arquitectura
La protección tiene dos capas. Blob privado bloquea la descarga directa de quien no tenga credenciales del almacenamiento. Tu ruta de Next.js comprueba la sesión del cliente y la propiedad de la factura antes de pedir el archivo con el SDK. Una sesión válida no basta: Ana no debe poder pedir la factura de Luis cambiando un ID en la URL. Por eso la consulta a la base de datos filtra por ID de factura y propietario.
Vercel documenta Blob en todos los planes y exige una tienda privada. Para esta función se necesita @vercel/blob 2.3 o posterior. En Vercel, el SDK usa OIDC por defecto para obtener credenciales que rotan; si trabajas fuera de Vercel, revisa cómo configurar el token de servidor. El navegador nunca debe recibir el token de lectura y escritura de la tienda.
Prepara los datos
Supongamos Next.js App Router, Auth.js en @/auth y Prisma en @/lib/db. Cada registro de factura guarda el blobPathname devuelto al subir el archivo, además de su dueño. Un esquema mínimo para el ejemplo sería:
model Invoice {
id String @id @default(cuid())
ownerEmail String
blobPathname String
}
Usar correo simplifica el ejemplo, pero en producción conviene un ID de usuario estable y una relación explícita. Al subir la factura, valida quién puede crearla y guarda el pathname en la misma lógica de negocio que registra la factura. La subida desde navegador puede usar access: 'private' con una tienda privada y un token emitido después de comprobar la sesión. No permitas que el cliente decida libremente a quién pertenece el archivo.
Ruta de descarga con permiso por factura
Crea app/api/invoices/[invoiceId]/download/route.ts. El ID de la URL solo selecciona una fila que también debe pertenecer al usuario autenticado. El pathname real sale de la base de datos, no de un parámetro enviado por el navegador.
import { get } from '@vercel/blob';
import { auth } from '@/auth';
import { db } from '@/lib/db';
export async function GET(
_request: Request,
{ params }: { params: Promise<{ invoiceId: string }> }
) {
const session = await auth();
if (!session?.user?.email) {
return new Response('No autorizado', { status: 401 });
}
const { invoiceId } = await params;
const invoice = await db.invoice.findFirst({
where: { id: invoiceId, ownerEmail: session.user.email },
select: { blobPathname: true },
});
if (!invoice) return new Response('No encontrado', { status: 404 });
const result = await get(invoice.blobPathname, { access: 'private' });
if (result?.statusCode !== 200) {
return new Response('No encontrado', { status: 404 });
}
return new Response(result.stream, {
headers: {
'Content-Type': result.blob.contentType,
'Content-Disposition': 'attachment',
'X-Content-Type-Options': 'nosniff',
'Cache-Control': 'private, no-store',
},
});
}
El SDK hace la lectura autenticada de Blob, mientras la ruta hace la autorización de negocio. private, no-store evita guardar una factura sensible en caché del navegador; Vercel recomienda ese valor para datos sensibles. No añadas caché compartida a esta respuesta. Si quieres descargas grandes o muchas descargas, revisa el costo de transferencia y el tiempo de Function antes de escalar el flujo.
Errores de implementación que sí cambian el riesgo
No aceptes ?pathname=... desde el cliente y lo pases directamente a get. Aunque la tienda sea privada, tu servidor sí tiene credenciales; una ruta así permitiría que un usuario autenticado intentara leer archivos ajenos. Tampoco confíes solo en ocultar el botón de descarga en la interfaz: la API sigue siendo accesible. Mantén la comprobación de propiedad dentro de la ruta que entrega bytes, cerca de get, y evita registrar en logs el contenido o tokens de la factura. Si permites enlaces temporales de descarga, revisa su vigencia y alcance por separado.
Cuatro pruebas antes de publicar
- Sin sesión, la ruta debe responder 401 sin pedir el blob.
- Con sesión de otro cliente, el mismo ID debe responder 404. No debe revelar si la factura existe.
- Con el dueño correcto, la ruta debe entregar el archivo y los encabezados de tipo, descarga y caché.
- La URL privada directa del blob, abierta sin credenciales de servidor, no debe entregar el archivo.
Prueba también el caso de factura eliminada y de pathname roto. El código es un patrón documentado y adaptado a Prisma/Auth.js, no una prueba desplegada en una cuenta Vercel propia. No se midieron costos ni latencia; consulta los precios vigentes de Blob con tu volumen esperado. La diferencia con la guía de fotos públicas es la decisión que importa: un archivo de cliente necesita control de lectura por usuario en cada descarga, además de una tienda privada.
