This document details what tools are available behind our SOCKS proxy and how to configure access to those tools.
What can I access?
Here are some of the tools you may need access to that are behind the SOCKS proxy:
Jenkins for build logs and details (linked to from GitHub PRs for each project).
Sentry for exception reports and tracebacks.
Grafana/Loki for system metrics and logs for diagnostic/troubleshooting purposes.
For more information on these tools, see Tools Overview in our Request access to tools docs.
How can I set up access?
If you get a 404 even after you've signed in, contact your team lead to get access. If you still need help, reach out to Infrastructure in #vfs-platform-support. You cannot proceed without this access.
Ensure you have a GitHub Personal Access Token (with at least “repo” scope permissions). If you have
gitconfigured already, you can skip this step.
You will use this as your GitHub password when prompted. (As of August 2021, your GitHub password won't work here.)
Follow the three processes below for configuring your Mac, Linux, or Windows machine.
Configuring access on Mac
🎦 Watching the instructional video below first (5m 47s) is recommended.
Open Terminal from your Application's Utilities folder.
If you're on Windows, this is the Ubuntu window you just opened.
Within the Terminal, run
sudo gem install vtkand enter your system password if prompted.
vtk socks setupand follow the prompts.
This command will guide you through installing Homebrew, downloading the correct configuration, setting up your key, creating an access request, and configuring your system to access our SOCKS-secured tools.
If you do not have a VA key, it will prompt you to create one. Adding a passphrase here is recommended. It will copy the key to your clipboard for you. Upon creation, it will open a SOCKS Access Request issue where you'll paste your key and submit the issue. You'll need to re-run
vtk socks setupwhen your key is approved.
Please see the paragraph at the bottom, “Additional notes on setup,” if you have any questions.
Configuring access on Linux
🎦 Watching the instructional video below first (5m 47s) is recommended. There's a Ubuntu demo at the end of the video.
Install ruby by running
sudo apt update && sudo apt install ruby.
If you already have a version of ruby installed, you can skip this step.
Follow the instructions in the process above, “Configuring access on Mac.”
Configuring access on Windows
🎦 Watching the instructional video below first (4m 45s) is recommended.
Enable WSL and reboot.
In Windows Search, search "features" and open "Turn Windows features on or off".
Enable "Windows Subsystem for Linux" and click "OK". It will ask you to reboot.
Install and open Ubuntu.
In Windows Search, search "store" and open "Microsoft Store".
In Microsoft Store, search "Ubuntu" and click "Ubuntu 20.04 LTS".
Click the "Install" or "Get" button.
You do not need to login if prompted. It may take a moment for the download to begin.
Once the download is finished, in Windows Search, search and open "Ubuntu".
On first open, it will ask you to create a user/password.
Follow the instructions in the process above, “Configuring access on Linux.”
Additional notes on setup
If you receive any errors regarding version issues, make sure that your system is up-to-date in System Preferences.
If you need to re-copy your key, you can run
vtk socks setupagain and it will prompt you to copy it when the SSH test fails.