​

Google Cloud — ディスカバリー

​

SecureAI がインポートするもの

• Vertex AI: エージェント (Agent Engine)、サービング エンドポイント、実行中のバッチ ジョブとチューニング ジョブ、モデル — Model Registry に加え、使用中のすべてのパブリッシャー モデル (Gemini、Claude、オープンモデル)。
• Agent Builder / Gemini Enterprise と Dialogflow CX (任意): Agent Builder (Discovery Engine) のエンジンとそのデータストア (global、us、eu の各ロケーションで照会)、および Dialogflow CX のエージェント (global と、設定した Vertex AI のロケーションで照会)。
• 過去 30 日間のモデルごとの使用状況: リクエスト数 (およびそのうち失敗した数)、入力トークンと出力トークン、プロンプト キャッシュのトークン。
• 過去 30 日間の認証情報ごとの使用状況 (Cloud Monitoring): サービス アカウントと API キーごとの、リクエストの総数と AI API (Vertex AI、Gemini API、Agent Builder、Dialogflow) へのリクエスト数。OAuth クライアントのトラフィック (ユーザーや、コンソール、gcloud などのツール) は別途集計されます。これらのアカウントとキーの最終使用日時もここから得られます。
• モデルと ID ごとの使用状況 (任意): どのサービス アカウントまたはユーザーがどの Vertex AI モデルを呼び出したか。データアクセス監査ログを有効にしている場合に、そこから取得します。モデルと ID ごとの使用状況を参照してください。
• SecureAI を経由しない Vertex AI の使用: SecureAI の推論接続を経由せずに Vertex AI または Gemini を直接呼び出した ID。SecureAI を経由しない Vertex AI の使用を参照してください。
• 過去 30 日間のコスト: BigQuery への請求データのエクスポートから得た、このプロジェクトの AI に関する実際の支出、または定価による見積もり。
• NHI: サービス アカウント、ユーザー管理のサービス アカウント キー、API キー、Workload Identity Federation のプールとプロバイダ、OAuth クライアント — 最終使用日時 (Policy Analyzer と認証情報ごとの使用状況から取得) と特権リスクも含みます。NHI インベントリから、手動またはNHI の自動ポリシーで取り消しと復元ができます。
• プロジェクトの IAM ロール バインディング。
• AI サービスと ID サービス (Vertex AI、IAM、IAM Credentials、STS、API Keys、Resource Manager) の Cloud Audit Logs: 過去 30 日間の最新 200 件のイベント。

​

前提条件

​

有効にする API

​

ロール

​

認証情報

​

入手方法

1. Google Cloud コンソールで、IAM と管理 → サービス アカウント → サービス アカウントを作成 に移動します (例: secureai-discovery)。
2. IAM と管理 → IAM → アクセスを許可 に移動し、サービス アカウントのメールアドレスをプリンシパルとして入力して、前提条件のロールを追加します。
3. サービス アカウント に戻ってアカウントを開き、キー → 鍵を追加 → 新しい鍵を作成 → JSON でファイルをダウンロードします。
4. JSON 全体を Service Account JSON に貼り付け、ダウンロードしたファイルを削除します。

PROJECT=my-project-123
gcloud services enable cloudresourcemanager.googleapis.com iam.googleapis.com aiplatform.googleapis.com \
  apikeys.googleapis.com monitoring.googleapis.com logging.googleapis.com policyanalyzer.googleapis.com \
  --project=$PROJECT
gcloud iam service-accounts create secureai-discovery --project=$PROJECT --display-name="SecureAI discovery"
SA=secureai-discovery@$PROJECT.iam.gserviceaccount.com
for ROLE in roles/aiplatform.viewer roles/iam.securityReviewer roles/monitoring.viewer roles/logging.viewer; do
  gcloud projects add-iam-policy-binding $PROJECT --member=serviceAccount:$SA --role=$ROLE --condition=None
done
# 任意: 最終使用日時、モデルと ID ごとの使用状況、Agent Builder、Dialogflow CX
for ROLE in roles/policyanalyzer.activityAnalysisViewer roles/logging.privateLogViewer roles/discoveryengine.viewer roles/dialogflow.reader; do
  gcloud projects add-iam-policy-binding $PROJECT --member=serviceAccount:$SA --role=$ROLE --condition=None
done
gcloud iam service-accounts keys create secureai-discovery.json --iam-account=$SA

1. サービス アカウントを作成し、ロールを付与します (上記の手順 1 と 2)。
2. SecureAI の接続フォームでは、Service account to impersonate (keyless — instead of the JSON) フィールドのヘルプテキストに、承認が必要な SecureAI のアカウントが表示されます。Google Cloud でご自身のサービス アカウントを開き、権限 → アクセスを許可 で、そのアカウントをプリンシパルとして入力し、roles/iam.serviceAccountTokenCreator を付与します。gcloud で行う場合:
   gcloud iam service-accounts add-iam-policy-binding $SA \
     --member=serviceAccount:SECUREAI_ACCOUNT --role=roles/iam.serviceAccountTokenCreator
   
