Copy & Run

PostgreSQL 행 수준 보안(RLS) 실습: 기본 거부, FORCE

한 표를 여러 사용자가 나눠 쓸 때 남의 행을 읽고 고치지 못하게 하는 RLS를 PostgreSQL 16 컨테이너에서 단계별로 확인합니다. 정책이 없을 때 모두 보이는 문제, 켜기만 하면 0행이 되는 기본 거부, 표 소유자와 슈퍼유저의 우회, FORCE로 소유자까지 묶는 방법을 같은 질의로 비교하고 합격 판정을 종료 코드로 냅니다.

실습 노트 · 2026-10-30 발행 · 10분 · 2026-10 확인
실습 코드 내려받기: 전체 받기(zip)GitHubrls_demo.sh

여러 사용자나 고객사의 자료를 표 하나에 담는 서비스는 "내 행만 보인다"를 앱 코드의 WHERE owner = ?에 맡기는 경우가 많습니다. 조건 하나를 빠뜨린 질의, 관리 화면의 임시 조회, 다른 서비스가 같은 데이터베이스에 붙는 상황에서는 이 방식이 쉽게 깨집니다. PostgreSQL의 행 수준 보안(Row Level Security, RLS)은 이 규칙을 데이터베이스가 직접 강제합니다. 이 글은 PostgreSQL 16 컨테이너에서 같은 질의를 RLS 없음, 켜기만 함, 정책 붙임, FORCE의 네 상태로 돌려 결과를 비교하고, "내 행만 보이고 남의 행은 쓸 수 없다"를 합격 기준으로 만들어 종료 코드로 확인합니다.

준비물

항목 확인한 값
Docker 29.5.3 (Windows 11, Git Bash에서 실행)
PostgreSQL 16.15 (postgres:16 이미지)
역할 app_owner(표 소유자), alice, bob(일반 사용자), postgres(슈퍼유저)
표 docs(id, owner, title), 행 4개(alice 2개, bob 2개)

컨테이너 하나(osk-fb-pg)에 psql로 접속해 시험하고, 끝나면 컨테이너를 지웁니다. 비밀번호는 시험용으로 모두 lab입니다. 사용자별 결과는 -h 127.0.0.1로 비밀번호 인증을 거쳐 그 사용자로 접속해서 얻었습니다.

1. 합격 기준을 먼저 정하기

"RLS가 잘 걸렸다"를 눈으로 보지 않고 gate 함수 하나로 판정합니다. alice로 접속해서 다음 세 가지가 모두 맞아야 합격(종료 코드 0)입니다.

  1. 보이는 행 중 남의 행(owner <> 'alice')이 0개입니다.
  2. 남의 이름으로 INSERT하면 row-level security 오류로 거절됩니다.
  3. 남의 행을 UPDATE하면 UPDATE 0입니다.

쓰기 시험은 BEGIN; ... ROLLBACK; 안에서 해서 시험 자체가 자료를 바꾸지 않게 했습니다. 처음에는 -c "INSERT ..."로 바로 실행했다가 시험 중에 위조 행이 실제로 들어가 다음 단계의 숫자가 달라졌습니다. 실험 코드가 자료를 바꾸면 비교가 되지 않으므로 트랜잭션으로 감싼 것입니다.

2. RLS가 없는 표

표를 만들고 alice와 bob에게 SELECT, INSERT, UPDATE, DELETE를 줬을 뿐 RLS는 켜지 않았습니다.

  • alice가 SELECT count(*)를 하면 4행, 제목은 a-1,a-2,b-1,b-2로 bob의 행까지 모두 보입니다.
  • 남의 이름으로 INSERT는 거절되지 않았고(거절 0건), 남의 행 UPDATE는 UPDATE 2로 bob의 두 행이 바뀝니다.
  • 게이트는 종료 코드 1로 불합격입니다.

표 단위 권한(GRANT)은 "이 표를 읽을 수 있다"까지만 정하고 어느 행인지는 정하지 못하므로, 행을 나누려면 앱의 조건이나 RLS가 필요합니다.

이 단계의 파일 내려받기:rls_demo.sh

3. RLS만 켰을 때: 기본 거부

ALTER TABLE docs ENABLE ROW LEVEL SECURITY만 실행하면 정책이 하나도 없을 때 일반 사용자에게는 아무 행도 보이지 않습니다.

사용자 보이는 행
alice 0행
app_owner(표 소유자) 4행

