Ver topologias de um projeto

Para responder a perguntas sobre integridade, relacionamentos, dependências e conformidade com políticas do agente, execute consultas que correlacionam dados de agente, informações de trânsito e outros dados de recursos. Os resultados são mostrados como um gráfico de topologia que você pode explorar.

Um gráfico de topologia pode ajudar você a:

  • Mapear relações de recursos:visualize dados associados aos seus agentes, incluindo servidores MCP, infraestrutura subjacente, endpoints, habilidades e identidades.
  • Identificar lacunas de registro:identifique as cargas de trabalho de computação descobertas que não estão registradas no Agent Registry.
  • Validar a conformidade com a política:identifique vulnerabilidades e problemas de segurança identificados pelo Security Command Center.
  • Analise os impactos das mudanças:avalie os impactos das mudanças nas políticas de acesso, nas credenciais de endpoint ou na infraestrutura de que os recursos do agente dependem.

Você pode executar consultas sugeridas, personalizar uma sugestão ou criar sua própria consulta personalizada.

Antes de começar

  1. Identifique o projeto do Cloud de Confiance que você quer configurar.

    Os dados de segurança e compliance fornecidos pelo Security Command Center estão disponíveis apenas para projetos em uma organização do Cloud de Confiance by S3NS . Se você quiser migrar um projeto para uma organização, consulte as instruções de migração.

  2. Configure os serviços que fornecem os dados de recursos que você quer consultar:

  3. Ative as APIs App Hub, App Topology, Inventário de recursos do Cloud e Observability, se alguma delas ainda não estiver ativada.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão pelo papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar as APIs

  4. Verifique se o faturamento está ativado para o projeto do Cloud de Confiance .

  5. Se você estiver protegendo serviços em um perímetro do VPC Service Controls, atualize o perímetro para incluir o App Topology e os serviços que fornecem dados subjacentes. Saiba mais.

Funções exigidas

Para receber as permissões necessárias para ver gráficos de topologia, peça ao administrador para conceder a você o papel do IAM de Leitor da topologia do app (roles/apptopology.viewer) nos projetos em que você quer usar a topologia do app. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar gráficos de topologia. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para acessar os gráficos de topologia:

  • Receber dados de recursos descobertos: apptopology.discoveredResourcesTopologies.generate
  • Receber dados de dados de recursos: apptopology.sreDomainTopologies.generate

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Sobre as consultas

As consultas da App Topology consistem em vários componentes:

  • Nós: recursos Cloud de Confiance by S3NS descobertos ou registrados. Exemplos de nós:

    • Uma VM do Compute Engine
    • Uma imagem do contêiner no Artifact Registry
    • Um agente
    • Um alerta do Cloud Monitoring
    • Um aplicativo de IA
    • Uma vulnerabilidade

    O criador de consultas agrupa os nós por serviço.

  • Cláusula WHERE: um filtro aplicado a um nó para refinar a consulta com base nas propriedades específicas dele.

  • Conexões: uma relação direcional entre dois nós. As conexões são sensíveis ao contexto, e apenas relações válidas estão disponíveis para um tipo de nó selecionado. Por exemplo:

    • contained in
    • sends traffic to
    • owns
    • depends on

A consulta de exemplo a seguir pesquisa implantações que têm uma vulnerabilidade específica:

Exemplo de consulta usando vários componentes
Exemplo de consulta usando vários componentes

A consulta estabelece os principais nós da investigação: - Agent - Vulnerability

A conexão contains indica as relações entre os nós:

  • Agent contains Vulnerability

A cláusula "Where" filtra os resultados de vulnerabilidade para mostrar um CVE específico.

  • Where Id = CVE-2026-24061

Usar ou personalizar uma consulta sugerida

