​

Google Cloud — Discovery

​

O que a SecureAI importa

• Vertex AI: agentes (Agent Engine), endpoints de serving, jobs de batch e de tuning em execução, e modelos — o Model Registry mais cada modelo de publisher em uso (Gemini, Claude, modelos abertos).
• Agent Builder / Gemini Enterprise e Dialogflow CX (opcional): os engines do Agent Builder (Discovery Engine) com seus data stores, consultados nos locais global, us e eu; e os agentes do Dialogflow CX, consultados em global e nos locais da Vertex AI que você configurar.
• Uso por modelo dos últimos 30 dias: solicitações (e quantas falharam), tokens de entrada e de saída, e tokens de cache de prompts.
• Uso por credencial dos últimos 30 dias (Cloud Monitoring): total de solicitações e solicitações às APIs de IA (Vertex AI, Gemini API, Agent Builder, Dialogflow) de cada conta de serviço e de cada chave de API. O tráfego de clientes OAuth (pessoas e ferramentas como o console ou o gcloud) é somado à parte. Também fornece o último uso dessas contas e chaves.
• Uso por modelo e identidade (opcional): qual conta de serviço ou pessoa chamou qual modelo da Vertex AI, obtido dos registros de auditoria de acesso a dados (Data Access) se você os tiver ativados. Consulte Uso por modelo e identidade.
• Vertex AI usada fora da SecureAI: as identidades que chamaram a Vertex AI ou o Gemini diretamente, sem passar pela conexão de inferência da SecureAI. Consulte Vertex AI usada fora da SecureAI.
• Custo dos últimos 30 dias: o gasto real deste projeto com IA, obtido da sua exportação de faturamento para o BigQuery, ou uma estimativa pelo preço de tabela.
• NHIs: contas de serviço, chaves de conta de serviço gerenciadas pelo usuário, chaves de API, pools e provedores de Workload Identity Federation, e clientes OAuth — com seu último uso (do Policy Analyzer e do uso por credencial) e seu risco de privilégio. Revogáveis e restauráveis no Inventário de NHIs, manualmente ou com políticas automáticas.
• Vinculações de papéis do IAM no projeto.
• Registros de auditoria do Cloud dos serviços de IA e de identidade (Vertex AI, IAM, IAM Credentials, STS, API Keys, Resource Manager): os 200 eventos mais recentes dos últimos 30 dias.

​

Pré-requisitos

​

APIs ativadas

​

Papéis

​

Credenciais

​

Onde obtê-los

1. No console do Google Cloud, acesse IAM e administrador → Contas de serviço → Criar conta de serviço (por exemplo, secureai-discovery).
2. Acesse IAM e administrador → IAM → Conceder acesso, insira o e-mail da conta de serviço como principal e adicione os papéis de Pré-requisitos.
3. De volta em Contas de serviço, abra a conta → Chaves → Adicionar chave → Criar nova chave → JSON e baixe o arquivo.
4. Cole o JSON inteiro em Service Account JSON e depois exclua o arquivo baixado.

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
# Opcional: último uso, uso por modelo e identidade, Agent Builder e 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. Crie a conta de serviço e conceda os papéis a ela (passos 1 e 2 acima).
2. No formulário de conexão da SecureAI, o texto de ajuda do campo Service account to impersonate (keyless — instead of the JSON) indica qual conta da SecureAI deve ser autorizada. No Google Cloud, abra sua conta de serviço → Permissões → Conceder acesso, insira essa conta como principal e atribua a ela roles/iam.serviceAccountTokenCreator. Com gcloud:
   gcloud iam service-accounts add-iam-policy-binding $SA \
     --member=serviceAccount:SECUREAI_ACCOUNT --role=roles/iam.serviceAccountTokenCreator
   
3. Insira o e-mail da sua conta de serviço no campo e deixe o JSON vazio.

​

Conta de serviço separada para revogação

