Skip to content

Commit 684501d

Browse files
authored
Merge pull request #206415 from cherylmc/linux2
Freshness updates and formatting
2 parents e0857e2 + 4916f2f commit 684501d

File tree

1 file changed

+37
-37
lines changed

1 file changed

+37
-37
lines changed

articles/vpn-gateway/point-to-site-vpn-client-cert-linux.md

Lines changed: 37 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,40 @@
11
---
2-
title: 'Configure P2S VPN clients -certificate authentication - Linux (strongSwan)'
2+
title: 'Configure P2S VPN clients -certificate authentication - Linux'
33
titleSuffix: Azure VPN Gateway
4-
description: Learn how to configure the Linux (strongSwan) VPN client solution for VPN Gateway P2S configurations that use certificate authentication. This article applies to Linux (strongSwan).
4+
description: Learn how to configure a Linux VPN client solution for VPN Gateway P2S configurations that use certificate authentication.
55
author: cherylmc
66
ms.service: vpn-gateway
77
ms.topic: how-to
8-
ms.date: 05/18/2022
8+
ms.date: 07/29/2022
99
ms.author: cherylmc
1010
---
1111

12-
# Configure point-to-site VPN clients - certificate authentication - Linux (strongSwan)
12+
# Configure point-to-site VPN clients - certificate authentication - Linux
1313

14-
When you connect to an Azure virtual network (VNet) using point-to-site (P2S) and certificate authentication from a Linux computer, you can use strongSwan. All of the necessary configuration settings for the VPN clients are contained in a VPN client configuration zip file. The settings in the zip file help you easily configure the VPN clients Linux.
14+
When you connect to an Azure virtual network (VNet) using point-to-site (P2S) and certificate authentication from a Linux computer, you can use strongSwan (IKEv2 tunnels) or an OpenVPN client. All of the necessary configuration settings for the VPN clients are contained in a VPN client configuration zip file. The settings in the zip file help you easily configure the VPN clients Linux.
1515

1616
The VPN client configuration files that you generate are specific to the P2S VPN gateway configuration for the virtual network. If there are any changes to the P2S VPN configuration after you generate the files, such as changes to the VPN protocol type or authentication type, you need to generate new VPN client configuration files and apply the new configuration to all of the VPN clients that you want to connect. For more information about P2S connections, see [About point-to-site VPN](point-to-site-about.md).
1717

18-
## <a name="generate"></a>Before you begin
18+
## Before you begin
1919

2020
Before beginning, verify that you are on the correct article. The following table shows the configuration articles available for Azure VPN Gateway P2S VPN clients. Steps differ, depending on the authentication type, tunnel type, and the client OS.
2121

2222
[!INCLUDE [All client articles](../../includes/vpn-gateway-vpn-client-install-articles.md)]
2323

24-
>[!IMPORTANT]
25-
>[!INCLUDE [TLS](../../includes/vpn-gateway-tls-change.md)]
26-
27-
## <a name="strongswan"></a>1. Install strongSwan
28-
29-
The steps in this article use strongSwan.
30-
31-
[!INCLUDE [Install strongSwan](../../includes/vpn-gateway-strongswan-install-include.md)]
32-
33-
## <a name="certificates"></a>2. Install certificates
34-
35-
A client certificate is required for authentication when using the Azure certificate authentication type. A client certificate must be installed on each client computer. The exported client certificate must be exported with the private key, and must contain all certificates in the certification path. Make sure that the client computer has the appropriate client certificate installed before proceeding to the next section.
36-
37-
For information about client certificates, see [Generate certificates - Linux](vpn-gateway-certificates-point-to-site-linux.md).
38-
39-
## <a name="generate"></a>3. Generate VPN client configuration files
24+
## Generate VPN client configuration files
4025

4126
You can generate client configuration files using PowerShell, or by using the Azure portal. Either method returns the same zip file.
4227

43-
### <a name="portal"></a>Generate profile config files using the Azure portal
28+
### Generate files using the Azure portal
4429

4530
1. In the Azure portal, navigate to the virtual network gateway for the virtual network that you want to connect to.
4631
1. On the virtual network gateway page, select **Point-to-site configuration** to open the Point-to-site configuration page.
4732
1. At the top of the Point-to-site configuration page, select **Download VPN client**. This doesn't download VPN client software, it generates the configuration package used to configure VPN clients. It takes a few minutes for the client configuration package to generate. During this time, you may not see any indications until the packet has generated.
4833

49-
:::image type="content" source="./media/point-to-site-vpn-client-cert-linux/download-configuration.png" alt-text="Download the VPN client configuration." lightbox="./media/point-to-site-vpn-client-cert-linux/download-configuration.png":::
34+
:::image type="content" source="./media/point-to-site-vpn-client-cert-mac/download-configuration.png" alt-text="Download the VPN client configuration." lightbox="./media/point-to-site-vpn-client-cert-mac/download-configuration.png":::
5035
1. Once the configuration package has been generated, your browser indicates that a client configuration zip file is available. It's named the same name as your gateway.
5136

52-
### <a name="powershell"></a>Generate profile config files using PowerShell
37+
### Generate files using PowerShell
5338

5439
1. When generating VPN client configuration files, the value for '-AuthenticationMethod' is 'EapTls'. Generate the VPN client configuration files using the following command:
5540

@@ -61,23 +46,33 @@ You can generate client configuration files using PowerShell, or by using the Az
6146

6247
1. Copy the URL to your browser to download the zip file.
6348

