本番環境における行レベルのセキュリティ
ユースケースの 95% をカバーする 3 つの RLS パターン: 所有権、マルチテナント、階層組織。 pg_prove とデバッグ テストを使用します。
RLSとは#
行レベルのセキュリティは、現在のロールと JWT クレームに依存する可能性のある SQL 式を評価することによって、返された (または受け入れられた) 行をその場でフィルター処理するネイティブの PostgreSQL 機能です。 Aurabase は、 request.jwt.claims 経由でユーザー クレームを挿入し、ヘルパー auth.uid()、 auth.role()、 auth.tenant()、 auth.has_role()を公開します。
- ロール名。 正規のデータベース ロールは、
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を介して各行が固有のユーザーに属するプロフィール、メモ、投稿。
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 を返すため、ポリシーは拒否します)。
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()を組み合わせます。
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 を追加します)。そのため、答えはアプリで表示されるものとまったく同じです。
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 にいることを意味します