Express
Adicione autenticação a um app Express com o Clowk em poucos passos: instale o SDK, defina suas chaves e proteja rotas com clowkMiddleware e requireAuth.
Instalação
pnpm add @clowk/express @clowk/coreConfiguração
import express from 'express'
import { clowkMiddleware, requireAuth } from '@clowk/express'
const app = express()Proteja todas as rotas
Aplique o middleware de forma global. O JWT decodificado fica disponível em req.auth:
app.use(clowkMiddleware({
secretKey: process.env.CLOWK_SECRET_KEY,
}))
app.get('/dashboard', (req, res) => {
res.json({ user: req.auth })
})Proteja rotas específicas
Use requireAuth() para proteger rotas individuais. Ele retorna 401 se não houver token válido:
app.get('/public', (req, res) => {
res.json({ message: 'This is public' })
})
app.get('/protected', requireAuth(), (req, res) => {
res.json({ user: req.auth })
})Como funciona
O middleware extrai e verifica o JWT a partir de (nesta ordem):
- Query parameter —
?token=eyJ... - Header Authorization —
Bearer eyJ... - Cookie —
clowk_token
Com clowkMiddleware, req.auth é null se nenhum token for encontrado (auth opcional). Com requireAuth, a requisição é rejeitada com 401 antes de chegar ao seu handler.
Próximos passos
- Quickstart do Hono — para Workers, Bun, Deno
- Integração completa com Express — referência completa da API
Next.js
Adicione autenticação a um app Next.js com o Clowk: defina suas chaves, proteja rotas com middleware e leia o usuário em Server e Client Components.
Hono
Adicione autenticação a um app Hono com o Clowk: instale, configure suas chaves e proteja rotas com middleware JWT no Workers, Bun, Deno ou Node.js.