Unified VPN SDK demo for Windows
This is a demo application for Windows with basic usage of Unified VPN SDK.
Last updated
Was this helpful?
This is a demo application for Windows with basic usage of Unified VPN SDK.
Last updated
Was this helpful?
The following prerequisites are required to use the SDK:
Architecture of processor: x86, x64, ARMx64
Windows 10 (1607+) / Windows 11 (23H2+). For more information please see
Latest version of Visual Studio (recommended)
Microsoft Software Development Kit v10+
InstalledNET 8.0 Desktop Runtime (v8.0.X) from official Microsoft .NET download page
Clone app source code locally from .
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 driver (only for x86, x64) and Unified SDK service on your device.
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\net8.0-windows\, then double-click UnifiedSDK.Demo.exe to launch the demo application.
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 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.
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 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.
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.
Click on the "Initialize SDK service" button.
Click on the "Loggin" button.
Uncheck "Prevent IP leaks" checkbox.
Check "Enable RouteViaVPN" checkbox.
Fill "Route via VPN applications" text box with full path to .exe file.
Fill "Route via VPN domains" text box.
Click "Apply" button.
Click "Connect" button.
The script helps to configure NetFilter SDK driver and Unified SDK service. 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 (only for x86, x64):
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 8.0 Desktop Runtime (v8.0.X) for installed operating system
Download and run the installer, following the on-screen instructions.
Try running the demo application again. It should now launch successfully.
Launch , navigate to the folder containing the recently downloaded project from GitHub and open the solution file "..\unified-sdk-windows-demo\src\UnifiedSDK.Demo.sln".
Sign in at .
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 . We apologize for any inconvenience.
You can find the backend URL for Prod/Stage/Dev .
For more detailed information, please refer to .
