Supabase service role ključ izložen u JavaScriptu: šta to znači i kako ga pronaći

Šta je service role ključ

Supabase izdaje dva različita ključa za svaki projekat: anon ključ (također zvan publishable key u novijim projektima) i service_role ključ. Oba su JSON Web Tokeni potpisani JWT secretom vašeg projekta. Razlika je u role claimu ugrađenom u payload JWT-a — anon za javni ključ, service_role za glavni ključ. PostgREST, Supabase Storage i Supabase Auth svi prelaze u režim zaobilaženja-svega kada vide claim service_role.

Dekodirajte bilo koji Supabase ključ na jwt.io i pogledajte payload. Oblik service-role JWT-a je nepogrešiv:

Dekodirani payload service-role JWT-a (prikazan kao blok s isticanjem sintakse ispod).

{
  "iss": "supabase",
  "ref": "[project-ref]",
  "role": "service_role",
  "iat": 1700000000,
  "exp": 2000000000
}

Noviji Supabase projekti izdaju tajne ključeve s prefiksom sb_secret_ umjesto JWT-a. Ponašanje je identično — sve što nosi sb_secret_ u javnom bundleu jednako je katastrofalno.

Kako AI alati za kodiranje izlijevaju service role ključ

Vidjeli smo ista tri obrasca u hiljadama vibe-coded aplikacija. Svaki počinje tako što developer traži pomoć od AI alata, a završava se ugrađivanjem service ključa u bundle.

Obrazac 1: Jedan .env fajl s prefiksom NEXT_PUBLIC_

Developer traži od AI alata da "postavi Supabase" i prihvata jedan .env s oba ključa. AI alat — treniran na korpusu u kojem se većina environment varijabli izlaže preko NEXT_PUBLIC_* — stavlja prefiks NEXT_PUBLIC_ na oba. Next.js u vrijeme buildanja ugrađuje sve što odgovara tom prefiksu u klijentski bundle. Isporučite na Vercel i service ključ je u main.[hash].js.

Obrazac 2: Pogrešan ključ u pozivu createClient

Developer lijepi oba ključa u fajl config.ts koji je AI generirao, a AI greškom popunjava klijentski createClient() poziv s process.env.SUPABASE_SERVICE_ROLE_KEY. Build povlači varijablu i JWT završi u bundleu.

Obrazac 3: Service-role ključ hardkodiran u seed skriptama

Developer traži od AI alata da napiše skriptu koja popunjava bazu. AI hardkodira service-role ključ direktno u fajl (umjesto čitanja iz environmenta), commita fajl u repozitorij i sada javni GitHub repo ili ruta /scripts/seed.js deploy-ane aplikacije poslužuje ključ.

Kako FixVibe bundle sken detektuje curenje

FixVibe-ova provjera bundle-secrets preuzima svaki JavaScript fajl koji deploy-ana aplikacija referencira — entry chunkove, lazy-loaded chunkove, web workere, service workere — i propušta ih kroz detektor koji dekodira sve što odgovara JWT obliku (eyJ[base64-header].eyJ[base64-payload].[signature]). Ako dekodirani payload sadrži "role": "service_role", sken to prijavljuje kao kritični nalaz s putanjom fajla i tačnom linijom gdje se ključ pojavljuje. Ista provjera također hvata noviji sb_secret_* obrazac po prefiksu.

Sken se nikada ne autentificira s otkrivenim ključem. Identificira oblik i prijavljuje curenje — koristiti ključ za dokazivanje iskoristivosti bilo bi neovlašteni pristup vašoj bazi. Dokaz je u samom JWT payloadu.

Otkriveno — šta uraditi u prvom satu

Procurjeli service role ključ je runtime hitnost. Pretpostavite da je ključ skrejpan — napadači u realnom vremenu prate javne bundleove. Tretirajte bazu kao kompromitovanu sve dok ne rotirate ključ i auditujete nedavnu aktivnost.

