보안 및 RBAC
행 수준 보안 네이티브 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에서 명시적으로 비활성화하지 않는 한). 정책을 추가하기 전에 항상 alter table ... enable row level security와의 직접 psql 연결을 통해 생성된 테이블에서 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로 정책을 테스트하세요. 각 마이그레이션의 CI에서 실행되는 테이블당 하나의 rls_posts.sql 파일입니다. RLS 가이드를 참조하세요.
향후/인증됨#
애플리케이션 역할(관리자, 편집자, 뷰어, 청구 등)은 사용자 app_metadata의 roles 배열에 있으며, 이는 서버(service_role 키 또는 액세스 토큰 후크가 있는 관리 API PUT /admin/users/{id})만 쓸 수 있습니다. 각 사용자는 N개의 역할을 가질 수 있습니다. app_metadata.roles아래의 토큰으로 이동하고 auth.has_role('admin')는 정책에서 이를 읽습니다. user_metadata는 역할을 부여하지 않습니다. 사용자가 직접 편집할 수 있습니다. 토큰의 role 클레임(anon 또는 authenticated: auth.role()에서 읽은 Postgres 계층)이나 사용자의 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 내보내기#
각 보안 이벤트는 project_{uuid}_auth.auth_audit_log(signin, signout,password_change, mfa_enroll, role_granted, service_role_access, failed_auth)에 기록됩니다. Pro에서는 30일 보존, Enterprise에서는 2년.
웹훅 또는 Kafka 스트림을 통해 SIEM(Splunk, Datadog, Elastic)으로 자동 내보내기. 자세한 이벤트 스키마는 /docs/compliance를 참조하세요.