SupabaseのRLSをテストする方法|別ユーザー・API・保存結果の確認
SupabaseのRLSを匿名・本人・別ユーザーでテストする手順を説明します。SELECT・INSERT・UPDATE・DELETE、所有者の書き換え、APIの応答と保存結果を確かめるSQLとJavaScript例を掲載。
SupabaseのRLSは、匿名・本人・別ユーザーのそれぞれでデータを読み書きしてテストします。許可した操作が成功することと、拒否した操作でデータが変わらないことを、APIの応答と保存結果の両方で確かめます。
この記事では、本人だけが読み書きできるメモを例に、SQLとJavaScriptで確認する手順を示します。説明用に作った架空の構成です。既存アプリで確認すべき範囲の全体像は、Supabaseのセキュリティチェックを参照してください。
RLSのテストで期待する結果を先に決める
RLSは、データの行ごとにアクセスを制限する仕組みです。今回は「メモの所有者だけが、そのメモを閲覧・追加・更新・削除できる」という仕様にします。AとBは別々のテストユーザーです。
| 操作 | 期待する結果 |
|---|---|
| Aが自分のメモを追加・閲覧する | 作成した内容を取得できる |
| Bが自分のメモを追加・閲覧する | B自身の内容を取得できる |
| 未ログインでAのメモを読む | 0件で、内容を取得できない |
| 未ログインでメモを追加・更新・削除する | 権限エラーとなり、保存内容は変わらない |
| BがAのメモを読む | 0件で、内容を取得できない |
| BがAのメモを更新・削除する | 対象0件。Aから読むと元のメモが残る |
| Bが所有者をAにしてメモを追加する | 拒否され、追加されない |
| Aが自分のメモの所有者をBへ変える | 拒否され、所有者はAのまま |
| Aが自分のメモを更新する | 新しい内容が保存される |
| Aが自分のメモを削除する | 削除後の読み取りが0件になる |
別ユーザーの操作が失敗しただけでは、権限が正しいと判断できません。接続先やテーブル名を間違えていれば、本人の操作も失敗します。先にA・Bそれぞれの正規操作を確認してから、相手のデータに対する操作を試します。
ローカルSupabaseにテスト用の表と二人を用意する
新しいローカルSupabase環境を使い、架空のデータだけで試します。環境の準備はSupabaseのローカル開発ガイドに沿って進めてください。既存の本番DBに、以下のテーブルやポリシーを追加する手順ではありません。
ローカルの管理画面で、メールとパスワードでログインできるテストユーザーA・Bを作ります。必要なメール確認も済ませ、UUIDが異なる二人を用意してください。
次のSQLをローカル環境に適用します。rls_example_notes はこの記事用の名前です。既に同名の表がある場合は、別の検証環境を使います。
create table public.rls_example_notes (
id uuid primary key default gen_random_uuid(),
owner_id uuid not null references auth.users(id),
body text not null
);
alter table public.rls_example_notes enable row level security;
revoke all on public.rls_example_notes from public, anon, authenticated;
grant select on public.rls_example_notes to anon;
grant select, insert, update, delete
on public.rls_example_notes to authenticated;
create policy notes_select_owner
on public.rls_example_notes for select to authenticated
using ((select auth.uid()) = owner_id);
create policy notes_insert_owner
on public.rls_example_notes for insert to authenticated
with check ((select auth.uid()) = owner_id);
create policy notes_update_owner
on public.rls_example_notes for update to authenticated
using ((select auth.uid()) = owner_id)
with check ((select auth.uid()) = owner_id);
create policy notes_delete_owner
on public.rls_example_notes for delete to authenticated
using ((select auth.uid()) = owner_id);
using は操作対象となる既存の行、with check は追加・更新後の行に対する条件です。更新前にAの行だったとしても、更新後の所有者をBに変えてよいとは限らないため、更新後の条件も確認します。UPDATEにはSELECTのポリシーも必要です。Supabaseの操作別RLSポリシー
この例では、未ログインのanonにSELECTの実行権限だけを与え、行を許可するポリシーは用意していません。そのためSELECTは0件となります。匿名の書き込みは、テーブルの権限で拒否されます。テーブルへの操作権限と、RLSによる行の絞り込みを区別して記録します。
A・B・未ログインのクライアントを分ける
Node.jsと@supabase/supabase-js v2を使います。次のJavaScript例は、同じcheck-rls.mjsへ順番に保存して実行する想定です。パッケージは検証用の作業ディレクトリで用意してください。
npm install @supabase/supabase-js@2
接続先URL、公開用キー、A・Bのメールとパスワードを、それぞれ次の環境変数で渡します。.env.rls-testなどのファイルを使う場合はGitの管理対象から外します。SUPABASE_PUBLIC_KEYにはpublishable keyまたは従来のanon keyを使い、service_role・secret keyは使いません。SupabaseのAPIキー
SUPABASE_URL
SUPABASE_PUBLIC_KEY
RLS_TEST_EMAIL_A
RLS_TEST_PASSWORD_A
RLS_TEST_EMAIL_B
RLS_TEST_PASSWORD_B
import assert from 'node:assert/strict';
import { createClient } from '@supabase/supabase-js';
function env(name) {
assert.ok(process.env[name], `${name} is required`);
return process.env[name];
}
const url = env('SUPABASE_URL');
assert.ok(['127.0.0.1', 'localhost'].includes(new URL(url).hostname));
const publicKey = env('SUPABASE_PUBLIC_KEY');
const client = () => createClient(url, publicKey, {
auth: { persistSession: false, autoRefreshToken: false,
detectSessionInUrl: false },
});
async function login(suffix) {
const db = client();
const { data, error } = await db.auth.signInWithPassword({
email: env(`RLS_TEST_EMAIL_${suffix}`),
password: env(`RLS_TEST_PASSWORD_${suffix}`),
});
assert.equal(error, null);
assert.ok(data.session);
return { db, id: data.user.id };
}
const a = await login('A');
const b = await login('B');
assert.notEqual(a.id, b.id);
const anonymous = client();
const table = 'rls_example_notes';
async function rows(query) {
const { data, error } = await query;
assert.equal(error, null);
assert.ok(Array.isArray(data));
return data;
}
クライアントを分け、セッションを保存しない設定にすることで、AでログインしたつもりがBのセッションに置き換わる混同を避けます。anonymousはログイン操作をしません。Supabase Authの「匿名ログイン」を使う利用者はauthenticatedとして扱われるため、ここでいう未ログインとは別の状態です。Supabaseの匿名ユーザー
APIの応答と、所有者から見た保存結果を確認する
続けて、以下のコードを同じファイルへ追加します。最初にAとBの正規の追加・閲覧を確認し、その後に他人のメモへの操作を試します。
const [noteA] = await rows(a.db.from(table)
.insert({ owner_id: a.id, body: 'Aの検証用メモ' }).select());
const [noteB] = await rows(b.db.from(table)
.insert({ owner_id: b.id, body: 'Bの検証用メモ' }).select());
assert.ok(noteA?.id);
assert.ok(noteB?.id);
const readA = () => rows(a.db.from(table).select()
.eq('id', noteA.id));
const readB = () => rows(b.db.from(table).select()
.eq('id', noteB.id));
assert.equal((await readA())[0]?.body, 'Aの検証用メモ');
assert.equal((await readB())[0]?.body, 'Bの検証用メモ');
for (const db of [anonymous, b.db]) {
assert.deepEqual(await rows(db.from(table).select()
.eq('id', noteA.id)), []);
}
for (const query of [
anonymous.from(table).insert({ owner_id: a.id, body: '匿名のメモ' }),
anonymous.from(table).update({ body: '匿名の変更' }).eq('id', noteA.id),
anonymous.from(table).delete().eq('id', noteA.id),
]) {
const { error } = await query;
assert.equal(error?.code, '42501');
}
assert.equal((await readA())[0]?.body, 'Aの検証用メモ');
assert.deepEqual(await rows(a.db.from(table).select()
.eq('owner_id', a.id).eq('body', '匿名のメモ')), []);
assert.deepEqual(await rows(b.db.from(table)
.update({ body: '変更されたら失敗' }).eq('id', noteA.id).select()), []);
assert.equal((await readA())[0]?.body, 'Aの検証用メモ');
assert.deepEqual(await rows(b.db.from(table)
.delete().eq('id', noteA.id).select()), []);
assert.equal((await readA())[0]?.body, 'Aの検証用メモ');
const forged = await b.db.from(table)
.insert({ owner_id: a.id, body: '所有者を偽ったメモ' }).select();
assert.equal(forged.error?.code, '42501');
assert.deepEqual(await rows(a.db.from(table).select()
.eq('owner_id', a.id).eq('body', '所有者を偽ったメモ')), []);
const reassigned = await a.db.from(table)
.update({ owner_id: b.id }).eq('id', noteA.id).select();
assert.equal(reassigned.error?.code, '42501');
assert.equal((await readA())[0]?.owner_id, a.id);
const updated = await rows(a.db.from(table)
.update({ body: 'Aが更新したメモ' }).eq('id', noteA.id).select());
assert.equal(updated.length, 1);
assert.equal((await readA())[0]?.body, 'Aが更新したメモ');
assert.equal((await rows(a.db.from(table)
.delete().eq('id', noteA.id).select())).length, 1);
assert.deepEqual(await readA(), []);
assert.equal((await readB())[0]?.body, 'Bの検証用メモ');
assert.equal((await rows(b.db.from(table)
.delete().eq('id', noteB.id).select())).length, 1);
assert.deepEqual(await readB(), []);
console.log('RLSの期待結果を確認しました');
環境変数をファイルで渡す場合の実行例です。--env-fileを使えるNode.jsを用意します。
node --env-file=.env.rls-test check-rls.mjs
assertが途中で止まったら、その箇所の応答と保存状態を調べます。例外が出た位置以降の検証は未実施です。失敗時には検証用のメモが残ることがあるため、状態を記録してから片付けます。エラーを握りつぶして最後の表示だけを出す変更はしないでください。
HTTP 200とエラーなしだけでは、更新を判定できない
RLSで対象行が見えなくなると、UPDATEやDELETEはエラーなしで対象0件になる場合があります。.select()で返却行を取得し、件数を確認します。通常の更新は結果の行を返さないため、dataがnullという理由だけで拒否されたとも判断できません。SupabaseのUPDATEの返却値
さらに、Bの操作後にはAとして読み直します。Bに「0件」が返ったことと、Aのデータが変わっていないことを一組で記録するためです。画面がエラーや認証ページを返した場合も、同じように保存結果を確かめます。
この例の42501は権限不足を表すコードです。所有者の偽装に対してこのコードが返ることを確認しますが、コードだけから原因を断定せず、本人の正常操作が通ることと照合します。
継続的なRLSテストでは、SQLとAPIの役割を分ける
ポリシーを変更するたびに確認するなら、SQLのテストを開発手順へ組み込みます。Supabaseは、期待値をSQLで判定するpgTAPと、supabase test dbによる実行方法を案内しています。SQLのテストでは、一般ユーザーのロールと認証情報を設定したうえで操作を実行します。SupabaseのRLSテスト手順
| 検証方法 | 主に確認すること |
|---|---|
| SQL・pgTAP | 操作ごとのポリシー条件、所有者変更、許可と拒否の期待値 |
| Supabase API | 実際のログイン情報、APIから見える範囲、応答と保存結果 |
| アプリの画面・更新処理 | 入力チェック、二段階認証、再試行、エラー表示と画面遷移 |
管理者としてSQLを実行した結果は、そのまま一般ユーザーの結果には置き換えられません。service_roleなどRLSを迂回する権限も、一般ユーザーの拒否テストには使いません。テストデータの準備に管理権限を使った場合は、確認する操作の前に一般ユーザーへ切り替えます。
DB関数・Storage・権限の変更も追加で試す
メモテーブルのテストが通ったら、実際のアプリが使う別の入口へ確認を広げます。
| 追加する対象 | 試す操作 |
|---|---|
| APIから呼ぶDB関数(RPC) | 別ユーザーのIDを渡しても、その人のデータを読めず変更できないか |
| 管理者専用の列 | 自分の行を更新できる利用者でも、承認状態などを変更できないか |
| Storage | 別ユーザーの画像を取得・上書き・削除できないか。非公開にしたい画像が公開URLから読めないか |
| 二段階認証 | 追加認証の前後で、DB更新・画像操作・アプリの更新処理が意図した結果になるか |
| 権限の取消 | 同じログイン状態のまま権限を取り消した後に、操作を拒否できるか |
DB関数は、その関数が持つ権限で動く設定になっていると、呼び出した利用者より広い範囲へアクセスできる場合があります。テーブルを直接更新したテストとは別に、関数内の対象データの権限も確認します。SupabaseのDB関数の権限
画像の公開範囲や管理者専用列など、確認項目の整理にはSupabaseのレビュー項目を使えます。AIで作ったWebアプリ全体の確認は、セキュリティ対策のガイドへまとめています。
確認した範囲を残し、次の変更で再実行する
結果には、確認日、接続した環境、コードとDBの変更履歴の版を残します。その環境で誰が何を操作したかを書き、期待結果と実際の応答・保存結果を対応させます。実行していない操作は未確認として記録します。
本稿のSQLは、PGliteの使い捨てDBで利用者とロールを模擬し、行の分離と保存結果を検証しました。この確認にはSupabase Auth・PostgRESTのHTTP処理は含まれません。JavaScript例は、それらを含めてローカルSupabaseで確認するための手順です。自分のアプリのテーブル・権限へ適用するときは、その構成で再実行してください。
権限の仕様やテスト範囲を整理したい場合は、技術顧問・セキュリティレビューへ相談できます。レビューを依頼する際の準備には、共有する情報と確認範囲の決め方をまとめています。
公式資料の確認日:2026年11月5日。
よくある質問
SupabaseのRLSをSQL Editorだけでテストできますか?
SQLでロールと利用者を切り替えれば、ポリシーの条件を検証できます。ただし、通常の管理者権限のまま実行しても一般ユーザーの確認にはなりません。認証情報やAPI経由の操作も確認する場合は、テストユーザーとして実際のAPIを呼びます。
更新APIが成功しても、RLSで拒否されていることはありますか?
あります。RLSによって対象行が見えない場合、エラーを返さず更新0件になることがあります。更新後の行を返す設定で件数を調べ、所有者として読み直して値が変わっていないことも確認します。
RLSのテストが通ればSupabase全体の確認は完了ですか?
今回のテストで確認できるのは、対象テーブルの行に対する操作です。DB関数、Storage、管理者専用の列、二段階認証、権限取消後の挙動は、アプリで使用している経路ごとに追加で確認します。
この記事を書いた人
株式会社Float Engineering 代表
西林 明信
自社プロダクトの開発・運営と、Webサイト・業務システムの受託開発を行っています。広告代理店でのマーケティング、楽天でのデータ分析を経て、2023年にFloat Engineeringを設立。
プロフィールを見る