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

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

조치 사항

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

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

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

변경 사항

요약

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

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

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]에서 설정	사용 목적에 따라 분리해 사용할 수 있도록 이름과 설정 위치 변경 - API 호출 인증: [플랫폼 키 ] > [JavaScript 키] > JavaScript SDK 도메인 - 제품 링크 설정: [제품 링크 관리] > 웹 도메인 (참고: 4. 목적에 따라 다른 링크 설정 가능)
Android 플랫폼 정보 (패키지명, 키 해시, 스토어 URL)	[앱] > [플랫폼] > [Android]에서 설정	네이티브 앱 키 > [Android 앱 정보]에서 설정
iOS 플랫폼 정보 (번들 ID, 스토어 URL)	[앱] > [플랫폼] > [iOS]에서 설정	네이티브 앱 키 > [iOS 앱 정보]에서 설정

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

• 대상: 어드민 키

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

기존 사용자를 위한 안내

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

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

• 대상: 웹 도메인, Android 플랫폼 정보(패키지명, 키 해시, 스토어 URL), iOS 플랫폼 정보(번들 ID, 스토어 URL)

개편 전	개편 후
[앱] > [일반] > [플랫폼]에 설정한 정보가 API 검증과 카카오톡 메시지 템플릿 링크 설정 정보에 같이 적용됨	사용 목적에 따라 플랫폼 정보 설정 위치 변경 - API 호출 검증: [앱] > [플랫폼 키]에서 등록한 정보 사용 - 카카오디벨로퍼스 제품 링크 설정: [앱] > 제품 링크 관리에서 설정 주의: - 기본 템플릿 사용 시: 템플릿에서 사용 중인 기본 네이티브 앱 스킴 변경 시, 앱 이동 링크가 변경될 수 있으니 주의 필요 - 사용자 정의 템플릿 사용 시: 메시지 템플릿 도구의 공통 설정에 설정된 네이티브 앱 스킴을 변경하면 앱 이동 링크가 변경될 수 있으니 주의 필요

API 검증

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

• Android: 패키지명, 키 해시
• iOS:번들 ID
• JavaScript: JavaScript SDK 도메인

기존 사용자를 위한 안내

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

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

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

• 대상: 메시지 템플릿 도구
• 상세 변경 사항:
  • 신규 설정 옵션
  • 컴포넌트 링크 설정 화면 변경
  • 컴포넌트 링크값 표기 방식

신규 설정 옵션

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

구분	말머리	설명
🅐	[기본 네이티브 앱 정보]	[앱] > [제품 링크 관리] > [네이티브 앱 스킴]에서 기본 네이티브 앱 스킴으로 지정한 스킴
🅑	[키 이름]	해당 네이티브 앱 키의 커스텀 URL 스킴 [플랫폼 키] > [네이티브 앱 키]에서 사용자가 설정한 키 이름이 말머리로 노출

2025년 12월 3일 이전에 생성한 템플릿의 경우, 기본 네이티브 앱 스킴이 아닌 기존 앱 키(대표 키) 정보로 마이그레이션 되었습니다.

기존 사용자를 위한 안내

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

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

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

개편 전	개편 후
[앱] > [플랫폼] > [사이트 도메인]에서 설정한 도메인을 직접 입력 사용자 인자 사용 시 등록된 도메인을 사용자 인자로 전달하지 않는 경우, 등록한 도메인 중 첫번째 값으로 대체됨	아래 도메인 목록 중 하나를 선택하여 사용 가능: - 🅐 기본 웹 도메인 - 🅑 웹 도메인 값: [제품 링크 관리] > [웹 도메인]에서 설정한 도메인 - 🅒 사용자 인자: 등록된 도메인을 사용자 인자로 전달하지 않는 경우, 기본 웹 도메인 값으로 대체됨 도메인 선택 시, 링크 미리보기 가능

컴포넌트 링크값 표기 방식

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

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

참고 문서

• 플랫폼 키 / 어드민 키
• 제품 링크 관리
• 메시지 템플릿 > 사용자 정의 템플릿