Integrazione di rete Azure SRE Agent

L'integrazione della rete virtuale (VNet) controlla dove l'Agente SRE può inviare traffico in uscita. Senza di esso, le chiamate in uscita fluiscono su internet pubblico. Con esso, il traffico passa attraverso la tua Rete virtuale di Azure. Questa integrazione di rete ti offre gli stessi controlli a livello di rete che usi per altri carichi di lavoro Azure: integrazione con firewall, comunicazione con risorse dietro endpoint privati e visibilità nei log di rete.

Modalità di controllo di rete

L'agente SRE offre tre modalità di controllo di rete. Selezionare la modalità corrispondente al comportamento di sicurezza e al contesto operativo.

Modalità Description Ideale per
Senza restrizioni Nessuna restrizione di rete. L'agente può raggiungere qualsiasi endpoint Internet. Carichi di lavoro di sviluppo, test e non sensibili.
Limitato L'elenco degli URL consentiti basato su caratteri jolly determina quali endpoint l'agente può contattare. Controllo a livello di host senza routing completo della rete virtuale.
Azure VNet Tutto il traffico in uscita non relativo alla piattaforma viene instradato tramite la tua VNet, con l'applicazione delle regole DNS e del firewall. Distribuzioni in produzione che richiedono il controllo del traffico in uscita e la conformità ai requisiti di audit.

Scegliere una modalità di controllo di rete per il carico di lavoro

Usare i criteri seguenti per selezionare una modalità:

  • Azure VNet: Scegli questa modalità se il carico di lavoro tratta dati sensibili o regolamentati, richiede una traccia di controllo completa dell'attività di rete in uscita o deve essere conforme ai criteri di sicurezza aziendali. Questa modalità è consigliata per le distribuzioni aziendali di produzione.

  • Limitato: scegliere questa modalità se si desidera limitare destinazioni esterne specifiche senza instradare tutto il traffico attraverso una rete virtuale. Questa modalità funziona correttamente quando è necessario un controllo parziale senza sovraccarico della configurazione completa della rete virtuale.

  • Senza restrizioni: scegliere questa modalità se il carico di lavoro è un ambiente di sviluppo o test a breve termine senza accesso ai dati sensibili. Questa modalità è l'impostazione predefinita.

Per selezionare una modalità, aprire l'agente nel portale di Azure e selezionare Impostazioni>Configurazione area di lavoro. Passare da una modalità all'altra su un agente in esecuzione. Le impostazioni vengono mantenute tra le modifiche alla modalità.

Schermata della configurazione dell'area di lavoro dell'agente SRE di Azure che mostra le opzioni della modalità di controllo della rete: senza restrizioni, limitata e Azure VNet.

Funzionamento della modalità di rete virtuale Azure

In Azure modalità rete virtuale, il traffico in uscita accetta uno dei due percorsi seguenti:

La tua VNet. Per impostazione predefinita, tutto il traffico in uscita non piattaforma passa attraverso una subnet delegata nella rete virtuale. Si applicano tutte le regole del gruppo di sicurezza di rete, i criteri firewall, il DNS personalizzato e i log di rete. L'agente è soggetto agli stessi controlli di qualsiasi altro carico di lavoro in tale subnet. Può raggiungere ciò che la subnet può raggiungere e niente di più.

L'agente può raggiungere le risorse dietro endpoint privati, servizi interni e sistemi locali connessi tramite ExpressRoute o VPN, purché le route di rete e le regole lo consentano.

Rete infrastrutturale dell'agente SRE di Azure I servizi della piattaforma da cui dipende l'agente (orchestrazione, endpoint del modello, telemetria) vengono sempre instradati attraverso l'infrastruttura gestita di Microsoft. Questi servizi non sono configurabili. Alcune funzionalità dell'agente, ad esempio l'installazione dei pacchetti, l'accesso al repository di codice e i server MCP remoti richiedono il raggiungimento dei servizi pubblici. Per utilizzare queste funzionalità in modalità Azure VNet, attiva l'interruttore corrispondente. Se un interruttore è disattivato, tale funzionalità non è disponibile a meno che la rete virtuale non possa instradare direttamente tali servizi, ad esempio tramite regole del firewall basate su FQDN. Vedere Azure SRE Agent infra network per i dettagli.

Riepilogo del routing del traffico

