KappS 지식 베이스 · 블로그

2026년 Google Play 앱 서명: 업로드 키, 키 업그레이드, 키 재설정 단계별 가이드

블로그 가이드

Play 앱 서명은 앱 서명을 두 가지 작업으로 나눕니다. 사용자는 키를 보관하고, Google는 키를 보관합니다. 2026년에는 세 번째 키가 합류했습니다. 새로운 하이브리드 서명의 포스트 양자 절반으로, 이것이 Google Maps, OAuth, Facebook 로그인에 등록하는 지문이 더 이상 단일 값이 아닌 이유입니다. 다음은 Google의 Play Console 문서를 바탕으로 한 전체 키 모델, 정확한 콘솔 경로, 그리고 실무에서 가장 중요한 두 가지 작업인 연간 앱 서명 키 업그레이드와 업로드 키 재설정입니다.

오늘 해결할 것: 어떤 키가 무슨 역할을 하는지 파악하고, 신규 또는 기존 앱에 Play 앱 서명을 설정하고, 올바른 지문을 등록하고(최대 3개), 앱 서명 키를 업그레이드하고, 앱이나 등록정보를 잃지 않고 분실한 업로드 키를 재설정합니다.


두 개의 키, 양자 대비 서명 포함 시 세 개

Play 앱 서명 사용에 따르면, Play 앱 서명을 사용하는 모든 앱은 각기 다른 키를 다루며 각 키마다 소유자, 형식, 복구 규칙이 따로 있습니다.

  • 업로드 키 — 당신의 것입니다. 형식: Java 키스토어(.jks 또는 .keystore). 요건: 2048비트 이상의 RSA. Play Console에 업로드하기 전에 앱 번들에 서명하는 데 사용하며, Google는 이를 신원 확인에 사용합니다. 키가 유출되거나 분실되면 Google가 재설정해 줄 수 있습니다. 분리 구조의 핵심이 바로 이것입니다.
  • 앱 서명 키 — Google Play의 키. 형식: 공개 인증서(.der 또는 .pem). Google에서 생성한 키는 RSA 4096비트이며, 직접 제공하는 사용자 지정 키는 RSA 2048비트 이상이어야 합니다. Google는 이 키로 사용자 기기에 전달되는 최종 APK에 서명합니다. Play 앱 서명 외부에서 직접 관리하다가 분실하면 재설정할 수 없습니다.
  • 양자 대비 키 — Android 17을 위해 추가된 Google Play의 키입니다. 하이브리드 서명은 클래식 RSA 4096비트 키와 포스트 양자 ML-DSA-65 키를 짝짓습니다. Google은 Android 17 이전 기기에 사용하는 클래식 키와 다른 새 클래식 키를 하이브리드 서명용으로 생성하므로, 앱은 결국 세 개의 서로 다른 키를 사용하게 됩니다. Android 17 이상은 하이브리드 블록에 정확히 두 개의 서명자를 담는 APK 서명 방식 v3.2로 앱을 검증하며, 이전 Android 버전은 클래식 서명 블록으로 계속 앱을 검증합니다.

최대한의 보안을 위해서는 업로드 키와 앱 서명 키가 서로 달라야 합니다. 또한 Google가 앱 서명 키로 APK에 서명할 때 apksigner를 사용해 매니페스트에 com.android.stamp.source와 com.android.stamp.type 두 개의 스탬프를 추가하므로, APK는 원래 서명자까지 추적 가능한 상태로 유지됩니다.


신규 앱: 이제 양자 내성 서명이 기본값입니다

  1. 앱을 생성합니다. Google가 생성한 키로 양자 대응 하이브리드 서명에 자동 등록됩니다. Google는 Android 16 이하에서 인식되는 서명 블록용으로 별도의 클래식 키도 생성합니다.
  2. 업로드 키 생성 — Android Studio에서 키스토어를 생성하거나 명령줄에서 Java keytool 유틸리티를 사용하세요.
  3. 앱 번들을 업로드하세요. 등록은 업로드 시점에 이루어지며 별도의 옵트인 단계는 없습니다.
  4. 선택 사항: 직접 관리하고 싶다면 앱 서명 키를 변경하세요. Play로 보호됨 → Play 스토어 배포 → Play 앱 서명으로 이동으로 가서 앱 서명 키 변경을 클릭합니다. 이는 공개 테스트 트랙이나 프로덕션 트랙에 배포된 릴리스가 없을 때만 가능하며, 같은 개발자 계정 내 다른 앱의 앱 서명 키를 사용하거나 본인 키의 사본을 제공할 수 있습니다.

