PostgreSQL 의 RLS(Row-Level Security)는 같은 테이블에서도 역할마다 보이는 행을 다르게 합니다. Role × Table 권한 매트릭스 창은 스키마의 테이블마다 어느 역할에 어떤 권한이 있고 RLS 가 활성화되어 있는지를 한 표로 보여 줍니다. RLS 정책 시뮬레이터 창은 SQL 을 다른 역할로 실행해 정책이 실제로 어떤 행을 남기는지 확인하고, 끝나면 모든 변경을 되돌립니다. 두 창 모두 PostgreSQL 커넥션(Supabase 포함)에서만 사용할 수 있습니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | Schema: | 권한을 볼 스키마입니다. 우클릭한 스키마가 속한 데이터베이스의 스키마만 선택할 수 있고, 표도 그 데이터베이스에서 읽습니다. 변경하면 표를 다시 읽습니다. |
| 2 | RLS 적용 테이블만 스위치와 검색 칸 | RLS 가 활성화된 테이블만 남기거나 테이블 이름으로 거릅니다. 오른쪽에 남은 테이블 수와 역할 수가 나옵니다. |
| 3 | Table 열 | 테이블 이름입니다. 보라색 방패는 RLS 가 활성화된 테이블(마우스를 올리면 정책 수), 주황색 방패는 소유자에게도 RLS 를 적용(FORCE)하는 테이블입니다. |
| 4 | 역할 머리글 | 열마다 역할 하나입니다. 경고색 방패는 RLS 를 무시하는 BYPASSRLS 역할, 사람 묶음 표시는 로그인할 수 없는 그룹 역할입니다. |
| 5 | 권한 표시 | 역할이 테이블에 받은 권한입니다. S SELECT, I INSERT, U UPDATE, D DELETE, T TRUNCATE, R REFERENCES, G TRIGGER 이고, 권한이 없으면 — 입니다. BYPASSRLS 역할이 RLS 가 활성화된 테이블을 보면 앞에 ⛨ 가 붙습니다. |
| 6 | 범례: | 권한 글자의 뜻입니다. |
역할별 권한 보기
- 객체 탐색기에서 PostgreSQL 커넥션의 스키마를 우클릭하고 메뉴를 선택합니다. 우클릭한 스키마의 Role × Table 권한 매트릭스 창이 열립니다.
- RLS 가 걸린 테이블만 보려면 RLS 적용 테이블만 스위치(2)를 활성화합니다.
- 역할 열(4)을 따라 내려가며, 권한이 있는데 RLS 가 비활성화된 테이블이나
BYPASSRLS역할이 접근할 수 있는 테이블을 확인합니다.
- 모든 역할에 준 권한(
PUBLIC)은 각 역할의 칸에 합쳐서 보여 줍니다. - 권한이 있어도 RLS 가 활성화된 테이블은 정책에 맞는 행만 보입니다. 어떤 행이 보이는지는 시뮬레이터로 확인합니다.
RLS 시뮬레이터로 정책 확인하기
- 시뮬레이터를 엽니다. 여는 곳은 아래 '시뮬레이터를 여는 곳' 에 있습니다. 탐색기에서 열면 SQL 칸에 테이블의
SELECT * FROM 스키마.테이블;이 들어 있습니다. - Role 칸(1)에서 테스트할 역할을 선택합니다.
- 정책이
current_setting()으로 읽는 값이 있으면 Session GUCs (SET LOCAL) 칸(2)에 키와 값을 넣습니다. Supabase 커넥션이면 Session GUCs (SET LOCAL) 칸 대신 JWT Claims 빌더가 나옵니다(아래 'Supabase 에서'). - SQL 칸(3)에 확인할 문장 하나를 적습니다.
INSERT,UPDATE,DELETE도 지원합니다. - 행 수 차이를 보려면 다른 role 과 비교 스위치(4)를 활성화하고 비교할 역할(보통
BYPASSRLS역할)을 선택합니다. - 실행 버튼(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 를 우클릭 › | 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시간 뒤로 정합니다 |
| 사용자 정의 claims | app_metadata 같은 다른 클레임을 더합니다. 값이 JSON 으로 읽히면 숫자, 객체, 배열로 넣고, 아니면 문자열로 넣습니다 |
request.jwt.claims 미리보기 | 실제로 넣을 JSON 입니다 |
app.tenant_id 처럼 JWT 밖의 값을 읽는 정책은 빌더 아래의 Session GUCs (advanced) 칸에 넣습니다.
주의할 점
- 시뮬레이터는 변경을 되돌리지만, 트랜잭션으로 되돌아가지 않는 일은 남습니다. 예를 들어
INSERT로 입력된 시퀀스 값은 되돌아가지 않습니다. - 시뮬레이터는 결과를 최대 1,000 행까지 보여 주고, 한 번 실행에 30 초를 넘기면 멈춥니다.
- 선택한 역할로 변경할 수 있어야 합니다. 접속 계정이 선택한 역할의 멤버가 아니면 실행이 실패합니다. 역할 목록이 비어 있으면 접속 계정이 역할 목록을 읽을 권한이 없는 것입니다.
- 매트릭스는 PostgreSQL 의
information_schema에서 권한을 읽습니다. 그래서 접속 계정과 관계없는 역할 사이의 권한은 나오지 않을 수 있고, 역할 멤버십으로 물려받은 권한은 합쳐 보여 주지 않습니다. 정확한 결과는 시뮬레이터로 확인하세요. - 탐색기의 메뉴는 테이블의 RLS 상태를 읽은 뒤에만 보입니다. 보이지 않으면 탐색기에서 스키마를 새로고침하세요.
관련 화면
- 테이블 탭: RLS 정책 표와 RLS 활성화하기, 비활성화하기가 있는 화면입니다.
- 테이블 상세 패널: ERD 에서 RLS 정책을 보고 시뮬레이터를 엽니다.
- SQL 편집기: 도구 모음에서 시뮬레이터를 엽니다.
- 커넥션 만들기와 수정: Supabase 모드를 활성화하고 비활성화합니다.