Tipo di traffico Percorso Configurabile?
La tua infrastruttura Azure (Log Analytics, App Insights, AKS, database, Key Vault) La tua VNet Yes. Instradato tramite la tua VNet per impostazione predefinita.
Sistemi locali (ExpressRoute/VPN) La tua VNet Yes. Accessibile se le route di rete lo consentono.
Servizi della piattaforma (orchestrazione, endpoint dei modelli, telemetria) Rete infrastrutturale dell'agente SRE di Azure No. Sempre instradato tramite l'infrastruttura gestita.
Registri pacchetti (PyPI, npm, NuGet, apt) Rete infrastrutturale dell'agente SRE (attivata) o VNet (regola FQDN) Yes. Attivazione/disattivazione per registro o pacchetti preinstallati
Repository di codice (GitHub, GHE, Azure DevOps) Rete infrastrutturale dell'agente SRE (attivata) o VNet (regola FQDN) Yes. Interruttore per ogni provider
Server MCP remoti Rete infrastrutturale dell'agente SRE (attivata) o VNet (regola FQDN) Yes. Interruttore singolo
Nomi host aggiuntivi Infrastruttura di rete dell'agente SRE (per gli host nell'elenco) Yes. Elenco personalizzato
Traffico del connettore Internet pubblico No. Non inoltrato tramite VNet.
(Endpoint privato) in entrata Non supportato No. Solo in uscita.

Configurare Azure modalità rete virtuale

Requisiti della subnet

La modalità VNet di Azure richiede una subnet dedicata nella rete virtuale:

  • Taglia: /27 o più.
  • Delega: la sottorete deve essere delegata a Microsoft.App/environments.
  • Area: la subnet deve trovarsi nella stessa area della risorsa agente SRE.
  • Dedicato: la subnet non può essere condivisa con altri servizi.

Configurare Azure modalità rete virtuale

  1. Passare a Impostazioni Configurazione>area di lavoro>Rete.
  2. Selezionare Azure VNet come modalità di uscita.
  3. Selezionare Sfoglia sottoreti.
  4. Selezionare la sottoscrizione, il gruppo di risorse, la rete virtuale e la subnet che soddisfano i requisiti della subnet.
  5. Seleziona Salva.
  6. Testare l'agente con un evento imprevisto rappresentativo per verificare che possa raggiungere le risorse necessarie.

Rete infrastrutturale dell'agente SRE di Azure

Alcune funzionalità dell'agente dipendono da servizi pubblici che è difficile inserire in un elenco di elementi consentiti in base all'indirizzo IP. In modalità Azure VNet, queste funzionalità richiedono un'opzione infra network (che instrada quella categoria attraverso la rete infra dell'agente Azure SRE) oppure regole del firewall basate su FQDN nella rete virtuale che permettano il passaggio diretto del traffico. Vedere il riepilogo del routing di traffico per l'elenco completo di categorie e percorsi.

Se si disattiva un interruttore e la rete virtuale non riesce a raggiungere il servizio, tale funzionalità non è disponibile.

Note

È possibile applicare un Criteri di Azure per limitare o disabilitare gli interruttori di rete infra, assicurandosi che nessun operatore possa instradare il traffico all'esterno della rete virtuale.

Pacchetti preinstallati

Preinstallare i pacchetti nell'immagine del disco di base sandbox in modo che siano disponibili ogni volta che viene eseguito l'agente. Questa funzionalità è utile quando gli strumenti o gli script dipendono da pacchetti specifici che non sono inclusi nell'ambiente sandbox predefinito.

Per configurare i pacchetti preinstallati:

  1. Aprire l'agente nel portale di Azure e selezionare Impostazioni>Configurazioneworkspace.

  2. Selezionare la scheda Pacchetti .

  3. Immettere il nome del pacchetto, selezionare la gestione pacchetti (pip o NuGet) e, facoltativamente, specificare una versione.

  4. Selezionare + Aggiungi pacchetto.

Schermata della scheda Pacchetti nella configurazione dell'area di lavoro dell'agente SRE di Azure che mostra i campi per il nome del pacchetto, il gestore di pacchetti e la versione.

Note

Gli elementi NuGet devono essere strumenti della CLI .NET (ad esempio, dotnet-ef). Non è possibile installare pacchetti di libreria a livello globale.

Controlli di esclusione della rete virtuale

Quando si abilita Azure modalità rete virtuale, la sezione Rete infrastruttura della pagina di configurazione dell'area di lavoro consente di instradare categorie di traffico all'esterno della rete virtuale tramite la rete Internet pubblica. Se non si abilita nessuno di questi controlli, tutto il traffico dell'agente viene instradato attraverso la rete virtuale.

