Supabase、アクセストークンを権限ごとに絞る形に　エージェントに全権を渡さない

米Supabaseは10月27日、個人のアクセストークン（PAT）を、組織・プロジェクト・権限ごとに絞って作れることをXの公式アカウントで知らせた。これまでのトークンは、持ち主ができることを全部できた。コーディングエージェントやCIに渡す鍵を、1つのプロジェクトの読み取りだけに狭められるようになり、鍵が漏れた時や、エージェントが想定外の操作をした時の被害を小さくできる。

鍵は今まで「アカウント全体」だった

Supabaseの公式ブログによると、これまでのPATは、持ち主が属する全部の組織とプロジェクトで、持ち主と同じ操作ができた。読み取りを1回するだけの道具にも、アカウント全体の鍵を渡すしかなかったという。

絞り込みの機能は9月28日に一般提供が始まり、10月2日のイベント「Supabase Select」で発表された。今では管理画面で作るトークンは、既定で範囲を絞った形になる。同社によると、提供の開始から管理画面で作られたトークンの10本に9本近くが、範囲を絞ったものだった。

1つのプロジェクトの読み取りだけを渡す

ブログは、表の中身を調べ、型を作り、読み取りだけのSQLを流すコーディングエージェントを例に、作り方を4段階で示している。まず対象のプロジェクトを1つ選ぶ。複数の組織にまたがる鍵も作れるが、管理画面はプロジェクト単位を勧める。

次に権限を決める。全部まとめて決める「No access」「Read-only」「Full access」の3つの型があるが、「Read-only」にはAPIキーなどの秘密の値も含まれる。このため同社は、「No access」から始めて「Database」だけを読み取りにする手順を勧めている。期限は最長1年で、1週間で終わる仕事なら鍵も1週間で切れるようにする。

最後の確認の画面では、権限ごとに、使える管理用のAPI（Management API）とMCPの道具の一覧を開いて見られる。届く範囲と書き込みの権限の組み合わせから、危険の度合いが「Low」「Medium」「High」の3段階で表示される。トークンの値は一度しか表示されず、範囲と権限は作った後に変えられない。変える時は新しいトークンを作って入れ替える。

持ち主の権限を超えない

トークンは、持ち主のアカウントの権限を超えて動かない。リクエストのたびに、トークンの範囲と、持ち主の今の役割の両方を確かめる仕組みだ。持ち主が組織を抜けたり、データベースを読む権限を失ったりすれば、エージェントもその操作をできなくなる。

範囲を絞ったトークンは「sbp_fc」で始まり、Management APIとMCPサーバー、CLIでそのまま使える。APIで権限が足りない時は、403の応答の「missing_permissions」に、足りない権限の名前が入る。MCPサーバーでは、道具ごとに実行の前に権限を確かめる。読み取りの権限だけのエージェントが「execute_sql」で書き込みを試すと、Postgresの権限のエラーが返る。マイグレーションを当てる「apply_migration」には、別の読み書きの権限が要る。

CLIのログインはまだ全権

ただし、CLIの「supabase login」でブラウザーから作るトークンは、今はまだアカウント全体の権限を持つ。同社は選んだ範囲で作る形に直している途中で、それまでは管理画面で作ったトークンを「supabase login --token」で渡すよう勧めている。「SUPABASE_DB_PASSWORD」に頼るデータベースの操作は、トークンの権限を通らない点にも注意が要る。

今あるトークンはそのまま使え、廃止の期限も無い。全権のトークンには管理画面で「Legacy」の印が付き、全権のトークンを新しく作る選択肢も残る。エージェントやCIに渡す鍵を、その仕事に要る範囲だけに絞れるようになったことが、今回の要点だ。

編集部の見方

Supabaseの鍵をClaude CodeやCursorのMCPの設定に入れている人は多い。その鍵が全部のプロジェクトを消せる鍵のままなら、エージェントの1回の誤操作が本番のデータベースに届く。まず手元の設定にある鍵を「Legacy」かどうかで確かめ、エージェント用はプロジェクト1つ・読み取りだけ・短い期限で作り直したい。CLIのブラウザーのログインがまだ全権で鍵を作る点は、CIの設定でも見落としやすい。