3. フィールドにご自身のサービス アカウントのメールアドレスを入力し、JSON は空のままにします。

​

取り消し用の別のサービス アカウント

1. 2 つ目のサービス アカウント (例: secureai-revoke) を作成し、前提条件の取り消しのロールのみを付与します。
2. そのアカウントで、Service account for revocation (optional — separate from reading) フィールドのヘルプテキストに表示される SecureAI のアカウントに roles/iam.serviceAccountTokenCreator を付与します。
3. そのフィールドにこのアカウントのメールアドレスを入力します。

​

組織またはフォルダ モード

• SecureAI は Cloud Asset Inventory でアクティブなプロジェクトを見つけ、それぞれを単一プロジェクトのコネクタと同じように読み取ります。Google Cloud Project ID は引き続き割り当てと請求のプロジェクトです。
• サービス アカウントに、組織またはフォルダに対して次のロールを付与します: roles/cloudasset.viewer、roles/iam.securityReviewer、roles/aiplatform.viewer、さらに使用状況と監査のために roles/monitoring.viewer と roles/logging.viewer。
• サービス アカウントのプロジェクトで cloudasset.googleapis.com を有効にします。

ORG=123456789012
for ROLE in roles/cloudasset.viewer roles/iam.securityReviewer roles/aiplatform.viewer roles/monitoring.viewer roles/logging.viewer; do
  gcloud organizations add-iam-policy-binding $ORG --member=serviceAccount:$SA --role=$ROLE --condition=None
done
gcloud services enable cloudasset.googleapis.com --project=$PROJECT

​

接続する

1. Admin → Integrations → Cloud → Google Cloud — 検出 → 統合を接続。
2. プロジェクト ID、ロケーション (または More Vertex AI Locations で複数)、そして JSON キーまたは権限借用するサービス アカウントのいずれかを入力します。使用する場合は、取り消し用のサービス アカウント、組織またはフォルダ、請求関連のフィールドも追加します。
3. 接続 をクリックします。SecureAI は保存前に、プロジェクトを実際に読み取って認証情報を確認します — 数秒かかります。プロジェクトを読み取れない場合は理由を表示し、何も保存しません。入力した内容はフォームに残ります。表示される可能性のあるメッセージはトラブルシューティングにあります。
4. 保存はされたもののロールが不足している場合は、警告に不足しているロールが一覧表示されます。それらを付与して、再度同期してください。
5. カードの更新ボタンで今すぐ同期します。以降、SecureAI は 6 時間ごとに自動的に同期します。

​

確認する

• Cloud Sensors に検出されたエージェントが一覧表示されます。Google Cloud のカードをクリックすると GCP パネルが開きます: 使用状況とコスト (リクエスト数、失敗数、トークン、キャッシュ、コストとその取得元)、モデルとデプロイ、ID とアクセス (サービス アカウントとキー、およびその最終使用日時、IAM バインディング)、監査。
• パネルに Discovery could not read everything と表示された場合は、各行を確認し (トラブルシューティングを参照)、再度同期してください。
• NHI インベントリにはサービス アカウントとキーが表示されます。

​

モデルと ID ごとの使用状況

• SecureAI がこれを読み取るのは、aiplatform.googleapis.com (またはすべてのサービス) に対して DATA_READ または DATA_WRITE のログが有効になっている場合だけです。SecureAI は IAM ポリシーからこれを検出します。SecureAI がログを有効にすることはありません。
• 有効にすると、Google の料金で Cloud Logging の取り込み費用が発生します。有効にするには IAM と管理 → 監査ログ → Vertex AI API → データ読み取り を使用します。
• サービス アカウントには roles/logging.privateLogViewer が必要です。
• SecureAI はプロジェクトおよび同期ごとに、最大 5,000 件のエントリ、または 20 秒間のうち、先に達した方まで読み取ります。
• 無効になっている場合、パネルには有効にする方法を説明する任意の不足項目が表示されます。組織またはフォルダで有効にしていても、単一のプロジェクトを接続している場合、SecureAI はプロジェクトのポリシーからそれを確認できないため、不足項目が表示されたままになります。

​

特権リスク

• オーナー (roles/owner) または編集者 (roles/editor)
• 管理者ロール (roles/<service>.admin、または末尾が Admin のロール)
• roles/iam.serviceAccountTokenCreator または roles/iam.serviceAccountUser (保持者が他のサービス アカウントとして動作できるロール)

​