정책이 없으면 거부하는 것이 기본값이라 안전한 쪽으로 실패합니다. 반면 표 소유자는 정책을 건너뛰어 여전히 4행이 보였습니다. pg_class에서 relrowsecurity는 t, relforcerowsecurity는 f였고, 이 값이 소유자가 우회하는 이유입니다. 슈퍼유저(postgres)도 정책을 건너뛴다는 것은 4단계에서 숫자로 확인했습니다.

이 단계의 파일 내려받기:rls_demo.sh

4. 정책 붙이기

CREATE POLICY own_rows ON docs FOR ALL TO alice, bob
  USING (owner = current_user) WITH CHECK (owner = current_user);
  • USING은 읽기와 수정, 삭제의 대상이 되는 행을 거릅니다.
  • WITH CHECK는 새로 들어가거나 바뀌는 행이 조건을 지키는지 봅니다. 이것이 없으면 bob의 이름으로 행을 만들어 넣는 쓰기를 막지 못합니다.
  • current_user는 접속한 데이터베이스 역할입니다. 앱이 모든 사용자를 하나의 계정으로 접속시키는 구조라면 current_setting('app.user_id') 같은 세션 변수를 쓰는 식으로 정책을 바꿔야 하며, 이 글에서는 해 보지 않았습니다.

정책을 붙인 뒤 결과입니다.

확인 결과
alice가 보는 행 2행(a-1,a-2)
bob이 보는 행 2행(b-1,b-2)
alice가 보는 남의 행 0
남의 이름으로 INSERT row-level security 오류로 거절
남의 행 UPDATE UPDATE 0
게이트 종료 코드 0(합격)

UPDATE가 오류가 아니라 UPDATE 0으로 끝나는 점에 주의합니다. 읽을 수 없는 행은 "없는 행"처럼 취급되므로 앱이 "수정 0건"을 성공으로 처리하면 실패를 놓칠 수 있습니다.

이 단계의 파일 내려받기:rls_demo.sh

5. 표 소유자와 FORCE

정책을 붙인 뒤에도 표 소유자 app_owner는 4행이 모두 보였습니다. 소유자에게도 정책을 적용하려면 ALTER TABLE docs FORCE ROW LEVEL SECURITY를 실행합니다.

사용자 FORCE 전 FORCE 후
app_owner(표 소유자) 4행 0행
postgres(슈퍼유저) 4행 4행

FORCE를 걸자 소유자의 4행이 0행이 되었습니다. 소유자 역할이 마이그레이션이나 배치 작업에 쓰이면 FORCE 때문에 그 작업이 행을 못 볼 수 있으므로 소유자용 정책을 따로 두거나 소유자와 앱 계정을 분리해야 합니다. 슈퍼유저는 FORCE에도 4행이 그대로였습니다. 슈퍼유저와 BYPASSRLS 속성을 가진 역할은 RLS의 적용 대상이 아니므로, 앱 접속 계정에는 이 권한을 주지 않는 것이 전제입니다. BYPASSRLS 역할은 이 글에서 만들어 보지 않았습니다.

\d+ docs로 정책이 표 정의에 어떻게 나오는지도 확인했습니다.

Policies (forced row security enabled):
    POLICY "own_rows"
      TO alice,bob
      USING ((owner = CURRENT_USER))
      WITH CHECK ((owner = CURRENT_USER))

rls_demo.sh 실행 결과에서 RLS가 없을 때 alice가 4행을 보고 게이트 1, 정책을 붙이면 2행과 게이트 0, FORCE 후 소유자가 0행, 슈퍼유저는 4행인 것과 정책 정의를 확인합니다.
rls_demo.sh 실행 결과에서 RLS가 없을 때 alice가 4행을 보고 게이트 1, 정책을 붙이면 2행과 게이트 0, FORCE 후 소유자가 0행, 슈퍼유저는 4행인 것과 정책 정의를 확인합니다.

3단계 이후만 다시 출력해서 정책 적용 뒤와 FORCE 뒤를 한 화면에서 비교했습니다.

정책 적용 뒤 alice 2행과 bob 2행, 게이트 종료 코드 0, 소유자 4행, FORCE 후 소유자 0행과 슈퍼유저 4행, 표 정의의 정책 요약을 확인합니다.
정책 적용 뒤 alice 2행과 bob 2행, 게이트 종료 코드 0, 소유자 4행, FORCE 후 소유자 0행과 슈퍼유저 4행, 표 정의의 정책 요약을 확인합니다.

이 단계의 파일 내려받기:rls_demo.sh

