안녕하세요, HM소프트입니다.
오늘은 카카오 로그인(카카오 OAuth) 연동을 실제 프로젝트에 적용했던 경험을 공유합니다.
1. 왜 카카오 로그인인가
한국에서 서비스를 운영한다면 카카오 로그인은 거의 필수입니다.
카카오톡 사용자가 4,700만 명 이상이고, 별도 회원가입 없이 로그인할 수 있어 전환율이 크게 올라갑니다.
실제로 제가 개발한 의료 플랫폼 프로젝트에서 카카오 로그인 도입 후 회원가입 전환율이 눈에 띄게 상승했습니다.
2. 카카오 개발자 등록 절차
카카오 로그인을 연동하려면 먼저 Kakao Developers에서 애플리케이션을 등록해야 합니다.
순서는 다음과 같습니다.
Kakao Developers 사이트 접속 후 로그인
내 애플리케이션 메뉴에서 애플리케이션 추가하기
앱 이름, 사업자명 입력
플랫폼 등록 (웹의 경우 사이트 도메인 입력)
카카오 로그인 활성화
동의항목 설정 (이메일, 프로필 정보 등)
Redirect URI 등록
여기서 주의할 점은 Redirect URI를 정확하게 입력해야 한다는 것입니다. 개발 환경과 운영 환경의 URI를 모두 등록해 두세요.
3. 전체 인증 흐름
카카오 로그인의 OAuth 2.0 인증 흐름은 다음과 같습니다.
사용자가 카카오 로그인 버튼 클릭
-> 카카오 인증 페이지로 리다이렉트
-> 사용자가 카카오 계정으로 로그인 및 동의
-> 카카오가 Redirect URI로 인가 코드(authorization code) 전달
-> 백엔드에서 인가 코드로 액세스 토큰 요청
-> 액세스 토큰으로 사용자 정보 조회
-> 자체 서비스의 JWT 토큰 발급 후 로그인 처리
4. 프론트엔드 구현
프론트엔드에서는 카카오 JavaScript SDK를 사용하거나 직접 REST API를 호출할 수 있습니다.
SDK 방식은 간편하지만, REST API 방식이 더 유연합니다.
저는 REST API 방식을 선호합니다. 카카오 인증 URL을 직접 구성해서 리다이렉트하는 방식입니다.
인증 URL 구성 시 필요한 파라미터는 client_id(REST API 키), redirect_uri, response_type(code 고정)입니다.
5. 백엔드 구현
백엔드에서 처리해야 할 핵심 로직은 세 가지입니다.
첫째, 인가 코드로 액세스 토큰을 교환합니다.
카카오 토큰 발급 API를 호출하면 access_token과 refresh_token을 받을 수 있습니다.
둘째, 액세스 토큰으로 사용자 정보를 조회합니다.
카카오 사용자 정보 API를 호출하면 카카오 고유 ID, 닉네임, 프로필 이미지, 이메일 등을 받을 수 있습니다.
셋째, 자체 회원 처리를 합니다.
카카오 고유 ID로 기존 회원인지 확인하고, 신규 회원이면 자동 가입 처리합니다. 그 후 자체 JWT 토큰을 발급해서 로그인 상태를 유지합니다.
6. 실전에서 겪은 문제들
문제 1: 이메일 동의 거부
카카오 로그인에서 이메일은 선택 동의 항목입니다. 사용자가 이메일 제공에 동의하지 않을 수 있습니다. 이 경우를 대비해서 이메일 없이도 회원가입이 되도록 처리하거나, 이메일이 필수인 경우 별도로 입력받는 화면을 만들어야 합니다.
문제 2: 토큰 만료 처리
카카오 액세스 토큰은 일정 시간이 지나면 만료됩니다. refresh_token으로 갱신하는 로직을 반드시 구현해야 합니다.
문제 3: 개발 환경 Redirect URI
localhost에서 테스트할 때 Redirect URI가 매칭되지 않아 오류가 나는 경우가 많습니다. 카카오 개발자 콘솔에서 개발용 URI도 반드시 등록하세요.
문제 4: 카카오 비즈앱 전환
이메일 등 추가 사용자 정보를 받으려면 비즈앱으로 전환해야 합니다. 사업자등록증이 필요하고 심사에 1~3일 소요됩니다.
7. 보안 고려사항
인가 코드를 받는 Redirect URI는 반드시 HTTPS여야 합니다 (개발 환경 제외).
state 파라미터를 사용해서 CSRF 공격을 방지하세요.
액세스 토큰은 프론트엔드에 노출하지 말고 백엔드에서만 관리하세요.
카카오 앱 시크릿 키는 절대 클라이언트 코드에 포함하면 안 됩니다.
8. 정리
카카오 로그인은 한국 서비스에서 사용자 경험을 크게 개선할 수 있는 기능입니다. OAuth 2.0 흐름만 이해하면 구현 자체는 어렵지 않지만, 예외 처리와 보안에 신경을 많이 써야 합니다.
소셜 로그인 연동이 필요한 프로젝트가 있으시면 HM소프트에 문의해 주세요.
홈페이지: https://hmsoft.it.kr
