Web razvoj
Next.jsAutentifikacijaVišestanarstvoSaaSSigurnostApp Router

Next.js višestanarijska autentifikacija u App Routeru: razrješavanje tenant-a, prebacivanje i sigurnost

AO
Adrijan Omićević
·14 min čitanja

# Što ćete izgraditi#

Ovaj vodič pokazuje kako implementirati Next.js višestanarijsku autentifikaciju u App Routeru uz snažne sigurnosne zadane postavke. Naučit ćete strategije razrješavanja tenant-a, kako ograničiti sesije i upite po tenant-u te kako izgraditi UX za prebacivanje tenant-a bez stvaranja curenja podataka između tenant-a.

Fokusirat ćemo se na praktične obrasce koje možete isporučiti u produkciji, kao i na zaštitne ograde koje sprječavaju da “radi lokalno” auth bugovi postanu povreda podataka. Za širi kontekst arhitekture pogledajte vodič za Next.js višestanarijsku SaaS arhitekturu, a za provedbu na razini baze pogledajte Next.js Supabase Row Level Security za višestanarijski SaaS.

# Zašto je višestanarijska autentifikacija drugačija#

Višestanarijska autentifikacija nije samo “login plus tenant ID”. Površina rizika raste jer svaki zahtjev sada ima dva identiteta:

  • Tko je korisnik
  • Koji je tenant kontekst aktivan

Većina ozbiljnih višestanarijskih incidenata događa se kada se ta dva identiteta razdvoje i sustav povjeruje tenant identifikatoru koji dolazi s klijenta. Prema IBM-ovim izvješćima Cost of a Data Breach, povrede rutinski koštaju milijune i treba stotine dana za otkrivanje i sanaciju, a curenje između tenant-a jedan je od najgorih scenarija jer krši izolaciju kupaca.

🎯 Ključna poruka: Tretirajte tenant kontekst kao sigurnosnu granicu. Nikada nemojte prihvatiti neprovjeren tenant identifikator s klijenta kao izvor istine.

# Strategije razrješavanja tenant-a u Next.js App Routeru#

Razrješavanje tenant-a je način na koji vaša aplikacija određuje tenantId za zahtjev. U praksi ćete birati između poddomene, putanje ili zaglavlja, ili ih kombinirati za različite ulazne točke.

Tablica usporedbe: poddomena vs putanja vs zaglavlje#

StrategijaPrimjerNajbolje zaSigurnosna pozicijaOperativne napomene
Poddomenaacme.example.comB2B SaaS, snažna izolacijaSnažna, vezana uz originTreba wildcard DNS i TLS
Temeljeno na putanjiexample.com/t/acmeJednostavniji DNS, marketing site + aplikacijaSrednja, lakše je “spoofati” u linkovimaTraži stroga pravila rutiranja
Temeljeno na zaglavljuX-Tenant: acmeInterni API-ji, server-to-serverSlaba ako je izloženo browserimaMora biti iza pouzdanog proxyja

Strategija 1: Razrješavanje tenant-a putem poddomene#

Razrješavanje putem poddomene je obično najčišće. Tenant je dio hostname-a, pa ga možete nametnuti rano u middlewareu i održati konzistentnim za linkove i kolačiće.

Pravila koja se isplati nametnuti:

  • Zabranite rezervirane poddomene poput www, app, admin, api
  • Normalizirajte i validirajte format tenant sluga
  • Preferirajte stabilne identifikatore u bazi, ali slug koristite za rutiranje

Primjer izdvajanja tenant-a u middlewareu:

TypeScript
// middleware.ts
import { NextRequest, NextResponse } from "next/server";
 
const RESERVED = new Set(["www", "app", "admin", "api"]);
 
function parseTenantFromHost(host: string) {
  const parts = host.split(".");
  if (parts.length < 3) return null;
  const subdomain = parts[0].toLowerCase();
  if (RESERVED.has(subdomain)) return null;
  if (!/^[a-z0-9-]{2,63}$/.test(subdomain)) return null;
  return subdomain;
}
 
