블로그 Help

Social 로그인 구현 (Spring Security)

개요

Spring Security를 사용하여 Social 로그인을 구현하는 방법에 대해 간단히 알아보겠습니다.

Google 로그인 구현

Google Oauth2은 Spring Security에서 기본적으로 지원하는 Oauth2 제공자 중 하나입니다. 구현하는 것은 매우 간단합니다.

Google API Console에서 프로젝트 생성

  1. Google API Console에 접속합니다.

  2. 사용자 인증 정보 > 사용자 인증 정보 만들기를 클릭합니다.

    사용자 인증 정보 만들기.png

  3. OAuth 클라이언트 ID를 선택합니다.

  4. 웹 애플리케이션을 선택하고 이름을 입력합니다.

  5. 승인된 JavaScript 원본과 승인된 리디렉션 URI를 입력합니다.

    • 승인된 JavaScript 원본: 브라우저에서 JavaScript를 사용하여 Google API를 호출할 때 사용하는 도메인입니다. (예: https://localhost:9000)

    • 승인된 리디렉션 URI: 사용자가 인증을 완료하면 Google이 사용자를 리디렉션하는 URI입니다. (예: https://localhost:9000/login/oauth2/code/google)

  6. 만들기를 클릭합니다.

OAuth 클라이언트 ID 만들기.png

Spring Boot 프로젝트 설정

기본 SecurityFilterChain에 Oauth2LoginConfigurer를 추가하여 Google 로그인을 구현합니다.

@Bean public SecurityFilterChain defaultSecurityFilterChain(HttpSecurity http) throws Exception { return http .authorizeHttpRequests(request -> request .requestMatchers(HttpMethod.POST, "/api/users", "/login").permitAll() .anyRequest().authenticated()) // CSRF 보호 기능을 비활성화합니다. .csrf(AbstractHttpConfigurer::disable) .formLogin(Customizer.withDefaults()) # ----------------- 추가 ----------------- .oauth2Login(Customizer.withDefaults()) # ---------------------------------------- .build(); }

application.yml 설정

application.yml 파일에 Google 로그인을 위한 설정을 추가합니다.

spring: security: oauth2: client: registration: google: provider: google # Google API Console에서 발급받은 클라이언트 ID client-id: { google-client-id } # Google API Console에서 발급받은 클라이언트 비밀번호 client-secret: { google-client-secret }

Google 로그인 테스트

  1. Spring Boot 프로젝트를 실행합니다.

  2. 로그인 페이지로 이동합니다. (예: https://localhost:9000/login)

  3. Google 버튼을 클릭하여 Google 로그인을 테스트합니다.

또는

  1. Spring Boot 프로젝트를 실행합니다.

  2. 다이렉트로 Google 로그인 URL로 이동합니다. (예: https://localhost:9000/oauth2/authorization/google)

Kakao 로그인 구현

Kakao 로그인은 Spring Security에서 기본적으로 지원하지 않습니다. Google 로그인과는 다르게 구현하는 방법이 다소 복잡합니다.

Kakao Developers에서 프로젝트 생성

  1. Kakao Developers에 접속합니다.

  2. 내 애플리케이션 > 애플리케이션 추가를 클릭합니다.

  3. 애플리케이션 이름을 입력하고 애플리케이션 만들기를 클릭합니다.

  4. 플래폼 > Web을 선택합니다. 사이트 도메인을 입력합니다.

    • 사이트 도메인: 애플리케이션을 사용하는 웹 사이트의 도메인입니다. (예: https://localhost:9000)

  5. 카카오 로그인 > 활성화 설정을 ON으로 변경합니다.

  6. OpenID Connect > 활성화 설정을 ON으로 변경합니다.

  7. Redirect URI를 입력합니다.

    • Redirect URI: 사용자가 인증을 완료하면 Kakao가 사용자를 리디렉션하는 URI입니다. (예: https://localhost:9000/login/oauth2/code/kakao)

  8. 앱 키에서 REST API 키를 확인합니다. REST API 키는 클라이언트 ID와 같습니다.

  9. 보안 > Client Secret 코드를 생성 및 확인합니다. Client Secret는 클라이언트 비밀번호와 같습니다.

application.yml 설정

application.yml 파일에 Google 로그인을 위한 설정을 추가합니다.

spring: security: oauth2: client: registration: google: client-id: { google-client-id } client-secret: { google-client-secret } # ----------------- 추가 ----------------- kakao: client-id: REST_API_KEY client-secret: CLIENT_SECRET provider: kakao: issuer-uri: "https://kauth.kakao.com" # ----------------------------------------

Naver 로그인도 Spring Security에서 기본적으로 지원하지 않습니다. 뿐만 아니라 Naver 로그인은 OpenID Connect를 지원하지 않습니다. 따라서 Naver 로그인을 구현하려면 더 많은 설정이 필요합니다.

  1. Naver Developers에 접속합니다.

  2. 애플리케이션 이름을 입력합니다.

  3. 필요한 개인정보 수집 항목을 선택합니다.

  4. 로그인 오픈 API 서비스 환경(PC 웹 브라우저)를 선택합니다.

    • 서비스 환경: 로그인을 사용할 환경을 선택합니다. (예: PC 웹 브라우저)

    • 서비스 URL: 서비스를 사용하는 웹 사이트의 URL입니다. (예: https://localhost:9000)

    • Callback URL: 사용자가 인증을 완료하면 Naver가 사용자를 리디렉션하는 URI입니다. (예: https://localhost:9000/login/oauth2/code/NAVER)

  5. 약관을 확인하고 애플리케이션 등록을 클릭합니다.

  6. 애플리케이션 정보에서 Client ID와 Client Secret를 확인합니다.

application.yml 파일에 Naver 로그인을 위한 설정을 추가합니다.

client: registration: google: client-name: "Google 로그인" client-id: { google-client-id } client-secret: { google-client-secret } kakao: client-name: "KAKAO 로그인" client-id: { kakao-client-id } client-secret: { kakao-client-secret } # ----------------- 추가 ----------------- NAVER: client-name: "NAVER 로그인" client-id: { naver-client-id } client-secret: { naver-client-secret } authorization-grant-type: "authorization_code" redirect-uri: "https://localhost:9000/login/oauth2/code/NAVER" # ---------------------------------------- provider: kakao: issuer-uri: "https://kauth.kakao.com" # ----------------- 추가 ----------------- NAVER: authorization-uri: "https://nid.naver.com/oauth2.0/authorize" token-uri: "https://nid.naver.com/oauth2.0/token" user-info-uri: "https://openapi.naver.com/v1/nid/me" user-name-attribute: "response" # ----------------------------------------

마무리

Spring Security를 사용하여 Social 로그인을 구현하는 방법에 대해 간단히 알아보았습니다. Google 로그인은 Spring Security에서 기본적으로 지원하며 Kakao 로그인과 Naver 로그인은 추가 설정이 필요합니다. Social 로그인을 구현하면 사용자가 손쉽게 로그인할 수 있으며 사용자 정보를 가져와서 사용할 수 있습니다.

참고

Last modified: 25 January 2025
HELLO!Spring AuthorizationServer를 사용한 OAuth2 인증 서버 구축 (1)