Configuring Vonage Register Authentication Trunk
Before proceeding with the next steps, you need to purchase a DID on the Vonage platform.
Create a SIP Trunk on the Vonage Platform
You can also reference the Vonage documentation for configuring the SIP Trunk.
Step 1: Create a New SIP Trunk
Sign in to the Vonage Dashboard.
Navigate to Build & Manage > SIP.
By default, Vonage provides a pre-created SIP trunk.
You may click the Settings icon to modify it, or
Click Create New to create a new SIP trunk.
In this guide, we will create a new SIP trunk.
Click Create New, enter a domain name for the trunk (for example,
portsip), and then click Create.
Step 2: Configure Outbound Calling (Register Authentication)
Once the SIP trunk is successfully created, you are automatically redirected to the Trunk Details page.
On the Trunk Details page, locate the Outbound Calling section.
Click Add Authentication. You will be redirected to the Authentication page.
Under the User Key and Secret section:
Enter a value for User Key
Enter a value for Secret
Click the + button to add the credentials
Important
Be sure to record the User Key and Secret, as they will be required later when configuring the SIP trunk in PortSIP PBX.
These credentials function as SIP registration credentials.
After the User Key and Secret are added, the section appears enabled (green), indicating that register-based authentication is active.
Important
User Key / Secret authentication and Access Control List (ACL) authentication cannot be enabled at the same time.
If you use User Key and Secret, do not configure ACL-based IP authentication for this trunk.
Click Back to return to the Trunk Details page.
Step 3: Note the Vonage SIP Trunk Domain
On the Trunk Details page, Outbound Calling should now display a status of Ready.
Copy and save the Vonage SIP trunk domain. Select the domain closest to your PortSIP PBX location to minimize latency:
portsip.sip-us.vonage.comportsip.sip-eu.vonage.comportsip.sip-ap.vonage.com
You will need this domain when configuring the Register-Based Trunk in PortSIP PBX.
Step 4: Configure Inbound Calling (SIP URI Routing)
To allow Vonage to route inbound calls to your PortSIP PBX, configure a SIP URI.
In the Inbound Calling section, add a new SIP URI with the following parameters:
Priority Enter a unique value between 0 and 100 (for example,
1).0is the highest priorityEach SIP URI must have a unique priority value
Note If priority values are not unique, Vonage cannot guarantee inbound call routing order.
URI Enter your PortSIP PBX public IP address or domain name, for example:
44.242.60.185pbx.portsip.com
Timeout Enter a value between 2000 ms and 20000 ms.
If left empty, Vonage uses the default timeout of 5000 ms.
TLS (Optional)
Enable this option if your PortSIP PBX is configured to receive SIP signaling over TLS.
By default, Vonage sends TLS traffic to port 5061.
If your PortSIP PBX listens on a different TLS port (for example,
5063), include it in the URI:
SRTP (Optional)
Enable this option to allow secure media encryption (SRTP).
SRTP is recommended when TLS is enabled for SIP signaling.
Click the + button to add the SIP URI. The SIP URI is listed under the Inbound Calling section, indicating that inbound call routing is configured.
Step 5: Link Phone Numbers to the SIP Trunk
In the Link Numbers section:
Click Link all… to associate all available numbers, or
Click Link to select specific numbers.
If no numbers are available:
Click Buy Numbers to open the Vonage number purchasing portal.
In the Numbers Dashboard, you can filter, link, or unlink numbers as needed.
Once numbers are successfully linked, Vonage displays a confirmation indicating that the SIP trunk is ready to receive inbound calls.
Configure a Register-Based Trunk in PortSIP PBX
In PortSIP PBX, a Vonage Registration Trunk corresponds to a Register-Based Trunk, where the PBX authenticates to Vonage using SIP credentials (User Key and Secret).
You can configure a Register-Based Trunk at either of the following levels:
System Administrator level
The trunk can be shared with one or more tenants
Tenant Administrator level
The trunk is dedicated to a single tenant and cannot be shared
Step 1: Create a Register-Based Trunk
Sign in to the PortSIP PBX Web Portal as a System Administrator or Tenant Administrator.
From the left navigation menu, go to Call Manager > Trunks.
Click Add to open the trunk type menu.
Select Register Based Trunk.
Step 2: Configure Basic Trunk Settings
On the Basic Settings page, configure the following fields:
Name Enter a friendly and descriptive name (for example,
Vonage-Register-Trunk).Brand Select Vonage.
DID Pool (Tenant Administrator level only)
Configure the Vonage DID numbers assigned to this tenant.
The tenant can use only the DIDs in this pool to:
Create inbound and outbound rules
Configure outbound caller ID for extensions
DID Pool Format Examples:
Hostname or IP Address Paste the Vonage SIP trunk domain copied earlier, for example:
Click Next to continue.
Step 3: Configure Trunk Authentication Credentials
On the Authentication page, enter the SIP registration credentials created on the Vonage platform:
Authentication Name Enter the User Key from the Vonage SIP trunk.
Password Enter the Secret from the Vonage SIP trunk.
Click Next to continue.
Important These credentials are used by PortSIP PBX to register with Vonage. Ensure they match exactly with the values configured on the Vonage platform.
Step 4: Configure Trunk Options
On the Options page:
Max Concurrent Calls Set the maximum number of simultaneous calls allowed on this trunk.
This should align with your Vonage service limits and expected traffic.
Other Options Leave the default values unless you have specific requirements related to codecs, routing, or interoperability.
Recommendation The default settings are suitable for most deployments and provide optimal compatibility with Vonage.
Click Next to proceed.
Step 5: Assign Tenants and Configure DID Pool
This step appears only when the trunk is created at the System Administrator level.
Assign one or more tenants to use this trunk.
Configure the DID Pool for each tenant.
DID Pool Rules
Each DID can be assigned to only one tenant
A tenant can use only the DIDs assigned to it to:
Create inbound and outbound rules
Configure outbound caller ID for extensions
Click OK to save the configuration.
DID Pool Format Examples:
Expected Result
PortSIP PBX initiates SIP registration to the Vonage platform.
Once registration is successful, the trunk status displays as Online on the trunk list page.
Next Steps
The Vonage Register Authentication Trunk is now ready for use.
You can proceed to:
Configure outbound call routing rules
Configure inbound DID routing
Assign outbound caller IDs
Refer to the next guide section: Configuring Outbound & Inbound Calls.
Last updated