Skip to main content

API キー漏洩の調査

API キーの漏洩が疑われる場合の調査手順です。漏洩したキーを特定して処置し損失を止めること、使用量と費用から異常期間を特定すること、監査ログと推論ログで呼び出し行動を確認すること、ActionTrail で管理操作を確認すること、損失評価・証拠収集・ローテーションによる復旧までを説明します。

調査の考え方

漏洩が確認済みの場合は、まずAPI キー管理ページに移動して漏洩したキーをリセットまたは削除し、直ちに損失を止めてから、本ページの手順に従って影響範囲を調査してください。漏洩が確定していない場合は、ステップ 2 の使用量の確認から始めてください。 漏洩の調査で回答すべきは 5 つの質問で、それぞれ 1 つのコンソールの情報源に対応します:

回答すべき質問

確認先

得られる情報

どのキーが漏洩したか?誰が作成したか?現在のステータスは?

API キー管理ページ

キー ID、マスク済みキー、説明、帰属アカウント、作成時刻。リセット、編集、削除、費用表示の各操作

このキーはどれだけ呼び出され、いくらかかったか?

モデル使用量、課金概要と請求

API キー別の呼び出し回数、トークン使用量、日次粒度の使用量曲線、金額

呼び出しはどこから来て、どのモデルを呼び出し、成功したか失敗したか?

監査ログ

Request ID、時刻、モデル、トークン使用量、レイテンシ、ステータスコード、エラーコード。API キーでフィルタリング可能

呼び出しの入力と出力の内容は何か?

推論ログ(事前に有効化が必要)

完全なプロンプトとレスポンス(長さ上限 128K)

このキーはどのような管理操作を経てきたか?

操作監査 ActionTrail

コンソールと OpenAPI レベルの操作イベントの記録

次の順序で進めることを推奨します:
Suspected leak
  ├─ Step 1: locate the key and immediately reset or delete it (containment)
  ├─ Step 2: identify anomalous periods from usage and cost curves
  ├─ Step 3: confirm call sources and behavior in audit logs (input and output available if inference logs were enabled)
  ├─ Step 4: review management operations such as key creation and deletion
  └─ Step 5: summarize the damage, rotate credentials, and fix the leak source

ステップ 1:漏洩したキーを特定して処置する

Alibaba Cloud Model Studio のAPI キーページに移動し、右上隅でリージョンを選択してください。リージョンごとのキーは相互に独立しており、リージョンをまたいで使用できません。 漏洩が確認済みの場合は、そのキーのリセットまたは削除を優先して直ちに損失を止めてください。権限を絞り込む編集は、漏洩を確認できず観察期間が必要な場合にのみ適しています。API キーのリストで対象のキーを見つけ、その操作列で次を実行します:
  • リセット:そのキーに新しい値を発行し、古い値は直ちに失効します。
  • 編集:権限を絞り込みます(IP ホワイトリスト、モデル範囲)。API キー漏洩防止のベストプラクティスをご参照ください。
  • 削除:即時に失効し、復元できません。
  • 費用を表示:そのキーの費用と使用量のビューに移動します。
このページでは、キーの識別情報を確認できます。キー ID、マスク済みの API キー(例:sk-ws-H.YHXL****PgonKozeC4RM-Nm)、説明、帰属アカウント、作成時刻です。説明と帰属アカウントは、キーがどのアプリケーションや担当者に帰属するかを特定する最初の手がかりです。完全な平文は通常確認できません。新しいバージョンのキーは作成時に一度だけ完全表示され、一部の旧バージョンのキーは今もリストから直接コピーできます(リストが実際に提供する機能によります)。調査時は、マスク済みの値、ID、説明で照合してください。
キーの削除では、関連付けられた非同期タスクはキャンセルされません。未実行の非同期タスクは実行を続けて費用が発生するため、個別に終了する必要があります。非同期タスクの延滞時の課金についてをご参照ください。調査期間中は、第 2 の損失停止策として、そのキーの予算で「予算到達時にサービスを停止」を有効にすることもできます。予算管理をご参照ください。
処置時には、陥りやすい 2 つの誤解に注意してください:
  1. 新しいキーを作成するだけでは、古いキーは自動的に失効しません。古いキーは個別に処置する必要があります。
  2. 調査が完了していない疑わしい環境に新しいキーを戻さないでください。戻すと、新しい認証情報を再び引き渡すことと同じです。

ステップ 2:使用量と費用を確認して異常期間を特定する