기존 앱: PEPK 도구를 통해 등록하기

여전히 직접 APK에 서명해 업로드한다면 Play 앱 서명으로 이관해 AAB와 함께 제공되는 Play 개선 기능을 활용할 수 있습니다.

  1. Play Console에서 Play로 보호 → Play 스토어 배포 → Play 앱 서명으로 이동한 후, 아직 동의하지 않았다면 서비스 약관에 동의하세요.
  2. 원본 키의 사본을 이전하세요. PEPK 도구를 내려받아 통합 단계별 안내에 따라 어떤 저장소에 있든 기존 앱 서명 키를 암호화해 업로드하세요.
  3. 새 업로드 키 생성(권장). Android Studio에서 새 키를 만들고 인증서를 Play Console에 등록하세요.

API 제공업체에 최대 세 개의 지문 등록

지도, OAuth, Facebook 로그인은 앱 서명 키의 지문으로 앱을 인증합니다. 최종 APK는 Google가 서명하므로, 해당 제공업체에는 Google가 보관한 앱 서명 키 지문을 등록해야 합니다. 로컬 업로드 키만 등록하는 것이 이관 후 흔히 발생하는 장애 원인입니다.

  1. Play로 보호됨 → Play 스토어 배포 → Play 앱 서명으로 이동으로 가세요.
  2. 앱 서명 키 섹션으로 스크롤하여 SHA-1 또는 SHA-256 지문을 복사하세요.
  3. 앱에서 양자 대응 하이브리드 서명을 사용하는 경우 세 개의 키 지문을 복사해 모두 등록하세요. 최신 기기에서 사용하는 새로운 클래식 키와 PQC 키, 그리고 구형 기기에서 사용하는 클래식 키입니다.
  4. 각 제공업체 콘솔(예: Google Cloud Console)에 붙여넣으세요. Android App Links를 사용한다면 assetlinks.json을 동일한 지문으로 업데이트하세요.

앱 서명 키 업그레이드 — 필요할 때 1년에 한 번

앱 서명 키가 유출되었거나 암호학적으로 더 강력한 키를 원한다면 연간 키 업그레이드를 요청할 수 있습니다. 업그레이드는 Android 17(API 레벨 37) 이상의 모든 설치에 적용되며, 시행 방식은 플랫폼 버전에 따라 다릅니다.

  • Android 17(API 레벨 37) 이상 — 플랫폼이 업그레이드된 양자 대응 하이브리드 키(APK 서명 방식 v3.2)를 엄격히 적용합니다.
  • Android 13~16 (API 레벨 33–36) — 플랫폼이 최신 클래식 키(APK 서명 방식 v3.1)를 엄격히 적용합니다.
  • Android 7~12(API 레벨 24~32) — 플랫폼이 업그레이드된 키를 강제하지 않으며 최신 클래식 키를 여전히 인식합니다. Play Protect는 사용자가 이를 해제하지 않은 한 업데이트가 최신 클래식 키로 서명되었는지 검증을 추가합니다.

공유 데이터 주의사항: 업그레이드된 키는 API 32 이하에서 적용되지 않으므로, 여러 앱에서 동일한 키로 데이터를 공유하는 경우 해당 구버전 Android에서는 맞춤 권한 공유 같은 기능에 레거시 키만 인식됩니다.

업그레이드 방법:

  1. Play로 보호됨 → Play 스토어 배포 → Play 앱 서명으로 이동으로 가세요.
  2. 앱 서명 키 섹션에서 키 업그레이드를 클릭하세요.
  3. 경로를 선택하세요: Google Play에서 새 앱 서명 키를 생성하거나(권장), 이 개발자 계정의 다른 앱과 동일한 앱 서명 키를 사용하거나, 앱 서명 키 사본을 제공할 수 있습니다.
  4. 저장을 클릭하세요.
  5. 새 지문을 API 제공업체에 등록하세요 — 양자 대비 서명에서는 새 키 두 개, 즉 새 클래식 키와 새 PQC 키가 필요합니다.

분실한 업로드 키 재설정

업로드 키를 분실하거나 손상이 의심되어도 앱에서 잠기지 않습니다.

  1. Android Studio에서 새 업로드 키를 생성하세요.
  2. 인증서를 PEM 형식으로 내보내기:
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
  1. Play Console에서 Play로 보호 → Play 스토어 보호 → Play 앱 서명 관리로 이동하세요.
  2. 업로드 키 인증서 섹션에서 업로드 키 재설정 요청을 클릭하고, 재설정 사유를 입력하고, upload_certificate.pem 파일을 업로드한 뒤 요청을 클릭하세요.

