​

Google Cloud — Descubrimiento

​

Qué importa SecureAI

• Vertex AI: agentes (Agent Engine), endpoints de serving, jobs de batch y de tuning en curso, y modelos — el Model Registry más cada modelo de publisher en uso (Gemini, Claude, modelos abiertos).
• Agent Builder / Gemini Enterprise y Dialogflow CX (opcional): los engines de Agent Builder (Discovery Engine) con sus data stores, que se consultan en las ubicaciones global, us y eu; y los agentes de Dialogflow CX, que se consultan en global y en las ubicaciones de Vertex AI que configure.
• Uso por modelo, de los últimos 30 días: solicitudes (y cuántas fallaron), tokens de entrada y de salida, y tokens de caché de prompts.
• Uso por credencial, de los últimos 30 días (Cloud Monitoring): solicitudes totales y solicitudes a APIs de IA (Vertex AI, Gemini API, Agent Builder, Dialogflow) de cada cuenta de servicio y cada clave API. El tráfico de clientes OAuth (personas y herramientas como la consola o gcloud) se suma aparte. También da el último uso de esas cuentas y claves.
• Uso por modelo e identidad (opcional): qué cuenta de servicio o persona llamó a qué modelo de Vertex AI, tomado de los registros de auditoría de Data Access si usted los tiene activos. Vea Uso por modelo e identidad.
• Vertex AI usado por fuera de SecureAI: las identidades que llamaron a Vertex AI o Gemini directamente, sin pasar por la conexión de inferencia de SecureAI. Vea Vertex AI usado por fuera de SecureAI.
• Costo de los últimos 30 días: el gasto real en IA de este proyecto, tomado de su exportación de facturación a BigQuery, o una estimación a precio de lista.
• NHI: cuentas de servicio, claves de cuenta de servicio administradas por el usuario, claves API, pools y proveedores de Workload Identity Federation, y clientes OAuth — con su último uso (de Policy Analyzer y del uso por credencial) y su riesgo por privilegios. Revocables y restaurables desde el Inventario de NHI, a mano o con políticas automáticas.
• Vinculaciones de roles de IAM del proyecto.
• Registros de auditoría de la nube de los servicios de IA e identidad (Vertex AI, IAM, IAM Credentials, STS, API Keys, Resource Manager): los últimos 200 eventos de los últimos 30 días.

​

Requisitos previos

​

APIs habilitadas

​

Roles

​

Credenciales

​

Dónde conseguirlas

1. En la consola de Google Cloud, vaya a IAM y administración → Cuentas de servicio → Crear cuenta de servicio (por ejemplo, secureai-discovery).
2. Vaya a IAM y administración → IAM → Otorgar acceso, ingrese el email de la cuenta de servicio como principal y agregue los roles de Requisitos previos.
3. De vuelta en Cuentas de servicio, abra la cuenta → Claves → Agregar clave → Crear clave nueva → JSON, y descargue el archivo.
4. Pegue el JSON completo en JSON de la cuenta de servicio y después borre el archivo descargado.

PROJECT=mi-proyecto-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
# Opcionales: último uso, uso por modelo e identidad, Agent Builder y 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. Cree la cuenta de servicio y otórguele los roles (pasos 1 y 2 de arriba).
2. En el formulario de conexión de SecureAI, la ayuda del campo Cuenta de servicio a suplantar (sin clave — en vez del JSON) indica qué cuenta de SecureAI hay que autorizar. En Google Cloud, abra su cuenta de servicio → Permisos → Otorgar acceso, ingrese esa cuenta como principal y asígnele roles/iam.serviceAccountTokenCreator. Con gcloud:
   gcloud iam service-accounts add-iam-policy-binding $SA \
     --member=serviceAccount:CUENTA_DE_SECUREAI --role=roles/iam.serviceAccountTokenCreator
   
3. Ingrese el email de su cuenta de servicio en el campo y deje el JSON vacío.

​

Cuenta de servicio aparte para revocar

