📌 Spring Boot 네이버 로그인 연동

📅 2025-05-14

---

📝 학습 내용

• 네이버 OAuth2 로그인 연동 (Spring Boot 3.x)
• Access Token 발급 및 사용자 정보 요청
• RestTemplate을 통한 외부 API 호출
• 사용자 정보 DTO 매핑 및 Thymeleaf 연동

---

1️⃣ 네이버 애플리케이션 등록

• 네이버 개발자센터 → 애플리케이션 등록
• 필수 설정:
  • 사용 API: ✅ 네이버 로그인
  • 환경 추가: PC 웹
    • 서비스 URL: http://localhost:8090
    • Callback URL: http://localhost:8090/naver/callback
• 발급 정보 확인:
  • Client ID, Client Secret
• 사용자 정보 제공 항목 선택 (이름, 이메일 등)

---

2️⃣ 로그인 요청 URL 구성

https://nid.naver.com/oauth2.0/authorize?
response_type=code
&client_id=YOUR_CLIENT_ID
&redirect_uri=http%3A%2F%2Flocalhost%3A8090%2Fnaver%2Fcallback
&state=STATE_STRING

---

3️⃣ Access Token 발급 요청

✅ 요청 URL

https://nid.naver.com/oauth2.0/token

✅ 파라미터

이름	설명
grant_type	authorization_code
client_id	발급받은 Client ID
client_secret	발급받은 Client Secret
code	callback으로 받은 code
state	callback으로 받은 state
redirect_uri	콜백 URI (등록된 것과 동일해야 함)

---

4️⃣ 사용자 정보 요청

✅ 요청 URL

https://openapi.naver.com/v1/nid/me

• Authorization 헤더에 Bearer access_token 추가 필요
• 응답 JSON 구조 (예시):

{
  "resultcode": "00",
  "message": "success",
  "response": {
    "id": "example_user_id",
    "profile_image": "https://example.com/image.png",
    "email": "user@example.com",
    "name": "홍길동"
  }
}

---

5️⃣ 전체 컨트롤러 코드 (Spring Boot)

package com.example.demo.C05Naver;

import lombok.Data;
import lombok.extern.slf4j.Slf4j;
import org.springframework.http.*;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.client.RestTemplate;

@Controller
@Slf4j
@RequestMapping("/naver")
public class C01NaverLoginController {

    private String NAVER_CLIENT_ID = "YOUR_CLIENT_ID";
    private String NAVER_CLIERNT_SECRET = "YOUR_CLIENT_SECRET";
    private String REDIRECT_URL = "http://localhost:8090/naver/callback";
    private NaverTokenResponse naverTokenResponse;

    @GetMapping("/login")
    public String login() {
        log.info("GET /naver/login...");
        return "redirect:https://nid.naver.com/oauth2.0/authorize?response_type=code&client_id="
                + NAVER_CLIENT_ID + "&state=STATE_STRING&redirect_uri=" + REDIRECT_URL;
    }

    @GetMapping("/callback")
    public String callback(@RequestParam("code") String code,
                           @RequestParam("state") String state) {
        log.info("GET /naver/callback | code: {}, state: {}", code, state);

        String url = "https://nid.naver.com/oauth2.0/token";
        HttpHeaders header = new HttpHeaders();
        MultiValueMap<String, String> params = new LinkedMultiValueMap<>();
        params.add("grant_type", "authorization_code");
        params.add("client_id", NAVER_CLIENT_ID);
        params.add("client_secret", NAVER_CLIERNT_SECRET);
        params.add("code", code);
        params.add("state", state);

        HttpEntity<MultiValueMap<String, String>> entity = new HttpEntity<>(params, header);
        RestTemplate rt = new RestTemplate();
        ResponseEntity<NaverTokenResponse> response =
                rt.exchange(url, HttpMethod.POST, entity, NaverTokenResponse.class);

        this.naverTokenResponse = response.getBody();
        return "redirect:/naver/main";
    }

    @GetMapping("/main")
    public void main(Model model) {
        log.info("GET /naver/main...");

        String url = "https://openapi.naver.com/v1/nid/me";
        HttpHeaders header = new HttpHeaders();
        header.add("Authorization", "Bearer " + this.naverTokenResponse.getAccess_token());

        HttpEntity<?> entity = new HttpEntity<>(header);
        RestTemplate rt = new RestTemplate();
        ResponseEntity<NaverProfileResponse> response =
                rt.exchange(url, HttpMethod.POST, entity, NaverProfileResponse.class);

        model.addAttribute("profile", response.getBody());
    }

    @Data
    private static class NaverTokenResponse {
        public String access_token;
        public String refresh_token;
        public String token_type;
        public String expires_in;
    }

    @Data
    private static class Response {
        public String id;
        public String profile_image;
        public String email;
        public String name;
    }

    @Data
    private static class NaverProfileResponse {
        public String resultcode;
        public String message;
        public Response response;
    }
}

---

6️⃣ Thymeleaf 뷰 (main.html)

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="UTF-8">
    <title>Naver Login</title>
</head>
<body>
<h1>NAVER MAIN</h1>
<hr>

<p>이름: <span th:text="${profile.response.name}">이름</span></p>
<p>이메일: <span th:text="${profile.response.email}">이메일</span></p>
<img th:src="${profile.response.profile_image}" alt="프로필 이미지" />

</body>
</html>

---

🔥 요약

단계	설명
1단계	네이버 앱 등록
2단계	로그인 URL로 리다이렉트
3단계	Callback에서 code 수신
4단계	Access Token 발급
5단계	사용자 정보 요청 및 출력

---

🔗 참고 자료

• 네이버 개발자센터 로그인
• Spring 공식 RestTemplate 문서

---