화면: 연결과 탐색기

RLS 권한 매트릭스와 시뮬레이터

PostgreSQL 의 RLS(Row-Level Security)는 같은 테이블에서도 역할마다 보이는 행을 다르게 합니다. Role × Table 권한 매트릭스 창은 스키마의 테이블마다 어느 역할에 어떤 권한이 있고 RLS 가 활성화되어 있는지를 한 표로 보여 줍니다. RLS 정책 시뮬레이터 창은 SQL 을 다른 역할로 실행해 정책이 실제로 어떤 행을 남기는지 확인하고, 끝나면 모든 변경을 되돌립니다. 두 창 모두 PostgreSQL 커넥션(Supabase 포함)에서만 사용할 수 있습니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

화면 구성

번호이름설명
1Schema:권한을 볼 스키마입니다. 우클릭한 스키마가 속한 데이터베이스의 스키마만 선택할 수 있고, 표도 그 데이터베이스에서 읽습니다. 변경하면 표를 다시 읽습니다.
2RLS 적용 테이블만 스위치와 검색 칸RLS 가 활성화된 테이블만 남기거나 테이블 이름으로 거릅니다. 오른쪽에 남은 테이블 수와 역할 수가 나옵니다.
3Table 열테이블 이름입니다. 보라색 방패는 RLS 가 활성화된 테이블(마우스를 올리면 정책 수), 주황색 방패는 소유자에게도 RLS 를 적용(FORCE)하는 테이블입니다.
4역할 머리글열마다 역할 하나입니다. 경고색 방패는 RLS 를 무시하는 BYPASSRLS 역할, 사람 묶음 표시는 로그인할 수 없는 그룹 역할입니다.
5권한 표시역할이 테이블에 받은 권한입니다. S SELECT, I INSERT, U UPDATE, D DELETE, T TRUNCATE, R REFERENCES, G TRIGGER 이고, 권한이 없으면 — 입니다. BYPASSRLS 역할이 RLS 가 활성화된 테이블을 보면 앞에 ⛨ 가 붙습니다.
6범례:권한 글자의 뜻입니다.

역할별 권한 보기

  1. 객체 탐색기에서 PostgreSQL 커넥션의 스키마를 우클릭하고 탐색기 우클릭역할별 권한... 메뉴를 선택합니다. 우클릭한 스키마의 Role × Table 권한 매트릭스 창이 열립니다.
  2. RLS 가 걸린 테이블만 보려면 RLS 적용 테이블만 스위치(2)를 활성화합니다.
  3. 역할 열(4)을 따라 내려가며, 권한이 있는데 RLS 가 비활성화된 테이블이나 BYPASSRLS 역할이 접근할 수 있는 테이블을 확인합니다.
  • 모든 역할에 준 권한(PUBLIC)은 각 역할의 칸에 합쳐서 보여 줍니다.
  • 권한이 있어도 RLS 가 활성화된 테이블은 정책에 맞는 행만 보입니다. 어떤 행이 보이는지는 시뮬레이터로 확인합니다.

RLS 시뮬레이터로 정책 확인하기

  1. 시뮬레이터를 엽니다. 여는 곳은 아래 '시뮬레이터를 여는 곳' 에 있습니다. 탐색기에서 열면 SQL 칸에 테이블의 SELECT * FROM 스키마.테이블; 이 들어 있습니다.
  2. Role 칸(1)에서 테스트할 역할을 선택합니다.
  3. 정책이 current_setting() 으로 읽는 값이 있으면 Session GUCs (SET LOCAL) 칸(2)에 키와 값을 넣습니다. Supabase 커넥션이면 Session GUCs (SET LOCAL) 칸 대신 JWT Claims 빌더가 나옵니다(아래 'Supabase 에서').
  4. SQL 칸(3)에 확인할 문장 하나를 적습니다. INSERT, UPDATE, DELETE 도 지원합니다.
  5. 행 수 차이를 보려면 다른 role 과 비교 스위치(4)를 활성화하고 비교할 역할(보통 BYPASSRLS 역할)을 선택합니다.
  6. 실행 버튼(5)을 클릭합니다. 결과(6)에 행과 행 수, 실행 시간이 나오고, 비교를 활성화했으면 RLS 가 가린 행 수가 함께 나옵니다.

