セキュリティとRBAC
行レベルのセキュリティ ネイティブ Postgres、事前定義されたロール、マルチテナント RBAC、監査ログ。ルールはデータベース内に存在します。テスト可能でバージョン管理されており、クライアント側で回避することは不可能です。
セキュリティは基地内にあります#
Aurabase は、 PostgreSQLのネイティブの行レベル セキュリティ (RLS) を使用します。これは、アクセス ルールが SQL で記述され、データベースに保存され、SDK、 PostgREST、または直接 psql によって作成されたリクエストを含む各リクエストに適用されることを意味します。
MongoDB プロジェクトには、 RLSはありません。 分離は予約フィールド _owner_idによって保証されます。非特権ロールの読み取りは JWTの sub でフィルターされ、書き込みはこのフィールドにスタンプされます。空のリストをデバッグする前に注意すべき 3 つの結果: service_role キーで作成されたドキュメントには があり、 _owner_id がないため、すべての認証されたユーザーには見えなくなります (HTTP 200 で[] 応答、エラーなし)。 JWT のない anon 呼び出し元は、非パブリック コレクションの 403 を受け取ります。および _owner_idは予約されており、クライアントは決して変更できません。コレクションは、明示的なオプトイン public_readによって、すべてに読み取れるように開かれます。
クライアント側ではポリシーを回避することは不可能です。ゲートウェイは、適切なロールで Postgres 接続を開く前に、各 JWT を検証します。クレーム (auth.uid()、 auth.role()、 auth.tenant()) は request.jwt.claims 経由で挿入されます。SQL クエリからは変更できません。
Aurabase (Studio、テーブル API、移行、または /raw) を通じて作成されたテーブルは、(DDL で明示的に無効にされていない限り) デフォルトで自動的に ENABLE および FORCE ROW LEVEL SECURITY を取得します。ポリシーを追加する前に、alter table ... enable row level security との直接 psql 接続を介して作成されたテーブルの RLS を必ず確認してください。
JWT → クレーム → ポリシー → ライン#
各クエリは同じパスをたどります。ゲートウェイは JWTをデコードし、その署名を検証し (デフォルトではES256 はプロジェクト派生シークレットを使用します。 RS256 は RSA キーが構成されている場合のみ JWKS を使用します)、クレームを抽出し、 SET LOCAL role + SET LOCAL request.jwt.claimsとの Postgres 接続を開きます。 auth.*() を参照するすべてのポリシーは、これらのクレームを使用します。
Client → Gateway verify JWT (ES256 via JWKS, project key)
↓ extract { sub, role, tenant, exp }
Postgres SET LOCAL role = authenticated
SET LOCAL request.jwt.claims = {...}
↓
SELECT ... FROM posts WHERE ...
↓ (RLS injecte la policy USING)
SELECT ... FROM posts WHERE author_id = auth.uid()
3 つの Postgres ロール、明確な階層#
| 役割 | クレーム | 説明 |
|---|---|---|
anon | いいえ user_id | anon キーを使用して署名済みユーザー JWT を使用して行われたリクエスト |
authenticated | auth.uid() はユーザーです | 任意の Aurabase セッションからの、有効な JWTを持つサインイン ユーザー |
service_role | RLS をバイパスします | すべてのポリシーを渡すバックエンド キー。サーバーのみ。 |
必須の5つのパターン#
ポリシーは、テーブル + 操作 (SELECT/INSERT/UPDATE/DELETE) + ロールにアタッチされます。同じペア上の複数のポリシーは OR で結合されます。既存の行をフィルターするには using を使用し、新しい値を検証するには with check を使用します。
alter table posts enable row level security;
-- 読み方:著者のみ
create policy "posts_own_read"
on posts for select
to aura_authenticated
using (auth.uid() = author_id);
pg_proveを使用してポリシーをテストします。テーブルごとに 1 つの rls_posts.sql ファイルがあり、移行ごとに CI で実行されます。 RLS ガイドを参照してください。
アノン/認証を超えて#
アプリケーション ロール (管理者、編集者、ビューア、請求など) は、ユーザーの app_metadataの roles 配列内に存在し、サーバーのみが書き込むことができます (service_role キーを備えた管理 API PUT /admin/users/{id}、またはアクセス トークン フック)。各ユーザーは N 個の役割を持つことができます。これらは app_metadata.rolesの下のトークン内を移動し、 auth.has_role('admin') はポリシー内でそれらを読み取ります。 user_metadata はロールを付与することはありません。ユーザーは自分でロールを編集できます。これらを、トークンの role クレーム (anon または authenticated: Postgres 層、 auth.role()によって読み取られる) やユーザーの role フィールド ( user や editorなど、Studio に表示される無料のラベル) と混同しないでください。どちらもアプリケーション ロールを付与しません。
-- 管理者はすべてを見ています
create policy "posts_admin_read"
on posts for select
to aura_authenticated
using (auth.has_role('admin'));
-- 請求では機密性の高い列が専用ビューで表示されます
create view posts_billing as
select id, author_id, revenue_cents from posts
where auth.has_role('billing');
完全なトレース、SIEM エクスポート#
各セキュリティ イベント (signin、signout、password_change、mfa_enroll、role_granted、service_role_access、failed_auth) は project_{uuid}_auth.auth_audit_logに記録されます。 Pro では 30 日間、Enterprise では 2 年間の保持。
Webhook または Kafka ストリーム経由で SIEM (Splunk、Datadog、Elastic) に自動エクスポートします。詳細なイベント スキーマについては、/docs/compliance を参照してください。