본문으로 건너뛰기
아우라베이스 로고
아우라베이스

프로덕션의 행 수준 보안

사용 사례의 95%를 다루는 세 가지 RLS 패턴: 소유권, 다중 테넌트, 계층적 조직. pg_prove 및 디버그 테스트를 사용합니다.

방법 가이드12분 읽기레벨 고급2026. 4. 15.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

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을 통해 고유한 사용자에게 속하는 프로필, 메모, 게시물.

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

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이므로 정책이 거부됩니다).

migrations/tenant_rls.sqlsql
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()을 결합합니다.

migrations/org_rls.sqlsql
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 추가) 앱에 표시되는 답변은 정확히 다음과 같습니다.

tests/rls.shbash
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에 있음을 의미합니다.

더 나아가려면#