1. Cree una segunda cuenta de servicio (por ejemplo, secureai-revoke) y otórguele solo los roles de revocación de Requisitos previos.
2. Sobre esa cuenta, otórguele roles/iam.serviceAccountTokenCreator a la cuenta de SecureAI que indica la ayuda del campo Cuenta de servicio para revocar (opcional — aparte de la de lectura).
3. Ingrese su email en ese campo.

​

Modo organización o carpeta

• SecureAI encuentra los proyectos activos con Cloud Asset Inventory y lee cada uno como si fuera un conector de un solo proyecto. El ID del proyecto de Google Cloud sigue siendo el proyecto de cuota y facturación.
• Otorgue a la cuenta de servicio, en la organización o carpeta: roles/cloudasset.viewer, roles/iam.securityReviewer y roles/aiplatform.viewer, más roles/monitoring.viewer y roles/logging.viewer para uso y auditoría.
• Habilite cloudasset.googleapis.com en el proyecto de la cuenta de servicio.

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

​

Conectar

1. Administrador → Integraciones → Nube → Google Cloud — Descubrimiento → Conectar Integración.
2. Ingrese el ID del proyecto, la ubicación (o varias en Más ubicaciones de Vertex AI) y la clave JSON o la cuenta de servicio a suplantar. Agregue, si los usa, la cuenta de servicio para revocar, la organización o carpeta y los campos de facturación.
3. Haga clic en Conectar. Antes de guardar, SecureAI verifica las credenciales con una lectura real del proyecto; demora unos segundos. Si no puede leer el proyecto, muestra el motivo y no guarda nada; lo que ingresó queda en el formulario. Los mensajes posibles están en Solución de problemas.
4. Si guarda pero faltan roles, un aviso los enumera. Otórguelos y vuelva a sincronizar.
5. Sincronice ahora con el botón de actualizar de la tarjeta. Después, SecureAI sincroniza solo cada 6 horas.

​

Verificar

• Sensores de nube lista los agentes descubiertos. Haga clic en la tarjeta de Google Cloud para abrir el panel de GCP: uso y costos (solicitudes, fallas, tokens, caché, costo y su origen), modelos y despliegues, identidad y acceso (cuentas de servicio y claves con su último uso, vinculaciones de IAM) y auditoría.
• Si el panel dice El descubrimiento no pudo leer todo, revise cada línea (vea Solución de problemas) y vuelva a sincronizar.
• El Inventario de NHI muestra las cuentas de servicio y las claves.

​

Uso por modelo e identidad

• SecureAI los lee solo si los registros DATA_READ o DATA_WRITE están activos para aiplatform.googleapis.com (o para todos los servicios). SecureAI lo detecta en la política de IAM; nunca los activa.
• Activarlos tiene un costo de ingesta en Cloud Logging, según la tarifa de Google. Se activan en IAM y administración → Registros de auditoría → Vertex AI API → Lectura de datos.
• La cuenta de servicio necesita roles/logging.privateLogViewer.
• Por proyecto y sincronización, SecureAI lee hasta 5000 entradas o durante 20 segundos, lo que ocurra primero.
• Si no están activos, el panel muestra una brecha opcional que explica cómo activarlos. Si los activó en la organización o carpeta pero conecta un solo proyecto, SecureAI no puede verlo desde la política del proyecto y muestra la brecha igual.

​

Riesgo por privilegios

• Owner (roles/owner) o Editor (roles/editor);
• cualquier rol de administración (roles/<servicio>.admin o terminado en Admin);
• roles/iam.serviceAccountTokenCreator o roles/iam.serviceAccountUser, que permiten actuar como otras cuentas de servicio.

​

Vertex AI usado por fuera de SecureAI

