Risolvere i problemi relativi al proxy e al firewall in Visual Studio

Quando si usa Visual Studio dietro un proxy aziendale o un firewall, è possibile che si verifichino problemi di connettività che influiscono sulle funzionalità che richiedono l'accesso alla rete, ad esempio il ripristino dei pacchetti NuGet, l'installazione dell'estensione e le funzionalità basate sull'intelligenza artificiale. I problemi del proxy in genere rientrano in due categorie:

• Problemi di configurazione: problemi relativi all'installazione, ai certificati o alla configurazione di rete del server proxy. Questi problemi vengono risolti dall'amministratore IT.

• Impostazioni necessarie: Visual Studio richiede informazioni aggiuntive sulla configurazione di rete. È possibile configurare le impostazioni proxy direttamente nell'IDE. Per istruzioni sull'installazione, vedere Configurare le impostazioni proxy in Visual Studio .

  Annotazioni

  L'esperienza di configurazione del proxy non è ancora disponibile in tutte le installazioni di Visual Studio 2026. Se non viene visualizzato nell'installazione, è possibile installare Visual Studio Insiders per provarlo. In alternativa, visualizzare la versione di Visual Studio 2022 di questa pagina per indicazioni.

• Problemi di prodotto: se si è determinato che il problema non è un problema di configurazione o le impostazioni specificate non risoluti il problema visualizzato, potrebbe trattarsi di un problema di prodotto. Seguire la procedura descritta in Raccogliere informazioni di diagnostica prima di inviare un ticket.

Questo articolo consente di identificare la categoria in cui rientra il problema e fornisce soluzioni per i problemi comuni.

Prerequisiti

Prima di risolvere i problemi del proxy, assicurarsi di avere:

• Visual Studio installato e aggiornato alla versione più recente.
• URL richiesti consentiti attraverso il firewall. Vedere Installare e usare Visual Studio dietro un firewall o un server proxy.

Problemi noti e soluzioni

Le sezioni seguenti descrivono i problemi comuni relativi al proxy e le relative soluzioni.

Errori di connessione SSL (autorità di certificazione non attendibile)

Sintomo: viene visualizzato un errore simile System.Net.Http.HttpRequestException: The SSL connection could not be established a un'eccezione IOException: Unable to read data from the transport connection: An existing connection was forcibly closed by the remote hostinterna.

Categoria: Problema di configurazione

Soluzione: il server proxy utilizza un'autorità di certificazione (CA) che deve essere installata e considerata attendibile. Completare entrambi i passaggi seguenti:

1. Installare tutti i certificati legati ai proxy (radice e intermedi) nell'archivio Autorità di certificazione radice attendibili di Windows. Per altre informazioni, vedere Archivio certificati autorità di certificazione radice attendibili.
2. Impostare la NODE_EXTRA_CA_CERTS variabile di ambiente sul percorso del file di certificato della CA. Questo passaggio è necessario per le funzionalità che usano processi di Node.js.

Annotazioni

Questo errore può verificarsi anche se un firewall blocca la connessione anziché un problema del proxy.

Malfunzionamenti del proxy trasparente

Sintomo: le chiamate di rete hanno esito negativo quando si usa un proxy trasparente, con vari messaggi di errore.

Categoria: Problema di configurazione

Soluzione: i proxy trasparenti possono causare un'ampia gamma di problemi perché intercettano il traffico senza configurazione esplicita. Il server proxy potrebbe usare elenchi di indirizzi consentiti o bloccati per processi e applicazioni specifici. Collaborare con l'amministratore di rete per:

• Verificare che i processi di Visual Studio siano consentiti tramite il proxy
• Controllare se gli endpoint specifici sono bloccati
• Esaminare le impostazioni di ispezione SSL

L'autenticazione copilota funziona mentre La chat copilota non funziona

Sintomo: è possibile accedere a GitHub e Copilot indica che si è autenticati, tuttavia l'uso della chat di Copilot genera un errore.

Categoria: Problema di configurazione

Soluzione: questi sintomi indicano che le richieste .NET di Visual Studio hanno esito negativo, ma le richieste di .NET Framework funzionano. Esistono molte possibili cause, tra cui proxy che bloccano endpoint specifici o che il traffico IPv6 generale è bloccato. Verificare che il traffico IPv6 non sia bloccato dal proxy o dal firewall. Provare a usare una delle soluzioni seguenti:

