Netskope AI Gatewayをゼロからセットアップし、最初のリクエストを送信します。VMをデプロイし、Netskopeテナントに登録してAIプロバイダーを接続し、ゲートウェイ経由でトラフィックをルーティングします。必要な情報はすべてこのページに記載されています。
実行内容
| Phase | Goal | 勤務先 | 完全なドキュメント |
|---|---|---|---|
| 1. Prepare | 要件を確認してVMサイズを選択する | ユーザーの環境 | AI Gatewayの概要:前提条件 サイジングガイドライン |
| 2. VMのデプロイ | 画像を取得し、起動する | NetskopeテナントUIおよびハイパーバイザーまたはクラウドコンソール | VMイメージのインストールと展開 |
| 3.登録および加入 | VMをテナントに接続する | Netskope tenant UI and the AI Gateway CLI | セットアップと登録 |
| 4. 設定する | AIプロバイダー、トークングループ、トークンを追加する | Netskope tenant UI | Configuration |
| 5. リクエストを送信する | アプリケーションをゲートウェイに向けます | ユーザーのアプリケーション | トラフィックを単一の AI Gateway エンドポイントにルーティングする |
始める前に要件を確認してください
- Platform: VMware ESXi、AWS、Google Cloud プラットフォーム(GCP)、またはMicrosoft Azure。柔軟な導入を参照してください。
- Host CPU: ホストはAVX2をサポートしています。それがないとデプロイメントは失敗します。
- Network access: VM はポート 443 で、使う予定の Netskope テナントおよび AI プロバイダーに到達できます。トラフィックが企業プロキシを経由する場合は、VM でプロキシを構成します。ポートとエグレス URL の完全なリストについては、インフラストラクチャネットワーク要件を参照してください。
- Netskope tenant: 管理者アクセス権と有効なAI Gatewayライセンスが必要です。管理要件とAI Gatewayライセンス契約条件をご覧ください。
- AI provider credentials: 使う予定のプロバイダー(OpenAI、Google Gemini、または Anthropic Claude)ごとに有効な API キーがあります。サポートされる LLM を参照してください。
- Traffic steering: エージェントは、トラフィックをLLMエンドポイントに直接ではなく、ゲートウェイに送信します。ルーティング要件をご覧ください。
- Certificate (optional): デフォルトの自己署名証明書を使用したくない場合は、ゲートウェイのホスト名の証明書要求に署名するCAを用意してください。
VMサイズを選択してください
| サイズ | AWS | GCP | Azure | ESXi |
|---|---|---|---|---|
| Small | c6a.4xlarge (16コア/32 GB) | c2d-highcpu-16 | D16ls_v7 (16 cores/32 GB) | 16 cores/32 GB |
| 中くらい | c6a.8xlarge(32コア/64 GB) | c2d-highcpu-32 | D32ls_v7 (32 cores/64 GB) | 32 cores/64 GB |
少なくとも300 GBのディスク容量を確保してください。検査タイプごとのスループットの数値については、AI Gatewayのサイジングガイドラインをご覧ください。
画像を取得する
- NetskopeテナントUIにログインしてSettings > Security Cloud Platform > VM Onboardingに移動します。
- Deploy VM > Get VM Imageをクリックしてください。
- プラットフォームのイメージを取得:
- ESXi: ESXiイメージを選択し、Downloadをクリックして
ai-gateway-ova.zipを取得します。詳細な手順:VMware ESXiイメージのダウンロード。 - AWS: AWS AMIセクションで、AWS Marketplaceリンクをクリックします。全ステップ:AWS Amazon Machine Image (AMI)の起動。
- GCP: GCP Marketplaceリンクをクリックします。全ステップ:Google Cloud プラットフォーム(GCP)イメージの起動。
- Azure: Azureの横にある View instruction をクリックします。イメージは、Netskopeがプロビジョニングした後にのみAzureサブスクリプションに表示されます。全ステップ:Azureイメージの起動。
- ESXi: ESXiイメージを選択し、Downloadをクリックして
VMを起動
プラットフォームの手順に従ってください。これら4つのトピックはすべて、インフラストラクチャへのインストールの配下にインデックスが作成されます。
VMware ESXi (全手順:ESXiへのOVAの展開)
ai-gateway-ova.zipを解凍してOVAファイルを取得します。- ESXiホストにログインし、Inventory > Hosts and Clustersに移動します。
- ホストを右クリックし、Deploy OVF Templateをクリックします。
- Select an OVF templateでLocal fileをクリックし、Upload filesをクリックして、OVAを選択します。URLを入力することもできます。
- 一意のVM名を入力し、ターゲットの場所を選択します。
- Select コンピューティングリソースを選択し、Automatically power on deployed VMを有効にします。
- 詳細を確認し、Select storageでシックプロビジョニングまたはシンプロビジョニングを選択します。
- Select VM Networkを宛先ネットワークとして選択し、Finishをクリックします。
AWS (完全な手順:AWS AMIイメージの展開)
- EC2管理コンソールで、Launch Instanceをクリックします。
- Netskope One AI Gateway を検索し、AWS Marketplace AMIからAMIを選択します。
- サイズ設定テーブルからインスタンスタイプを選択し、サインインに使うSSHキーペアでインスタンスを起動します。
- Elastic IPを割り当てます。次に、インスタンスのネットワークインターフェースを選択し、Actions > Associate Address を選択して割り当てます。
AWSブートストラップを自動化するには、AWS Secrets Managerを使う自動ブートストラップを参照してください。
GCP (全ステップ:GCPイメージの展開)
- Compute EngineでVM Instancesに移動し、Create Instance > Create VM from Marketplaceをクリックします。GCP MarketplaceでNetskope One AI Gatewayを検索することもできます。
- インスタンス名、サービスアカウント、マシンタイプ、ブートディスク、およびネットワークを指定します。
VMを作成した後にSSHキーを追加または変更するには、同じトピックをご覧ください。
Azure (完全な手順:Azureイメージの展開)
- Azureポータルで、Virtual machines に移動し、Images ドロップダウンを開いて All images を選択します。
- Marketplaceに移動し、Netskope One AI Gatewayを検索します。
- サイジングテーブルからサイズを選択します。このイメージは、Trusted Launchを搭載した第2世代VMをサポートします。
- 管理者アカウントを設定します。ユーザー名は
nsadminに固定されています。インバウンドSSH(ポート22)を許可します。パスワードを使う場合は、小文字、大文字、数字、特殊文字の少なくとも3種類を含む12~72文字にします。
登録と加入の手順の詳細:NetskopeポータルにAI Gatewayをデプロイする。
ゲートウェイをテナントに登録する
- In the Netskope tenant UI, go to Settings > Security Cloud Platform > VM Onboarding.
- Deploy VM > Register VMをクリックしてください。
- Step 1 (Configure)で、VM Name (AI Gateway)とHostnameを入力します。ホスト名は、ゲートウェイに解決される有効なドメイン名である必要があります。
- Protocol and Port で、ゲートウェイが使用するHTTPSおよびHTTPポートを選択します。
- Continue をクリックします。Step 2 (Register)では、テナントが登録トークンを生成します。
- CopyまたはDownloadをクリックしてトークンを保存し、Finishをクリックします。
トークンは、生成されてから24時間で期限切れになります。その期間内にゲートウェイを登録してください。
アプライアンスにサインインする
全手順:アプライアンスへのサインイン。
nsadminとしてAI Gateway CLIに接続します:
ssh nsadmin@<appliance-ip>
- ESXi: デフォルトのパスワードは
nsadminです。設定ウィザードで変更するように指示されます。新しいパスワードは、数字、大文字、小文字、特殊文字を含む14文字以上にする必要があります。 - AWS: キーペアを使う:
ssh -i /path/to/key.pem nsadmin@<appliance-ip> - GCP: このインスタンスは、
nsadminメタデータに追加したSSHキーを使用します。 - Azure: VMの作成時に設定したSSHキーまたはパスワードを使います。
5回連続でサインインに失敗すると、nsadminアカウントが15分間ロックされます。
ネットワークを構成する
- ESXi: 設定ウィザードで Network Configuration を開き、DNSサーバー、DHCP、または静的IPを設定します。
- AWS: AWSコンソールでネットワークを設定するか、DHCPを使用してください。AI Gateway CLIで静的IPを設定しないでください。VPCと競合し、接続が遮断される可能性があります。
ゲートウェイを登録する
- 設定ウィザードで、Enroll this AI Gateway を選択します。
- 事前登録で AI Gateway サービスがセットアップされるまで数分待ちます。
- AI Gateway Enrollmentページが表示されたら、登録トークンを貼り付けます。
- CLIが登録を確定し、Gateway IDを表示するまで待ちます。
登録を確認
テナントUIで、Settings > Security Cloud Platform > VM Onboarding に移動します。VM-Name 列のVMの横にある緑色のアイコンは、ゲートウェイが登録されていることを確認します。
証明書のインストール (オプション)
全手順については、AI Gatewayへの証明書のインストールを参照してください。
AI Gatewayはデフォルトで自己署名証明書を使用します。それを保持する場合は、AIエージェントがそれを信頼するように構成するか、検証をスキップするように構成してください。CA署名付き証明書を使う場合:
- 設定ウィザードで、Certificate Managementを開き、Generate CSRを選択します。Common Nameがゲートウェイのホスト名と一致するように設定し、他のフィールドに入力します。
- ルートCAまたは証明書プロバイダーにCSRへの署名を依頼してください。
- Select Install Certificateを選択し、署名済み証明書をPaste your signed certificateの下に貼り付けます。
トピックの全リスト:設定
AIプロバイダーを追加する
全ステップ:AIプロバイダーリスト、カスタムAIプロバイダーの追加または登録、カスタムAIプロバイダーをAIGに関連付け。
- Settings > Security Cloud Platform > AI Gateway > AI Providerへ移動してください。
- 必要なプロバイダーがリストに表示されていることを確認します。AI Gatewayは、OpenAI、Google Gemini、およびAnthropic Claudeのスキーマをサポートしています。
- リストにないプロバイダーを追加するには、New AI Providerをクリックして次を入力します。
- Name: AI Gatewayは、接頭辞
custを自動的に追加します。 - AI Schema: OpenAI、Google Gemini、Claude、またはその他。
- Host: AIプロバイダーのドメイン名。
- Protocol & Port: プロバイダーがリッスンするHTTPSおよびHTTPポート。
- Name: AI Gatewayは、接頭辞
- Saveをクリックしてください。
- カスタムプロバイダーの場合は、Settings > Security Cloud Platform > AI Gateway > Gateway Setupに移動し、ゲートウェイを選択し、Link Custom AI Providersをクリックし、プロバイダーを選択して、Saveをクリックします。
Othersスキーマを選択すると、AI Gatewayはアクセス制御、レート制限、および認証を提供します。これらのプロバイダーでは、DLP検査およびAI Security Guardrailsは利用できません。
AWS Bedrockを使用していますか?カスタムAIプロバイダーとしてのAWS Bedrockの構成を参照してください。
トークン・グループを作成する
全ステップ:新しいトークングループの作成。概要:認証トークンとグループ。
- Settings > Security Cloud Platform > AI Gateway > Authentication Token & Groupへ移動してください。
- New Token Groupをクリックしてください。
- Token Group Nameを入力します。必要に応じてデスクリプションを追加します。
- Saveをクリックしてください。
トークン・グループにより、複数のトークンに対して一度にポリシーやレート制限を適用できます。
Create a token
手順の詳細については、新しいトークンの作成をご覧ください。
- Authentication Token & GroupページでNew Tokenをクリックします。
- Tokenの名前を入力します。
- オプションで Expire In を設定し、単位(時間、日、週、または月)を選択します。
- Token Groupを選択します。
- Saveをクリックしてください。
- Copy Tokenウィンドウからトークンをコピーし、安全に保管します。二度と表示することはできません。
プロバイダーキーをAI Gatewayに保存する(推奨)
完全な手順:AIプロバイダーAPIキー(仮想キー)。
仮想キーは、実際のプロバイダーのAPIキーをアプリケーションコードから除外します。キーを1回追加すれば、AI Gatewayはそれをアウトバウンド要求にスワップします。
- Settings > Security Cloud Platform > AI Gateway > Providerに移動し、プロバイダーを選択します。
- Add Keyをクリックし、一意のName of API keyを入力し、プロバイダーのAPIキーを貼り付けて、[保存]をクリックします。AI Gatewayは、キーを保存する前にプロバイダーでキーを検証します。
- Settings > Security Cloud Platform > AI Gateway > Token Group に移動し、トークン・グループを開きます。
- AI provider keysでプロバイダーと保存されたキーを選択し、保存します。
このグループのトークンを使うアプリケーションは、APIキーを処理することなく今プロバイダーに到達します。
全ステップ:トラフィックを単一のAI Gatewayエンドポイントにルーティングする。
- Settings > Security Cloud Platform > AI Gateway > Gateway Setup に移動します。ゲートウェイのアドレスと、AI Provider 列の名前と一致するプロバイダー slug をメモしておきます。
- プロバイダーの代わりにゲートウェイにリクエストを送信:
curl https://<your-ai-gateway-fqdn>/v1/chat/completions \ -H "Content-Type: application/json" \ -H "x-ns-aig-apikey: <your-aig-token>" \ -H "x-ns-aig-slug: openai" \ -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
x-ns-aig-apikeyフェーズ 4 で作成したトークンを伝送します。x-ns-aig-slugゲートウェイに、ルーティング先のプロバイダーを指定します。プロバイダーを切り替えるには、スラッグだけを変更し、それ以外は変更しないでください。- 仮想キーを設定しなかった場合は、プロバイダー独自のクレデンシャルも
Authorizationヘッダーで送信します。
Gateway Setupページには、プロバイダーごとに個別のベースURLを保持する場合、各プロバイダーのHTTPSおよびHTTPベースURLも表示されます。
エージェントとSDKについては、トークンを環境変数に保存し、呼び出しごとにx-ns-aig-apikeyヘッダーで渡します。
次のステップ
- DLPやAI Security Guardrailsを含むポリシーを作成します。AI Gatewayポリシー。リクエストに独自のメタデータをタグ付けするには、カスタムメタデータをご覧ください。
- レート制限を設定します:レート制限。
- トラフィックの確認:AI Gatewayイベントの監視。
- 設定の自動化:設定API。
- 問題が解決しない場合は?トラブルシューティングと診断をご覧ください。

