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/bastion/connect-native-client-windows.md
+24-23Lines changed: 24 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,29 +6,28 @@ services: bastion
6
6
author: cherylmc
7
7
ms.service: bastion
8
8
ms.topic: how-to
9
-
ms.date: 03/17/2022
9
+
ms.date: 09/09/2022
10
10
ms.author: cherylmc
11
-
ms.custom: ignite-fall-2021
12
11
---
13
12
14
13
# Connect to a VM using a native client
15
14
16
15
This article helps you configure your Bastion deployment, and then connect to a VM in the VNet using the native client (SSH or RDP) on your local computer. The native client feature lets you connect to your target VMs via Bastion using Azure CLI, and expands your sign-in options to include local SSH key pair and Azure Active Directory (Azure AD). Additionally with this feature, you can now also upload or download files, depending on the connection type and client.
17
16
18
-
Your capabilities on the VM when connecting via a native client are dependent on what is enabled on the native client. Controlling access to features such as file transfer via Bastion isn't supported.
17
+
Your capabilities on the VM when connecting via native client are dependent on what is enabled on the native client. Controlling access to features such as file transfer via Bastion isn't supported.
19
18
20
19
> [!NOTE]
21
20
> This configuration requires the Standard SKU tier for Azure Bastion.
22
21
23
-
There are two different sets of connection instructions.
22
+
After you deploy this feature, there are two different sets of connection instructions.
24
23
25
-
* Connect to a VM from the [native client on a Windows local computer](#connect). This lets you do the following:
24
+
*[Connect to a VM from the native client on a Windows local computer](#connect). This lets you do the following:
26
25
27
26
* Connect using SSH or RDP.
28
27
*[Upload and download files](vm-upload-download-native.md#rdp) over RDP.
29
28
* If you want to connect using SSH and need to upload files to your target VM, use the **az network bastion tunnel** command instead.
30
29
31
-
* Connect to a VM using the [**az network bastion tunnel** command](#connect-tunnel). This lets you do the following:
30
+
*[Connect to a VM using the **az network bastion tunnel** command](#connect-tunnel). This lets you do the following:
32
31
33
32
* Use native clients on *non*-Windows local computers (example: a Linux PC).
34
33
* Use the native client of your choice. (This includes the Windows native client.)
@@ -53,35 +52,37 @@ Before you begin, verify that you have the following prerequisites:
53
52
*[Configure your Windows VM to be Azure AD-joined](../active-directory/devices/concept-azure-ad-join.md).
54
53
*[Configure your Windows VM to be hybrid Azure AD-joined](../active-directory/devices/concept-azure-ad-join-hybrid.md).
55
54
56
-
## <aname="configure"></a>Configure Bastion
55
+
## <aname="configure"></a>Configure the native client support feature
57
56
58
-
You can either [modify an existing Bastion deployment](#modify-host), or [deploy Bastion](#configure-new) to a virtual network.
57
+
You can configure this feature by either modifying an existing Bastion deployment, or you can deploy Bastion with the feature configuration already specified.
59
58
60
-
### <aname="modify-host"></a>To modify an existing Bastion deployment
59
+
### To modify an existing Bastion deployment
61
60
62
-
If you have already deployed Bastion to your VNet, modify the following configuration settings:
61
+
If you've already deployed Bastion to your VNet, modify the following configuration settings:
63
62
64
-
1. Navigate to the **Configuration** page for your Bastion resource. Verify that the SKU is **Standard**. If it isn't, change it to **Standard** from the dropdown.
65
-
1.Check the box for **Native Client Support** and apply your changes.
63
+
1. Navigate to the **Configuration** page for your Bastion resource. Verify that the SKU Tier is **Standard**. If it isn't, select **Standard**.
64
+
1.Select the box for **Native Client Support**, then apply your changes.
66
65
67
-
:::image type="content" source="./media/connect-native-client-windows/update-host.png" alt-text="Settings for updating an existing host with Native Client Support box selected." lightbox="./media/connect-native-client-windows/update-host-expand.png":::
66
+
:::image type="content" source="./media/connect-native-client-windows/update-host.png" alt-text="Screenshot that shows settings for updating an existing host with Native Client Support box selected." lightbox="./media/connect-native-client-windows/update-host.png":::
68
67
69
-
### <aname="configure-new"></a>To deploy Bastion to a VNet
68
+
### To deploy Bastion with the native client feature
70
69
71
-
If you haven't already deployed Bastion to your VNet, [deploy Bastion](tutorial-create-host-portal.md#createhost). When configuring Bastion, specify the following settings:
70
+
If you haven't already deployed Bastion to your VNet, you can deploy with the native client feature specified by deploying Bastion using manual settings. For steps, see [Tutorial - Deploy Bastion with manual settings](tutorial-create-host-portal.md#createhost). When you deploy Bastion, specify the following settings:
72
71
73
-
1. On the **Basics** tab, for **Instance Details -> Tier** select **Standard** to deploy Bastion using the Standard SKU.
72
+
1. On the **Basics** tab, for **Instance Details -> Tier** select **Standard**. Native client support requires the Standard SKU.
74
73
75
74
:::image type="content" source="./media/connect-native-client-windows/standard.png" alt-text="Settings for a new bastion host with Standard SKU selected." lightbox="./media/connect-native-client-windows/standard.png":::
76
-
1.On the **Advanced** tab, check the box for **Native Client Support**.
75
+
1.Before you create the bastion host, go to the **Advanced** tab and check the box for **Native Client Support**, along with the checkboxes for any other additional features that you want to deploy.
77
76
78
-
:::image type="content" source="./media/connect-native-client-windows/new-host.png" alt-text="Settings for a new bastion host with Native Client Support box selected." lightbox="./media/connect-native-client-windows/new-host-expand.png":::
77
+
:::image type="content" source="./media/connect-native-client-windows/new-host.png" alt-text="Screenshot that shows settings for a new bastion host with Native Client Support box selected." lightbox="./media/connect-native-client-windows/new-host.png":::
78
+
79
+
1. Click **Review + create** to validate, then click **Create** to deploy your Bastion host.
79
80
80
81
## <aname="verify"></a>Verify roles and ports
81
82
82
-
Verify that the following roles and ports are configured in order to connect.
83
+
Verify that the following roles and ports are configured in order to connect to the VM.
83
84
84
-
### <aname="roles"></a>Required roles
85
+
### Required roles
85
86
86
87
* Reader role on the virtual machine.
87
88
* Reader role on the NIC with private IP of the virtual machine.
@@ -105,7 +106,7 @@ To connect to a Windows VM using native client support, you must have the follow
105
106
106
107
To learn about how to best configure NSGs with Azure Bastion, see [Working with NSG access and Azure Bastion](bastion-nsg.md).
107
108
108
-
## <aname="connect"></a>Connect - Windows native client
109
+
## <aname="connect"></a>Connect to VM - Windows native client
109
110
110
111
This section helps you connect to your virtual machine from the native client on a local Windows computer. If you want to upload and download files after connecting, you must use an RDP connection. For more information about file transfers, see [Upload or download files](vm-upload-download-native.md).
111
112
@@ -135,7 +136,7 @@ Use the example that corresponds to the type of target VM to which you want to c
135
136
```
136
137
137
138
**SSH:**
138
-
139
+
139
140
The extension can be installed by running, ```az extension add --name ssh```. To sign in using an SSH key pair, use the following example.
140
141
141
142
```azurecli
@@ -182,7 +183,7 @@ Use the example that corresponds to the type of target VM to which you want to c
182
183
183
184
1. Once you sign in to your target VM, the native client on your computer will open up with your VM session; **MSTSC** for RDP sessions, and **SSH CLI extension (az ssh)** for SSH sessions.
184
185
185
-
## <a name="connect-tunnel"></a>Connect - other native clients
186
+
## <a name="connect-tunnel"></a>Connect to VM - other native clients
186
187
187
188
This section helps you connect to your virtual machine from native clients on *non*-Windows local computers (example: a Linux PC) using the **az network bastion tunnel** command. You can also connect using this method from a Windows computer. This is helpful when you require an SSH connection and want to upload files to your VM.
0 commit comments