android에서 구글 로그인 연동하기

😊 들어가기 전에

안드로이드 앱에 구글 로그인 기능을 구현하려고 공식문서부터 많이 문서를 찾아보았지만 더이상 지원되지 않는 방식인 원탭에 대한 글이 대부분이었다. 

지원되지 않는다는 말을 보고 작동하지 않을 것이라고 생각했고, 어떻게 구현해야할지 막막하던 참에
기능이 잘 작동되어서 우선 구글 로그인 구현을 위한 순서를 정리해보았다! 이후 인증 관리자로 코드를 바꾸며 리펙토링을 할 예정이다.

아래처럼 원탭 로그인을 구현해보자~~

 

---

1️⃣ 원탭 로그인 클라이언트 구성하기

우리 앱에서는 Google 로그인을 사용하는 경우 setGoogleIdTokenRequestOptions ( )을 사용하여 Google ID 토큰 요청을 사용 설정하고 구성해주면 된다.

       //원탭 로그인 클라이언트 구성
        oneTapClient = Identity.getSignInClient(this)
        
        signInRequest = BeginSignInRequest.builder()
            .setGoogleIdTokenRequestOptions(
                BeginSignInRequest.GoogleIdTokenRequestOptions.builder()
                    .setSupported(true)
                    .setServerClientId(SERVER_CLIENT_ID)
                    .setFilterByAuthorizedAccounts(false)
                    .build()
            )
            .build()

 

- SignInClient는 로그인 api를 위한 client이다.

SignInClient는 sign-in (로그인) 과 sign-up (등록) 두 시나리오에서 같은 흐름을 공유하지만  BeginSignInRequest 에서는 다른 시나리오를 제공해야만 한다.

 

🔥 PasswordRequestOptions 로 구현 시 원탭 로그인 UI와 동작이 어떻게 다른지 비교해보기 

 

credential에 대한 설명

우선 credential 이라는 개념을 알고 아래의 설명을 보자
credential은 자격이 있는지 증명하기 위한 수단이라고 생각하면 된다. 

 

로그인(sign-in), 등록(sign-up)에서 다른 BeginSignInRequest를 사용한다.

 

- 존재하는 사용자는 로그인한다.

두 종류의 credentials은 SignInCredential 에서 지원한다.

 

- credential의 종류

1. Google Id token credential

2. Password credential

 

사용자에게 선택지를 주고, 로그인 비율을 높이기 위해서는 Google ID token과 password credential을 모두 사용하는 것을 권장한다고 한다.

 

1. 만약 username과 password 로그인을 제공하려면 요청시 PasswordRequestOptions 객체를 구성한다.

2. 만약 Google Id token을 사용한 로그인을 제공하려면 GoogleInTokenRequestOptions 객체를 구성한다.

 

로그인 시나리오를 위해 GoogleIDTokenRequestOptions.Builder.setFilterByAuthorizedAccounts를 true로 설정하는 것을 권장한다. 이를 통해 사용자는 credential 리스트가 보여지기 전에 인증될 수 있다.

효과 : 이미 앱에 등록된 계정이 존재하는 사용자가 새로운 계정을 생성하는 것을 방지할 수 있다.

 

BeginSignInRequest 는 로그인 시도에서 반환된 credential이 접근가능한 타입인지 필터링 하는데 사용된다.

각 코드 설명

 

// 1. SignInClient를 초기화한다.
//getSignInClient는 google play service에서 제공되며 원탭 로그인을 사용하기 위한 client를 생성한다.

oneTapClient = Identity.getSignInClient(this)

// 2. 원탭 로그인을 시작하기 위한 요청을 생성한다.

signInRequest = BeginSignInRequest.builder() // -> 새로운 요청을 만들기 위한 빌더 반환

    .setGoogleIdTokenRequestOptions(
        BeginSignInRequest.GoogleIdTokenRequestOptions.builder()
        
            .setSupported(true) // -> google id token이 지원되는지 여부
          
            .setServerClientId(SERVER_CLIENT_ID)    // -> google cloud console에서 생성한 서버용 Oauth 2.0 클라이언트 ID
          
            .setFilterByAuthorizedAccounts(false) 
            
            // 사용자가 앱에 이미 로그인되어있는 경우에만 원탭 로그인이 작동하도록,
            // true인 경우 로그인되어있지 않더라도 원탭 로그인 작동한다. 
      
            .build()
    )
    .build() // -> 설정한옵션으로 최종 SignInRequest 객체를 생성한다.

---

2️⃣ 로그인한 사용자 확인

🔥 이 과정은 어떻게 진행되는것인지 더 찾아보기

3️⃣ 원탭 로그인 UI 표시 

 

사용자가 로그인하지 않았고, 원탭 로그인 사용을 거부하지 않았다면 클라이언트 객체의 beginSignIn 메서드를 호출하고 반환되는 Task에 리스너를 연결해준다. 

 

사용자에게 저장된 앱 사용자 인증 정보가 있을 때  원탭 클라이언트는 성공 리스너를 호출한다.

🔥   앱 사용자 인증 정보란 ? 

 

성공 리스너의 task 결과에서 대기 중인 인텐트를 가져와 startIntentSenderForResult( ) 에 전달하여 원탭 로그인 UI를 시작한다.

 