漏洩の最も直接的なシグナルは、存在するはずのない呼び出しや費用です。Model Studio コンソールのコストと使用量 > モデル使用量ページで、グループ化の次元を API キーに設定すると、各キーの使用量を比較でき、異常なキーがひと目で分かります:
  • 時間粒度:分(最大 1 日)、時間(最大 7 日)、日(最大 31 日)、月(最大 12 か月)。突発的な高額の呼び出しの特定には時間粒度を使用します。
  • データの遅延:呼び出し回数は約 1 分以内、トークン使用量と費用は約 10 分遅延します。発生したばかりの悪用は後で反映される場合があるため、一時的にデータが表示されないからといって容疑を排除しないでください。
  • 明細行の費用を表示で関連する金額を確認できます。課金概要と請求の集計については、課金概要の確認と請求の照会をご参照ください。
指標の定義と操作の詳細については、モデルの利用状況の確認をご参照ください。 調査では、まず通常の業務変動を排除します。異常な時間、モデル、呼び出し量を、業務のリリース、バッチ処理、ストレステスト、定時タスクと照合し、そのキーを使用するサービスのデプロイリージョン、出口 IP、サードパーティツールに変化がないかも確認します。海外 IP、新しい IP、使用量の急増は、確認が必要なシグナルであって、漏洩を確定する証拠ではありません。処置の強度は疑いの程度に合わせてください。アラート通知のみ、または軽度の異常の場合は、まず監査ログで呼び出し元を確認します。使用量曲線で未知の送信元からの呼び出しが確認されたら、直ちにそのキーをリセットまたは削除してから証拠収集を続けてください。 漏洩が確認された時刻を終点として、過去 7 日間(時間粒度)と 31 日間(日粒度)を遡り、そのキーの履歴ベースラインと比較することを推奨します。特定された異常の時間枠が、その後のログ調査の範囲になります。

ステップ 3:呼び出しログを確認して呼び出し行動を確定する

Model Studio の呼び出しログには監査ログと推論ログの 2 種類があり、できることの範囲が異なるため、調査時は区別してください。

監査ログ

監査ログはデフォルトで有効になっており、プラットフォーム側に保存されるため設定が不要で、調査の主力です。モデルモニタリングページで確認できます:
  • 記録フィールド:Request ID、時刻、モデル、トークン使用量、レイテンシ、ステータス、エラーコード。入出力の内容は含まれません。
  • フィルタリングと検索:時間(最大 30 日)、モデル、API キー ID、ステータス、推論タイプでフィルタリング、または Request ID で検索します。
  • 用途:漏洩期間内にそのキーの呼び出しが予期された動作と一致するかを確認します。例:大量の 4xx/5xx、異常な呼び出しペース、未知のモデルへの呼び出し記録。
使用方法については、ログをご参照ください。

推論ログ

推論ログには、完全なプロンプトとレスポンス、中間ステップが含まれます(長さ上限 128K)。事前にデータ転送で有効化して、自社のログサービス(SLS)に転送する必要があります(有効化にはクラウドプロダクトの認可とログサービスの費用が伴います)。有効化後のデータにのみ適用されます。有効化前の履歴呼び出しは遡れず、無効期間中に生成されたログは補完されません。有効化方法とリージョン対応については、推論ログの有効化をご参照ください。推論ログを有効化していない場合、それ以前の呼び出しは監査ログのフィールドレベルの情報でのみ調査できます。

追跡の限界

プラットフォームは呼び出しログに基づいて異常な行動の確認を支援できますが、呼び出し IP、モデル、時間の情報だけでは、実際の使用者や最初の漏洩経路を直接特定するには通常不十分です。さらに追跡するには、お客様側のコードリポジトリ、サーバー、端末、サードパーティサービスの証拠が必要です。調査の成果物は証拠連鎖と影響評価であり、責任帰属の結論ではありません。違法行為が関与する場合は、法に従って証拠を保全し、適切なチャネルを通じて処理してください。

ステップ 4:管理操作の履歴を確認する

API キーの作成、削除などのライフサイクル操作は、Alibaba Cloud の操作監査(ActionTrail)に統合されています。ActionTrail コンソールのイベント照会ページに移動し、サービス(Model Studio)と時間範囲で絞り込んでください:
  • キーの作成イベントを検索して、このキーを誰がいつ作成したかを確認し、帰属責任を照合します。
  • キーの削除イベントを検索して、漏洩期間の前後にキーを削除した人がいないかを確認します。例えば、攻撃者や内部者が痕跡を消そうとした場合などです。
まず操作監査でキーのステータスと操作履歴を確認し、その後、呼び出しログと組み合わせて具体的な行動を調査します。

