Skip to content

Commit 1bfdc15

Browse files
snehara99TylerMSFTTylerMSFT
authored
Update connect-to-your-remote-linux-computer.md (#5548)
* Learn Editor: Update connect-to-your-remote-linux-computer.md * Learn Editor: Update connect-to-your-remote-linux-computer.md * Learn Editor: Update connect-to-your-remote-linux-computer.md * Learn Editor: Update connect-to-your-remote-linux-computer.md * Learn Editor: Update connect-to-your-remote-linux-computer.md * Learn Editor: Update connect-to-your-remote-linux-computer.md * Learn Editor: Update connect-to-your-remote-linux-computer.md * Update connect-to-your-remote-linux-computer.md edits * Update connect-to-your-remote-linux-computer.md acrolinx fixes * Learn Editor: Update connect-to-your-remote-linux-computer.md * update filenames for graphics --------- Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]>
1 parent 04d0f95 commit 1bfdc15

File tree

4 files changed

+18
-14
lines changed

4 files changed

+18
-14
lines changed

docs/linux/connect-to-your-remote-linux-computer.md

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -64,14 +64,16 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste
6464

6565
1. In the Connection Manager dialog, choose the **Add** button to add a new connection.
6666

67-
:::image type="content" source="media/settings_connectionmanager.png" alt-text="Screenshot of the Visual Studio options pane. CrossPlatform > C++ > Connection Manager is selected and the Add button is highlighted.":::
68-
69-
In either scenario, the **Connect to Remote System** window is displayed.
70-
71-
:::image type="content" source="media/connect.png" alt-text="Screenshot of the Visual Studio Connect to Remote System window.":::
72-
There are fields for host name, port, user name, authentication type, and password. Port is set to 22. Authentication type is set to 'Password'.
67+
:::image type="complex" source="media/connect-to-your-remote-linux-computer/settings-connection-manager-updated.png" alt-text="Screenshot of the Visual Studio options pane.":::
68+
In the options pane, CrossPlatform > C++ > Connection Manager is selected and the Add button is highlighted.
7369
:::image-end:::
7470

71+
To edit an existing connection, choose **Edit**. In either scenario, the **Connect to Remote System** window is displayed.
72+
73+
:::image type="complex" source="media/connect-to-your-remote-linux-computer/connect-updated.png" alt-text="Screenshot of the Visual Studio Connect to Remote System window.":::
74+
In the Connect to Remote System window, there are fields for host name, port, user name, authentication type, and password. Port is set to 22. Authentication type is set to 'Password'.
75+
:::image-end:::
76+
7577
1. Enter the following information:
7678

7779
| Entry | Description |
@@ -83,22 +85,24 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste
8385
| **Password** | Password for the entered user name |
8486
| **Private key file** | Private key file created for ssh connection |
8587
| **Passphrase** | Passphrase used with private key selected above |
86-
88+
89+
You can't click the **Connect** button until all the required fields are completed and the port is set to an integer between 1 and 65535.
90+
8791
You can use either a password or a key file and passphrase for authentication. For many development scenarios, password authentication is sufficient, but key files are more secure. If you already have a key pair, it's possible to reuse it.
8892

8993
Versions of Visual Studio before 17.10 support EC, RSA, and DSA keys for remote connections. Because of security concerns, RSA and DSA keys are no longer supported in VS 17.10 and later. Only EC keys are currently supported. To create a key pair compatible with the connection manager use the command:
9094
`ssh-keygen -m pem -t ecdsa -f <key-name>`
9195

9296
> [!NOTE]
93-
> If using `ssh-keygen` to create the private key, you must specify the switch `-m pem`, or the key will not be accepted by Visual Studio. If your private key begins with `-----BEGIN OPENSSH PRIVATE KEY-----`, you must convert it with `ssh-keygen -p -f <FILE> -m pem`.
97+
> If using `ssh-keygen` to create the private key, you must specify the switch `-m pem`, or the key will not be accepted by Visual Studio. If your private key begins with `-----BEGIN OPENSSH PRIVATE KEY-----`, you must convert it with `ssh-keygen -p -f <FILE> -m pem`.
9498
9599
1. Choose the **Connect** button to attempt a connection to the remote computer.
96100

97101
If the connection succeeds, Visual Studio configures IntelliSense to use the remote headers. For more information, see [IntelliSense for headers on remote systems](configure-a-linux-project.md#remote_intellisense).
98102

99-
If the connection fails, the entry boxes that need to be changed are outlined in red.
103+
If the connection fails, an info bar with error information appears and the fields that you may need to change are outlined in red.
100104

101-
:::image type="content" source="media/settings_connectionmanagererror.png" alt-text="Screenshot of the Visual Studio Connect to Remote System window. The host name and port fields are outlined in red to indicate incorrect entries.":::
105+
:::image type="content" source="media/connect-to-your-remote-linux-computer/settings-connection-manager-error-updated.png" alt-text="Screenshot of the Visual Studio Connect to Remote System window. The host name and port fields are outlined in red to indicate incorrect entries.":::
102106

103107
If you use key files for authentication, make sure the target machine's SSH server is running and configured properly.
104108

@@ -110,17 +114,17 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste
110114

111115
## Host key verification
112116

113-
In Visual Studio version 16.10 or later, you are asked to verify the server's host key fingerprint whenever Visual Studio connects to a remote system for the first time. You may be familiar with this process if you've used the OpenSSH command-line client or PuTTY before. The fingerprint identifies the server. Visual Studio uses the fingerprint to ensure it's connecting to the intended and trusted server.
117+
In Visual Studio version 16.10 or later, you're asked to verify the server's host key fingerprint whenever Visual Studio connects to a remote system for the first time. You may be familiar with this process if you've used the OpenSSH command-line client or PuTTY before. The fingerprint identifies the server. Visual Studio uses the fingerprint to ensure it's connecting to the intended and trusted server.
114118

115-
The first time Visual Studio establishes a new remote connection, you are asked to accept or deny the host key fingerprint presented by the server. Or, anytime there are changes to a cached fingerprint. You can also verify a fingerprint on demand: select a connection in the Connection Manager and choose **Verify**.
119+
The first time Visual Studio establishes a new remote connection, you're asked to accept or deny the host key fingerprint presented by the server. Or, anytime there are changes to a cached fingerprint. You can also verify a fingerprint on demand: select a connection in the Connection Manager and choose **Verify**.
116120

117-
If you upgrade to Visual Studio 16.10 or later from an older version, it treats any existing remote connections as new connections. You are prompted to accept the host key fingerprint first. Then, Visual Studio establishes a connection and caches the accepted fingerprint.
121+
If you upgrade to Visual Studio 16.10 or later from an older version, it treats any existing remote connections as new connections. You're prompted to accept the host key fingerprint first. Then, Visual Studio establishes a connection and caches the accepted fingerprint.
118122

119123
You can also update remote connections from `ConnectionManager.exe` using the `update` argument.
120124

121125
## Supported SSH algorithms
122126

123-
Starting in Visual Studio version 16.9, support for older, insecure SSH algorithms used to encrypt data and exchange keys, has been removed. Only the following algorithms are supported. They're supported for both client-to-server and server-to-client SSH communication:
127+
Starting in Visual Studio version 16.9, support for older, insecure SSH algorithms used to encrypt data and exchange keys is removed. Only the following algorithms are supported. They're supported for both client-to-server and server-to-client SSH communication:
124128

125129
| Algorithm type | Supported algorithms |
126130
|--|--|
13.8 KB
Loading
16.6 KB
Loading
62.5 KB
Loading

0 commit comments

Comments
 (0)