Next.js + Supabase Auth
Integração especializada do Supabase Auth com o Next.js App Router
Capacidades
- nextjs-auth
- supabase-auth-nextjs
- auth-middleware
- auth-callback
Pré-requisitos
- Habilidades necessárias: nextjs-app-router, supabase-backend
Padrões
Configuração do Cliente Supabase
Crie clientes Supabase configurados corretamente para diferentes contextos
Quando usar: Configurando autenticação em um projeto Next.js
// lib/supabase/client.ts (Cliente do 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 do 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 Autenticação
Proteja rotas e atualize sessões no middleware
Quando usar: Você precisa de proteção de rotas ou atualização de sessão
// 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)
})
},
},
}
)
// Atualizar sessão se expirada
const { data: { user } } = await supabase.auth.getUser()
// Proteger rotas do 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).*)'],
}
Rota de Callback de Autenticação
Lide com o callback OAuth e troque o código pela sessão
Quando usar: Usando provedores 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`)
}
Autenticação em Ações do Servidor
Lide com operações de autenticação em Server Actions
Quando usar: Login, logout ou cadastro a partir de Server Components
// 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('/')
}
Obter Usuário em Server Component
Acesse o usuário autenticado em Server Components
Quando usar: Renderizando conteúdo específico do usuário no lado do 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>Bem-vindo, {user.email}</h1>
</div>
)
}
Verificações de Validação
Usar getSession() para Verificações de Autenticação
Severidade: ERRO
Mensagem: getSession() não verifica o JWT. Use getUser() para verificações seguras de autenticação.
Ação de correção: Substitua getSession() por getUser() para verificações críticas de segurança
OAuth Sem Rota de Callback
Severidade: ERRO
Mensagem: Usando OAuth, mas faltando a rota de callback em app/auth/callback/route.ts
Ação de correção: Crie app/auth/callback/route.ts para lidar com redirecionamentos OAuth
Cliente do Navegador em Contexto de Servidor
Severidade: ERRO
Mensagem: Cliente do navegador usado em contexto de servidor. Use createServerClient.
Ação de correção: Importe e use createServerClient de @supabase/ssr
Rotas Protegidas Sem Middleware
Severidade: AVISO
Mensagem: Nenhum middleware.ts encontrado. Considere adicionar middleware para proteção de rotas.
Ação de correção: Crie middleware.ts para proteger rotas e atualizar sessões
URL de Redirecionamento de Autenticação Fixa
Severidade: AVISO
Mensagem: Redirecionamento localhost fixo. Use origin para flexibilidade de ambiente.
Ação de correção: Use window.location.origin ou process.env.NEXT_PUBLIC_SITE_URL
Chamada de Autenticação Sem Tratamento de Erro
Severidade: AVISO
Mensagem: Operação de autenticação sem tratamento de erro. Sempre verifique erros.
Ação de correção: Desestruture { data, error } e trate o caso de erro
Ação de Autenticação Sem Revalidação
Severidade: AVISO
Mensagem: Ação de autenticação sem revalidatePath. O cache pode mostrar estado de autenticação desatualizado.
Ação de correção: Adicione revalidatePath('/', 'layout') após operações de autenticação
Proteção de Rota Apenas no Cliente
Severidade: AVISO
Mensagem: Proteção de rota no lado do cliente mostra flash de conteúdo. Use middleware.
Ação de correção: Mova a proteção para middleware.ts para melhor UX
Colaboração
Gatilhos de Delegação
- database|rls|queries|tables -> supabase-backend (Auth precisa da camada de banco de dados)
- route|page|component|layout -> nextjs-app-router (Auth precisa de padrões Next.js)
- deploy|production|vercel -> vercel-deployment (Auth precisa de configuração de deploy)
- ui|form|button|design -> frontend (Auth precisa de componentes de UI)
Stack Completo de Autenticação
Habilidades: nextjs-supabase-auth, supabase-backend, nextjs-app-router, vercel-deployment
Fluxo de trabalho:
1. Configuração do banco de dados (supabase-backend)
2. Implementação de autenticação (nextjs-supabase-auth)
3. Proteção de rotas (nextjs-app-router)
4. Configuração de deploy (vercel-deployment)
SaaS Protegido
Habilidades: nextjs-supabase-auth, stripe-integration, supabase-backend
Fluxo de trabalho:
1. Autenticação de usuário (nextjs-supabase-auth)
2. Sincronização de cliente (stripe-integration)
3. Controle de acesso por assinatura (supabase-backend)
Habilidades Relacionadas
Funciona bem com: nextjs-app-router, supabase-backend
Quando Usar
- O usuário menciona ou implica: supabase auth next
- O usuário menciona ou implica: autenticação next.js
- O usuário menciona ou implica: login supabase
- O usuário menciona ou implica: middleware de autenticação
- O usuário menciona ou implica: rota protegida
- O usuário menciona ou implica: callback de autenticação
- O usuário menciona ou implica: gerenciamento de sessão
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação específica de ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem faltando.