Android 키해시 문제 종합 안내 - 릴리즈키해시, 디버그키해시

카카오 키 해시 가이드 https://developers.kakao.com/docs/latest/ko/android/getting-started#before-you-begin-add-key-hash
구글 Play Console 앱 서명 사용 안내 https://support.google.com/googleplay/android-developer/answer/9842756?hl=ko


들어가기 전에

키해시는 설치된 앱에서 카카오로 전달하는 값으로 다른 환경에서 빌드했다면 다른 값이 전달됩니다.
구글에 등록된 인증서를 변경한 경우 키해시가 잘못 구해지는 경우가 있으므로 구글에 문의하여 확인합니다.

키해시를 잘 등록했는데 안되는 경우는 없으므로, 정상작동하지 않는다면 코드로 로깅해서 키해시 구하는 방법이 가장 확실합니다.

[Android]
import com.kakao.sdk.common.util.Utility
var keyHash = Utility.getKeyHash(this)

[Flutter]
print(await KakaoSdk.origin);

1. 에러 표기

“잘못된 접근입니다. 인증에 실패하여 페이지에 접근할 수 없습니다. 해당 기능을 제공한 서비스 관리자에게 문의해주세요.”

{
message: "
  AuthError(
    statusCode=401, 
    reason=Misconfigured, 
    response=AuthErrorResponse(
         error=misconfigured, 
         errorDescription=invalid android_key_hash or ios_bundle_id or web_site_url))"
}

2. 릴리즈 키해시 조회

구글 플레이 콘솔에 앱 배포 시, 앱 서명 키는 일반적으로 구글에서 관리하므로 릴리즈 키해시는 "구글 플레이 콘솔"에서 "SHA-1 인증서 지문"을 가져와 Base64로 인코딩 해야합니다.

반드시 앱 서명 키 인증서에서 지문을 가져와야합니다.

image

키해시 생성

echo "{SHA-1 인증서 지문}" | xxd -r -p | openssl base64 

3. 디벨로퍼스 설정에 키해시 등록

image
image

4. 문제 사례

  1. 다른 디벨로퍼스앱으로 요청 (키해시를 다른 디벨로퍼스앱에 설정) 하는 사례가 많이 있습니다. 환경별 앱키 확인하시면 됩니다.

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

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

  1. 낮은 Open SSL 버전 사용 시, 잘못 변환된 케이스 확인됨.

  2. 공개 배포된 앱이 아닌 비공개 테스트, 내부테스트는 구글 플레이 콘솔에 설정하신 방법에 따라 다른 키해시 적용될 수 있으므로 SHA1 인증서 지문으로 변환된 키해시가 일치 하지 않는경우

구글에 문의 하거나 앱내 키해시 로깅하셔서 확인 권장합니다.

[Android]
import com.kakao.sdk.common.util.Utility
var keyHash = Utility.getKeyHash(this)
2개의 좋아요
카카오 로그인 해시키 확인 문
릴리즈버전에서 카카오로그인 비정상동작
안드로이드 카카오 로그인 심사 거절(앱 승인절차에 로그인 실패되는 걸로 보임)
카카오 맵 HashKey 문제 관련
카카오 로그인 관련 도움이 필요합니다
안드로이드 배포만하면 로그인이 안됩니다
올바른 릴리즈 키해시, 구글 플레이스토어 키 해시를 등록해도 에러가 납니다
Flutter 개발 안드로이드 기기에서 로그인이 안되는 현상
안드로이드 기기에서만 카카오 로그인이 안됩니다
스토어 등록 후 카카오 로그인 불가
RN 카카오톡 로그인 릴리즈 강제 종료
카카오로그인 관련 문의 invalid android_key_hash or ios_bundle_id or web_site_url
카카오로그인 관련 문의 invalid android_key_hash or ios_bundle_id or web_site_url
잘 동작하던 카카오의 로그인이 안드로이드에서 되지않습니다
Play 스토어 검토 중 오류 발생 원인 알려주세요! ㅠㅠ
카카오 로그인 시, 브라우저가 열리고 정보 입력 후에 로그인으로 하면 반응이 없습니다. 확인부탁드립니다
카카오 로그인이 되지않습니다
Install via .apk is working but via Goolge Play is not
카카오 :Native 로그인 관련해서 문의 드립니다. 내부 테스트 배포 버전으로 배포하여 테스트 하려고 하는데 작동하지 않습니다
[Kotlin] 카카오 로그인시 동의누르고 넘어가면 JsonSyntaxException 이 나옵니다
Flutter에서 카카오톡 로그인 오류
안드로이드 프로덕션 카카오 소셜 로그인이 실패하고 있습니다
안드로이드 내부 테스트를 진행 중 키 해시 문제 질문드립니다
원스토어 배포 관련 문의 (카카오 로그인 반려)
targetSdkVersion 34로 변경 후. 로그인이 안됩니다
targetSdkVersion 34로 변경 후. 로그인이 안됩니다
Flutter 에뮬레이터에 카카오 간편로그인 대해 질문 드리겠습니다
카카오 로그인 에러 문의
{error: misconfigured, error_description: invalid android_key_hash or ios_bundle_id or web_site_url} 이 메세지 뜨면서 로그인이 안됩니다
안드로이드 앱 키 해시 변경 후 로그인 오류 발생
안드로이드 카카오로그인 플레이 스토어 출시 버전만 안되는 현상 문의
플러터 안드로이드 카카오톡 로그인 이후 반응이 없습니다
앱 스토어 등록을 위한 준비사항
안드로이드 연동 카카오내비 인증에 실패하였습니다
Kakao 로그인 장애
카카오 로그인 창이 뜨지 않습니다
카카오톡 로그인 계속하기 버튼
플러터와 카카오로그인 API 인증키
로그인 실패 AuthError statusCode=401
bundleRelease 시 카카오 로그인이 안됩니다
Flutter에서 카카오 공유하기가 안됩니다
안드로이드 apk으로는 카카오로그인이 잘 작동하는데 aab파일에서는 작동이 안 됩니다
카카오맵 Android SDK 401 에러 문의
릴리즈버전에서 카카오로그인 비정상동작
안드로이드 회원가입이 패키지명 변경 후부터 안됩니다
카카오 로그인 API AuthError 401 관련 문의
Internal app sharing에서 카카오 로그인이 동작하지 않습니다
앱키 제발급 후 KOE101 에러
카카오 로그인시 안드로이드 무반응
카카오 로그인 관련
플레이스토어 배포 후 카카오 채널로 이동이 되지 않아서 문의합니다
카카오 링크 공유하기 error
React native에서 로그인 구현 중 invalid android_key_hash or ios_bundle_id or web_site_url 미해결 문제
카카오톡 소셜 로그인
플러터 카카오 로그인 해시 키 질문
Faq 목록 입니다
카카오 로그인 android keyhash validation failed 에러 뜨네요
Buzzad 채널추가 오류
안드로이드 카카오 로그인 키해시 에러문제
해시키 3개 등록했는데도 validation failed
리눅스에서 릴리즈 키 해시 에러
Flutter 안드로이드 appbundle로 빌드해서 파이어베이스 배포 시 invalid 에러
[에러] Invalid android_key_hash or iOS_bundle_id or web_site_url 문의
카카오 로그인 api 호출 문의
카카오 연동 로그인 무반응