Technical Details
Welcome to Vonage SIP Trunking. Our platform enables you to seamlessly enable both inbound and outbound calls from your SIP infrastructure - with just one click, the SIP Dashboard empowers you to create a trunk and effortlessly manage it. This includes various operations such as whitelisting IPs, adding numbers, and editing/deleting SIP URIs, among other functionalities.
Concepts
This section contains some key concepts and terminology used throughout this documentation.
Endpoint
You can send your INVITE requests to the dedicated domain under Vonage regional endpoint, which is created when you set up a new trunk, for example: yourcompany.sip-us.vonage.com
Learn more about SIP endpoints.
Authentication
You can authenticate every INVITE request with Digest authentication for which you can set up a list of credentials, or create an Access Control List (ACL) to only allow certain IP addresses from your SIP infrastructure.
Recipient
Recipient numbers must be in E.164 format. See our guide on phone numbers for more information.
Caller ID
Set the Caller Line Identity (CLI) in the From header using E.164, for example: From: <447700900000@yourcompany.com>. See out phone numbers guide for more information.
Codecs
The following codecs are supported:
PCMA (G711a)PCMU (G711u)iLBCg729 (without annexdb)g722Speex16
ACL
An Access Control List (ACL) is a set of IP ranges which are allowed to interact with a SIP System, which could be either a Vonage or customer SIP system.
Media Traffic
Visit the Vonage Knowledge Base to obtain a list of the IP ranges to open traffic for on all ports.
DTMF
Vonage supports out-of-band DTMF. For more information, see RFC4733(obsoletes RFC2833).
Health Checks
Use the OPTIONS method to run a health check on our SIP trunks.
Protocols
You can use the following protocols:
- UDP on port
5060 - TCP on port
5060 - TLS on port
5061
Transport Layer Security (TLS) is a cryptographic protocol designed to provide communications security to your SIP connection. You can use self-signed certificates on your user agent, Vonage does not validate the client certificate. Connections using TLS 1.2 are accepted. Older protocols are disabled as they are considered insecure.
See our knowledge base article for more information on the IP addresses and port ranges to allow when using SIP trunking with the Vonage Communication APIs.
Media Protocols
You can use either Real-time Transport Protocol (RTP) or Secure Real-time Transport Protocol (SRTP) for the media exchange with Vonage. If there are security and privacy concerns, we highly recommend the use of SIP over TLS, so that the entire communication can be secured.
For outbound calls, your SIP endpoint must negotiate SRTP automatically in the standard way. For inbound calls, see configuration details below.
Note: Vonage supports a single crypto suite AES_CM_128_HMAC_SHA1_80
Session Timers
Vonage supports Session Timers RFC4028; SIP customers that require Session Timers can negotiate them at the moment of establishing a session (INVITE).
Further Reading
- SIP Dashboard guide - Learn how to implement SIP trunking using the Vonage developer dashboard.
- Programmable SIP concept - Learn how to integrate your existing SIP Infrastructure with the Vonage Communications Platform.