O App Topology oferece sugestões de consultas que podem ser usadas sem alterações. Também é possível personalizar essas sugestões para atender aos seus requisitos específicos.

  1. No console do Cloud de Confiance , acesse a página "Topologia".

    Acessar "Topologia"

  2. No seletor de projetos, selecione o projeto que contém seus agentes.

  3. Em Consultas rápidas, clique em uma consulta para ver uma prévia dos componentes dela.

  4. Para usar a consulta, clique em Usar sugestão. A consulta aparece na seção Mostrar.

  5. Para fazer mudanças na consulta, adicione, edite ou remova componentes.

    • Para adicionar um componente à consulta, clique no ícone de adição () ao lado do nó.
    • Para remover um componente, clique no ícone de fechar .
    • Para mudar o valor de uma cláusula Where, clique nele.

    Clique em Desfazer para reverter uma mudança ou em Refazer para reaplicar as mudanças revertidas com Desfazer.

    À medida que você cria sua consulta, os nós, filtros e conexões disponíveis são atualizados.

  6. Quando terminar de editar a consulta, clique em Executar consulta. Se os resultados da consulta incluírem Cloud de Confiance recursos descobertos ou recursos registrados no Agent Registry, um gráfico de topologia será exibido.

    Os gráficos não estão disponíveis para resultados de consultas que incluem apenas tipos de dados, como strings ou contagens.

    Com base nos resultados, edite a consulta e clique em Executar consulta para atualizar o gráfico de topologia.

  7. Analise o gráfico de topologia. O gráfico mostra os recursos que correspondem à sua consulta e as relações entre eles.

    • Os ícones representam nós, recursos descobertos e registrados e o tipo de recurso deles.
    • As linhas representam conexões, ou seja, as relações entre os nós.

    Exemplo de gráfico de topologia com um nó selecionado

    É possível interagir com uma topologia das seguintes maneiras:

    • Mude a visualização aumentando ou diminuindo o zoom ou reposicionando os nós.
    • Para ver o rótulo de uma conexão, passe o cursor sobre a linha entre dois nós.
    • Selecione um nó ou uma conexão para receber informações sobre eles.
    • Clique em Alternar painel para ocultar ou mostrar o painel de consulta.

Se não houver resultados, tente refinar sua consulta.

Criar consultas personalizadas

Para criar uma consulta personalizada, inicie uma nova ou personalize uma consulta sugerida seguindo estas etapas:

  1. No console do Cloud de Confiance , acesse a página "Topologia".

    Acessar "Topologia"

  2. No seletor de projetos, selecione o projeto que contém seus agentes.

  3. No criador de consultas, clique em , selecione um recurso ou uma descoberta como o nó principal da consulta e clique em Continuar.

  4. Para refinar sua consulta, clique no botão de alternância de qualquer filtro ou conexão para ativar o nó selecionado. Defina o valor de cada filtro ativado.

  5. Para fazer mudanças na consulta, adicione, edite ou remova componentes.

    • Para adicionar um componente à consulta, clique no ícone de adição () ao lado do nó.
    • Para remover um componente, clique no ícone de fechar .
    • Para mudar o valor de uma cláusula Where, clique nele.

    Clique em Desfazer para reverter uma mudança ou em Refazer para reaplicar as mudanças revertidas com Desfazer.

    À medida que você cria sua consulta, os nós, filtros e conexões disponíveis são atualizados.

  6. Quando terminar de editar a consulta, clique em Executar consulta. Se os resultados da consulta incluírem Cloud de Confiance recursos descobertos ou recursos registrados no Agent Registry, um gráfico de topologia será exibido.

    Os gráficos não estão disponíveis para resultados de consultas que incluem apenas tipos de dados, como strings ou contagens.

    Com base nos resultados, edite a consulta e clique em Executar consulta para atualizar o gráfico de topologia.

  7. Analise o gráfico de topologia. O gráfico mostra os recursos que correspondem à sua consulta e as relações entre eles.

    • Os ícones representam nós, recursos descobertos e registrados e o tipo de recurso deles.
    • As linhas representam conexões, ou seja, as relações entre os nós.

    Exemplo de gráfico de topologia com um nó selecionado

    É possível interagir com uma topologia das seguintes maneiras:

    • Mude a visualização aumentando ou diminuindo o zoom ou reposicionando os nós.
    • Para ver o rótulo de uma conexão, passe o cursor sobre a linha entre dois nós.
    • Selecione um nó ou uma conexão para receber informações sobre eles.
    • Clique em Alternar painel para ocultar ou mostrar o painel de consulta.

Algumas limitações se aplicam às consultas. Se não houver resultados, refine sua consulta.

A seguir