소셜 로그인 앱 등록: 카카오
카카오 로그인을 쓰기 위해 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 앱을 설정하고, 오픈 전에 게시하는 방법입니다. 소셜 로그인 전반의 원칙은 소셜 로그인 앱 등록 가이드에 있습니다.
- 소셜 로그인 앱 등록: 네이버네이버 로그인을 쓰기 위해 네이버 개발자센터에 애플리케이션을 고객 명의로 등록하고, 사전 검수를 받는 방법입니다. 소셜 로그인 전반의 원칙은 소셜 로그인 앱 등록 가이드에 있습니다.
- 소셜 로그인 앱 등록 가이드카카오·네이버·구글·애플 로그인을 붙이려면 각 회사의 개발자 사이트에 애플리케이션(앱)을 등록해야 합니다. 이 앱은 로그인할 때 사용자에게 보이는 회사 이름과 로고를 담고, 회원을 식별하는 기준이 됩니다. 이 가이드는 로그인 앱을 고객 명의로 등록하고 개발사를 참여시키는 방법을 안내합…
- 고객 자료 준비: 서식과 직인, 사업자 서류견적서나 거래명세서를 시스템에서 출력하려면 지금 쓰고 계신 서식 원본과 직인 이미지, 사업자 서류 사본을 준비해 주셔야 합니다. 거래처가 이미 익숙한 모양 그대로 문서가 나와야 하고, 사이트 하단 정보나 결제 설정에도 서류에 적힌 값이 그대로 들어가기 때문입니다.