Skip to main content

API キー漏洩防止のベストプラクティス

認証情報の露出時間の短縮、権限範囲の絞り込み、アラートと損失軽減の設定という 3 つの観点から API キーの漏洩を防止します。一時的な API キー、定期的なローテーション、IP ホワイトリスト、プライベート接続、予算アラート、モデルモニタリングアラートを取り上げます。

概要

API キーは、Alibaba Cloud Model Studio のモデルサービスを呼び出すための認証情報です。ひとたび漏洩すると、それを入手した誰もがそのキーの認可範囲内のモデルを呼び出してクォータを消費できます。漏洩による影響は 4 つの因子に分解できます。漏洩確率、露出時間、1 回の呼び出しの権限範囲、異常の継続時間です。漏洩確率は本ページ全体を貫く基礎プラクティスによって低減され、残りの 3 つの因子はそれぞれ次の 3 つの観点で低減されます。

観点

低減される因子

主要な対策

露出時間の短縮

露出時間

クライアントでの一時的な API キーの利用、一度きりの表示と管理された保存、定期的なローテーションと離職時の失効

権限範囲の絞り込み

1 回の呼び出しの権限範囲

1 業務 1 キー、ワークスペース分離、IP ホワイトリストとモデル範囲、プライベート接続

アラートと損失軽減

異常の継続時間

予算アラートと予算到達時のサービス停止、モデルモニタリングアラート、プラットフォームのリスク検出

3 つの観点すべてに共通する基礎プラクティス:
  • アプリケーションは認証情報を環境変数またはキーマネージメントサービスから読み込み、コードにハードコードしません。CI/CD で機密情報スキャンを設定し(gitleaks などの認証情報スキャンツールが利用可能)、API キーのパターンをカバーします。
  • キー台帳を管理します。キー ID、用途、担当者、最終ローテーション日を記録する基本的な表から始め、リージョン、ワークスペース、権限範囲、予算などの項目を徐々に補完します。台帳に完全なキーは保存しません。
  • キーの管理権限(作成、表示、編集、削除)を必要な管理者に限定します。

認証情報の露出時間を短縮する

永続的な API キーを適切に保管する

新規作成した API キーの完全な値が表示されるのは作成時の 1 回のみです。ダイアログボックスを閉じると、完全な平文は再表示もコピーもできません。保存しなかった場合は、リセットまたは再作成するしかありません。API キーの取得をご参照ください。 作成後、完全なキーは管理された認証情報ストア(キーマネージメントサービスまたはデプロイプラットフォームのシークレット管理)に直接保存してください。スクリーンショット、メール、チャットツール、通常のドキュメントで中継しないでください。リストに表示されるマスク済みの値は、照合と識別にのみ使用します。 永続的な API キーを次の場所に置かないでください:
  • ブラウザースクリプト、フロントエンドのビルド成果物、モバイルアプリのインストールパッケージ
  • 公開または共有のコードリポジトリ(.gitignore を追加するだけでは、履歴コミット内の認証情報は削除されません)
  • Notebook の出力、サンプルコード
  • スクリーンショット、画面録画
  • チケット、グループチャット、オンラインドキュメント
  • プロンプト、ナレッジベース、エージェントのコンテキスト
  • リクエスト URL とクエリパラメーター
  • アクセスログと例外スタックトレース
  • サードパーティプラグインとモデル中継サービス
  • 共有環境、外部に公開される設定ファイル、イメージとバックアップ
