[AWS] Cognito로 사용자 인증하기 (회원가입부터 탈퇴까지)

사용자가 회원가입을 할 때 username(userId)과 간단한 정보만 DB에 저장하고, 비밀번호는 AWS Cognito에 저장하도록 할 것이다.

 

AWS Cognito 란 ? 

이 부분에 대해 정리한 글이 있기 때문에 자세한 설명은 생략하고,

사용자 풀을 사용해 인증하고 있는 구조를 활용한다 ! 라는 것만 확인하고 넘어가자. 

 

✳️ 사용자 풀을 사용한 인증

 

🔷 인증 흐름 

• 사용자 등록 (Sign Up)
  • 사용자가 사용자 풀에 등록
  • 사용자 이름, 비밀번호, 이메일/전화번호 등의 사용자 속성 입력
  • 이메일 또는 전화번호를 통해 verification code를 받아 등록 완료
• 사용자 인증 (Sign In)
  • 등록된 사용자가 사용자 이름과 비밀번호로 인증
  • 인증 성공 시, ID 토큰, accessToken, refreshToken 반환
  • 토큰은 JWT 형식이며 인증된 사용자의 정보를 담고 있음
• 인증 토큰 발급
  • ID 토큰 : 사용자의 인증 상태 및 속성 포함
  • accessToken : 어플리케이션에서 보호된 리소스에 액세스하는 데 사용
  • refreshToken : accessToken과 ID 토큰 갱신하는 데 사용
• 토큰 갱신
  • accessToken과 ID Token이 만료되면 refreshToken을 사용해 새 토큰 요청

 

build.gradle에 추가

 

 

 

사용자 등록 - signUp

✳️ signUp

CognitoIdentityProviderAsyncClient (AWS SDK for Java - 2.30.2)

signUp 메서드

• Amazon Cognito User Pools에서 사용자를 등록하는 기능 제공 
• SMS 및 이메일을 사용해 인증 과정 생성 가능
• 사용자 이름, 비밀번호, 사용자 속성을 지정된 User Pool에 등록 가능
• SignUpRequest는 사용자를 등록하기 위한 요청 객체로, 사용자 이름, 비밀번호, 속성 등 포함

SignUpRequest

 

 

 

 

---

✳️adminConfirmSignUp

CognitoIdentityProviderAsyncClient (AWS SDK for Java - 2.30.2)

 

https://docs.aws.amazon.com/ko_kr/cognito-user-identity-pools/latest/APIReference/API_AdminConfirmSignUp.html

AdminConfirmSignUp - Amazon Cognito User Pools

 

adminConfirmSignUp

• 관리자 권한을 통해 가입 확인 처리
• 사용자가 가입 확인 코드 입력 필요없이 바로 활성화됨
• IAM 자격 증명을 통해 권한을 부여받아야 하며 해당 권한을 부여받은 후 메서드 실행
• 사용자 풀에서 새 사용자가 가입할 때, 가입 확인을 위해 코드를 입력하는 대신 이 API를 사용하여 관리자가 직접 승인 처리

 

 

AdminConfirmSignUpRequest

 

---

🌟 두 메서드의 차이 

🔸 signUp
- 일반 사용자가 자신의 계정을 직접 생성할 때 사용
- Cognito는 자동으로 가입 확인 코드를 전송하여 사용자가 이메일 또는 SMS를 통해 인증
- 가입 후 사용자는 Cognito에서 제공하는 확인 코드를 입력해야만 계정 활성화됨 

🔸 adminConfirmSignUp
- 관리자가 사용자의 가입을 직접 승인할 때 사용
- 사용자가 가입할 때 가입 확인 코드를 입력할 필요 없이 관리자가 이 API 를 통해 직접 사용자 계정 활성화 

👉 signUp 실행 완료 후 adminConfirmSignUp을 실행하는 흐름으로 진행했다. 사용자가 가입 신청을 하되, 가입 확인 코드를 생략하고 관리자가 가입을 승인하는 방식이다. 

 

 

 

사용자 로그인 & 리프레쉬 토큰 - initiateAuth 

사용자의 로그인을 시작하는 기능 
👉 사용자가 Cognito User Pool에 로그인하도록 요청

✳️ initiateAuth

AuthFlowType

• 로그인 시에는 authFlowType에 USER_PASSWORD_AUTH로 선택 
• 로그인 유지를 위해서는 REFRESH_TOKEN_AUTH 또는 REFRESH_TOKEN 사용 
  기존에 받은 Refresh Token을 사용하여 새로운 ID 및 access token 발급

 

 

사용자 로그아웃 - adminUserGlobalSignOut

사용자가 로그인한 모든 세션을 강제로 로그아웃시키는 기능 

 

✳️ adminUserGlobalSignOut

AdminUserGlobalSignOut - Amazon Cognito User Pools

 

adminUserGlobalSignOut

 

 

 

사용자 업데이트 - adminUpdateUserAttributes

특정 사용자의 속성 업데이트하는 기능 

✳️ adminUpdateUserAttributes

AdminUpdateUserAttributes - Amazon Cognito User Pools

 

 

 

 

사용자 삭제 - adminDeleteUser

해당 사용자를 관리자 권한으로 삭제하는 작업 수행

 

✳️ adminDeleteUser

CognitoIdentityProviderAsyncClient (AWS SDK for Java - 2.30.2)

 

https://docs.aws.amazon.com/ko_kr/cognito-user-identity-pools/latest/APIReference/API_AdminDeleteUserAttributes.html

AdminDeleteUserAttributes - Amazon Cognito User Pools

 

 

adminDeleteUser

 

• 호출 전후로 성능 메트릭 수집
• 요청 및 응답 처리하는 핸들러 설정

 

 

비밀번호 초기화 

사용자의 비밀번호 설정

 

✳️ adminSetUserPassword

AdminSetUserPassword - Amazon Cognito User Pools

• 특정 사용자 풀의 사용자의 비밀번호 설정하는 기능

 

✳️ respondToAuthChallenge

RespondToAuthChallenge - Amazon Cognito User Pools

 

• 사용자 풀에서 인증 과정 중 발생하는 challenge(추가 인증)에 대한 응답 제공
• 챌린지 예시
  • MFA (Multi-Factor Authentication) : 사용자가 비밀번호를 입력하면 OTP 입력 요구
  • NEW_PASSWORD_REQUIRED : 관리자가 임시 비밀번호를 설정한 경우, 사용자가 로그인하면 새로운 비밀번호 설정
  • DEVICE_VERIFICATION : 기기인증 코드 입력 요구
  • CUSTOM_CHALLENGE : 개발자가 직접 정의한 보안 절차 추가

 

 

 

 

참고자료 

https://docs.aws.amazon.com/ko_kr/cognito/latest/developerguide/authentication.html

https://docs.aws.amazon.com/ko_kr/cognito-user-identity-pools/latest/APIReference/API_SignUp.html