Requisitos de conectividade do Live Share

Este artigo resume os requisitos de conectividade para o Visual Studio Live Share, opções de conectividade disponíveis e soluções alternativas conhecidas, quando aplicável.

Entrar

Você pode entrar no Live Share usando qualquer conta corporativa ou de estudante apoiada pelo Active Directory do Azure, uma conta da Microsoft ou um perfil do GitHub. Normalmente, as URLs de entrada para eles estão abertas na maioria das organizações, dado o número de produtos voltados para o público que os usam, mas, se não, entre em contato com o administrador da rede sobre a login.microsoftonline.com abertura e/ou github.com adição aos domínios listados abaixo.

Observação

As contas do AD local (ADFS) e as contas do GitHub Enterprise no local não são suportadas atualmente (up-vote 👍).

Modos de conexão

Para garantir o desempenho ideal, por padrão, o Visual Studio Live Share detecta automaticamente se uma máquina host de sessão de colaboração e uma máquina convidada podem se comunicar diretamente por uma rede e só retransmite por meio da nuvem se não houver rota entre elas. Este modo "automático" misto é flexível e até permite que alguns convidados retransmitam através da nuvem, enquanto outros se conectam diretamente para a mesma sessão.

As conexões diretas são autenticadas por meio de um mecanismo baseado em nuvem para garantir a segurança, mas exigem que uma porta entre 5990 e 5999 seja aberta para habilitar a conectividade. Como resultado, ao compartilhar pela primeira vez, o firewall da área de trabalho pode solicitar que você abra uma porta. Aceitar isso é opcional, pois ignorá-lo simplesmente fará com que o Live Share sempre use o relé quando estiver no modo automático.

Todas as conexões no Visual Studio Live Share são criptografadas SSH ou SSL e autenticadas em um serviço central para garantir que apenas aqueles na sessão de colaboração possam obter acesso ao seu conteúdo. Além disso, o revezamento em nuvem do Live Share não persiste nenhum tráfego roteado por ele e não "bisbilhota" o tráfego de forma alguma.

Como alterar o modo de conexão

Se preferir desativar conexões diretas ou retransmitidas ou estiver simplesmente solucionando problemas de conectividade, você pode forçar outros modos de conexão.

Modo Comportamento do host Comportamento do hóspede
Auto A sessão de colaboração do host aceita conexões diretas seguras e autenticadas ou conexões retransmitidas na nuvem. Tenta usar uma conexão direta e volta a retransmitir através da nuvem se isso falhar.
Direto A sessão de colaboração do host só aceita conexões diretas autenticadas e seguras. Tenta usar uma conexão direta e pára se não puder se conectar.
Retransmissão A sessão de colaboração do host não permite conexões diretas. Nenhuma porta é aberta na máquina do host. Sempre se conecta via nuvem.

Para alterar o modo:

VS:

  1. Vá para Opções > de ferramentas > Live Share.
  2. Selecione o modo na lista suspensa "Modo de conexão".
  3. Reinicie o VS.

Código VS:

  1. Edite settings.json (Configurações de preferências > de arquivo>).
  2. Defina "liveshare.connectionMode" como "auto", "direct"ou "relay" dependendo da sua preferência.
  3. Reinicie o VS Code.

Requisitos para modos de conexão

O modo de conexão em que você está ditará as portas e URLs específicas que precisam estar disponíveis para o Live Share funcionar.

Modo Requisito de acesso para cliente Solução de problemas
Qualquer Acesso de saída ao *.liveshare.vsengsaas.visualstudio.com:443. Verifique se o firewall da rede corporativa ou pessoal permite que você se conecte a esse domínio. Entre https://visualstudio.microsoft.com/services/live-share/ em um navegador e verifique se você acessa a home page do Visual Studio Live Share. Você também pode estar enfrentando problemas de proxy que precisam ser resolvidos.
Qualquer (VS Code) Acesso de saída ao download.microsoft.com:443. Verifique se o firewall da rede corporativa ou pessoal permite que você se conecte a esse domínio. Você também pode estar enfrentando problemas de proxy que precisam ser resolvidos.
Auto Comutadores automáticos. Veja os modos direto e de retransmissão. Alterne para o modo direto ou de retransmissão para solucionar problemas.
Direto Hosts: Uma porta no intervalo 5990 - 5999 precisa ser aberta para aceitar conexões de rede local de entrada.