1. Crie uma segunda conta de serviço (por exemplo, secureai-revoke) e conceda a ela apenas os papéis de revogação de Pré-requisitos.
2. Nessa conta, conceda roles/iam.serviceAccountTokenCreator à conta da SecureAI indicada no texto de ajuda do campo Service account for revocation (optional — separate from reading).
3. Insira o e-mail dela nesse campo.

​

Modo organização ou pasta

• A SecureAI encontra os projetos ativos com o Cloud Asset Inventory e lê cada um como se fosse um conector de projeto único. O Google Cloud Project ID continua sendo o projeto de cota e de faturamento.
• Conceda à conta de serviço, na organização ou pasta: roles/cloudasset.viewer, roles/iam.securityReviewer e roles/aiplatform.viewer, mais roles/monitoring.viewer e roles/logging.viewer para uso e auditoria.
• Ative cloudasset.googleapis.com no projeto da conta de serviço.

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. Admin → Integrations → Cloud → Google Cloud — Descoberta → Conectar Integração.
2. Insira o ID do projeto, o local (ou vários em More Vertex AI Locations) e a chave JSON ou a conta de serviço a personificar. Se você os usa, adicione a conta de serviço para revogação, a organização ou pasta e os campos de faturamento.
3. Clique em Conectar. Antes de salvar, a SecureAI verifica as credenciais com uma leitura real do projeto — leva alguns segundos. Se não conseguir ler o projeto, ela mostra o motivo e não salva nada; o que você inseriu permanece no formulário. As mensagens possíveis estão em Solução de problemas.
4. Se salvar, mas faltarem papéis, um aviso os lista. Conceda-os e sincronize novamente.
5. Sincronize agora com o botão de atualizar do cartão. Depois disso, a SecureAI sincroniza automaticamente a cada 6 horas.

​

Verifique

• Sensores Cloud lista os agentes descobertos. Clique no cartão do Google Cloud para abrir o painel do GCP: uso e custo (solicitações, falhas, tokens, cache, custo e sua origem), modelos e implantações, identidade e acesso (contas de serviço e chaves com seu último uso, vinculações do IAM) e auditoria.
• Se o painel disser Discovery could not read everything, revise cada linha (consulte Solução de problemas) e sincronize novamente.
• O Inventário de NHIs mostra as contas de serviço e as chaves.

​

Uso por modelo e identidade

• A SecureAI só os lê se os registros DATA_READ ou DATA_WRITE estiverem ativados para aiplatform.googleapis.com (ou para todos os serviços). A SecureAI detecta isso na política do IAM; ela nunca os ativa.
• Ativá-los tem um custo de ingestão do Cloud Logging, pelas tarifas do Google. Você os ativa em IAM e administrador → Registros de auditoria → Vertex AI API → Leitura de dados.
• A conta de serviço precisa de roles/logging.privateLogViewer.
• Por projeto e por sincronização, a SecureAI lê até 5.000 entradas ou durante 20 segundos, o que ocorrer primeiro.
• Se estiverem desativados, o painel mostra uma lacuna opcional explicando como ativá-los. Se você os ativou na organização ou pasta, mas conecta um único projeto, a SecureAI não consegue ver isso pela política do projeto e mostra a lacuna mesmo assim.

​

Risco de privilégio

• Proprietário (roles/owner) ou Editor (roles/editor);
• qualquer papel de administrador (roles/<serviço>.admin ou terminado em Admin);
• roles/iam.serviceAccountTokenCreator ou roles/iam.serviceAccountUser, que permitem a quem os tem atuar como outras contas de serviço.

​

Vertex AI usada fora da SecureAI

