本番環境で API キーをどこに置くべきか
認証情報をブラウザ、リポジトリ、日常のログから遠ざけます。

ブラウザは秘密の保管場所ではない
フロントエンドに埋め込まれたキーは、ビルド時の環境変数から来たものでも利用者に見える可能性があります。強い権限を持つキーは管理下のサーバーに置きます。ブラウザは認証済みバックエンドを呼び、バックエンドが権限を確認してから API にアクセスします。
ブラウザーがバックエンドを呼び、バックエンドがキーを読み取って API を呼び、必要な結果だけを返す流れを考えます。キーを HTML、フロントエンドのスクリプト、公開モバイル設定、URL のクエリに入れてはいけません。HTTPS は通信を保護しますが、配布されたクライアントコードを受け取った人による閲覧は防げません。
環境ごとに鍵を分ける
開発用と本番用には別々の認証情報を使い、対応していればアプリやチームごとにも分けます。環境設定または専用の秘密情報管理に保存し、リポジトリや公開チケットに載せません。必要な権限と使用量の範囲に絞りましょう。
開発、テスト、本番で異なるキーを使い、可能ならアプリやチームでも分けます。一つが漏れたとき影響範囲を把握しやすく、個別に失効できます。関係のないサービスで高権限キーを共有せず、利用できる権限、使用量、アクセス制限を設定します。担当者と用途は記録し、キーの平文は台帳に保存しません。
API キーを保護し、公開されるアプリのコードから分離する。漏れたときに交換できるように
スクリーンショット、ログ、公開コミットにキーが現れたら、漏えいしたものとして扱います。失効またはローテーションし、新しい値をデプロイして利用状況を確認します。最新コミットから消しても履歴に残る場合があります。担当者と連絡方法を事前に決めておきます。
漏えい時は対象キーを制限または失効し、代替を作成してデプロイし、関連する使用量とアクセスを調べます。事前の練習は混乱を減らします。新しいキーをチャットやチケットに貼ってはいけません。すぐに切り替えられないサービスには担当者と移行手順を決め、旧キーが不要になるまで監視します。
周辺の出力も点検する
ログ、エラー報告、サポートへの連絡から認証ヘッダーやキーを取り除きます。プロキシ、CI の出力、外部連携も確認してください。短い対応手順と定期的な権限の見直しが役立ちます。利用可能な制御は最新のドキュメントで確認します。
ソース以外にビルド成果物、CI 出力、エラー監視、プロキシログ、スクリーンショットも確認します。調査中に認証ヘッダー、完全な要求、環境変数が表示される場合があります。ログは脱敏し、必要な情報だけを残します。公開リポジトリに漏れたキーは履歴やキャッシュにも残り得ます。
人、アプリ、環境が変われば、以前は必要だった権限も不要になることがあります。未使用キー、広すぎる権限、異常な使用量を確認し、不要なアクセスを取り消します。利用可能な制限は実際のプラットフォームに従います。アカウント、サーバー権限、依存関係の安全も重要です。
キーが現れる場所を洗い出す
リポジトリ、デプロイ設定、CI ログ、問い合わせ、スクリーンショット、ブラウザの通信を確認します。フロントエンドの環境変数も、ブラウザへ配布するコードに埋め込まれれば秘密ではありません。モバイルやデスクトップのアプリも解析され得るため、長期間使える高権限キーの保管場所には向きません。
クライアントは自分のサーバーを呼び、サーバーがユーザーの認証、入力、利用制限を確認してから、環境変数または秘密管理サービスからキーを読み取ります。URL のクエリには入れません。履歴やプロキシに残ることがあり、エラーでも認証ヘッダーを表示しないようにします。
開発、テスト、本番の認証情報を分け、利用可能な範囲で権限、上限、有効期間を制限します。不要になった連携や担当者の変更時にも、アクセスが残っていないか確認します。
実行できるローテーション手順を用意する
誰がキーを作成・無効化でき、どのサービスが参照しているかを確認します。代替キーを安全な設定経路で反映し、最小の要求で動作確認してから、プラットフォームの仕様に沿って古いキーを停止します。新旧の値をチャット、工票、ログへ貼り付けません。
漏えいが疑われるときは、まず影響するキーを制限または停止し、不審な利用を確認して依存サービスを更新します。その後、公開コミットやデバッグ画像など原因を調べます。コードの一行を削除しても、履歴やキャッシュに残る可能性があるため、それだけではキーは無効になりません。
テスト専用の認証情報で手順を演習し、担当者と通知経路を確認します。停止順序は重複利用が可能か、無停止で切り替えられるか、事件の緊急度に応じて判断します。
日常的に維持できる対策にする
用途を識別できる名前と責任者を決め、必要な環境だけにキーを渡します。不要な設定を定期的に整理し、コードレビューや自動検出も利用します。ただし検出だけで最小権限やローテーションの代わりにはなりません。
通常と異なる利用量の増加や認証失敗などを、実際の事業に合わせて監視します。通知には時刻、エラーの種類、機密ではない識別子を含め、完全なキーを載せません。ログを閲覧できる人にも適切な権限が必要です。
公開前にはビルド済みのファイルや画像にキーが混入していないか、停止したキーが使えないか、担当者が更新方法を知っているかを確かめます。外部サービスには可能なら専用キーを渡し、連携終了時に個別に取り消せるようにします。
公開前の短いチェック
デプロイ前にフロントエンドの成果物とリポジトリ履歴に認証情報がないか調べ、本番用の独立したキーを確認し、バックエンドから小さなリクエストを送ります。エラー報告が認証ヘッダーを隠すことも確認します。キーが漏れた場合は、表示部分を削除するだけでなく、先に交換して使用状況を調べます。
サービスごとにキーの作成と失効、代替のデプロイ、異常使用の調査を誰が担当するか決めます。引き継ぎ時には記録を更新し、不要なアクセスを削除します。演習にはテスト用キーを使い、本番の秘密をデモ資料にコピーしないようにします。