📌 카카오 로그인 API 연동 - 1단계: 인가 코드 받기

📅 날짜

2025-05-13

📝 학습 내용

✅ 1. 왜 백엔드에서 카카오 로그인을 구현해야 할까?

• JavaScript SDK를 활용하면 프론트 단에서 로그인 처리가 가능하지만, client_id 노출 및 토큰 탈취 위험이 있기 때문에 Spring Boot 같은 백엔드 서버에서 처리하는 REST 방식이 권장됨.
  

---

✅ 2. 카카오 로그인 OAuth2 흐름 요약

카카오 로그인 과정

---

✅ 3. 카카오 개발자 콘솔 설정

1. 카카오 로그인 활성화
2. Redirect URI 등록 → http://localhost:8090/kakao/callback
3. 필수 동의 항목 설정
   • 닉네임 (profile_nickname)
   • 프로필 사진 (profile_image)
   • 이메일 (account_email)

---

✅ 4. 인가 코드 요청 URL 구성

파라미터	설명	필수 여부
client_id	카카오 앱의 REST API 키	✅
redirect_uri	인가 코드 수신 주소 (콘솔에 등록 필요)	✅
response_type	"code"로 고정	✅

예시 URL:

https://kauth.kakao.com/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost:8090/kakao/callback&response_type=code

---

✅ 5. Spring Boot 인가 코드 요청 및 수신 코드

package com.example.demo.C04Kakao;

import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
@Slf4j
@RequestMapping("/kakao")
public class C02KakaoLoginController {

    // 실제 발급된 키는 보안상 외부에 노출하지 않도록 주의
    String REDIRECT_URI = "http://localhost:8090/kakao/callback";
    String CLIENT_ID = "YOUR_CLIENT_ID"; // 실제 키는 외부 노출 금지
    String RESPONSE_TYPE = "code";

    // 1단계: 사용자 인가 요청 (카카오 로그인 창 리디렉트)
    @GetMapping("/getCode")
    public String getCode() {
        log.info("GET /kakao/getCode...");
        return "redirect:https://kauth.kakao.com/oauth/authorize?client_id=" + CLIENT_ID
                + "&redirect_uri=" + REDIRECT_URI
                + "&response_type=" + RESPONSE_TYPE;
    }

    // 2단계: 카카오에서 인가 코드를 받아오는 콜백
    @GetMapping("/callback")
    public void callback(@RequestParam("code") String code) {
        log.info("GET /kakao/callback... 인가 코드 수신: " + code);
        // TODO: 이후 Access Token 요청 단계에서 이 code 사용
    }
}

---

🔹 테스트 시나리오

1. 브라우저에 입력:

http://localhost:8090/kakao/getCode

1. → 카카오 로그인 및 동의 진행
2. → 서버 콘솔 출력 예:

GET /kakao/callback... 인가 코드 수신: abcde12345xyz...

---

🔥 정리

• 카카오 로그인 REST 연동 시 첫 단계는 인가 코드 수신
• Redirect URI는 카카오 콘솔과 백엔드 코드 양쪽에서 정확히 일치시켜야 함
• 받은 인가 코드는 다음 단계에서 Access Token 요청에 사용됨

---

🔗 참고 자료

• 카카오 로그인 공식 문서
• Spring Security OAuth2 Login

---