Requisiti di connettività per Live Share

  • Articolo

Questo articolo riepiloga i requisiti di connettività per Visual Studio Live Share, le opzioni di connettività disponibili e le soluzioni alternative note, se applicabile.

Eseguire l'accesso

È possibile accedere a Live Share usando qualsiasi account aziendale o dell'istituto di istruzione supportato da Azure Active Directory , un account Microsoft o un profilo GitHub. In genere, gli URL di accesso per questi sono aperti nella maggior parte delle organizzazioni, dato il numero di prodotti pubblici che li usano, ma in caso contrario, contattare l'amministratore di rete per l'apertura login.microsoftonline.com e/o github.com oltre ai domini elencati di seguito.

Nota

Gli account AD (ADFS) locali e gli account GitHub Enterprise locali non sono attualmente supportati (voto 👍attivo).

modalità di Connessione ion

Per garantire prestazioni ottimali, Per impostazione predefinita, Visual Studio Live Share rileva automaticamente se un computer host di sessione di collaborazione e un computer guest possono comunicare direttamente su una rete e solo inoltri tramite il cloud se non è presente alcuna route tra di esse. Questa modalità mista "auto" è flessibile e consente ad alcuni guest di inoltrare il cloud mentre altri si connettono direttamente per la stessa sessione.

Le connessioni dirette vengono autenticate tramite un meccanismo basato sul cloud per garantire la sicurezza, ma richiedono l'apertura di una porta compresa tra 5990 e 5999 per abilitare la connettività. Di conseguenza, quando si condivide per la prima volta il firewall desktop potrebbe richiedere di aprire una porta. L'accettazione di questa opzione è facoltativa perché ignorando semplicemente Live Share userà sempre l'inoltro quando è in modalità automatica.

Tutte le connessioni in Visual Studio Live Share sono SSH o SSL crittografate e autenticate in un servizio centrale per garantire che solo quelli nella sessione di collaborazione possano ottenere l'accesso al relativo contenuto. Inoltre, l'inoltro cloud di Live Share non rende persistente il traffico instradato attraverso di esso e non "snoop" il traffico in alcun modo.

Modifica della modalità di connessione

Se si preferisce disabilitare connessioni dirette o inoltrate o risolvere semplicemente i problemi di connettività, è possibile forzare altre modalità di connessione.

Modalità Comportamento host Comportamento guest
Automatica La sessione di collaborazione dell'host accetta connessioni dirette protette autenticate o connessioni inoltrate nel cloud. Tenta di usare una connessione diretta ed esegue il fallback all'inoltro attraverso il cloud in caso di errore.
Diretto La sessione di collaborazione dell'host accetta solo connessioni dirette autenticate e sicure. Tenta di usare una connessione diretta e si arresta se non riesce a connettersi.
Inoltro La sessione di collaborazione dell'host non consente connessioni dirette. Nessuna porta aperta nel computer dell'host. Si connette sempre tramite il cloud.

Per modificare la modalità:

VS:

  1. Passare a Strumenti > Opzioni > Live Share.
  2. Selezionare la modalità dall'elenco a discesa "modalità Connessione".
  3. Riavviare Visual Studio.

VS Code:

  1. Modifica settings.json (Preferenze > file > Impostazioni).
  2. Impostare "liveshare.connectionMode" su "auto", "direct"o "relay" a seconda delle preferenze.
  3. Riavvia Visual Studio Code.

Requisiti per le modalità di connessione

La modalità di connessione in cui ci si trova determinerà le porte e gli URL specifici che devono essere disponibili per il funzionamento di Live Share.

Modalità Requisito di accesso client Risoluzione dei problemi
Any Accesso in uscita a *.liveshare.vsengsaas.visualstudio.com:443. Assicurarsi che il firewall di rete aziendale o personale consenta di connettersi a questo dominio. Immettere https://visualstudio.microsoft.com/services/live-share/ in un browser e verificare di entrare nella home page di Visual Studio Live Share. È anche possibile che si verifichino problemi del proxy che devono essere risolti.
Any (VS Code) Accesso in uscita a download.microsoft.com:443. Assicurarsi che il firewall di rete aziendale o personale consenta di connettersi a questo dominio. È anche possibile che si verifichino problemi del proxy che devono essere risolti.
Automatica Commutatori automatici. Vedere modalità di inoltro e diretto. Passare alla modalità diretta o di inoltro per risolvere i problemi.
Diretto Host: una porta nell'intervallo da 5990 a 5999 deve essere aperta per accettare connessioni di rete locali in ingresso.

