Skip to main content

Onboarding Instructions

Basic onboarding instructions for the first set of researchers.

note

Please note that the onboarding procedure is evolving and the snapshots below may differ from what you see. Please reach out if you run into any issues.

Step 1: Accept VISION Invitation​

You will receive an invitation email to set up your account on VISION:

VISION invitation email

Click the link which will open a browser window, then click Log in With SSO:

Log in with SSO screen

Select the correct Identity provider and login:

Select identity provider

Step 2: Email Verification​

You will be redirected back to the VISION account setup page. Click Send Confirmation Code:

Send confirmation code

Check your email to get the confirmation code:

Email confirmation code

Navigate back to the VISION account setup page and fill in the confirmation code:

Enter confirmation code

Step 3: Create SSH Key​

Click on Create a new SSH key:

Create SSH key screen

The comment is optional but I would suggest adding "vision". Click Generate Key Pair:

Generate key pair screen

Download the Private Key by clicking on the Download Private Key button. If your browser gives you the option while downloading, save the private key to $HOME/.ssh/ directory. Otherwise, move the file to $HOME/.ssh/ after downloading.

You will need to confirm that your private key has 600 permissions:

ls -l $HOME/.ssh/id_ed25519_vision

Change the permissions if needed:

chmod 600 $HOME/.ssh/id_ed25519_vision

Download private key screen

Step 4: Setup Duo Account​

Click on Manage Devices:

Manage devices screen

Click on Get started:

Duo get started

Your options will differ depending on your current setup in DUO. Click Duo Mobile:

Select Duo Mobile

Add your phone number:

Add phone number

Confirm your number:

Confirm phone number

Download the Duo Mobile app if you do not already have it. Click Next:

Download Duo Mobile app

There will be a QR Code to finish the setup with your DUO app. Scan the QR code with the DUO app.

After scanning, you will get an Added Duo Mobile confirmation screen. Click Continue:

Duo Mobile added confirmation

Step 5: Setup Cloudflare Warp​

You will now need to set up Cloudflare Warp on your device before you can login to VISION. Visit the link below and select the installer appropriate for your computer:

https://developers.cloudflare.com/cloudflare-one/team-and-resources/devices/warp/download-warp/(opens in new window)

After installing Cloudflare Warp, you should see an icon available for a running service. The location will vary by operating system. The image below is from a Mac.

Click Next:

Cloudflare Warp menu icon

Click Accept:

Cloudflare Warp accept

Click the gear icon:

Cloudflare Warp gear icon

Click on Preferences:

Cloudflare Warp preferences

Click on Account:

Cloudflare Warp account

Type tamucs in the Enter your Team name field:

Enter team name tamucs

You will be directed to the Warp Login App in your default browser. Select the appropriate Institution. Your page may differ in options than the snapshot below:

Warp login select institution

After logging in, you should see a Success! page. If you do not see the Zero Trust window, click the Cloudflare Warp in your menu bar. Click on the toggle under Zero Trust to Connect:

Zero Trust connect toggle

You should now see Connected under the Zero Trust toggle:

Zero Trust connected

Step 6: Configure SSH​

Setup the config file to ssh to VISION. Personalized instructions are available by clicking View Instructions on the account.vision.tamus.edu(opens in new window) page:

View Instructions button

If it doesn't already exist, create a text file named config in $HOME/.ssh/config with the following content. You will need to replace id_institution with your username as shown on the vision account activation page:

Host vision
    Hostname  login.vision.tamus.edu
    User  id_institution
    IdentityFile  ~/.ssh/id_ed25519_vision
    Port  22

Step 7: Connect to VISION​

You should now be able to ssh to VISION using:

ssh vision