コンテンツへスキップ
オーラベースのロゴ
オーラベース

本番環境における行レベルのセキュリティ

ユースケースの 95% をカバーする 3 つの RLS パターン: 所有権、マルチテナント、階層組織。 pg_prove とデバッグ テストを使用します。

ハウツーガイド12 分 読み取りレベル 高度な2026/04/15 に改訂

このページは自動翻訳されました。英語版が正式です。

RLSとは#

行レベルのセキュリティは、現在のロールと JWT クレームに依存する可能性のある SQL 式を評価することによって、返された (または受け入れられた) 行をその場でフィルター処理するネイティブの PostgreSQL 機能です。 Aurabase は、 request.jwt.claims 経由でユーザー クレームを挿入し、ヘルパー auth.uid()、 auth.role()、 auth.tenant()、 auth.has_role()を公開します。

ポリシーを作成する前に知っておくべき 3 つのこと
  • ロール名。 正規のデータベース ロールは、 aura_anon、 aura_authenticated 、および aura_service_roleです。管理対象クラスターでは、グループ エイリアス anon、 authenticated、および service_role もそれらにマップされます ( BYPASSRLS は厳密に aura_service_role のみにとどまることに注意してください)。
  • RLS は、 Aurabaseを通じて作成されたテーブルに対してデフォルトでオンになっています。 /raw、移行、Studio、またはテーブル API で作成されたテーブルは、自動的に ENABLE および FORCE ROW LEVEL SECURITY を受け取ります (DISABLE ROW LEVEL SECURITY が同じ DDL バッチで明示的に実行されない限り)。ポリシーを追加するまで、パブリック/アノン クエリは [] を返します。直接 PostgreSQL 接続 (psql、 Prisma、Drizzle) を介して作成されたテーブルはそのフックを通過しないため、 、 RLS が取得され、代わりに が公開キーにアクセスできません: aura_anon および aura_authenticated はそれらに対する権限を保持しません。あなたがそれを許可するまで。このようなテーブルを SDK に公開するには、まず RLS を有効にしてから、ポリシー ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY ...を付与して追加します。 RLS がオフになっているテーブルの aura_anon または aura_authenticated には決して許可しないでください。公開キーのすべての所有者、またはサインアップしたすべてのユーザーが、そのすべての行を読み取ります (書き込み許可があれば変更します)。
  • 公開キーにはユーザーがありません。 auth.uid() は、公開キーおよび service_role キーの NULL です。サインインしているユーザーの ID のみを返します。 to aura_authenticated を使用して、ポリシーをサインインしているユーザーに制限します。

所有権 - 各ユーザーが独自の回線を所有#

ユースケース: user_id または author_idを介して各行が固有のユーザーに属するプロフィール、メモ、投稿。

migrations/posts_rls.sqlsql
alter table posts enable row level security;

create policy "posts_own_read" on posts
  for select to aura_authenticated
  using (auth.uid() = author_id);

create policy "posts_own_write" on posts
  for all to aura_authenticated
  using (auth.uid() = author_id)
  with check (auth.uid() = author_id);
ヒント

for all と using + with check を組み合わせて、1 つのポリシーで SELECT/UPDATE/DELETE をカバーします。 INSERT では with checkのみが使用されます。

マルチテナント — 組織ごとの範囲#

ユースケース: 各ユーザーが組織に属し、組織のすべてのデータを参照する B2B SaaS。 JWT は app_metadata.tenantを伝えます。 auth.tenant() ヘルパーはこれを返します (存在しない場合、または UUID ではない場合はNULL を返すため、ポリシーは拒否します)。

migrations/tenant_rls.sqlsql
create policy "orders_tenant_scope" on orders
  for all to aura_authenticated
  using (tenant_id = auth.tenant())
  with check (tenant_id = auth.tenant());

-- パフォーマンスに欠かせない指標
create index idx_orders_tenant on orders(tenant_id);

階層型組織 — ロール別の権限#

ユースケース: 組織内のロール (管理者、メンバー、閲覧者) が異なる権限を持つ SaaS。 auth.tenant() と auth.has_role()を組み合わせます。

migrations/org_rls.sqlsql
create policy "invoices_read" on invoices
  for select to aura_authenticated
  using (
    tenant_id = auth.tenant()
    and (auth.has_role('admin') or auth.has_role('billing'))
  );

create policy "invoices_write" on invoices
  for all to aura_authenticated
  using (tenant_id = auth.tenant() and auth.has_role('admin'))
  with check (tenant_id = auth.tenant());

pg_prove — ポリシーごとに 1 つのアサーション#

CI で実際のユーザーとしてポリシーをテストします

ポリシーはコードなのでテストしてください。 aura db raw ... --as authenticated --user <uuid> は、そのユーザーに設定された auth.uid() および auth.role() を使用して PostgreSQL 内で SQL を実行します (ロール ライトバックするには --dry-run を追加します)。そのため、答えはアプリで表示されるものとまったく同じです。

tests/rls.shbash
set -euo pipefail
ALICE=$(aura auth users create --email alice@example.com --password 'Passw0rd!long1' --json | jq -r .id)
BOB=$(aura auth users create --email bob@example.com --password 'Passw0rd!long1' --json | jq -r .id)

aura db raw "insert into posts(author_id, title) values ('$ALICE', 'hello')"
# ボブはアリスの投稿を見てはならない
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# アリスは必見です
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# 訪問者には何も見えない
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"

aura db pushの後に CI で実行します。 Studio の RLS シミュレーター (データベース › テーブル › RLS シミュレーター) は、ロールバックされた PostgreSQL トランザクション内で同じチェックを実行し、結果の横にその旨を表示します。 pgTAP および pg_prove には直接 PostgreSQL 接続が必要ですが、すべての展開で公開されるわけではありません。

ポリシーが希望どおりに動作しない場合#

  • 結果が空ですか? RLS があり、一致する SELECT ポリシーがないテーブルを匿名またはサインインして読み取ると、追加するロールとポリシーを指定する meta.hint を含む [] が返されます。 aura db raw "select * from posts" --as anon は、訪問者に表示される内容を示します。
  • RLS は無効ですか? aura db table list はテーブルに [RLS]をマークし、 Advisor は RLS が無効になっているテーブル、および RLS が設定されているがポリシーがないテーブルについて警告します。 RLS をオフ (aura db table rls posts off) にすると、公開キーを保持している誰でもテーブルを読み取れるようになります。
  • ビュー。 ビューはリーダーの権限で読み取りを行うため (security_invoker = true は作成するすべてのビューに適用されます)、そのテーブルのポリシーが適用されます。
  • 合計するポリシー: 同じテーブル上の複数のポリシー + 操作 + ロールが OR で結合されます。必要に応じて単一ポリシー内で AND を使用して制限する
  • GRANT 権限がありません: ポリシーがある場合でも、ロールには grant select on posts to aura_authenticated が必要です
  • クレームは挿入されません: Postgres、 select current_setting('request.jwt.claims', true) から — null は、ゲートウェイ経由ではなく直接 DB にいることを意味します

さらに進むには#