API キーの漏洩が疑われる場合の調査手順です。漏洩したキーを特定して処置し損失を止めること、使用量と費用から異常期間を特定すること、監査ログと推論ログで呼び出し行動を確認すること、ActionTrail で管理操作を確認すること、損失評価・証拠収集・ローテーションによる復旧までを説明します。
調査の考え方
漏洩が確認済みの場合は、まずAPI キー管理ページに移動して漏洩したキーをリセットまたは削除し、直ちに損失を止めてから、本ページの手順に従って影響範囲を調査してください。漏洩が確定していない場合は、ステップ 2 の使用量の確認から始めてください。
漏洩の調査で回答すべきは 5 つの質問で、それぞれ 1 つのコンソールの情報源に対応します:
回答すべき質問 | 確認先 | 得られる情報 |
|---|---|---|
どのキーが漏洩したか?誰が作成したか?現在のステータスは? | API キー管理ページ | キー ID、マスク済みキー、説明、帰属アカウント、作成時刻。リセット、編集、削除、費用表示の各操作 |
このキーはどれだけ呼び出され、いくらかかったか? | モデル使用量、課金概要と請求 | API キー別の呼び出し回数、トークン使用量、日次粒度の使用量曲線、金額 |
呼び出しはどこから来て、どのモデルを呼び出し、成功したか失敗したか? | 監査ログ | Request ID、時刻、モデル、トークン使用量、レイテンシ、ステータスコード、エラーコード。API キーでフィルタリング可能 |
呼び出しの入力と出力の内容は何か? | 推論ログ(事前に有効化が必要) | 完全なプロンプトとレスポンス(長さ上限 128K) |
このキーはどのような管理操作を経てきたか? | 操作監査 ActionTrail | コンソールと OpenAPI レベルの操作イベントの記録 |
ステップ 1:漏洩したキーを特定して処置する
Alibaba Cloud Model Studio のAPI キーページに移動し、右上隅でリージョンを選択してください。リージョンごとのキーは相互に独立しており、リージョンをまたいで使用できません。
漏洩が確認済みの場合は、そのキーのリセットまたは削除を優先して直ちに損失を止めてください。権限を絞り込む編集は、漏洩を確認できず観察期間が必要な場合にのみ適しています。API キーのリストで対象のキーを見つけ、その操作列で次を実行します:
- リセット:そのキーに新しい値を発行し、古い値は直ちに失効します。
- 編集:権限を絞り込みます(IP ホワイトリスト、モデル範囲)。API キー漏洩防止のベストプラクティスをご参照ください。
- 削除:即時に失効し、復元できません。
- 費用を表示:そのキーの費用と使用量のビューに移動します。
- 新しいキーを作成するだけでは、古いキーは自動的に失効しません。古いキーは個別に処置する必要があります。
- 調査が完了していない疑わしい環境に新しいキーを戻さないでください。戻すと、新しい認証情報を再び引き渡すことと同じです。
ステップ 2:使用量と費用を確認して異常期間を特定する
漏洩の最も直接的なシグナルは、存在するはずのない呼び出しや費用です。Model Studio コンソールのコストと使用量 > モデル使用量ページで、グループ化の次元を API キーに設定すると、各キーの使用量を比較でき、異常なキーがひと目で分かります:
- 時間粒度:分(最大 1 日)、時間(最大 7 日)、日(最大 31 日)、月(最大 12 か月)。突発的な高額の呼び出しの特定には時間粒度を使用します。
- データの遅延:呼び出し回数は約 1 分以内、トークン使用量と費用は約 10 分遅延します。発生したばかりの悪用は後で反映される場合があるため、一時的にデータが表示されないからといって容疑を排除しないでください。
- 明細行の費用を表示で関連する金額を確認できます。課金概要と請求の集計については、課金概要の確認と請求の照会をご参照ください。
ステップ 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:損失評価、証拠収集と復旧
- 損失の集計:異常の時間枠(使用量曲線)、呼び出し元とステータス(監査ログ)、金額(請求)を組み合わせて、影響範囲の結論を作成します。
- 影響範囲の確定:キーの認可範囲に基づいて評価します。Model Studio の API キーを保有することは、アカウントのパスワードやすべてのクラウドリソースの権限を取得することと同等ではなく、実際の影響はそのキーに認可された呼び出し範囲に限定されます。Model Studio の API キーと Alibaba Cloud の AccessKey(AK)は別種の認証情報であることに注意してください。AK が漏洩した場合は、RAM の AK 処理フローに従ってください。
- マスク済み証拠の保全:スクリーンショットと Request ID のリストを保存する際は、キーの値とアカウント ID をマスクし、完全なキーをいかなるチャネルでも拡散させないでください。
- 非同期タスクの確認:キーの削除では送信済みの非同期タスクはキャンセルされません。キャンセル可能なタスクは終了し、キャンセル不可なタスクの費用は追跡してください。
- ローテーション範囲の確定:漏洩が確認されたキーはできるだけ早く失効させて交換してください。残りのキーは露出範囲に基づいて判断し、同じ露出済み環境に保存されている複数のキーはまとめてローテーションし、環境を修復してください。
- 復旧の順序:高リスク場所のチェックリストに従って漏洩源を修復した後、信頼できる環境で新しいキーを作成し、権限と予算を再設定します。各サーバーサービス、タスク、サードパーティ連携の認証情報の参照を更新し、新しいキーが正常に呼び出せることを確認した後、最後に古いキーが失効していることを確認します。
よくある質問
漏洩したキーは既に削除しました。なぜ引き続きアラートを受け取るのですか?
漏洩したキーは既に削除しました。なぜ引き続きアラートを受け取るのですか?
同じキーから繰り返しアラートを受け取っています。それは漏洩の確認になりますか?
同じキーから繰り返しアラートを受け取っています。それは漏洩の確認になりますか?
漏洩が発生したのにプラットフォームのアラートを受け取らなかったのはなぜですか?
漏洩が発生したのにプラットフォームのアラートを受け取らなかったのはなぜですか?
コンソールで完全なキーが表示されないのはなぜですか?サポートに平文を確認してもらえますか?
コンソールで完全なキーが表示されないのはなぜですか?サポートに平文を確認してもらえますか?
推論ログを有効化したばかりです。昨日の入出力が見つからないのはなぜですか?
推論ログを有効化したばかりです。昨日の入出力が見つからないのはなぜですか?
使用量ページのデータが実際の呼び出しと一致しないのはなぜですか?
使用量ページのデータが実際の呼び出しと一致しないのはなぜですか?
呼び出しが 429 を返す場合、スロットリングですか、予算による停止ですか?
呼び出しが 429 を返す場合、スロットリングですか、予算による停止ですか?
ログを一括エクスポートして独自の分析に使えますか?
ログを一括エクスポートして独自の分析に使えますか?
漏洩したのが Model Studio の API キーか Alibaba Cloud の AccessKey かを確認するには?
漏洩したのが Model Studio の API キーか Alibaba Cloud の AccessKey かを確認するには?