• Con los logs de auditoría de Data Access activos (vea Uso por modelo e identidad), cada fila dice qué modelos llamó y cuántas veces, y solo cuenta llamadas de inferencia.
• Sin ellos, el número sale de Cloud Monitoring por credencial (cuenta de servicio o clave API) e incluye toda llamada a una API de IA (Vertex AI, Gemini API, Agent Builder, Dialogflow), no solo inferencia.
• Nunca cuenta la cuenta de servicio de la conexión de inferencia ni la del conector. A las personas no las lista una por una: sus llamadas van en una sola fila agregada (Personas (cuentas de Google), o Personas y herramientas (OAuth): consola, gcloud, apps).
• Si SecureAI no pudo leer la conexión de inferencia en esa sincronización, no clasifica nada, lo indica como brecha opcional y conserva lo de la sincronización anterior.
• Genera el hallazgo de Insights Google Vertex AI / Gemini is being used outside SecureAI: moderado, y crítico si quien llama es una clave API (una credencial de larga vida). Se mapea a OWASP LLM02, ISO/IEC 42001 A.4.2 y A.6.2.6, y NIST AI RMF MAP-1.1 y GOVERN-6.1.

​

Costo

• Con la tabla de exportación de facturación: el gasto real de este proyecto en servicios de IA (Vertex AI, Gemini API, Agent Builder, Dialogflow, …), neto de créditos, en la moneda de su cuenta de facturación. Si los créditos cubren el uso, el neto puede ser cero; el panel muestra al lado el importe antes de créditos. Google actualiza la exportación con varias horas de demora.
• Sin ella: una estimación — tokens de Cloud Monitoring × precio de lista, incluidos Claude y los tokens de caché. No refleja descuentos ni contratos de uso comprometido.

​

Revocación y restauración

• Solo se puede restaurar lo que SecureAI revocó en Google Cloud, a mano o con una política automática. No se ofrece para un bloqueo solo en el gateway de SecureAI, ni para una identidad que su equipo deshabilitó directamente en Google Cloud.
• Una clave de cuenta de servicio borrada no se puede restaurar: SecureAI lo rechaza sin llamar a Google.
• Restaurar usa los mismos roles que revocar.

• La cuenta de servicio que usa el conector, y sus claves, no se pueden revocar desde SecureAI: cortaría el descubrimiento. Lo mismo vale para la cuenta de servicio para revocar. Rótelas en Google Cloud.
• Tampoco se puede revocar la cuenta de servicio con la que se autentica la conexión de inferencia de Vertex AI, ni la clave con la que firma: cortaría todas las llamadas gobernadas. Con la opción sin clave (impersonación) solo se protege la cuenta de servicio: sus claves se pueden revocar, porque SecureAI no firma con ninguna. Si SecureAI no puede comprobar qué identidad usa la conexión de inferencia, no revoca ninguna cuenta de servicio ni clave de cuenta de servicio (las claves API no se ven afectadas).
• Las cuentas de servicio predeterminadas de Google (la predeterminada de Compute Engine, App Engine, Cloud Build, agentes de servicio) piden una segunda confirmación: deshabilitar una detiene cada VM, aplicación o build que se ejecuta con ella.
• Si al conector le falta el rol de una acción, el error indica cuál.

​

Políticas automáticas de NHI

• Modo simulación (dryRun) activado por defecto: con él, ninguna regla en Revocar corta nada; solo queda listado qué haría. Apagarlo es lo único que habilita cortes reales. Simular con esta configuración muestra el efecto antes de guardar.
• Tope de revocaciones por corrida: 5 por defecto (de 1 a 50). Si en una corrida las reglas en Revocar afectan a más identidades que el tope, no se corta ninguna y se envía una alerta.
• Exclusiones: ninguna regla actúa sobre una identidad cuyo dueño, nombre o recurso coincida con un patrón; * es el único comodín.
• Solo se evalúan listados de claves completos.
• Nunca se corta una credencial que usa SecureAI (la del conector, la de revocación o la de la inferencia de Vertex AI). Las claves de las cuentas de servicio predeterminadas de Google nunca se cortan automáticamente: la regla solo alerta, y decide una persona.

​

Solución de problemas

​

Al conectar

​

Brechas del panel

​

Relacionado

• Google Vertex AI — Inferencia en tu cuenta
• Descripción general de los proveedores de IA en la nube
• SSO de Google Workspace
• Inventario de NHI