v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:08:00.000Z▲ 0 upvotes

API Routes Next.js'de Zod: katı, şerit ve ekstra alanlara karşı gerçekte koruma sağlayan şey

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Hangi sorunu çözüyoruz?

Genellikle katı doğrulamayla birlikte tartışılan iki saldırı şunlardır:

  • Toplu atama. İstemci, profil güncelleme uç noktasına {"name":"Ivan","role":"admin"} gönderir ve sunucu db.user.update({ data: body }) yapar. role alanı veritabanına gider.
  • Prototip kirliliği. Gövde, __proto__ veya constructor.prototype anahtarını içerir ve kod, prototipi Object değiştirerek, kendi kendine yazılan bir deepMerge aracılığıyla yinelemeli olarak onu bir nesneyle birleştirir.

Her iki güvenlik açığı da .strict() eksikliğinden değil, sunucunun ham istek gövdesi kullanması gerçeğinden kaynaklanmaktadır. Zod aracılığıyla doğrulama yaparsanız ve ardından yalnızca parse sonucuyla çalışırsanız, ekstra anahtarlar strict olmasa bile oraya ulaşamaz: varsayılan olarak, z.object bunları atar (şerit modu).

Üç nesne modu

import { z } from "zod";

const Base = { name: z.string().min(1).max(100) };

z.object(Base).parse({ name: "a", role: "admin" });
// { name: "a" } — role молча удалён

z.object(Base).strict().parse({ name: "a", role: "admin" });
// ZodError: unrecognized key "role"

z.object(Base).passthrough().parse({ name: "a", role: "admin" });
// { name: "a", role: "admin" } — опасно для входных данных

Zod 4'te aynı modlar ayrı kurucular z.strictObject({...}) ve z.looseObject({...}) olarak mevcuttur; .strict() ve .passthrough() yöntemleri uyumluluk amacıyla korunur. Proje başına bir stil seçin.

O halde neden strict? Sessiz silme işlemini açık bir hataya dönüştürür. Alan adını yanlış yazan bir istemci (email yerine emial), e-posta olmadan "başarılı" bir kaydetme yerine anahtarla 400 alır. Dahili API'ler ve formlar için bu, saatlerce süren hata ayıklamadan tasarruf sağlar.

İşleyici şablonu

// app/api/profile/route.ts
import { z } from "zod";
import { NextResponse } from "next/server";
import { getSession } from "@/lib/auth";
import { db } from "@/lib/db";

const Address = z.strictObject({
  city: z.string().max(80),
  street: z.string().max(120),
});

const UpdateProfile = z.strictObject({
  name: z.string().trim().min(1).max(100).optional(),
  email: z.email().optional(),          // в Zod 3: z.string().email()
  address: Address.optional(),
});

export async function PATCH(req: Request) {
  const session = await getSession();
  if (!session) return NextResponse.json({ error: "unauthorized" }, { status: 401 });

  let json: unknown;
  try {
    json = await req.json();
  } catch {
    return NextResponse.json({ error: "invalid JSON" }, { status: 400 });
  }

  const parsed = UpdateProfile.safeParse(json);
  if (!parsed.success) {
    return NextResponse.json(
      { error: "validation", issues: parsed.error.issues.map(i => ({ path: i.path, message: i.message })) },
      { status: 400 }
    );
  }

  // только parsed.data, никогда json
  const user = await db.user.update({ where: { id: session.userId }, data: parsed.data });
  return NextResponse.json({ id: user.id, name: user.name, email: user.email });
}

Çoğu zaman gözden kaçırılan ayrıntılar:

  • `strict` özyinelemeli değildir. Katı bir nesnenin içindeki yuvalanmış bir z.object, şerit modunda kalır. Bu nedenle, Address ayrı olarak katı olarak bildirilir.
  • `req.json()` geçersiz JSON'da istisna atar. try/catch olmadan istemci 400 yerine 500 alacaktır.
  • `parse` yerine safeParse - normal kullanıcı hatalarına ilişkin istisnaların yakalanmasını önlemek için.
  • Yanıt da filtrelenir. Parola karması ile kullanıcı nesnesinin tamamını değil, açık bir alan kümesini döndürür.

Sorgu parametreleri ve formları

searchParams ve FormData'dan gelen her şey dizelerdir. Bir alçı kullanın:

const ListQuery = z.strictObject({
  page: z.coerce.number().int().min(1).default(1),
  limit: z.coerce.number().int().min(1).max(100).default(20),
  q: z.string().max(200).optional(),
});

const query = ListQuery.safeParse(Object.fromEntries(new URL(req.url).searchParams));

Object.fromEntries yinelenen parametreleri kaybeder (?tag=a&tag=b). Gerekirse diziyi searchParams.getAll("tag") aracılığıyla ayrı ayrı toplayın.

Nasıl teşhis edilir

  • Bir müşteri, bir mobil uygulamanın yayınlanmasından sonra yaklaşık 400 şikayette bulunuyor: yeni sürüm ek bir alan gönderiyor, ancak şema katı. Yanıttaki issues'a bakın; anahtarın yolu orada olacaktır.
  • Alan "kaydedilmedi", hata yok: şema katı değil ve anahtar beklediğinizden farklı şekilde çağrılıyor. strict'u geçici olarak etkinleştirin ve isteği yeniden deneyin.
  • Anahtarlardaki günlüklerde __proto__ - tarayıcı prototip kirliliğini arar. parsed.data kullanırsanız bu gürültüdür; Birleştirme kodunda herhangi bir ham nesne olup olmadığını kontrol edin.

Katı yolunuza çıktığında

Harici hizmetlerin web kancaları (ödeme sistemleri, anlık mesajlaşma programları) düzenli olarak yeni alanlar ekler. Bunlara yönelik katı bir plan, zararsız bir sağlayıcı güncellemesini işleme hatasına dönüştürecektir. Bu tür girişler için şerit modunu kullanın ve yalnızca gerekli alanları tanımlayın. Geriye dönük uyumluluğa sahip genel API'ler için de aynısı geçerlidir: Uç noktaların eski sürümlerindeki katı bir şema, yeni sürümlerden alan gönderen istemcileri bozabilir.

Обсуждение (0)

Ещё на vbcd4u.com