Azure VPN Client P2S file uses backslashes, which is incorrect

Andrew Janke 45 Reputation points

The "VPN client" zip files from Azure Portal use backslashes in paths and expand to bad files on macOS.

As of 2023-08, it looks like the "VPN client" zip files produced by Azure VPN gateway point-to-site configurations use backslashes in the file path names inside the ZIP entries, which cause them to expand to the "wrong" files on macOS and produce warnings on Linux.

In the Azure Portal blade for a Virtual Network Gateway, if I have it configured for a point-to-site VPN, and select "Point-to-site configuration" in the navigation bar and then click the "Download VPN client" button [1], that downloads a zip file, named "" or whatever "<gateway>.zip" I have.

When I unzip that zip file on Windows by double-clicking it or right-clicking and doing "Expand all", it produces a directory with some subdirectories as described on this page. However, on macOS, if I click that zip file, it expands to several files with backslashes in their names in a single-level folder. [2] And when expanding on Linux using its unzip utility, it gives me a warning about "backslashes in path names" but then produces subdirectories.

I think this is because the zip file is incorrectly using backslashes instead of slashes in the path names inside the Zip entries in that file. The default Windows unzipper utility handles that by creating subdirectories, but the default macOS unzipper treats backslashes as regular characters and does not produce subdirectories.

I think it would be good if this "VPN client" zip file expanded to the same folder structure on all supported client OSes, including macOS. This would happen if the zip file were produced using forward slashes instead of backslashes as the file/path separator in its zip entries. I think Microsoft should consider altering the code that produces this zip file to do so.

My basis for thinking that forward slashes are corret and backslashes are wrong here is:

My basis for thinking that macOS is a supported client OS for Azure VPN P2S stuff here, and thus that Microsoft should consider making this "VPN Client" zip file work good on macOS, is:

Any chance I could get an Azure Portal or VPN Gateway developer interested in this issue, and get them interested in fixing up the ZIP file to use forward slashes instead of backslashes in the zip entry paths so it works good on macOS?

This is a minor issue: the contents of the extracted files are correct, and setting up a VPN client connection using them works fine, as long as you can read the instructions and translate stuff like "in the 'Generic/' folder" to "the file that starts with 'Generic'". However, I'm a sysadmin who needs to get non-technical users to be able to set up VPN connections on their client machines using this file, and any deviation from the exact documentation or expected file names/directory structure makes that more difficult. My current workaround is to download that VPN client zip file on Windows, unzip it, and then re-zip it using a utility that produces a zip file with correct forward slashes. But that's a bit of a bummer; we can do better here, right?


virtual network gateway - p2s configuration - download client



Azure VPN Gateway
Azure VPN Gateway
An Azure service that enables the connection of on-premises networks to Azure through site-to-site virtual private networks.
1,144 questions
{count} votes