export function middleware(req: NextRequest) {
  const host = req.headers.get("host") || "";
  const tenantSlug = parseTenantFromHost(host);
 
  if (!tenantSlug) return NextResponse.next();
 
  const res = NextResponse.next();
  res.headers.set("x-tenant-slug", tenantSlug);
  return res;
}
 
export const config = {
  matcher: ["/((?!_next|favicon.ico|robots.txt).*)"],
};

Ovo postavlja request zaglavlje koje server komponente mogu čitati. Važan dio nije samo zaglavlje, nego činjenica da je izvedeno server-side iz pouzdanog svojstva zahtjeva.

⚠️ Upozorenje: Nemojte vjerovati X-Forwarded-Host koji dolazi s klijenta. Oslonite se na njega samo ako kontrolirate reverse proxy i provjerili ste ponašanje svoje platforme.

Strategija 2: Razrješavanje tenant-a putem putanje#

Razrješavanje putem putanje izgleda kao example.com/t/acme/.... Dobro funkcionira ako trebate jednu domenu za marketing stranice i rute tenant aplikacije.

Sigurna pravila za putanju:

  • Tenant rute dopustite samo pod fiksnim prefiksom poput /t/[tenant]
  • Odbijte bilo koju tenant vrijednost koja padne normalizaciju
  • Izbjegavajte rute poput /[tenant]/... jer stvaraju previše kolizija s marketing stranicama i statičkim rutama

Primjer middlewarea koji nameće kanoničke tenant URL-ove:

TypeScript
// middleware.ts
import { NextRequest, NextResponse } from "next/server";
 
function isValidTenantSlug(value: string) {
  return /^[a-z0-9-]{2,63}$/.test(value);
}
 
export function middleware(req: NextRequest) {
  const url = req.nextUrl;
  const segments = url.pathname.split("/").filter(Boolean);
 
  if (segments[0] !== "t") return NextResponse.next();
  const slug = segments[1] || "";
 
  if (!isValidTenantSlug(slug)) {
    url.pathname = "/404";
    return NextResponse.rewrite(url);
  }
 
  const res = NextResponse.next();
  res.headers.set("x-tenant-slug", slug.toLowerCase());
  return res;
}
 
export const config = {
  matcher: ["/t/:path*"],
};

Ovaj pristup čini tenant rute eksplicitnima i izbjegava slučajno parsiranje tenant-a za nepovezane stranice.

Strategija 3: Razrješavanje tenant-a putem zaglavlja#

Razrješavanje putem zaglavlja je korisno za interne API-je ili worker callbackove, ali je najlakše za krivu upotrebu. Browseri mogu slati proizvoljna zaglavlja s kompromitiranih klijenata, a čak i ako CORS blokira neke slučajeve, oslanjanje na tenant zaglavlja koja šalje klijent i dalje je “footgun”.

Uvjeti sigurne upotrebe:

  • Endpoint ne pozivaju direktno browseri
  • Endpoint je iza pouzdanog gatewaya koji ubacuje tenant zaglavlje
  • Validirate origin zahtjeva i zahtijevate snažnu autentifikaciju

Za interne API rute, tretirajte X-Tenant kao optimizaciju, ne kao istinu. Razriješite tenantId tako da provjerite potpisani token, mTLS identitet ili servisne kredencijale.

# Identitet tenant-a: slug vs tenant ID#

Koristite slug za rutiranje, a tenantId za autorizaciju i upite prema bazi.

Praktični model:

PoljePrimjerGdje se koristiZašto
tenant.slugacmeURL, UILjudima čitljivo, dovoljno stabilno
tenant.iduuidDB joinovi, RLS, politikeNeizmjenjivo, sigurno za reference

Kad zahtjev dođe, razriješite slug u tenant ID na serveru i cacheirajte ga radi performansi.

# Implementacija razrješavanja tenant-a u App Routeru (Server Components)#