Guest: una route di rete e l'accesso in uscita all'host su questa stessa porta.		 Verificare che "vsls-agent" (per VS), "code" (per Visual Studio Code) o "code - insider" (per Visual Studio Code Insider) non sia bloccato dal software firewall desktop per questo intervallo di porte e che sia possibile effettuare il ping l'uno all'altro. Mentre Windows e altri software desktop devono richiedere la prima volta che l'agente viene avviato, abbiamo visto le istanze in cui i criteri di gruppo impediscono questo verificarsi e sarà necessario aggiungere manualmente la voce. È anche possibile che si verifichino problemi del proxy che devono essere risolti.
Inoltro Accesso in uscita a *.servicebus.windows.net:443. Assicurarsi che il firewall di rete aziendale o personale consenta di connettersi a questo dominio. È anche possibile che si verifichino problemi del proxy che devono essere risolti.
Any Accesso in uscita a *.online.visualstudio.com. Assicurarsi che il firewall di rete aziendale o personale consenta di connettersi a questo dominio. Immettere https://sts.online.visualstudio.com/api/swagger/index.html in un browser e verificare di entrare nella pagina swagger. È anche possibile che si verifichino problemi del proxy che devono essere risolti.

Aggiunta manuale di una voce del firewall

Come descritto in precedenza, la modalità diretta richiede che il firewall personale consenta a vsls-agent, codice o codice- insider di accettare connessioni nell'intervallo di porte 5990-5999. Se si vuole usare la modalità diretta ma si è scoperto che il firewall non dispone di una voce vsls-agent, è possibile aggiungerla manualmente. Le modalità di questa operazione variano in base al software firewall, ma qui è possibile trovare informazioni sulla configurazione di Windows Firewall.

Se non viene visualizzata una voce per vsls-agent, è possibile trovare l'eseguibile dell'agente in uno dei percorsi seguenti.

Percorso di installazione di VS Code

Quando si configura manualmente il firewall per VS Code o VS Code Insider in Windows, MacOS o Linux, usare il percorso di installazione dell'app VS Code.

Ad esempio: Windows (percorso di installazione predefinito)

  • %applocaldata%\Programs\Microsoft VS Code\code.exe
  • %applocaldata%\Programs\Microsoft VS Code Insiders\code - insiders.exe

Posizione dell'agente di Visual Studio

Il percorso di Visual Studio è più dinamico, ma è possibile seguire questa procedura per trovare l'eseguibile:

  1. Passare al percorso di installazione di Visual Studio. Questo è in C:\Program Files (x86)\Microsoft Visual Studio\EDITION genere dove EDITION è Community, Enterprise e così via

  2. Eseguire una ricerca vsls-agent.exe nella sottocartella IDE\Extensions .

Sfortunatamente, potrebbe essere necessario eseguire questo passaggio ogni volta che si aggiorna Visual Studio Live Share.

Proxy

Visual Studio Live Share presenta attualmente alcune limitazioni relative all'uso del proxy. Anche se le impostazioni proxy automatiche devono funzionare in Windows, quando si usa macOS o Linux (e con determinate configurazioni proxy in Windows) le variabili di ambiente HTTP_PROXY e HTTPS_PROXY dovranno essere impostate a livello globale per Visual Studio o nelle impostazioni del proxy di applicazione > per VS Code.

Nota: se il proxy non è configurato nelle impostazioni del proxy di applicazione > di VS Code, verrà ereditato anche dalle variabili di ambiente http_proxy e https_proxy.

Se il proxy non imposta automaticamente questi valori, è possibile impostare manualmente le variabili nel formato seguente:

HTTPS_PROXY=http://proxy-ip-address:proxyport

Se si dispone di un proxy di autenticazione, è possibile aggiungere l'utente e la password come indicato di seguito:

HTTPS_PROXY=http://user:password@proxy-ip-address:proxyport

Se queste impostazioni non risolvono il problema, segnalare le specifiche della configurazione del proxy in modo da poter esaminare il miglioramento del supporto.

Vedi anche

Problemi? Vedere la risoluzione dei problemi o inviare un feedback.