Non tutti i servizi esterni forniscono un tag di servizio Azure. GitHub, ad esempio, non è un servizio Azure e non espone un tag di servizio. Se l'agente deve raggiungere GitHub, l'unica opzione con un firewall basato su IP di livello 4 consiste nel mantenere un elenco degli indirizzi IP del provider. Questi elenchi cambiano frequentemente e un firewall che non viene mantenuto aggiornato compromette il funzionamento dell'agente.

Lo stesso vale per diversi servizi pubblici principali, ad esempio PyPI, npm, NuGet e registri contenitori. Questi servizi operano da intervalli IP globali di grandi dimensioni e spesso modificati e non sono coperti da tag di servizio Azure.

Gli interruttori di bypass consentono all'agente di raggiungere questi host tramite l'uscita della piattaforma. Il team di rete aggiorna le regole del firewall o passa a un firewall che supporta il filtro dei nomi host o il filtro del nome di dominio completo (FQDN). Gli esempi includono Firewall di Azure Premium con regole FQDN o un'appliance virtuale di rete che supporta l'ispezione di Transport Layer Security.

Considera i controlli di bypass come una soluzione temporanea, non come un sostituto permanente del filtraggio del traffico in uscita basato sul nome host.

Di seguito sono illustrati i controlli disponibili:

Controllo Description
Accesso al server MCP (Model Context Protocol) Se abilitata, il traffico del server MCP viene instradato su Internet pubblico anziché sulla rete virtuale.
Accesso al gestore pacchetti Se abilitata, il traffico di Gestione pacchetti (PyPI, npm, NuGet) viene instradato su Internet pubblico anziché sulla rete virtuale.
Repository di codice Seleziona quali provider dei repository di codice (GitHub, GitHub Enterprise, Azure DevOps) passano attraverso Internet pubblico anziché attraverso la rete virtuale.
Host aggiuntivi Immetti nomi host aggiuntivi o pattern wildcard (ad esempio, github.com, *.example.com, raw.contoso.io) per instradare il traffico tramite Internet pubblico anziché la tua rete virtuale. I pacchetti configurati autorizzano automaticamente i rispettivi host.

Considerazioni sulla governance

L'accesso a questi controlli è limitato agli utenti con il ruolo amministratore agente SRE. La creazione di un agente SRE in un ambiente aziendale è un atto di governance significativo perché le organizzazioni richiedono in genere un'approvazione sostanziale per distribuire i servizi nell'ambiente di produzione. I controlli di bypass rappresentano un aspetto del più ampio quadro di governance aziendale, che comprende identità gestite, credenziali per conto di (OBO) e autorizzazioni RBAC. L'agente può fare solo ciò che le sue autorizzazioni gli consentono, e la configurazione di rete controlla dove va quel traffico.

Ispezionare l'attività di rete

Gli amministratori possono aprire Impostazioni>, configurazione> dello spaziodi lavoro, ispezionare e usare l'audit di rete per esaminare le richieste in uscita filtrate, permesse e negate dall'agente. Usa host, metodo, percorso e decisione per identificare le destinazioni bloccate dalla policy Limited o Azure VNet.

L'audit di rete copre solo le decisioni relative alla politica di uscita degli agenti. Non è una traccia completa di audit di rete e non include ogni runtime, connettore, piattaforma, firewall, DNS o evento proxy.

Cosa accade quando la rete blocca una chiamata

Se una richiesta in uscita viene negata da una regola NSG o non dispone di alcun percorso, l'agente riscontra lo stesso errore di rete che riscontrerebbe qualsiasi carico di lavoro in quella subnet. L'agente segnala l'errore nell'output dell'indagine (ad esempio, "Impossibile raggiungere l'area di lavoro di Log Analytics: timeout di connessione") e continua usando gli strumenti e i dati a cui riesce ad accedere. Se un'origine dati critica non è raggiungibile, l'indagine è incompleta e l'agente segnala questa condizione.

Limitations

Si applicano le limitazioni seguenti.

  • Solo traffico in uscita: l'integrazione con la rete virtuale controlla solo il traffico in uscita (egress). Le connessioni in ingresso all'agente dall'interno di una rete privata non sono supportate.

  • I connettori non vengono instradati tramite la rete virtuale: il traffico dei connettori viene instradato tramite Internet pubblico.