Regulated Research, How to Connect to a Virtual Machine in the Regulated Research Enclave

In order to connect to a Virtual Machine hosted by the Regulated Research Enclave, you have to follow the attached steps for the operating system of the machine you will be using to access the VM.

Windows

  1. First you must install the Windows App. You can do so from the Microsoft Store at this link: https://apps.microsoft.com/detail/9N1F85V9T8BN?hl=en-us&gl=US&ocid=pdpshare

    Screenshot of the Windows Store navigated to the Windows App that is used to connect to Virtual Machines

  2. Once installed, launch the Windows App

    Screenshot of the sign in page on the Windows app that shows up to first time users

  3. Select Sign in and enter your Enclave credentials, providing MFA as needed. You will then be brought to the resources page

    Screenshot of the Windows App Devices page which lists virtual machines available for users to connect to

  4. To launch a Virtual Machine, select the Connect icon on the resource in the image above and wait for the connection to commence

MacOS

  1. Download the Windows App from the Mac App store: https://apps.apple.com/us/app/windows-app/id1295203466?mt=12

    Screenshot of Mac desktop where the App Store is navigated to the Windows App for Mac OS

  2. Once you have installed the Windows app and opened it, press the plus (+) icon in the top right and select Add a workspace

    Screenshot of the Windows App home screen for users who are not signed in or who have never connected before

  3. In the dialog box that opens, enter the following url: https://rdweb.wvd.azure.us/api/arm/feeddiscovery

    Screenshot of the Windows App "Add workspace" pane where the user points the app to the GCCH endpoint

  4. Then press Done and authenticate with your Enclave credentials

    If you are prompted Yes/No whether you want to allow the machine to connect using your account, select Yes

    Screenshot of the Microsoft Online login page that shows up when the user tries to authenticate to the tenant

  5. You should then be brought to the device home screen that looks something like this:

    Screenshot of the MacOS Windows App that has all the virtual machines available for a user to connect to

  6. To open a machine, double-click its box and then pay attention to the status box that opens. The machine will open in a new window.

    Screenshot of the loading experience when connecting to a virtual machine


Keywords:
Regulated Research, Enclave, VM, Windows App 
Doc ID:
155928
Owned by:
Drew B. in University of Illinois Technology Services
Created:
2025-10-23
Updated:
2025-11-13
Sites:
University of Illinois Technology Services