프로덕션의 행 수준 보안
사용 사례의 95%를 다루는 세 가지 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)을 통해 생성된 테이블은 해당 후크를 통과하지 않으므로 no 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와 결합하여 하나의 정책에서 SELECT/UPDATE/DELETE를 처리합니다. INSERT는 with check만 사용합니다.
다중 테넌트 — 조직별 범위#
사용 사례: 각 사용자가 조직에 속하고 해당 조직의 모든 데이터를 보는 B2B SaaS입니다. JWT는 auth.tenant() 도우미가 반환하는 app_metadata.tenant을 전달합니다(UUID가 없거나 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 — 정책당 하나의 어설션#
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')"
# Bob은 Alice의 게시물을 볼 수 없습니다.
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이 있어야 합니다. - 클레임이 삽입되지 않음: from Postgres,
select current_setting('request.jwt.claims', true)— null은 게이트웨이를 통하지 않고 직접 DB에 있음을 의미합니다.