Exigences de connectivité pour Live Share

  • Article

Cet article récapitule les exigences de connectivité pour Visual Studio Live Share, les options de connectivité disponibles et les solutions de contournement connues le cas échéant.

Connexion

Vous pouvez vous connecter à Live Share à l’aide de n’importe quel compte professionnel ou scolaire soutenu par Azure Active Directory , d’un compte Microsoft ou d’un profil GitHub. En règle générale, les URL de connexion pour celles-ci sont ouvertes dans la plupart des organisations en fonction du nombre de produits publics qui les utilisent, mais si ce n’est pas le cas, contactez votre administrateur réseau pour l’ouverture login.microsoftonline.com et/ou github.com en plus des domaines répertoriés ci-dessous.

Remarque

Les comptes AD locaux (ADFS) et les comptes GitHub Enterprise locaux ne sont actuellement pas pris en charge (à voix haute👍).

Modes de connexion

Pour garantir des performances optimales, Par défaut, Visual Studio Live Share détecte automatiquement si une machine hôte de session de collaboration et une machine invitée peuvent communiquer directement sur un réseau et uniquement les relais via le cloud s’il n’y a pas d’itinéraire entre eux. Ce mode mixte « auto » est flexible et permet même à certains invités de relayer via le cloud, tandis que d’autres se connectent directement pour la même session.

Les connexions directes sont authentifiées via un mécanisme basé sur le cloud pour garantir la sécurité, mais nécessitent l’ouverture d’un port entre 5990 et 5999 pour permettre la connectivité. Par conséquent, lors du partage pour la première fois que votre pare-feu de bureau peut vous inviter à ouvrir un port. L’acceptation de ce paramètre est facultative, car elle entraîne simplement l’utilisation de Live Share pour toujours utiliser le relais en mode automatique.

Toutes les connexions dans Visual Studio Live Share sont chiffrées SSH ou SSL et authentifiées auprès d’un service central pour s’assurer que seules celles de la session de collaboration peuvent accéder à son contenu. En outre, le relais cloud de Live Share ne conserve pas le trafic routé vers celui-ci et ne « snoop » pas le trafic de quelque manière que ce soit.

Modification du mode de connexion

Si vous préférez désactiver les connexions directes ou relayées ou résoudre simplement les problèmes de connectivité, vous pouvez forcer d’autres modes de connexion.

Mode Comportement de l’hôte Comportement de l’invité
Automatique La session de collaboration de l’hôte accepte les connexions directes sécurisées, authentifiées ou les connexions relayées dans le cloud. Tente d’utiliser une connexion directe et revient à relayer via le cloud en cas d’échec.
Direct La session de collaboration de l’hôte accepte uniquement les connexions directes authentifiées et sécurisées. Tente d’utiliser une connexion directe et s’arrête si elle ne peut pas se connecter.
Relay La session de collaboration de l’hôte n’autorise pas les connexions directes. Aucun port n’est ouvert sur l’ordinateur de l’hôte. Se connecte toujours via le cloud.

Pour modifier le mode :

VS:

  1. Accédez à Outils > Options > Live Share.
  2. Sélectionnez le mode dans la liste déroulante « Mode de connexion ».
  3. Redémarrez VS.

VS Code :

  1. Modifier settings.json (Paramètres des préférences > de fichier>).
  2. Définissez "liveshare.connectionMode" sur "auto", "direct"ou "relay" en fonction de vos préférences.
  3. Redémarrez VS Code.

Configuration requise pour les modes de connexion

Le mode de connexion dans lequel vous vous trouvez détermine les ports et URL spécifiques qui doivent être disponibles pour que Live Share fonctionne.

Mode Condition requise pour l’accès client Résolution des problèmes
N’importe lequel Accès sortant à *.liveshare.vsengsaas.visualstudio.com:443. Assurez-vous que votre pare-feu réseau professionnel ou personnel vous permet de vous connecter à ce domaine. Entrez dans un navigateur et vérifiez que vous accédez https://visualstudio.microsoft.com/services/live-share/ à la page d’accueil de Visual Studio Live Share. Vous pouvez également rencontrer des problèmes de proxy qui doivent être résolus.
Any (VS Code) Accès sortant à download.microsoft.com:443. Assurez-vous que votre pare-feu réseau professionnel ou personnel vous permet de vous connecter à ce domaine. Vous pouvez également rencontrer des problèmes de proxy qui doivent être résolus.
Automatique Commutateurs automatiques. Voir les modes direct et relais. Basculez vers le mode direct ou relais pour résoudre les problèmes.
Direct Hôtes : un port de la plage 5990 - 5999 doit être ouvert pour accepter les connexions de réseau local entrant.

