본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트
  • 문서
  • 이용 안내
  • 앱과 앱 키 변경 사항

사이드 메뉴

문서 홈

시작하기

카카오디벨로퍼스

로그인

커뮤니케이션

카카오맵

내비게이션

광고

검색

더 보기

이용 안내

카카오디벨로퍼스 앱과 앱 키 변경 안내

이 문서는 2025년 12월 3일에 개편된 카카오디벨로퍼스 앱과 앱 키에 대한 주요 변경 사항을 안내합니다.

조치 사항

자동 마이그레이션되어 별도 조치 없이 기존 기능을 그대로 사용할 수 있습니다.

다만, 메뉴 위치나 사용 방법이 많이 변경되었으니 아래를 참고합니다. 특히 아래 서비스를 이용 중인 경우 해당 내용을 반드시 확인해야 합니다.

사용 중인 서비스참고 항목
카카오 로그인 또는 카카오싱크2. 플랫폼 정보 설정 위치 변경
카카오톡 공유 또는 카카오톡 메시지4. 목적에 따라 다른 링크 설정 가능,
5. 메시지 템플릿 도구에 설정 옵션 추가 및 UI 변경
어드민 키로 호출한 API3. 어드민 키로 호출할 수 있는 허용 API 설정

변경 사항

주요 메뉴 경로 변경
대상개편 전개편 후
리다이렉트 URI[카카오 로그인] > [일반]사용하는 앱 키에 각각 설정 필요
  • [앱] > [플랫폼 키] > [REST API 키]
  • [앱] > [플랫폼 키] > [JavaScript 키]
클라이언트 시크릿[카카오 로그인] > [일반][앱] > [플랫폼 키] > [REST API 키]
호출 허용 IP 주소[카카오 로그인] > [고급] > [허용 IP 주소]사용하는 앱 키에 각각 설정 필요
  • [앱] > [플랫폼 키] > [REST API 키]
  • [앱] > [플랫폼 키] > [어드민 키]
웹 도메인[앱] > [플랫폼] > [사이트 도메인]사용 목적에 따라 설정 위치가 분리 되어, 아래 경로에서 각각 설정
  • JavaScript SDK에서 API 호출 검증 시: [앱] > [플랫폼 키] > [JavaScript 키] > [JavaScript SDK 도메인]
  • 제품(카카오톡 메시지/공유 등) 링크 설정 시: [앱] > [제품 링크 관리] > [웹 도메인]
주요 변경 사항 요약

카카오디벨로퍼스 앱에 등록한 플랫폼 정보, 제품별 정보를 이제 앱 키별로 설정할 수 있게 되었습니다. 이에 따른 주요 변경 사항은 아래와 같습니다.

  1. 앱에 플랫폼 환경별로 앱 키를 최대 5개까지 생성할 수 있습니다.
  2. 일부 플랫폼 정보(웹 도메인, 리다이렉트 URI 등)의 설정 위치가 앱 키 하위로 변경됩니다.
  3. 어드민 키로 호출할 수 있는 API를 직접 허용하거나 제한할 수 있습니다.
  4. 목적에 따라 링크 설정 위치가 변경됩니다. API 호출 검증은 [플랫폼 키]에서, 카카오톡 메시지 링크 설정은 [제품 관리 링크]에서 각각 관리할 수 있습니다.
  5. 메시지 템플릿 도구에서 앱 스킴 선택 옵션과 링크 미리보기 기능 등이 추가되었습니다.

1. 환경별 앱 키 추가 기능

  • 대상: REST API 키, JavaScript 키, 네이티브 앱 키, 어드민 키
대상개편 전개편 후
생성 개수 제한앱 키별 1개앱 키별 각각 5개
앱 키 관리앱 생성 시 각 키별로 1개씩 발급앱 생성 시 각 키별로 1개씩 발급은 동일하나, 각 앱 키별 5개씩 키 등록 가능
각 앱 키별 대표 키 지정 가능
앱 키 삭제 가능
앱 키별 이름 지정 가능
설정 위치4가지 타입의 앱 키 모두 [앱] > [일반] > [앱 키]에서 설정키 타입에 따라 설정 위치 다름
  • REST API 키, JavaScript 키, 네이티브 앱 키: [앱] > [플랫폼 키]
  • 어드민 키: [앱] > [어드민 키]

개편된 앱 키 관리 화면

이전 앱 키 관리 화면

기존 사용자를 위한 안내
  • 앱 키 타입은 변경 없이 그대로 유지됩니다.
  • 개편 전에 생성된 앱 키는 대표 키로 지정되어 마이그레이션되었습니다.
  • 개편 후에도 기존과 동일하게 앱 생성 시 앱 키 4종이 자동으로 각각 1개씩 생성됩니다. 최초 생성 키는 대표 키로 지정됩니다.

