micomia株式会社の畑井です。
OpenAIのAPIを呼び出して文章を生成する、Googleマップを埋め込む、メールを送信する。
こうした機能を自分のアプリケーションに組み込むとき、ほぼ必ずAPIキーを取得して設定することになります。
AIを使った開発では数行の指示で組み込めてしまうため、キーを発行して貼り付けたあと、そのまま運用に入ってしまうことが少なくありません。
APIキーが漏洩すると、金銭的な被害が直接発生します。
他人が自分の契約で大量のリクエストを送れるようになり、その利用料が請求されるためです。
送信系のAPIであれば、自分の名義で迷惑メールを送られることもあります。
APIキーが何を証明しているのか、どこから漏れるのか、そして定期的な入れ替えをどう運用するのかを解説します。
目次
APIキーは「支払う人」を証明している

APIキーとは、外部サービスの機能を使うための鍵。ChatGPTのAI生成機能なども、APIキーを入れると使えるようになる
APIキーは、サービスの提供元に対して「このリクエストは自分の契約によるものです」と伝えるための文字列です。
利用量の記録と課金は、このキーに紐づいて行われます。
ここで注意したいのは、APIキーが本人確認ではなく、所持の証明でしかないという点です。
キーを持っている人は誰でも、その契約の持ち主として扱われます。
パスワードのように二要素認証で守られているわけではないため、文字列が一度外に出た時点で、取得した人は制限なく使えるようになります。
従量課金のサービスでは、この違いがそのまま被害額になります。
利用量の上限を設定していなければ、短時間で想定を大きく超える請求が発生します。
気づくのは請求が来てからになりやすい
APIキーの漏洩が厄介なのは、起きたことが画面に出てこない点です。
アプリケーションは普段どおり動き続けるため、管理画面を見ていても異常が分かりません。
実際に発覚するきっかけは、月末の請求額が普段の数倍になっていた、利用者から身に覚えのないメールが届くという問い合わせが来た、といった後追いのものがほとんどです。
その時点では、すでに数週間分の不正利用が積み上がっています。
そのため、漏洩を前提にした備えが必要になります。
具体的には、利用量の上限とアラートを先に設定しておくことと、キーを定期的に入れ替えることの2つです。
キーが外に出る経路

APIキーの守り方のチェックリスト。プロンプトに入れない・AIに送らない、カフェなど公衆の場で発行しない、見せるのは必要最低限の人だけ、アプリの中で厳密に管理する
APIキーは、攻撃を受けて盗まれるよりも、日常の作業の中で持ち出されることのほうが多くあります。
AIに相談するときの貼り付けは、その代表例です。
エラーが解決しないときに設定ファイルや環境変数をそのまま貼り付けてしまうと、キーを含んだ内容が外部のサービスへ送信されます。
やり取りの内容が学習や保存の対象になるかどうかはサービスや契約によって異なるため、キーは伏せ字にしてから相談する習慣にしておくと安全です。
次に、キーをアプリケーションの中に直接書き込んでしまうケースがあります。
画面側のコードに書かれたキーは、ブラウザの開発者ツールやアプリの解析で取り出せます。
表示していない情報でも通信の中身は読めるという点は、Firestoreのセキュリティルールでも同じ問題になります。
外部APIの呼び出しは、キーを持たせたサーバー側から行い、画面側はそのサーバーに依頼する構成にします。
キーを発行する場所にも注意が必要です。
カフェや移動中の公衆無線LANなど、通信経路が信頼できない環境でキーを発行したり貼り付けたりするのは避けたほうがよいと考えています。
作業環境そのものを含めた情報セキュリティ対策の進め方についても、別の記事で整理しています。
公開リポジトリへのコミットも、典型的な経路のひとつです。
キーは環境変数に置き、バージョン管理の対象から外す設定を最初に入れておきます。
月に一度の入れ替えを運用に組み込む

