업로드 키 재설정 요청을 하려고 .pem 파일 생성 명령을 내리니까 password 입력란이 나왔는데 키를 눌러 보아도 아무것도 보이지 않아서 제대로 입력되고 있는 건지 알 수가 없었다. 그래서 일부러 오류 메시지가 나오는 상황을 만들어서 실험을 했다. .pem 파일 생성 시, 유효기간 옵션을 넣었다.
필요성
업로드 키를 뭐하러 바꾸지? 처음에는 그런 생각을 할 수도 있겠다. 그런데 이런 저런 앱의 앱 번들을 생성하다 보면 업로드 키를 바꾸고 싶은 생각이 자연스럽게 생긴다. 편하게 하고 싶으니까.
업로드 키 vs 서명 키
2025.02.06. 00:30
앱 업로드 키를 바꾸기로 했다. 업로드 키와 서명 키는 다르다. 개발자가 업로드할 앱 번들(aab)을 만들 때 쓰는 키가 업로드 키이고, 그후 구글이 만든 서명 키가 apk 에 들어간다. 물론 이 방법은 앱 출시할 때, 내 대신 구글이 서명 키를 만들도록 설정했을 때의 일이다.
업로드 키 재설정 요청
다음 위치에서 업로드 키 재설정 요청을 할 수 있다:
Play Console > 앱 클릭 > 테스트 및 출시 > 설정 > 앱 서명
'업로드 키 재설정 요청' 클릭
팝업이 나왔다:
업로드 키 재설정 요청
Google Play에 새 업로드 키를 제공하여 업로드 키 변경을 요청할 수 있습니다. 승인되면 새로운 출시에 새 업로드 키만 사용할 수 있습니다.
1. 업로드 키를 재설정하는 이유를 선택합니다.
업로드 키를 분실함
키 저장소 액세스 권한을 보유한 개발자가 퇴사했습니다.
업로드 키가 손상됨
키 저장소의 비밀번호를 잊어버림
v 기타
나는 ‘기타’를 선택했다.
2. 새 업로드 키를 만듭니다. 자세히 알아보기
업로드 키는 이미 만들어 놓은 게 있어서 이 단계는 그냥 통과했다(안드로이드 스튜디오에서 앱 번들 생성할 때 ‘Create new’ 메뉴를 이용하면 됨. 내가 기억하기로는 거기까지만 하고 컴파일은 안 해도 키는 만들어진다).
설명에 다음과 같은 내용이 나온다:
3. 다음 명령어를 사용하여 업로드 키 인증서를 PEM 파일로 내보냅니다. 이때 굵게 표시된 인수를 적절히 바꾸세요.
$ keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
설명에 나온 것처럼, .jks 파일 이름과 alias 이름은 키 생성할 때 내가 정한대로 바꿔넣었다. 그리고 -validity 365000 를 다음과 같이 보탰다. 유효기간 1000년이라는 뜻이다. 즉, 다음과 같이 했다:
$ keytool -export -rfc -keystore upload-keystore.jks -validity 365000 -alias upload -file upload_certificate.pem
Gnome Terminal 에서 위의 명령을 내리자, 다음과 같이 나왔다:
Enter keystore password:
여기서 자판을 눌러보니 아무것도 보이지 않아서 제대로 입력되고 있는 건지 알 수가 없다. 시험삼아 아무 키나 마구 누르다가 Enter 키를 쳤더니 이렇게 나왔다:
keytool error: java.io.IOException: keystore password was incorrect
물론 pem 파일도 아직 생성되지 않았다. 이번에는 password 를 제대로 입력했다. 그냥 붙여넣기로 했다. 그랬더니 다음과 같은 메시지가 나왔다:
Certificate stored in file <upload_certificate.pem>
아까와 달리 오류 메시지가 안 나온 걸 보면 제대로 된 셈이다. 실제로 upload_certificate.pem 파일이 생성된 걸 볼 수 있었다.
4. 업로드 키 인증서에서 생성된 .PEM 파일을 업로드하세요. > 요청 클릭.
팝업이 닫히면서 다음 내용이 새로 생겼다:
이 앱의 업로드 키 재설정 요청이 대기 중입니다.
이메일이 날아왔다:
앱 이름(com.example.myapp)의 업로드 키 재설정 요청이 접수되었습니다. 새 업로드 키는 Feb 7, 2025, 3:53 PM(UTC)부터 유효합니다. 새 업로드 키가 유효해야만 새 App Bundle이나 APK를 업로드할 수 있습니다.
이제 1.5일이 지나면 새 업로드 키가 유효하다.
업로드 키 재설정 성공
2025.02.17.
앱 업데이트 할 일이 생겨서 새로 만든 업로드 키로 앱 번들을 생성해서 업로드했다. 이 과정에서 아무 문제도 발생하지 않았다. 앱을 실행해서 인앱 업데이트 기능으로 업데이트를 진행했다. 앱이 잘 작동한다. 즉, 업로드 키 재설정에 성공한 셈이다.