U App Routeru server komponente mogu čitati zaglavlja i izvesti tenant kontekst server-side. Glavni cilj je centralizirati ovu logiku kako bi svaka stranica i akcija koristile isti izvor istine.

Primjer helpera za dohvat tenant sluga iz request zaglavlja:

TypeScript
// lib/tenant.ts
import { headers } from "next/headers";
 
export function getTenantSlugFromRequest() {
  const h = headers();
  const slug = h.get("x-tenant-slug");
  return slug || null;
}

Zatim razriješite u tenant zapis:

TypeScript
// lib/tenant.ts
import { cache } from "react";
 
type Tenant = { id: string; slug: string; name: string };
 
async function dbFindTenantBySlug(slug: string): Promise<Tenant | null> {
  // Replace with your ORM call
  return null;
}
 
export const getTenant = cache(async () => {
  const slug = getTenantSlugFromRequest();
  if (!slug) return null;
  return dbFindTenantBySlug(slug);
});

Ovo čini getTenant() sigurnim i ponovljivim kroz server komponente tijekom renderiranja.

💡 Savjet: Cacheirajte razrješavanje tenant-a po request renderu. Tenant se često čita, a cache smanjuje ponovljene upite prema bazi bez curenja između requestova.

# Autentifikacija: identitet korisnika vs članstvo u tenant-u#

Korisnik može biti:

  • U točno jednom tenant-u
  • U više tenant-a
  • Još nije dodijeljen, zbog onboardinga

Vaš podatkovni model treba to eksplicitno reprezentirati.

Preporučeni podatkovni model#

TablicaKljučni stupciSvrha
usersid, emailGlobalni identitet
tenantsid, slug, nameTenant kontejner
membershipsuser_id, tenant_id, roleKontrola pristupa
sessionsuser_id, created_atAuth sesija, neovisna o tenant-u

Ova separacija omogućuje prebacivanje tenant-a bez ponovne autentifikacije i bez vjerovanja tenant inputu s klijenta.

Ako trebate referentnu implementaciju za auth providere i upravljanje sesijama, pogledajte vodič za Next.js autentifikaciju s NextAuth, Clerk i Supabase.

# Opseg sesije: kako vezati zahtjeve uz aktivni tenant#

Postoje dva sigurna obrasca:

  1. 1
    Auth sesija neovisna o tenant-u + kolačić aktivnog tenant-a
  2. 2
    Sesije vezane uz tenant s rotacijom pri prebacivanju

Obrazac 1 je jednostavniji i teže ga je pogrešno implementirati. Obrazac 2 može biti snažniji za auditiranje, ali zahtijeva pažljivu rotaciju.

Obrazac 1: Aktivni tenant u potpisanom kolačiću#

Spremite activeTenantId ili activeTenantSlug u server-set kolačić koji je:

  • httpOnly
  • secure
  • sameSite=lax ili strict ovisno o cross-site tokovima
  • potpisan ili enkriptiran

Zatim ga validirajte na svakom zahtjevu provjerom članstva.

Primjer server actiona za prebacivanje tenant-a:

TypeScript
// app/(app)/settings/switch-tenant/actions.ts
"use server";
 
import { cookies } from "next/headers";
 
async function userHasMembership(userId: string, tenantId: string) {
  return false;
}
 
export async function switchTenantAction(input: { userId: string; tenantId: string }) {
  const allowed = await userHasMembership(input.userId, input.tenantId);
  if (!allowed) throw new Error("Not a member of that tenant");
 
  const jar = cookies();
  jar.set("activeTenantId", input.tenantId, {
    httpOnly: true,
    secure: true,
    sameSite: "lax",
    path: "/",
  });
}

I dalje morate osigurati da razrješavanje tenant-a putem URL-a odgovara pravilima aktivnog tenant-a. Postoje dva česta pristupa:

  • URL određuje tenant, a kolačić aktivnog tenant-a je samo radi praktičnosti
  • Kolačić određuje tenant, a URL se rewritea da odgovara

