個人情報保護委員会への報告義務とは、個人データの漏洩
APIキーの安全な管理方法は、暗号化されたシークレット管理ツールに保管し、必要な担当者やアプリケーションだけが取得できるようにすることが基本です。秘密のキーをソースコードや公開するアプリに埋め込まず、用途や開発・本番環境ごとに分け、API側の権限も必要最小限に制限します。さらに、提供元の仕様に応じて有効期限やローテーションの運用を定め、利用状況を監視し、漏えい時には発行元で速やかに無効化できる手順を整えます。
APIキーが漏えいすると、付与された権限によっては、情報流出やデータの改ざん、想定外の利用料金につながるおそれがあります。暗号化は保管中のキーを保護しますが、キーを取得・利用するシステムのアクセス制御や保護も欠かせません。また、権限を必要最小限に設定しておけば、キーが盗まれても攻撃者が実行できる操作を制限できます。利用状況の監視と速やかな無効化を組み合わせ、不正利用の早期発見と被害の拡大防止につなげましょう。
APIキーが漏えいする原因と悪用のリスク
APIキーとは、APIの呼び出し元を識別したり、APIへのリクエストを認証したりするための固有の識別子です。どのように使われるかは、サービスによって異なります。ここでは、第三者に公開してはいけない秘密のAPIキーを対象に、その管理方法を説明します。
国内で不正アクセスによる被害が相次ぐなか、2026年10月9日、自民党国家サイバーセキュリティ戦略本部の平将明本部長は、サイバーセキュリティの状況を「非常事態、有事」と表現しました。企業では、APIキーを含め、システムへのアクセスに使う認証情報の管理状況を点検する必要があります。
APIキーが漏えいする主な経路
APIキーをソースコードや設定ファイルに直接書き込むと、リポジトリへの登録、コードレビュー、ファイルのコピーを通じて値が広がります。チャットや共有文書への貼り付け、デバッグ用ログへの出力も漏えいの原因になります。ブラウザやモバイルアプリに組み込んだ秘密のキーは、アプリを解析した第三者に取得される可能性があります。
JPCERT/CCは、2026年10月の国内組織への不正アクセスに関する注意喚起で、公開されたスマートフォンアプリを解析し、APIのエンドポイントやキーを特定する手口が報告されていると説明しています。また、キーを保管する別のシステムが侵害され、そこから盗まれるケースもあります。
攻撃者が漏えいしたAPIキーを悪用する方法
有効なAPIキーを取得した攻撃者は、そのキーに許可された範囲でリクエストを送信できる場合があります。例えば、顧客情報の読み取りが許可されたキーなら情報流出に、書き込みが許可されたキーならデータの改ざんにつながる可能性があります。従量課金のAPIでは、不正利用によって想定外の料金が発生するおそれもあります。実際に可能な操作は、キーの権限とAPI側のアクセス制御によって決まります。
JPCERT/CCの注意喚起には、他のシステムへの侵入で盗んだAPIキーを使う手口も記載されています。DIGITAL Xも、国内の認証情報の窃取やAPIの不正利用を報じています。キーの漏えい経路を減らすとともに、漏えいしても被害が広がりにくい権限設定が必要です。APIそのものの認証・認可の不備などについては、APIの脆弱性の解説も参考にしてください。
APIキーを安全に管理する8つの方法
保管場所を決めるだけでは、担当者の交代やアプリの更新時に管理が途切れてしまいます。発行から廃止まで、次の8つのポイントを運用に組み込みましょう。
1. APIキーの用途と管理責任者を把握する
まず、利用サービス、用途、利用環境、管理責任者、保管先、権限、有効期限、利用するアプリを整理します。例えば「本番環境の請求データ連携に使うキー」と分かれば、更新時にどの処理を確認すべきか判断できます。
台帳にはキーの値そのものを記載せず、安全な保管先の参照情報を残します。発行できる担当者と承認者を決め、利用を終えたキーは発行元で無効化し、台帳も更新してください。
2. 暗号化された保管先で一元管理する
APIキーの保管先は、暗号化、アクセス制御、更新・無効化の運用を考慮して選びます。個人のメモや複数の共有ファイルに分散させず、用途ごとに決めた保管先と取得方法をチームで統一しましょう。
| 方法 | 主な役割 | 注意点 |
|---|---|---|
| 平文の文書やチャット | 手作業による受け渡し | コピーが残りやすく、閲覧者や配布先の把握が難しい |
| 環境変数 | 実行するアプリへの値の受け渡し | 値の暗号化保管やログへの出力防止まで自動で行う仕組みではない |
| シークレット管理ツール | 暗号化保管と許可された利用者・アプリへの提供 | 接続用の認証情報の保護と適切な権限設定が必要 |
環境変数は、コードに値を埋め込まないための手段になります。ただし、環境変数の値を設定するファイルや実行環境の保護も必要です。保管と受け渡しを分けて考え、どこに秘密の値が残るか確認してください。
3. コードへの直接記述を避け、実行時に取得する
アプリやCI/CDパイプラインでは、秘密の値をコードやコンテナイメージに含めず、認可された処理が実行時に取得する方式を検討します。例えば、デプロイ処理が必要なキーだけを取得すれば、コードを閲覧する全員にその値を渡さずに済みます。
公開を前提としないキーは、ブラウザやモバイルアプリに配布せず、必要に応じてバックエンドからAPIを呼び出します。シークレット管理ツールへの接続に使う認証情報も保護し、取得したキーをログや生成ファイルに出力しないようにしてください。システム間での利用例は、API連携の仕組みの解説で確認できます。
4. キーの権限とアクセス元を必要最小限に制限する
「保管されたキーを誰が取得できるか」と「取得したキーで何ができるか」をそれぞれ設定します。例えば、請求データを読むだけの処理に、データの削除や利用者の管理権限を与える必要はありません。API提供元で設定できる権限の範囲を確認し、必要な操作だけを許可します。
シークレット管理ツール側でも、アプリが取得できるレコードを絞り込みます。提供元が対応している場合はIP許可リストなども利用できますが、キー自体の保護やAPI側の認可を併せて実施してください。
5. 開発・検証・本番環境でキーを分ける
開発環境と本番環境で同じキーを使うと、開発用ファイルの流出が本番データへのアクセスにつながる可能性があります。環境ごとにキーを発行し、接続先やアクセスできる情報も分けましょう。
可能であれば、業務やアプリ単位でも分離します。利用者を特定しやすくなり、問題が起きたキーだけを止めるための判断もしやすくなります。
6. 有効期限とローテーションの手順を設定する
提供元が対応している場合は有効期限を設定し、キーを交換する頻度と担当者を決めます。交換間隔は、キーの権限、扱うデータ、提供元の仕様、自社のリスクに応じて判断します。すべてのAPIキーに同じ日数を当てはめる必要はありません。
通常のローテーションでは、新しいキーの発行、利用アプリへの反映、動作確認、古いキーの無効化を順に行います。旧キーと新キーを並行利用できるかも事前に確認しましょう。漏えいが疑われる場合は、定期交換の日を待たず、発行元での無効化を優先します。
7. 利用状況を監視し、キーをログに残さない
API提供元の利用状況や監査ログを確認し、通常と異なる時間帯のアクセス、急なリクエスト増加、想定外の操作や料金に気付けるようにします。異常時の連絡先と、キーを止める判断を行う担当者も決めておきましょう。料金アラートが通知だけなのか、利用停止まで行えるのかは提供元の設定で確認してください。
シークレット管理ツールでの取得履歴と、提供元でのAPI利用履歴は異なります。保管先のログだけで利用状況を把握できるとは限りません。また、調査用ログにキーそのものを出力すると新たな漏えい経路になるため、認証ヘッダーやエラー出力のマスキングを確認します。
8. チームや委託先の利用・退職時のルールを整える
キーの利用を申請・承認する方法と、必要なアクセスを付与する範囲を決めます。平文のメールやチャットで値を配布せず、承認済みの保管先や取得手順を使いましょう。キーを管理する人のアカウントには、多要素認証などの保護も適用します。
異動、退職、委託契約の終了時には、個人のアクセス権だけでなく、その担当者が用意したアプリや自動処理の権限も確認します。責任者を引き継ぎ、不要なアクセスを削除してください。利用者がキーをコピーしていた可能性があれば、発行元での交換・無効化も検討します。
APIキーが漏えいした場合の対処法
公開したファイルを消すだけでは、すでにコピーされたキーの利用を止められません。漏えいが確認された、または疑われる場合は、次の順序を基本に対応します。
1. 発行元でキーを無効化する:対象のサービスとキーを特定し、管理画面やAPIで無効化します。サービス停止への影響も確認しながら、悪用を止める対応を進めます。
2. 必要最小限の権限で再発行し、利用先を更新する:代替キーを安全な保管先に登録し、利用アプリやパイプラインに反映します。必要に応じて再読み込みや再起動を行います。
3. 古いキーが利用できないことを確認する:新しい処理が動くことと、漏えいしたキーでのアクセスが拒否されることを確認します。保管先の値を変更しただけで終わらせないようにします。
4. 利用履歴と影響範囲を調べる:提供元のログや料金を確認し、不正な操作、閲覧された可能性のある情報、影響する顧客や業務を調べます。適用される社内手順に沿って報告します。
5. 漏えい経路を修正する:リポジトリ、設定、ログ、共有方法、侵害された端末などを調査します。ほかのキーも同じ経路で流出していないか確認し、再発を防ぐ運用に変更します。
KeeperでAPIキーの安全な管理を支援
KeeperPAMとKeeper Secret Manager(シークレットマネージャー)は、APIキーの安全な保管やアクセス権の管理、対応サービスの認証情報のローテーションを支援します。必要な人やアプリケーションにアクセスを許可しながら、APIキーの漏えいリスクを抑えられます。
Keeper Secrets Managerで安全に保管・取得する
Keeper Secrets Manager(KSM)は、APIキーなどのシークレットを管理し、許可されたアプリやワークロードがSDK、CLI、連携機能を通じて取得できるようにします。キーをコードや設定ファイルに埋め込む必要を減らせます。
例えば、請求処理用のアプリに必要なレコードだけを共有し、実行時にキーを取得する構成にできます。KSMは承認されたクライアント上でシークレットを復号し、Keeperのクラウドはその内容を読み取るための鍵を保持しません。取得後のアプリ側でも、ログへの出力などによる漏えいを防ぐ必要があります。
人とアプリケーションのアクセスを適切に管理する
担当者によるアクセスは、Keeperボルトの共有設定やチーム、企業向けの認証・ポリシーで管理します。一方、アプリはKSMアプリケーションとクライアントを通じて認可されたレコードにアクセスします。KSMではレコードや共有フォルダへの権限を設定でき、参照だけが必要な処理には読み取り専用の権限を付与できます。
本番用と検証用のKSMアプリケーションを分けるなど、業務上の境界に合わせて設計しましょう。クライアントの設定情報が侵害された場合は、そのクライアントを無効化できます。ただし、すでに取得された外部サービスのAPIキーは、発行元で別途対応する必要があります。
KeeperPAMで対応する認証情報のローテーションを自動化する
KeeperPAMは、対応する連携を設定することで、認証情報をオンデマンドまたはスケジュールに沿ってローテーションできます。組み込みの連携例としては、AWSアクセスキーやAzureクライアントシークレット(Azure Client Secret)のローテーションがあります。
このワークフローでは、KeeperPAM Gatewayが対象システムに対する処理を実行します。利用する連携、必要な権限、依存するアプリへの反映方法を確認して設定してください。APIキーをKSMに保存するだけで、あらゆる提供元のキーが自動交換されるわけではありません。
KeeperでAPIキーの安全な管理を始めましょう
まず、コードや共有ファイルに残っているキーと、その管理責任者を確認しましょう。KSMによる保管・取得と、対応するKeeperPAMのローテーションを組み合わせる場合も、提供元での権限設定や利用監視まで含めて運用を決めることが必要です。自社のアプリや開発環境に合う構成については、Keeper Secrets Managerのカスタムデモをご依頼ください。
よくある質問
APIキーが流出するとどうなりますか?
キーに付与された権限によっては、情報の取得、データの変更、従量課金サービスの不正利用などにつながります。影響は、権限の範囲、有効期限、提供元のアクセス制御によって異なります。
APIキーは環境変数に保存すれば安全ですか?
環境変数を使えばコードへの直接記述を避けられますが、安全性は設定ファイルや実行環境の保護にも左右されます。環境変数の値をログに出さず、必要な処理だけが取得できるようにしてください。
GitHubに公開したAPIキーは、削除すれば安全ですか?
削除だけでは不十分です。履歴やコピーに残っている可能性があるため、まず発行元でキーを無効化・交換します。その後、リポジトリ内の残存箇所や、誤って登録した原因を確認してください。
APIキーはどのくらいの頻度でローテーションすべきですか?
提供元の仕様、権限、扱うデータ、自社のリスクに応じて決めます。有効期限を設定できる場合は活用し、期限前に安全に交換できる手順を用意してください。漏えいが疑われる場合は、通常の交換予定を待たずに対応します。
APIキーの漏えいに気づいたら、まず何をすべきですか?
対象のキーを特定し、発行元で速やかに無効化することを優先します。利用先への影響を確認しつつ代替キーに切り替え、不正利用の有無と漏えい経路を調査してください。