ローカルデバッグ時は、非表示入力で環境変数を設定し、平文がコマンド履歴に残るのを避けることを推奨します:
read -r -s -p "Enter API key: " DASHSCOPE_API_KEY
printf '\n'
export DASHSCOPE_API_KEY
この例は Linux/macOS 環境に適用されます。
環境変数はハードコードを避けられますが、暗号化された保存ではありません。認証情報は、プロセスの診断情報、コンテナー設定、クラッシュダンプ、運用データのエクスポートなどの経路で漏洩する可能性がまだあります。デバッグ時は、set -x のような機密変数を出力するオプションを使用しないでください。本番環境では、キーマネージメントサービスまたはデプロイプラットフォームのシークレット注入を使用してください。
信頼できないモデル中継サービスやサードパーティプラグインに API キーを提供したことがある場合は、新しいキーの提供を停止し、公式 API または信頼できるサーバーサイド連携に切り替えて、提供済みのキーをローテーションしてください。

クライアント側のシナリオで一時的な API キーを使用する

ブラウザー、モバイルアプリ、ミニプログラムなどの環境では、認証情報を確実に秘匿できません。このようなシナリオでは、認証済みのバックエンドに一時的な API キーを発行させ、フロントエンドから直接呼び出せるようにしてください:
  1. 永続的な API キーは自社のサーバーのみに保存し、いかなるクライアントにも配布しません。
  2. フロントエンドがモデルを呼び出す必要がある場合は、まずバックエンドに一時的なキーを申請します。
  3. バックエンドは一時的な API キー生成 API を呼び出し、短い有効期間の st- キーを発行してフロントエンドに返します。
  4. フロントエンドは st- キーで Model Studio に直接接続してモデルを呼び出します。
一時的な API キーのデフォルトの有効期間は 60 秒で、expire_in_seconds で 1〜1,800 秒を設定できます(タスクに必要な最短時間を設定し、無条件に最大値を使用しないでください)。期限が切れると自動的に失効し、事前の削除はサポートされません。一時的な API キーは、発行に使用した永続的な API キーのすべての権限を継承します。より小さい権限が必要な場合は、まず発行に使用する永続的なキーの権限を絞り込んでください。発行 API は OpenAPI 経由で永続的なキーを使って呼び出されるため、呼び出し元の権限を検証し、発行頻度を制限して、公開された認証情報の発行窓口にならないようにしてください。API の詳細については、一時的な API キーの生成をご参照ください。

定期的なローテーションと離職時の失効

コードやエージェントに設定された長期間有効なキーは、時間とともに露出面が蓄積するため、定期的にローテーションしてください:
  1. 新しいキーを作成し、現在のニーズに合わせて権限と予算を再設定します。
  2. 業務側の認証情報の参照を更新します。
  3. 新しいキーで呼び出しが正常に動作することを確認します。
  4. 古いキーを削除し、古いキーが新しい呼び出しを開始できないことを確認します。
  5. キー台帳を更新します。
新しいキーは古いキーの権限と予算の設定を自動的に継承しないため、再設定が必要です。メンバーが離職する場合や業務を終了する場合は、その名義のキーを個別に棚卸して削除またはローテーションする必要があります。2026 年 3 月 25 日以降に作成された API キーは、帰属する RAM ユーザーの削除に連動して削除されず、引き続き使用できます(このルールはキーが RAM サブアカウントに帰属する場合にのみ関係します)。そのため、RAM ユーザーが削除されたことだけをもって認証情報が回収されたとは判断できません。API キーの有効期間をご参照ください。 複数のキーが同じ侵害が疑われるサーバー、公開設定、コードリポジトリ、またはサードパーティ環境に保存されている場合は、影響を受ける可能性のある認証情報をまとめてローテーションし、環境を修復してください。すべてのキーを無差別に交換する必要はなく、共通の露出環境を無視して単一のキーだけを処置することも避けてください。 高度な方法:キーの平文をキーマネージメントサービス(KMS)に保管し、アプリケーションが認証情報名で取得するようにし、KMS のキーローテーション機能で定期的に更新します。

認証情報の権限範囲を絞り込む

1 業務 1 キーとワークスペース分離

異なるアプリケーションと異なる環境(本番、テスト、個人デバッグ)に独立した API キーを割り当ててください。これにより、単一のキーの漏洩による影響範囲が縮小され、キーごとの問題の切り分けと個別のローテーションが容易になります。権限分離、きめ細かなモデルアクセス制御、独立したコスト管理が必要な場合は、業務にデフォルト以外のワークスペースを割り当ててください(ワークスペースは Model Studio で権限とコストを分離するコンテナーであり、アカウントにはデフォルトでデフォルトワークスペースが存在します)。キーの基本的な呼び出し範囲は、帰属するワークスペースに制約されます。権限管理をご参照ください。 また、キーの管理権限を必要な管理者に限定してください。コンソールにログオンして認証情報を管理できるアカウントは、最小権限とし、組織の要件に従って多要素認証を有効にしてください。

IP ホワイトリストとモデル範囲の設定

API キーの作成または編集パネルで権限をカスタムに設定すると、キーの呼び出し範囲をさらに絞り込めます:
  • IP ホワイトリスト:業務で実際に使用されるパブリックの出口 IP または CIDR ブロックのみを許可します(最大 20 件。curl ifconfig.me などでパブリックの出口 IP を確認できます)。デフォルトではすべての IPv4 アドレスが許可されます。キーを作成しただけでは、送信元制限が有効になったことにはなりません。NAT、プロキシ、またはゲートウェイ経由で呼び出す場合は、サーバーのイントラネットアドレスではなく、Model Studio が実際に認識するパブリックの出口 IP アドレスを入力してください。
  • アクセス可能なモデル範囲:有効にすると、そのキーは選択されたモデル(最大 30 件、ワークスペースに認可されたモデルに制約されます)のみを呼び出しできます。漏洩後に高コストのモデルへ悪用されるのを防ぎます。
設定後、絞り込みが有効になっていることを確認してください。許可されたネットワークとモデルのみが呼び出し可能で、認可されていないものは呼び出し不可であることを確認します。確認時に完全なキーを出力しないでください。操作入口と完全なルールについては、API キーの権限をご参照ください。
IP ホワイトリストは認証情報の秘匿の代替にはなりません。同じ出口ネットワークから呼び出しを開始できる人や侵害されたホストは、漏洩したキーを悪用できる可能性がまだあります。

プライベート接続経由での呼び出し

ネットワークセキュリティ要件が高いシナリオでは、VPC と Model Studio の間にプライベート接続(PrivateLink)を確立できます。呼び出しはパブリックネットワークを経由しないため、キーが漏洩しても、ネットワークが接続されていない外部の攻撃者は呼び出せません。設定方法については、プライベートネットワーク経由での Model Studio API へのアクセスをご参照ください。

アラートと損失軽減を設定する

予算アラートと予算到達時のサービス停止

アカウント、ワークスペース、または単一の API キーに対して月間予算とアラートしきい値を設定します。開発テスト、デモ、サードパーティ連携などの高リスクのキーに優先して独立した予算を設定してください。費用がしきい値に達したときと予算を使い切ったときに、サイト内メッセージ、SMS、メール、またはボット経由で通知されます。「予算到達時にサービスを停止」を有効にすると、予算を使い切った時点で、そのディメンションの従量課金の呼び出しが制限され、429 が返されます。設定方法については、予算管理をご参照ください。
「予算到達時にサービスを停止」には反映の遅延があり、遅延期間中に発生した費用は引き続き課金されます。プリセットスループット(PTU)のオーバーフロー分とアプリケーションが発生させる呼び出しは、自動停止の対象外です。本番の重要業務では自動停止を有効にせず、アラートと管理された処置を優先してください。

モデルモニタリングアラート

モデルモニタリングは、ワークスペースごとに呼び出し回数、トークン使用量、失敗回数、失敗率などの指標を集計し、API キーによるフィルタリングをサポートします。プリセットまたはカスタムのアラートテンプレートに基づいてアラートルールを作成し、担当者または担当者グループに通知できます。高リスクのキーには、呼び出し量や呼び出し回数の急増系アラートを設定することを推奨します。異常は呼び出しの発生から数分以内に可視化され、勤務時間外の発報には人的な対応が必要です。初めてアラートを設定する場合は、まずデータ転送で Cloud Monitor のサービスロールを認可する必要があります。設定方法については、アラートをご参照ください。