Za većinu SaaS aplikacija, URL određuje tenant je jasnije i smanjuje iznenađenja.

Obrazac 2: Sesije vezane uz tenant#

Ako ugrađujete tenantId u sesiju ili JWT, morate ga rotirati pri prebacivanju. Ako ga ne rotirate, zastarjeli tokeni mogu i dalje autorizirati stari tenant.

Ovaj obrazac ima smisla kada:

  • Želite kratko-živuće tokene vezane uz tenant za API-je
  • Imate stroge audit zahtjeve po tenant kontekstu

Ako ovo implementirate, tretirajte prebacivanje tenant-a kao ponovni login u smislu autorizacije.

# Sprječavanje curenja podataka između tenant-a: zaštitne ograde za upite#

Curenja između tenant-a najčešće nastaju zbog jednog od ovih razloga:

  • Upitu nedostaje tenant_id filter
  • Koristi se globalno jedinstven ID resursa i zaboravi se provjeriti pripadnost tenant-u
  • Preširoki joinovi
  • Cacheiranje odgovora bez tenant-a u cache keyju

Siguran obrazac upita: uvijek zahtijevajte tenantId#

Učinite pisanje neograničenih upita teškim tako da tenantId bude obavezan parametar u funkcijama repozitorija.

TypeScript
// lib/repo/projects.ts
type Project = { id: string; tenantId: string; name: string };
 
export async function listProjects(params: { tenantId: string; limit: number }) {
  const { tenantId, limit } = params;
 
  // Example: replace with Prisma/Drizzle/SQL
  // SELECT id, tenant_id, name FROM projects WHERE tenant_id = $1 LIMIT $2;
  return [] as Project[];
}
 
export async function getProjectById(params: { tenantId: string; projectId: string }) {
  const { tenantId, projectId } = params;
 
  // SELECT ... WHERE id = $1 AND tenant_id = $2;
  return null as Project | null;
}

Ključ je da čak i kada je projectId globalno jedinstven, i dalje ograničavate po tenantId. Time se IDOR-style bug pretvara u bezopasan 404.

Tenant guard za Server Components#

Server komponente trebaju “fail closed”. Ako tenant nedostaje ili je nevažeći, prikažite error boundary ili napravite redirect.

TypeScript
// lib/authz.ts
import { redirect } from "next/navigation";
import { getTenant } from "./tenant";
 
export async function requireTenant() {
  const tenant = await getTenant();
  if (!tenant) redirect("/select-tenant");
  return tenant;
}

Zatim:

TypeScript
// app/(app)/t/[tenant]/dashboard/page.tsx
import { requireTenant } from "@/lib/authz";
import { listProjects } from "@/lib/repo/projects";
 
export default async function DashboardPage() {
  const tenant = await requireTenant();
  const projects = await listProjects({ tenantId: tenant.id, limit: 20 });
 
  return (
    // Keep JSX minimal in examples, render logic omitted
    null
  );
}

Ovdje je tijelo rendera izostavljeno jer je ključna sigurnosna logika nametanje tenant-a i pristup podacima ograničen po tenant-u.

# Provedba u middlewareu: kanonički tenant i auth gateovi#

Middleware je vaša najranija točka provedbe. Tipične odgovornosti:

  • Razriješiti tenant slug
  • Normalizirati i preusmjeriti na kanonički tenant URL
  • Blokirati pristup tenant rutama kada korisnik nije autentificiran
  • Dodati hintove tenant konteksta za server komponente

Primjer high-level middleware logike za tenant-e temeljene na putanji:

TypeScript
// middleware.ts
import { NextRequest, NextResponse } from "next/server";
 
function isValidTenantSlug(value: string) {
  return /^[a-z0-9-]{2,63}$/.test(value);
}
 
function isProtectedPath(pathname: string) {
  return pathname.startsWith("/t/") && !pathname.includes("/login");
}
 
