APIキーが漏れたら何をする?無効化からチーム管理までの手順
外部サービスのAPIキーを使い始めたものの、どこに保存すればいいのか、チームにどう渡せばいいのかで手が止まっていませんか。うっかりGitHubに公開してしまったとき、何から手を付けるべきかも気になるところです。この記事では、APIキー管理の基本、環境変数とシークレット管理サービスの使い分け、漏えい時の初動、チームで続ける運用までを、手を動かせる形でまとめます。
APIキーが漏れると何が起きる?コードやログに残るリスク
APIキーは、APIの利用者や利用するアプリを識別するための合言葉のようなものです。キーだけで認証できる場合、キーを持っている第三者があなたの契約でリクエストを送れるおそれがあります。従量課金のAPIなら、身に覚えのない請求が届くケースがあります。顧客データを扱うAPIなら、キーに与えられた権限によっては情報の読み出しにも使われかねません。
漏れる経路は、派手な攻撃だけではありません。コードに直接書いたままGitにコミットしてしまう、というミスもあります。公開リポジトリに載せると、キーを自動で探すスキャナーに拾われる可能性があります。GitHubも公開リポジトリで既知の形式のシークレットを検出する仕組み(Secret scanning)を提供しています。
ログも見落としがちです。リクエストのヘッダーをデバッグ出力した結果、Authorizationヘッダーごとログに残ってしまうことがあります。エラー監視ツールに送られるスタックトレースや、スクリーンショット、チャットへの貼り付けも漏えい経路になりえます。
ここで押さえたいのは、一度Gitの履歴に入ったキーは、ファイルから消しても履歴に残るという点です。次のコミットで削除しても、過去のコミットを見れば読めます。だから「消した」では解決にならず、後述の無効化が必要になります。
サンプル用のダミーキーで試す、設定ファイルと環境変数の扱い方
基本方針は単純です。キーをコードに書かず、実行時に外から渡します。ここでは本物のキーではなく、ダミーの値で試してみましょう。
まず、プロジェクト直下に .env ファイルを作ります。値はダミーです。
EXAMPLE_API_KEY=dummy-key-1234567890
次に、このファイルをGitの管理対象から外します。.gitignore に1行足してください。
.env
.env はPythonに自動で読み込まれないため、ここでは python-dotenv をインストールします。
pip install python-dotenv
コードで .env を読み込み、環境変数として値を取り出します。
import os
from dotenv import load_dotenv
load_dotenv()
api_key = os.environ.get("EXAMPLE_API_KEY")
if not api_key:
raise RuntimeError("EXAMPLE_API_KEY が設定されていません")
ここで、キーが無いときに早めにエラーにしているのが地味に効きます。空のまま外部APIを呼ぶと、原因の分かりにくい認証エラーになるためです。Node.jsでも、dotenv といったライブラリを使って .env を読み込めます。
もうひとつ、.env.example というファイルを用意する運用をおすすめします。中身はキー名だけ、値は空かダミーにして、こちらはGitに入れます。新しくチームに入った人が「どの変数を設定すればいいのか」を一目で分かります。.gitignore への追加は、最初のコミットより前にやるのが鉄則です。後から足しても、すでに追跡されたファイルは対象から外れません。
環境変数の限界と、シークレット管理サービスを使う場面
環境変数は手軽ですが、万能ではありません。個人的には、ローカル開発や小さな個人プロジェクトなら環境変数と .env で十分だと思っています。一方で、本番環境やチーム開発に入ると限界が見えてきます。
限界のひとつは、環境変数や .env 自体には、安全に共有する仕組みがないことです。.env をSlackやメールで送り合う運用では、チャットやメールの履歴にキーが残るおそれがあります。もうひとつは、誰がいつ読んだかの記録を .env 自体では残せないこと、そして更新の手間です。キーを変えるたびに全員の .env を書き換える運用は、人数が増えると負担になります。プロセスの環境変数は、クラッシュレポートやデバッグ用のダンプに含まれることもあります。
そこで登場するのが、シークレット管理サービスです。AWS Secrets Manager、Google Cloud Secret Manager、HashiCorp Vault、各CI/CDが持つ暗号化済みシークレット機能などが代表例です。保存時の暗号化やアクセス権の設定に加え、アクセス履歴の記録、バージョン管理、自動ローテーションに対応するサービスもあります。対応範囲や設定方法はサービスごとに違うので、利用中のサービスの公式ドキュメントで確認してください。
使い分けの目安は、こんな場面です。
- 本番環境にデプロイするアプリがキーを使う
- 複数人がキーにアクセスする
- 退職や異動のたびにキーを切り替える必要がある
このどれかに当てはまったら、導入を検討するタイミングだと考えています。ただし、小さなチームで最初から大がかりな仕組みを入れると、運用が重くなって形骸化するリスクもあります。まずは利用中のクラウドが標準で持つ機能から始めるのが現実的です。
キーを公開してしまったときの初動:無効化・再発行・影響確認
公開してしまったら、最優先はキーの無効化です。履歴の削除より先にやります。公開から検出までの時間が短くても、すでにコピーされた可能性があるためです。焦る場面ですが、まずは無効化し、影響を確認しましょう。
- 該当サービスの管理画面で、漏れたキーを無効化(revoke)する
- 新しいキーを発行し、シークレット管理側や環境変数を差し替える
- 利用履歴や請求を確認し、身に覚えのないアクセスがないか調べる
- コードやログから該当キーを取り除き、再発防止策を入れる
2と3の順序は、状況で前後します。サービスを止めたくなくて、新キーに切り替えてから旧キーを無効化する運用もあります。ただ、すでに悪用が疑われるなら、止まってでも先に無効化するほうが安全です。この判断は、キーの権限の強さや停止による影響で変わります。
影響確認では、各サービスで確認できる範囲の利用ログやAPI呼び出し回数、課金の推移を見ます。記録があれば、普段と違う国やIPからのアクセス、深夜の急増が手がかりです。被害が確認できた場合は、サービス提供元のサポートへ早めに連絡してください。不正利用分の扱いは事業者ごとに違い、一律に免除されるとは限りません。
履歴の書き換え(git filter-repo など)は、無効化のあとの補助作業です。やっても、すでにクローンやフォークされたコピーは消せません。キーが無効になっていれば、そのキーによる新たな不正利用は防げます。ただし、無効化前にデータを取得されていた可能性などは別途確認が必要です。「履歴を消したから安心」と考えないようにしましょう。
チームで続けたい最小権限とアクセス権の見直し
漏えいを完全にゼロにするのは難しいです。だから、漏れても被害が小さくなる設計を目指します。その軸が最小権限の原則です。キーには、その用途に必要な操作だけを許可します。読み取りだけで足りるなら、書き込み権限は付けません。サービスによっては、スコープの限定、IPアドレス制限、利用上限や予算アラートを設定できます。予算アラートは通知であり、利用を自動停止するとは限りません。
運用面では、次のような習慣が効きます。環境ごと(開発、ステージング、本番)にキーを分ける。用途ごとにキーを発行し、共有が必要な場合も誰が使っているか追えるようにする。定期的にキーを入れ替える。そして、使っていないキーは削除する。棚卸しは地味ですが、効果は大きいです。
仕組みで守ることも考えましょう。コミット前にシークレットを検出するツール(gitleaks、detect-secrets など)をpre-commitフックやCIに組み込むと、うっかりを検出しやすくなります。ただし、すべてのキーを検出できるとは限りません。正直なところ、ここが一番費用対効果の高い対策だと感じます。
退職や異動のときのアクセス権の見直しも、手順に入れておいてください。共有キーを使っていると、誰かが抜けるたびに全員分の差し替えが発生します。
今日できる一歩は、手元のリポジトリで git log -p と gitleaks を使い、過去にキーを載せていないか確認することです。


