이 문서는 카카오 로그인 사용 시 필요한 설정에 대해 안내합니다.

카카오 로그인을 사용하려면 사용 설정, 리다이렉트 URI 등록은 반드시 완료해야 합니다. OpenID Connect는 필요 시 설정합니다.

각 제목에 부착된 태그(Tag)는 아래와 같은 의미입니다.

카카오 로그인을 사용하려면 앱 관리 페이지의 [카카오 로그인] > [사용 설정]의 [상태]를 [ON]으로 설정해야 합니다. [상태]가 [OFF]인 경우, 카카오 로그인 요청 시 KOE004 에러가 발생합니다.

카카오 로그인을 사용하려면 리다이렉트 URI를 반드시 등록해야 합니다. 카카오 로그인은 리다이렉트 URI로 서비스에서 요청한 인가 코드와 토큰을 전달합니다. 리다이렉트 URI가 올바르지 않은 경우, 카카오 로그인 시 KOE006 에러가 발생합니다. 아래 호출 방식별 리다이렉트 URI 설정 위치와 설정 방법 안내를 참고합니다.

• REST API: 앱 관리 페이지의 [앱] > [플랫폼 키] > [REST API 키] > [리다이렉트 URI]
• Kakao SDK for JavaScript: 앱 관리 페이지의 [앱] > [플랫폼 키] > [JavaScript 키] > [리다이렉트 URI]

클라이언트 시크릿(Client Secret)은 카카오디벨로퍼스에서 발급하는 특정 코드를 요청에 포함해야 카카오 로그인의 토큰을 발급받을 수 있는 보안 기능입니다.

서비스의 보안을 위해 REST API 키(앱과 함께 자동 생성된 키 포함)는 클라이언트 시크릿 기능이 활성화된 상태로 추가되어, 토큰 발급 시 관련 파라미터를 포함해야 합니다. 아래 클라이언트 시크릿 설정 위치와 설정 방법 안내를 참고합니다.

• 앱 관리 페이지의 [앱] > [플랫폼 키] > [REST API 키] > [클라이언트 시크릿]

OpenID Connect를 활성화하면 카카오 로그인 시 액세스 토큰과 ID 토큰을 함께 발급받을 수 있습니다. 앱 관리 페이지의 [카카오 로그인] > [OpenID Connect]에서 아래 순서로 OpenID Connect를 사용하도록 설정할 수 있습니다.

1. [사용 설정]에서 [상태]를 [ON]으로 설정해 카카오 로그인을 활성화합니다. 카카오 로그인을 사용 중인 경우에만 OpenID Connect를 사용할 수 있습니다.
2. [OpenID Connect]에서 [상태]를 [ON]으로 설정해 OpenID Connect를 활성화합니다.

동의항목은 서비스가 특정 정보 조회 또는 기능 사용을 사용자에게 허가받기 위한 설정입니다. 동의항목에서 자세한 내용과 전체 목록을 확인할 수 있습니다.

앱 관리 페이지의 [카카오 로그인] > [동의항목]에서 동의항목을 사용하도록 설정할 수 있습니다. 자세한 설정 방법은 아래 항목별 설명을 확인합니다.

서비스의 정보 조회 또는 기능 사용을 위한 동의항목을 설정할 수 있습니다. 아래 단계별 안내를 참고합니다.

설정 가능한 [A] [개인정보] 동의항목과 [B] [접근권한] 동의항목 목록입니다. 아래 각 동의항목의 전체 리스트를 참고해 서비스에서 사용자에게 동의가 필요한 항목이 무엇인지 확인합니다.

• 개인정보 동의항목
• 접근권한 동의항목

[개인정보] 또는 [접근 권한]에서 원하는 동의항목의 [설정]을 선택합니다. 일부 동의항목은 설정하기 위해 먼저 추가 기능 신청을 완료해야 합니다.

[A] [동의 단계]를 선택합니다.
[B] [동의 목적]에 사용 목적을 작성한 뒤 [저장]을 선택합니다.
[C] [카카오계정으로 수집 후 제공]의 체크박스를 선택하면, 카카오계정에 등록되지 않은 정보도 사용자에게 동의받은 후 수집해 제공합니다. 해당 기능에 대한 자세한 내용은 카카오계정으로 수집 후 제공을 확인합니다.

