Per rispondere a domande su stato, relazioni, dipendenze e conformità alle norme degli agenti, puoi eseguire query che mettono in correlazione dati degli agenti, dati sul traffico e altri dati delle risorse. I risultati vengono visualizzati come un grafico della topologia che puoi esplorare.
Un grafico della topologia può aiutarti a:
- Mappare le relazioni tra le risorse:visualizza i dati associati ai tuoi agenti, inclusi server MCP, infrastruttura sottostante, endpoint, skill e identità.
- Identifica le lacune nella registrazione:identifica i workload di calcolo rilevati che non sono registrati in Agent Registry.
- Convalida della conformità alle norme:identifica le vulnerabilità e i problemi di sicurezza identificati da Security Command Center.
- Analizza gli impatti delle modifiche: valuta gli impatti delle modifiche alle norme di accesso, alle credenziali degli endpoint o all'infrastruttura da cui dipendono le risorse dell'agente.
Puoi eseguire query suggerite, personalizzarne una o creare una query personalizzata.
Prima di iniziare
Identifica il Cloud de Confiance progetto che vuoi configurare.
I dati di sicurezza e conformità forniti da Security Command Center sono disponibili solo per i progetti di un' Cloud de Confiance by S3NS organizzazione. Se vuoi eseguire la migrazione di un progetto a un'organizzazione, consulta le istruzioni per la migrazione.
Configura i servizi che forniscono i dati delle risorse su cui vuoi eseguire query:
Per visualizzare i dati della catena di fornitura del software, ad esempio la provenienza della build, configura gli approfondimenti di Developer Connect.
Per visualizzare i dati delle risorse dell'agente registrate in Agent Registry, configura Agent Registry e registra le risorse dell'agente.
Per visualizzare il traffico degli agenti, strumenta le tue applicazioni di AI.
Per visualizzare i dati di sicurezza e conformità, configura Security Command Center per i dati di sicurezza e conformità. Attiva Security Command Center a livello di organizzazione e configura le funzionalità che vuoi utilizzare. L'esecuzione di query sui dati di Security Command Center è disponibile solo per i livelli Premium ed Enterprise.
Abilita le API App Hub, App Topology, Cloud Asset Inventory e Observability, se non sono già abilitate.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre dell'autorizzazione
serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.-
Verifica che la fatturazione sia attivata per il tuo progetto Cloud de Confiance .
Se proteggi i servizi in un perimetro dei Controlli di servizio VPC, aggiorna il perimetro in modo che includa App Topology e i servizi che forniscono i dati sottostanti. Scopri di più.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per visualizzare i grafici della topologia, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore topologia app (roles/apptopology.viewer) sui progetti in cui vuoi utilizzare App Topology.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare i grafici della topologia. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per visualizzare i grafici della topologia sono necessarie le seguenti autorizzazioni:
-
Recupera i dati delle risorse rilevate:
apptopology.discoveredResourcesTopologies.generate -
Recupera i dati delle risorse:
apptopology.sreDomainTopologies.generate
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Informazioni sulle query
Le query di App Topology sono costituite da diversi componenti:
Nodi: risorse rilevate o registrate Cloud de Confiance by S3NS . Esempi di nodi:
- Una VM di Compute Engine
- Un'immagine container in Artifact Registry
- Un agente
- Un avviso di Cloud Monitoring
- Un'applicazione AI
- Una vulnerabilità
Il generatore di query raggruppa i nodi per servizio.
Clausola WHERE: un filtro applicato a un nodo per perfezionare la query in base alle proprietà specifiche del nodo.
Connessioni: una relazione direzionale tra due nodi. Le connessioni sono sensibili al contesto e solo le relazioni valide sono disponibili per un tipo di nodo selezionato. Ecco alcuni esempi:
contained insends traffic toownsdepends on
La seguente query di esempio cerca i deployment che presentano una vulnerabilità specifica:
La query stabilisce i nodi chiave dell'indagine:
- Agent
- Vulnerability
La connessione contains indica le relazioni tra i nodi:
Agent contains Vulnerability
La clausola WHERE filtra i risultati delle vulnerabilità per mostrare una CVE specifica.
Where Id = CVE-2026-24061
Utilizzare o personalizzare una query suggerita
App Topology fornisce suggerimenti per le query che puoi utilizzare senza modifiche oppure puoi personalizzarli in base ai tuoi requisiti specifici.
Nella console Cloud de Confiance , vai alla pagina Topologia.
Nel selettore di progetti, seleziona il progetto che contiene i tuoi agenti.
In Query rapide, fai clic su una query per visualizzare un'anteprima dei componenti della query.
Per utilizzare la query, fai clic su Utilizza suggerimento. La query viene visualizzata nella sezione Mostra.
Per apportare modifiche alla query, aggiungi, modifica o rimuovi i componenti.
- Per aggiungere un componente alla query, fai clic sull'icona Più () accanto al nodo.
- Per rimuovere un componente, fai clic sull'icona di chiusura .
- Per modificare il valore di una clausola
Where, fai clic sul valore.
Puoi fare clic su Annulla per annullare una modifica o su Ripeti per riapplicare le modifiche annullate con Annulla.
Man mano che crei la query, i nodi, i filtri e le connessioni disponibili vengono aggiornati.
Al termine della modifica della query, fai clic su Esegui query. Se i risultati della query includono Cloud de Confiance risorse rilevate o risorse registrate in Agent Registry, viene visualizzato un grafico della topologia.
I grafici non sono disponibili per i risultati delle query che includono solo tipi di dati come stringhe o conteggi.
In base ai risultati, puoi modificare la query e poi fare clic su Esegui query per aggiornare il grafico della topologia.
Esplora il grafico della topologia. Il grafico mostra le risorse che corrispondono alla tua query e le relazioni tra di loro.
- Le icone rappresentano i nodi, le risorse rilevate e registrate e il relativo tipo di risorsa.
- Le linee rappresentano le connessioni, le relazioni tra i nodi.
Puoi interagire con una topologia nei seguenti modi:
- Modifica la visualizzazione aumentando o diminuendo lo zoom o riposizionando i nodi.
- Visualizza l'etichetta di una connessione passando il mouse sopra la linea di connessione tra due nodi.
- Seleziona un nodo o una connessione per visualizzare le relative informazioni.
- Nascondi o mostra il riquadro della query facendo clic su Attiva/disattiva riquadro .
Se non vengono visualizzati risultati, prova a perfezionare la query.
Creare query personalizzate
Per creare una query personalizzata, inizia una nuova query o personalizza una query suggerita esistente seguendo questi passaggi:
Nella console Cloud de Confiance , vai alla pagina Topologia.
Nel selettore di progetti, seleziona il progetto che contiene i tuoi agenti.
Nel generatore di query, fai clic su e seleziona una risorsa o un risultato come nodo principale della query, quindi fai clic su Continua.
Per perfezionare la query, fai clic sul pulsante di attivazione/disattivazione di un filtro o di una connessione per abilitarlo per il nodo selezionato. Definisci il valore per ogni filtro che attivi.
Per apportare modifiche alla query, aggiungi, modifica o rimuovi i componenti.
- Per aggiungere un componente alla query, fai clic sull'icona Più () accanto al nodo.
- Per rimuovere un componente, fai clic sull'icona di chiusura .
- Per modificare il valore di una clausola
Where, fai clic sul valore.
Puoi fare clic su Annulla per annullare una modifica o su Ripeti per riapplicare le modifiche annullate con Annulla.
Man mano che crei la query, i nodi, i filtri e le connessioni disponibili vengono aggiornati.
Al termine della modifica della query, fai clic su Esegui query. Se i risultati della query includono Cloud de Confiance risorse rilevate o risorse registrate in Agent Registry, viene visualizzato un grafico della topologia.
I grafici non sono disponibili per i risultati delle query che includono solo tipi di dati come stringhe o conteggi.
In base ai risultati, puoi modificare la query e poi fare clic su Esegui query per aggiornare il grafico della topologia.
Esplora il grafico della topologia. Il grafico mostra le risorse che corrispondono alla tua query e le relazioni tra di loro.
- Le icone rappresentano i nodi, le risorse rilevate e registrate e il relativo tipo di risorsa.
- Le linee rappresentano le connessioni, le relazioni tra i nodi.
Puoi interagire con una topologia nei seguenti modi:
- Modifica la visualizzazione aumentando o diminuendo lo zoom o riposizionando i nodi.
- Visualizza l'etichetta di una connessione passando il mouse sopra la linea di connessione tra due nodi.
- Seleziona un nodo o una connessione per visualizzare le relative informazioni.
- Nascondi o mostra il riquadro della query facendo clic su Attiva/disattiva riquadro .
Alle query si applicano alcune limitazioni. Se non vengono visualizzati risultati, prova a perfezionare la query.
Passaggi successivi
- Registra gli agenti rilevati in Agent Registry.