Skip to main content

Reference article(4) Connect to Your Tehama Virtual Desktop for End-users

  • Updated

(4) Connect to Your Tehama Virtual Desktop for End-users

This is the fourth of the four onboarding steps for Tehama end-users.

This step tells you how to connect to your Tehama virtual desktop.

4.1 Connecting to Tehama’s AWS desktops (AWS Enclave)

 

Steps to connect

From your physical computer, the one you installed the Tehama Client on:

  1. Log in to your corporate Tehama Portal (on one of the supported browsers).

     
  2. Click on the DESKTOPS tab in the navigation bar. You will see the DESKTOPS page.

     
  3. Locate the desktop you wish to connect to in the list of desktops on the page.

    Most end-users will have just one desktop assigned to them. If you have more than one and are uncertain of the purpose of each, talk to your employer.

     
  4. Click on the CONNECT button for your desktop. The PREPARING YOUR DESKTOP dialog will appear. Your desktop is waking up and getting ready to be launched.

    NOTE: if your desktop's Tehama Enclave has a policy assigned to it, you will be asked to accept it, if you have not done so already. Click on the name of the Enclave in the desktop's entry and click on the I ACCEPT button. Then return to the DESKTOPS page and start connecting again.


 

  1. Wait until the LAUNCHING YOUR DESKTOP dialog appears.

    At this point, your desktop is launching through the Tehama Client on your device. This may take a number of minutes.

    You will see a message asking you to allow the Tehama application that launches the Desktop to open. You must allow the application to open in order to launch your Desktop.
    • On Mac:
      Message: "Open Tehama.app?".
      Click on Open Tehama.app to allow the app to open.
    • On Linux:
      Message: "Open xdb-open?".
      Click on Open xdb-open to allow the app to open.
    • On Windows:
      Message: "Open Microsoft© Windows Based Script Host".
      Click on Open Microsoft© Windows-based Script Host to allow the app to open.

Optional: Check the box beside the "Always allow <your corporate portal> to open links of this type in the associated app", before clicking on the Open button to permanently allow the application to open without having to see this message again.

 

  1. Wait until your virtual desktop interface appears.

    You will be automatically logged in to your virtual desktop with secure temporary credentials created by Tehama just for this desktop session. The interface to your virtual desktop is displayed to you by the Tehama Client.

4.2.1 Connecting to Tehama’s Azure virtual desktops via Windows App (browser-based, HTML5 in Azure Enclave)

 

Steps to connect


 

This step tells you how to connect to your Tehama Azure virtual desktop.

From your host device using web browsers:

 

  1. 1. Log in to your corporate Tehama portal (on one of the supported browsers).

     
  2. Click on the DESKTOPS tab in the navigation bar. You will see the DESKTOPS page.

     
  3. Locate the desktop you wish to connect to in the list of desktops on the page.

    Most end-users will have just one desktop assigned to them. If you have more than one and are uncertain of the purpose of each, talk to your employer.

     
  4. Click on the CONNECT button for your desktop. You will be directed to the Microsoft Windows App webpage to authenticate:
    1. For Tehama-hosted AVDs: Use your provided @tehama.io credentials to authenticate to the Windows App.
    2. For customer-hosted AVDs: Use your corporate Microsoft account (provided by your employer) to authenticate to the Windows App.

 

  1. Once authenticated to the Windows App, click on the Connect button for your Tehama AVD.

 

  1. You will be prompted to enter your Microsoft credentials again. The virtual desktop will then launch within the browser.

 

4.2.2 Connecting to Tehama’s Azure virtual desktops (AVD) via installed Windows App in Azure Enclave


 

This step tells you how to connect to your Tehama Azure virtual desktop.

From your host device using the installed Windows App:

 

  1. Download the Windows App via Microsoft Store: https://apps.microsoft.com/detail/9n1f85v9t8bn?hl=en-US&gl=US

 

  1. Run the application and authenticate using your Microsoft credentials:
    1. For Tehama-hosted AVDs: Use your provided @tehama.io credentials to authenticate to the Windows App.
    2. For customer-hosted AVDs: Use your corporate Microsoft account (provided by your employer) to authenticate to the Windows App.

 

  1. Click on Devices from the side navigation menu and click on Connect to launch your Tehama Azure virtual desktop.

Welcome to your first Tehama virtual desktop session!


 

Your first desktop session

You are now logged in to your first Tehama virtual desktop session.

For the first few minutes of your session, your desktop is busy behind the scenes establishing a link with the Tehama Enclave your employer set up in Tehama to provide the resources and the access that you need to your company’s private network and/or the internet. (See Enclaves User Guide for more information about Tehama Enclaves.)

Once this link is established, your virtual desktop should be good-to-go.

Troubleshooting

You can find troubleshooting tips for the end-user onboarding process here:

Related articles