export function middleware(req: NextRequest) {
  const url = req.nextUrl;
  const segments = url.pathname.split("/").filter(Boolean);
 
  if (segments[0] === "t") {
    const slug = (segments[1] || "").toLowerCase();
    if (!isValidTenantSlug(slug)) return NextResponse.rewrite(new URL("/404", req.url));
 
    const res = NextResponse.next();
    res.headers.set("x-tenant-slug", slug);
 
    // Example auth gate placeholder: replace with your auth cookie check
    const hasSession = Boolean(req.cookies.get("session")?.value);
    if (isProtectedPath(url.pathname) && !hasSession) {
      const loginUrl = new URL(`/login`, req.url);
      loginUrl.searchParams.set("next", url.pathname);
      return NextResponse.redirect(loginUrl);
    }
 
    return res;
  }
 
  return NextResponse.next();
}
 
export const config = {
  matcher: ["/((?!_next|favicon.ico|robots.txt).*)"],
};

Održite middleware brzim. Ne zovite bazu u middlewareu osim ako prihvaćate trošak latencije na svakom zahtjevu. Ako trebate DB validaciju, napravite je u server komponentama ili server actionima.

# Siguran UX za prebacivanje tenant-a (bez sigurnosnih rupa)#

UX za prebacivanje tenant-a izgleda jednostavno, ali uzrokuje stvarne incidente kada se UI prebaci prije nego što server potvrdi autorizaciju.

Siguran tok:

  1. 1
    Korisnik otvara tenant switcher i vidi samo tenant-e u kojima je član.
  2. 2
    Pri odabiru, poziva se server action koji validira članstvo.
  3. 3
    Server postavlja kolačić aktivnog tenant-a i vraća kanonički redirect URL.
  4. 4
    Klijent navigira na taj URL, a server ponovno validira tenant kontekst.

Dizajn tablice za tenant switcher#

ElementZahtjevZašto je važno
Popis tenant-aDolazi sa servera, ograničen članstvomSprječava enumeraciju tenant-a
Switch akcijaČlanstvo validirano na serveruSprječava forced browsing
RedirectKanonički tenant URLSprječava miješano tenant rutiranje
FeedbackLoading state i poruka greškeSprječava UI desinkronizaciju

Primjer server actiona za prebacivanje s redirectom#

TypeScript
// app/(app)/select-tenant/actions.ts
"use server";
 
import { cookies } from "next/headers";
 
async function getTenantSlugById(tenantId: string) {
  return null as string | null;
}
 
async function userHasMembership(userId: string, tenantId: string) {
  return false;
}
 
export async function switchTenant(input: { userId: string; tenantId: string }) {
  const ok = await userHasMembership(input.userId, input.tenantId);
  if (!ok) throw new Error("Access denied");
 
  const slug = await getTenantSlugById(input.tenantId);
  if (!slug) throw new Error("Tenant not found");
 
  cookies().set("activeTenantId", input.tenantId, {
    httpOnly: true,
    secure: true,
    sameSite: "lax",
    path: "/",
  });
 
  return { redirectTo: `/t/${slug}/dashboard` };
}

Client komponente trebaju tretirati server output kao autoritativan i izbjegavati optimistično prebacivanje. UI može prikazati spinner, ali ne bi trebao renderirati tenant podatke dok navigacija ne završi.

ℹ️ Napomena: Ako koristite poddomene, switch action bi trebao vratiti puni apsolutni URL na novi origin, a domene kolačića trebate pažljivo razmotriti kako biste izbjegli curenje tenant konteksta preko origin-a.

# Sigurnosna checklista: česte zamke i popravci#

Zamka 1: Vjerovanje tenantId-u s klijenta#

Popravak: Razriješite tenant iz hosta ili kanoničke putanje, a zatim mapirajte slug u tenant ID server-side.

Zamka 2: Nedostaje tenant filter u jednom upitu#

