KappSナレッジベース · FAQ

Google PlayにおけるPlay Integrity APIの実装と移行

FAQ 技術コンプライアンス

1. 移行は任意ではありません。SafetyNetは完全に停止しています。Googleは非推奨化のタイムラインで次のように述べています。「SafetyNet Attestation APIは2022年に非推奨となり、2025年1月に完全に停止されました。デベロッパーは、複数の整合性ソリューション(SafetyNet Attestationの整合性判定を含む)を単一のAPIに統合するPlay Integrity APIへ移行する必要があります。」現在残っている呼び出しは失敗します。「SafetyNet Attestation APIを呼び出そうとすると、エラーが発生します。attest APIは、常にonFailureリスナーをApiExceptionおよびステータスコード7(NETWORK_ERROR)で呼び出すタスクを返します。」SafetyNetを呼び出すバージョンをまだ配信している場合は、ユーザーにアップデートを促してください。(https://developer.android.com/privacy-and-security/safetynet/deprecation-timeline)

2. APIが実際に検証するもの。「Play Integrity APIは、ユーザーの操作やサーバーリクエストが、Google Playによってインストールされ、正規の認定済みAndroidデバイスで動作する、あなたの正規のアプリから来ていることを確認するのに役立ちます」。3つの主要な判定結果を返す。accountDetails(不正アクセス - ユーザーがGoogle Playでアプリをインストールまたは購入したか)、appIntegrity(コード改ざん - バイナリがGoogle Playが認識する未改変のものか)、deviceIntegrity(リスクのあるデバイスやエミュレート環境 - 正規の認定済みAndroidデバイスか、Google Play Games for PCの正規インスタンスか)。オプションの判定結果として、MEETS_STRONG_INTEGRITY(最近のセキュリティアップデート、Android 13以上)、appAccessRiskVerdict(他のアプリによる画面キャプチャ、オーバーレイ、アクセシビリティの悪用)、playProtectVerdict(Play Protectが有効で危険なアプリがない)、recentDeviceActivity(異常に高いリクエスト量)、deviceRecall(ベータ)が加わる。(https://developer.android.com/google/play/integrity/overview)

3. Google Cloudプロジェクトを作成してリンクします。「APIを統合するには、Google Cloudプロジェクトが必要です…その後、Google Play Console(アプリの場合)またはGoogle Play SDK Console(SDKの場合)でGoogle Cloudプロジェクトをリンクできます。プロジェクトのリンクは必須です」とあり、これにより高度な機能と割り当ての増加が利用可能になります。Play Integrity APIはGoogle Cloud Consoleで有効にできますが、先にリンクすれば自動的に有効になります。落とし穴に注意してください。「Google Cloud Consoleで有効になっていても、Play ConsoleまたはPlay SDK Consoleでリンクされていないプロジェクトは、追加機能の対象外です。」(https://developer.android.com/google/play/integrity/setup)

4. 標準リクエストとクラシックリクエストのどちらかを選びます。両者はレイテンシとキャッシュの点で異なります。標準リクエストはレイテンシが最も低く(「平均で数百ミリ秒」)、使用可能な判定を取得できる信頼性が高く、スマートなオンデバイスキャッシュを使用し、特定の攻撃からの保護をGoogle Playに委ねます。トークンプロバイダーを一度準備(「ウォームアップ」)し(インスタンスは「1分間に最大5回までインテグリティトークンを準備できる」)、その後は必要に応じてトークンをリクエストします。クラシックリクエストは元々の経路で、レイテンシが高く(「平均で数秒」)、より多くのユーザーデータとバッテリーを消費する新たな評価を開始し、特定の緩和策を開発者に委ねるため、機密性の高い操作や価値の高い操作に対して「単発で、頻繁でなく」行うべきです。どちらもAndroid 6.0(APIレベル23)以上が必要です。明確なルール:「クラシックリクエストを行い、それをキャッシュして後で使うことを検討しているなら、攻撃のリスクを減らすために標準リクエストを行うべきです」。(https://developer.android.com/google/play/integrity/overview, https://developer.android.com/google/play/integrity/standard)

5. 検証は必ずサーバー側で行い、クライアント側では決して行わない。流れは次のとおりです。アプリがGoogle Cloudプロジェクト番号でトークンプロバイダを準備し、リクエストハッシュを渡して整合性トークンを要求します。署名・暗号化されたトークンを受け取り、バックエンドに渡します。そして「アプリのバックエンドがトークンをGoogle Playサーバーに送信します。Google Playサーバーが復号して判定を検証し、結果をアプリのバックエンドに返します」。判定の適用はバックエンドのみで行ってください。クライアント側のチェックはパッチで外せます。(https://developer.android.com/google/play/integrity/standard)

6. トークンを特定のリクエストに紐付ける。標準リクエストは、トークン要求時に指定したリクエストハッシュに紐付けられます。クラシックリクエストはnonceフィールドを使い、リクエストデータまたはサーバー側ロジックに基づくコンテンツバインディングを行います。判定結果をキャッシュして再利用しないでください。「判定結果をキャッシュすると、情報漏えいやリプレイなどの攻撃リスクが高まります」。クラシックの判定結果を後で使うためにキャッシュしようとしていたなら、標準リクエストに切り替えてください。(https://developer.android.com/google/play/integrity/classic)

7. クォータを守る。「デフォルトでは、アプリはすべてのインストールを通じて1日あたり最大10,000リクエストを送信できます」— 1日の上限を引き上げるリクエストは可能ですが、それを前提に余裕を持たせ、トークンプロバイダーの準備は頻繁に行わないようにしてください(インスタンスあたり毎分最大5回まで)。(https://developer.android.com/google/play/integrity/overview)

8. 正当なユーザーを壊さずに判定を展開する。Googleの明確な推奨事項は次のとおりです。まず「執行なしでAPIを実装」し、「対応する前にテレメトリを収集してオーディエンスを理解」し、その後、計画している執行の影響を見積もって不正対策戦略を調整する。APIは戦略全体ではなく一つのシグナルとして扱いましょう。「Play Integrity APIは、不正対策の唯一の仕組みとしてではなく、全体的な不正対策戦略の一環として他のシグナルと併用するときに最も効果を発揮します」。このAPIはスマートフォン、タブレット、折りたたみ端末、Android Auto、Android TV、Android XR、ChromeOS、Wear OS、PC版Google Play Gamesで利用できます。(https://developer.android.com/google/play/integrity/overview)

バージョンとクォータの境界(2026-10-13にGoogleのページで確認済み):

ライブラリのバージョン。現行リリース(1.5.x系)では、標準リクエストとクラシックリクエストにAndroid APIレベル23(Android 6.0)以上が必要です。1.4.0系ではAPIレベル21(Android 5.0)以上に対応していました。実際に使用するバージョンの最小要件は、チュートリアルではなくライブラリのリリースノートで確認してください。

クォータの種類。デフォルトの上限は関連付けられたCloudプロジェクト番号に紐づく1日10,000リクエストで、Googleはトークンリクエスト(クライアント側)とトークン復号(サーバー側)を別々のクォータアクションとして追跡します。クライアント側で大量にリクエストしても、それ自体がサーバー側の復号クォータを消費することはありません。より大きな量が必要な場合はGoogleからクォータの引き上げを申請してください。

プロジェクトの紐付け。APIを使うには、Play Consoleでアプリに(またはPlay SDK ConsoleでSDKに)Google Cloudプロジェクトを紐付ける必要があります。割り当て量はそのプロジェクト番号に紐付くため、同じCloudプロジェクトを共有するアプリは1つの上限を共有します。