---
title: "Supabase Vault：秘密が公開キーに漏れる仕組み"
description: "Supabase Vaultは秘密を暗号化して保管しますが、grantやラッパー関数が公開キーに渡してしまうことがあります。ローカルテストの結果と防ぎ方を紹介します。"
url: "https://madsalt.tech/ja/notes/supabase-vault-secrets/"
author: "Denys Zaichenko"
author_url: "https://madsalt.tech/ja/about/"
language: "ja"
published: 2026-11-13
---

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

TL;DR

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

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

## Supabase Vaultは何を守る？

Supabaseの[Vaultガイド](https://supabase.com/docs/guides/database/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。](https://madsalt.tech/charts/ja/supabase-vault-secrets.svg)

*ローカルのSupabaseスタックでの私の再現、2026年10月23日。*

```sql
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](https://madsalt.tech/ja/notes/supabase-exposed-schemas/)で説明しました。

関数もAPIです。`search_path`や`NULL`の扱いを含む、そのルールの残りは[Lovableアプリのセキュリティチェックリスト](https://madsalt.tech/ja/blog/lovable-app-security-checklist/)にあります。ラッパー関数の`search_path`がどのように逆用されうるかは、[Supabase search_path警告：意味と対処](https://madsalt.tech/ja/notes/supabase-function-search-path-mutable/)にあります。

設定1つではなくアプリ全体を人の目で見てほしい場合は、各部分について「残す・修正・書き直し」の判断を付ける[範囲固定のアプリ監査](https://madsalt.tech/ja/services/vibe-coded-app-audit/)を行っています。

## 似たケース

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

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

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

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

[ご連絡ください](https://madsalt.tech/ja/#contact)