64-
## 4. View the folder and files
49+
### View the folder and files
6550

6651
Unzip the file to view the following folders:
6752

6853
* **WindowsAmd64** and **WindowsX86**, which contain the Windows 32-bit and 64-bit installer packages, respectively. The **WindowsAmd64** installer package is for all supported 64-bit Windows clients, not just Amd.
6954
* **Generic**, which contains general information used to create your own VPN client configuration. The Generic folder is provided if IKEv2 or SSTP+IKEv2 was configured on the gateway. If only SSTP is configured, then the Generic folder isn’t present.
7055

71-
## 5. Select the configuration instructions
56+
## Select the configuration instructions
7257

7358
The sections below contain instructions to help you configure your VPN client. Select the tunnel type that your P2S configuration uses, then select the method that you want to use to configure.
7459

75-
* [IKEv2 tunnel type steps](#ike)
76-
* [OpenVPN tunnel type steps](#openvpn)
60+
* [IKEv2 tunnel type steps](#ike) for strongSwan
61+
* [OpenVPN tunnel type steps](#openvpn) for OpenVPN client
7762

78-
## <a name="ike"></a>IKEv2 tunnel type steps
63+
## <a name="ike"></a>IKEv2 - strongSwan steps
7964

80-
This section helps you configure Linux clients for certificate authentication that uses the IKEv2 tunnel type. To connect to Azure, you manually configure an IKEv2 VPN client.
65+
### Install strongSwan
66+
67+
[!INCLUDE [Install strongSwan](../../includes/vpn-gateway-strongswan-install-include.md)]
68+
69+
### Install certificates
70+
71+
A client certificate is required for authentication when using the Azure certificate authentication type. A client certificate must be installed on each client computer. The exported client certificate must be exported with the private key, and must contain all certificates in the certification path. Make sure that the client computer has the appropriate client certificate installed before proceeding to the next section.
72+
73+
For information about client certificates, see [Generate certificates - Linux](vpn-gateway-certificates-point-to-site-linux.md).
74+
75+
### View VPN client profile files
8176

8277
Go to the downloaded VPN client profile configuration files. You can find all of the information that you need for configuration in the **Generic** folder. Azure doesn’t provide a *mobileconfig* file for this configuration.
8378

@@ -91,9 +86,14 @@ The Generic folder contains the following files:
9186
* **VpnSettings.xml**, which contains important settings like server address and tunnel type.
9287
* **VpnServerRoot.cer**, which contains the root certificate required to validate the Azure VPN gateway during P2S connection setup.
9388

94-
### <a name="gui"></a>GUI instructions
89+
After viewing the files, continue with the steps that you want to use:
90+
91+
* [GUI steps](#gui)
92+
* [CLI steps](#cli)
93+
94+
#### <a name="gui"></a>strongSwan GUI instructions
9595

96-
This section walks you through the configuration using the strongSwan GUI. The following instructions were created on Ubuntu 18.0.4. Ubuntu 16.0.10 doesn’t support strongSwan GUI. If you want to use Ubuntu 16.0.10, you’ll have to use the [command line](#linuxinstallcli). The following examples may not match screens that you see, depending on your version of Linux and strongSwan.
96+
This section walks you through the configuration using the strongSwan GUI. The following instructions were created on Ubuntu 18.0.4. Ubuntu 16.0.10 doesn’t support strongSwan GUI. If you want to use Ubuntu 16.0.10, you’ll have to use the [command line](#cli). The following examples may not match screens that you see, depending on your version of Linux and strongSwan.
9797

9898
1. Open the **Terminal** to install **strongSwan** and its Network Manager by running the command in the example.
9999

@@ -126,7 +126,7 @@ This section walks you through the configuration using the strongSwan GUI. The f
126126

127127
:::image type="content" source="./media/point-to-site-vpn-client-cert-linux/turn-on.png" alt-text="Screenshot shows copy." lightbox="./media/point-to-site-vpn-client-cert-linux/expanded/turn-on.png":::
128128

129-
### <a name="linuxinstallcli"></a>CLI instructions
129+
#### <a name="cli"></a>strongSwan CLI instructions
130130

131131
This section walks you through the configuration using the strongSwan CLI.
132132

@@ -168,13 +168,13 @@ This section walks you through the configuration using the strongSwan CLI.
168168

169169
## <a name="openvpn"></a>OpenVPN tunnel type steps
170170

171-
This section helps you configure Linux clients for certificate authentication that uses the OpenVPN tunnel type. To connect to Azure, you download the OpenVPN client and configure the connection profile.
171+
This section helps you configure Linux clients for certificate authentication that uses the OpenVPN tunnel type. To connect to Azure, download the OpenVPN client and configure the connection profile.
172172

173173
[!INCLUDE [Configuration steps for OpenVPN Linux](../../includes/vpn-gateway-config-openvpn-linux.md)]
174174

175175
## Next steps
176176

177177
For additional steps, return to the original point-to-site article that you were working from.
178178

179-
* [PowerShell configuration steps](vpn-gateway-howto-point-to-site-rm-ps.md).
180-
* [Azure portal configuration steps](vpn-gateway-howto-point-to-site-resource-manager-portal.md).
179+
* [P2S Azure portal steps](vpn-gateway-howto-point-to-site-resource-manager-portal.md).
180+
* [P2S PowerShell steps](vpn-gateway-howto-point-to-site-rm-ps.md).

0 commit comments

Comments
 (0)