# Redis ACL로 사용자별 명령과 키 제한하기

> 비밀번호 없는 default 사용자만 있는 Redis 7.4를 앱용과 읽기용 사용자로 나누고, default를 끄고, 키 패턴과 명령을 제한합니다. 같은 9칸짜리 허용/거부 표로 전후를 검사해 어긋난 칸이 6개에서 0개가 되는 것을 확인하고, 실행 없이 판정하는 ACL DRYRUN과 거부 사유를 남기는 ACL LOG로 교차 확인합니다.

- 주소: https://copyandrun.com/blog/redis-acl-users-commands/
- 분야: DevSecOps
- 발행일: 2026-10-30
- 태그: Redis, ACL, 최소 권한, ACL DRYRUN, ACL LOG

Redis는 설치 직후 비밀번호 없는 `default` 사용자 하나가 모든 명령과 모든 키를 쓸 수 있는 상태로 시작합니다. 같은 서버를 여러 서비스가 나눠 쓰는 순간 캐시를 읽으려던 코드가 `FLUSHALL`을 부를 수 있고, 설정 변경(`CONFIG`)이나 전체 키 조회(`KEYS *`)도 열려 있습니다. Redis 6부터 있는 ACL로 사용자별로 쓸 수 있는 명령과 키를 줄일 수 있습니다. 이 글에서는 Redis 7.4 컨테이너를 느슨한 상태에서 최소 권한으로 고치면서, 사용자와 명령의 허용/거부 기대표를 먼저 정하고 전후에 같은 표로 검사합니다. 같은 방식으로 PostgreSQL 권한을 다룬 [역할 최소 권한 글](/blog/postgres-roles-least-privilege/)도 함께 읽어 보면 좋습니다.

익명 사용자와 로그인 사용자의 읽기 권한을 나눠 보는 방식은 [OpenLDAP ACL 점검 글](/blog/openldap-acl-anonymous-vs-bound/)에서 디렉터리 서버로 옮겨 다룹니다.

## 준비물

| 항목 | 확인한 값 |
|---|---|
| Docker | 29.5.3 (Windows 11, Git Bash에서 실행) |
| Redis | 7.4.11 (`redis:7-alpine` 이미지) |
| 접속 | 컨테이너 안의 `redis-cli`(`docker exec`), 포트는 바깥에 열지 않음 |
| 사용자 | `default`(처음부터 있음), `app`(앱), `reader`(읽기 전용), `admin`(설정과 점검용) |

모든 사용자의 비밀번호는 시험용으로 `lab`입니다. `admin`은 `default`를 끄기 전에 먼저 만들었습니다. `default`를 먼저 끄면 설정할 사용자가 없어서 이후 명령이 모두 `NOAUTH`로 막히는데, 실제로 처음 스크립트에서 이 실수를 해서 순서를 고쳤습니다.

## 1. 기대하는 허용과 거부 표

최소 권한 기준으로 9칸을 먼저 적었습니다.

| 사용자 | 명령 | 기대 |
|---|---|---|
| 인증 없음(`default`) | `GET app:1` | 거부 |
| `app` | `SET app:1`, `GET app:1` | 허용 |
| `app` | `GET other:1`(다른 키 영역) | 거부 |
| `app` | `KEYS *`, `CONFIG GET dir`, `FLUSHALL` | 거부 |
| `reader` | `GET app:1` | 허용 |
| `reader` | `SET app:1` | 거부 |

결과에 `NOPERM`(권한 없음), `NOAUTH`(인증 필요), `WRONGPASS`(비밀번호 오류) 중 하나가 나오면 거부로, 아니면 허용으로 읽었습니다. 매 검사 전에 `app:1`과 `other:1`을 `admin`으로 채워 둬서 이전 검사의 영향을 받지 않게 했습니다.

## 2. 느슨한 상태

<!-- files: redis_acl_demo.sh -->

처음 상태를 재현했습니다. `default`는 `on nopass ~* &* +@all`(켜짐, 비밀번호 없음, 모든 키, 모든 채널, 모든 명령)이고, `app`과 `reader`도 일부러 같은 범위(`~* &* +@all`)에 비밀번호만 붙여 두었습니다. 사용자는 나뉘어 있지만 권한은 똑같은 "이름만 있는 ACL"입니다. 흔히 보는 모양입니다.

