本文へスキップ

Supabase Vault:秘密が公開キーに漏れる仕組み

Supabase

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

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

このページの内容
  1. Supabase Vaultは何を守る?
  2. デフォルトで読めるのは誰?
  3. それでも秘密が漏れるのはなぜ?
  4. Vaultを安全に使うには?
  5. 似たケース

TL;DR

Supabase Vaultは秘密を暗号化して保管し、ビューvault.decrypted_secretsを通して復号します。デフォルトで読めるのはservice_roleとpostgresだけで、私のローカルスタックでは、anonとauthenticatedはvaultスキーマにまったくアクセスできませんでした。秘密が漏れる経路は2つあります。クライアントロールへのVaultのgrantと、公開スキーマにある、復号した値を返すSECURITY DEFINER関数です。私のテスト関数は、架空の秘密を公開キーに200で返しました。EXECUTEを取り消すと、42501で応答しました。

私の無料のSupabaseセキュリティチェッカーには、漏えい経路ごとにルールがあります。「API ロールから読める Vault のシークレット」はanonが読める場合に致命的と評価され、もう1つは「API から呼び出せる security definer 関数」です。このノートでは、後者がVaultでなぜ重要かを示します。

Supabase Vaultは何を守る?

SupabaseのVaultガイドは、Vaultを、認証付き暗号化で保管された秘密のテーブルで、ビューを通して復号された形で読めるものと説明しています。秘密は、ディスク上でも、バックアップでも、レプリケーションでも、暗号化されたままです。ガイドは、すべてが依存する条件も挙げています。ビューにアクセスできる人は復号された秘密にアクセスできるため、そのアクセスは常にSQLの権限で制限しなければなりません。

デフォルトで読めるのは誰?

ローカルのSupabaseスタック(CLI 2.109.1、Postgres 17.6)で、vault.create_secretを使って架空の値を保存し、各ロールを確認しました。

ロール vaultスキーマのusage vault.decrypted_secretsのselect
anon なし なし
authenticated なし なし
service_role あり あり

vaultスキーマは、デフォルトではData APIの公開スキーマにも入っていません。つまり、初期状態では、公開キーはVaultに到達できません。

それでも秘密が漏れるのはなぜ?

よくある理由は、アプリが秘密を必要とすることです。関数は、それを渡す最短の方法です。

公開キーがVaultから取り出せるもの。ローカルのSupabase、架空の秘密1つ、publishable key。デフォルト:Publishable key → vaultスキーマ → アクセス不可、definer関数が秘密を返す:Publishable key → rpc/get_api_key → 200、秘密、クライアントロールからEXECUTEを取り消し:Publishable key → rpc、EXECUTEなし → 401, 42501。
ローカルのSupabaseスタックでの私の再現、2026年10月23日。
create function public.get_api_key() returns text
language sql security definer set search_path = ''
as $$ select decrypted_secret from vault.decrypted_secrets where name = 'demo_api_key' $$;

SECURITY DEFINERは所有者の権限で実行されるため、Vaultを読めます。既存のプロジェクトでは、publicの関数にはデフォルトでanonとauthenticatedにEXECUTEが付与され、publicは公開されています。そのため、Data APIはこれを/rest/v1/rpc/get_api_keyとして提供します。

publishable keyでのリクエスト 結果
POST /rest/v1/rpc/get_api_key 200、復号された架空の値
同じリクエスト、revoke execute … from public, anon, authenticatedのあと 401、42501 “permission denied for function get_api_key”

2つ目の漏えい経路はgrantです。誰かがvaultを公開スキーマに加えたり、クエリを動かすためにクライアントロールへusageとselectを付与したりします。チェッカーが致命的と評価するのはこのケースです。

Vaultを安全に使うには?

  • 秘密は、サーバー側でのみ読みます。値を返さないデータベース関数、triggerやwebhook、secret keyを使うEdge Functionsの中です。
  • 関数が秘密を読む必要があるなら、公開されていないスキーマに置くか、public、anon、authenticatedからEXECUTEを取り消し、必要なロールにだけ付与します。
  • クライアントが呼び出せる関数から、復号した値を返してはいけません。代わりに、秘密を使った結果(たとえばAPI呼び出しのレスポンス)を返します。
  • vaultを公開スキーマに加えてはいけません。このリストが何を開くのかは、Supabase exposed schemasで説明しました。

関数もAPIです。search_pathやNULLの扱いを含む、そのルールの残りはLovableアプリのセキュリティチェックリストにあります。ラッパー関数のsearch_pathがどのように逆用されうるかは、Supabase search_path警告:意味と対処にあります。

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

似たケース

私が手がけたある会社は、エンタープライズ向けの文書製品に月に数千ドルを払っていました。現在は自社のプラットフォームが月に数百で、文書、フォーム、レポート、クライアントポータルのロールを備え、チームが使う機能だけを持っています。建設文書プラットフォームの事例をご覧ください。

シークレットの保管場所が不安ですか?ご連絡ください。確認します。

シークレットはどこに保管されていますか?

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

ご連絡ください

© 2026 Denys Zaichenko. 元の記事: https://madsalt.tech/ja/notes/supabase-vault-secrets/