소셜 로그인 앱 등록: 카카오
카카오 로그인을 쓰기 위해 Kakao Developers 에 앱을 고객 명의로 등록하고 개발사를 팀 멤버로 추가하는 방법입니다. 소셜 로그인 전반의 원칙은 소셜 로그인 앱 등록 가이드에 있습니다.
확인 기준. 2026년 9월 17일에 Kakao Developers 공식 문서를 확인해 작성했습니다. 진행 직전에 출처의 원문을 다시 확인하시기 바랍니다.
준비물
| 준비 | 이유 |
|---|---|
| 회사 담당자의 카카오계정 | 앱의 오너가 됩니다. 가능하면 회사 공용으로 관리할 수 있는 계정 |
| 사업자 정보 | 비즈 앱 전환에 필요합니다 |
| 서비스 이름과 로고 | 로그인 화면에 표시됩니다 |
1. 앱 만들기
회사 담당자의 카카오계정으로 Kakao Developers 에 로그인해 앱을 만듭니다. 이 계정이 앱의 오너가 됩니다.
2. 개발사를 팀 멤버로 추가
앱의 멤버 관리에서 초대할 개발자 계정의 이메일을 입력하고 권한을 선택해 초대합니다.
| 권한 | 할 수 있는 일 | 누구에게 |
|---|---|---|
| 오너 | 앱의 모든 설정, 오너 권한 이전 | 고객 |
| 에디터 | 오너 전용 기능을 뺀 모든 설정 | 개발사 |
| 메시지 에디터 | 앱 정보 보기, 메시지 템플릿 관리 | 메시지 담당자 |
| 뷰어 | 앱 정보 읽기만 | 확인만 하는 사람 |
이미 개발사 계정에 앱이 있다면
카카오 문서에 따르면 앱 소유권을 바꾸려면 현재 오너가 새 오너를 멤버로 추가한 뒤, 멤버 관리에서 권한을 오너로 변경합니다. 기존 앱을 새로 만드는 대신 이 방법으로 오너를 고객에게 넘기면 앱이 그대로 유지됩니다.
3. 비즈 앱으로 전환
사업자 정보를 등록하면 비즈 앱으로 전환됩니다. 사업자등록이 없는 개발자도 본인 인증과 약관 동의로 전환할 수 있습니다.
비즈 앱이 되면 할 수 있는 것 중 로그인과 관련된 것입니다.
- 이메일을 필수 동의 항목으로 설정
- 원래 앱마다 테스트 앱을 최대 5개 만들기
- 와일드카드 하위 도메인 사용
회원가입에 이메일을 반드시 받아야 한다면 비즈 앱 전환이 필요합니다.
4. 카카오 로그인 설정
| 설정 | 내용 | 빠뜨리면 |
|---|---|---|
| 카카오 로그인 활성화 | 카카오 로그인 상태를 ON 으로 | 오류 KOE004 |
| Redirect URI 등록 | 로그인 후 돌아올 서비스 주소 | 오류 KOE006 |
| 클라이언트 시크릿 | REST API 키는 클라이언트 시크릿이 켜진 상태로 추가되므로, 토큰을 받을 때 함께 보내야 합니다 | 토큰 발급 실패 |
Redirect URI 에는 운영 주소뿐 아니라 개발·테스트 주소도 필요한 만큼 등록합니다.
5. 동의항목 설정
로그인할 때 받을 사용자 정보(동의항목)를 고릅니다. 일부 동의항목은 추가 권한이 있어야 설정할 수 있고, 개인정보 항목을 요청하면 실제 서비스에 필요한지 검수를 받습니다. 카카오 문서는 이 검수가 보통 3~5 영업일 걸린다고 안내합니다.
검수에서 확인하는 것은 「그 정보를 서비스가 실제로 쓰는가」입니다. 쓰지 않는 항목은 요청하지 마세요.
키 관리
| 키 | 주의할 점 |
|---|---|
| REST API 키 | 서버에서 토큰을 요청할 때 씁니다 |
| 어드민 키 | 어드민 키를 쓰는 API 는 서버에서만 호출해야 하고, 소스 코드에 넣지 않습니다 |
| IP 허용 목록 | 키마다 호출을 허용할 IP 를 지정해, 키가 새어도 다른 곳에서 못 쓰게 할 수 있습니다 |
계약이 끝날 때
- 멤버 관리에서 개발사 계정을 삭제합니다.
- 개발사가 알고 있던 키가 걱정된다면 키를 재발급하고 운영 서버 설정을 함께 바꿉니다.
- 오너가 회사 담당자 계정인지 확인합니다.
자주 막히는 곳
| 증상 | 원인 | 대응 |
|---|---|---|
로그인 시 KOE004 |
카카오 로그인이 꺼져 있음 | 카카오 로그인 활성화 |
로그인 시 KOE006 |
Redirect URI 미등록·불일치 | 실제 주소를 정확히 등록 |
| 이메일을 필수로 설정할 수 없음 | 비즈 앱이 아님 | 사업자 정보 등록으로 비즈 앱 전환 |
| 원하는 동의항목이 선택되지 않음 | 추가 권한 필요, 검수 대기 | 권한 신청과 검수 일정을 오픈 전에 반영 |
| 앱 오너가 퇴사자 개인 계정 | 개인 계정으로 앱 생성 | 새 오너를 멤버로 추가 후 오너로 변경 |
출처
관련 문서
- 소셜 로그인 앱 등록: 애플애플 로그인(Sign in with Apple)을 쓰기 위해 고객의 Apple 개발자 계정에서 식별자와 메일 설정을 준비하는 방법입니다. 소셜 로그인 전반의 원칙은 소셜 로그인 앱 등록 가이드에 있습니다.
- 소셜 로그인 앱 등록: 구글구글 로그인을 쓰기 위해 고객의 Google Cloud 프로젝트에 OAuth 앱을 설정하고, 오픈 전에 게시하는 방법입니다. 소셜 로그인 전반의 원칙은 소셜 로그인 앱 등록 가이드에 있습니다.
- 소셜 로그인 앱 등록: 네이버네이버 로그인을 쓰기 위해 네이버 개발자센터에 애플리케이션을 고객 명의로 등록하고, 사전 검수를 받는 방법입니다. 소셜 로그인 전반의 원칙은 소셜 로그인 앱 등록 가이드에 있습니다.
- 소셜 로그인 앱 등록 가이드카카오·네이버·구글·애플 로그인을 붙이려면 각 회사의 개발자 사이트에 애플리케이션(앱)을 등록해야 합니다. 이 앱은 로그인할 때 사용자에게 보이는 회사 이름과 로고를 담고, 회원을 식별하는 기준이 됩니다. 이 가이드는 로그인 앱을 고객 명의로 등록하고 개발사를 참여시키는 방법을 안내합…
- 알림 발송 준비: 카카오 알림톡카카오 알림톡은 카카오톡 채널을 추가하지 않은 사람에게도 주문 확인, 결제 완료, 배송·예약 안내 같은 정보성 메시지를 보낼 수 있는 서비스입니다. 쓰려면 회사의 카카오톡 채널과 심사를 통과한 템플릿이 필요합니다. 알림 채널 전반은 알림 발송 준비 가이드에 있습니다.