BaroCert Developers
가이드 카카오 인증 간편로그인 Java 간편로그인 설정 목록

간편로그인 설정 목록

이용기관은 카카오 개발자 웹사이트에서 앱을 등록하고 카카오 로그인 사용에 필요한 필수 설정을 앱에 반드시 등록해야 합니다.

간편로그인 설정 목록
  1. 1. 플랫폼 등록
  2. 2. 카카오 로그인 활성화 설정
  3. 3. Redirect URL 등록
  4. 4. 동의항목 설정

1. 플랫폼 등록

등록한 앱에서 API 호출에 필요한 플랫폼에 대한 정보를 [카카오 개발자 웹사이트] > [내 애플리케이션] > 플랫폼]에 등록합니다.

Android Android 플랫폼 등록하기
  1. ① 패키지명(Package Name)
    • - Android 앱의 고유한 이름으로 AndroidManifest.xml 파일의 package 속성 값과 동일한 값을 입력합니다.
  2. ② 마켓 URL
    • - 사용자가 카카오톡 공유나 메시지 API로 전송된 메시지의 링크를 통해 앱을 실행시킬 때 사용자 기기에서 해당 앱이 설치되어 있지 않을 경우 이동할 오픈마켓 주소입니다.
    • - [구글플레이] 선택 시 패키지명을 기반으로 마켓 URL이 자동 입력되고, [직접 입력] 선택 시 전체 마켓 URL 값을 등록해야 합니다.
    • - [직접 입력] 선택 시, 구글 플레이 스토어 외에 원스토어 등의 마켓 URL도 등록할 수 있습니다.
  3. ③ 키 해시(Key Hash)
    • - 개발 및 서비스 릴리즈 빌드를 위해 필요한 키 해시 값입니다.
    • - 카카오 API 요청 시 유효성 검증에 사용되며, 개발 환경별로 등록해야 합니다.
iOS iOS 플랫폼 등록하기
  1. ① 번들 ID(Bundle ID)
    • - iOS 앱의 고유 값으로 Xcode의 프로젝트 정보에 설정된 Bundle Identifier 값과 동일한 값을 입력합니다.
  2. ② 앱스토어 ID(Appstore ID) 및 마켓 URL(Market URL)
    • - 애플 앱스토어 등록 시 발급받은 앱 ID를 등록하면 마켓 URL이 자동 입력됩니다.
    • - 사용자가 카카오톡 공유나 메시지 API로 전송된 메시지의 링크를 통해 앱을 실행시킬 때 사용자 기기에서 해당 앱이 설치되어 있지 않을 경우 이동할 오픈마켓 주소입니다.
Web Web 플랫폼 등록하기
  1. ① 사이트 도메인
    • - Kakao SDK for JavaScript, 카카오톡 공유를 포함한 메시지 API를 사용하려면 도메인 정보를 등록해야 합니다.
    • - http://, https://, file:// 형식의 도메인을 등록할 수 있으며, http와 https 도메인은 둘 중 한가지만 등록해도 사용할 수 있습니다.
    • - 최대 10개의 도메인을 등록할 수 있습니다.
  2. ② 기본 도메인
    • - 하나 이상의 도메인을 등록한 경우, 맨 윗줄에 등록된 도메인이 기본 도메인으로 설정됩니다.
    • - 기본 도메인은 카카오톡 공유, 카카오톡 메시지 API를 통해 발송되는 메시지의 Web 링크 기본값으로 사용됩니다.
잘못된 플랫폼 정보로 인한 오류 해결방법

플랫폼 별로 필요한 정보를 등록하지 않았거나, 등록한 정보가 실제 앱 정보와 다르면 "invalid android_key_hash or ios_bundle_id or web_site_url" 에러가 발생합니다.

  • Android : 등록한 패키지명과 AndroidManifest.xml 파일 package 속성값의 동일 여부 또는 키 해시 값 등록 여부를 확인합니다.
  • iOS : 등록한 번들 ID와 Xcode 프로젝트 파일에 설정된 Bundle Identifier ID 값의 동일 여부를 확인합니다.
    번들 ID는 Xcode의 [TARGETS] > [General] > [Identify]에서 확인 가능합니다.
  • Web : API를 호출할 때 사용한 사이트 도메인 등록 여부를 확인합니다.

