Dein supabase service role key steckt im JavaScript, das deine Besucher herunterladen — und die App sieht völlig normal aus. Genau das ist das Problem.
Registrieren klappt. Formulare speichern. Das Dashboard zeigt Zeilen. Niemand bekommt einen Fehler, weil der Key, der jede Regel umgeht, die du eigentlich schreiben wolltest, still seine Arbeit tut. Der Schaden ist unsichtbar, bis jemand dein Bundle nach service_role oder sb_secret_ durchsucht und den Generalschlüssel zu deiner kompletten Datenbank findet.
Der supabase service role key ist ein Generalschlüssel
Supabase gibt dir zwei Key-Familien. Der publishable key (ältere Projekte nennen ihn anon) ist für Browser gedacht und identifiziert dein Projekt, während Row Level Security entscheidet, was er anfassen darf. Der secret key — bei älteren Projekten das service_role-JWT — bildet auf eine Postgres-Rolle mit BYPASSRLS ab. Policies gelten für ihn nie.
Nochmal zum Mitschreiben: Der Service-Role-Key ignoriert RLS absichtlich. Er existiert für Backends unter deiner Kontrolle — Edge Functions, eine Node-API, Cron-Jobs — wo er Dinge tun muss, die Nutzer nicht dürfen: Audit-Zeilen schreiben, Accounts verwalten. Im Browser ist er keine Abkürzung. Er ist ein Leck.
Mit dem Key kann ein Fremder:
- jede Zeile in jeder Tabelle lesen, die deine Grants erlauben — Nutzer, Bestellungen, Nachrichten
- Daten einfügen, ändern oder löschen, ganz ohne Policy im Weg
- über die Admin-API Auth-Nutzer anlegen oder bestätigen
- Storage-Objekte lesen, die deine App für privat hält
Supabase ersetzt die JWT-artigen Keys gerade durch kurze Strings wie sb_publishable_ und sb_secret_, und der klassische service_role-Key läuft gegen Ende 2026 aus. Die Regel bleibt: kurz oder lang, alt oder neu — der elevated Key bleibt auf dem Server.
Wie er im Frontend gelandet ist
Niemand hat beschlossen, den Generalschlüssel zu shippen. Der übliche Weg ist leiser: Deine App ist in einen Permission-Fehler gelaufen, und der supabase service role key war der schnellste Weg, ihn zum Schweigen zu bringen.
Row-Level-Security-Fehler fühlen sich wie Bugs an. Das Insert schlägt fehl, das KI-Coding-Tool probiert erneut — und irgendwann entdeckt es den anderen Key, den, bei dem der Fehler verschwindet. Es versteht nicht, dass der Fehler Absicht war. Es sieht einen roten Test und macht ihn grün.
Drei Stellen, die du zuerst prüfst:
- Client-Env-Vars. Alles mit Präfix
VITE_,NEXT_PUBLIC_oderREACT_APP_wird ins öffentliche Bundle kompiliert.VITE_SUPABASE_SERVICE_ROLE_KEYin der.envist nicht versteckt — sie wird ausgeliefert. - Den Supabase-Client-Init. Suche nach
createClient(. Wenn das zweite Argument der Service-Role-Key ist — oder eine Variable, die darauf auflöst — läuft der Browser als Root. - Die Git-History. Ein Key, den du letzte Woche entfernt hast, steckt noch in alten Commits. Durchsuche die Historie, nicht nur den Arbeitsstand.
Der supabase anon key ist der einzige Key, der in diesen Code gehört. Braucht deine App den elevated Key wirklich, gehört dieser Codepfad auf einen Server.
App in fünf Minuten prüfen
- Öffne deine Live-Site, öffne DevTools, geh zu Sources. Durchsuche alle geladenen Dateien nach
service_role,sb_secret_undeyJ. - Im Repo: Suche nach
service_role,sb_secret_undSERVICE_ROLE— inklusive.env-Dateien und Build-Output indist,buildoder.next. - Prüfe die Variablen, die dein Hosting-Anbieter injiziert. Ein korrekt benanntes Secret wird trotzdem öffentlich, wenn das Framework es in Client-Code kopiert.
- Durchsuche die Git-History nach denselben Strings. Gefunden heißt geleakt — geh vom Schlimmsten aus.
Findet sich nichts, bleibt das Gegenstück als Risiko: der Anon-Key ganz ohne supabase rls-Policies dahinter — leiser, aber dieselbe offene Datenbank.
Fixen — rotieren, verschieben, dann die fehlenden Policies schreiben
- Neuen secret key erstellen im Supabase-Dashboard → Settings → API Keys. Den alten noch nicht deaktivieren — laufender Code nutzt ihn noch.
- Jede legitime Nutzung umziehen: Edge-Function-Secrets, Server-Env-Vars, CI. Der elevated Key bekommt nie wieder ein
VITE_-/NEXT_PUBLIC_-Präfix. - Geleakten Key retirieren. Bei altem
service_roletrifft das Retirieren auch den gekoppeltenanon-Key — Clients im selben Schritt auf den publishable key umstellen. Erst das Retirieren schließt die Tür wirklich. - Aus dem Frontend entfernen. Der Client geht zurück auf den publishable key. Neu deployen und prüfen, dass das Bundle ihn nicht mehr enthält.
- Die Policies schreiben, die die KI übersprungen hat. RLS aktivieren und SELECT/INSERT/UPDATE/DELETE auf
auth.uid()oder dein Membership-Modell scopen. Das ist der echte Fix — der Key hat nur die fehlende Policy verdeckt. - Ausgeloggt verifizieren. Deinen REST-Endpoint nur mit dem publishable key aufrufen. Private Tabellen müssen leer oder 401 liefern, nicht Zeilen.
Wo der Service-Role-Key legitim lebt
Es gibt echte Gründe für diesen Key. Server-Code, der RLS ignorieren muss — Nutzer provisionieren, mandantenübergreifende Jobs, Webhook-Handler — läuft ihn aus serverseitigen Env-Vars oder Edge-Function-Secrets. Der Test ist simpel: Könnte ein Fremder diesen Wert aus dem lesen, was du shipst? Wenn ja, ist es der falsche Ort.
Env-Vars, die den Laptop nie verlassen haben, sind das Geschwister-Problem — die lovable deploy-Checkliste deckt die fünf Production-Settings ab, die am selben Wochenende brechen, und supabase rls geht die Policy-Seite im Detail durch.
Pre-Launch-Checkliste
- Bundle-Suche findet keine
service_role-,sb_secret_– odereyJ-Strings - Nur publishable-key-Env-Vars tragen
VITE_-/NEXT_PUBLIC_-/REACT_APP_-Präfixe - Secret key liegt in Server-Env oder Edge-Function-Secrets — nie im Repo
- Git-History ist sauber, oder der alte Key ist retiriert
- RLS aktiv mit Policies — der Fix, den die KI umgangen hat
- Ausgeloggte REST-Calls liefern leer, nicht deine Tabellen
Ein supabase service role key im Browser ist kein Workaround. Es ist deine Datenbank, mitgeliefert zur Seite.
FAQ
Was kann jemand mit meinem supabase service role key anstellen?
Alles. Der Service-Role-Key umgeht Row Level Security — ein Fremder kann jede Zeile lesen, ändern oder löschen, die deine Grants erlauben, Nutzer anlegen und oft Storage-Dateien lesen. Jede Exposition in Frontend-Code oder einem öffentlichen Repo gilt als Leck.
Ist der Service-Role-Key dasselbe wie der Anon-Key?
Nein. Der Anon-Key ist öffentlich by Design und im Browser sicher, wenn RLS-Policies gesetzt sind. Der Service-Role-Key ist ein Root-Credential nur für vertrauenswürdige Backends. Neuere Projekte zeigen publishable und secret keys — der secret key ist das Service-Role-Äquivalent.
Mein Key lag einen Tag in einem öffentlichen Repo. Trotzdem rotieren?
Ja. Bots scannen öffentliche Repos und Websites laufend nach Keys — geh davon aus, dass er kopiert wurde. Erstelle einen neuen secret key im Supabase-Dashboard, migriere jede legitime Nutzung darauf und retiriere dann den alten Key. Erst das Retirieren schließt die Tür wirklich.