• Com os registros de auditoria de acesso a dados (Data Access) ativados (consulte Uso por modelo e identidade), cada linha diz quais modelos foram chamados e quantas vezes, e só são contadas chamadas de inferência.
• Sem eles, o número vem do Cloud Monitoring por credencial (conta de serviço ou chave de API) e inclui toda chamada a uma API de IA (Vertex AI, Gemini API, Agent Builder, Dialogflow), não só inferência.
• A conta de serviço da conexão de inferência e a do conector nunca são contadas. As pessoas não são listadas uma a uma: as chamadas delas ficam em uma única linha agregada (People (Google accounts), ou People and tools (OAuth): console, gcloud, apps).
• Se a SecureAI não conseguiu ler a conexão de inferência nessa sincronização, ela não classifica nada, indica isso como lacuna opcional e mantém o resultado da sincronização anterior.
• Gera a constatação do Insights Google Vertex AI / Gemini is being used outside SecureAI: moderada, e crítica se quem chama é uma chave de API (uma credencial de longa duração). É mapeada para OWASP LLM02, ISO/IEC 42001 A.4.2 e A.6.2.6, e NIST AI RMF MAP-1.1 e GOVERN-6.1.

​

Custo

• Com a tabela de exportação de faturamento: o gasto real deste projeto com serviços de IA (Vertex AI, Gemini API, Agent Builder, Dialogflow, …), descontados os créditos, na moeda da sua conta de faturamento. Quando os créditos cobrem o uso, o valor líquido pode ser zero; nesse caso o painel mostra ao lado o valor antes dos créditos. O Google atualiza a exportação com um atraso de várias horas.
• Sem ela: uma estimativa — tokens do Cloud Monitoring × preço de tabela, incluindo Claude e os tokens de cache de prompts. Não reflete descontos nem contratos de uso comprometido.

​

Revogação e restauração

• Só pode ser restaurado o que a SecureAI revogou no Google Cloud, manualmente ou por uma política automática. Não é oferecido para um bloqueio apenas no gateway da SecureAI, nem para uma identidade que sua equipe desativou diretamente no Google Cloud.
• Uma chave de conta de serviço excluída não pode ser restaurada: a SecureAI recusa sem chamar o Google.
• Restaurar usa os mesmos papéis que revogar.

• A conta de serviço que o conector usa, e as chaves dela, não podem ser revogadas a partir da SecureAI — isso interromperia a descoberta. O mesmo vale para a conta de serviço para revogação. Faça a rotação delas no Google Cloud.
• Também não podem ser revogadas a conta de serviço com que a conexão de inferência da Vertex AI se autentica, nem a chave com que ela assina: isso interromperia todas as chamadas governadas. Com a opção sem chave (personificação), só a conta de serviço fica protegida: as chaves dela podem ser revogadas, porque a SecureAI não assina com nenhuma delas. Se a SecureAI não conseguir verificar qual identidade a conexão de inferência usa, ela não revoga nenhuma conta de serviço nem chave de conta de serviço (as chaves de API não são afetadas).
• As contas de serviço padrão do Google (a padrão do Compute Engine, App Engine, Cloud Build, agentes de serviço) pedem uma segunda confirmação: desativar uma delas interrompe cada VM, aplicativo ou build que é executado com ela.
• Se faltar ao conector o papel de uma ação, o erro indica qual é.

​

Políticas automáticas de NHI

• O Simulation mode (dryRun) vem ativado por padrão: com ele, nenhuma regra em Revoke corta nada; apenas lista o que faria. Desativá-lo é a única coisa que habilita cortes reais. Simulate with this configuration mostra o efeito antes de você salvar.
• Revocation cap per run: 5 por padrão (de 1 a 50). Se, em uma execução, as regras em Revoke corresponderem a mais identidades do que o limite, nada é cortado e um alerta é enviado.
• Exclusions: nenhuma regra age sobre uma identidade cujo proprietário, nome ou recurso corresponda a um padrão; * é o único curinga.
• Só são avaliadas listagens de chaves completas.
• Uma credencial que a SecureAI usa (a do conector, a da conta de revogação ou a da inferência da Vertex AI) nunca é cortada. As chaves das contas de serviço padrão do Google nunca são cortadas automaticamente: a regra apenas alerta, e uma pessoa decide.

​

Solução de problemas

​

Ao conectar

​

Lacunas do painel

​

Relacionado

• Google Vertex AI — Inferência na sua conta
• Visão geral dos provedores de IA em nuvem
• Google Workspace SSO
• Inventário de NHIs