앱 관리 페이지의 [카카오 로그인] > [동의항목]의 하단에서 [동의 화면 미리보기]를 눌러 앱의 설정을 반영한 동의 화면을 미리 확인할 수 있습니다.

일부 동의항목은 추가 기능 사용 권한이 있어야 설정할 수 있습니다. 아래 절차에 따라 추가 기능을 신청할 수 있습니다. 심사 과정에 대한 자세한 정보는 개인정보 동의항목 심사 과정을 참고합니다.

동의항목을 설정하기 위해 필요한 항목별 권한은 개인정보 동의항목, 접근권한 동의항목에서 확인할 수 있습니다.

1. 추가 기능을 신청하려면 아래 작업을 먼저 수행해야 합니다.
   • 비즈 앱 전환
   • 신청 자격 확인
   • 비즈니스 정보 심사
2. [앱] > [추가 기능 신청] > [개인정보 동의항목] 항목에서 [신청]을 선택합니다.
3. 개인정보 동의항목 신청 정보를 입력합니다. 심사 체크리스트를 참고해 준비하면 심사 승인 가능성을 높일 수 있습니다.
4. [신청]을 눌러 심사를 요청합니다.

개인정보 동의항목 권한 신청 화면의 구성은 아래와 같습니다.

• [A] 개인정보: 필요한 개인정보의 동의 단계 선택, 최소 하나는 [필수 동의] 또는 [선택 동의]로 선택 필요
• [B] 카카오 로그인 이용 동의: 확인 후 체크박스 선택, [다음] 선택하면 정보 입력창 나타남
• [C] 회원가입 링크: 수집하는 동의항목을 확인할 수 있는 회원가입 페이지 URL 입력, 네이티브 앱을 사용하는 경우 앱 스토어 URL 입력
  • 사이트 개발 등으로 확인 자료 첨부가 어려울 경우, 기획안 또는 디자인 시안으로 대체 가능
  • 참고: 심사 체크리스트
• [D] 개인정보 처리방침: 아래 내용을 반영한 개인정보 처리방침 URL 입력
  • 개인정보 처리 목적: 카카오로부터 취급하는 개인정보가 회원가입 목적임을 명확히 기재
  • 수집 항목: 심사 신청 시 요청한 동의항목을 모두 기재
• [E] 회원가입 화면: 수집 항목을 증빙할 수 있는 확인 자료 첨부
  • 용량 20 MB 이내의 JPG, JPEG, PNG, PDF 형식의 파일 한 개만 업로드 가능
• [F] 수집 사유: 서비스에서 각 사용자 정보가 어떤 용도로 쓰이는지, 수집 목적 입력

반려 없이 한번에 승인 받기 위해, 신청 전에 아래 항목을 확인합니다.

• 화면 캡처와 제출 자료에는 개인정보가 포함되지 않아야 합니다.
  • 개인정보 보호를 위해, 내용과 상관 없이 즉시 첨부 파일을 삭제하고, 반려 처리합니다.
• 회원가입 페이지 제출 시, 실제 사용하는 서비스의 이름이 보이는 화면으로 제출합니다.
• 회원가입 페이지에서 수집하는 항목과 심사 신청 동의항목이 일치해야 합니다.
• 회원가입시 사용자가 입력해야 하는 정보(예: 이름, 연락처, 나이)와 심사 시 요청한 동의항목(예: 이름, 카카오계정(전화번호), 출생 연도)의 종류가 일치해야 합니다.
• 수집하는 정보의 필수/선택 조건은 신청한 동의항목의 동의 단계와 일치해야 합니다.
  • 예: [성별] 동의항목을 [필수 동의]로 신청했으나, 회원가입 페이지에서는 [선택] 수집 조건이라면 반려됩니다.