2. 플랫폼 정보 설정 위치 변경

  • 대상: 웹 도메인, 네이티브 앱 플랫폼 정보, 리다이렉트 URI, 클라이언트 시크릿, 허용 IP 설정
개편 전개편 후
앱에 등록한 플랫폼 정보가 모든 앱 키에 일괄 적용앱 키마다 필요한 플랫폼 설정 가능
  • REST API 키: 리다이렉트 URI(로그인/비즈니스 인증), 클라이언트 시크릿(로그인/비즈니스 인증), 허용 IP 설정
  • JavaScript 키: JavaScript SDK 도메인(기존 '사이트 도메인'), 카카오 로그인 리다이렉트 URI
  • 네이티브 앱 키: Android 패키지명, 키 해시, iOS 번들 ID, 스토어 URL
  • 어드민 키: 허용 IP 설정, 사용 가능한 API
예시

플랫폼 정보 설정 위치 예시

기존 사용자를 위한 안내

별도 설정 없이 기존 기능을 그대로 이용할 수 있으나, 수정이 필요한 경우 호출 환경에 맞는 키 하위에서 해당 정보를 수정해야 합니다. 예를 들어, JavaScript SDK를 사용해 카카오 로그인을 이용 중인 서비스에서 리다이렉트 URI 수정이 필요한 경우, JavaScript 키 하위에서 리다이렉트 URI를 수정합니다.

사용 중인 설정개편 전개편 후
리다이렉트 URI
(카카오 로그인/비즈니스 인증)		[제품 설정] 하위에서 설정REST API 키, JavaScript 키 하위에서 설정
클라이언트 시크릿[제품 설정] 하위에서 설정REST API 키 하위에서 설정
허용 IP 설정[앱] > [고급]에서 설정REST API 키, 어드민 키 하위에서 설정
사이트 도메인[앱] > [플랫폼] > [Web]에서 설정사용 목적에 따라 분리해 사용할 수 있도록 이름과 설정 위치 변경
(참고: 4. 목적에 따라 다른 링크 설정 가능)
Android 플랫폼 정보
(패키지명, 키 해시, 스토어 URL)		[앱] > [플랫폼] > [Android]에서 설정네이티브 앱 키 > [Android 앱 정보]에서 설정
iOS 플랫폼 정보
(번들 ID, 스토어 URL)		[앱] > [플랫폼] > [iOS]에서 설정네이티브 앱 키 > [iOS 앱 정보]에서 설정

3. 어드민 키로 호출할 수 있는 허용 API 설정

대상: 어드민 키
개편 전개편 후
하나의 어드민 키로 모든 API 호출어드민 키별로 호출을 허용하거나 제한할 API를 직접 설정 가능(참고: 사용 가능 API)
어드민 키를 추가로 생성해(최대 5개), 목적별로 사용 가능
사용 용도별로 분리해 관리할 수 있어 안전성 강화

어드민 키 API 설정 화면

기존 사용자를 위한 안내
  • 개편 전 생성된 어드민 키는 모든 API를 호출할 수 있도록 허용된 상태로 마이그레이션 되었습니다. 제한이 필요한 경우, 사용 가능 API을 참고해 API를 제한할 수 있습니다.
  • API 상세 목록은 사용 중인 앱에 부여된 권한을 기준으로 노출됩니다. 어드민 키: API 카테고리를 참고해 사용하려는 카테고리를 선택합니다.

4. 목적에 따라 다른 링크 설정 가능

  • 대상: 웹 도메인, Android 플랫폼 정보(패키지명, 키 해시, 스토어 URL), iOS 플랫폼 정보(번들 ID, 스토어 URL)
개편 전개편 후
[앱] > [일반] > [플랫폼]에 설정한 정보가 API 검증과 카카오톡 메시지 템플릿 링크 설정 정보에 같이 적용됨사용 목적에 따라 플랫폼 정보 설정 위치 변경

주의
API 검증

카카오는 SDK를 사용하는 클라이언트를 아래 정보로 인증합니다. Kakao SDK for Android, iOS, JavaScript를 사용하는 경우, 카카오디벨로퍼스 앱에 아래 플랫폼 정보가 등록되어야 API를 호출할 수 있습니다.

API 검증 설정 화면

기존 사용자를 위한 안내

별도 설정 없이 기존 기능을 그대로 이용할 수 있으나, 수정이 필요한 경우 사용 목적에 따라 아래 경로에서 해당 정보를 수정해야 합니다.