9칸 검사에서 6칸이 기대와 달랐고 게이트는 종료 코드 1이었습니다.

| 어긋난 칸 | 실제 |
|---|---|
| 인증 없이 `GET app:1` | 허용 |
| `app`의 `GET other:1`, `KEYS *`, `CONFIG GET dir`, `FLUSHALL` | 모두 허용 |
| `reader`의 `SET app:1` | 허용 |

## 3. 최소 권한으로 고치기

<!-- files: redis_acl_demo.sh -->

명령은 세 줄입니다.

```
ACL SETUSER default off
ACL SETUSER app resetkeys '~app:*' resetchannels -@all +get +set +del +expire +ttl
ACL SETUSER reader resetkeys '~app:*' resetchannels -@all +get +mget
```

- `default off`로 비밀번호 없는 접속을 끊습니다. 이제 인증 없이 접속하면 `NOAUTH Authentication required.`가 나옵니다.
- `resetkeys '~app:*'`로 기존 키 범위를 지우고 `app:`으로 시작하는 키만 허용합니다.
- `resetchannels`는 Pub/Sub 채널 접근을 모두 지웁니다.
- `-@all`로 모든 명령을 막은 다음 필요한 명령만 `+`로 하나씩 엽니다. 허용 목록 방식이라 나중에 위험한 명령이 추가되어도 자동으로 열리지 않습니다.
- `app`이 `ACL LIST`를 실행해 보자 `NOPERM User app has no permissions to run the 'acl|list' command`가 나와, 앱이 다른 사용자의 설정을 볼 수 없었습니다. 권한을 바꾸는 명령은 `app`으로 실행해 보지 않았습니다.

같은 9칸을 다시 검사한 결과 어긋난 칸 0개, 게이트 종료 코드 0이었습니다.

