가이드 요약
Android 패키지에 추가 서명 키를 등록할 때 적격 공개 키, 소유권 증명, 사유 제출을 구분합니다.
대상: 기존 패키지 등록 중 적격 키, 추가 키, 서명 키 불일치 메시지를 받은 Android 출시 담당자.
출시 점검 순서
- 사용 중인 배포 채널마다 사용자가 받는 아티팩트를 목록화합니다.
- 공개 SHA-256 인증서 지문을 추출하고 앱 서명, 업로드, 레거시, 채널 전용 키로 분류합니다.
- 적격 키 또는 공식 검토 경로를 선택하고 실제 배포 버전을 서명하는 합법적인 키를 모두 추가합니다.
- 요청된 소유권 증명을 끝내고 동일한 패키지·인증서 조합을 다시 조회합니다.
핵심 정보
적격 목록에 없다는 이유로 프로덕션 서명 키를 교체하지 마세요. 아티팩트와 키 역할을 확인하고 업데이트 연속성을 보존하면서 공식 요청 또는 검토 절차를 사용합니다.
상세 안내
설치된 앱을 서명한 인증서 등록하기
사용자가 실제로 설치하는 아티팩트부터 확인합니다. Play 앱 서명에서는 Google이 앱 서명 키로 배포 APK에 서명하고 업로드 키는 제출 인증에만 사용됩니다. 웹사이트나 다른 스토어의 빌드는 다른 프로덕션 인증서를 쓸 수 있습니다.
각 배포 APK에서 SHA-256 인증서를 추출하고 사용 위치를 기록합니다. 익숙한 키 저장소 별칭이라도 설치 앱을 서명하지 않았다면 올바른 등록 값이 아닙니다.
- Play 배포 APK: 앱 서명 키의 인증서.
- Play 업로드: 별도 용도의 업로드 키 인증서.
- 다른 채널: 해당 프로덕션 APK를 검사합니다.
apksigner verify --print-certs app-release.apk적격 키 또는 검토 경로 선택하기
기존 패키지의 경우 콘솔에 과거 이력과 연결된 서명 키가 나타날 수 있습니다. 사용자가 받는 버전과 일치하는 키를 고릅니다. 올바른 프로덕션 키가 적격하지 않다면 업로드 키나 디버그 키를 잘못 선택하지 않았는지 확인하고 공식 요청·검토 경로에서 배포 이력을 설명합니다.
새 패키지 이름은 현재 콘솔 절차를 따르고 패키지, 인증서, 개발자 계정을 하나의 출시 기록에 함께 둡니다. 목록에 보이게 하려고 대체 키를 만들면 안 됩니다.
- 키 별칭이 아닌 SHA-256 지문을 비교합니다.
- 레거시 및 채널별 출시 증거를 보관합니다.
- 앱 업데이트 연속성을 유지하는 키를 보존합니다.
합법적인 배포 키를 모두 추가하기
여러 채널 또는 승인된 서명 이력이 있다면 하나의 패키지에 여러 합법적인 서명 키가 있을 수 있습니다. 공식 추가 키 절차로 각 공개 인증서를 등록하고 지문마다 채널과 담당자를 표시합니다.
콘솔에서 소유권 증명을 요구하면 해당 서명 키로 과제를 완료합니다. 서명된 APK와 adi-registration.properties를 사용할 수 있지만 비공개 키 자체를 업로드하지는 않습니다.
- 실제 배포 아티팩트를 서명하는 키만 추가합니다.
- 비공개 키는 기존 서명 시스템 안에 보관합니다.
- 콘솔 처리가 끝난 뒤 상태를 다시 조회합니다.
등록 오류와 Play 업로드 오류 구분하기
등록 불일치는 패키지가 다른 인증서 지문으로 등록됐다는 뜻입니다. App Bundle이 잘못된 키로 서명됐다는 Play 메시지는 업로드 키 또는 Play 앱 서명 문제입니다. 같은 패키지를 언급해도 해결할 계층이 다릅니다.
등록은 패키지와 인증서를 조합해 Status API로 확인합니다. AAB 거부는 Play Console 인증서 화면과 업로드 안내로 진단합니다. 실패 계층을 확인하기 전에 키를 바꾸면 복구가 더 어려워집니다.
- 등록 확인: 패키지 + 공개 인증서.
- AAB 거부: Play가 기대하는 업로드 키 인증서.
- Play 설치 신원: 앱 서명 키의 인증서.
추가 키를 등록하기 전 확인할 분기
먼저 공식 콘솔에서 새 패키지인지 기존 패키지인지 확인합니다. 기존 패키지의 `SELECT_KEY_FROM_LIST` 흐름에서는 known key의 공개 SHA-256을 실제 배포 인증서와 대조하세요. 선택된 공개 키와 쌍을 이루는 비공개 키로 서명한 APK가 소유권 증명에 필요합니다.
Play App Signing을 사용한다면 목록이 Play 배포용 App signing key를 가리키는지 AAB 제출용 upload key를 가리키는지 구분하세요. 다른 스토어의 키도 섞지 말고 채널별 APK와 인증서를 대조합니다.
콘솔이 justification을 요구하면 APK를 반복 제출하는 것으로 해결되지 않습니다. 패키지 사용 권한에 관한 구체적인 사업 사유를 제출하고 검토에 최대 24시간 걸릴 수 있음을 일정에 반영하세요.
- 등록 표시가 있어도 실제 배포 인증서는 채널마다 대조합니다.
- 비공개 키나 keystore를 업로드하지 말고 공개 인증서만 확인하세요.
운영 패키지 이름을 입력하고, 서명까지 확인하려면 실제 배포 APK의 인증서 SHA-256을 추가하세요. 이 조회는 스토어 심사와 별개입니다.
상태 확인 →자주 묻는 질문
Android 패키지 하나에 여러 서명 키를 등록할 수 있나요?
가능합니다. 실제 배포 채널이나 승인된 서명 이력을 나타내는 합법적인 추가 키를 등록하고 각 SHA-256이 어느 아티팩트와 채널에 속하는지 기록하세요.
Play 앱 서명에서는 어떤 키를 사용하나요?
Google Play가 사용자에게 전달하는 앱 신원에는 앱 서명 키 인증서를 사용합니다. 번들 업로드를 인증하는 업로드 키 인증서는 다를 수 있습니다.
프로덕션 키가 적격 목록에 없으면 어떻게 하나요?
먼저 업로드 또는 디버그 빌드가 아니라 설치된 프로덕션 아티팩트를 서명한 키인지 확인합니다. 그런 다음 공식 콘솔 요청 또는 검토 절차에서 배포 증거를 제출하세요.
비공개 서명 키를 업로드해야 하나요?
아닙니다. 등록에는 공개 인증서 지문을 사용합니다. 소유권 증명에서 해당 비공개 키로 서명한 APK를 요구할 수 있지만 키 자체는 키 저장소나 서명 서비스에 남습니다.
Play에서 App Bundle 키가 틀렸다고 하는 이유는?
대개 Play가 기대한 업로드 키 인증서 문제이며 개발자 인증에 등록된 인증서와는 별개입니다. 키를 바꾸기 전에 Play Console에서 실패 지점을 진단하세요.
출처 및 검토
최종 검토일: