Problemen met proxy en firewall oplossen in Visual Studio

Wanneer u Visual Studio achter een bedrijfsproxy of firewall gebruikt, kunnen er verbindingsproblemen optreden die van invloed zijn op functies die netwerktoegang vereisen, zoals nuGet-pakketherstel, extensie-installatie en ai-functies. Proxyproblemen vallen over het algemeen in twee categorieën:

• Configuratieproblemen: problemen met de installatie, certificaten of netwerkconfiguratie van uw proxyserver. Deze problemen worden opgelost door uw IT-beheerder.

• Productproblemen: Als u hebt vastgesteld dat uw probleem geen configuratieprobleem is of als de opgegeven instellingen het probleem niet oplossen dat u ziet, kan dit een productprobleem zijn. Volg de stappen bij Diagnostische gegevens verzamelen voordat u een ticket indient.

Dit artikel helpt u bij het identificeren van de categorie waarin uw probleem zich bevindt en biedt oplossingen voor veelvoorkomende problemen.

Vereiste voorwaarden

Voordat u proxyproblemen gaat oplossen, moet u ervoor zorgen dat u het volgende hebt:

• Visual Studio is geïnstalleerd en bijgewerkt naar de nieuwste versie.
• De vereiste URL's die zijn toegestaan via uw firewall. Zie Visual Studio installeren en gebruiken achter een firewall of proxyserver.

Bekende problemen en oplossingen

In de volgende secties worden veelvoorkomende problemen met betrekking tot proxy's en hun oplossingen beschreven.

SSL-verbindingsfouten (certificeringsinstantie wordt niet vertrouwd)

Symptoom: U ziet een fout zoals System.Net.Http.HttpRequestException: The SSL connection could not be established met een interne uitzondering IOException: Unable to read data from the transport connection: An existing connection was forcibly closed by the remote host.

Categorie: Configuratieprobleem

Oplossing: Uw proxyserver maakt gebruik van een certificaatautoriteit (CA) die moet worden geïnstalleerd en vertrouwd. Voer beide van de volgende stappen uit:

1. Installeer alle certificaten voor proxyproblemen (basis- en tussenliggende certificaten) in het archief met vertrouwde basiscertificeringsinstanties van Windows. Zie Het certificaatarchief van vertrouwde basiscertificeringsinstanties voor meer informatie.
2. Stel de NODE_EXTRA_CA_CERTS omgevingsvariabele in op het pad van het CA-certificaatbestand. Deze stap is vereist voor functies die gebruikmaken van Node.js processen.

Transparante proxy-fouten

Symptoom: netwerkoproepen mislukken bij het gebruik van een transparante proxy, met verschillende foutberichten.

Categorie: Configuratieprobleem

Oplossing: Transparante proxy's kunnen een breed scala aan problemen veroorzaken omdat ze verkeer onderscheppen zonder expliciete configuratie. De proxyserver gebruikt mogelijk acceptatie- of blokkeringslijsten voor specifieke processen en toepassingen. Werk samen met uw netwerkbeheerder om:

• Controleer of Visual Studio-processen zijn toegestaan via de proxy
• Controleren of specifieke eindpunten zijn geblokkeerd
• SSL-inspectie-instellingen controleren

Copilot-verificatie werkt terwijl Copilot Chat niet werkt

Symptoom: U kunt zich aanmelden bij GitHub en Copilot geeft aan dat u bent geverifieerd, maar het gebruik van Copilot-chat resulteert in een fout.

Categorie: Configuratieprobleem

Oplossing: Deze symptomen betekenen dat de eigen .NET-aanvragen van Visual Studio mislukken, maar .NET Framework-aanvragen werken. Er zijn veel mogelijke oorzaken, waaronder proxy's die specifieke eindpunten blokkeren of dat algemeen IPv6-verkeer wordt geblokkeerd. Controleer of IPv6-verkeer niet wordt geblokkeerd door uw proxy of firewall. Gebruik een van de volgende oplossingen:

Fouten in gedeeltelijke certificaatketen

Symptoom: Stacktraceringen tonen The remote certificate is invalid because of errors in the certificate chain: PartialChain.

Categorie: Configuratieprobleem

Oplossing: een of meer tussenliggende certificaten ontbreken in de certificaatketen. Zie Problemen met gedeeltelijke certificaatketen vaststellen voor stappen voor het identificeren van ontbrekende certificaten en werk vervolgens samen met uw IT-beheerder om ze te installeren.

Proxy-authenticatie vereist (407-fout met basisauthenticatie)

Symptoom: Stack-traceringen worden weergegeven wanneer u een proxy met basisverificatie gebruikt (407) Proxy Authentication Required .

Categorie: Instellingen vereist

Oplossing: Visual Studio ondersteunt het aanmelden bij GitHub- en Microsoft Entra-accounts achter een verificatieproxy met basisverificatie, maar de meeste versies van Visual Studio hebben geen ondersteuning voor Copilot achter een verificatieproxy met basisverificatie.

Proxyverificatie vereist (NTLM of Kerberos)

Symptoom: netwerkafhankelijke functies werken niet wanneer u een proxyserver met NTLM- of Kerberos-verificatie gebruikt.

Categorie: Instellingen vereist

Oplossing: Visual Studio configureren voor het gebruik van standaardproxyreferenties:

Expliciete proxyconfiguratie vereist

Symptoom: netwerkafhankelijke functies werken niet, ook al is verificatie niet vereist voor uw proxy.

Categorie: Instellingen vereist

Oplossing: Configureer het adres van de proxyserver expliciet:

Problemen met SSL-certificaten oplossen

