KOE009 (invalid android_key_hash or ios_bundle_id or web_site_url) 에러가 발생할 때

General / 일반 General / 일반 FAQ
1 
{"error":"misconfigured",
"error_description":"invalid android_key_hash or ios_bundle_id or web_site_url",
"error_code":"KOE009"}

KOE009 (invalid android_key_hash or ios_bundle_id or web_site_url) 에러가 발생할 때

:black_medium_small_square: 플랫폼별로 디벨로퍼스 설정에 API 호출 출처 정보를 등록하지 않은 경우

  • 웹 : JavaScript SDK가 구동되는 사이트 도메인을 등록하지 않은 경우

내 애플리케이션>앱 설정>플랫폼 > Web : 사이트 도메인

  • 앱

– Android : SDK를 사용한 앱이 빌드된 환경에 맞는 key_hash를 등록하지 않은 경우

내 애플리케이션>앱 설정>플랫폼 > Android : 키 해시

– iOS : SDK를 사용한 앱에 설정된 번들ID를 등록하지 않은 경우

내 애플리케이션>앱 설정>플랫폼 > iOS : 번들 ID

빈번한 문의

:black_medium_small_square: Android 앱에서 key_hash 불일치로 에러가 발생할때

(1) 구글 플레이 스토어에 공개 배포된 경우

  • 구글 측에 인증서가 보관되므로 "구글 플레이 콘솔"에서 앱 서명 키 인증서 항목의 "SHA-1 인증서 지문"을 가져와 Base64로 인코딩 합니다.
echo "{SHA-1 인증서 지문}" | xxd -r -p | openssl base64

빈번한 오류

※ 앱 서명 키 인증서 항목이 아닌 업로드 키 인증서 항목에서 "SHA-1 인증서 지문"을 가져와 잘못 인코딩 한 경우
※ “구글 플레이 콘솔” 설정에 따라 구글 측에 인증서를 보관하지 않는 경우
※ “구글 플레이 콘솔” 설정에 따라 인증서를 변경한 경우 (이전에 설치된 앱은 이전에 사용한 값 반영)

(2) 키 해시를 잘못 인코딩한 경우

  • windows powershell 에서 SHA-1 인증서 지문 변환 시, 다르게 변환되는 사례가 있습니다.

아래 Git Client 설치하시면 bash 라는 명령 실행 도구가 같이 설치됩니다.
윈도우에서 리눅스 명령어를 사용할 수 있으며, 정상 변환 되는 것 확인됩니다.
https://git-scm.com/downloads

빈번한 오류

※ 여러기기에서 각각 빌드하고 한곳에서 확인한 키해시 사용
※ 키해시 일부 값누락하여 디벨로퍼스에 등록한경우
※ 다른 디벨로퍼스앱에 키 해시 등록한 경우

:black_medium_small_square: 불특정한 상황에 정확한 키해시를 구하지 못한경우 앱내 로깅하여 키해시 확인을 권장합니다.

(1) Android

import com.kakao.sdk.common.util.Utility

var keyHash = Utility.getKeyHash(this)

(2) Flutter

print(await KakaoSdk.origin);