モバイルアプリにおけるシークレット管理とAPIキー保護:APK内のAPIキーが
1. 本当に問うべきは、どのキーならバイナリに含めてよいのかという一点です。Google自身のAndroidセキュリティガイダンスは、これは難読化の問題ではないと明言しています。「アプリがコンパイルされ、そのソースコードにAPIキーが含まれている場合、攻撃者がアプリを逆コンパイルしてこれらのリソースを見つけることが可能です」。APK内のすべての文字列、およびAPKにパッケージされたすべてのリソースやアセットは、公開済みとして扱ってください。したがってクライアント側のキーは、低権限でクォータ管理され、スコープが限定されたものに限られます。地図、天気、読み取り専用のコンテンツフィード、公開検索などです。金銭を動かす、他ユーザーの記録を読む、返金を行う、メールを送信する、サーバーの状態を変更する、といった処理は決してクライアントに含めず、ユーザーを認証する自社エンドポイントの背後に置きます。(§https://developer.android.com/privacy-and-security/security-tips)
2. Playのユーザーデータポリシーには「APIキー」という言葉は一切登場しません。規制するのは結果であり、だからこそキーの漏えいは単なるエンジニアリング上の問題ではなくポリシー違反になるのです。ポリシーはデベロッパーに対し「個人データおよび機密性の高いユーザーデータをすべて安全に取り扱い、最新の暗号化技術(例:HTTPS)を用いて送信すること」、および「転送中のデータには最新の暗号化技術を用いるなど、適切なセキュリティ対策でユーザーデータをすべて保護すること」を求めています。ハードコードされたキー自体は違反ではありませんが、攻撃者にユーザーデータの読み取り・書き込み・持ち出しを許すハードコードされたキーはユーザーデータポリシー違反であり、請求書や漏えい通知に加えて削除リスクが重なります。§https://support.google.com/googleplay/android-developer/answer/10144311
3. APIキーは認証ではなく、Google Cloudのドキュメントもはっきりとそう述べています。「標準のAPIキーはプリンシパルを認証しません」— APIキーはリクエストを課金とクォータのためにプロジェクトに関連付けるだけです。アプリケーション制限(ウェブサイト、IPアドレス、Androidアプリ、iOSアプリ — 一度に1種類のみ)とAPI制限は被害の限定であり、秘匿性ではありません。またAndroidアプリ制限には文書化された注意事項があります。「この制限の回避は容易です。この制限を使用する場合は、API制限も追加し、使用状況を監視する必要があります。」同じドキュメントの推奨は、API制限とアプリケーション制限の両方を設定し、キーが実際に何を呼び出しているかを監視することです。§https://cloud.google.com/docs/authentication/api-keys
4. 実効性のある衛生管理リスト。キーをリポジトリにコミットしないこと。Androidのガイダンスは、ファイルをチェックインするのではなく、secrets-gradle-pluginなどのGradleプラグインを指し示しています。開発・テスト・本番でキーを分け、さらにアプリごとにキーを分けることで、侵害されたキーを本番を止めることなく無効化できます。呼び出し元がサーバーの場合はIPで制限します。端末上にシークレット(トークン、リフレッシュ用の情報)を保持する必要がある場合は、文字列定数やアセットファイル、平文のSharedPreferencesではなく、Android Keystoreに保存し、Tinkのようなレビュー済みライブラリで暗号化してください。常にHTTPSを使用し、証明書ピンニングは代替手段ではなく追加の防御層として検討してください。§https://developer.android.com/privacy-and-security/security-tips
5. 鍵のローテーションは、インシデント時だけの反射的な対応ではなく、カレンダーに載せる定例作業です。AndroidのガイダンスはISO 27001を引用し、「ほとんどの場合、90日から6か月の鍵ローテーション期間が適切です」と述べています。Google Cloudのローテーション操作は同じ制限を持つ新しい鍵を作成し、古い鍵は削除するまで機能し続けます。この重複期間こそが要点です。現場のインストールは数週間かけて更新されるため、両方の鍵が有効な移行期間を設け、その後無効化し、削除する必要があります。鍵ID、所有者、パッケージ、スコープ、ローテーション日を一覧で管理しましょう。1プロジェクトに最大300個の鍵を保持でき、管理を失うには十分すぎる数です。§https://cloud.google.com/docs/authentication/api-keys
6. 検知できるかどうかで、漏えいが「火曜日の出来事」で済むか「四半期を失う」かに分かれます。キー単位の利用ログとクォータ・課金アラートを有効にし、重要な3つの兆候を監視してください。想定外のリファラーやIPからの急激なアクセス増、ユーザーが眠っている時間帯でのクォータ枯渇、アプリが決して呼ばないエンドポイントへのリクエストです。漏えいが確認されたら、インシデントとして決まった順序で対応します。同一の制限を付けた代替キーを作成し、クライアントのアップデートを配信し、旧キーへの通信が減るのを確認してから旧キーを無効化し、その後、漏えい期間全体のアクセスログと請求明細を確認します。あわせて、Play Consoleのデータセーフティ宣言が実態と一致しているかも確認してください。「転送時に暗号化」は実際の実行時の挙動に関する宣言であり、漏えいしたキーによって経路が平文に格下げされていたなら、その宣言は虚偽になります。§https://cloud.google.com/docs/authentication/api-keys