2026年版Playアプリ署名:アップロードキー・キーアップグレード・リセットのステップバイステップガイド
Play App Signingはアプリ署名を2つの役割に分けます。あなたがキーを1つ保持し、Googleがキーを1つ保持します。2026年には3つ目のキーが加わりました。新しいハイブリッド署名のポスト量子側の半分で、だからこそGoogle Maps、OAuth、Facebook Loginに登録するフィンガープリントはもはや単一の値ではありません。ここではGoogle自身のPlay Consoleドキュメントに基づくキーモデル全体、正確なコンソールのパス、そして実務で最も重要な2つの操作、年間アプリ署名キーのアップグレードとアップロードキーのリセットを解説します。
今日解決すること: どのキーが何の役割を担うのかを把握し、新規または既存のアプリにPlay App Signingを設定し、正しいフィンガープリント(最大3つ)を登録し、アプリ署名キーをアップグレードし、アプリや掲載情報を失うことなく紛失したアップロードキーをリセットします
2つのキー、量子対応署名を含めると3つ
Play App Signingを利用する場合、Play App Signing配下の各アプリはそれぞれ異なるキーで管理され、キーごとに保有者・形式・復旧ルールが異なります。
- アップロードキー — あなたのものです。形式:Javaキーストア(
.jksまたは.keystore)。要件:2048ビット以上のRSA。Play Consoleにアップロードする前にアプリバンドルに署名するために使い、Googleはあなたの身元を確認するために使います。漏えいや紛失の際はGoogleがリセットできます。これが分離の狙いそのものです。 - アプリ署名キー — Google Playのもの。 形式:公開証明書(
.derまたは.pem)。Googleが生成するキーはRSA 4096ビットで、独自に用意するキーはRSA 2048ビット以上である必要があります。Googleはこのキーを使って、ユーザーの端末に届ける最終APKに署名します。Play App Signingの外で自己管理し、紛失するとリセットはできません。 - 量子対応キー — Android 17向けに追加されたGoogle Playの機能。ハイブリッド署名は、従来型のRSA 4096ビットキーとポスト量子のML-DSA-65キーを組み合わせます。Googleはハイブリッド署名用に新しい従来型キーを生成し、これはAndroid 17以前のデバイスで使用する従来型キーとは別のものです。その結果、アプリは3つの異なるキーを使用することになります。Android 17以降はAPK署名スキームv3.2でアプリを検証し、ハイブリッドブロックには署名者がちょうど2人含まれます。それより古いAndroidバージョンは従来の署名ブロックでアプリの検証を続けます。
最大限のセキュリティのためには、アップロードキーとアプリ署名キーは別のキーにすべきです。そしてGoogleがアプリ署名キーでAPKに署名する際、apksignerを使ってマニフェストにcom.android.stamp.sourceとcom.android.stamp.typeの2つのスタンプを付加するため、APKは元の署名者まで追跡可能なままです。
新規アプリ:量子対応署名がデフォルトに
- アプリを作成します。アプリは自動的に量子対応のハイブリッド署名に登録され、鍵はGoogleが生成します。Googleはさらに、Android 16以前で認識される署名ブロック用に別の従来型鍵も生成します。
- アップロードキーを作成 — Android Studioでキーストアを生成するか、コマンドラインからJavaの
keytoolユーティリティを使用します。 - AABをアップロードしてください。 登録はアップロード時に行われ、別途オプトインの手順はありません。
- 任意:アプリ署名キーを変更して、ご自身で管理することもできます。Playで保護 → Playストアでの配信 → Playアプリ署名へに進み、アプリ署名キーを変更をクリックします。これはオープンテストトラックまたは製品版トラックでリリースが展開される前のみ可能で、同じデベロッパーアカウント内の別アプリのアプリ署名キーを使うか、ご自身のキーのコピーを提供するかのいずれかを選べます。
既存アプリ:PEPKツールで登録する
今も自前のAPKに署名してアップロードしている場合は、Play App Signingに移行してAABとそれに伴うPlayの拡張機能を利用できます。
- Play ConsoleでPlayで保護 → Playストアでの配信 → Playアプリ署名へ移動し、まだ同意していない場合は利用規約に同意してください。
- 元のキーのコピーを移行する。 PEPKツールをダウンロードし、統合された手順に従って、任意のリポジトリから既存のアプリ署名キーを暗号化してアップロードする。
- 新しいアップロードキーを作成(推奨)。Android Studioで新しいキーを生成し、その証明書をPlay Consoleに登録します。
APIプロバイダーに最大3つのフィンガープリントを登録する
Maps、OAuth、Facebook Loginは、アプリ署名キーのフィンガープリントでアプリを認証します。Googleが最終的なAPKに署名するため、Googleが保持するアプリ署名キーのフィンガープリントを各プロバイダーに登録する必要があります。ローカルのアップロードキーだけを登録するのが、移行後に典型的に発生する不具合です。
- Playで保護 → Playストアでの配信 → Playアプリ署名に移動。
- アプリ署名キーセクションまでスクロールし、SHA-1またはSHA-256のフィンガープリントをコピーする。
- アプリが量子対応のハイブリッド署名を使用している場合は、3つのキーのフィンガープリントをコピーし、すべて登録してください。新しいクラシックキーと新しい端末で使用するPQCキー、さらに旧端末で使用するクラシックキーです。
- 各プロバイダーのコンソール(例:Google Cloud Console)に貼り付けてください。Android App Linksを使っている場合は、
assetlinks.jsonを同じフィンガープリントで更新します。
アプリ署名キーを更新する — 年1回、必要なタイミングで
アプリの署名キーが漏えいした場合、または暗号学的により強固なキーが必要な場合は、年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のバージョンではカスタム権限の共有などの機能にレガシーキーしか認識されません。
アップグレード方法:
- Playで保護 → Playストアでの配信 → Playアプリ署名に移動。
- App signing keyセクションで、Upgrade keyをクリックします。
- 方法を選択してください。Google Playに新しいアプリ署名キーを生成させる(推奨)、このデベロッパーアカウント内の別のアプリと同じアプリ署名キーを使用する、またはアプリ署名キーのコピーを提供する。
- 保存をクリックします。
- 新しいフィンガープリントをAPIプロバイダーに登録します — 量子対応署名では、新しい古典鍵と新しいPQC鍵の2つの新しい鍵が必要です。
アップロードキーを紛失した場合のリセット
アップロードキーを紛失したり侵害を疑われたりしても、アプリから締め出されることはありません。
- Android Studioで新しいアップロードキーを作成します。
- 証明書をPEM形式でエクスポートします:
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
- Play Consoleで、Playで保護 → Playストアの保護 → Playアプリ署名の管理に移動します。
- アップロードキーの証明書セクションでアップロードキーのリセットをリクエストをクリックし、リセットの理由を入力して
upload_certificate.pemファイルをアップロードし、リクエストをクリックします。
アカウントやアプリが譲渡されたときに何が起きるか
アプリ署名キーはGoogleが保持し、アプリとともに移動するため、引き継ぎ作業はアップロード用キーストアと、あなたのフィンガープリントを信頼するサービスに集中します。
- アップロード用キーストア(
.jks)をエイリアスとパスワードとともに入手するか、受け取り側でアップロードキーのリセットを計画してください。 - アップグレードやリセットの後は、フィンガープリントに依存するすべての連携を再確認しましょう。SHA-1で制限されたMaps APIキー、Facebookログイン、OAuthクライアント、そしてApp Links用の
assetlinks.jsonです。これらは大げさにではなく、静かに壊れます。 - 引き継ぎチェックリストが未だにSHA-1を1つだけ求めているなら、それは時代遅れです。量子対応の署名では、プロバイダーは3つのフィンガープリントを確認します。
このブログの関連ウォークスルー:Google Playアカウントとアプリの移管チェックリスト、およびPlay Consoleアクセス制御チュートリアル。
Google Play外での配信、そしてユーザーが実際に受け取るものをテストする
- すべてのストアで同じキー:Googleにアプリ署名キーを生成させ、Play ConsoleまたはPlay Developer APIから署名済みユニバーサルAPKをダウンロードして他のストアで配布できます。テストとリリース → 最新のリリースとバンドルに進み、アプリバンドルを選択してダウンロードタブを開きます。あるいは、アプリ署名キーを自分で生成し、Play App Signingの設定時にそのコピーをGoogleに転送します。
- 実際の成果物をテストする: Internal App Sharingを使ってPlayが配信するそのままのものをテストするか、App Bundle Explorerからデバイス固有のAPKをダウンロードし、
adb install-multiple *.apkでローカルにインストールしてください。 - APK Signature Scheme v4は対象アプリに自動適用され、Android 11以降の端末での最適化された配信を支えます。対応は不要ですが、量子対応ハイブリッド署名を使うアプリは除外されます。v4はまだこれに対応していないためです。
- コンソールへのアクセスを保護: アカウントの全ユーザーに2段階認証を強制してください。キーストアを失っても復旧できますが、アカウントを失うと復旧できません。
事前チェックリスト
- アップロードキーはビルドマシン外にバックアップしたキーストアに保存し、エイリアスとパスワードはパスワードマネージャーに記録します。
- アップロードキーとアプリ署名キーは別のキーです。
- アプリがPlay App Signingに登録済み(新規アプリはAABアップロード時に自動登録)。
- Play Consoleからコピーしたすべてのアプリ署名キーのフィンガープリントを、各APIプロバイダーのコンソールに登録済み — ハイブリッド署名を使用している場合は3つすべてのキー。
- App Linksを使用する場合は、
assetlinks.jsonを同じフィンガープリントで更新します。 - 独自の署名キーを使いたい場合は、リリースがオープンテストまたは製品版に進む前にアップグレードを済ませてください。
- アップグレード後またはリセット後:指紋を再登録し、実機で連携を再テストする。
- すべてのPlay Consoleユーザーに2段階認証を必須化。
一行でまとめると
あなたはアップロードキーで署名し、Googleはアプリ署名キーで署名します。さらにAndroid 17ではポスト量子キーも加わるため、アップロードキーストアをバックアップし、すべてのアプリ署名キーのフィンガープリントをAPIプロバイダーに登録し、より強固なキーが必要なときは年次アップグレードの道筋を使い、アップロードキーを紛失した場合はPlay Consoleでリセットしてください。
情報源
デベロッパーアカウントを大規模に運用中ですか? 運用面は当社が対応します。
メッセージを受け付けました。24時間以内に返信します。
← 編集に戻る