Skip to content

Commit e074a88

Browse files
committed
AzureVPN folder
1 parent e4cb130 commit e074a88

7 files changed

+30
-38
lines changed

articles/vpn-gateway/azure-vpn-client-optional-configurations.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to configure optional configuration settings for the Azur
55
author: cherylmc
66
ms.service: azure-vpn-gateway
77
ms.topic: how-to
8-
ms.date: 05/15/2024
8+
ms.date: 09/06/2024
99
ms.author: cherylmc
1010

1111
---
@@ -26,15 +26,21 @@ The steps in this article assume that you have configured your P2S gateway and h
2626

2727
## Working with VPN client profile configuration files
2828

29-
The steps in this article require you to modify and import the Azure VPN Client profile configuration file. To work with VPN client profile configuration files (xml files), use the following steps:
29+
The steps in this article require you to modify and import the Azure VPN Client profile configuration file. The following profile configuration files are generated, depending on the authentication types configured for your P2S VPN gateway.
30+
31+
* **azurevpnconfig.xml**: This file is generated when only one authentication type is selected.
32+
* **azurevpnconfig_aad.xml**: This file is generated for Microsoft Entra ID authentication when there are multiple authentication types selected.
33+
* **azurevpnconfig_cert.xml**: This file is generated for Certificate authentication when there are multiple authentication types selected.
34+
35+
To work with VPN client profile configuration files (xml files), use the following steps:
3036

3137
1. Locate the profile configuration file and open it using the editor of your choice.
3238
1. Using the examples in the following sections, modify the file as necessary, then save your changes.
3339
1. Import the file to configure the Azure VPN client. You can import the file for the Azure VPN Client using these methods:
3440

35-
* **Azure VPN Client interface**: Open the Azure VPN Client and click **+** and then **Import**. Locate the modified xml file, configure any additional settings in the Azure VPN Client interface (if necessary), then click **Save**.
41+
* **Azure VPN Client interface**: Open the Azure VPN Client and click **+** and then **Import**. Locate the modified .xml file, configure any additional settings in the Azure VPN Client interface (if necessary), then click **Save**.
3642

37-
* **Command-line prompt**: Place the downloaded *azurevpnconfig.xml* file in the *%userprofile%\AppData\Local\Packages\Microsoft.AzureVpn_8wekyb3d8bbwe\LocalState* folder, then run the following command: `azurevpn -i azurevpnconfig.xml`. To force the import, use the **-f** switch.
43+
* **Command-line prompt**: Place the appropriate downloaded configuration xml file in the *%userprofile%\AppData\Local\Packages\Microsoft.AzureVpn_8wekyb3d8bbwe\LocalState* folder, then run the command that corresponds to the configuration file name. For example, `azurevpn -i azurevpnconfig_aad.xml`. To force the import, use the **-f** switch.
3844

3945
## DNS
4046

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

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: cherylmc
66
ms.service: azure-vpn-gateway
77
ms.custom: linux-related-content
88
ms.topic: how-to
9-
ms.date: 06/05/2024
9+
ms.date: 09/06/2024
1010
ms.author: cherylmc
1111
---
1212

@@ -42,7 +42,7 @@ The basic workflow is as follows:
4242

