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を設立。

ブログ一覧