![느슨한 상태에서 9칸 중 6칸이 어긋나 종료 코드 1이고, default를 끄고 키와 명령을 제한한 뒤에는 어긋난 칸 0으로 종료 코드 0이며 인증 없는 접속은 NOAUTH, app의 ACL LIST는 NOPERM인 것을 확인합니다.](https://copyandrun.com/img/redis-acl-users-commands/01-redis-느슨한-상태와-고침.png)

## 4. 교차 확인: ACL DRYRUN

`ACL DRYRUN 사용자 명령 인자...`는 명령을 실행하지 않고 그 사용자가 실행할 수 있는지만 알려 줍니다. 이 값이 위의 실제 실행 결과와 같은지 확인했습니다.

| DRYRUN | 응답 |
|---|---|
| `app GET app:1` | `OK` |
| `app GET other:1` | `User app has no permissions to access the 'other:1' key` |
| `app FLUSHALL` | `User app has no permissions to run the 'flushall' command` |
| `reader SET app:1 x` | `User reader has no permissions to run the 'set' command` |

네 건 모두 실제 실행 결과와 같았습니다. 거부 사유가 "키"인지 "명령"인지까지 구분해 알려 주므로, 규칙을 고칠 때 먼저 `DRYRUN`으로 확인하면 서비스에 영향을 주지 않고 결과를 볼 수 있습니다.

## 5. ACL LOG: 거부된 시도의 기록

`ACL LOG`는 거부된 시도를 사유(`reason`), 대상(`object`), 사용자(`username`)와 함께 남깁니다. 시험 뒤에 확인한 기록입니다.

| 사용자 | 사유 | 대상 |
|---|---|---|
| `reader` | command | `set` |
| `app` | command | `flushall`, `config|get`, `keys`, `acl|list` |
| `app` | key | `other:1` |

시도한 거부 5건과 ACL LIST 거부 1건이 모두 남았고, 사유가 명령 때문인지 키 때문인지 구분되었습니다. 운영에서는 이 기록이 갑자기 늘어나면 앱 설정이 틀렸거나 누군가 권한 밖의 명령이나 키를 시도한다는 신호가 될 수 있습니다. 인증 실패(`NOAUTH`)의 기록 방식은 이 글에서 확인하지 않았습니다.

![다시 검사한 9칸이 모두 기대와 같고, ACL DRYRUN의 네 건이 실제 결과와 같으며, ACL LOG에 거부된 명령과 키가 사유와 함께 남은 것과 Redis 7.4.11을 확인합니다.](https://copyandrun.com/img/redis-acl-users-commands/02-redis-dryrun-acl-log.png)

## 6. 명령 묶음으로 짧게 쓰기

명령을 하나씩 나열하면 길고 빠뜨리기 쉬워서 Redis는 명령 묶음(`@read`, `@write`, `@dangerous` 등)을 제공합니다. 별도 스크립트(`redis_cat_demo.sh`)로 `ACL CAT`의 크기와 묶음으로 만든 사용자의 동작을 확인했습니다.

| 묶음 | 명령 수(7.4.11) |
|---|---|
| `@read` | 91개 |
| `@write` | 113개 |
| `@dangerous` | 75개(`shutdown`, `debug`, `keys`, `flushall` 포함) |

`viewer` 사용자를 `-@all +@read -@dangerous`와 키 패턴 `~v:*`로 만들어 실행한 결과입니다.

| 실행 | 결과 |
|---|---|
| `GET v:1`, `MGET v:1 v:2` | 값이 돌아옴 |
| `SET v:1 x` | `NOPERM ... 'set' command` |
| `KEYS v:*` | `NOPERM ... 'keys' command`(`@dangerous`를 뺐으므로 막힘) |
| `INFO` | `NOPERM ... 'info' command` |
| `ACL DRYRUN viewer SCAN 0` | `OK`(`KEYS` 대신 `SCAN`은 허용됨) |

묶음은 짧고 읽기 쉽지만, 묶음에 든 명령과 위 숫자는 이 버전에서만 확인한 값이므로 버전을 올릴 때는 허용/거부 표를 다시 돌려 확인합니다.

## 7. 운영에 옮길 때 확인할 것

- **`default`를 끄기 전에 관리자를 만듭니다.** 순서가 거꾸로면 서버에 들어가 재시작하는 수밖에 없습니다.
- **허용 목록으로 시작합니다.** `-@all`에서 필요한 명령만 열고, `KEYS`, `CONFIG`, `FLUSHALL` 같은 위험한 명령은 열지 않습니다. 3번에서는 개별 명령을 나열했고 묶음은 6번에서 따로 확인했습니다.
- **ACL을 파일로 저장합니다.** 이 글의 설정은 `ACL SETUSER`로 메모리에만 넣었습니다. 서버를 재시작해도 유지하려면 `aclfile`이나 `redis.conf`의 `user` 줄이 필요하며, 이 방법은 해 보지 않았습니다.
- **네트워크도 함께 닫습니다.** ACL은 접속한 뒤의 권한을 줄이는 도구이고 접속 자체는 방화벽과 바인딩 설정이 막아야 합니다.

## 전체 코드

전체를 한 번에 돌리는 스크립트입니다. 같은 폴더에서 실행합니다.

```bash
# redis_acl_demo.sh
#!/usr/bin/env bash
# Redis ACL 을 "느슨한 상태"와 "최소 권한 상태"로 나눠 같은 허용/거부 표로 검사하고, ACL DRYRUN 과 ACL LOG 로 교차 확인한다.
# 준비: Docker (redis:7-alpine). 시험용 컨테이너라 비밀번호는 모두 lab 이고 포트는 바깥에 열지 않는다.
# 실행(Git Bash): bash redis_acl_demo.sh   (약 15초)
export MSYS_NO_PATHCONV=1
N=osk-fb-redis
docker rm -f $N >/dev/null 2>&1
docker run -d --name $N redis:7-alpine >/dev/null
sleep 2
R()  { docker exec $N redis-cli --no-auth-warning "$@" 2>&1; }             # 인증 없이(default 사용자)
RU() { local u=$1; shift; docker exec $N redis-cli --no-auth-warning --user "$u" --pass lab "$@" 2>&1; }
AD() { RU admin "$@"; }                                                     # 설정과 점검에만 쓰는 관리자(default 를 끄기 전에 만들어 둔다)
R ACL SETUSER admin on '>lab' '~*' '&*' '+@all' >/dev/null

# 기대하는 표(최소 권한 기준): 사용자 | 명령 | 기대값
MATRIX=(
  "anon|GET app:1|DENY"
  "app|SET app:1 hello|ALLOW"
  "app|GET app:1|ALLOW"
  "app|GET other:1|DENY"
  "app|KEYS *|DENY"
  "app|CONFIG GET dir|DENY"
  "app|FLUSHALL|DENY"
  "reader|GET app:1|ALLOW"
  "reader|SET app:1 x|DENY"
)
try() {   # try <사용자> <명령...> : NOPERM, NOAUTH, WRONGPASS 가 나오면 DENY
  local u=$1; shift; local out
  if [ "$u" = anon ]; then out=$(R "$@"); else out=$(RU "$u" "$@"); fi
  if echo "$out" | grep -qE 'NOPERM|NOAUTH|WRONGPASS'; then echo DENY; else echo ALLOW; fi
}
check_all() {
  local bad=0 row u cmd want got mark
  AD SET app:1 seed >/dev/null; AD SET other:1 seed >/dev/null            # 시험 전에 자료를 채움
  for row in "${MATRIX[@]}"; do
    IFS='|' read -r u cmd want <<<"$row"
    got=$(try "$u" $cmd)
    mark="  "; [ "$got" != "$want" ] && { mark="X "; bad=$((bad+1)); }
    printf "  %s%-7s %-22s 기대 %-5s 실제 %s\n" "$mark" "$u" "$cmd" "$want" "$got"
  done
  echo "  어긋난 칸: $bad / ${#MATRIX[@]}"
  return $((bad>0))
}

echo "## 1. 느슨한 상태(default 사용자는 비밀번호 없음, 앱과 읽기 사용자도 모든 명령과 키 허용)"
AD ACL SETUSER app on '>lab' '~*' '&*' '+@all' >/dev/null
AD ACL SETUSER reader on '>lab' '~*' '&*' '+@all' >/dev/null
echo "  default 사용자 규칙: $(AD ACL LIST | grep '^user default' | sed 's/sanitize-payload //')"
echo "  app 사용자 규칙:     $(AD ACL LIST | grep '^user app' | sed 's/sanitize-payload //; s/#[0-9a-f]*/#해시/')"
check_all; echo "  게이트 종료 코드 $?"

echo "## 2. 최소 권한으로 고치기"
AD ACL SETUSER default off >/dev/null
AD ACL SETUSER app resetkeys '~app:*' resetchannels -@all +get +set +del +expire +ttl >/dev/null
AD ACL SETUSER reader resetkeys '~app:*' resetchannels -@all +get +mget >/dev/null
AD ACL LOG RESET >/dev/null
echo "  인증 없이 접속(default 사용자): $(R GET app:1)"
echo "  app 사용자가 ACL LIST 실행: $(RU app ACL LIST)"

echo "## 3. 같은 표로 다시 검사"
check_all; echo "  게이트 종료 코드 $?"

echo "## 4. 교차 확인: ACL DRYRUN(실행하지 않고 판정)과 실제 실행 결과"
for t in "app GET app:1" "app GET other:1" "app FLUSHALL" "reader SET app:1 x"; do
  printf "  DRYRUN %-20s -> %s\n" "$t" "$(AD ACL DRYRUN $t | cut -c1-80)"
done
echo "## 5. ACL LOG: 거부된 시도가 사유와 함께 남음"
AD ACL LOG 20 | awk 'NR%2==1{k=$0} NR%2==0{print "  " k ": " $0}' | grep -E '^  (reason|object|username):' | paste - - - | head -8 | sed 's/\t/  /g'
AD INFO server | grep redis_version | tr -d '\r' | sed 's/^/  /'
docker rm -f $N >/dev/null 2>&1
echo "## 끝"
```

명령 묶음으로 허용 목록을 쓰는 방법을 확인하는 보조 스크립트입니다.

```bash
# redis_cat_demo.sh
#!/usr/bin/env bash
# 명령 묶음(@read, @write, @dangerous)으로 허용 목록을 짧게 쓰는 방법을 확인한다.
# 실행(Git Bash): bash redis_cat_demo.sh   (약 10초)
export MSYS_NO_PATHCONV=1
N=osk-fb-redis2
docker rm -f $N >/dev/null 2>&1
docker run -d --name $N redis:7-alpine >/dev/null
sleep 2
R() { docker exec $N redis-cli --no-auth-warning "$@" 2>&1; }
echo "## 묶음별 명령 수"
for c in read write dangerous; do echo "  @$c: $(R ACL CAT $c | wc -l)개"; done
echo "  @dangerous 안의 예: $(R ACL CAT dangerous | grep -E '^(flushall|keys|config|shutdown|debug)$' | tr '\n' ' ')"
echo "## +@read -@dangerous 로 만든 사용자"
R ACL SETUSER viewer on '>lab' '~v:*' -@all +@read -@dangerous >/dev/null
R SET v:1 hello >/dev/null
RV() { docker exec $N redis-cli --no-auth-warning --user viewer --pass lab "$@" 2>&1; }
for cmd in "GET v:1" "MGET v:1 v:2" "SET v:1 x" "KEYS v:*" "INFO"; do
  printf "  %-14s -> %s\n" "$cmd" "$(RV $cmd | head -1 | cut -c1-70)"
done
echo "  DRYRUN viewer SCAN 0 -> $(R ACL DRYRUN viewer SCAN 0)"
docker rm -f $N >/dev/null 2>&1
echo "## 끝"
```

## 자주 막히는 곳

| 증상 | 원인 | 해결 |
|---|---|---|
| `default off` 뒤 모든 명령이 `NOAUTH` | 관리자 사용자 없이 default를 껐음 | 먼저 `admin`을 만들고, 껐다면 컨테이너를 다시 시작 |
| 키 패턴을 줬는데도 다른 키가 읽힘 | 이전 규칙의 `~*`가 남아 있음 | `resetkeys`로 지운 뒤 패턴 지정 |
| 앱이 `NOPERM ... no permissions to access the key` | 키 이름이 패턴(`app:*`)과 다름 | 키 이름 규칙을 맞추거나 패턴 확장 |
| `ACL DRYRUN`이 `NOPERM` | DRYRUN을 부르는 사용자에게 `ACL` 권한이 없음 | 관리자 사용자로 실행 |
| 비밀번호가 ACL 목록에 그대로 보일까 걱정됨 | 목록에는 SHA-256 해시(`#...`)로 표시됨 | `ACL LIST` 출력을 확인 |

## 확인 범위

- **해 본 것:** 2026-10-30, Windows 11 · Docker 29.5.3 · Redis 7.4.11에서 느슨한 상태의 9칸 검사(어긋난 6칸, 종료 코드 1), `default`를 끄고 키 패턴과 명령을 제한한 뒤의 검사(0칸, 종료 코드 0), `app`의 `ACL LIST` 거부, `ACL DRYRUN` 네 건과 실제 결과의 일치, `ACL LOG`의 사유 확인, 명령 묶음(`@read`, `@dangerous`)으로 만든 사용자의 동작을 실행했습니다. 전체 스크립트를 세 번 실행해 출력이 완전히 같았고, 끝에 컨테이너를 지웠습니다.
- **해 보지 않은 것:** ACL 파일 저장과 재시작 뒤 유지, 하위 명령 규칙의 세부, 채널(Pub/Sub) 제한, 선택자(selector) 문법, TLS와 `bind` 설정, Redis Cluster와 Sentinel, 다른 버전, Linux와 macOS.
- **읽을 때 주의:** 비밀번호 `lab`과 컨테이너 안 접속은 시험용입니다. 이 글의 설정은 메모리에만 있으며 컨테이너를 지우면 사라집니다. 오류 문구는 Redis 7.4.11 기준입니다.
