# PostgreSQL pg_hba.conf 점검: trust를 SCRAM과 접속 제한으로 바꾸기

> pg_hba.conf가 trust로 열려 있는 PostgreSQL 16을 컨테이너로 띄우고, 다른 두 서버에서 같은 6가지 접속을 시도해 5칸이 어긋나는 것을 확인합니다. 규칙만 SCRAM으로 바꾸면 정상 앱까지 막히는 이유, 저장된 해시를 다시 만드는 순서, pg_hba_file_rules로 규칙을 교차 확인하는 방법과 종료 코드 게이트를 다룹니다.

- 주소: https://copyandrun.com/blog/postgres-scram-pg-hba-test/
- 분야: DevSecOps
- 발행일: 2026-11-12
- 태그: PostgreSQL, pg_hba.conf, SCRAM, trust, 접속 제어

PostgreSQL에서 "누가 어디서 어떤 방식으로 들어오는가"는 `pg_hba.conf`가 정합니다. 앞의 [역할 최소 권한 글](/blog/postgres-roles-least-privilege/)과 [행 수준 보안 글](/blog/postgres-row-level-security/)은 일단 접속한 뒤의 권한을 다뤘습니다. 이 글은 그보다 앞 단계인 접속 자체를 다룹니다. 개발할 때 편하자고 `trust`(비밀번호 없이 통과)를 걸어 둔 설정이 그대로 남으면, 아무리 권한을 잘게 나눠도 같은 네트워크의 누구나 슈퍼유저로 들어올 수 있습니다. 일부러 `trust`로 열어 둔 PostgreSQL을 서로 다른 두 클라이언트 컨테이너에서 같은 6가지 방법으로 두드려 보고, 규칙을 고치는 순서와 그 중간에 생기는 함정, 마지막 확인 방법까지 실행해서 기록합니다.

## 준비물

| 항목 | 확인한 값 |
|---|---|
| Docker | 29.5.3 (Windows 11, Git Bash에서 실행) |
| PostgreSQL | 16.15 (`postgres:16` 이미지, Debian) |
| 네트워크 | 전용 네트워크 `osk-l1b-net`(`10.231.77.0/24`), 서버 `.2`, app 서버 `.10`, 다른 서버 `.20` |
| 클라이언트 | `postgres:16` 이미지의 `psql`을 쓰는 컨테이너 두 개 |
| 포트 | 바깥에 열지 않음. 컨테이너끼리만 접속 |

시험 비밀번호는 모두 시험용 값(`lab-pw`, `admin-pw`)이며 실제 환경에서 쓰지 않습니다.

## 1. 설정 두 개와 접속 6가지

`pg_hba.conf`는 위에서 아래로 읽다가 처음 맞는 줄에서 결정합니다. 두 파일의 차이는 아래와 같습니다.