漏洩のリスクを下げるため、月に1回程度キーを入れ替える
漏洩したかどうかを確実に知る方法はありません。
そのため、仮に漏れていても被害が続かないようにする考え方が必要になります。
これがキーのローテーションです。
月に一度を目安にキーを新しく発行し、古いキーを失効させます。
入れ替えを前提にしておくと、過去のどこかの時点で外に出ていたとしても、使える期間がその一か月に限定されます。
# 月次のローテーションでやること
1. 新しいキーを発行する
2. 本番環境の環境変数を新しいキーに差し替える
3. アプリケーションが新しいキーで動作することを確認する
4. 古いキーを失効させる失効を最後に回すのは、切り替えの途中でサービスを止めないためです。
新旧2本のキーを一時的に有効にしておける期間があるかどうかは、サービスによって異なります。
人の出入りがある開発では特に重要になる

人の出入りが多いと昔のキーが危ないため、退職者が出たらキーを入れ替える
複数人で開発している場合、ローテーションの意味はさらに大きくなります。
開発に参加していた期間中、メンバーはキーを見られる立場にあります。
プロジェクトを離れたあとも、その文字列を記録していれば使える状態が続きます。
悪意があるかどうかにかかわらず、アクセスできる状態が残っていること自体が問題です。
メンバーが抜けたタイミングでキーを入れ替えておけば、在籍中に把握していたキーはその時点で使えなくなります。
退職や契約終了の手続きに、キーの入れ替えを含めておくとよいと考えています。
あわせて、キーを見られる人を必要最小限にとどめておくことも有効です。
開発を外部に委託する場合、アカウントそのものを渡すのではなく、権限を絞った招待で参加してもらう形にしておくと、入れ替えの手間も減ります。
確認しておきたい項目
確認する内容 | 見るべきポイント |
|---|---|
保管場所 | コードに直接書かず、環境変数に置いているか |
バージョン管理 | 設定ファイルが管理対象から外れているか |
呼び出し元 | 外部APIを画面側から直接呼んでいないか |
利用上限 | 請求額の上限とアラートを設定しているか |
権限 | キーごとに使える機能を絞り込んでいるか |
入れ替え | 発行日と最終更新日を記録しているか |
利用上限については、サービス側で月額の上限を設定できる場合が多くあります。
上限に達した時点で呼び出しが止まるため、被害額そのものを抑えられます。
キーの扱いを含めた、AIを使った開発全体の注意点もあわせてご覧ください。
権限の絞り込みも効果があります。
たとえば読み取りだけを許可したキーであれば、漏洩してもデータを書き換えられることはありません。
用途ごとにキーを分けておくと、問題が起きたときに影響範囲を特定しやすくなります。
まとめ
APIキーは、持っているだけで契約者として扱われる文字列です。
そのため、漏れないようにすることと同じくらい、漏れていても被害が続かない状態をつくることが重要になります。
AIを使った開発では、キーの設定までを短時間で終えられるぶん、保管場所や入れ替えの運用が後回しになりがちです。
利用上限の設定と月次のローテーションは、どちらも一度決めてしまえば負担の少ない作業です。
セキュリティは、起きてからでは取り返しがつかない部分に先に手を打っておくものだと考えています。
アプリ開発のセキュリティでお困りの方へ
micomiaでは、アプリケーションの開発とあわせて、公開前のセキュリティ確認を行っています。
AIを活用して開発を進めてきた方から、キーの管理や権限設定について相談をいただくことも増えています。
設計の確認だけでも対応していますので、お気軽にご相談ください。
ホームページ制作・アプリ開発に関するご相談
https://micomia.com/contact

.webp%3Falt%3Dmedia%26token%3D8e9329ab-e3ee-4f02-bdbc-f9a3e35ae1e7&w=3840&q=75)




.webp%3Falt%3Dmedia%26token%3De82fc05e-e6f3-436a-b03c-7d7ea1315012&w=3840&q=75)
.webp%3Falt%3Dmedia%26token%3D4a3d2dd0-4d09-4897-8397-df2ddf975344&w=3840&q=75)

.webp%3Falt%3Dmedia%26token%3Dc01cd48b-0c65-42b9-a1e5-97a28ce1e761&w=3840&q=75)





.webp%3Falt%3Dmedia%26token%3D554beac3-1f0a-4dae-99c0-76320019500f&w=3840&q=75)

