VPN Dashboard
← Blesta integration

Installation guide

Connect Blesta to VPN Dashboard.

Install the module, add a module row and configure packages or selectable profile quantities.

Packagevpn-dashboard-blesta.zip
Install incomponents/modules/vpn_dashboard
Provider keyblesta
01

Install

Put the module in the right place.

  1. Download the Blesta ZIP from Integration downloads in your VPN Dashboard account.
  2. Extract it and copy the vpn_dashboard directory into components/modules in your Blesta installation.
  3. In Blesta, open Settings, Company, Modules and install VPN Dashboard.
Download it from your account.Module packages are private and the current ZIP is available under Integration downloads after sign-in.
02

Connect

Add the dashboard connection.

  1. Add a module row and enter the HTTPS address of your hosted dashboard.
  2. Enter the billing API token, SSO signing secret and webhook signing secret from the matching billing connection in VPN Dashboard.
  3. Set the provider key to blesta, run Test connection and add the Blesta server public IP to the billing API allow-list.
Use one matching provider key.The module, billing connection and customer sign-in settings must use blesta.
03

Product

Set up the VPN product.

  1. Create or edit a Blesta package and select the VPN Dashboard module.
  2. Set the minimum, default and maximum profile quantities, the product name and the server access type.
  3. If checkout uses a configurable quantity, use profile_limit, vpn_dashboard_profile_limit, vpn_profiles, profiles or profile_count as the option name.
04

Customer access

Add the customer-area link.

The Blesta service page can open the customer VPN area through a signed link that expires after five minutes.

Keep the SSO signing secret private. Change it in both systems if it is ever exposed.

Configuration reference

Settings used by Blesta.

Connection settings apply to the module. Product settings apply to each plan.

Connection settings5 fields
Dashboard URLRequired HTTPS address
The address of your hosted VPN Dashboard, without an API path.
Billing API tokenRequired secret
Copy the token from the matching billing connection in VPN Dashboard.
SSO signing secretRequired, at least 32 characters
Signs the short-lived link that takes a customer from their billing account to the VPN area.
Webhook signing secretBlank or at least 32 characters
Signs write requests from the module. Leave it blank only when the billing server IP is enforced through the API allow-list.
Provider keyblesta
Must match the provider key on the billing connection and customer sign-in settings.
Product settings6 fields
Minimum profiles50 by default
The lowest profile quantity accepted for this package.
Default profiles50 by default
Used when the service or a configurable option does not supply a quantity.
Maximum profiles10,000 by default
The highest profile quantity accepted for this package.
Product name sent to VPN DashboardVPN profiles by default
The plan name stored with the service in VPN Dashboard.
Server accessShared or dedicated; shared by default
Dedicated services wait for dedicated VPN server capacity.
VPN profilesBetween the package minimum and maximum
The service quantity. A recognised Blesta configurable option can override it during ordering.

Service lifecycle

What Blesta sends.

Create or edit serviceCreates or updates the same VPN service and profile allowance.
Suspend serviceSuspends VPN access for that service.
Unsuspend serviceRestores VPN access for that service.
Cancel serviceCancels VPN access for that service.

Before launch

Check the complete order path.

  1. The module connection check succeeds.
  2. The product creates the expected profile allowance and server access type.
  3. The customer link opens the correct branded VPN area.
  4. Suspension and restoration update the same service.
  5. Cancellation removes access from the same service.

Module notes

Details specific to Blesta.

  • PHP cURL must be available to Blesta.
  • A separate incoming webhook is not required.
  • The profile quantity is stored as profile_limit for service emails and display.

Ready to install?

Download the Blesta module from your account.

The package and its version details are kept under Integration downloads.

Sign in to download