Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
È possibile migliorare la sicurezza dell'agente in Azure agente SRE in due modi: tramite le autorizzazioni appropriate per il controllo degli accessi in base al ruolo e l'integrazione della rete virtuale.
Se concedi all'identità gestita dell'agente le autorizzazioni RBAC appropriate, l'agente può operare sulla tua infrastruttura, eseguire query sui tuoi database ed eseguire comandi sui tuoi cluster. RBAC è il principale confine di sicurezza che determina ciò che l'agente può fare.
L'integrazione della rete virtuale aggiunge un livello di protezione complementare controllando dove l'agente può inviare traffico. Senza questa integrazione, il traffico in uscita dall'agente passa tramite Internet pubblico. Con esso, ogni chiamata in uscita instrada attraverso Rete virtuale di Azure e l'infrastruttura di sicurezza di rete esistente.
Questo articolo illustra perché il controllo a livello di rete è importante per le distribuzioni aziendali, il funzionamento dell'integrazione della rete virtuale e come scegliere la modalità di controllo di rete appropriata per il carico di lavoro.
Perché il controllo di rete è importante
Per impostazione predefinita, l'agente può raggiungere qualsiasi endpoint su Internet. Per i carichi di lavoro di sviluppo e test, questo comportamento è accettabile. Per le distribuzioni aziendali di produzione, questo livello di accesso crea rischi non necessari.
Due rischi determinano il requisito aziendale per i controlli di rete:
Esfiltrazione dei dati: un agente con accesso ai dati interni sensibili e l'accesso a Internet senza restrizioni può creare un percorso per i dati da lasciare l'organizzazione.
Iniezione di prompt: contenuti dannosi sul web pubblico possono essere creati ad arte per manipolare il comportamento dell'agente. Un agente privo di restrizioni che recupera contenuti esterni è esposto ad attacchi di injection attraverso tali risposte.
Posizionare l'agente all'interno di una rete virtuale per un migliore controllo sul comportamento.
Funzionamento dell'integrazione della rete virtuale
L'integrazione della rete virtuale connette SRE Agent alla rete virtuale esistente. Quando l'agente effettua una chiamata in uscita, il traffico passa attraverso l'infrastruttura di rete anziché la rete Internet pubblica.
Dopo aver configurato l'integrazione con la rete virtuale, il traffico dell'agente:
- Viene visualizzato nei log di rete per il controllo e il monitoraggio.
- Passa attraverso i firewall di livello 4 e 7.
- Rispetta la configurazione DNS (Domain Name System) personalizzata.
- Segue le policy di sicurezza aziendali e le regole di uscita.
Dopo che L'agente SRE viene aggiunto alla rete virtuale, funziona con le stesse regole di qualsiasi altro carico di lavoro in tale rete, tra cui ispezione del firewall, risoluzione DNS e registrazione del traffico.
Importante
L'integrazione della rete virtuale controlla solo il traffico in uscita.
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à.
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 instradato tramite VNet in questa anteprima. |
| (Endpoint privato) in entrata | Non supportato | No. Uscita solo in questa anteprima. |
Configurare Azure modalità rete virtuale
Requisiti della subnet
La modalità VNet di Azure richiede una subnet dedicata nella rete virtuale:
- Dimensioni: /28 o superiore. Un /28 supporta le sessioni simultanee di un singolo agente. Dimensionamento fino a /26 per flotte più grandi o per picchi di capacità.
-
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
- Passare a Impostazioni Configurazione>area di lavoro>Rete.
- Selezionare Azure VNet come modalità di uscita.
- Selezionare Sfoglia sottoreti.
- Selezionare la sottoscrizione, il gruppo di risorse, la rete virtuale e la subnet che soddisfano i requisiti della subnet.
- Seleziona Salva.
- 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:
Aprire l'agente nel portale di Azure e selezionare Impostazioni>Configurazioneworkspace.
Selezionare la scheda Pacchetti .
Immettere il nome del pacchetto, selezionare la gestione pacchetti (pip o NuGet) e, facoltativamente, specificare una versione.
Selezionare + Aggiungi pacchetto.
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.
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
Durante l'anteprima vengono applicate 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 instradano attraverso la rete virtuale: non è disponibile alcun supporto per il routing del traffico del connettore attraverso la rete virtuale. I connettori sono disponibili anche in anteprima. Durante l'anteprima, il traffico del connettore viene instradato su Internet pubblico. Per ulteriori informazioni, vedi connettori di SRE Agent.