2. 카카오 로그인 활성화 설정

카카오 로그인을 이용하려면 [카카오 개발자 웹사이트] > [내 애플리케이션] > [카카오 로그인]에서 활성화 설정 상태를 “ON”으로 설정합니다. 활성화 설정 상태가 “OFF”인 경우 오류가 발생하니 사전에 반드시 설정을 변경하시기 바랍니다.

카카오 로그인 활성화 설정하기

3. Redirect URL 등록

PC 또는 모바일 웹 브라우저에서 카카오 로그인을 이용한다면 [카카오 개발자 웹사이트] > [내 애플리케이션] > [카카오 로그인]에서 Redirect URI를 반드시 등록해야 합니다. 카카오 로그인은 서비스 로그인 과정에서 Redirect URI를 통해 서비스에서 요청한 인가코드와 토큰을 전달합니다.

Redirect URL 규칙
  • Redirect URI는 최대 10개까지 등록할 수 있습니다.
  • Redirect URI는 HTTP 및 HTTPS 프로토콜, 80,443포트를 허용합니다.
  • Redirect URI는 HTTP 및 HTTPS 프로토콜을 구분하므로 각각 등록해야 합니다.
Redirect URL 등록하기

4. 동의항목 설정

카카오 로그인을 이용하는 이용자에게 동의받고자 하는 동의항목(개인정보, 접근권한)의 용도에 따라 [필수], [선택], [이용 중 동의]단계를 설정할 수 있습니다. 앱에 설정된 동의항목은 카카오 로그인 동의 화면에 반영되며 이용자는 동의 화면을 통해 필요한 동의항목에 동의합니다.

동의항목 설정하기
  1. ① 동의 단계
    • 필수 동의 - 이용자가 필수로 동의해야 로그인을 완료할 수 있습니다.
    • 선택 동의 - 이용자가 동의하지 않아도 로그인을 완료할 수 있습니다.
    • 이용 중 동의 - 동의항목에 대한 동의가 필요한 시점에 동의를 받습니다.
    • 사용 안함 - 이용자에게 동의를 요청하지 않습니다.
  2. ② 카카오계정으로 정보 수집 후 제공

    특정 동의항목의 이용자 정보의 수집이 반드시 필요하면 앱 설정에서 필수 동의로 단계를 선택하고 [카카오계정으로 수집 후 제공] 옵션을 설정합니다. [카카오계정으로 수집 후 제공] 옵션이 설정된 필수 동의항목은 이용자가 정보를 가지고 있지 않아도 동의 및 제공을 받을 수 있습니다. 선택 동의 단계로 설정된 동의항목도 옵션 설정이 가능하지만 카카오 로그인 동의 화면에서는 적용되지 않고 추가 항목 동의 받기를 요청한 경우에만 적용됩니다.

    동의항목(이메일) 수집 예시
  3. ③ 동의목적

    동의항목 사용 목적에 대한 참고 정보로 카카오 로그인 동의 화면에는 노출되지 않습니다.

  4. ④ 동의항목
    • 개인정보
      항목 이름 ID ①설정 가능 동의 단계 ②정보 수집 후 제공
      닉네임 profile_nickname 필수 동의 불가능
      프로필 사진 profile_image 필수 동의 불가능
      카카오 계정(이메일) account_email 선택 동의 가능
      성별 gender 선택 동의 가능
      연령대 age_range 선택 동의 가능
      생일 birthday 선택 동의 가능
      카카오 서비스 내 친구목록
      (프로필 사진, 닉네임, 즐겨찾기 포함)       		friends 이용 중 동의 불가능
      카카오스토리 프로필 URL story_permalink 필수 동의 불가능
    • 접근권한
      항목 이름 ID 상태
      카카오스토리 글 목록 story_read
      • 선택 동의
      • 이용 중 동의
      • 사용 안함
      중 선택 가능
      카카오스토리 글 작성 story_publish
      카카오톡 메시지 전송 talk_message
      톡캘린더 및 일정 생성, 조회, 편집/삭제 talk_calendar