Next.js + Supabase Auth
Integración experta de Supabase Auth con el App Router de Next.js
Capacidades
- nextjs-auth
- supabase-auth-nextjs
- auth-middleware
- auth-callback
Prerrequisitos
- Habilidades requeridas: nextjs-app-router, supabase-backend
Patrones
Configuración del Cliente Supabase
Crear clientes Supabase correctamente configurados para diferentes contextos
Cuándo usarlo: Configurando autenticación en un proyecto Next.js
// lib/supabase/client.ts (Cliente de navegador)
'use client'
import { createBrowserClient } from '@supabase/ssr'
export function createClient() {
return createBrowserClient(
process.env.NEXT_PUBLIC_SUPABASE_URL!,
process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
)
}
// lib/supabase/server.ts (Cliente de servidor)
import { createServerClient } from '@supabase/ssr'
import { cookies } from 'next/headers'
export async function createClient() {
const cookieStore = await cookies()
return createServerClient(
process.env.NEXT_PUBLIC_SUPABASE_URL!,
process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
{
cookies: {
getAll() {
return cookieStore.getAll()
},
setAll(cookiesToSet) {
cookiesToSet.forEach(({ name, value, options }) => {
cookieStore.set(name, value, options)
})
},
},
}
)
}
Middleware de Autenticación
Proteger rutas y renovar sesiones en el middleware
Cuándo usarlo: Necesitas protección de rutas o renovación de sesiones
// middleware.ts
import { createServerClient } from '@supabase/ssr'
import { NextResponse, type NextRequest } from 'next/server'
export async function middleware(request: NextRequest) {
let response = NextResponse.next({ request })
const supabase = createServerClient(
process.env.NEXT_PUBLIC_SUPABASE_URL!,
process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
{
cookies: {
getAll() {
return request.cookies.getAll()
},
setAll(cookiesToSet) {
cookiesToSet.forEach(({ name, value, options }) => {
response.cookies.set(name, value, options)
})
},
},
}
)
// Renovar sesión si ha expirado
const { data: { user } } = await supabase.auth.getUser()
// Proteger rutas del dashboard
if (request.nextUrl.pathname.startsWith('/dashboard') && !user) {
return NextResponse.redirect(new URL('/login', request.url))
}
return response
}
export const config = {
matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
}
Ruta de Callback de Autenticación
Manejar el callback OAuth e intercambiar el código por una sesión
Cuándo usarlo: Usando proveedores OAuth (Google, GitHub, etc.)
// app/auth/callback/route.ts
import { createClient } from '@/lib/supabase/server'
import { NextResponse } from 'next/server'
export async function GET(request: Request) {
const { searchParams, origin } = new URL(request.url)
const code = searchParams.get('code')
const next = searchParams.get('next') ?? '/'
if (code) {
const supabase = await createClient()
const { error } = await supabase.auth.exchangeCodeForSession(code)
if (!error) {
return NextResponse.redirect(`${origin}${next}`)
}
}
return NextResponse.redirect(`${origin}/auth/error`)
}
Autenticación en Acciones del Servidor
Manejar operaciones de autenticación en Acciones del Servidor
Cuándo usarlo: Inicio de sesión, cierre de sesión o registro desde Componentes del Servidor
// app/actions/auth.ts
'use server'
import { createClient } from '@/lib/supabase/server'
import { redirect } from 'next/navigation'
import { revalidatePath } from 'next/cache'
export async function signIn(formData: FormData) {
const supabase = await createClient()
const { error } = await supabase.auth.signInWithPassword({
email: formData.get('email') as string,
password: formData.get('password') as string,
})
if (error) {
return { error: error.message }
}
revalidatePath('/', 'layout')
redirect('/dashboard')
}
export async function signOut() {
const supabase = await createClient()
await supabase.auth.signOut()
revalidatePath('/', 'layout')
redirect('/')
}
Obtener Usuario en Componente del Servidor
Acceder al usuario autenticado en Componentes del Servidor
Cuándo usarlo: Renderizando contenido específico del usuario en el lado del servidor
// app/dashboard/page.tsx
import { createClient } from '@/lib/supabase/server'
import { redirect } from 'next/navigation'
export default async function DashboardPage() {
const supabase = await createClient()
const { data: { user } } = await supabase.auth.getUser()
if (!user) {
redirect('/login')
}
return (
<div>
<h1>Bienvenido, {user.email}</h1>
</div>
)
}
Validaciones
Usar getSession() para Verificaciones de Autenticación
Severidad: ERROR
Mensaje: getSession() no verifica el JWT. Usa getUser() para verificaciones de autenticación seguras.
Acción de corrección: Reemplazar getSession() por getUser() para verificaciones críticas de seguridad
OAuth Sin Ruta de Callback
Severidad: ERROR
Mensaje: Usando OAuth pero falta la ruta de callback en app/auth/callback/route.ts
Acción de corrección: Crear app/auth/callback/route.ts para manejar redirecciones OAuth
Cliente de Navegador en Contexto del Servidor
Severidad: ERROR
Mensaje: Cliente de navegador usado en contexto de servidor. Usa createServerClient en su lugar.
Acción de corrección: Importar y usar createServerClient desde @supabase/ssr
Rutas Protegidas Sin Middleware
Severidad: ADVERTENCIA
Mensaje: No se encontró middleware.ts. Considera agregar middleware para protección de rutas.
Acción de corrección: Crear middleware.ts para proteger rutas y renovar sesiones
URL de Redirección de Autenticación Hardcodeada
Severidad: ADVERTENCIA
Mensaje: Redirección localhost hardcodeada. Usa origin para flexibilidad de entorno.
Acción de corrección: Usar window.location.origin o process.env.NEXT_PUBLIC_SITE_URL
Llamada de Autenticación Sin Manejo de Errores
Severidad: ADVERTENCIA
Mensaje: Operación de autenticación sin manejo de errores. Siempre verifica los errores.
Acción de corrección: Desestructurar { data, error } y manejar el caso de error
Acción de Autenticación Sin Revalidación
Severidad: ADVERTENCIA
Mensaje: Acción de autenticación sin revalidatePath. El caché puede mostrar estado de autenticación obsoleto.
Acción de corrección: Agregar revalidatePath('/', 'layout') después de operaciones de autenticación
Protección de Rutas Solo del Lado del Cliente
Severidad: ADVERTENCIA
Mensaje: La protección de rutas del lado del cliente muestra un destello de contenido. Usa middleware.
Acción de corrección: Mover la protección a middleware.ts para mejor experiencia de usuario
Colaboración
Disparadores de Delegación
- database|rls|queries|tables -> supabase-backend (Auth necesita la capa de base de datos)
- route|page|component|layout -> nextjs-app-router (Auth necesita patrones de Next.js)
- deploy|production|vercel -> vercel-deployment (Auth necesita configuración de despliegue)
- ui|form|button|design -> frontend (Auth necesita componentes de UI)
Stack Completo de Autenticación
Habilidades: nextjs-supabase-auth, supabase-backend, nextjs-app-router, vercel-deployment
Flujo de trabajo:
1. Configuración de base de datos (supabase-backend)
2. Implementación de autenticación (nextjs-supabase-auth)
3. Protección de rutas (nextjs-app-router)
4. Configuración de despliegue (vercel-deployment)
SaaS Protegido
Habilidades: nextjs-supabase-auth, stripe-integration, supabase-backend
Flujo de trabajo:
1. Autenticación de usuario (nextjs-supabase-auth)
2. Sincronización de clientes (stripe-integration)
3. Control de suscripciones (supabase-backend)
Habilidades Relacionadas
Funciona bien con: nextjs-app-router, supabase-backend
Cuándo Usar
- El usuario menciona o implica: supabase auth next
- El usuario menciona o implica: authentication next.js
- El usuario menciona o implica: login supabase
- El usuario menciona o implica: auth middleware
- El usuario menciona o implica: protected route
- El usuario menciona o implica: auth callback
- El usuario menciona o implica: session management
Limitaciones
- Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trates la salida como un sustituto de la validación específica del entorno, las pruebas o la revisión de expertos.
- Detente y pide aclaraciones si faltan las entradas requeridas, los permisos, los límites de seguridad o los criterios de éxito.