---
title: "Uniklý Supabase service role key: co dělat a v jakém pořadí"
description: "Co uniklý service role key v Supabase otevřel v mém lokálním testu a v jakém pořadí ho vyměnit, starý zrušit a ověřit škody bez výpadku aplikace."
url: "https://madsalt.tech/cs/notes/supabase-service-role-key-leaked/"
author: "Denys Zaichenko"
author_url: "https://madsalt.tech/cs/about/"
language: "cs"
published: 2026-11-14
---

# Uniklý Supabase service role key: co dělat a v jakém pořadí

TL;DR

Uniklý service role key obchází RLS a může používat Auth admin API. V mém lokálním testu přečetl 3 ze 3 řádků pod politikami jen pro vlastníka, změnil řádek jiného uživatele a vypsal všechny uživatele. Opravte příčinu úniku, vytvořte nový secret key, přesuňte na něj každou komponentu, starý klíč zrušte a pak zkontrolujte, co se za tu dobu změnilo. Pokud klíč právě někdo používá, zrušte ho jako první a smiřte se s výpadkem.

Můj bezplatný [skener tajných klíčů](https://madsalt.tech/cs/tools/secret-scanner/) přečte HTML jedné veřejné stránky a odkazované soubory skriptů a hledá API klíče, tokeny a URL databází, které by si návštěvník mohl zkopírovat, včetně klíče Supabase `service_role`; hodnoty zobrazuje zamaskované. Tato poznámka je o tom, co dělat, když klíč unikl.

Když převezmu aplikaci na Supabase, tenhle klíč je první věc, kterou hledám v sestaveném JavaScriptu. Rozdíl mezi oběma klíči je v článku [anon key vs service role key](https://madsalt.tech/cs/blog/supabase-anon-key-vs-service-role-key/). Tato poznámka je pro špatný den, kdy se ten tajný objevil v bundlu, ve veřejném repozitáři nebo v logu.

## Co může s uniklým klíčem někdo udělat?

Ověřil jsem to na lokálním Supabase stacku (CLI 2.109.1, Postgres 17.6), na tabulce se zapnutým RLS, politikami jen pro vlastníka a 3 fiktivními objednávkami, plus testovacím seznamem uživatelů.

![Co uniklý klíč otevřel. Lokální Supabase, RLS zapnuté, politiky jen pro vlastníka. Čtení tabulky: Secret key → orders, RLS zapnuté → 3 z 3 řádků; Výpis uživatelů: Secret key → Auth admin API → 200, všichni uživatelé; Stejné volání, veřejný klíč: Publishable key → Auth admin API → 403.](https://madsalt.tech/charts/cs/supabase-service-role-key-leaked.svg)

*Můj test na lokálním Supabase, 2. listopadu 2026.*

| Požadavek                  | Publishable key | Secret nebo `service_role` key   |
| -------------------------- | --------------- | -------------------------------- |
| Čtení `orders`             | 0 řádků         | 3 z 3 řádků                      |
| Změna cizího řádku         | Nezkoušeno      | změněn 1 řádek                   |
| `GET /auth/v1/admin/users` | `403`           | `200`, vypsáni všichni uživatelé |

Starší klíč `service_role` a nový klíč `sb_secret_` se ve všech třech případech chovaly stejně.

Dva výsledky by mohly dát falešný pocit bezpečí:

- Nová tabulka na tomto stacku dala rolím API jen `TRUNCATE`, `REFERENCES` a `TRIGGER`. Secret key na ní proto dostal `403` s kódem `42501`, dokud jsem nespustil `GRANT`. Únik to neudělá neškodným: volání Auth admin odpovědělo `200` ve stejném okamžiku. Změna, která za tím stojí, je v poznámce [Supabase 42501 permission denied](https://madsalt.tech/cs/notes/supabase-42501-permission-denied/).
- [Průvodce API keys](https://supabase.com/docs/guides/getting-started/api-keys) od Supabase říká, že secret key použitý z prohlížeče dostane `401`, a dodává, že útočník ho může stále použít z jiných nástrojů. Můj lokální stack odpověděl `200` na požadavek s hlavičkami prohlížeče, takže jsem tuto blokaci tady nemohl reprodukovat.

## Jaké je správné pořadí výměny klíče?

Tyto kroky vycházejí z [průvodce rotací uniklého klíče](https://supabase.com/docs/guides/security/rotate-leaked-api-keys) od Supabase. Pro tuto poznámku jsem je na hostovaném projektu nespouštěl.

1. **Opravte příčinu.** Odstraňte klíč z bundlu, repozitáře nebo logu, jinak unikne nový stejným způsobem. Smazat ho z posledního commitu v Gitu nestačí, protože historie ho dál obsahuje.
2. **Vytvořte nový secret key** v Settings → API Keys.
3. **Nahraďte starý klíč všude**: servery, cron joby, Edge Functions, Database Webhooks a volání `pg_net`. Webhook, který posílal starší klíč v `Authorization: Bearer`, teď posílá nový klíč v hlavičce `apikey`.
4. **Pokud unikl starší klíč `service_role`, přesuňte také klienty na publishable key.** Deaktivace starších klíčů vypne `anon` i `service_role` najednou, takže klient, který zůstal na `anon`, přestane fungovat.
5. **Ověřte, že starý klíč nic nepoužívá.** Stránka API Keys má k tomu ukazatele posledního použití.
6. **Zrušte ho.** Smažte secret key, což nejde vrátit, nebo deaktivujte starší klíče.
7. **U staršího klíče zrušte i starší JWT secret** podle [průvodce JWT signing keys](https://supabase.com/docs/guides/auth/signing-keys). Starší klíče jsou tokeny podepsané tímto secretem, takže cokoli, co mu stále důvěřuje, může uniklý klíč přijmout.

Výjimkou je útok, který právě probíhá. Pak průvodce říká klíč zrušit okamžitě, i když komponenty, které ho používají, přestanou fungovat, dokud ho nenahradíte.

Pokud jste po deaktivaci starších klíčů na nějakého klienta zapomněli, přesuňte ho na nový klíč. Opětovné zapnutí starších klíčů vrátí i uniklý klíč.

## Jak zjistíte, co se stalo, když byl venku?

Supabase podle samotného klíče neřekne, kdo ho držel, proto hledejte následky. Začněte novými nebo změněnými účty:

```sql
select email, created_at, last_sign_in_at, raw_app_meta_data
from auth.users
order by created_at desc
limit 50;
```

Hledejte účty, které neznáte, a role, které nikdo nepřidělil. Pak porovnejte důležité tabulky s poslední zálohou z doby před únikem. Pokud vás ta věta zneklidnila, že žádnou nemáte, přečtěte si [Supabase backups](https://madsalt.tech/cs/notes/supabase-backups/). Osobní údaje vašich uživatelů mohly být čitelné, proto zkontrolujte, zda pravidla ochrany osobních údajů vyžadují ohlášení.

## Jak udržet další únik malý?

Používejte samostatný secret key pro každou komponentu, což průvodce API keys doporučuje, takže jeden únik znamená jednu rotaci. Nedávejte klíč do ničeho s předponou `NEXT_PUBLIC_` nebo `VITE_`, protože to jde do prohlížeče. A před nasazením prohledejte každý produkční build na `sb_secret_` a `service_role`. Na živém webu provede stejné hledání bezplatný [skener tajných klíčů](https://madsalt.tech/cs/tools/secret-scanner/), a to na jedné veřejné stránce a skriptech, které načítá.

Pokud má celou aplikaci projít člověk, a ne jen jedno nastavení, nabízím [audit aplikace s pevně daným rozsahem](https://madsalt.tech/cs/services/vibe-coded-app-audit/) s verdiktem ponechat, opravit, nebo přepsat pro každou část.

## Můj podobný případ

Aplikoval jsem migrace 1 170 veřejných projektů Supabase na čerstvé databáze: z 568, které proběhly bez chyby, mělo 134 (23,6 %) tabulku s vypnutým RLS, kterou veřejný klíč uměl číst a měnit. Metoda a dotazy jsou v [open-source studii Supabase](https://madsalt.tech/cs/blog/open-source-supabase-projects-security-study/).

Bojíte se, že unikl klíč? Napište mi a vyměníme ho a zkontrolujeme, co odhalil.

Bojíte se, že unikl klíč?

Napište mi, co máte teď a co potřebujete. Odpovím variantou, kterou bych zvolil já.

[Napište mi](https://madsalt.tech/cs/#contact)