사용자에게 저장된 사용자 인증 정보가 없는 경우 원탭 클라이언트는 실패 리스너를 호출한다. 별도의 조치는 필요하지 않다.

앱의 로그아웃 환경을 계속 표시해주면 된다. 

 

	binding.googleLoginBtn.setOnClickListener {
            // Begin the One Tap sign-in flow
            oneTapClient.beginSignIn(signInRequest)
                .addOnSuccessListener(this) { result ->
                    try {
                        // Start the One Tap UI
                        startIntentSenderForResult(
                            result.pendingIntent.intentSender, REQ_ONE_TAP,
                            null, 0, 0, 0, null
                        )
                    } catch (e: IntentSender.SendIntentException) {
                        Log.e("Google", "Couldn't start One Tap UI: ${e.localizedMessage}")
                    }
                }
                .addOnFailureListener(this) { e ->
                    // Handle failure (no saved credentials found)
                    Log.d("Google", e.localizedMessage)
                }
        }

---

4️⃣ 사용자 응답 처리 

원탭 로그인 메시지에 대한 사용자의 응답은 Activity의 onActivityResult 메서드를 사용하여 앱에 보고된다. 

사용자가 로그인을 선택한 경우 저장된 사용자 인증 정보가 결과에 표시된다. 

사용자가 원탭 UI를 닫거나 로그인을 거부하면 RESULT_CANCELED 코드와 함께 결과가 반환된다. 이 두가지를 모두 처리해줘야한다.

 

가져온 사용자 인증 정보로 로그인

사용자가 앱과 사용자 인증 정보를 공유하기로 선택한 경우 onActivityResult ( )의 인텐트 데이터를 원탭 클라이언트의 getSignInCredentialFromIntent( ) 메서드에 전달하여 사용자 인증 정보를 검색할 수 있다.

 

사용자가 앱과 google 계정 사용자 인증 정보를 공유한 경우에는 사용자 인증 정보에 null 이 아닌 googleIdToken 속성이 있고, 사용자가 저장된 비밀번호를 공유한 경우에는 null 아닌 password 속성이 있다.

 

사용자 인증 정보를 사용하여 앱의 백엔드에 인증한다.

🔥   이 때 서버에 인증정보를 보내주는 것인가??

- 사용자 이름과 비밀번호 쌍을 가져온 경우 사용자가 수동으로 제공한 것과 동일한 방식으로 로그인한다.

- google 계정 사용자 인증 정보를 가져왔으면 ID 토큰을 사용하여 백엔드에 인증한다.

 

  // 4. 사용자 응답 처리
    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        when (requestCode) {
            REQ_ONE_TAP -> {
                try {
                    val credential = oneTapClient.getSignInCredentialFromIntent(data)
                    val idToken = credential.googleIdToken
                    val username = credential.id
                    val password = credential.password
                    
                    when {
                        idToken != null -> {
                            // Handle successful sign-in
                            Log.d("Google", "Got ID token: $idToken")
                            // You can now use this ID token for authentication or other purposes
                        } 
                        password != null -> {
                            Log.d("Google","Got password")
                        }
                        else -> {
                            Log.d("Google","no id token or password")
                        }
                    }
              
                } 
            }
        }
    }

 

---

원탭 UI 표시 중지

 

사용자가 로그인을 거부한 경우 getSignInCredentialFromIntent( )를 호출하면 CommonStatusCodes.CANCELDED 상태 코드와 함께 ApiException이 발생한다. 이 경우에는 원탭 로그인 UI를 일시적으로 사용 중지하여 사용자들로 하여금 불편한 감정을 느끼게 하지 않도록 해야한다. 

 

원탭 로그인 메시지의 비율 제한을 직접 구현하는 것이 좋다. 아니면 사용자가 여러 메시지를 연속으로 취소하면 원탬 클라이언트는 24시간 쿨다운 기간이 발생하여 원탭 로그인 UI가 표시되지 않는다.

catch (e: ApiException) {
                    when (e.statusCode) {
                        CommonStatusCodes.CANCELED-> {
                            Log.d("구글","원탭 다이얼러그 was closed")
                            showOneTapUI = false
                        }
                    }

 

정확히 어떤 작업을 하는지 로그로 확인하기 위해 원탭 UI 창을 여러 번 탭했더니 갑자기 로그인 창이 뜨지 않는다...! 

에러 내용을 확인해보니  16: Caller has been temporarily blocked due to too many canceled sign-in prompts. 

공식문서를 확인해보니 쿨다운 기간이 발생한 것이었다! 

 

원탭 다이얼로그 창을 닫으면 아래의 로그가 뜬다.

---

5️⃣  로그아웃 처리

signOut 메서드를 호출하면 된다.

    // 5. 로그아웃  처리 
        binding.googleLoginOutBtn.setOnClickListener{

            oneTapClient.signOut()

        }

 

 

🔥다음 이야기

공식에서 권장하는 인증 관리자를 사용하여 구글 로그인을 구현하는 방법을 사용해보자.

또한 원탭 로그인 UI 중 google ID token이 아니라 password credential를 사용해서 구현해보도록 한다.