• Preferito: configurare il proxy per consentire il traffico IPv6.
• Alternativa: impostare la variabile DOTNET_SYSTEM_NET_DISABLEIPV6 di ambiente su 1 per forzare IPv4.
• Se si usano elenchi di autorizzazione del processo: aggiungere DevHub.exe all'elenco di indirizzi consentiti del firewall o del proxy.

Errori parziali della catena di certificati

Sintomo: le tracce dello stack mostrano The remote certificate is invalid because of errors in the certificate chain: PartialChain.

Categoria: Problema di configurazione

Soluzione: manca uno o più certificati intermedi dalla catena di certificati. Vedere Diagnosticare i problemi parziali della catena di certificati per la procedura per identificare i certificati mancanti, quindi collaborare con l'amministratore IT per installarli.

Autenticazione proxy richiesta (errore 407 con autenticazione di base)

Sintomo: le tracce dello stack vengono visualizzate (407) Proxy Authentication Required quando si usa un proxy con l'autenticazione di base.

Categoria: Impostazioni obbligatorie

Soluzione: Visual Studio supporta l'accesso agli account GitHub e Microsoft Entra dietro un proxy di autenticazione di base, ma la maggior parte delle versioni di Visual Studio non supporta Copilot dietro un proxy di autenticazione di base.

All'avvio viene visualizzato un prompt per acquisire le credenziali. Le credenziali persistono in Gestione credenziali di Windows sotto Credenziali di Windows come indirizzo Internet o di rete, quindi il nome utente e la password richiesti dal proxy.

È anche possibile configurare le credenziali proxy direttamente in Visual Studio. Vedere Configurare le impostazioni proxy in Visual Studio.

Autenticazione proxy obbligatoria (NTLM o Kerberos)

Sintomo: le funzionalità dipendenti dalla rete non funzionano quando si usa un server proxy con autenticazione NTLM o Kerberos.

Categoria: Impostazioni obbligatorie

Soluzione: configurare Visual Studio per l'uso delle credenziali proxy predefinite:

1. Passare a Strumenti>Opzioni Proxy>Impostazioni proxy.
2. Selezionare Usa l'account di Windows connesso per usare le credenziali di Windows correnti.
3. Riavviare Visual Studio per rendere effettive le modifiche.

Per altre informazioni, vedere Configurare le impostazioni proxy in Visual Studio.

Annotazioni

Per disabilitare questa soluzione alternativa in un secondo momento, eliminare completamente la variabile di ambiente. Impostandolo su false non disabilita la funzionalità.

Configurazione esplicita del proxy è richiesta

Sintomo: le funzionalità dipendenti dalla rete non funzionano anche se il proxy non richiede l'autenticazione.

Categoria: Impostazioni obbligatorie

Soluzione: configurare l'indirizzo del server proxy in modo esplicito:

1. Passare a Strumenti>Opzioni Proxy>Impostazioni proxy.
2. Selezionare Usa impostazioni proxy personalizzate.
3. Immettere l'URL e la porta del server proxy.
4. Riavviare Visual Studio per rendere effettive le modifiche.

Per altre informazioni, vedere Configurare le impostazioni proxy in Visual Studio.

Per informazioni dettagliate sui passaggi di configurazione del proxy, vedere Configurare le impostazioni proxy in Visual Studio.

Risolvere i problemi relativi ai certificati SSL

Gli errori del certificato SSL si verificano in genere quando il server proxy esegue l'ispezione SSL e i certificati necessari non sono installati correttamente o attendibili. Usare la procedura seguente per diagnosticare la causa radice.

Rispondere alle domande di diagnostica

Esaminare queste domande per limitare il problema:

1. I certificati sono attendibili? Controllare se il certificato CA del proxy è installato nell'archivio certificati dell'utente corrente o nell'archivio computer locale.
2. Visual Studio è in esecuzione con un diverso utente? Se Visual Studio viene eseguito come utente diverso da quello connesso a Windows, potrebbe non avere accesso ai certificati nell'archivio dell'utente corrente.
3. L'utente è autenticato nei servizi online? Controllare se è possibile accedere all'account Microsoft o GitHub in Visual Studio.
4. La funzionalità funziona in precedenza? Se la funzionalità funzionava prima e smetteva di funzionare, probabilmente si è verificata una modifica della configurazione di rete upstream. Questo non è un problema del prodotto Visual Studio.
5. È possibile accedere ad altre risorse di rete? Se è possibile esplorare il Web ma le funzionalità di Visual Studio hanno esito negativo, il problema riguarda in particolare le connessioni di rete di Visual Studio.

