Copy & Run

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

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

실습 노트 · 2026-10-30 발행 · 2026-11-14 수정 · 10분 · 2026-10 확인

Redis는 설치 직후 비밀번호 없는 default 사용자 하나가 모든 명령과 모든 키를 쓸 수 있는 상태로 시작합니다. 같은 서버를 여러 서비스가 나눠 쓰는 순간 캐시를 읽으려던 코드가 FLUSHALL을 부를 수 있고, 설정 변경(CONFIG)이나 전체 키 조회(KEYS *)도 열려 있습니다. Redis 6부터 있는 ACL로 사용자별로 쓸 수 있는 명령과 키를 줄일 수 있습니다. 이 글에서는 Redis 7.4 컨테이너를 느슨한 상태에서 최소 권한으로 고치면서, 사용자와 명령의 허용/거부 기대표를 먼저 정하고 전후에 같은 표로 검사합니다. 같은 방식으로 PostgreSQL 권한을 다룬 역할 최소 권한 글도 함께 읽어 보면 좋습니다.

익명 사용자와 로그인 사용자의 읽기 권한을 나눠 보는 방식은 OpenLDAP ACL 점검 글에서 디렉터리 서버로 옮겨 다룹니다.

준비물

항목 확인한 값
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. 느슨한 상태

처음 상태를 재현했습니다. 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 허용
이 단계의 파일 내려받기:redis_acl_demo.sh

3. 최소 권한으로 고치기

명령은 세 줄입니다.

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인 것을 확인합니다.
느슨한 상태에서 9칸 중 6칸이 어긋나 종료 코드 1이고, default를 끄고 키와 명령을 제한한 뒤에는 어긋난 칸 0으로 종료 코드 0이며 인증 없는 접속은 NOAUTH, app의 ACL LIST는 NOPERM인 것을 확인합니다.

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

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
app key other:1

시도한 거부 5건과 ACL LIST 거부 1건이 모두 남았고, 사유가 명령 때문인지 키 때문인지 구분되었습니다. 운영에서는 이 기록이 갑자기 늘어나면 앱 설정이 틀렸거나 누군가 권한 밖의 명령이나 키를 시도한다는 신호가 될 수 있습니다. 인증 실패(NOAUTH)의 기록 방식은 이 글에서 확인하지 않았습니다.

다시 검사한 9칸이 모두 기대와 같고, ACL DRYRUN의 네 건이 실제 결과와 같으며, ACL LOG에 거부된 명령과 키가 사유와 함께 남은 것과 Redis 7.4.11을 확인합니다.
다시 검사한 9칸이 모두 기대와 같고, ACL DRYRUN의 네 건이 실제 결과와 같으며, ACL LOG에 거부된 명령과 키가 사유와 함께 남은 것과 Redis 7.4.11을 확인합니다.

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은 허용됨)

묶음은 짧고 읽기 쉽지만, 묶음에 든 명령과 위 숫자는 이 버전에서만 확인한 값이므로 버전을 올릴 때는 허용/거부 표를 다시 돌려 확인합니다.

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

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

  • default를 끄기 전에 관리자를 만듭니다. 순서가 거꾸로면 서버에 들어가 재시작하는 수밖에 없습니다.
  • 허용 목록으로 시작합니다. -@all에서 필요한 명령만 열고, KEYS, CONFIG, FLUSHALL 같은 위험한 명령은 열지 않습니다. 3번에서는 개별 명령을 나열했고 묶음은 6번에서 따로 확인했습니다.
  • ACL을 파일로 저장합니다. 이 글의 설정은 ACL SETUSER로 메모리에만 넣었습니다. 서버를 재시작해도 유지하려면 aclfile이나 redis.conf의 user 줄이 필요하며, 이 방법은 해 보지 않았습니다.
  • 네트워크도 함께 닫습니다. ACL은 접속한 뒤의 권한을 줄이는 도구이고 접속 자체는 방화벽과 바인딩 설정이 막아야 합니다.

전체 코드

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

# 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 "## 끝"

명령 묶음으로 허용 목록을 쓰는 방법을 확인하는 보조 스크립트입니다.

# 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 "## 끝"
이 단계의 파일 내려받기:redis_acl_demo.shredis_cat_demo.sh

자주 막히는 곳

증상 원인 해결
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 기준입니다.

이 글의 다음 단계

  • MongoDB 인증 켜기와 최소 권한 사용자: 열린 서버, 루트 공유, 역할 분리 비교인증 없이 뜬 MongoDB 8은 같은 네트워크의 다른 컨테이너가 DB 목록을 보고 급여 문서를 읽고 컬렉션을 지울 수 있습니다. 인증을 켠 서버에서 앱이 루트 계정을 그대로 쓰는 경우와 앱용, 보고용 사용자를 나눈 경우를 5가지 동작 20칸 표로 비교하고, connectionStatus와 서버 로그로 교차 확인합니다.
  • MySQL 8.0 사용자와 권한 감사: 빈 비밀번호, 와일드카드MySQL 8.0 컨테이너에 일부러 느슨한 계정을 만들고, mysql.user와 information_schema 질의로 빈 비밀번호, % 호스트, GRANT OPTION 전역 권한을 찾는 감사 스크립트를 돌립니다. HIGH 발견 4건을 최소 권한으로 고쳐 0건으로 만들고, 실제 접속 시험 8칸과 SHOW GRANTS로 교차 확인한 뒤 종료 코드로 판정합니다.

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

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

교육 문의하기

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

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

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

같은 카테고리의 글

DevSecOps · 실습 노트

MongoDB 인증 켜기와 최소 권한 사용자: 열린 서버, 루트 공유, 역할 분리 비교

인증 없이 뜬 MongoDB 8은 같은 네트워크의 다른 컨테이너가 DB 목록을 보고 급여 문서를 읽고 컬렉션을 지울 수 있습니다. 인증을 켠 서버에서 앱이 루트 계정을 그대로 쓰는 경우와 앱용, 보고용 사용자를 나눈 경우를 5가지 동작 20칸 표로 비교하고, connectionStatus와 서버 로그로 교차 확인합니다.

2026-10-31 · 10분
DevSecOps · 실습 노트

MySQL 8.0 사용자와 권한 감사: 빈 비밀번호, 와일드카드

MySQL 8.0 컨테이너에 일부러 느슨한 계정을 만들고, mysql.user와 information_schema 질의로 빈 비밀번호, % 호스트, GRANT OPTION 전역 권한을 찾는 감사 스크립트를 돌립니다. HIGH 발견 4건을 최소 권한으로 고쳐 0건으로 만들고, 실제 접속 시험 8칸과 SHOW GRANTS로 교차 확인한 뒤 종료 코드로 판정합니다.

2026-10-30 · 10분
DevSecOps · 실습 노트

PostgreSQL 역할 최소 권한 실습: PUBLIC 회수, 기본 권한

앱 역할이 표 주인이고 읽기 역할에 ALL이 주어진 느슨한 PostgreSQL을 최소 권한으로 고칩니다. 같은 12칸짜리 허용/거부 표로 전후를 검사해 어긋난 칸이 6개에서 0개가 되는 것을 확인하고, 나중에 만든 표에 권한이 자동으로 붙는 기본 권한(DEFAULT PRIVILEGES)과 has_table_privilege 교차 확인까지 다룹니다.

2026-10-30 · 11분