# Š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#
| Strategija | Primjer | Najbolje za | Sigurnosna pozicija | Operativne napomene |
|---|---|---|---|---|
| Poddomena | acme.example.com | B2B SaaS, snažna izolacija | Snažna, vezana uz origin | Treba wildcard DNS i TLS |
| Temeljeno na putanji | example.com/t/acme | Jednostavniji DNS, marketing site + aplikacija | Srednja, lakše je “spoofati” u linkovima | Traži stroga pravila rutiranja |
| Temeljeno na zaglavlju | X-Tenant: acme | Interni API-ji, server-to-server | Slaba ako je izloženo browserima | Mora 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:
// 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-Hostkoji 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:
// 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:
| Polje | Primjer | Gdje se koristi | Zašto |
|---|---|---|---|
tenant.slug | acme | URL, UI | Ljudima čitljivo, dovoljno stabilno |
tenant.id | uuid | DB joinovi, RLS, politike | Neizmjenjivo, 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:
// 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:
// 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#
| Tablica | Ključni stupci | Svrha |
|---|---|---|
users | id, email | Globalni identitet |
tenants | id, slug, name | Tenant kontejner |
memberships | user_id, tenant_id, role | Kontrola pristupa |
sessions | user_id, created_at | Auth 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:
- 1Auth sesija neovisna o tenant-u + kolačić aktivnog tenant-a
- 2Sesije 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:
httpOnlysecuresameSite=laxilistrictovisno o cross-site tokovima- potpisan ili enkriptiran
Zatim ga validirajte na svakom zahtjevu provjerom članstva.
Primjer server actiona za prebacivanje tenant-a:
// 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_idfilter - 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.
// 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.
// 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:
// 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:
// 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:
- 1Korisnik otvara tenant switcher i vidi samo tenant-e u kojima je član.
- 2Pri odabiru, poziva se server action koji validira članstvo.
- 3Server postavlja kolačić aktivnog tenant-a i vraća kanonički redirect URL.
- 4Klijent navigira na taj URL, a server ponovno validira tenant kontekst.
Dizajn tablice za tenant switcher#
| Element | Zahtjev | Zašto je važno |
|---|---|---|
| Popis tenant-a | Dolazi sa servera, ograničen članstvom | Sprječava enumeraciju tenant-a |
| Switch akcija | Članstvo validirano na serveru | Sprječava forced browsing |
| Redirect | Kanonički tenant URL | Sprječava miješano tenant rutiranje |
| Feedback | Loading state i poruka greške | Sprječava UI desinkronizaciju |
Primjer server actiona za prebacivanje s redirectom#
// 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:
| Polje | Primjer | Upotreba |
|---|---|---|
user_id | uuid | Tko je to napravio |
tenant_id | uuid | Gdje se dogodilo |
action | project.read | Što se dogodilo |
resource_id | uuid | Koji objekt |
request_id | trace | Debugiranje |
Č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
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 →Next.js App Router autentikacija sa sesijama: cookie sesije, middleware i obrasci osvježavanja
Praktičan vodič za Next.js App Router autentikaciju sa sesijama koristeći httpOnly cookie sesije, middleware zaštite i obrasce osvježavanja ili rotacije — uz siguran logout, smjernice za CSRF i napomene o Vercel runtimeu.
Obavijesti u stvarnom vremenu u Next.js-u (App Router): SSE vs WebSockets, fanout i jamstva isporuke
Izgradite produkcijski spremne Next.js obavijesti u stvarnom vremenu s App Routerom. Usporedite SSE i WebSockets, dizajnirajte trajni inbox i stanja pročitanosti, sigurno skalirajte fanout te dodajte fallback polling uz React Query ili SWR.
Arhitektura React administratorske nadzorne ploče: RBAC, revizijski zapisi, navigacija i skalabilni moduli
Praktičan nacrt arhitekture React administratorske nadzorne ploče u B2B proizvodima: informacijska arhitektura, UI vođen dozvolama, model događaja revizijskog zapisa, feature flagovi, granice modula i strategije testiranja za rute s kontrolom pristupa.
Trebate pomoć s projektom?
Gradimo prilagođena rješenja koristeći tehnologije iz ovog članka. Senior tim, fiksne cijene.
Povezani članci
Next.js + Supabase RLS za multi‑tenant SaaS: pravila, uloge i siguran pristup podacima
Praktičan vodič za Next.js App Router i Supabase Row Level Security za multi-tenant SaaS: dizajn tablica, pravila, uloge, obrasci pristupa na serveru, česte zamke i kontrolna lista za deployment.
Next.js multitenant SaaS arhitektura: modeli tenancije, rutiranje, autentikacija i izolacija podataka (Vodič za 2026.)
Praktičan vodič za Next.js multitenant SaaS arhitekturu: modeli tenancije, tenant-aware rutiranje uz App Router i middleware, obrasci autentikacije te učvršćivanje izolacije podataka kako bi se spriječila curenja.
Next.js autentikacija u 2026.: NextAuth vs Clerk vs Supabase (što koristimo na klijentskim projektima)
Praktična usporedba opcija za Next.js autentikaciju u 2026. — NextAuth, Clerk i Supabase — kroz UX, sigurnost, trošak, vrijeme postavljanja i enterprise zahtjeve, uz matrice odluke za SaaS, interne alate i B2B portale.