​

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 等工具）会单独汇总。它还提供这些帐户和密钥的上次使用时间。
• 按模型和身份统计的使用情况（可选）：哪个服务帐户或人员调用了哪个 Vertex AI 模型，数据来自数据访问审计日志（如果您已开启）。请参阅按模型和身份统计的使用情况。
• 在 SecureAI 之外使用的 Vertex AI：未经过 SecureAI 推理连接、直接调用 Vertex AI 或 Gemini 的身份。请参阅在 SecureAI 之外使用的 Vertex AI。
• 过去 30 天的成本：来自 BigQuery 账单导出的本项目实际 AI 支出，或按标价计算的估算值。
• NHI：服务帐户、用户管理的服务帐户密钥、API 密钥、Workload Identity Federation 池和提供方，以及 OAuth 客户端 — 包括它们的上次使用时间（来自 Policy Analyzer 和按凭证统计的使用情况）以及它们的特权风险。可从 NHI 清单 撤销和恢复，可以手动操作，也可以通过自动策略。
• 项目的 IAM 角色绑定。
• AI 和身份服务（Vertex AI、IAM、IAM Credentials、STS、API Keys、Resource Manager）的 Cloud 审计日志：过去 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
# 可选：上次使用时间、按模型和身份统计的使用情况、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. 创建第二个服务帐户（例如 secureai-revoke），并只为其授予先决条件中的撤销角色。
2. 在该帐户上，将 roles/iam.serviceAccountTokenCreator 授予 Service account for revocation (optional — separate from reading) 字段帮助文本中注明的 SecureAI 帐户。
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 面板：使用情况和成本（请求、失败、令牌、缓存、成本及其来源）、模型和部署、身份和访问（服务帐户和密钥及其上次使用时间、IAM 绑定）以及审计。
• 如果面板显示 Discovery could not read everything，请逐行查看（请参阅故障排除）并再次同步。
• NHI 清单 会显示服务帐户和密钥。

​

按模型和身份统计的使用情况

• 只有当 aiplatform.googleapis.com（或所有服务）开启了 DATA_READ 或 DATA_WRITE 日志时，SecureAI 才会读取它们。SecureAI 会在 IAM 政策中检测这一点；它从不替您开启。
• 开启它们会产生 Cloud Logging 注入费用，按 Google 的费率计费。您可以在 IAM 和管理 → 审核日志 → Vertex AI API → 数据读取 中开启。
• 服务帐户需要 roles/logging.privateLogViewer。
• 每个项目每次同步，SecureAI 最多读取 5,000 个条目或读取 20 秒，以先达到者为准。
• 如果它们处于关闭状态，面板会显示一个可选缺口，说明如何开启。如果您在组织或文件夹上开启了它们，但连接的是单个项目，SecureAI 无法从项目的政策中看到这一点，仍会显示该缺口。

​

特权风险

• Owner（roles/owner）或 Editor（roles/editor）；
• 任何管理员角色（roles/<service>.admin 或以 Admin 结尾）；
• roles/iam.serviceAccountTokenCreator 或 roles/iam.serviceAccountUser，它们允许持有者以其他服务帐户的身份行事。

​

在 SecureAI 之外使用的 Vertex AI

• 启用数据访问 (Data Access) 审计日志时（请参阅按模型和身份统计的使用情况），每一行会列出调用了哪些模型以及调用次数，并且只统计推理调用。
• 未启用时，数字来自 Cloud Monitoring 按凭证（服务帐户或 API 密钥）的统计，包括对 AI API（Vertex AI、Gemini API、Agent Builder、Dialogflow）的所有调用，而不仅是推理。
• 推理连接的服务帐户和连接器的服务帐户永远不计入。人员不会逐一列出：他们的调用汇总为一行（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。

​

成本

• 使用账单导出表时：本项目在 AI 服务（Vertex AI、Gemini API、Agent Builder、Dialogflow 等）上的实际支出，扣除赠送金后以结算帐户的币种显示。当赠送金覆盖了使用量时，净额可能为零；此时面板会在旁边显示扣除赠送金前的金额。Google 会以数小时的延迟更新导出数据。
• 不使用时：估算值 — Cloud Monitoring 中的令牌数 × 标价，包括 Claude 和提示缓存令牌。不反映折扣或承诺使用合同。

​

撤销和恢复

• 只有 SecureAI 在 Google Cloud 中撤销的内容才能恢复，无论是手动撤销还是通过自动策略撤销。对于仅在 SecureAI 网关上的阻止，或您的团队直接在 Google Cloud 中停用的身份，不提供此操作。
• 已删除的服务帐户密钥无法恢复：SecureAI 会直接拒绝，不调用 Google。
• 恢复使用与撤销相同的角色。

• 连接器使用的服务帐户及其密钥无法从 SecureAI 撤销 — 那样会中断发现。用于撤销的服务帐户也是如此。请在 Google Cloud 中轮换它们。
• Vertex AI 推理连接用于身份验证的服务帐户及其用于签名的密钥也无法撤销：那样会停止每一次受治理的调用。使用无密钥（模拟）选项时，只有服务帐户受到保护：其密钥仍可撤销，因为 SecureAI 不使用其中任何一个签名。如果 SecureAI 无法确认推理连接使用的是哪个身份，它不会撤销任何服务帐户或服务帐户密钥（API 密钥不受影响）。
• Google 的默认服务帐户（Compute Engine 默认服务帐户、App Engine、Cloud Build、服务代理）需要二次确认：停用其中一个会停止以其身份运行的所有虚拟机、应用或构建。
• 如果连接器缺少某项操作的角色，错误会指出该角色。

​

自动 NHI 策略

• Simulation mode (dryRun) 默认开启：开启时，设为 Revoke 的规则不会切断任何内容；它只列出将要执行的操作。关闭它是启用真实切断的唯一方式。Simulate with this configuration 会在您保存之前显示效果。
• Revocation cap per run：默认为 5（1 到 50）。如果在一次运行中 Revoke 规则匹配的身份数超过上限，则不会切断任何内容，并发送警报。
• Exclusions：如果身份的所有者、名称或资源与某个模式匹配，任何规则都不会对其生效；* 是唯一的通配符。
• 只评估完整的密钥列表。
• SecureAI 使用的凭证（连接器的、撤销帐户的或 Vertex AI 推理的）永远不会被切断。Google 默认服务帐户的密钥永远不会被自动切断：规则只发出警报，由人来决定。

​

故障排除

​

连接时

​

面板中的缺口

​

相关

• Google Vertex AI — 在您的帐户上推理
• 云人工智能提供商概述
• Google Workspace SSO
• NHI 清单