카카오 통합 가이드

카카오 OAuth를 활용한 소셜 로그인 키 발급 및 연동 방법

카카오OAuth소셜로그인최종 수정: 2026-03-27

이 문서는 카카오 서비스 관련된 모든 가이드를 종합한 통합 가이드 문서입니다.


카카오 기본 세팅 가이드

1단계: 카카오 개발자 사이트 접속

카카오 개발자 사이트에 접속합니다.

2단계: 애플리케이션 등록

'앱' 클릭

앱 클릭

'앱 생성' 클릭

앱 생성 클릭

앱 이름, 서비스 환경 선택 후 등록

앱 이름 및 서비스 환경 선택

앱 등록 완료

3단계: 카카오 로그인 활성화

'카카오 로그인' - '일반' 선택

카카오 로그인 일반 선택

사용 설정 'ON'으로 변경

사용 설정 ON으로 변경


카카오 앱 API 키 발급 가이드

1단계: 해당 앱 클릭 후 좌측 '앱 - 플랫폼 키' 클릭

해당 앱 클릭 후 좌측 앱 플랫폼 키 클릭

해당 화면 캡쳐 후 공유

앱 플랫폼 키 화면 캡쳐 후 공유

좌측 '앱 - 어드민 키' 클릭

해당 앱 클릭 후 좌측 앱 어드민 키 클릭

해당 화면 캡쳐 후 공유

앱 어드민 키 화면 캡쳐 후 공유

2단계: '앱 - 플랫폼 키 - REST API 키' 클릭

플랫폼 키에서 REST API 키 클릭

아래 '클라이언트 시크릿'의 '코드 생성' 클릭

클라이언트 시크릿 코드 생성 클릭

모달에서 '확인' 클릭

클라이언트 시크릿 코드 생성 확인 모달

활성화 스위치 버튼 클릭

활성화 OFF 스위치 클릭

모달에서 '확인' 클릭

활성화 확인 모달

'저장' 클릭

설정 완료 후 저장 클릭

다시 '앱 - 플랫폼 키 - REST API 키' 클릭하여 접속

다시 플랫폼 키에서 REST API 키 클릭

발급된 화면 캡쳐 후 공유

발급된 클라이언트 시크릿 화면 캡쳐 후 공유


카카오 리다이렉트 url 입력 가이드

1단계: '카카오 로그인' - '일반' 선택

카카오 로그인 일반 선택

2단계: 리다이렉트 url '수정' 클릭

리다이렉트 url 수정 클릭

3단계: 리다이렉트 url 줄바꿈하여 입력하고 '저장'

리다이렉트 url은 빌더스게이트에서 제공하며, 로컬호스트 url도 함께 추가합니다.

리다이렉트 url 입력 후 저장


카카오 계정 초기 닉네임 가져오기 설정 가이드

1단계: '카카오 로그인' - '동의 항목' 선택

카카오 로그인 동의 항목 선택

2단계: 닉네임의 '설정' 클릭

닉네임 설정 클릭

3단계: 동의 단계 '필수 동의' 선택 후 저장

동의 단계: '필수 동의' 선택, 동의 목적: '계정 초기 닉네임으로 사용됩니다' 타이핑 후 저장

필수 동의 선택 및 동의 목적 입력 후 저장

4단계: 상태 확인

상태: '필수 동의'로 변경하면 완료

필수 동의로 변경 완료