• 회원가입 페이지에서 요청하는 사용자 정보가 [필수]인지 [선택]인지 명확하게 구분되어야 합니다.
• 첨부 이미지(화면 캡처)는 가입 → 로그인 → 탈퇴까지, 전체 동선을 확인할 수 있도록 준비합니다.
• 개인정보 처리방침에는 수집 목적, 수집 항목, 수집 조건(필수/선택)을 명시해야 합니다.
• 개인정보 처리방침에 기재된 내용은 추가 기능 신청 시 입력한 정보와 일치해야 합니다.
• 카카오 로그인과 같이 소셜 로그인만 제공하는 서비스의 경우, 개인정보 처리방침을 기준으로 심사합니다.

• 목적: 서비스에서 과도한 개인 정보 수집을 막고, 수집하는 목적이 적합한지 판단하기 위해 심사 진행
• 심사 소요일: 영업일 기준 3~5일 소요
• 심사 시, 검토 사항:
  • 입력한 신청 정보와 제출한 자료의 일치 여부
  • 현재 서비스의 회원가입 방식 및 개인정보 활용 범위가 신청 내역과 일치하는지 여부
  • 참고: 심사 체크리스트
• 심사 결과 안내 경로: 앱 멤버의 이메일과 앱 알림으로 안내, 또는 앱 관리 페이지에서도 확인 가능
• 심사 반려 사유 확인: [앱] > [추가 기능 신청] 페이지에서 [심사 반려]를 선택하면 반려 사유 및 조치 방법 확인 가능
  • (참고: Q. 개인정보 동의항목 추가 기능 신청이 반려되었어요.)
• 재심사: 반려 사유를 보완하여 [앱] > [추가 기능 신청] > [개인정보 동의항목] 항목에서 [신청]을 선택해 재신청 가능, 영업일 기준 3~5일 소요
• 동의항목의 사용을 해제하거나, [필수 동의]를 [선택 동의]로 변경하는 경우에는 별도의 추가 심사 없이 바로 적용 가능

대표 채널은 카카오 로그인 시 동의 화면에 노출되는 카카오톡 채널입니다.

1. 앱에 카카오톡 채널을 연결합니다.
2. 앱 관리 페이지의 [카카오 로그인] > [동의항목] > [대표 채널]에서 [대표 채널 선택]을 선택해 연결된 카카오톡 채널 중 하나를 대표 채널로 선택합니다.

앱 관리 페이지의 [카카오 로그인] > [동의항목] > [개인정보 국외이전]에서 개인정보 국외이전 정보를 등록할 수 있습니다.

[A] 이전되는 국가: 개인정보가 이전되는 국가명 입력
[B] 법인명(업체): 개인정보를 이전받는 법인명 입력
[C] 연락처: 정보관리책임자의 이메일, 전화번호, 고객센터 URL 등 개인정보 관련 문의를 위한 [B]의 연락처 입력

입력한 정보로 카카오 로그인 동의 화면에 [개인정보 국외 이전 동의] 필수 동의항목이 추가되며, 사용자는 해당 항목의 [보기]를 선택해 자세한 내용을 확인한 후 동의할 수 있습니다.

간편가입 기능을 이용하면 앱에 설정한 서비스 약관을 카카오 로그인 동의 화면에 노출시켜 사용자로부터 쉽게 약관에 동의를 받을할 수 있습니다.

간편가입을 사용하려면 아래 요구사항을 만족해야 합니다.

1. 추가 기능 신청 자격 확인
2. 비즈니스 정보 심사 신청
3. 앱에 카카오톡 채널 연결
4. 서비스 약관 등록 후, 사용 설정을 [ON]으로 선택
5. 앱 관리 페이지의 [카카오 로그인] > [간편가입]에서 [사용 설정]을 [ON]으로 설정 (최소 하나의 약관이 활성화되어 있어야 간편가입 설정 가능)

앱 관리 페이지의 [카카오 로그인] > [간편가입]에서 [A] [서비스 약관 추가]를 눌러 새로운 서비스 약관을 등록할 수 있습니다. 서비스 약관 운용을 준수해야 합니다.

