redis를 사용한 리프레시 토큰과 함께 인증 시퀀스 완성

[jagaldol]

Summary

redis의 경우 도커로 띄웠고, 액세스 토큰과 리프레시 토큰을 구현 완료 하였습니다. api 적인 관점에서는

• 회원가입
• 로그인
• 로그아웃
• 토큰 재발급

총 4가지의 api를 구현하였습니다.

Description

redis

redis의 경우 docker-compose-redis.yml을 통해 컨테이너를 만들었습니다. 개발/ 배포 profile에 전부 redis 설정을 집어 넣었습니다.

$ docker-compose -f docker-compose-redis.yml up

명령어로 레디스 컨테이너를 실행하실 수 있습니다. 혹은, intelliJ의 run configuration으로도 설정가능합니다.

redis에 직접 접근하여 값을 보고 싶은 경우,

$ docker exec -it redis redis-cli
127.0.0.1:6379> keys *
(empty array)
                                                     #  로그인 진행 후
127.0.0.1:6379> keys *
1) "1"
127.0.0.1:6379> get 1
"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiIxIiwidHlwZSI6InJlZnJlc2giLCJleHAiOjE2OTgzNDc2NzR9.P71t6HS1NHKsUmTSpmthEnzN0Md2WMdbcTP10Udkg3N5kNOtjO8WgKQII3L2G8hF-Gw3TnvuoYXBOXfRVM3WKg"
127.0.0.1:6379> del 1
(integer) 1
127.0.0.1:6379> keys *
(empty array)

위와 같이 파악한 명령어는 keys, get, del이 있습니다.

레디스는 key-value로 값을 저장되기 때문에, 회원 ID(PK)를 key로 하여 refresh 토큰을 value로 저장합니다.

API

테스트의 용이성을 위해 data.sql에 김볼링을 더미 데이터로 집어넣었습니다.

• 이메일: test@test.com
• 비밀번호: test12!@ 로 로그인 가능합니다.

---

• 로그인을 구현했습니다.
  • 액세스 토큰과 리프레시 토큰을 발급하며 리프레시 토큰은 레디스에 저장합니다.
  • JWT의 구조를 변경하여 type이라는 claim을 추가하였습니다.
  • JWT verify로 decode를 할 때, type을 파라미터로 받아 타입이 일치하지 않으면 Exception이 발생하도록 구현하였습니다.
  • 인증과정에서 id(claim)이 subject로 변경되었었는데, 여전히 claim의 id를 접근하던 버그를 수정했습니다.
• 로그아웃을 구현했습니다.
  • 로그아웃 시, 쿠키를 만료 시키며, 레디스의 리프레시 토큰을 삭제합니다.
• 토큰 재발급을 구현했습니다.
  • 재발급은 아이디, 비밀번호 대신 리프레시 토큰으로 인증하여 로그인하는 것과 같습니다.(똑같이 액세스, 리프레시 발급함)
  • 따라서 로그인 api와 구조가 유사합니다.
  • 기존의 리프레시 토큰의 경우는, 새로 발급한 토큰이 기존 토큰 위에 덮어씌워져서 사라지므로 기존 토큰 삭제 로직은 별도로 필요가 없습니다.
• 회원가입을 구현했습니다.
  • 유효성 검사 정규식과 제약들을 작성했습니다. 다른 api 제작 시 참고 부탁드립니다.
  • 닉네임이 원래 중복 허용이 되었는데 닉네임으로 검색 시 같은 닉네임이 있으면 안될 거 같아 unique 제약을 추가하였습니다.
  • 이제 닉네임은 중복 불가이며 입력 필수입니다.
• 성공 응답이 201로 명세가 되어 있어 success에도 상태코드 변경이 가능하도록 확장시켰습니다.
• 토큰의 만료 시간을 application.yml에서 관리하게 변경하였습니다.
  • 개발 서버의 경우, 액세스 2일, 리프레시 30일 / 배포 서버의 경우, 액세스 10분, 리프레시 30일입니다.

프론트 측에서 회원가입/로그인 api를 요청하여서 review가 안된 코드지만, 일단 이 브랜치를 기준으로 바로 배포 중입니다.

노션의 BE 아카이브에 가이드를 추가하였으니 이것도 확인 부탁드립니다!

• 🐋도커 redis 서버 실행
• 🚀로그인 관련 포스트맨 설정법

Related Issue

Issue Number: close #11