|
| 1 | +--- |
| 2 | +title: 'Configure P2S VPN clients: certificate authentication: OpenVPN Client 3.x series - Windows' |
| 3 | +titleSuffix: Azure Virtual WAN |
| 4 | +description: Learn how to configure VPN clients for P2S User VPN configurations that use certificate authentication. This article applies to Windows and the OpenVPN Client 3.x series. |
| 5 | +author: cherylmc |
| 6 | +ms.service: azure-virtual-wan |
| 7 | +ms.topic: how-to |
| 8 | +ms.date: 01/28/2025 |
| 9 | +ms.author: cherylmc |
| 10 | +--- |
| 11 | + |
| 12 | +# Configure OpenVPN Connect 3.x clients for P2S User VPN certificate authentication connections - Windows |
| 13 | + |
| 14 | +If your point-to-site (P2S) VPN gateway is configured to use OpenVPN and certificate authentication, you can connect to your virtual network using the OpenVPN Client. This article walks you through the steps to configure the **OpenVPN Connect client 3.x** and connect to your virtual network. There are some configuration differences between the [OpenVPN 2.x](point-to-site-vpn-client-certificate-windows-openvpn-client-version-2.md) client and the OpenVPN Connect 3.x client. This article focuses on the OpenVPN Connect 3.x client. |
| 15 | + |
| 16 | +> [!NOTE] |
| 17 | +> The OpenVPN client is independently managed and not under Microsoft's control. This means Microsoft doesn't oversee its code, builds, roadmap, or legal aspects. Should customers encounter any bugs or issues with the OpenVPN client, they should directly contact OpenVPN Inc. support. The guidelines in this article are provided 'as is' and haven't been validated by OpenVPN Inc. They're intended to assist customers who are already familiar with the client and wish to use it to connect to the Azure VPN gateway in a User VPN point-to-site VPN setup. |
| 18 | +
|
| 19 | +## Before you begin |
| 20 | + |
| 21 | +Before beginning, make sure you've configured a virtual WAN according to the steps in the [Create User VPN point-to-site connections](virtual-wan-point-to-site-portal.md) article. Your User VPN configuration must use certificate authentication. |
| 22 | + |
| 23 | +### Prerequisites |
| 24 | + |
| 25 | +This article assumes that you've already performed the following prerequisites: |
| 26 | + |
| 27 | +* You configured a virtual WAN according to the steps in the [Create User VPN point-to-site connections](virtual-wan-point-to-site-portal.md) article. Your User VPN configuration must use certificate authentication. |
| 28 | +* You generated and downloaded the VPN client configuration files. For steps to generate a VPN client profile configuration package, see [Generate VPN client configuration files](virtual-wan-point-to-site-portal.md#p2sconfig). |
| 29 | +* You can either generate client certificates, or acquire the appropriate client certificates necessary for authentication. |
| 30 | + |
| 31 | +### Connection requirements |
| 32 | + |
| 33 | +To connect to Azure using the OpenVPN Connect 3.x client using certificate authentication, each connecting client computer requires the following items: |
| 34 | + |
| 35 | +* The OpenVPN Connect client software must be installed and configured on each client computer. |
| 36 | +* The client computer must have a client certificate that's installed locally. |
| 37 | +* If your certificate chain includes an intermediate certificate, see the [Intermediate certificates](#intermediate) section first to verify that your P2S VPN gateway configuration is set up to support this certificate chain. The certificate authentication behavior for 3.x clients is different than previous versions, where you could specify the intermediate certificate in the client profile. |
| 38 | + |
| 39 | +### Workflow |
| 40 | + |
| 41 | +The workflow for this article is: |
| 42 | + |
| 43 | +1. Generate and install client certificates, if you haven't already done so. |
| 44 | +1. View the VPN client profile configuration files contained in the VPN client profile configuration package that you generated. |
| 45 | +1. Configure the OpenVPN Connect client. |
| 46 | +1. Connect to Azure. |
| 47 | + |
| 48 | +## Generate and install client certificates |
| 49 | + |
| 50 | +For certificate authentication, a client certificate must be installed on each client computer. The client certificate you want to use must be exported with the private key, and must contain all certificates in the certification path. Additionally, for some configurations, you'll also need to install root certificate information. |
| 51 | + |
| 52 | +In many cases, you can install the client certificate directly on the client computer by double-clicking. However, for some OpenVPN client configurations, you might need to extract information from the client certificate in order to complete the configuration. |
| 53 | + |
| 54 | +* For information about working with certificates, see [Generate and export certificates](certificates-point-to-site.md#clientcert). |
| 55 | +* To view an installed client certificate, open **Manage User Certificates**. The client certificate is installed in **Current User\Personal\Certificates**. |
| 56 | + |
| 57 | +### Install the client certificate |
| 58 | + |
| 59 | +Each computer needs a client certificate in order to authenticate. If the client certificate isn't already installed on the local computer, you can install it using the following steps: |
| 60 | + |
| 61 | +1. Locate the client certificate. For more information about client certificates, see [Install client certificates](install-client-certificates.md). |
| 62 | +1. Install the client certificate. Typically, you can install a certificate by double-clicking the certificate file and providing a password (if required). |
| 63 | +1. You'll also use the client certificate later in this exercise to configure the OpenVPN Connect client profile settings. |
| 64 | + |
| 65 | +## View client profile configuration files |
| 66 | + |
| 67 | +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. |
| 68 | + |
| 69 | +Locate and unzip the VPN client profile configuration package you generated. For Certificate authentication and OpenVPN, you should see the **OpenVPN** folder. If you don't see the folder, verify the following items: |
| 70 | + |
| 71 | +* Verify that your VPN gateway is configured to use the OpenVPN tunnel type. |
| 72 | +* If you're using Microsoft Entra ID authentication, you might not have an OpenVPN folder. See the [Microsoft Entra ID](openvpn-azure-ad-client.md) configuration article instead. |
| 73 | + |
| 74 | +## Configure the client |
| 75 | + |
| 76 | +[!INCLUDE [Configuration steps](../../includes/vpn-gateway-vwan-config-openvpn-3-series-windows.md)] |
| 77 | + |
| 78 | +### <a name="example"></a>User profile example |
| 79 | + |
| 80 | +[!INCLUDE [User profile example](../../includes/vpn-gateway-vwan-config-openvpn-user-profile.md)] |
| 81 | + |
| 82 | +## <a name="intermediate"></a>Intermediate certificates |
| 83 | + |
| 84 | +If your certificate chain includes intermediate certificates, you must upload the intermediate certificates to the Azure VPN gateway. |
| 85 | +This is the preferred method to use, regardless of the VPN client you choose to connect from. In previous versions, you could specify intermediate certificates in the user profile. This is no longer supported in OpenVPN Connect client version 3.x. |
| 86 | + |
| 87 | +When you're working with intermediate certificates, the intermediate certificate must be uploaded after the root certificate. |
| 88 | + |
| 89 | +## Reconnects |
| 90 | + |
| 91 | +If you experience periodic reconnects due to no traffic being sent to client, you can add the "ping-restart 0" option to the profile to prevent disconnections from causing reconnects. This is described in the OpenVPN Connect documentation as follows: " --ping-restart n Similar to --ping-exit, but trigger a SIGUSR1 restart after n seconds pass without reception of a ping or other packet from remote." |
| 92 | + |
| 93 | +See the [User profile example](#example) for an example of how to add this option. |
| 94 | + |
| 95 | +## Next steps |
| 96 | + |
| 97 | +Follow up with any additional server or connection settings. See [Tutorial: Create a P2S User VPN connection](virtual-wan-point-to-site-portal.md). |
0 commit comments