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に到達できません。
それでも秘密が漏れるのはなぜ?
よくある理由は、アプリが秘密を必要とすることです。関数は、それを渡す最短の方法です。
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つではなくアプリ全体を人の目で見てほしい場合は、各部分について「残す・修正・書き直し」の判断を付ける範囲固定のアプリ監査を行っています。
似たケース
私が手がけたある会社は、エンタープライズ向けの文書製品に月に数千ドルを払っていました。現在は自社のプラットフォームが月に数百で、文書、フォーム、レポート、クライアントポータルのロールを備え、チームが使う機能だけを持っています。建設文書プラットフォームの事例をご覧ください。
シークレットの保管場所が不安ですか?ご連絡ください。確認します。