![pg_hba_bad.conf는 host all all 0.0.0.0/0 trust 한 줄이고, pg_hba_good.conf는 10.231.77.10에서 lab 데이터베이스에 app 역할만 scram-sha-256으로 허용하고 나머지는 reject하는 것을 확인합니다.](https://copyandrun.com/img/postgres-scram-pg-hba-test/02-pg_hba-두-설정-파일.png)

| 파일 | 규칙 | 뜻 |
|---|---|---|
| `pg_hba_bad.conf` | `host all all 0.0.0.0/0 trust` | 어디서든, 누구든, 어느 데이터베이스든 비밀번호 없이 허용 |
| `pg_hba_good.conf` | `host lab app 10.231.77.10/32 scram-sha-256` | app 서버 한 곳에서, `app` 역할만, `lab`만, SCRAM 비밀번호로 허용 |
| `pg_hba_good.conf` | `host all all 0.0.0.0/0 reject` | 그 밖은 모두 거절 |

두 파일 모두 `local all all trust`가 있습니다. 컨테이너 안에서 관리하려고 남긴 것으로, 컨테이너에 들어올 수 있는 사람은 이미 관리 권한이 있다고 보고 이 글에서는 바꾸지 않았습니다. 시험은 모두 네트워크(`host`) 접속으로 합니다.

접속 시도 6가지와 기대값은 다음과 같습니다. `app 서버`는 `10.231.77.10`, `다른 서버`는 `10.231.77.20`입니다.

| # | 시도 | 기대 |
|---|---|---|
| 1 | app 서버에서 `app`, 맞는 비밀번호, `lab` | 허용 |
| 2 | app 서버에서 `app`, 틀린 비밀번호 | 거절 |
| 3 | app 서버에서 `postgres`(슈퍼유저), 비밀번호 없이 | 거절 |
| 4 | 다른 서버에서 `app`, 맞는 비밀번호 | 거절 |
| 5 | 다른 서버에서 `postgres`, 비밀번호 없이 | 거절 |
| 6 | app 서버에서 `app`, `postgres` 데이터베이스 | 거절 |

## 2. 세 단계로 바꾸며 같은 표를 돌리기

스크립트 `hba_demo.sh`는 컨테이너 세 개를 띄우고 설정을 세 번 바꿔 가며 같은 6가지를 시도해 기대와 어긋난 칸을 셉니다.

1. **느슨한 상태:** `trust`, 그리고 `app`의 비밀번호는 옛 방식인 `md5`로 저장
2. **규칙만 고침:** `pg_hba`는 SCRAM으로 바꾸고, `app`의 저장된 해시는 그대로
3. **저장 방식도 고침:** `password_encryption`을 `scram-sha-256`으로 바꾸고 `app`의 비밀번호를 다시 설정

![hba_demo.sh 실행 결과에서 1단계는 어긋난 칸 5/6, 2단계는 정상 앱의 로그인까지 막혀 1/6이고 서버 로그에 User app does not have a valid SCRAM secret이 보이며, 3단계는 0/6과 종료 코드 0인 것을 확인합니다.](https://copyandrun.com/img/postgres-scram-pg-hba-test/01-pg_hba-세-단계-접속-표.png)

| 단계 | 어긋난 칸 | 설명 |
|---|---|---|
| 1. 느슨한 상태 | 5 / 6 | 맞는 비밀번호(1번)만 기대와 같고, 나머지 5개는 모두 허용됨 |
| 2. 규칙만 고침 | 1 / 6 | 막을 것은 모두 막았지만 정상인 1번까지 거절됨 |
| 3. 저장 방식도 고침 | 0 / 6 | 6칸 모두 기대와 같음, 종료 코드 0 |

- **1단계에서 틀린 비밀번호가 통과했습니다.** `trust`는 비밀번호를 아예 묻지 않으므로 2번에서 보낸 `wrong`은 확인조차 되지 않았습니다. 다른 서버에서 `postgres`로 들어가는 5번도 그대로 통과했으므로 같은 네트워크에 있는 컨테이너 하나가 침해되면 데이터베이스 전체가 열린 것과 같았습니다.
- **`postgres` 데이터베이스로 가는 6번도 통과했습니다.** `app`이 쓰는 데이터베이스는 `lab` 하나인데도 규칙이 `all`이라 다른 데이터베이스에도 접속할 수 있었습니다.

## 3. 2단계: 규칙만 고치면 정상 앱이 막힙니다

<!-- files: hba_demo.sh -->

2단계에서 1번, 즉 맞는 비밀번호를 가진 `app`이 `password authentication failed`로 거절되었습니다. 클라이언트에 보이는 메시지는 2번(틀린 비밀번호)과 똑같아서, 이것만 보면 비밀번호를 잘못 넣은 것으로 읽힙니다. 이유는 서버 로그에 있었습니다.

```
DETAIL:  User "app" does not have a valid SCRAM secret.
```

`pg_hba`의 방식을 `scram-sha-256`으로 바꿔도 이미 저장된 해시는 옛 `md5` 형태(`md566e2778badd…`)입니다. SCRAM 인증은 SCRAM 형태의 저장값이 있어야 하므로, 새 규칙에서는 정상 비밀번호도 통과하지 못합니다. 그래서 순서는 다음과 같습니다.

1. `password_encryption`을 `scram-sha-256`으로 바꾸고 설정을 다시 읽게 합니다(`pg_reload_conf()`).
2. 역할마다 비밀번호를 다시 설정합니다(`ALTER ROLE app PASSWORD '…'`). 이때 새 방식으로 저장됩니다.
3. 그다음에 `pg_hba`를 SCRAM으로 바꿉니다.

이 글의 스크립트는 함정을 보여 주려고 일부러 `pg_hba` 변경(3번)을 먼저 했습니다. 실제 환경에서는 위 순서로 하고, 역할이 여럿이면 어느 역할이 아직 `md5`인지 먼저 조회해야 합니다.

```sql
SELECT rolname, left(rolpassword, 14) FROM pg_authid WHERE rolpassword IS NOT NULL;
```

3단계에서는 `app`의 해시가 `SCRAM-SHA-256$`로 시작하는 것을 확인했습니다. 비밀번호 해시는 슈퍼유저만 조회할 수 있고, 위 조회에서는 앞 14글자만 보았습니다.

## 4. 규칙을 파일이 아니라 서버 쪽에서 확인하기

설정 파일을 눈으로 읽는 것만으로는 오타를 놓치기 쉽습니다. `pg_hba_file_rules` 뷰는 서버가 지금 읽은 규칙을 한 줄씩 보여 주고, 문법 오류가 있으면 `error` 열에 이유를 적어 줍니다.

```sql
SELECT line_number, type, database, user_name, address, auth_method, coalesce(error,'-')
FROM pg_hba_file_rules;
```

3단계 끝에서 확인한 결과는 `local trust`, `host {lab} {app} 10.231.77.10 scram-sha-256`, `host {all} {all} 0.0.0.0 reject` 세 줄이었고, `error` 열은 모두 `-`(오류 없음)였습니다. 그래서 파일을 고친 뒤에는 이 뷰의 `error` 열이 모두 비어 있는지를 마지막 확인 단계로 두었습니다. 일부러 잘못된 줄을 넣어 `error` 열에 무엇이 나오는지는 이 글에서 해 보지 않았습니다.

## 5. 접속 표를 게이트로 쓰기

<!-- files: hba_demo.sh -->

스크립트는 마지막 단계의 어긋난 칸 수를 종료 코드로 돌려줍니다. 3단계가 0이면 종료 코드 0, 아니면 그 개수입니다. 설정을 바꿀 때마다 같은 6칸을 돌리면 "비밀번호 없이 들어오는 길이 생겼는가", "허용 범위 밖에서 들어오는가"를 사람이 아니라 표가 확인합니다. 칸을 늘리려면 `MATRIX`에 한 줄을 더하면 됩니다. 예를 들어 읽기 전용 역할이 따로 있으면 그 역할의 접속 위치를 추가합니다.

## 6. 읽을 때 알아 둘 점

- **`reject`를 맨 아래에 둔 것은 제 선택입니다.** 마지막에 모든 접속을 거절하는 줄을 두면 "허용한 것만 통과한다"는 의도가 파일에 드러납니다. 이 줄을 뺀 설정과 비교해 보지는 않았습니다.
- **SSL은 따지지 않았습니다.** 이 실습의 연결은 암호화 없이 맺었고(서버가 거절할 때 `no encryption`이라고 표시했습니다), 실제 환경에서는 `hostssl`을 쓰고 서버 인증서를 확인하는 단계가 더 필요합니다. 웹 서버의 TLS 점검은 [testssl 글](/blog/testssl-local-tls-check/)에서 다뤘고, 데이터베이스 연결의 TLS는 이 글에서 해 보지 않았습니다.
- **컨테이너 네트워크의 주소는 고정해서 썼습니다.** 앱이 여러 대로 늘면 `/32` 하나가 아니라 앱이 속한 대역으로 넓혀야 하고, 그때 범위가 얼마나 넓은지가 보안 수준을 정합니다.

## 전체 코드

전체를 한 번에 돌리는 스크립트입니다. 아래 두 설정 파일과 같은 폴더에서 실행합니다.

```bash
# hba_demo.sh
#!/usr/bin/env bash
# PostgreSQL 의 pg_hba.conf 를 "trust 로 전부 열림", "규칙만 고침(비밀번호는 md5 그대로)", "규칙과 SCRAM 모두 고침" 세 단계로 바꿔 가며
# 서로 다른 두 클라이언트 컨테이너에서 같은 6가지 접속을 시도하고, 기대와 어긋난 개수를 종료 코드로 낸다.
# 준비: Docker (postgres:16 이미지), 같은 폴더에 pg_hba_bad.conf, pg_hba_good.conf. 시험용이라 비밀번호는 lab-pw 이다.
# 실행(Git Bash): bash hba_demo.sh   (약 1분)
export MSYS_NO_PATHCONV=1
HERE="$(pwd)"
NET=osk-l1b-net; DB=osk-l1b-db; APP=osk-l1b-app; OTH=osk-l1b-other
cleanup() { docker rm -f $DB $APP $OTH >/dev/null 2>&1; docker network rm $NET >/dev/null 2>&1; }
cleanup
docker network create --subnet 10.231.77.0/24 $NET >/dev/null
docker run -d --name $DB  --network $NET --ip 10.231.77.2  -e POSTGRES_PASSWORD=admin-pw postgres:16 >/dev/null
docker run -d --name $APP --network $NET --ip 10.231.77.10 postgres:16 sleep infinity >/dev/null
docker run -d --name $OTH --network $NET --ip 10.231.77.20 postgres:16 sleep infinity >/dev/null
for i in $(seq 1 40); do docker exec $DB pg_isready -U postgres >/dev/null 2>&1 && break; sleep 1; done; sleep 3

SU() { docker exec -i $DB psql -U postgres -At "$@" 2>&1; }   # 컨테이너 안의 소켓(local trust)으로 관리 작업
SU -c "ALTER SYSTEM SET password_encryption='md5'" >/dev/null     # 처음엔 일부러 옛 방식(md5)으로 저장
SU -c "SELECT pg_reload_conf()" >/dev/null
SU -c "CREATE DATABASE lab" >/dev/null
SU -c "CREATE ROLE app LOGIN PASSWORD 'lab-pw'" >/dev/null
use_hba() { docker exec -i $DB sh -c 'cat > "$PGDATA/pg_hba.conf"' < "$HERE/$1"; SU -c "SELECT pg_reload_conf()" >/dev/null; sleep 1; }

# 접속 시도: try <클라이언트 컨테이너> <사용자> <비밀번호|-> <데이터베이스> → ALLOW 또는 DENY(이유)
try() {
  local c=$1 u=$2 p=$3 d=$4 out
  if [ "$p" = "-" ]; then p=""; fi
  out=$(docker exec -e PGPASSWORD="$p" -e PGCONNECT_TIMEOUT=5 $c psql "host=10.231.77.2 user=$u dbname=$d" -w -At -c "select 1" 2>&1)
  if [ "$out" = "1" ]; then echo "ALLOW"; else echo "DENY|$(echo "$out" | head -1 | sed -E 's/^.*FATAL:  //; s/, no encryption//; s/pg_hba.conf rejects connection for host/pg_hba 거절: host/' | cut -c1-100)"; fi
}
# 기대하는 표: 이름 | 클라이언트 | 사용자 | 비밀번호 | 데이터베이스 | 기대
MATRIX=(
  "1 app 서버에서 app, 맞는 비밀번호|$APP|app|lab-pw|lab|ALLOW"
  "2 app 서버에서 app, 틀린 비밀번호|$APP|app|wrong|lab|DENY"
  "3 app 서버에서 postgres, 비밀번호 없이|$APP|postgres|-|lab|DENY"
  "4 다른 서버에서 app, 맞는 비밀번호|$OTH|app|lab-pw|lab|DENY"
  "5 다른 서버에서 postgres, 비밀번호 없이|$OTH|postgres|-|lab|DENY"
  "6 app 서버에서 app, postgres DB|$APP|app|lab-pw|postgres|DENY"
)
run_matrix() {
  local bad=0 row name c u p d want got
  for row in "${MATRIX[@]}"; do
    IFS='|' read -r name c u p d want <<<"$row"
    got=$(try $c $u $p $d)
    if [ "${got%%|*}" = "$want" ]; then mark="맞음"; else mark="어긋남"; bad=$((bad+1)); fi
    printf "  %s 기대 %-5s 실제 %-5s %s
" "$mark" "$want" "${got%%|*}" "${name#* }"
    [ "$got" != "${got%%|*}" ] && echo "           - ${got#*|}"
  done
  echo "  어긋난 칸: $bad / ${#MATRIX[@]}"
  return $bad
}
hash_kind() { SU -c "SELECT rolname || ' ' || left(rolpassword, 14) FROM pg_authid WHERE rolname='app'"; }

echo "## 1. 느슨한 상태: host all all 0.0.0.0/0 trust, 비밀번호는 md5 저장"
use_hba pg_hba_bad.conf
echo "  저장된 해시: $(hash_kind)"
run_matrix; R1=$?

echo "## 2. 규칙만 고침: pg_hba 는 scram-sha-256 인데 app 의 비밀번호는 md5 로 저장된 채"
use_hba pg_hba_good.conf
run_matrix; R2=$?
echo "  서버 로그: $(docker logs $DB 2>&1 | grep -m1 'valid SCRAM secret' | sed -E 's/^.*DETAIL:  /DETAIL: /')"

echo "## 3. 저장 방식도 고침: password_encryption 을 scram 으로 바꾸고 비밀번호를 다시 설정"
SU -c "ALTER SYSTEM SET password_encryption='scram-sha-256'" >/dev/null; SU -c "SELECT pg_reload_conf()" >/dev/null
SU -c "ALTER ROLE app PASSWORD 'lab-pw'" >/dev/null
echo "  저장된 해시: $(hash_kind)"
run_matrix; R3=$?

echo "## 4. pg_hba_file_rules 로 규칙 교차 확인(error 열이 비어 있어야 함)"
SU -c "SELECT line_number, type, database, user_name, address, auth_method, coalesce(error,'-') FROM pg_hba_file_rules" | sed 's/^/  /'
cleanup
echo "## 요약: 1단계 어긋남 $R1, 2단계 어긋남 $R2, 3단계 어긋남 $R3"
[ $R3 -eq 0 ] && echo "  게이트: 최종 상태 통과(종료 코드 0)" || echo "  게이트: 실패"
exit $R3
```

느슨한 설정입니다.

`pg_hba_bad.conf`

```text
# 느슨한 상태: 어디서 오든 누구든(슈퍼유저 포함) 비밀번호 없이 들어온다.
local   all   all                  trust
host    all   all   0.0.0.0/0      trust
```

조인 설정입니다.

`pg_hba_good.conf`

```text
# 조인 상태: app 서버(10.231.77.10) 한 곳에서, app 역할만, lab 데이터베이스만, SCRAM 비밀번호로만 허용한다.
local   all   all                  trust
host    lab   app   10.231.77.10/32  scram-sha-256
host    all   all   0.0.0.0/0      reject
```

## 자주 막히는 곳

| 증상 | 원인 | 해결 |
|---|---|---|
| 규칙을 SCRAM으로 바꿨더니 정상 비밀번호도 `password authentication failed` | 저장된 해시가 `md5` 형태 | `password_encryption`을 바꾸고 비밀번호 재설정, 서버 로그의 `valid SCRAM secret` 확인 |
| 네트워크 생성이 `Pool overlaps with other one on this address space` | 다른 컨테이너 네트워크와 주소 대역이 겹침 | 겹치지 않는 대역(이 글은 `10.231.77.0/24`)으로 변경 |
| 설정 파일 위치를 모르겠음 | 설치마다 다름 | `SHOW hba_file;`로 확인하고, 이 글은 `$PGDATA/pg_hba.conf`에 썼음 |
| 규칙을 고쳤는데 그대로임 | 설정을 다시 읽지 않음 | `SELECT pg_reload_conf();` 후 `pg_hba_file_rules` 확인 |

## 확인 범위

- **해 본 것:** 2026-10-30, Windows 11 · Docker 29.5.3 · PostgreSQL 16.15에서 `trust` 설정, SCRAM으로 규칙만 바꾼 설정, 저장 방식까지 바꾼 설정을 같은 6가지 접속(app 서버의 맞는 비밀번호, 틀린 비밀번호, 슈퍼유저 무비밀번호, 다른 서버의 맞는 비밀번호, 다른 서버의 슈퍼유저 무비밀번호, 다른 데이터베이스)으로 비교했습니다. 어긋난 칸이 5, 1, 0개였고 종료 코드 0을 확인했습니다. `pg_hba_file_rules`의 규칙과 `error` 열, `pg_authid`의 해시 접두어, 서버 로그의 `valid SCRAM secret` 메시지를 대조했습니다. 전체 스크립트의 최종판을 두 번 실행해 결과가 같았고(고치기 전 판도 같은 숫자였습니다), 끝에 컨테이너와 네트워크를 지웠습니다.
- **해 보지 않은 것:** `hostssl`과 인증서 검증, 클라이언트 인증서(`cert`) 방식, `peer`와 `ident`, LDAP와 `gss` 연동, 잘못된 규칙 줄을 넣었을 때의 `error` 열 내용, `md5`가 아닌 평문 저장값, `scram`의 반복 횟수 조정, 연결 수 제한, Linux와 macOS.
- **읽을 때 주의:** 이 글의 비밀번호와 주소는 시험용이며 `trust` 설정은 컨테이너 안의 소켓 관리에만 남겼습니다. 3단계에서 `app` 해시가 `SCRAM-SHA-256$`로 시작한다는 것까지만 확인했고 내부 형식은 읽지 않았습니다. 오류 메시지는 이 버전(16.15)의 것입니다.