1. Rotirajte ključ odmah. U Supabase Dashboardu, idite na Project Settings → API → Service role key → Reset. Stari ključ se poništava u roku od nekoliko sekundi. Svaki serverski kod koji koristi ključ mora biti ažuriran i ponovo deploy-an prije nego što rotacija stupi na snagu.
2. Auditujte nedavnu aktivnost baze. Otvorite Database → Logs u dashboardu. Filtrirajte zadnjih 7 dana. Tražite neobične upite SELECT * nad tabelama s PII-jem, velike UPDATE ili DELETE izjave i zahtjeve s IP adresa izvan vaše poznate infrastrukture. Supabase loguje header x-real-ip na svakom zahtjevu.
3. Provjerite storage objekte. Posjetite Storage → Logs i pregledajte nedavna preuzimanja fajlova. Procurjeli service-role ključ daje bypass-everything pristup i privatnim bucketima.
4. Uklonite ključ iz source controla. Čak i nakon rotacije, ostavljanje JWT-a u vašoj git historiji znači da je otkriv u javnom repou. Koristite git filter-repo ili BFG Repo-Cleaner da ga uklonite iz historije, zatim force-push (prvo upozorite saradnike).
5. Ponovo skenirajte nakon popravka. Pokrenite svjež FixVibe sken prema redeploy-anoj aplikaciji. Nalaz bundle-secrets trebao bi nestati. Potvrdite da nijedan service_role JWT i nijedan string sb_secret_* nije ostao ni u jednom chunku.

Sprečavanje curenja od samog početka

Strukturni popravak je disciplina imenovanja plus zaštita na nivou alata:

• Nikada ne stavljajte prefiks NEXT_PUBLIC_*, VITE_* ili bilo koji drugi prefiks koji ugrađuje varijable u bundle na service ključ. Konvencija imenovanja je granica — svaki framework je poštuje.
• Držite service ključ potpuno izvan .env fajla na developerovoj mašini. Čitajte ga iz secret managera (Doppler, Infisical, Vercel enkriptovane env varijable) prilikom deploya, nikada ga ne commitajte lokalno.
• <strong>Mark every Supabase client construction with explicit context.</strong> Files named <code>supabase/browser.ts</code> use the anon key; files named <code>supabase/server.ts</code> use the service-role key with <code>import 'server-only'</code> at the top. The <code>server-only</code> import causes a build error if a client component tries to consume the module.
• <strong>Add a pre-commit hook that greps for JWT-shaped strings.</strong> <code>git diff --staged | grep -E 'eyJ[A-Za-z0-9_-]+\.eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+'</code> catches both anon and service tokens before they leave your machine.
• Dodajte CI gate koji skenira izlaz buildanja. Nakon next build, grepujte izlaz .next/static/chunks/ za string service_role. Neuspjeh buildanja ako se nešto poklopi.

# Pre-commit hook: refuse any staged JWT-shaped string.
git diff --staged \
  | grep -E 'eyJ[A-Za-z0-9_-]+\.eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+' \
  && echo "JWT detected in staged changes — refusing commit" \
  && exit 1

# CI gate: fail the build if "service_role" shipped to the static bundle.
grep -RE 'service_role|sb_secret_' .next/static/chunks/ \
  && echo "Service-role credential leaked into bundle" \
  && exit 1

Često postavljana pitanja

Sljedeći koraci

Pokrenite FixVibe sken prema svom produkcijskom URL-u — provjera bundle-secrets je besplatna, bez registracije, i prijavljuje izloženost service_role u manje od minute. Uparite ovo s člankom Supabase RLS skener da biste provjerili da li RLS sloj radi svoj posao, te s Sigurnosnom checklistom za Supabase storage da zaključate pristup fajlovima. Za pozadinu zašto AI alati tako pouzdano generiraju ovu klasu curenja, pročitajte Zašto AI alati za kodiranje ostavljaju sigurnosne propuste.