Unified VPN SDK demo for Windows
This is a demo application for Windows with basic usage of Unified VPN SDK.
Last updated
This is a demo application for Windows with basic usage of Unified VPN SDK.
Last updated
The following prerequisites are required to use the SDK:
Windows 10 (1607+) / Windows 11 (21H2+). For more information please see https://github.com/dotnet/core/blob/main/release-notes/6.0/supported-os.md
Latest version of Visual Studio (recommended)
Microsoft Software Development Kit v10+
Clone app source code locally from this GitHub.
Right-click on the Command Prompt, select "Run as administrator" from the context menu, then navigate to the unified-sdk-windows-demo directory.
Run the following command:
powershell.exe -ExecutionPolicy Bypass -File "bootstrap_service.ps1"
The script installs NetFilter SDK driver and Unified SDK service on your device.
If you encounter any issues while running the bootstrap_service.ps1 script, please refer to the troubleshooting section below for instructions on how to install the service manually.
Launch Visual Studio, navigate to the folder containing the recently downloaded project from GitHub and open the solution file "..\unified-sdk-windows-demo\src\UnifiedSDK.Demo.sln".
Once the solution is open, you need to restore NuGet Packages.
Build the "UnifiedSDK.Demo" project.
Navigate to ..\unified-sdk-windows-demo\output\Debug(Release)\UnifiedSDK.Demo\net6.0-windows\, then double-click UnifiedSDK.Demo.exe to launch the demo application.
Sign in at pango-cloud.com.
Note that at this time, it is not possible for users to create their own accounts directly if they do not already have an account established with example.com. Please contact your sales representative to initiate account creation as part of the project and client onboarding process or contact us. We apologize for any inconvenience.
In Pango dashboard, create a project and use a name for your project as a Public key. Private key is optional.
Navigate to the Network tab from the navigation bar. Then, click on the Add location button.
In Pango dashboard, navigate to the dashboard and locate your carrier_id.
You can find the backend URL for Prod/Stage/Dev here.
You are almost ready to connect to the VPN. To initiate the VPN connection process in the demo app:
Enter the carrier ID and backend address in the appropriate fields.
Click the "Initialize SDK service" button. No visible change will occur (except the log message in the log window), which is expected behavior.
Click the "Login" button. The app should now display a "Logged in" message, indicating successful authentication.
[Optional] Choose VPN protocol and/or Virtual Location.
Click the "Connect" button. The app will establish the VPN connection, and display a "Connected" message upon success.
Your device is now connected to the VPN. To verify the connection:
Open any browser on your device.
Navigate to whatsmyip.com (or any other site which can identify your IP).
Observe that the IP address displayed is different from your device's actual IP address, confirming that traffic is being routed through the VPN.
To terminate the VPN connection when finished, click the "Disconnect" button in the demo app. This will sever the connection and restore direct network access.
Initialize SDK service.
Select "Use multihop proxy" if needed.
Select "Use optimal proxy location" or write your own location description.
Select "Get custom VPN profiles" if needed.
After Login select profile from "Custom profiles" combo box.
Select "Use custom DNS" if needed.
After Login select profile from "DNS server" combo box.
Fill the "User DNS server address" if you want to define the HTTP URL of DNS-over-HTTPS which should be used for a VPN session. Should be a valid URL.
Click the "Login" button.
Select VPN protocol.
Select virtual location.
In case you selected "Use multihop proxy" / "Get custom VPN profiles" / "Use custom DNS" the backend returns locations instead of countries.
Click the "Connect" button.
Initialize SDK service and Login.
Select "Block local networks" if needed. Disabled by default.
It blocks all local network connections during the VPN session except for multicast networks
.Unselect "Prevent IP leak" if needed. Enabled by default.
It blocks IPv6 and DNS requests outside the VPN tunnel.
Select "Enable Killswitch" if needed. Disabled by default.
It prevents traffic leakage during an expected VPN tunnel shutdown.
Click the "Connect" button.
Connect to VPN with Killswitch enabled.
Select "Keep killswitch enabled". Disabled by default.
It blocks all network connections when or even if VPN was turned off normally/manually.
It still allows to Unified SDK to connect to another country/location.
Click the "Disconnect" button.
To disable this feature, unselect "Keep killswitch enabled" and call disconnect one more time.
Fill the domains/applications (full path required).
Click the "Apply" button.
Connect to VPN.
Initialize SDK service and Login.
Put the fireshield config in the text box.
Please see the documentation about Fireshield manual configure here.
Click the "Connect" button.
Select "Enable throttling".
Set global speed limits in Bit/second.
Set local speed limits in Bit/second.
Add the process you want to throttling by clicking the "Add process" button and filling the process name.
Click the "Add speed limit" button if you want to add another one local speed limit.
Click the "Send configuration button".
Click the "Connect" button.
If you encounter issues running the bootstrap_service.ps1 script successfully, follow these steps to execute the commands in the script manually:
1. Open Command Prompt:
Right-click on the Command Prompt icon.
Select "Run as administrator" to open it with elevated privileges.
2. Navigate to the unified SDK folder:
Use the cd command followed by the full path to the unified-sdk-windows-demo directory.
For example: cd C:\Path\To\unified-sdk-windows-demo\.
3. Check if netfilter2 is installed:
Run the command: sc.exe query partner_netfilter2.
If the output says, "The specified service does not exist as an installed service," proceed to the next step.
4. Create a new netfilter2 service:
Run the command: sc.exe create partner_netfilter2 binPath="C:\Path\To\unified-sdk-windows-demo\service\netfilter\partner_netfilter2.sys" type= kernel start= auto.
Replace C:\Path\To\unified-sdk-windows-demo\ with the actual path to your unified-sdk-windows-demo directory.
The output should indicate: [SC] CreateService SUCCESS.
5. Verify the netfilter2 service:
Run the command: sc.exe query partner_netfilter2 again.
The output should display the service details, including:
6. Install the Unified SDK service:
Run the command: "C:\Path\To\unified-sdk-windows-demo\service\UnifiedSDK.Service.exe" -install UnifiedSDKService.
Replace "C:\Path\To\unified-sdk-windows-demo\" with the actual path to your unified-sdk-windows-demodirectory.
By following these steps, you should be able to manually execute the commands from the bootstrap_service.ps1 script and resolve any issues you were facing.
When attempting to run the application, you encounter the following message: "You must install or update .NET to run this application".
Visit the official Microsoft .NET download page and download NET 6.0 Desktop Runtime (v6.0.X) Windows x64 Installer
Download and run the installer, following the on-screen instructions.
Try running the demo application again. It should now launch successfully.
For more detailed information, please refer to SDK documentation.
