You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/devtest-labs/configure-lab-remote-desktop-gateway.md
+14-8Lines changed: 14 additions & 8 deletions
Original file line number
Diff line number
Diff line change
@@ -7,11 +7,17 @@ ms.date: 03/07/2022
7
7
8
8
# Configure and use a remote desktop gateway in Azure DevTest Labs
9
9
10
-
This article walks through how to use a remote desktop gateway for more secure access to lab virtual machines (VMs) in Azure DevTest Labs. Using the gateway improves security because the VMs' remote desktop protocol (RDP) ports aren't exposed to the internet.
10
+
This article describes how to set up and use a gateway for more secure remote desktop access to lab virtual machines (VMs) in Azure DevTest Labs. Using a gateway improves security because you don't expose the VMs' remote desktop protocol (RDP) ports to the internet.
11
11
12
-
DevTest Labs provides a central place for lab users to view and connect to their VMs. On a Windows VM, you can select **Connect** > **RDP** on a lab VM's **Overview** page to create a machine-specific RDP file, and open the file to connect to the VM. With a remote desktop gateway, lab users connect to their VMs through a gateway machine. Users can authenticate directly to the gateway machine, and can use company credentials on domain-joined machines. DevTest Labs also supports using token authentication to the gateway machine.
12
+
DevTest Labs provides a central place for lab users to view and connect to their VMs. You can select **Connect** > **RDP** on a lab VM's **Overview** page to create a machine-specific RDP file, and open the file to connect to the VM.
13
13
14
-
Another way to securely access lab VMs without exposing the RDP port is through a browser with Azure Bastion. For more information, see [Enable browser connection to DevTest Labs VMs with Azure Bastion](enable-browser-connection-lab-virtual-machines.md).
14
+
With a remote desktop gateway, lab users connect to their VMs through a gateway machine. With a remote desktop gateway, users can:
15
+
16
+
- Authenticate directly to the gateway machine.
17
+
- Use token authentication to the gateway machine.
18
+
- Use company credentials on domain-joined machines.
19
+
20
+
Another way to securely access lab VMs without exposing RDP ports is through a browser with Azure Bastion. For more information, see [Enable browser connection to DevTest Labs VMs with Azure Bastion](enable-browser-connection-lab-virtual-machines.md).
15
21
16
22
## Architecture
17
23
@@ -26,9 +32,9 @@ The following diagram shows how a remote desktop gateway applies token authentic
26
32
```
27
33
28
34
1. The `getRdpFileContents` action invokes `https://{gateway-hostname}/api/host/{lab-machine-name}/port/{port-number}` to request an authentication token.
29
-
-`{gateway-hostname}`, or `{lb-uri}` for a load balancer, is the gateway hostname you specify on the **Lab settings** page for your lab.
30
-
-`{lab-machine-name}` is the name of the VM you want to connect to.
31
-
-`{port-number}` is the port to use for the connection. Usually this port is 3389, but if the lab VM uses a [shared IP](devtest-lab-shared-ip.md), the port is different.
35
+
-`{gateway-hostname}`, or `{lb-uri}` for a load balancer, is the gateway hostname specified on the **Lab settings** page for the lab.
36
+
-`{lab-machine-name}` is the name of the VM to connect to.
37
+
-`{port-number}` is the port to use for the connection. Usually this port is 3389, but if the lab VM uses a [shared IP](devtest-lab-shared-ip.md), the port number is different.
32
38
33
39
1. The remote desktop gateway uses `https://{function-app-uri}/api/host/{lab-machine-name}/port/{port-number}` to defer the call to an Azure Functions function app.
34
40
@@ -47,13 +53,13 @@ When an RDP connection program opens the RDP file, the remote desktop gateway au
47
53
48
54
## Configuration requirements
49
55
50
-
There are a few configuration requirements for gateway machines, domain name services (DNS), and Azure Functions to work with DevTest Labs token authentication.
56
+
For gateway machines, domain name services (DNS), and Azure Functions to work with DevTest Labs token authentication, there are some configuration requirements:
51
57
52
58
### Gateway machine requirements
53
59
54
60
- The gateway machine must have a TLS/SSL certificate installed to handle HTTPS traffic. The certificate must match the fully qualified domain name (FQDN) of the gateway machine if there's only one machine, or the load balancer for a gateway farm. Wild-card TLS/SSL certificates don't work.
55
61
56
-
-Gateway machine(s) must have a signing certificate installed. You can create a signing certificate by using the [Create-SigningCertificate.ps1](https://github.com/Azure/azure-devtestlab/blob/master/samples/DevTestLabs/GatewaySample/tools/Create-SigningCertificate.ps1) PowerShell script.
62
+
-The gateway machine(s) must have a signing certificate installed. You can create a signing certificate by using the [Create-SigningCertificate.ps1](https://github.com/Azure/azure-devtestlab/blob/master/samples/DevTestLabs/GatewaySample/tools/Create-SigningCertificate.ps1) PowerShell script.
57
63
58
64
- The gateway must have a [pluggable authentication module](https://en.wikipedia.org/wiki/Pluggable_authentication_module) that supports token authentication. One example is *RDGatewayFedAuth.msi*, which comes with [System Center Virtual Machine Manager (VMM)](/system-center/vmm/install-console?view=sc-vmm-1807&preserve-view=true) images.
0 commit comments