プラットフォームのリスク検出

プラットフォームは、公開コードリポジトリなどのパブリックネットワーク環境を定期的にスキャンして漏洩した API キーを識別し、主体的に通知します。実際のチャネルは有効化されているものによります(SMS、メール、サイト内メッセージなどが含まれる可能性があります)。また、通常と異なる IP からのログオン、夜間の突発的なトラフィック、費用の異常な急増などの異常な行動も識別します。 プラットフォームのリスク検出とアラートは、プラットフォームが利用体験の向上のために主体的に提供する異常検出と警告の能力であり、SLA で定められたサービス範囲には含まれません。リスクシナリオの複雑さにより、絶対的なアラート網羅率は保証されず、アラートの識別と通知に遅延が生じる場合もあります。API キーなどの認証情報の安全な保管とコンプライアンスに沿った利用はお客様の責任範囲に属します。ご自身で設定した予算アラート、モデルモニタリングアラート、定期的なローテーションを主要な防御線としてください。プラットフォームのアラートを受信しなくても、漏洩のリスクがないことを意味するわけではありません。漏洩の疑いを発見した場合、またはアラートを受信した場合は、API キー漏洩の調査に従って特定と処置を行ってください。

リリース前チェックリスト

個人開発者や小規模チームは、まず最小限のセットアップを完了できます。キーに予算とアラート通知を設定し、認証情報は環境変数のみに保存し、定期的にローテーションします。完全なチェックリストは以下のとおりです:
  • 本番、テスト、サードパーティ連携が同じ API キーを共有しておらず、キーの担当者と用途が明確であること。
  • 帰属リージョン、ワークスペース、モデル範囲、リクエストの出口 IP が確認済みで、権限が必要な範囲のみをカバーしていること。
  • 永続的なキーが管理されたバックエンドのみに保存され、クライアント、ソースコード、プロンプト、共有ドキュメント、ログに入らないこと。
  • キーが信頼できないサードパーティの中継サービスやプラグイン環境に提供されていないこと。提供したことがある場合は、提供を停止し、ローテーションが完了していること。
  • 認証情報が環境変数またはシークレットで注入され、機密ファイルとビルド成果物に平文が含まれないこと。
  • クライアント直接接続のシナリオでは、認証済みバックエンドが短期キーを発行しており、発行に使用する永続的なキーの権限が絞り込まれていること。
  • 新しいバージョンのキーが管理された状態で保存されていること。旧バージョンのキー、未使用のキー、離職したメンバーに関連するキーが確認済みであること。
  • アカウント、ワークスペース、キーレベルの予算とアラートが設定済みで、通知チャネルと担当者が明確であること。
  • 「予算到達時にサービスを停止」の可用性への影響と反映の遅延が評価済みであること。
  • ローテーションと漏洩対応の手順が明確であり、調査手順は API キー漏洩の調査を参照していること。

よくある質問

小さくありません。一時的な API キーは、発行に使用した永続的な API キーのすべての権限を継承し、有効期間のみ短くなります。より小さい権限が必要な場合は、まず発行に使用する永続的な API キーの権限を絞り込んでください。
あります。IP ホワイトリストは呼び出しの送信元ネットワークのみを制限でき、同じ出口ネットワーク内に漏洩したキーは悪用される可能性がまだあります。最小権限、予算アラート、定期的なローテーションと併用してください。
そのサービスへの新しいキーの提供を停止し、提供済みのキーをローテーションし、公式 API または信頼できるサーバーサイド連携に切り替えてください。漏洩したキーの処置手順については、API キー漏洩の調査をご参照ください。