Convidados: Uma rota de rede e acesso de saída ao host nesta mesma porta.
Verifique se "vsls-agent" (para VS), "código" (para Visual Studio Code) ou "code - insiders" (para Visual Studio Code Insiders) não está bloqueado pelo software de firewall da área de trabalho para esse intervalo de portas e se você pode executar ping uns aos outros. Embora o Windows e outros softwares de desktop devam avisá-lo na primeira vez que o agente for iniciado, vimos casos em que as políticas de grupo impedem que isso aconteça e você precisará adicionar manualmente a entrada. Você também pode estar enfrentando problemas de proxy que precisam ser resolvidos.
Retransmissão Acesso de saída ao *.servicebus.windows.net:443. Verifique se o firewall da rede corporativa ou pessoal permite que você se conecte a esse domínio. Você também pode estar enfrentando problemas de proxy que precisam ser resolvidos.
Qualquer Acesso de saída ao *.online.visualstudio.com. Verifique se o firewall da rede corporativa ou pessoal permite que você se conecte a esse domínio. Entre https://sts.online.visualstudio.com/api/swagger/index.html em um navegador e verifique se você pousa na página swagger. Você também pode estar enfrentando problemas de proxy que precisam ser resolvidos.

Adicionando manualmente uma entrada de firewall

Como descrito acima, o modo direto requer que seu firewall pessoal permita que vsls-agent, code ou code - insiders aceitem conexões no intervalo de portas 5990-5999. Se você quiser usar o modo direto, mas descobriu que seu firewall não tem entrada vsls-agent, você pode adicioná-lo manualmente. A forma como você faz isso varia de acordo com o software de firewall, mas você pode encontrar informações sobre como configurar o Firewall do Windows aqui.

Se você não vir uma entrada para vsls-agent, poderá encontrar o executável do agente em um dos seguintes locais.

Local de instalação do VS Code

Ao configurar o firewall manualmente para VS Code ou VS Code Insiders no Windows, MacOS ou Linux, use o caminho para o local de instalação do aplicativo VS Code.

Ex: Windows (local de instalação padrão)

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

Local do agente do Visual Studio

O local do Visual Studio é mais dinâmico, mas você pode seguir estas etapas para localizar o executável:

  1. Navegue até o local de instalação do Visual Studio. Isto é tipicamente C:\Program Files (x86)\Microsoft Visual Studio\EDITION onde EDITION é Community, Enterprise, etc

  2. Execute uma pesquisa vsls-agent.exe na subpasta IDE\Extensões .

Infelizmente, talvez seja necessário executar essa etapa sempre que atualizar o Visual Studio Live Share.

Proxies

Atualmente, o Visual Studio Live Share tem algumas limitações em relação ao uso de proxy. Embora as configurações automáticas de proxy devam funcionar no Windows, ao usar o macOS ou Linux (e com determinadas configurações de proxy no Windows), as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY precisarão ser definidas globalmente para VS ou nas configurações de Proxy de Aplicativo > para VS Code.

Nota: se o proxy não estiver configurado nas configurações do Proxy de Aplicativo do VS Code, ele também será herdado das variáveis de > ambiente http_proxy e https_proxy.

Se o proxy não defini-los automaticamente para você, você poderá definir manualmente as variáveis da seguinte forma:

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

Se você tiver um proxy de autenticação, poderá adicionar seu usuário e senha da seguinte maneira:

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

Se essas configurações não resolverem o problema para você, informe-nos sobre as especificidades de sua configuração de proxy para que possamos dar uma olhada na melhoria do suporte.

Confira também

Está tendo problemas? Confira Solução de problemas ou envie comentários.