계정이나 앱이 소유자를 바꿀 때 이것이 의미하는 것

앱 서명 키는 Google가 보유하며 앱과 함께 이동하므로, 인수인계 작업은 업로드 키스토어와 여러분의 지문을 신뢰하는 서비스에 집중됩니다.

  • 업로드 키스토어(.jks)를 별칭, 비밀번호와 함께 받거나, 인수하는 쪽에서 업로드 키 재설정을 계획하세요.
  • 업그레이드나 초기화 후에는 지문에 의존하는 모든 연동을 재확인하세요. SHA-1로 제한된 Maps API 키, Facebook 로그인, OAuth 클라이언트, App Links용 assetlinks.json 등입니다. 이런 것들은 요란하게가 아니라 조용히 실패합니다.
  • 여전히 SHA-1 하나를 요구하는 인수인계 체크리스트는 구식입니다. 양자 대응 서명에서는 제공업체가 세 개의 지문을 확인합니다.

이 블로그의 관련 안내 두 편: Google Play 계정 및 앱 이전 점검표와 Play Console 액세스 제어 튜토리얼입니다.


Google Play 외부에서 배포하고, 이용자가 실제로 받는 것을 테스트하기

  • 모든 스토어에서 동일한 키: Google가 앱 서명 키를 생성하도록 하고 Play Console이나 Play Developer API에서 서명된 유니버설 APK를 다운로드해 다른 스토어에 배포할 수 있습니다. 테스트 및 출시 → 최신 출시 및 번들로 이동해 앱 번들을 선택하고 다운로드 탭을 여세요. 또는 앱 서명 키를 직접 생성해 Play 앱 서명을 설정할 때 사본을 Google에 전송할 수도 있습니다.
  • 실제 산출물을 테스트하세요: Internal App Sharing을 사용해 Play가 실제로 배포할 결과물을 그대로 테스트하거나, 앱 번들 탐색기에서 기기별 APK를 내려받아 adb install-multiple *.apk로 로컬에 설치하세요.
  • APK Signature Scheme v4는 대상 앱에 자동 적용되어 Android 11+ 기기에서 최적화된 배포를 지원합니다. 별도 조치는 필요 없지만, v4가 아직 양자 대응 하이브리드 서명과 호환되지 않으므로 해당 방식을 쓰는 앱은 제외됩니다.
  • 콘솔 접근 보호: 계정의 모든 사용자에게 2단계 인증을 적용하세요. 키스토어를 잃으면 복구할 수 있지만, 계정을 잃으면 복구할 수 없습니다.

사전 점검표

  • 업로드 키는 빌드 머신 외부에 백업한 키스토어에 보관하고, 별칭과 비밀번호는 비밀번호 관리자에 기록하세요.
  • 업로드 키와 앱 서명 키는 서로 다른 키입니다.
  • Play 앱 서명에 등록된 앱(신규 앱은 AAB 업로드 시 자동 등록됩니다).
  • Play Console에서 복사한 모든 앱 서명 키 지문을 모든 API 제공업체 콘솔에 입력 — 하이브리드 서명을 쓰는 경우 세 개 키 모두.
  • App Links를 사용하는 경우 assetlinks.json을 동일한 지문으로 업데이트하세요.
  • 자체 앱 서명 키를 사용하려면 출시가 공개 테스트나 프로덕션에 진입하기 전에 업그레이드를 완료하세요.
  • 업그레이드 또는 초기화 후: 지문을 다시 등록하고 실제 기기에서 연동을 재테스트합니다.
  • 모든 Play Console 사용자에게 2단계 인증 적용.

한 줄 요약

업로드 키로 서명하고, Google는 앱 서명 키로 서명하며, Android 17은 여기에 포스트 양자 키까지 더합니다. 따라서 업로드 키스토어를 백업해 두고, 모든 앱 서명 키 지문을 API 제공업체에 등록하고, 더 강력한 키가 필요할 때 연간 업그레이드 경로를 사용하며, 업로드 키를 분실하면 Play Console에서 재설정하세요.


개발자 계정을 대규모로 운영하시나요? 운영 업무를 저희가 처리합니다.

클릭하여 파일 선택 · 우클릭 → 붙여넣기, 또는 Ctrl/⌘+V로 스크린샷 붙여넣기

파일을 이 상자로 끌어다 놓아도 됩니다.

입력하신 이메일로 답변드립니다. 고객님의 정보는 KappS에만 보관됩니다.

✔ 제출 완료

메시지를 접수했습니다. 24시간 이내에 답변드리겠습니다.


← 수정으로 돌아가기