6. 운영에 옮길 때 확인할 것

  • 앱 접속 계정은 표 소유자가 아니어야 합니다. 소유자는 FORCE를 걸지 않으면 우회합니다.
  • 정책마다 WITH CHECK를 씁니다. USING만 있으면 읽기 쪽만 막힙니다. 이 글의 FOR ALL 정책은 두 가지를 함께 정했지만 FOR SELECT 정책만 썼을 때의 쓰기 동작은 해 보지 않았습니다.
  • 성능은 따로 봅니다. 정책 조건이 모든 질의에 붙으므로 owner 같은 열에 인덱스가 필요할 수 있습니다. 이 글은 행 4개짜리 표라 성능은 측정하지 않았습니다.
  • 합격 판정을 CI에 넣습니다. 스키마 변경으로 정책이 빠지면 게이트가 1을 내므로 마이그레이션 시험에 같은 gate를 붙일 수 있습니다.

전체 코드

실험 전체를 한 번에 돌리는 스크립트입니다. 같은 폴더에서 실행합니다.

# rls_demo.sh
#!/usr/bin/env bash
# PostgreSQL 행 수준 보안(RLS)을 끈 상태, 켠 상태, 정책을 붙인 상태로 나눠 같은 질의의 결과를 비교하고 합격/불합격 판정을 종료 코드로 낸다.
# 준비: Docker (postgres:16 이미지). 시험용 컨테이너라 비밀번호는 모두 lab 이다.
# 실행(Git Bash): bash rls_demo.sh   (약 40초)
export MSYS_NO_PATHCONV=1
N=osk-fb-pg
docker rm -f $N >/dev/null 2>&1
docker run -d --name $N -e POSTGRES_PASSWORD=lab postgres:16 >/dev/null
for i in $(seq 1 30); do docker exec $N pg_isready -U postgres >/dev/null 2>&1 && break; sleep 1; done
sleep 2
SU() { docker exec -i $N psql -U postgres -d lab -v ON_ERROR_STOP=0 -At "$@" 2>&1; }
AS() { local u=$1; shift; docker exec -i -e PGPASSWORD=lab $N psql -h 127.0.0.1 -U "$u" -d lab -At "$@" 2>&1; }
docker exec $N psql -U postgres -c 'CREATE DATABASE lab' >/dev/null

SU <<'SQL' >/dev/null
CREATE ROLE app_owner LOGIN PASSWORD 'lab';
CREATE ROLE alice LOGIN PASSWORD 'lab';
CREATE ROLE bob   LOGIN PASSWORD 'lab';
GRANT CREATE ON SCHEMA public TO app_owner;
SET ROLE app_owner;
CREATE TABLE docs (id serial PRIMARY KEY, owner text NOT NULL, title text NOT NULL);
GRANT SELECT, INSERT, UPDATE, DELETE ON docs TO alice, bob;
GRANT USAGE ON SEQUENCE docs_id_seq TO alice, bob;
INSERT INTO docs(owner,title) VALUES ('alice','a-1'),('alice','a-2'),('bob','b-1'),('bob','b-2');
SQL

# 판정: alice 가 자기 행만 보고, 남의 행을 쓰지 못하는지. 합격이면 0, 아니면 1
gate() {
  local seen others w1 w2
  seen=$(AS alice -c "SELECT count(*) FROM docs")
  others=$(AS alice -c "SELECT count(*) FROM docs WHERE owner <> 'alice'")
  # 쓰기 시험은 트랜잭션 안에서 하고 되돌려 자료를 바꾸지 않는다
  w1=$(echo "BEGIN; INSERT INTO docs(owner,title) VALUES ('bob','forged'); ROLLBACK;" | AS alice | grep -c 'row-level security')
  w2=$(echo "BEGIN; UPDATE docs SET title='x' WHERE owner='bob'; ROLLBACK;" | AS alice | grep '^UPDATE')
  echo "  alice 가 보는 행 $seen, 그중 남의 행 $others, 남의 이름으로 INSERT 거절 $w1, 남의 행 UPDATE 결과 '$w2'"
  [ "$others" = 0 ] && [ "$w1" = 1 ] && [ "$w2" = "UPDATE 0" ]
}
show() { echo "  $1 $(AS "$1" -c "SELECT count(*) FROM docs")행: $(AS "$1" -c "SELECT string_agg(title, ',' ORDER BY id) FROM docs")"; }

echo "## 1. RLS 를 켜지 않은 표(문제 있는 상태)"
show alice; show bob
gate; echo "  게이트 종료 코드 $?"

echo "## 2. RLS 만 켜고 정책이 없을 때(기본 거부)"
SU -c "ALTER TABLE docs ENABLE ROW LEVEL SECURITY" >/dev/null
show alice; show app_owner
echo "  표 소유자와 슈퍼유저는 정책을 건너뜁니다: $(SU -c "SELECT relrowsecurity, relforcerowsecurity FROM pg_class WHERE relname='docs'")"

