[java] Google Guice와 OAuth 인증 및 인가 구현하기

20 Nov 2023

java

이번 글에서는 Google Guice를 사용하여 OAuth 인증 및 인가를 구현하는 방법을 알아보겠습니다. OAuth는 많은 웹 애플리케이션에서 사용되는 인증 프로토콜이며, 사용자가 기존의 계정을 통해 다른 애플리케이션에 접근할 수 있도록 합니다. Google Guice는 의존성 주입(Dependency Injection) 프레임워크로서, 애플리케이션의 객체들 간의 관계를 쉽게 관리할 수 있게 도와줍니다.

1. Google API Console에서 애플리케이션 등록하기

먼저, OAuth를 사용하기 위해 Google API Console에서 애플리케이션을 등록해야 합니다. 등록 과정은 아래와 같습니다.

Google API Console에 로그인합니다.
‘사용자 인증 정보 만들기’를 선택합니다.
‘OAuth 클라이언트 ID’를 선택합니다.
‘애플리케이션 유형’을 선택하고, 필요한 정보를 입력합니다.
‘스크린샷 추가’ 및 ‘OAuth 동의 화면 설정’을 선택합니다.
‘제출’을 클릭하여 애플리케이션을 등록합니다.

2. Maven Dependency 추가하기

OAuth 인증 및 인가를 위해 필요한 라이브러리를 Maven dependency로 추가합니다.

<dependency>
    <groupId>com.google.oauth-client</groupId>
    <artifactId>google-oauth-client</artifactId>
    <version>1.32.1</version>
</dependency>
<dependency>
    <groupId>com.google.inject</groupId>
    <artifactId>guice</artifactId>
    <version>4.2.2</version>
</dependency>

3. Guice Module 작성하기

OAuth 인증 및 인가를 처리하는 Guice Module을 작성합니다.

import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.inject.AbstractModule;
import com.google.inject.Provides;

import java.io.File;
import java.io.IOException;
import java.security.GeneralSecurityException;

public class OAuthModule extends AbstractModule {

    @Provides
    public HttpTransport provideHttpTransport() throws GeneralSecurityException, IOException {
        return GoogleNetHttpTransport.newTrustedTransport();
    }

    @Provides
    public JsonFactory provideJsonFactory() {
        return JacksonFactory.getDefaultInstance();
    }

    @Provides
    public GoogleClientSecrets provideClientSecrets(JsonFactory jsonFactory) throws IOException {
        File clientSecretsFile = new File("client_secret.json");
        return GoogleClientSecrets.load(jsonFactory, clientSecretsFile);
    }

    @Provides
    public GoogleAuthorizationCodeFlow provideAuthorizationCodeFlow(HttpTransport httpTransport, JsonFactory jsonFactory, GoogleClientSecrets clientSecrets) throws IOException {
        return new GoogleAuthorizationCodeFlow.Builder(httpTransport, jsonFactory, clientSecrets, Collections.singleton("https://www.googleapis.com/auth/userinfo.email"))
                .setAccessType("offline")
                .build();
    }

}

위의 모듈은 HttpTransport, JsonFactory, GoogleClientSecrets, GoogleAuthorizationCodeFlow 객체를 제공합니다. GoogleAuthorizationCodeFlow 객체는 토큰 교환 및 인증 코드 요청을 처리하기 위해 사용됩니다.

4. Guice 핵심 모듈에 OAuthModule 추가하기

Guice의 주요 모듈에 OAuthModule을 추가하여 애플리케이션에서 사용할 수 있게 합니다.

import com.google.inject.Guice;
import com.google.inject.Injector;

public class MyApp {

    public static void main(String[] args) {
        Injector injector = Guice.createInjector(new OAuthModule());

        // 애플리케이션 코드 작성
    }

}

5. 인증 및 인가 흐름 구현하기

OAuth 인증과 인가 흐름은 각 애플리케이션에 따라 달라질 수 있습니다. 일반적으로는 인증 URL을 생성하여 사용자를 리다이렉트시키고, 사용자가 인증을 마치면 인가 코드를 받아와 토큰 교환을 수행합니다. 구체적인 흐름은 공식 문서 등에서 확인할 수 있습니다.

결론

이제 Google Guice와 OAuth를 사용하여 애플리케이션에 인증 및 인가 기능을 구현하는 방법에 대해 알아보았습니다. Google Guice는 의존성 주입을 통해 객체 관리를 용이하게 하며, OAuth를 사용하여 사용자 인증 및 인가를 구현할 수 있습니다. 추가적인 자세한 내용은 Google API 문서 등을 참고하시기 바랍니다.

참고 자료

Google API Console: https://console.cloud.google.com/
Google OAuth 클라이언트 라이브러리: https://developers.google.com/api-client-library/java/google-oauth-java-client
Google Guice: https://github.com/google/guice