From Non-compliant Networks (2-FA)

Accessing VSCode from Non-Brown compliant networks

This guide is only for users connecting from Non-Brown Compliant Networks. 2-FA is mandatory.

1. Install the Remote Development extension pack for VSCode

2. Open VSCode settings

   • On Windows/Linux - File > Preferences > Settings

   • On macOS - Code > Preferences > Settings

   Search for symlink and make sure the symlink searching is unchecked

   

   VSCode settings with symlink searching unchecked
3. Under VSCode settings, search for remote ssh timeout and manually enter a timeout value i.e. 50s. It should give you enough time to complete 2-Factor Authentication.

   

   VSCode settings showing remote SSH timeout value
4. Edit the ~/.ssh/config file on your local machine, add the following lines. Replace <username> with your Oscar username.

   # Jump box with public IP address
   Host jump-box
     HostName ssh.ccv.brown.edu
     User <username>
   # Target machine with private IP address
   Host ccv-vscode-node
     HostName vscode1
     User <username>
     ProxyCommand ssh -q -W %h:%p jump-box

5. In VSCode, select Remote-SSH: Connect to Host… and after the list populates select ccv-vscode-node

   

   VSCode Remote-SSH connect to host dialog

   
6. When prompted in VSCode, please enter your Brown password and complete the DUO authentication. After that, wait about 30 seconds and VSCode should connect to Oscar.