認証情報の露出時間の短縮、権限範囲の絞り込み、アラートと損失軽減の設定という 3 つの観点から API キーの漏洩を防止します。一時的な API キー、定期的なローテーション、IP ホワイトリスト、プライベート接続、予算アラート、モデルモニタリングアラートを取り上げます。
概要
API キーは、Alibaba Cloud Model Studio のモデルサービスを呼び出すための認証情報です。ひとたび漏洩すると、それを入手した誰もがそのキーの認可範囲内のモデルを呼び出してクォータを消費できます。漏洩による影響は 4 つの因子に分解できます。漏洩確率、露出時間、1 回の呼び出しの権限範囲、異常の継続時間です。漏洩確率は本ページ全体を貫く基礎プラクティスによって低減され、残りの 3 つの因子はそれぞれ次の 3 つの観点で低減されます。
観点 | 低減される因子 | 主要な対策 |
|---|---|---|
露出時間の短縮 | 露出時間 | クライアントでの一時的な API キーの利用、一度きりの表示と管理された保存、定期的なローテーションと離職時の失効 |
権限範囲の絞り込み | 1 回の呼び出しの権限範囲 | 1 業務 1 キー、ワークスペース分離、IP ホワイトリストとモデル範囲、プライベート接続 |
アラートと損失軽減 | 異常の継続時間 | 予算アラートと予算到達時のサービス停止、モデルモニタリングアラート、プラットフォームのリスク検出 |
- アプリケーションは認証情報を環境変数またはキーマネージメントサービスから読み込み、コードにハードコードしません。CI/CD で機密情報スキャンを設定し(gitleaks などの認証情報スキャンツールが利用可能)、API キーのパターンをカバーします。
- キー台帳を管理します。キー ID、用途、担当者、最終ローテーション日を記録する基本的な表から始め、リージョン、ワークスペース、権限範囲、予算などの項目を徐々に補完します。台帳に完全なキーは保存しません。
- キーの管理権限(作成、表示、編集、削除)を必要な管理者に限定します。
認証情報の露出時間を短縮する
永続的な API キーを適切に保管する
新規作成した API キーの完全な値が表示されるのは作成時の 1 回のみです。ダイアログボックスを閉じると、完全な平文は再表示もコピーもできません。保存しなかった場合は、リセットまたは再作成するしかありません。API キーの取得をご参照ください。
作成後、完全なキーは管理された認証情報ストア(キーマネージメントサービスまたはデプロイプラットフォームのシークレット管理)に直接保存してください。スクリーンショット、メール、チャットツール、通常のドキュメントで中継しないでください。リストに表示されるマスク済みの値は、照合と識別にのみ使用します。
永続的な API キーを次の場所に置かないでください:
- ブラウザースクリプト、フロントエンドのビルド成果物、モバイルアプリのインストールパッケージ
- 公開または共有のコードリポジトリ(.gitignore を追加するだけでは、履歴コミット内の認証情報は削除されません)
- Notebook の出力、サンプルコード
- スクリーンショット、画面録画
- チケット、グループチャット、オンラインドキュメント
- プロンプト、ナレッジベース、エージェントのコンテキスト
- リクエスト URL とクエリパラメーター
- アクセスログと例外スタックトレース
- サードパーティプラグインとモデル中継サービス
- 共有環境、外部に公開される設定ファイル、イメージとバックアップ
環境変数はハードコードを避けられますが、暗号化された保存ではありません。認証情報は、プロセスの診断情報、コンテナー設定、クラッシュダンプ、運用データのエクスポートなどの経路で漏洩する可能性がまだあります。デバッグ時は、set -x のような機密変数を出力するオプションを使用しないでください。本番環境では、キーマネージメントサービスまたはデプロイプラットフォームのシークレット注入を使用してください。
クライアント側のシナリオで一時的な API キーを使用する
ブラウザー、モバイルアプリ、ミニプログラムなどの環境では、認証情報を確実に秘匿できません。このようなシナリオでは、認証済みのバックエンドに一時的な API キーを発行させ、フロントエンドから直接呼び出せるようにしてください:
- 永続的な API キーは自社のサーバーのみに保存し、いかなるクライアントにも配布しません。
- フロントエンドがモデルを呼び出す必要がある場合は、まずバックエンドに一時的なキーを申請します。
- バックエンドは一時的な API キー生成 API を呼び出し、短い有効期間の st- キーを発行してフロントエンドに返します。
- フロントエンドは st- キーで Model Studio に直接接続してモデルを呼び出します。
定期的なローテーションと離職時の失効
コードやエージェントに設定された長期間有効なキーは、時間とともに露出面が蓄積するため、定期的にローテーションしてください:
- 新しいキーを作成し、現在のニーズに合わせて権限と予算を再設定します。
- 業務側の認証情報の参照を更新します。
- 新しいキーで呼び出しが正常に動作することを確認します。
- 古いキーを削除し、古いキーが新しい呼び出しを開始できないことを確認します。
- キー台帳を更新します。
認証情報の権限範囲を絞り込む
1 業務 1 キーとワークスペース分離
異なるアプリケーションと異なる環境(本番、テスト、個人デバッグ)に独立した API キーを割り当ててください。これにより、単一のキーの漏洩による影響範囲が縮小され、キーごとの問題の切り分けと個別のローテーションが容易になります。権限分離、きめ細かなモデルアクセス制御、独立したコスト管理が必要な場合は、業務にデフォルト以外のワークスペースを割り当ててください(ワークスペースは Model Studio で権限とコストを分離するコンテナーであり、アカウントにはデフォルトでデフォルトワークスペースが存在します)。キーの基本的な呼び出し範囲は、帰属するワークスペースに制約されます。権限管理をご参照ください。
また、キーの管理権限を必要な管理者に限定してください。コンソールにログオンして認証情報を管理できるアカウントは、最小権限とし、組織の要件に従って多要素認証を有効にしてください。
IP ホワイトリストとモデル範囲の設定
API キーの作成または編集パネルで権限をカスタムに設定すると、キーの呼び出し範囲をさらに絞り込めます:
- IP ホワイトリスト:業務で実際に使用されるパブリックの出口 IP または CIDR ブロックのみを許可します(最大 20 件。curl ifconfig.me などでパブリックの出口 IP を確認できます)。デフォルトではすべての IPv4 アドレスが許可されます。キーを作成しただけでは、送信元制限が有効になったことにはなりません。NAT、プロキシ、またはゲートウェイ経由で呼び出す場合は、サーバーのイントラネットアドレスではなく、Model Studio が実際に認識するパブリックの出口 IP アドレスを入力してください。
- アクセス可能なモデル範囲:有効にすると、そのキーは選択されたモデル(最大 30 件、ワークスペースに認可されたモデルに制約されます)のみを呼び出しできます。漏洩後に高コストのモデルへ悪用されるのを防ぎます。
IP ホワイトリストは認証情報の秘匿の代替にはなりません。同じ出口ネットワークから呼び出しを開始できる人や侵害されたホストは、漏洩したキーを悪用できる可能性がまだあります。
プライベート接続経由での呼び出し
ネットワークセキュリティ要件が高いシナリオでは、VPC と Model Studio の間にプライベート接続(PrivateLink)を確立できます。呼び出しはパブリックネットワークを経由しないため、キーが漏洩しても、ネットワークが接続されていない外部の攻撃者は呼び出せません。設定方法については、プライベートネットワーク経由での Model Studio API へのアクセスをご参照ください。
アラートと損失軽減を設定する
予算アラートと予算到達時のサービス停止
アカウント、ワークスペース、または単一の API キーに対して月間予算とアラートしきい値を設定します。開発テスト、デモ、サードパーティ連携などの高リスクのキーに優先して独立した予算を設定してください。費用がしきい値に達したときと予算を使い切ったときに、サイト内メッセージ、SMS、メール、またはボット経由で通知されます。「予算到達時にサービスを停止」を有効にすると、予算を使い切った時点で、そのディメンションの従量課金の呼び出しが制限され、429 が返されます。設定方法については、予算管理をご参照ください。
モデルモニタリングアラート
モデルモニタリングは、ワークスペースごとに呼び出し回数、トークン使用量、失敗回数、失敗率などの指標を集計し、API キーによるフィルタリングをサポートします。プリセットまたはカスタムのアラートテンプレートに基づいてアラートルールを作成し、担当者または担当者グループに通知できます。高リスクのキーには、呼び出し量や呼び出し回数の急増系アラートを設定することを推奨します。異常は呼び出しの発生から数分以内に可視化され、勤務時間外の発報には人的な対応が必要です。初めてアラートを設定する場合は、まずデータ転送で Cloud Monitor のサービスロールを認可する必要があります。設定方法については、アラートをご参照ください。
プラットフォームのリスク検出
プラットフォームは、公開コードリポジトリなどのパブリックネットワーク環境を定期的にスキャンして漏洩した API キーを識別し、主体的に通知します。実際のチャネルは有効化されているものによります(SMS、メール、サイト内メッセージなどが含まれる可能性があります)。また、通常と異なる IP からのログオン、夜間の突発的なトラフィック、費用の異常な急増などの異常な行動も識別します。
プラットフォームのリスク検出とアラートは、プラットフォームが利用体験の向上のために主体的に提供する異常検出と警告の能力であり、SLA で定められたサービス範囲には含まれません。リスクシナリオの複雑さにより、絶対的なアラート網羅率は保証されず、アラートの識別と通知に遅延が生じる場合もあります。API キーなどの認証情報の安全な保管とコンプライアンスに沿った利用はお客様の責任範囲に属します。ご自身で設定した予算アラート、モデルモニタリングアラート、定期的なローテーションを主要な防御線としてください。プラットフォームのアラートを受信しなくても、漏洩のリスクがないことを意味するわけではありません。漏洩の疑いを発見した場合、またはアラートを受信した場合は、API キー漏洩の調査に従って特定と処置を行ってください。
リリース前チェックリスト
個人開発者や小規模チームは、まず最小限のセットアップを完了できます。キーに予算とアラート通知を設定し、認証情報は環境変数のみに保存し、定期的にローテーションします。完全なチェックリストは以下のとおりです:
- 本番、テスト、サードパーティ連携が同じ API キーを共有しておらず、キーの担当者と用途が明確であること。
- 帰属リージョン、ワークスペース、モデル範囲、リクエストの出口 IP が確認済みで、権限が必要な範囲のみをカバーしていること。
- 永続的なキーが管理されたバックエンドのみに保存され、クライアント、ソースコード、プロンプト、共有ドキュメント、ログに入らないこと。
- キーが信頼できないサードパーティの中継サービスやプラグイン環境に提供されていないこと。提供したことがある場合は、提供を停止し、ローテーションが完了していること。
- 認証情報が環境変数またはシークレットで注入され、機密ファイルとビルド成果物に平文が含まれないこと。
- クライアント直接接続のシナリオでは、認証済みバックエンドが短期キーを発行しており、発行に使用する永続的なキーの権限が絞り込まれていること。
- 新しいバージョンのキーが管理された状態で保存されていること。旧バージョンのキー、未使用のキー、離職したメンバーに関連するキーが確認済みであること。
- アカウント、ワークスペース、キーレベルの予算とアラートが設定済みで、通知チャネルと担当者が明確であること。
- 「予算到達時にサービスを停止」の可用性への影響と反映の遅延が評価済みであること。
- ローテーションと漏洩対応の手順が明確であり、調査手順は API キー漏洩の調査を参照していること。
よくある質問
一時的な API キーの権限は永続的な API キーより小さいですか?
一時的な API キーの権限は永続的な API キーより小さいですか?
小さくありません。一時的な API キーは、発行に使用した永続的な API キーのすべての権限を継承し、有効期間のみ短くなります。より小さい権限が必要な場合は、まず発行に使用する永続的な API キーの権限を絞り込んでください。
IP ホワイトリストを設定していますが、キーの漏洩を心配する必要はありますか?
IP ホワイトリストを設定していますが、キーの漏洩を心配する必要はありますか?
あります。IP ホワイトリストは呼び出しの送信元ネットワークのみを制限でき、同じ出口ネットワーク内に漏洩したキーは悪用される可能性がまだあります。最小権限、予算アラート、定期的なローテーションと併用してください。
キーをサードパーティの中継サービスに渡してしまった場合はどうすればよいですか?
キーをサードパーティの中継サービスに渡してしまった場合はどうすればよいですか?
そのサービスへの新しいキーの提供を停止し、提供済みのキーをローテーションし、公式 API または信頼できるサーバーサイド連携に切り替えてください。漏洩したキーの処置手順については、API キー漏洩の調査をご参照ください。