사용 중인 설정개편 전개편 후
사이트 도메인[플랫폼] > [Web] > [사이트 도메인]사용 목적에 따라 플랫폼 정보 설정 위치 변경
Android 플랫폼 정보(패키지명, 키 해시, 스토어 URL)[플랫폼] > [Android]네이티브 앱 키 하위에서 설정
iOS 플랫폼 정보(번들 ID, 스토어 URL)[플랫폼] > [iOS]네이티브 앱 키 하위에서 설정
카카오톡 공유 또는 카카오톡 메시지에서 링크 설정[플랫폼] > [Web], [Android], [iOS]에 등록된 정보만 사용 가능제품 링크 관리에서 별도 설정 가능
  • 웹 도메인: 제품 링크에 적용될 도메인 등록
  • 네이티브 앱 스킴: 커스텀 URL 스킴을 확인하고 기본 네이티브 앱 스킴 선택

5. 메시지 템플릿 도구에 설정 옵션 추가 및 UI 변경

신규 설정 옵션

  • [공통 설정] > [네이티브 앱 스킴]: 앱 키에 설정된 네이티브 앱 스킴 중 템플릿에 적용할 스킴을 선택할 수 있습니다.

네이티브 앱 키 선택 화면

구분말머리설명
[A][기본 네이티브 앱 정보][앱] > [제품 링크 관리] > [네이티브 앱 스킴]에서 기본 네이티브 앱 스킴으로 지정한 스킴
[B][키 이름]해당 네이티브 앱 키의 커스텀 URL 스킴
[플랫폼 키] > [네이티브 앱 키]에서 사용자가 설정한 키 이름이 말머리로 노출
* 2025년 12월 3일 이전에 생성한 템플릿의 경우, 기본 네이티브 앱 스킴이 아닌 기존 앱 키(대표 키) 정보로 마이그레이션 되었습니다.
기존 사용자를 위한 안내
  • 개편 전 생성한 메시지 템플릿의 [네이티브 앱 스킴]은 대표 키로 설정된 기존 앱 키를 기준으로 마이그레이션 되었습니다.
    • [Default LEGACY_NATIVE_APP_KEY] 또는 [Default Native Key]라는 이름의 커스텀 URL 스킴이 기본 선택되어 있습니다.
    • 마이그레이션 된 스킴이 [기본 네이티브 앱 정보]에도 동일하게 적용되어 있습니다.
  • 기본 앱 스킴을 변경하려면, [플랫폼 키]에서 네이티브 앱 키를 생성 후, [제품 링크 관리]에서 기본 앱 스킴으로 변경합니다. 이때, 메시지 템플릿 도구의 공통 설정에서 어떤 네이티브 앱 정보를 선택했느냐에 따라 다르게 동작합니다.
    • [기본 네이티브 앱 스킴]: 앱 이동 링크(Android/iOS 스토어 링크 등)이 함께 변경되니 주의가 필요합니다.
    • [Default LEGACY_NATIVE_APP_KEY] 또는 [Default Native Key]: 키 정보로 유지됩니다.

컴포넌트 링크 설정 화면 변경

메시지 템플릿 도구의 컴포넌트 링크 관리 설정 화면이 개선되었습니다.

개편 전개편 후
[앱] > [플랫폼] > [사이트 도메인]에서 설정한 도메인을 직접 입력

사용자 인자 사용 시 등록된 도메인을 사용자 인자로 전달하지 않는 경우, 등록한 도메인 중 첫번째 값으로 대체됨		아래 도메인 목록 중 하나를 선택하여 사용 가능:
  • [A] 기본 웹 도메인: [앱] > [플랫폼] > [웹 도메인]에서 설정한 기본 웹 도메인
  • [B] 웹 도메인 값: [제품 링크 관리] > [웹 도메인]에서 설정한 도메인
  • [C] 사용자 인자: 등록된 도메인을 사용자 인자로 전달하지 않는 경우, 기본 웹 도메인 값으로 대체됨

도메인 선택 시, 링크 미리보기 가능

컴포넌트 링크 설정 화면

컴포넌트 링크값 표기 방식

메시지 템플릿 도구의 컴포넌트 링크 관리 설정값 표기 방식이 개선되었습니다.

개편 전개편 후
[플랫폼]에 등록된 값을 사용할 경우, 내부 예약어 노출
(예: ${REGI_WEB_DOMAIN}, ${A_E}, ${A_M}, ${I_E}, ${I_M})		예약어 대신 링크가 이동되는 설정값이 보여짐
  • 웹 도메인
    • 기본 웹 도메인 선택 시: 기본 웹 도메인 표시
    • 웹 도메인 목록 중 하나 선택 시: 도메인 원문값 표시(예: https://developers.kakao.com)
    • 사용자 인자: 입력한 사용자 인자값 표시 (예: ${web_domain})
  • 네이티브 앱 스킴
    • 공통 설정에서 기본 네이티브 앱 스킴 선택시: 기본 네이티브 앱 스킴
    • 공통 설정에서 특정 키의 네이티브 앱 스킴 선택시: 특정 네이티브 앱 스킴 원문

참고 문서

도움이 되었나요?