> For the complete documentation index, see [llms.txt](https://docs.ccv.brown.edu/oscar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ccv.brown.edu/oscar/connecting-to-oscar/remote-ide/from-non-compliant-networks-2-fa.md).

# From Non-compliant Networks (2-FA)

Accessing VSCode from Non-Brown compliant networks

{% hint style="info" %}
This guide is only for users connecting from Non-Brown Compliant Networks. 2-FA is mandatory.
{% endhint %}

1. Install the [Remote Development extension pack](https://aka.ms/vscode-remote/download/extension) 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](https://4272811953-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWJ6pKCQH6l3rl9IQa%2F-Mfc9K3hESjQmkr6wjSm%2F-MfcEEm-c6-L5-T4WZZ6%2FScreen%20Shot%202021-07-27%20at%209.52.23%20AM.png?alt=media\&token=5aa9b4a7-6f9f-4c55-8cc3-df507c6e695b)
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](https://4272811953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWJ6pKCQH6l3rl9IQa%2Fuploads%2FqdVmbkMGoyffoWdnjvsX%2FScreen%20Shot%202022-03-28%20at%209.15.51%20AM.png?alt=media\&token=aa9cf9a6-0e86-4107-bb90-4960cacf048c)
4. Edit the `~/.ssh/config` file on your local machine, add the following lines. Replace `<username>` with your Oscar username.

   ```console
   # 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](https://4272811953-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWJ6pKCQH6l3rl9IQa%2F-Mj4momcqp0OE776MVEI%2F-Mj4nSLSBBnJMYZ3zLaP%2FScreen%20Shot%202021-09-08%20at%2010.24.42%20AM.png?alt=media\&token=83e0b8f4-94b6-4881-925a-633a7d397d07)

   <figure><img src="https://4272811953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWJ6pKCQH6l3rl9IQa%2Fuploads%2FTnvWX1c1mYK9XoAb1p7Q%2Fvscode_setup.png?alt=media&amp;token=1534f050-017d-4b41-bc6f-72b76065e9b8" alt="select vscode node"><figcaption></figcaption></figure>
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.

   <figure><img src="https://4272811953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWJ6pKCQH6l3rl9IQa%2Fuploads%2F8lPkCTIBVye62qyunPdM%2Fimage.png?alt=media&amp;token=21528fa5-77dc-40a5-8043-a9040e1aec0d" alt="Enter your Brown password and confirm access"><figcaption></figcaption></figure>