카카오 로그인

카카오 로그인 설정 방법에 대해 알아봅니다.

국내 사용자들이 가장 많이 사용하는 SNS 중 하나인 카카오 계정으로 보다 쉽게 사이트에 회원가입 및 로그인을 할 수 있습니다.

1. 어플리케이션 생성

1-1. Kakao Developers에 접속합니다.

1-2. 오른쪽 위 [로그인]버튼을 클릭해 카카오 계정으로 로그인 합니다.

1-3. 상단 메뉴의 내 애플리케이션으로 들어갑니다.

1-4. [애플리케이션 추가하기]버튼을 클릭합니다.

1-5. 모든 정보를 입력한 후 [저장]버튼을 눌러 애플리케이션 생성을 합니다.

항목	설명
앱 아이콘	로고와 같은 사이트의 정체성이 담긴 아이콘을 등록합니다.
앱 이름	사이트 이름 또는 브랜드 이름을 입력합니다.
사업자명	사업자 정보와 동일한 이름을 입력합니다. 사업자가 없을 경우 앱 이름과 동일한 명칭을 입력합니다.
카테고리	사업자의 판매 카테고리를 선택합니다.

1-6. 생성이 된 애플리케이션을 클릭하여,이후 과정을 진행합니다.

2. 비즈 앱 전환

비즈 앱은 이후 진행이 될 사용자 정보 수집을 위해 필수로 진행이 되어야하는 과정입니다. 비즈 앱 설정이 되지않을 경우 이후 과정 진행이 불가하며, 나아가 차후 카카오 채널 연동 및 카카오 싱크 사용이 불가능합니다.

2-1. 사업자 정보 등록하기

이 과정을 진행하기 위해서는 사업자 등록 정보가 필요합니다. 만약 사업자 정보가 없을 경우 아래 [2-2. 개인 개발자 비즈 앱 전환] 가이드를 참고해주세요.

2-1-1. [내 애플리케이션 > 비즈니스]페이지의 [사업자 정보 등록] 버튼을 클릭합니다.

2-1-2. 사이트에 등록 된 사업자 정보와 동일한 사업자 정보를 입력합니다.

2-1-3. 검색 된 사업자 정보 확인 후 [저장]버튼을 클릭합니다.

2-2. 개인 개발자 비즈 앱 전환하기

사업자 등록 정보가 없을 경우 아래 과정을 통해 비즈 앱 전환이 가능합니다. 개인 개발자 비즈 앱 전환을 위해서는 카카오 계정의 본인인증이 진행이 되어야하기에 진행 전 본인인증 여부를 확인 부탁드립니다.

Kakao Developers 로그인 후 메뉴 위 [계정 설정 > 본인인증] 페이지를 통해 본인인증이 가능합니다.

2-2-1. [내 애플리케이션 > 비즈니스]페이지의 [카카오비즈니스 통합 서비스 약관 동의] 버튼을 클릭하여 약관 동의를 합니다.

2-2-2. [개인 개발자 비즈 앱 전환] 버튼을 클릭합니다.

2-2-3. 비즈 앱 전환 목적 항목을 [이메일 필수 동의]로 선택한 후 [전환]을 클릭 합니다.

3. 플랫폼 등록

3-1. [내 애플리케이션 > 플랫폼]페이지의 [Web 플랫폼 등록] 버튼을 클릭합니다.

3-2. 사이트의 대표 도메인을 입력하고, 저장 버튼을 클릭합니다. 입력한 도메인 중 가장 위에 위치한 도메인이 기본 도메인으로 자동 지정이 됩니다.

여러개의 도메인을 사용할 경우 아래 이미지와 같이 줄바꿈을 한 후 입력을 합니다. 입력하지 않은 도메인에서는 카카오 로그인이 동작하지 않습니다.

4. 동의항목 설정

4-1. [내 애플리케이션 > 카카오 로그인 > 동의항목]페이지로 이동합니다.

4-2. [관리자페이지 > 상점설정 > 회원가입]의 기본로그인 페이지의 가입 폼을 통해 설정한 항목과 동일하게 설정합니다. 각 항목의 오른쪽 [설정]버튼을 클릭하여 설정이 가능합니다.

일부 항목은 사업자 정보가 입력된 비즈앱과 비즈채널이 연결되어야 선택 동의 항목으로 사용이 가능합니다.

항목	내용	필수	선택
닉네임	현재 지원되지 않는 항목 입니다.	-	O
프로필 사진	현재 지원되지 않는 항목 입니다.	-	O
카카오계정 (이메일)	사이트에서 이메일 주소를 받는 경우 선택합니다.	필수	-
이름	사이트에서 회원의 이름을 받는 경우 선택합니다.	-	O
성별	사이트에서 성별을 받는 경우 선택합니다.	-	O
연령대	현재 지원되지 않는 항목 입니다.	미지원	미지원
생일	사이트에서 생년월일을 받는 경우 선택합니다.	-	O
출생연도	사이트에서 생년월일을 받는 경우 선택합니다.	-	O
카카오계정 (전화번호)	사이트에서 휴대폰번호를 받는 경우 선택합니다.	-	O
CI(연계정보)	현재 지원되지 않는 항목 입니다.	미지원	미지원
카카오 서비스 내 친구 목록	현재 지원되지 않는 항목 입니다.	미지원	미지원
카카오톡 채널 추가 상태 및 내역	현재 지원되지 않는 항목 입니다.	미지원	미지원
배송지 정보	상품 구매 시 등록 될 배송지 정보입니다.	-	O
보안 이벤트 정보 제공	현재 지원되지 않는 항목 입니다.	미지원	미지원

4-3. 동의 항목 설정 시 항목에 따라 정보를 수집하는 목적을 필수로 기재해야합니다. 예를들어, “카카오 간편 로그인을 통한 사용자 가입 편의성 제공” 등의 내용으로 기재를 해주시면 됩니다.

일부 정보에서 [카카오 계정으로 정보 수집 후 제공] 항목이 있다면 체크를 합니다.

5. 활성화 및 Redirect URL 설정

5-1. [내 애플리케이션 > 제품 설정 > 카카오 로그인]페이지로 이동합니다.

5-2. 활성화 설정의 상태 토글을 ON, OpenID Connect 활성화 설정은 OFF로 설정합니다.

5-3. Redirect URI 등록 버튼을 클릭합니다.

5-4. [3. 플랫폼 등록] 과정에서 등록한 도메인 뒤 api/auth/social/kakao/callback 의 URL을 입력합니다. 예: https://mydomain.com/api/auth/social/kakao/callback

6. 연동하기

6-1. [내 애플리케이션 > 앱 설정 > 앱 키]페이지로 이동합니다.

6-2. REST API 키 와 JavaScript 키를 복사합니다.

6-3. [관리자페이지 > 상점설정 > 회원가입] 페이지의 소셜로그인에 들어갑니다.

6-4. Kakao 로그인 [사용함] 체크 후 에서 복사한 값을 입력 후 [저장]버튼을 클릭합니다.

6-5. 모든 과정이 완료되었습니다. 이제 카카오 로그인을 사용할 수 있습니다.