Popravak: Koristite repozitorijske helpere koji zahtijevaju tenantId. Dodajte lint pravila ili code review provjere koje označavaju neograničene upite.

Zamka 3: Korištenje globalnog cacheiranja bez tenant ključeva#

Popravak: Uključite tenant u cache keyjeve za server cache i CDN-ove. Na primjer, cacheirajte pod tenantId + pathname.

Zamka 4: Redirectovi između tenant-a i open redirecti#

Popravak: Dopustite samo relativne next putanje koje počinju s / i ne sadrže protokol. next gdje je moguće spremite u server-side sesiju.

Zamka 5: Prebacivanje tenant-a bez server validacije#

Popravak: Tretirajte prebacivanje kao autorizacijski događaj. Validirajte članstvo na serveru i rotirajte stanje vezano uz tenant.

# Produkcijsko “hardening” (što dodati nakon MVP-a)#

Izolacija na razini baze: Row Level Security#

Ako koristite Postgres, nametnite izolaciju u bazi. Uz Supabase RLS možete blokirati cross-tenant čitanja čak i ako je application upit pogrešan. Glavna ideja je osigurati da svaki redak ima tenant_id i da se svaki upit izvršava pod kontekstom koji se može provjeriti prema članstvu.

Ako želite walkthrough implementacije, pratite Next.js Supabase Row Level Security za višestanarijski SaaS.

Auditiranje i spremnost na incidente#

Dodajte polja u logove:

PoljePrimjerUpotreba
user_iduuidTko je to napravio
tenant_iduuidGdje se dogodilo
actionproject.readŠto se dogodilo
resource_iduuidKoji objekt
request_idtraceDebugiranje

Čak i mali timovi imaju korist od ovoga pri dijagnosticiranju sumnjivih pristupa.

Testiranje izolacije između tenant-a#

Dodajte automatizirane testove specifično za tenant granice:

  • Korisnik u tenant-u A ne može čitati resurse tenant-a B
  • Prebacivanje tenant-a invalidira tenant-specifične cacheve
  • Direktno lijepljenje URL-a drugog tenant-a vraća 404 ili 403

Jedan propušten test ovdje kasnije je skup.

# Ključne poruke#

  • Razriješite tenant server-side putem poddomene ili kanoničkog prefiksa putanje, i tretirajte tenant identifikatore koje šalje klijent kao nepouzdane.
  • Odvojite identitet korisnika od članstva u tenant-u i validirajte članstvo na svakom zahtjevu unutar tenant konteksta.
  • Svaki upit prema bazi ograničite s tenantId, čak i kada su ID-jevi resursa globalno jedinstveni, kako biste spriječili IDOR-style curenje između tenant-a.
  • Implementirajte prebacivanje tenant-a kao server-validirani autorizacijski korak koji vraća kanonički redirect URL i izbjegava optimistično prebacivanje u UI-ju.
  • Dodajte defense-in-depth s ograničenjima u bazi ili row-level security, i uključite tenant u cache keyjeve i audit logove.

# Zaključak#

Next.js višestanarijska autentifikacija u App Routeru je pouzdana kada standardizirate razrješavanje tenant-a, održite sesije tenant-sigurnima i učinite cross-tenant pristup mehanički teškim u podatkovnom sloju. Ako gradite višestanarijski SaaS i želite reviziju tenant granica, middlewarea i obrazaca upita, kontaktirajte Samioda i pomoći ćemo vam isporučiti sigurnu implementaciju na React i Next.js, uključujući tenant-aware automatizacijske tokove gdje se n8n uklapa u vaš stack.

FAQ

Share
A
Adrijan OmićevićOsnivač i senior developer

Osnivač i senior developer u Samiodi. 8+ godina iskustva u izradi React, Next.js, Flutter i n8n rješenja za klijente diljem Europe.

Više iz kategorije Web razvoj

Sve →

Trebate pomoć s projektom?

Gradimo prilagođena rješenja koristeći tehnologije iz ovog članka. Senior tim, fiksne cijene.