SecureAI を経由しない Vertex AI の使用

• データアクセス (Data Access) 監査ログが有効な場合 (モデルと ID ごとの使用状況を参照)、各行に呼び出されたモデルとその回数が表示され、推論の呼び出しのみがカウントされます。
• 有効でない場合、件数は認証情報 (サービス アカウントまたは API キー) ごとの Cloud Monitoring の値で、推論だけでなく AI API (Vertex AI、Gemini API、Agent Builder、Dialogflow) へのすべての呼び出しが含まれます。
• 推論接続のサービス アカウントとコネクタのサービス アカウントはカウントされません。個人は 1 人ずつ一覧表示されず、その呼び出しは 1 行に集計されます (People (Google accounts)、または People and tools (OAuth): コンソール、gcloud、アプリ)。
• その同期で SecureAI が推論接続を読み取れなかった場合は、何も分類せず、任意の不足項目として示し、前回の同期の結果を保持します。
• Insights の検出結果 Google Vertex AI / Gemini is being used outside SecureAI が生成されます。重大度は中程度で、呼び出し元が API キー (長期間有効な認証情報) の場合は重大になります。OWASP LLM02、ISO/IEC 42001 A.4.2 および A.6.2.6、NIST AI RMF MAP-1.1 および GOVERN-6.1 に対応付けられます。

​

コスト

• billingExportTable を指定した場合: このプロジェクトの AI サービス (Vertex AI、Gemini API、Agent Builder、Dialogflow など) に対する実際の支出を、クレジット適用後の金額で、請求先アカウントの通貨で表示します。クレジットで使用量がまかなわれている場合、正味金額がゼロになることがあります。その場合、パネルにはクレジット適用前の金額が併せて表示されます。Google はエクスポートを数時間の遅延で更新します。
• 指定しない場合: 見積もり — Cloud Monitoring のトークン数 × 定価で、Claude とプロンプト キャッシュのトークンも含みます。割引や確約利用契約は反映されません。

​

取り消しと復元

• 復元できるのは、手動または自動ポリシーによって SecureAI が Google Cloud で取り消したものだけです。SecureAI のゲートウェイでのみブロックしたものや、お客様のチームが Google Cloud で直接無効にした ID には提供されません。
• 削除されたサービス アカウント キーは復元できません: SecureAI は Google を呼び出さずに拒否します。
• 復元には、取り消しと同じロールを使用します。

• コネクタが使用するサービス アカウントとそのキーは、SecureAI から取り消すことはできません — 取り消すとディスカバリーが停止してしまうためです。取り消し用のサービス アカウントも同様です。これらは Google Cloud でローテーションしてください。
• Vertex AI での推論の接続が認証に使用するサービス アカウントと、署名に使用するキーも取り消せません: 取り消すと、管理対象のすべての呼び出しが停止するためです。キーレス (権限借用) オプションの場合、保護されるのはサービス アカウントのみです。SecureAI はそのキーのいずれでも署名しないため、キーは取り消せます。推論接続がどのアイデンティティを使用しているかを SecureAI が確認できない場合は、サービス アカウントもサービス アカウント キーも取り消しません (API キーは影響を受けません)。
• Google のデフォルトのサービス アカウント (Compute Engine のデフォルト、App Engine、Cloud Build、サービス エージェント) では 2 回目の確認が求められます。これらのいずれかを無効にすると、そのアカウントで実行されているすべての VM、アプリ、ビルドが停止します。
• コネクタにある操作のロールがない場合は、エラーにそのロールが表示されます。

​

NHI の自動ポリシー

• Simulation mode (dryRun) はデフォルトで有効です: 有効な間は、Revoke に設定したルールも何も遮断せず、何をするかを一覧表示するだけです。実際の遮断を有効にできるのは、これを無効にした場合だけです。Simulate with this configuration で、保存前に効果を確認できます。
• Revocation cap per run: デフォルトは 5 (1〜50)。1 回の実行で Revoke のルールに該当する ID が上限を超えた場合、何も遮断されず、アラートが送信されます。
• Exclusions: 所有者、名前、またはリソースがパターンに一致する ID には、どのルールも動作しません。ワイルドカードは * のみです。
• 評価されるのは、キーの一覧が完全に取得できた場合だけです。
• SecureAI が使用する認証情報 (コネクタのもの、取り消し用アカウントのもの、または Vertex AI での推論のもの) が遮断されることはありません。Google のデフォルトのサービス アカウントのキーが自動的に遮断されることもありません: ルールはアラートを出すだけで、判断は人が行います。

​

トラブルシューティング

​

接続時

​

パネルの不足項目

​

関連

• Google Vertex AI — お客様のアカウントでの推論
• クラウド AI プロバイダーの概要
• Google Workspace SSO
• NHI インベントリ