Caused by: org.redisson.client.RedisAuthRequiredException: NOAUTH Authentication required. 원인 및 해결방법

갑자기 팀원들한테 테스트 서버가 접속이 안된다고 연락이 왔다. 분명 어제도 배포 workflow가 동작하고 정상 작동하는 것을 확인했기 때문에 이상해서 로그를 확인했더니, 처음 보는 로그가 있었다. 확인해보자.

Caused by: org.redisson.client.RedisAuthRequiredException: NOAUTH Authentication required.

 

 

---

NOAUTH Authentication required. 란

NOAUTH Authentication required는 비밀번호가 설정되어 있음에도 AUTH 설정이 안되있어서 발생하는 에러이기도 하다. 이를 확인하려면 redis-cli에 접속해보자. 필자는 Docker container로 redis를 관리하고 있으므로 조금 다른 명령어를 사용해야 한다.

$ sckwon770@ubuntu:~/jnu-parking/storage$ sudo docker exec -it 77d53a9a5bb8 redis-cli
127.0.0.1:6379> ping
(error) NOAUTH Authentication required.

 

AUTH 설정이 문제라면 응답으로 pong이 와야하지만, 위와 같은 똑같은 에러가 발생한다.

그런데 이상하다. 이때까지 별도로 레디스 설정을 관리하지 않아, 디폴트로 패스워드가 설정되지 않은채로 사용했다.

 

 

---

원인 파악

• 여러 명이 개발하는 프로젝트이니, 누군가 설정 파일을 도입한걸까?

docker-compose.yml을 확인하니, 초기에 생성한 그대로이다.

 

version: '3.8'

services:
  redis:
    image: redis:alpine
    container_name: redis_container
    ports:
      - "6379:6379" # 로컬호스트에서 6380 포트로 Redis에 접근
    networks:
      - jnu-parking
    volumes:
      - redis_data:/data

volumes:
  redis_data:

networks:
  jnu-parking:
    external: true
~

 

• 디폴트 패스워드가 별도로 존재했던걸까?

이에대한 공식 문서는 없었지만, docker-library-redis repo의 issues에서 redis-lab 개발자가 답변한 내용이 있다. 디폴트는 비밀번호가 없는 것이 맞다.

 

• 컨테이너 생성시에 별도로 설정파일을 매핑하지 않았으니, 별도로 생성되는 설정파일이 있거나 누군가 수정했던걸까?

컨테이너 내부에 redis.conf 파일 자체가 존재하지 않았다.. 기묘한 일이 아닐 수 없다...

/data # cd /etc/redis
/bin/sh: cd: can't cd to /etc/redis: No such file or directory

/bin/sh: cd: can't cd to /usr/local/etc/redis: No such file or directory

/ # sudo find / -name "redis.conf"
/bin/sh: sudo: not found

 

 

---

해결 방법

일반적으로 알려진 내용대로 구축되어 있음에도 문제가 발생되고 있는 상태이다. 구축된 시스템들이 오픈소스이므로 결함이 있을수도 있고 자료가 outdated되어 변경사항이 있는 것일수도 있다. 다만, 하나 확실한 것은 시스템이 디폴트 값에 의존하고 있는 것은 올바른 내용이 아니다. 언제라도 발생할 문제였던 것으로 보인다.

 

반대로 명시적으로 redis.conf를 매핑하고 비밀번호를 설정해 해결해보자.

 

컨테이너의 redis.conf에 대해 매핑값을 추가하고

version: '3.8'

services:
  redis:
    image: redis:alpine
    container_name: redis_container
    ports:
      - "6379:6379" # 로컬호스트에서 6380 포트로 Redis에 접근
    networks:
      - jnu-parking
    volumes:
      - redis_data:/data
      - ./redis.conf:/etc/redis/redis.conf

volumes:
  redis_data:

networks:
  jnu-parking:
    external: true
~

 

redis.conf 내용을 작성하자. redis.conf 파일의 공식 예시는 (링크) 에서 확인할 수 있다. 필자의 경우 잘 정리되어 있는 포스팅의 설정파일을 참고했다.

# 연결 가능한 네트위크(0.0.0.0 = Anywhere)
bind 0.0.0.0

# 연결 포트
port 6379

# Master 노드의 기본 사용자 비밀번호
requirepass redis

# 최대 사용 메모리 용량(Default : 시스템 전체 용량)
maxmemory 2gb

# 설정된 최대 사용 메모리 용량을 초과했을때 처리 방식
# - noeviction : 쓰기 동작에 대해 error 반환 (Default)
# - volatile-lru : expire 가 설정된 key 들중에서 LRU algorithm 에 의해서 선택된 key 제거
# - allkeys-lru : 모든 key 들 중 LRU algorithm에 의해서 선택된 key 제거
# - volatile-random : expire 가 설정된 key 들 중 임의의 key 제거
# - allkeys-random : 모든 key 들 중 임의의 key 제거
# - volatile-ttl : expire time(TTL)이 가장 적게 남은 key 제거 (minor TTL)
maxmemory-policy volatile-ttl

# RDB 설정 (주기적 백업)
# 15분 안에 최소 1개 이상의 key가 변경되었을 때
save 900 1
# 5분 안에 최소 10개 이상의 key가 변경되었을 때
save 300 10
# 60초 안에 최소 10000개 이상의 key가 변경되었을 때
save 60 10000

# AOF 설정 (쓰기에 대한 로그 파일 저장)
## AOF 사용 여부
# appendonly yes
# 저장할 AOF 파일명
# appendfilename appendonly.aof
# 디스크와 동기화 처리 방식
# - always : AOF 값을 추가할 때마다 fsync를 호출해서 디스크에 쓰기
# - everysec : 매초마다 fsync를 호출해서 디스크에 쓰기
# - no : OS가 실제 sync를 할 때까지 따로 설정하지 않음
# appendfsync everysec


## Replication 관련 설정
## Slave Redis 설정
#slaveof 127.0.0.1 6380

 

Redis 컨테이너를 새로 띄우고 확인해보자. 정상적으로 PONG 응답이 온다.

127.0.0.1:6379> ping
PONG

 

마지막으로 Spring 기동에 사용되는 .env 파일에도 redis_password 값을 넣고, 재기동하면 문제가 해결된다!