安全与角色控制
行级安全本机 Postgres、预定义角色、多租户 RBAC、审核日志。您的规则存在于数据库中——可测试、版本化、无法在客户端规避。
基地内有保安人员#
Aurabase 使用 PostgreSQL的本机 行级安全性 (RLS)。这意味着您的访问规则是用 SQL 编写的,存储在数据库中,应用于每个请求 - 包括由 SDK、 PostgREST或直接 psql 发出的请求。
在 MongoDB 项目中,没有 RLS。 隔离由保留字段 _owner_id确保:任何非特权角色的读取都会在 JWT的 sub 上进行过滤,并且任何写入都会标记此字段。在调试空列表之前需要注意的三个后果: 使用 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)创建的表自动获取 ENABLE 和 FORCE ROW LEVEL SECURITY (除非在 DDL 中明确禁用)。在添加策略之前,请务必在通过 psql 直接连接与 alter table ... enable row level security 创建的表上验证 RLS。
JWT → 索赔 → 保单 → 行#
每个查询都遵循相同的路径。网关解码 JWT,验证其签名(默认情况下ES256 使用项目派生的密钥;仅在配置 RSA 密钥时使用 JWKS 的 RS256 ),提取声明,打开与 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()
三个Postgres角色,层次清晰#
| 角色 | 索赔 | 描述 |
|---|---|---|
anon | 没有 user_id | 使用匿名密钥且无签名用户 JWT 发出的请求 |
authenticated | auth.uid() 是用户 | 来自任何 Aurabase 会话且具有有效 JWT的登录用户 |
service_role | 绕过 RLS | 通过每个策略的后端密钥。仅限服务器。 |
五个基本模式#
策略附加到表 + 操作 (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测试您的策略。每个表一个 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 字段(Studio 中显示的免费标签,例如 user 或 editor)混淆:这些都不会授予应用程序角色。
-- 管理员看到一切
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 导出#
每个安全事件都记录在 project_{uuid}_auth.auth_audit_log中:登录、注销、password_change、mfa_enroll、role_granted、service_role_access、failed_auth。专业版保留 30 天,企业版保留 2 年。
通过 webhook 或 Kafka 流自动导出到您的 SIEM(Splunk、Datadog、Elastic)。有关详细的事件模式,请参阅 /docs/compliance。