本文へスキップ

Supabase service role keyが漏えいしたら:対応の順番

Supabase

Markdownで表示Claudeで開くChatGPTで開くPerplexityで開く

質問もコピーされます。チャットが空で開いた場合は貼り付けてください。

このページの内容
  1. 漏えいした鍵で何ができる?
  2. 鍵を交換する正しい順番は?
  3. 鍵が外に出ていた間に何があったか、どう確認する?
  4. 次の漏えいを小さくするには?
  5. 似たケース

TL;DR

漏えいしたservice role keyはRLSを素通りし、Auth admin APIも使えます。私のローカルのテストでは、オーナーのみのポリシーがあっても3行中3行を読み、別のユーザーの行を変更し、すべてのユーザーを一覧しました。漏えいの原因を直し、新しいsecret keyを作り、すべてのコンポーネントをそれに移し、古い鍵を廃止してから、鍵が外に出ていた間に何が変わったかを確認してください。今まさに誰かが使っている場合は、先に廃止して、停止を受け入れます。

私の無料のシークレットスキャナーは、公開ページ1つのHTMLとリンク先のスクリプトファイルを読み取り、訪問者がコピーできる API キー、トークン、データベース URL を探します。Supabase の service_role キーも対象で、値はマスクして表示します。このノートでは、キーが漏れたときの対応を扱います。

Supabaseアプリを引き継ぐとき、私が最初にビルド済みJavaScriptで探すのがこの鍵です。2つの鍵の違いはanon keyとservice role keyの違いにあります。このノートは、秘密のほうの鍵がバンドル、公開リポジトリ、ログのどこかで見つかった、最悪の日のためのものです。

漏えいした鍵で何ができる?

ローカルのSupabaseスタック(CLI 2.109.1、Postgres 17.6)で確認しました。RLSがオンで、オーナーのみのポリシーがあり、偽の注文3件を持つテーブルと、テスト用のユーザー一覧を使っています。

漏えいした鍵が開けたもの。ローカルのSupabase、RLSオン、オーナーのみのポリシー。テーブルを読む:Secret key → orders、RLSオン → 3行中3行、ユーザーを一覧:Secret key → Auth admin API → 200、全ユーザー、同じ呼び出し、公開キー:Publishable key → Auth admin API → 403。
ローカルのSupabaseスタックでの私のテスト、2026年11月2日。
リクエスト Publishable key Secret keyまたはservice_roleキー
ordersを読む 0行 3行中3行
他人の行を更新する 試していない 1行変更
GET /auth/v1/admin/users 403 200、全ユーザーを一覧

従来のservice_roleキーと新しいsb_secret_キーは、3つとも同じ結果でした。

誤った安心につながりかねない結果が2つあります。

  • このスタックでは、新しいテーブルにAPIロールが得た権限はTRUNCATE、REFERENCES、TRIGGERだけでした。そのため、GRANTを実行するまで、secret keyは42501のコードで403を受け取りました。だからといって漏えいが無害になるわけではありません。同じ時点で、Auth adminの呼び出しは200を返しました。この背景にある変更はSupabase 42501 permission deniedにあります。
  • SupabaseのAPI keysガイドは、ブラウザから使ったsecret keyは401になると述べ、攻撃者は他のツールからなら使えると付け加えています。私のローカルスタックはブラウザのヘッダー付きのリクエストに200を返したので、このブロックはここでは再現できませんでした。

鍵を交換する正しい順番は?

この手順は、Supabaseの漏えいした鍵をローテーションするガイドに沿っています。このノートのために、ホスト版プロジェクトで実行してはいません。

  1. 原因を直す。 バンドル、リポジトリ、ログから鍵を取り除きます。そうしないと、新しい鍵も同じ形で漏れます。Gitの最新コミットから消すだけでは足りません。履歴にまだ残っているからです。
  2. 新しいsecret keyを作る。 Settings → API Keysで作成します。
  3. 古い鍵をすべての場所で置き換える。 サーバー、cronジョブ、Edge Function、Database Webhooks、pg_netの呼び出しです。従来の鍵をAuthorization: Bearerで送っていたwebhookは、今後は新しい鍵をapikeyヘッダーで送ります。
  4. 漏えいしたのが従来のservice_roleキーなら、クライアントもpublishable keyに移す。 従来のキーを無効にするとanonとservice_roleが一緒に止まるので、まだanonを使っているクライアントは動かなくなります。
  5. 古い鍵をもう誰も使っていないことを確認する。 API Keysのページには、そのための最終使用の表示があります。
  6. 廃止する。 secret keyは削除します。これは元に戻せません。従来のキーの場合は無効にします。
  7. 従来のキーなら、従来のJWTシークレットも失効させる。 JWT signing keysのガイドに従います。従来のキーはそのシークレットで署名されたトークンなので、まだそれを信頼しているものは、漏えいした鍵を受け入れる可能性があります。

例外は、攻撃が進行中の場合です。そのときガイドは、その鍵を使うコンポーネントが置き換えるまで動かなくなるとしても、すぐに鍵を廃止するよう述べています。

従来のキーを無効にしたあとでクライアントを1つ移し忘れたら、そのクライアントを新しい鍵に移してください。従来のキーを再び有効にすると、漏えいした鍵も一緒に戻ってきます。

鍵が外に出ていた間に何があったか、どう確認する?

Supabaseは、鍵だけからは誰がそれを持っていたかを教えられないので、結果を探します。まず、新規または変更されたアカウントを見ます。

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

見覚えのないアカウントや、誰も付与していないロールを探してください。そのあと、重要なテーブルを漏えい前の最後のバックアップと比べます。バックアップがあるか不安になったなら、Supabase backupsを読んでください。ユーザーの個人データが読まれた可能性があるので、データ保護のルールで報告が必要かどうかも確認してください。

次の漏えいを小さくするには?

コンポーネントごとに別のsecret keyを使います。これはAPI keysガイドも勧めていて、1回の漏えいがローテーション1回で済みます。NEXT_PUBLIC_やVITE_のプレフィックスが付くものには鍵を置かないでください。それらはブラウザに送られます。そして、本番ビルドを出す前に、毎回sb_secret_とservice_roleを検索してください。公開中のサイトでは、無料のシークレットスキャナーが同じ検索を公開ページ1つとそのページが読み込むスクリプトに対して実行します。

設定1つではなくアプリ全体を人の目で見てほしい場合は、各部分について「残す・修正・書き直し」の判断を付ける範囲固定のアプリ監査を行っています。

似たケース

公開されている1,170のSupabaseプロジェクトのマイグレーションを新しいデータベースに適用しました。問題なく動いた568件のうち134件(23.6%)に、RLSがオフで、公開キーで読み書きできるテーブルがありました。手法とクエリはオープンソースSupabase調査にあります。

キーが漏れたかもしれないと心配ですか?ご連絡ください。ローテーションし、何が露出したかを確認します。

キーの漏えいが心配ですか?

今お使いのものと必要なものを教えてください。私が選ぶ選択肢をお返事します。

ご連絡ください

© 2026 Denys Zaichenko. 元の記事: https://madsalt.tech/ja/notes/supabase-service-role-key-leaked/