Invités : un itinéraire réseau et un accès sortant à l’hôte sur ce même port.		 Vérifiez que « vsls-agent » (pour VS), « code » (pour Visual Studio Code) ou « code - insiders » (pour Visual Studio Code Insiders) n’est pas bloqué par votre logiciel de pare-feu de bureau pour cette plage de ports et que vous pouvez effectuer un test ping un autre. Bien que Windows et d’autres logiciels de bureau vous invitent à démarrer la première fois que l’agent démarre, nous avons vu des instances où les stratégies de groupe empêchent cela et vous devrez ajouter manuellement l’entrée. Vous pouvez également rencontrer des problèmes de proxy qui doivent être résolus.
Relay Accès sortant à *.servicebus.windows.net:443. Assurez-vous que votre pare-feu réseau professionnel ou personnel vous permet de vous connecter à ce domaine. Vous pouvez également rencontrer des problèmes de proxy qui doivent être résolus.
N’importe lequel Accès sortant à *.online.visualstudio.com. Assurez-vous que votre pare-feu réseau professionnel ou personnel vous permet de vous connecter à ce domaine. Entrez dans un navigateur et vérifiez que vous accédez https://sts.online.visualstudio.com/api/swagger/index.html à la page swagger. Vous pouvez également rencontrer des problèmes de proxy qui doivent être résolus.

Ajout manuel d’une entrée de pare-feu

Comme indiqué ci-dessus, le mode direct nécessite que votre pare-feu personnel autorise vsls-agent, code ou code - insiders à accepter les connexions dans la plage de ports 5990-5999. Si vous souhaitez utiliser le mode direct, mais que votre pare-feu n’a pas d’entrée vsls-agent, vous pouvez l’ajouter manuellement. La façon dont vous procédez varie en fonction des logiciels de pare-feu, mais vous trouverez des informations sur la configuration du Pare-feu Windows ici.

Si vous ne voyez pas d’entrée pour vsls-agent, vous pouvez trouver l’exécutable de l’agent dans l’un des emplacements suivants.

Emplacement d’installation de VS Code

Lors de la configuration manuelle du pare-feu pour VS Code ou VS Code Insiders sur Windows, MacOS ou Linux, utilisez le chemin d’accès à l’emplacement d’installation de l’application VS Code.

Ex : Windows (emplacement d’installation par défaut)

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

Emplacement de l’agent Visual Studio

L’emplacement Visual Studio est plus dynamique, mais vous pouvez suivre ces étapes pour rechercher l’exécutable :

  1. Accédez à votre emplacement d’installation de Visual Studio. C’est généralement C:\Program Files (x86)\Microsoft Visual Studio\EDITION là que EDITION est Community, Enterprise, etc.

  2. Exécutez une recherche vsls-agent.exe dans le sous-dossier IDE\Extensions .

Malheureusement, vous devrez peut-être effectuer cette étape chaque fois que vous mettez à jour Visual Studio Live Share.

Proxies

Visual Studio Live Share présente actuellement certaines limitations relatives à l’utilisation du proxy. Bien que les paramètres de proxy automatique fonctionnent sur Windows, lorsque vous utilisez macOS ou Linux (et avec certaines configurations proxy sur Windows), les variables d’environnement HTTP_PROXY et HTTPS_PROXY doivent être définies globalement pour VS ou dans les paramètres du proxy d’application > pour VS Code.

Remarque : si le proxy n’est pas configuré dans les paramètres du proxy d’application > de VS Code, il est également hérité des variables d’environnement http_proxy et https_proxy.

Si votre proxy ne les définit pas automatiquement, vous pouvez définir manuellement les variables sous la forme suivante :

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

Si vous disposez d’un proxy d’authentification, vous pouvez ajouter votre utilisateur et votre mot de passe comme suit :

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

Si ces paramètres ne résolvent pas le problème pour vous, veuillez nous informer des spécificités de votre configuration de proxy afin que nous puissions examiner l’amélioration de la prise en charge.

Voir aussi

Vous rencontrez des problèmes ? Voir la section dépannage ou fournir des commentaires.