4343
1. Generate and install client certificates.
4444
1. Locate the VPN client profile configuration package that you generated in the [Configure server settings for P2S VPN Gateway connections - certificate authentication](vpn-gateway-howto-point-to-site-resource-manager-portal.md#profile-files) article.
45-
1. Download and configure Azure VPN Client for Linux.
45+
1. Download and configure the Azure VPN Client for Linux.
4646
1. Connect to Azure.
4747

4848
## Generate certificates
@@ -67,15 +67,11 @@ openssl x509 -req -days 365 -in "${USERNAME}Req.pem" -CA caCert.pem -CAkey caKey
6767

6868
## View VPN client profile configuration files
6969

70-
When you generate a VPN client profile configuration package, all the necessary configuration settings for VPN clients are contained in a VPN client profile configuration zip file. The VPN client profile configuration files 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 profile configuration files and apply the new configuration to all of the VPN clients that you want to connect.
70+
When you generate and download a VPN client profile configuration package, all the necessary configuration settings for VPN clients are contained in a VPN client profile configuration zip file. The VPN client profile configuration files 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 profile configuration files and apply the new configuration to all of the VPN clients that you want to connect.
7171

72-
Locate and unzip the VPN client profile configuration package you generated (listed in the [Prequisites](#prerequisites)). For P2S **Certificate authentication** and with an **OpenVPN** tunnel type, you'll see the **AzureVPN** folder. In the AzureVPN folder, locate the **azurevpnconfig.xml** file. This file contains the settings you use to configure the VPN client profile.
72+
Locate and unzip the VPN client profile configuration package you generated and downloaded (listed in the [Prequisites](#prerequisites)). Open the **AzureVPN** folder. In this folder, you'll see either the **azurevpnconfig_cert.xml** file or the **azurevpnconfig.xml** file, depending on whether your P2S configuration includes multiple authentication types. The .xml file contains the settings you use to configure the VPN client profile.
7373

74-
If you don't see the **azurevpnconfig.xml** file, verify the following items:
75-
76-
* Verify that your VPN gateway is configured to use the OpenVPN tunnel type.
77-
* Verify your P2S configuration is set for certificate authentication.
78-
* If you're using Microsoft Entra ID authentication, you might not have an AzureVPN folder. See the [Microsoft Entra ID](point-to-site-entra-gateway.md) configuration article instead.
74+
If you don't see either file, or you don't have an **AzureVPN** folder, verify that your VPN gateway is configured to use the OpenVPN tunnel type and that certificate authentication is selected.
7975

8076
## Download the Azure VPN Client
8177

@@ -109,7 +105,7 @@ For more information about the repository, see [Linux Software Repository for Mi
109105
1. On the bottom left of the page of the Linux VPN client, select **Import**.
110106

111107
:::image type="content" source="./media/azure-vpn-client-certificate-linux/import.png" alt-text="Screenshot of Azure VPN Client for Linux with Import." lightbox="./media/azure-vpn-client-certificate-linux/import.png":::
112-
1. In the window, navigate to the **azurevpnconfig.xml** file, select it, then select **Open**.
108+
1. In the window, navigate to either the **azurevpnconfig.xml** or **azurevpnconfig_cert.xml** file, select it, then select **Open**.
113109
1. To add **Client Certificate Public Data**, use the file picker and locate the related **.pem** files.
114110

115111
:::image type="content" source="./media/azure-vpn-client-certificate-linux/client-certificate-data.png" alt-text="Screenshot of Azure VPN Client for Linux with client certificate data selected." lightbox="./media/azure-vpn-client-certificate-linux/client-certificate-data.png":::

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: cherylmc
66
ms.service: azure-vpn-gateway
77
ms.custom: linux-related-content
88
ms.topic: how-to
9-
ms.date: 06/05/2024
9+
ms.date: 09/09/2024
1010
ms.author: cherylmc
1111
---
1212

@@ -71,7 +71,7 @@ In this section, you configure the Azure VPN client for Linux.
7171

7272
* If your P2S gateway configuration was previously configured to use the older, manually registered App ID versions, your P2S configuration doesn't support the Linux VPN client. See [About the Microsoft-registered App ID for Azure VPN Client](point-to-site-entra-gateway.md).
7373

74-
* For Microsoft Entra ID authentication, use the **azurevpnconfig_aad.xml** file. The file is located in the **AzureVPN** folder of the VPN client profile configuration package.
74+
* For Microsoft Entra ID authentication, use the **azurevpnconfig_aad.xml** or **azurevpnconfig.xml** file that's located in the **AzureVPN** folder of the VPN client profile configuration package. The file name depends on whether your P2S configuration includes multiple authentication types.
7575

7676
1. On the Azure VPN Client page, select **Import**.
7777

articles/vpn-gateway/point-to-site-entra-vpn-client-mac.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,11 +36,11 @@ This article continues on from the [Configure a P2S VPN gateway for Microsoft En
3636

3737
## <a name="generate"></a>Extract client profile configuration files
3838

39-
To configure your Azure VPN Client profile, you download a VPN client profile configuration package from the Azure P2S gateway. This package contains the necessary settings to configure the VPN client.
40-
4139
If you used the P2S server configuration steps as mentioned in the [Prerequisites](#prerequisites) section, you've already generated and downloaded the VPN client profile configuration package that contains the VPN profile configuration files. If you need to generate configuration files, see [Download the VPN client profile configuration package](point-to-site-entra-gateway.md#download).
4240

43-
After you obtain the VPN client profile configuration package, extract the files.
41+
When you generate and download a VPN client profile configuration package, all the necessary configuration settings for VPN clients are contained in a VPN client profile configuration zip file. The VPN client profile configuration files 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 profile configuration files and apply the new configuration to all of the VPN clients that you want to connect.
42+
43+
Locate and unzip the VPN client profile configuration package you generated and downloaded (listed in the [Prequisites](#prerequisites)). Open the **AzureVPN** folder. In this folder, you'll see either the **azurevpnconfig_aad.xml** file or the **azurevpnconfig.xml** file, depending on whether your P2S configuration includes multiple authentication types. The .xml file contains the settings you use to configure the VPN client profile.
4444

4545
## Import VPN client profile configuration files
4646

articles/vpn-gateway/point-to-site-entra-vpn-client-windows.md

Lines changed: 4 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ titleSuffix: Azure VPN Gateway
55
author: cherylmc
66
ms.service: azure-vpn-gateway
77
ms.topic: how-to
8-
ms.date: 06/05/2024
8+
ms.date: 09/06/2024
99
ms.author: cherylmc
1010

1111
---
@@ -33,27 +33,20 @@ This article continues on from the [Configure a P2S VPN gateway for Microsoft En
3333

3434
## <a name="generate"></a>Extract client profile configuration files
3535

36-
To configure your Azure VPN Client profile, you must first download the VPN client profile configuration package from the Azure P2S gateway. This package is specific to the configured VPN gateway and contains the necessary settings to configure the VPN client.
36+
To configure your Azure VPN Client profile, you must first download the VPN client profile configuration package from the Azure P2S gateway. This package is specific to the configured VPN gateway and contains the necessary settings to configure the VPN client. If you used the P2S server configuration steps as mentioned in the [Prerequisites](#prerequisites) section, you've already generated and downloaded the VPN client profile configuration package that contains the VPN profile configuration files. If you need to generate configuration files, see [Download the VPN client profile configuration package](point-to-site-entra-gateway.md#download).
3737

38-
If you used the P2S server configuration steps as mentioned in the [Prerequisites](#prerequisites) section, you've already generated and downloaded the VPN client profile configuration package that contains the VPN profile configuration files. If you need to generate configuration files, see [Download the VPN client profile configuration package](point-to-site-entra-gateway.md#download).
39-
40-
After you obtain the VPN client profile configuration package, extract the zip file. The file contains the following folders:
41-
42-
* **AzureVPN**: The AzureVPN folder contains the **Azurevpnconfig.xml** file that is used to configure the Azure VPN Client.
43-
* **Generic**: The generic folder contains the public server certificate and the VpnSettings.xml file. The VpnSettings.xml file contains information needed to configure a generic client.
38+
After you obtain the VPN client profile configuration package, extract the zip file. The zip file contains the **AzureVPN** folder. The **AzureVPN** folder contains the **azurevpnconfig_aad.xml** file or the **azurevpnconfig.xml** file, depending on whether your P2S configuration includes multiple authentication types. If you don't see **azurevpnconfig_aad.xml** or **azurevpnconfig.xml**, or you don't have an **AzureVPN** folder, verify that your VPN gateway is configured to use the OpenVPN tunnel type and that Azure Active Directory (Microsoft Entra ID) authentication is selected.
4439

4540
## <a name="import"></a>Import client profile configuration settings
4641

4742
> [!NOTE]
4843
> [!INCLUDE [Entra VPN client note](../../includes/vpn-gateway-entra-vpn-client-note.md)]
4944
50-
When your P2S configuration specifies Microsoft Entra ID authentication, the VPN client profile configuration settings are contained in the **azurevpnconfig.xml** file. This file is located in the **AzureVPN** folder of the VPN client profile configuration package.
51-
5245
1. On the page, select **Import**.
5346

5447
:::image type="content" source="./media/point-to-site-entra-vpn-client-windows/import.png" alt-text="Screenshot that shows the Add button selected and the Import action highlighted in the lower left-side of the window." lightbox="./media/point-to-site-entra-vpn-client-windows/import.png":::
5548

56-
1. Browse to the Azure VPN Client profile configuration folder that you extracted. In the AzureVPN folder, select **azurevpnconfig.xml**. With the file selected, select **Open**.
49+
1. Browse to the Azure VPN Client profile configuration folder that you extracted. Open the **AzureVPN** folder and select the client profile configuration file (azurevpnconfig_aad.xml or azurevpnconfig.xml). Select **Open** to import the file.
5750

5851
1. Change the name of the Connection name (optional). In this example, you'll notice that the Audience value shown is the new Azure Public value associated to the Microsoft-registered Azure VPN Client App ID. The value in this field must match the value that your P2S VPN gateway is configured to use.
5952

articles/vpn-gateway/point-to-site-vpn-client-certificate-windows-azure-vpn-client.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ This article assumes that you've already performed the following prerequisites:
3232
To connect to Azure, each connecting client computer requires the following items:
3333

3434
* The Azure VPN Client software must be installed on each client computer.
35-
* The Azure VPN Client profile must be configured using the downloaded **azurevpnconfig.xml** configuration file.
35+
* The Azure VPN Client profile is configured using the settings contained in the downloaded **azurevpnconfig.xml** or **azurevpnconfig_cert.xml** configuration file.
3636
* The client computer must have a client certificate that's installed locally.
3737

3838
## Generate and install client certificates
@@ -53,12 +53,9 @@ Each computer needs a client certificate in order to authenticate. If the client
5353

5454
The VPN client profile configuration package contains specific folders. The files within the folders contain the settings needed to configure the VPN client profile on the client computer. The files and the settings they contain are specific to the VPN gateway and the type of authentication and tunnel your VPN gateway is configured to use.
5555

56-
Locate and unzip the VPN client profile configuration package you generated. For Certificate authentication and OpenVPN, you'll see the **AzureVPN** folder. Locate the **azurevpnconfig.xml** file. This file contains the settings you use to configure the VPN client profile.
56+
Locate and unzip the VPN client profile configuration package you generated. For Certificate authentication and OpenVPN, you'll see the **AzureVPN** folder. In this folder, you'll see either the **azurevpnconfig_cert.xml** file or the **azurevpnconfig.xml** file, depending on whether your P2S configuration includes multiple authentication types. The .xml file contains the settings you use to configure the VPN client profile.
5757

58-
If you don't see the file, verify the following items:
59-
60-
* Verify that your VPN gateway is configured to use the OpenVPN tunnel type.
61-
* If you're using Microsoft Entra authentication, you might not have an AzureVPN folder. See the [Microsoft Entra ID](point-to-site-entra-vpn-client-windows.md) configuration article instead.
58+
If you don't see either file, or you don't have an **AzureVPN** folder, verify that your VPN gateway is configured to use the OpenVPN tunnel type and that certificate authentication is selected.
6259

6360
## Download the Azure VPN Client
6461

@@ -70,7 +67,7 @@ If you don't see the file, verify the following items:
7067

7168
1. Select **+** on the bottom left of the page, then select **Import**.
7269

73-
1. In the window, navigate to the **azurevpnconfig.xml** file. Select the file, then select **Open**.
70+
1. In the window, navigate to the **azurevpnconfig.xml** or **azurevpnconfig_cert.xml** file. Select the file, then select **Open**.
7471

7572
1. On the client profile page, notice that many of the settings are already specified. The preconfigured settings are contained in the VPN client profile package that you imported. Even though most of the settings are already specified, you need to configure settings specific to the client computer.
7673

articles/vpn-gateway/vpn-gateway-howto-point-to-site-resource-manager-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: cherylmc
66
ms.service: azure-vpn-gateway
77
ms.custom: devx-track-azurepowershell
88
ms.topic: how-to
9-
ms.date: 08/23/2024
9+
ms.date: 09/06/2024
1010
ms.author: cherylmc
1111
---
1212
# Configure server settings for P2S VPN Gateway certificate authentication

0 commit comments

Comments
 (0)