[A] 서비스 약관 추가: 약관 추가
[B] 만 14세 이상 연령 동의 추가
[C] 사용 중인 약관 목록: 등록한 서비스 약관 중 사용 설정(ON)한 약관 표시
[D] 비활성 서비스 약관: 등록한 서비스 약관 중 사용하지 않는(OFF) 약관 표시
[E] 동의 화면 미리보기: 설정한 약관이 반영된 카카오 로그인 동의 화면 미리보기 창 표시
[F] 순서 변경: 카카오 로그인 동의 화면의 서비스 약관 노출 순서 변경, 상태와 무관하게 지정 가능
[G] 수정: 각 약관에 대한 설정 변경
[H] 사용 설정: 카카오 로그인 동의 화면에 노출 여부 선택

서비스 약관 추가 시, 아래 정보를 설정해야 합니다.

[A] 제목: 한국어, 영어 모두 입력 필요
[B] URL: 약관 내용을 확인할 수 있는 웹 페이지 URL 입력
[C] 동의 단계: 사용자에게 서비스 약관 동의를 요청할 동의 단계 선택(필수 또는 선택 동의항목)
[D] 태그: 각 서비스 약관을 구분하기 위한 고유값을 지정해 입력

항목별 등록 가능 형식은 아래를 참고합니다.

• 제목
  • 한국어 서비스 약관 제목은 한글, 영문, 숫자, 공백, 키보드에서 직접 입력 가능한 특수문자만 지원(최대 45자)
  • 영어 서비스 약관 제목은 영문, 숫자, 공백, 키보드에서 직접 입력 가능한 특수문자만 지원(최대 100자)
  • 영문 서비스 약관이 없더라도 영어 서비스 약관 제목은 영어로 입력, 영어 약관 제목은 사용자 기기의 언어 설정이 영어일 때 사용됨
• URL
  • 선택 서비스 약관에 한해 URL 생략 가능
• 동의 단계
  • 가입 시 반드시 동의해야 하는 서비스 약관은 [필수 동의] 동의항목으로 설정
  • 서비스 제공 범위에 따라 사용자가 추가 동의할 수 있는 서비스 약관은 [선택 동의] 동의항목으로 설정
• 태그
  • 아래 카카오 API 요청 시 태그 사용, 실제 서비스 개발 시 사용 가능한 값으로 입력
    • 서비스 약관 동의 내역 조회: 사용자가 동의한 서비스 약관의 내역 확인
    • 서비스 약관 선택해 동의 요청: 사용자에게 특정 서비스 약관 동의 요청
    • 서비스 약관 동의 철회: 사용자가 동의한 서비스 약관의 동의 철회 요청
  • 영문, 숫자, 하이픈(-), 언더스코어(_)만 입력 가능
  • ${KEYWORD}_${DATE}, ${KEYWORD}_${ORDER} 등 형식 권장(예: terms_20220701, terms_01)

앱 관리 페이지의 [카카오 로그인] > [고급] > [로그아웃 리다이렉트 URI]에서 로그아웃 리다이렉트 URI를 등록해 카카오계정과 함께 로그아웃 기능을 사용할 수 있습니다.

로그아웃 리다이렉트 URI는 HTTP/HTTPS 프로토콜 및 80, 443 포트를 지원하며, HTTP/HTTPS 프로토콜을 구분하므로 각각 등록해야 합니다. 최대 10개의 로그아웃 리다이렉트 URI 등록이 가능하며, 10개 초과 등록이 필요한 경우 데브톡으로 문의합니다.

앱 관리 페이지의 [카카오 로그인] > [고급] > [사용자 프로퍼티]에서 사용자 프로퍼티 키를 등록하고 앱에 연결된 멤버를 대상으로 저장된 값을 확인할 수 있습니다. 서비스마다 총 5개의 사용자 프로퍼티 키(사용자 프로퍼티 예약어 제외)를 등록할 수 있습니다.

[A] 프로퍼티 추가
[B] 프로퍼티 삭제
[C] 계정 정보: 앱에 연결된 멤버의 계정 정보
[D] 예약된 프로퍼티: 사용자 프로퍼티 예약어와 저장된 값
[E] 사용자 프로퍼티: 추가한 사용자 프로퍼티 키와 저장된 값

nickname, profile_image, thumbnail_image는 카카오 플랫폼에서 사용하는 예약어이므로 사용자 프로퍼티 키 등록 시 사용할 수 없습니다.