ステップ 5:損失評価、証拠収集と復旧

  1. 損失の集計:異常の時間枠(使用量曲線)、呼び出し元とステータス(監査ログ)、金額(請求)を組み合わせて、影響範囲の結論を作成します。
  2. 影響範囲の確定:キーの認可範囲に基づいて評価します。Model Studio の API キーを保有することは、アカウントのパスワードやすべてのクラウドリソースの権限を取得することと同等ではなく、実際の影響はそのキーに認可された呼び出し範囲に限定されます。Model Studio の API キーと Alibaba Cloud の AccessKey(AK)は別種の認証情報であることに注意してください。AK が漏洩した場合は、RAM の AK 処理フローに従ってください。
  3. マスク済み証拠の保全:スクリーンショットと Request ID のリストを保存する際は、キーの値とアカウント ID をマスクし、完全なキーをいかなるチャネルでも拡散させないでください。
  4. 非同期タスクの確認:キーの削除では送信済みの非同期タスクはキャンセルされません。キャンセル可能なタスクは終了し、キャンセル不可なタスクの費用は追跡してください。
  5. ローテーション範囲の確定:漏洩が確認されたキーはできるだけ早く失効させて交換してください。残りのキーは露出範囲に基づいて判断し、同じ露出済み環境に保存されている複数のキーはまとめてローテーションし、環境を修復してください。
  6. 復旧の順序:高リスク場所のチェックリストに従って漏洩源を修復した後、信頼できる環境で新しいキーを作成し、権限と予算を再設定します。各サーバーサービス、タスク、サードパーティ連携の認証情報の参照を更新し、新しいキーが正常に呼び出せることを確認した後、最後に古いキーが失効していることを確認します。
異常な費用が完全に解明される前に、予算を単純に引き上げたり、損失軽減の設定をオフにして呼び出しを再開したりしないでください。まず上記の調査を完了し、漏洩源が修復されたことを確認してください。

よくある質問

検出と通知には時間差があり、通知の時刻だけでは異常が継続しているかは判断できません。履歴イベントも、後の確認で発見されて通知されることがあります。通知を受け取ったことが、古いキーがまだ呼び出しに成功することを意味するわけではありません。古いキーを処置済みで、最近の使用量に異常がない場合は、通知に対応する呼び出し時刻とキー識別子を確認した上で無視できます。
繰り返しの回数だけでは漏洩は確認できません。各アラートに対応する呼び出し時刻、キー識別子、異常の内容を確認し、新たに発生した呼び出し、同一イベントの再通知、履歴記録を区別してください。
プラットフォームのリスク検出とアラートはプラットフォームが主体的に提供する能力であり、SLA で定められたサービス範囲には含まれず、リスクシナリオの複雑さにより絶対的なアラート網羅率は保証されません。認証情報の安全な保管とコンプライアンスに沿った利用はお客様の責任範囲です。アラートを受信しなくても漏洩のリスクがないことを意味するわけではありません。まず本ページの手順に従って漏洩が疑われるキーの調査と処置を完了し、その後、異常の時間と通知記録を突き合わせてアラートが通知されなかった原因を確認してください。
確認できません。新しいバージョンのキーは作成時に一度だけ完全表示され、その後は完全な平文を表示もコピーもできません(一部の旧バージョンのキーはリストから直接コピーできます。リストが実際に提供する機能によります)。
推論ログは有効化後のデータにのみ適用され、履歴データは遡れません。それより前の呼び出しは、監査ログのフィールドレベルの情報でしか調査できません。
トークン使用量と費用には約 10 分の遅延があります。また、使用量ページはトークン従量課金の呼び出しのみを集計しており、モデルトレーニング、プリセットスループット(PTU)などは含まれません。失敗回数やスロットリングエラーなどの指標は、モデルモニタリングページで確認してください。
どちらも 429 を返します。予算を使い切った場合のエラーメッセージは「The budget configured in Budget Management has been exhausted...」です。エラーコードをご参照ください。スロットリングの 429 は、レート制限またはクォータ制限によって発生します。モデルモニタリングのスロットリングエラー回数の指標で区別できます。
独自に分析する必要がある場合は、ログをご自身の SLS ログストアに転送し、ログストア内で検索とエクスポートを行ってください。データ転送をご参照ください。
この 2 つは別種の認証情報です。Model Studio の API キーは、認可範囲内のモデルサービスへのアクセスにのみ使用されます。Alibaba Cloud の AccessKey はクラウド API の認証に使用され、権限はアカウントと認可設定によって決まります。まず漏洩した認証情報の種類を確認し、対応するプロダクトの管理入口で処理してください。手順を混用しないでください。