echo "## 3. 정책을 붙인 뒤"
SU <<'SQL' >/dev/null
CREATE POLICY own_rows ON docs FOR ALL TO alice, bob
  USING (owner = current_user) WITH CHECK (owner = current_user);
SQL
show alice; show bob
gate; echo "  게이트 종료 코드 $?"
echo "  표 소유자 app_owner: $(AS app_owner -c "SELECT count(*) FROM docs")행(정책이 소유자에게는 적용되지 않음)"

echo "## 4. FORCE ROW LEVEL SECURITY 로 소유자도 정책 아래로"
SU -c "ALTER TABLE docs FORCE ROW LEVEL SECURITY" >/dev/null
echo "  표 소유자 app_owner: $(AS app_owner -c "SELECT count(*) FROM docs")행, 슈퍼유저 postgres: $(SU -c "SELECT count(*) FROM docs")행"
echo "  pg_policies: $(SU -c "SELECT policyname, cmd, roles FROM pg_policies WHERE tablename='docs'")"
echo "## 5. 표 정의에서 정책 확인(\d+)"
docker exec $N psql -U postgres -d lab -c '\d+ docs' | sed -n '/Policies/,/^Access/p'
echo "  서버 버전: $(SU -c 'SHOW server_version')"
docker rm -f $N >/dev/null 2>&1
echo "## 끝"
이 단계의 파일 내려받기:rls_demo.sh

자주 막히는 곳

증상 원인 해결
RLS를 켰는데 소유자 계정에서는 전부 보임 소유자는 정책을 우회함 FORCE ROW LEVEL SECURITY 또는 앱 계정과 소유자 분리
RLS를 켰더니 일반 사용자가 0행 정책이 없으면 기본 거부 CREATE POLICY 추가
시험이 끝났는데 다음 단계 숫자가 달라짐 시험용 INSERT와 UPDATE가 실제로 반영됨 BEGIN; ...; ROLLBACK;으로 감싸기
UPDATE 0을 성공으로 처리 정책에 걸린 행은 없는 것처럼 취급됨 영향받은 행 수를 확인하는 코드
슈퍼유저로 시험하면 항상 통과 슈퍼유저는 RLS를 건너뜀 일반 역할로 접속해서 시험

확인 범위

  • 해 본 것: 2026-10-30, Windows 11 · Docker 29.5.3 · PostgreSQL 16.15에서 RLS 없는 표(게이트 1), RLS만 켠 표(일반 사용자 0행, 소유자 4행), 정책을 붙인 표(alice 2행, bob 2행, 게이트 0), FORCE(소유자 0행, 슈퍼유저 4행), \d+의 정책 출력, pg_class의 relrowsecurity와 relforcerowsecurity를 확인했습니다. 전체 스크립트를 세 번 실행해 결과가 같았고, 끝에 컨테이너를 지웠습니다.
  • 해 보지 않은 것: BYPASSRLS 속성 역할, 세션 변수로 사용자를 구분하는 정책, FOR SELECT 등 명령별 정책의 조합, 여러 정책이 겹칠 때의 OR 결합, 뷰와 함수(SECURITY DEFINER)를 거친 우회, 인덱스와 성능, 다른 PostgreSQL 버전, Linux와 macOS.
  • 읽을 때 주의: 비밀번호 lab과 로컬 접속은 시험용입니다. 결과는 PostgreSQL 16.15 기준이며 표가 4행이라 정책의 성능 영향은 알 수 없습니다.

이 글의 다음 단계

  • NoSQL과 SQL 차이: 같은 상품 데이터를 두 방식으로 다뤄 보기같은 상품 데이터를 PostgreSQL 표와 MongoDB 컬렉션에 각각 넣고 같은 질문을 던집니다. 조건 검색 결과는 같지만, 새 필드를 추가할 때 PostgreSQL은 ALTER TABLE이 필요하고 MongoDB는 문서에 바로 넣을 수 있는 차이를 실행 결과로 확인합니다.
  • PostgreSQL pg_hba.conf 점검: trust를 SCRAM과 접속 제한으로 바꾸기pg_hba.conf가 trust로 열려 있는 PostgreSQL 16을 컨테이너로 띄우고, 다른 두 서버에서 같은 6가지 접속을 시도해 5칸이 어긋나는 것을 확인합니다. 규칙만 SCRAM으로 바꾸면 정상 앱까지 막히는 이유, 저장된 해시를 다시 만드는 순서, pg_hba_file_rules로 규칙을 교차 확인하는 방법과 종료 코드 게이트를 다룹니다.

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글