한국 시장에 필수입니다. 카카오 로그인 옵션 없이는 가입을 포기하는 한국 사용자가 많습니다. 참고: DontCode는 모든 사용자에 이메일이 필요한데, 카카오는 일반 앱에는 이메일 수집을 허용하지 않습니다 — "비즈 앱"으로 전환해야 합니다. 본 가이드는 OAuth 자격 증명 등록과 비즈 앱 전환(무료, 사업자등록번호가 없는 개인 개발자도 가능) 모두를 안내합니다.
developers.kakao.com에 접속해 카카오 계정으로 로그인하고 개발자 약관에 동의합니다.
내 애플리케이션 → 애플리케이션 추가하기. 앱 이름, 회사명(선택), 아이콘을 입력하고 저장합니다.
생성한 애플리케이션을 클릭합니다. 요약 페이지에 4개의 키가 보입니다: 네이티브 앱 키, REST API 키, JavaScript 키, Admin 키. DontCode는 REST API 키를 클라이언트 ID로 사용합니다.
왼쪽 사이드바에서 카카오 로그인을 클릭하고, 활성화 설정을 ON으로 토글합니다.
카카오 로그인 → 보안으로 이동합니다. Client Secret 사용함을 ON으로 토글하고 코드 생성을 클릭합니다. 생성된 값을 복사해 두세요. DontCode가 서버 측에서 로그인을 완료할 때 사용합니다. 비밀번호처럼 취급하세요.
카카오 로그인 페이지에서 "Redirect URI" 항목을 찾아 등록을 클릭합니다. DontCode 리다이렉트 URL(https://<배포된-도메인>/api/auth/oauth/callback)을 붙여넣고 저장합니다.
DontCode는 이메일을 사용자 식별자로 사용합니다 — 모든 계정에 이메일이 필요합니다. 그런데 카카오는 일반 앱에 카카오계정(이메일) 동의항목을 허용하지 않습니다. 비즈 앱으로 전환해야만 동의항목이 잠금 해제됩니다. 이는 카카오 플랫폼 정책이며 DontCode가 변경할 수 없습니다. 전환하기 전에는 이메일을 요청하는 모든 카카오 로그인이 KOE205 오류로 실패합니다. 다음 두 단계가 전환 절차를 안내합니다. 비즈 앱 전환은 무료이며 두 가지 경로 중 본인에게 맞는 것을 선택하세요.
한국 사업자등록번호가 있다면 가장 빠른 경로입니다. 앱 설정 → 앱 → 일반으로 이동합니다. 비즈니스 정보 섹션에서 비즈 앱 전환을 클릭합니다. 사업자등록번호와 일치하는 사업자 정보를 입력합니다. 카카오가 자동으로 검증하며 보통 몇 분 안에 처리됩니다. 경로 B는 건너뛰고 "동의항목 설정" 단계로 이동합니다.
사업자등록번호가 없어도 개인 개발자로 비즈 앱 전환이 가능합니다. 두 가지 조건이 필요합니다. (1) 앱 소유자의 카카오 계정에서 본인인증을 완료해야 합니다(휴대폰 본인인증). (2) 카카오비즈니스 통합 서비스 약관에 동의해야 합니다. 그 다음 devtalk.kakao.com에 "개인개발자 비즈앱 전환"을 요청하는 게시글을 작성합니다. 게시글에는 다음을 포함합니다: 앱 이름, 앱 ID, 개발자 계정 이메일, 본인인증 완료 여부(Y/N), 신청 사유("이메일 필수 동의 설정"). 카카오 관리자가 보통 영업일 기준 1~3일 안에 처리합니다. 해외 거주 등으로 휴대폰 본인인증이 어려운 경우에도 같은 데브톡 게시글에 상황을 설명하면 대체 인증 방법을 안내받을 수 있습니다.
비즈 앱 전환이 완료되면 카카오 로그인 → 동의항목으로 이동합니다. 닉네임을 찾아 필수 동의로 설정합니다. 카카오계정(이메일)을 찾으면 — 이제 잠금 해제되어 있어야 합니다 — 필수 동의로 설정합니다. 각 동의항목에는 동의 목적을 간단히 입력해야 합니다(예: "사용자 식별 및 알림 발송"). 입력 후 저장을 클릭합니다. DontCode는 이메일 없이 작동하지 않으므로 사용 안 함으로 두지 마세요. 사용자가 건너뛸 수 있게 하려면 선택 동의로 설정해도 되지만, 동의하지 않은 사용자에게는 임의 이메일이 부여되어 비밀번호 재설정·알림·트랜잭션 이메일을 받지 못합니다.
DontCode 프로젝트의 인증 → 소셜 로그인 → 카카오로 이동합니다. REST API 키를 클라이언트 ID 칸에, 보안에서 발급한 값을 클라이언트 시크릿 칸에 붙여넣고 저장합니다. 앱이 자동으로 재배포되며 카카오 로그인은 몇 초 안에 적용됩니다.
일반적인 문제는 메인 가이드의 문제 해결 섹션도 함께 확인하세요.
위에서 설명한 비즈 앱 / 동의항목 오류입니다. 앱이 카카오계정(이메일)을 요청했지만 동의항목에서 활성화되지 않은 상태입니다. 비즈 앱으로 전환한 뒤 이메일 동의항목을 활성화하거나(경로 A 또는 B), 요청 scope에서 이메일을 제거해야 합니다. 단, DontCode는 이메일이 필수이므로 올바른 해결책은 비즈 앱 전환을 완료하는 것입니다.
Kakao Developers에 등록한 리다이렉트 URL과 배포된 앱이 보낸 URL이 정확히 일치하지 않을 때 발생합니다. 끝의 슬래시, 프로토콜(http/https), 호스트를 다시 확인하세요. 카카오는 등록된 URI가 한 글자도 다르지 않게 일치해야 합니다. DontCode 프로젝트의 인증된 각 도메인마다 별도의 리다이렉트 URL이 있으니 모두 등록하세요.
카카오 로그인 → 동의항목으로 이동해 카카오계정(이메일)을 명시적으로 필수 동의 또는 선택 동의로 설정해야 합니다. 비즈 앱 전환은 옵션을 잠금 해제할 뿐 자동 활성화하지 않습니다. 처음 활성화할 때는 동의 목적도 입력해야 합니다.
카카오가 실제 이메일을 반환하지 않을 때 DontCode가 사용하는 임의 이메일입니다. account_email이 선택 동의이고 사용자가 거절했거나, 앱이 아직 비즈 앱이 아닐 때 발생합니다. 해결: 동의항목을 필수 동의로 변경해 사용자가 이메일을 공유해야만 로그인되도록 하세요.