APIキーを保管庫へ移したら、利用先を新しいキーへ切り替え、新キーで必要な処理が通ることと、旧キーで同じ認証が拒否されることを確かめます。旧キーの無効化までが交換です。漏えいが分かっている場合は通常の切り替えを待たず、失効と侵害調査を進めます。
古いキーは、本当に使えなくなっていますか
保管場所を変えても、発行元で有効な旧キーは残ります。Cloudflareは2024年2月、2023年10月のOkta侵害で漏れた認証情報のうち、未使用と思って交換しなかったサービストークン1件とサービスアカウントの認証情報3件が、同年11月の社内Atlassian環境への侵入に使われたと報告しました。同社によると、顧客データと顧客向けシステムへの影響はありませんでした。これはAPIキーそのものの事案ではありませんが、「使っていないはず」という判断だけで古い認証情報を残す危険を示します。
通常の交換は、どの順に確認しますか
発行元のキー一覧と利用記録、アプリの設定を突き合わせ、利用先と切り替え担当を記録します。公開中のアプリに加え、夜間バッチ、検証環境、開発者用の連携も対象です。利用先が分からない場合は、失効の影響を調べてから切り替え計画を立てます。
| 順序 | 行うこと | 完了を確かめるもの |
|---|---|---|
| 1 | 新しいキーを発行し、対象の利用先へ設定する | 発行元のキー識別子と、変更した利用先・担当者の記録 |
| 2 | 各利用先で、必要な処理を新キーで実行する | 処理の成功記録。単にキーを保存できたことでは判断しない |
| 3 | 旧キーを発行元で失効させる | 発行元の管理画面やAPIが示す無効状態と時刻 |
| 4 | 許可された検証環境で旧キーの拒否を試す | 同じ認証先・操作で、新キーは成功し、旧キーは認証エラーになる結果。通信障害や権限不足との取り違えを避ける |
発行元が失効後の再試行を認めない場合は、その仕様に従い、無効状態と発行元の利用記録で確認します。キーの値をログや共有資料へ貼り付けず、識別子だけを記録してください。新キーの成功だけ、あるいは旧キーの失敗だけでは、切り替えの成否と失効の両方を示せません。
保管庫から取り出したキーは、どこへ流れますか
アプリは保管庫からキーを読み、外部APIへ送ります。例外処理がリクエスト全体や認証ヘッダーを出力すると、ログ、障害通知、デバッグ情報にもキーが残るおそれがあります。OWASPはアクセストークン、パスワード、暗号鍵などをログへ直接残さず、除去・マスクなどで扱うよう示しています。
検証環境でテスト用の資格情報を使い、許可された模擬の認証失敗を起こします。アプリのログだけでなく、転送先のログ管理サービス、障害通知、保存されたデバッグ情報まで確認します。値が出た場合は、出力した処理と転送先を記録し、値を出さない実装へ直して再試験します。
漏えいが分かったら、通常の交換と何が変わりますか
キーが公開された、第三者に渡った、または閲覧権限の広いログへ記録されたと分かったら、通常の交換日程を待ちません。利用停止の影響を担当者と確認しながら、発行元で速やかに失効させ、必要な利用先には新キーを設定します。OWASPも、不要または侵害された可能性のある秘密情報の失効を求めています。
あわせて、いつからどこに値があり、誰が閲覧でき、発行元の利用記録に不審な操作がないかを調べます。ログを消す前に調査に必要な証拠の保全方法を決め、閲覧権限と保存先も確認します。調査後は出力経路を修正し、交換後のキーが同じ経路に残らないことを試してください。
まず担当者には、利用先一覧、新旧キーの状態と試験結果、ログ・通知の点検結果を一枚にまとめてもらうと、交換漏れと調査対象を追えます。
出典
- Cloudflare「Thanksgiving 2023 security incident」調査報告(Attack timeline: October 18、November 15)
- OWASP「Secrets Management Cheat Sheet」2.7 Secret Lifecycle
- OWASP「Logging Cheat Sheet」Data to exclude、Verification、Protection
確認日:2026-11-02






