跳到内容
光环标志
光环基地

安全与角色控制

行级安全本机 Postgres、预定义角色、多租户 RBAC、审核日志。您的规则存在于数据库中——可测试、版本化、无法在客户端规避。

说明9分钟 读取级别 先进的修改于 2026年4月15日

该页面已自动翻译。英文版具有权威性。

基地内有保安人员#

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.*() 的保单均使用这些声明。

fluxtext
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 发出的请求
authenticatedauth.uid() 是用户来自任何 Aurabase 会话且具有有效 JWT的登录用户
service_role绕过 RLS通过每个策略的后端密钥。仅限服务器。

五个基本模式#

策略附加到表 + 操作 (SELECT/INSERT/UPDATE/DELETE) + 角色。同一对上的多个策略在 OR 中组合。使用 using 过滤现有行,使用 with check 验证新值。

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);
提示

使用 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)混淆:这些都不会授予应用程序角色。

policies/admin.sqlsql
-- 管理员看到一切
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。

为了走得更远#