시뮬레이터는 SQL 을 이렇게 감싸 실행하고, 끝나면 언제나 되돌립니다. 모든 변경 ROLLBACK (강제) 표시는 비활성화할 수 없습니다.

BEGIN;
  SET LOCAL ROLE "고른 역할";
  SELECT set_config('키', '값', true);   -- 넣은 값마다
  -- 적은 SQL
ROLLBACK;
시뮬레이터가 차단하는 문장이유
BEGIN, COMMIT, ROLLBACK, SAVEPOINT시뮬레이터가 트랜잭션을 직접 열고 되돌립니다
LOCAL 이 없는 SET세션에 값이 남지 않도록 SET LOCAL 만 사용합니다
여러 문장한 번에 한 문장만 실행합니다
CREATE INDEX CONCURRENTLY트랜잭션 안에서 실행할 수 없습니다

시뮬레이터를 여는 곳

여는 곳보일 때
탐색기에서 테이블이나 View 를 우클릭 › 탐색기 우클릭Test with RLS...RLS 가 활성화된 PostgreSQL 테이블
SQL 편집기 도구 모음의 Test with RLS... 버튼지금 커넥션의 스키마에 RLS 가 활성화된 테이블이 있을 때. 편집기의 지금 SQL 이 들어갑니다
테이블 탭과 ERD 테이블 상세 패널의 RLS Policies 표에서 정책마다 있는 시뮬레이션... 버튼RLS 정책이 있는 PostgreSQL 테이블

Supabase 에서

커넥션이 Supabase 로 확인되면(커넥션 창의 Supabase 모드 항목. supabase.co 주소는 자동으로 감지합니다) 두 창이 Supabase 에 맞게 변경됩니다.

  • 매트릭스는 anon, authenticated, service_role 역할을 앞에 두고 머리글에 뜻을 붙입니다. service_role 은 RLS 를 무시하므로 경고 방패가 붙습니다.
  • 시뮬레이터의 역할 목록은 Supabase preset 묶음과 All roles 묶음으로 나뉩니다.
  • 시뮬레이터의 값 칸이 JWT Claims 빌더로 변경됩니다. 정책의 auth.uid(), auth.role(), auth.jwt() 가 읽는 값을 request.jwt.claims 하나로 넣습니다.
JWT Claims 빌더하는 일
preset 생성 목록anon (sub 없음), 임의 authenticated, service_role (bypass) 가운데 하나로 클레임을 채웁니다
sub, role, email, aud, exp, iss 칸자주 사용하는 클레임입니다. role 은 위의 Role 칸과 서로 따라 변경됩니다. exp 옆의 exp 1시간 연장 버튼은 만료를 지금부터 1시간 뒤로 정합니다
사용자 정의 claimsapp_metadata 같은 다른 클레임을 더합니다. 값이 JSON 으로 읽히면 숫자, 객체, 배열로 넣고, 아니면 문자열로 넣습니다
request.jwt.claims 미리보기실제로 넣을 JSON 입니다

app.tenant_id 처럼 JWT 밖의 값을 읽는 정책은 빌더 아래의 Session GUCs (advanced) 칸에 넣습니다.

주의할 점

  • 시뮬레이터는 변경을 되돌리지만, 트랜잭션으로 되돌아가지 않는 일은 남습니다. 예를 들어 INSERT 로 입력된 시퀀스 값은 되돌아가지 않습니다.
  • 시뮬레이터는 결과를 최대 1,000 행까지 보여 주고, 한 번 실행에 30 초를 넘기면 멈춥니다.
  • 선택한 역할로 변경할 수 있어야 합니다. 접속 계정이 선택한 역할의 멤버가 아니면 실행이 실패합니다. 역할 목록이 비어 있으면 접속 계정이 역할 목록을 읽을 권한이 없는 것입니다.
  • 매트릭스는 PostgreSQL 의 information_schema 에서 권한을 읽습니다. 그래서 접속 계정과 관계없는 역할 사이의 권한은 나오지 않을 수 있고, 역할 멤버십으로 물려받은 권한은 합쳐 보여 주지 않습니다. 정확한 결과는 시뮬레이터로 확인하세요.
  • 탐색기의 탐색기 우클릭Test with RLS... 메뉴는 테이블의 RLS 상태를 읽은 뒤에만 보입니다. 보이지 않으면 탐색기에서 스키마를 새로고침하세요.

관련 화면