SSL-certificaatfouten treden doorgaans op wanneer uw proxyserver SSL-inspectie uitvoert en de vereiste certificaten niet correct zijn geïnstalleerd of vertrouwd. Gebruik de volgende stappen om de hoofdoorzaak te diagnosticeren.

Diagnostische vragen beantwoorden

Doorloop deze vragen om het probleem te beperken:

1. Worden de certificaten vertrouwd? Controleer of het CA-certificaat van de proxy is geïnstalleerd in het certificaatarchief van de huidige gebruiker of het lokale computerarchief.
2. Wordt Visual Studio uitgevoerd als een andere gebruiker? Als Visual Studio wordt uitgevoerd als een andere gebruiker dan de gebruiker die is aangemeld bij Windows, heeft visual Studio mogelijk geen toegang tot certificaten in het archief van de huidige gebruiker.
3. Bent u geverifieerd bij onlineservices? Controleer of u zich kunt aanmelden bij uw Microsoft- of GitHub-account in Visual Studio.
4. Werkte de functie eerder? Als de functie eerder werkte en niet meer werkte, is er waarschijnlijk een upstream-netwerkconfiguratiewijziging opgetreden. Dit is geen probleem met een Visual Studio-product.
5. Hebt u toegang tot andere netwerkbronnen? Als u op internet kunt bladeren, maar Visual Studio-functies mislukken, is het probleem specifiek met de netwerkverbindingen van Visual Studio.

Het probleem identificeren op basis van symptomen

Gebruik deze patronen om uw specifieke probleem te identificeren:

• Certificaten in het gebruikersarchief, VS die als een andere gebruiker worden uitgevoerd: Visual Studio heeft mogelijk geen toegang tot de certificaten. Installeer in plaats daarvan certificaten in het archief van de lokale computer.
• Sommige functies werken, maar andere mislukken: dit duidt meestal op een IPv6-probleem of een verschil tussen .NET Framework en .NET Core-netwerken. Zie Copilot-verificatie werkt terwijl Copilot Chat niet werkt.
• Gisteren werkte het, vandaag kapot: er is een upstream netwerkconfiguratiewijziging opgetreden. Neem contact op met uw IT-beheerder om te bepalen wat er is gewijzigd.

Problemen met gedeeltelijke certificaatketen vaststellen

Als u fouten ziet PartialChain , gebruikt u de volgende stappen om ontbrekende certificaten te identificeren. Voor deze stappen is het openSSL-opdrachtregelprogramma vereist.

1. Voer de volgende opdracht uit om de certificaatketen weer te geven, waarbij u PROXY_HOST:PORT het proxyadres vervangt door target.host.com het eindpunt dat u probeert te bereiken:

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

2. Voer voor elk certificaat in de uitvoer de volgende opdracht uit om de keten te controleren (nadat elk certificaat is opgeslagen in een bestand zoals cert1.pem, cert2.pemenzovoort):

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

3. Controleer de certificaatketen door het volgende te controleren:

   • De Authority Key Identifier (AKI) van certificaat N moet overeenkomen met de Subject Key Identifier (SKI) van het certificaat N+1.
   • De verlener-DN van certificaat N moet overeenkomen met de onderwerp-DN van certificaat N+1.

Als u een onderbreking in de keten vindt, neemt u contact op met uw IT-beheerder om de ontbrekende tussenliggende certificaten te verkrijgen en te installeren.

Productproblemen: diagnostische informatie verzamelen voor ondersteuning

Als u hebt vastgesteld dat uw probleem geen configuratieprobleem is nadat u de vereiste instellingen hebt opgegeven in Visual Studio, dient u een feedbackticket in. Zie Een probleem melden met Visual Studio. Wanneer u een feedbackticket indient voor proxyproblemen, neemt u de volgende informatie op om ons te helpen onderzoeken. Hoe meer details u opgeeft, hoe sneller we kunnen vaststellen of het probleem een productfout of een configuratieprobleem is.

Verificatiestatus controleren

Controleer de volgende verificatiestatussen:

1. GitHub-verificatie:

   • Open Windows>Referentiebeheer>Windows-referenties.
   • Zoek naar referenties met het git: voorvoegsel.
   • Controleer de metagegevens van GitHub-accounts op %LocalAppData%/.IdentityService/GitHubV3AccountStore.json.

2. Functiestatus: Let op welke functies werken en welke mislukken (bijvoorbeeld NuGet-herstel, extensie-installatie, AI-functies).

Logboeken en configuratiegegevens verzamelen

Verzamel de volgende informatie:

1. Visual Studio-logboeken: maak een zip-bestand van %temp%/Vslogs.

2. Netwerktracering: verzamel indien mogelijk een Fiddler-trace met de mislukte aanvragen.

3. Details van proxyconfiguratie:

   • Is dit een expliciete of transparante proxy?
   • Vereist de proxy autorisatie of verificatie? Zo ja, wat voor soort (Basic, NTLM, Kerberos)?
   • Blokkeert of staat de proxy specifieke toepassingen toe?
   • Zijn de vereiste certificaten geïnstalleerd en vertrouwd? Zijn er certificaten ingetrokken of verlopen?
   • Is er ook een firewall geconfigureerd?
   • Is SSL-inspectie ingeschakeld?
   • Wordt IPv6-verkeer gerouteerd via de proxy?

4. Vergelijking met andere hulpprogramma's: Werken Visual Studio Code of andere toepassingen via deze proxy?

Verwante inhoud

• Visual Studio installeren en gebruiken achter een firewall of proxyserver
• Problemen met Visual Studio-connectiviteit oplossen