Identificare il problema in base ai sintomi

Usare questi modelli per identificare il problema specifico:

• Certificati nell'archivio utenti, Visual Studio in esecuzione come utente diverso: Visual Studio potrebbe non essere in grado di accedere ai certificati. Installare invece i certificati nell'archivio computer locale.
• Alcune funzionalità funzionano ma altre hanno esito negativo: questo indica in genere un problema IPv6 o una differenza tra .NET Framework e la rete .NET Core. Vedere Copilot Authentication works while Copilot Chat does not (L'autenticazione copilot funziona mentre la chat di Copilot non funziona).
• Ha funzionato ieri, interrotto oggi: si è verificata una modifica della configurazione di rete upstream. Contattare l'amministratore IT per identificare le modifiche apportate.

Diagnosticare i problemi della catena di certificati parziali

Se vengono visualizzati PartialChain errori, seguire questa procedura per identificare i certificati mancanti. Questi passaggi richiedono lo strumento da riga di comando OpenSSL.

1. Eseguire il comando seguente per visualizzare la catena di certificati, sostituendo PROXY_HOST:PORT con l'indirizzo proxy e target.host.com con l'endpoint che si sta tentando di raggiungere:

   openssl s_client -proxy PROXY_HOST:PORT -connect target.host.com:443 -showcerts -verify 5 </dev/null
   

2. Per ogni certificato nell'output, eseguire il comando seguente per controllare la catena (dopo aver salvato ogni certificato in un file come cert1.pem, cert2.peme così via):

   openssl x509 -in cert1.pem -noout -subject -issuer -ski -aki
   

3. Verificare la catena di certificati controllando:

   • L'identificatore di chiave dell'autorità (AKI) del certificato N deve corrispondere all'identificatore di chiave del soggetto (SKI) del certificato N+1.
   • Il DN dell'autorità emittente del certificato N deve corrispondere al DN soggetto del certificato N+1.

Se si trova un'interruzione nella catena, contattare l'amministratore IT per ottenere e installare i certificati intermedi mancanti.

Annotazioni

.NET rifiuta le richieste se l'AKI di un certificato non corrisponde allo SKI del certificato successivo nella catena, anche quando i Web browser hanno esito positivo. Si tratta di una convalida più rigorosa rispetto alla maggior parte dei browser.

Problemi del prodotto: raccogliere informazioni di diagnostica per il supporto

Se si è determinato che il problema non è un problema di configurazione dopo aver specificato le impostazioni necessarie in Visual Studio, inviare un ticket di feedback. Vedere Come segnalare un problema con Visual Studio. Quando si invia un ticket di feedback per i problemi del proxy, includere le informazioni seguenti per consentirci di analizzare. Altri dettagli forniti, più velocemente è possibile identificare se il problema è un bug del prodotto o un problema di configurazione.

Controllare lo stato di autenticazione

Verificare gli stati di autenticazione seguenti:

1. Autenticazione di GitHub:

   • AprireCredenziali di Windows>>.
   • Cercare le credenziali con il prefisso git:.
   • Verificare %LocalAppData%/.IdentityService/GitHubV3AccountStore.json la presenza di metadati dell'account GitHub.

2. Stato della funzionalità: si noti quali funzionalità funzionano e che hanno esito negativo (ad esempio, ripristino NuGet, installazione dell'estensione, funzionalità di intelligenza artificiale).

Raccogliere log e dettagli di configurazione

Raccogliere le informazioni seguenti:

1. Log di Visual Studio: creare un file ZIP di %temp%/Vslogs.

2. Traccia di rete: se possibile, raccogliere una traccia fiddler che mostra le richieste non riuscite.

3. Dettagli della configurazione del proxy:

   • Si tratta di un proxy esplicito o trasparente?
   • Il proxy richiede l'autenticazione? In tal caso, che tipo (Basic, NTLM, Kerberos)?
   • Il proxy blocca o consente applicazioni specifiche?
   • I certificati necessari sono installati e attendibili? I certificati vengono revocati o scaduti?
   • È configurato anche un firewall?
   • L'ispezione SSL è abilitata?
   • Il traffico IPv6 viene instradato attraverso il proxy?

4. Confronto con altri strumenti: Visual Studio Code o altre applicazioni funzionano tramite questo proxy?

Contenuti correlati

• Configurare le impostazioni proxy in Visual Studio

• Installare e usare Visual Studio protetto da un firewall o un server proxy
• Risoluzione dei problemi di connettività di Visual Studio