Leadde Logo

APIキーとアクセストークンを保護するためのベストプラクティス

APIキーのリスク、よくある間違い、安全な保管方法、最小権限の原則、キーローテーション戦略の概要。
L作成者 Leadde 更新日 2026年8月19日

APIキーが漏洩するとどうなるか

漏洩したAPIキーはほぼ瞬時に悪用されます。自動スキャナーは公開リポジトリを常に監視しており、キーを含むコミットは、開発者がプルリクエストを完了する前に発見され、試行されるのが一般的です。キーが最終的なコードに残る必要はなく、コミット履歴のどこかに存在すれば十分なのです。

ほとんどの開発者が驚くのは、この履歴の時点です。後のコミットでキーを削除しても何も変わらず、リポジトリにはまだキーが含まれています。履歴を書き換えるための強制プッシュは、めったに間に合いません。プライベートリポジトリは安全だという思い込みも同様に崩れます。リポジトリは可視性を変更することがあり、フォークは親よりも長く存続するからです。画面に表示すべきでないのは、有効期限切れの資格情報や、部分的にマスクされた値を示すコンソールのスクリーンショットなど、実際のあらゆる資格情報です。

この課題への対策は、以下の7つのシーンで解説します。キーがどのように発見されるか、履歴の問題、トークンのスコープ設定と最小権限について2つ、シークレットが実際にどこに存在すべきか、ローテーションとローテーション計画に含めるべきこと、そして漏洩が疑われた後の最初の1時間で何をすべきか、です。

シークレットポリシーを開発者が遵守するものにする方法

どのエンジニアリング組織にもシークレットポリシーはありますが、キーは依然としてリポジトリに流れ着きます。そのギャップは、安全な方法が金曜日に開発者の20分を要するのに対し、危険な方法は何もコストがかからないという点にあります。このトレードオフに対処しないコンテンツは、単なる飾りでしかありません。

スキャンがキーを発見する様子を、時間とともに示す

スキャンがキーを発見する様子を、時間とともに示す

プッシュ後数分で自動検出されるのを見ることは、リスクに関するどんな説明よりも効果的です。そのスピードこそが説得力です。

スコープ設定を原則論ではなく具体的にする

1つのリソースと1つの環境に限定された読み取り専用キーは、具体的な成果物です。最小権限という概念だけでは、完全なアクセス権を持つキーに「良い意図」が付随するだけになりがちです。

ローテーションにスケジュールではなくトリガーリストを与える

キーは、誰かが退職したとき、ラップトップが紛失したとき、ベンダーとの契約が終了したとき、そして定期的な間隔でローテーションされます。定期的な間隔しか持たないチームは、インシデント発生時に他の3つのトリガーの重要性を発見することになります。

漏洩後の最初の1時間で何をすべきか

調査する前に失効させましょう。開発者は本番環境を壊すことを恐れて失効を遅らせがちですが、その遅延こそが露出したキーをインシデントに変えてしまうのです。

必要なものはすべてシークレット標準にあります

シークレット管理標準、開発者オンボーディングガイド、または前回の露出に関するインシデント後レビューを、PDF、DOC、DOCX、PPTX、TXT形式で最大200MBまでアップロードしてください。すべてのシーンは編集可能になり、アップロードされた内容はそのまま保持されます。

リポジトリを公開する前にキーをローテーションする

プラットフォームチームが公開しているシークレット管理標準から始めましょう。次の開発者採用まで、すべて編集可能な状態が維持されます。

avatar

このテンプレートから始めて、共有可能な動画を完成させましょう。

オンボーディングガイドやヘルプセンターページを追加すれば、数分で編集可能な下書きが生成されます。