Overview
As of 22 March 2021 the Vonage Video API platform requires all customers to use TLS 1.2 or higher. Connections using TLS 1.1 are not accepted.
The platform now supports TLS 1.3 for both the OpenTok and Unified environments, and was enabled for OpenTok on February 18, 2026.
For more information about supported TLS versions and security guidance, see:
- OpenTok environment: https://tokbox.com/developer/guides/security/#security--transport-layer
-
Unified environment: https://developer.vonage.com/en/video/guides/security#security--transport-layer
Not sure which environment you are using? See How to recognize if I’m using Vonage Video API Unified Environment or Vonage Video API OpenTok environment?
See the list of Supported TLS Cipher Suites for more information.
Some customers using .NET 4.5 and TLS 1.2 have experienced issues, potentially because TLS configuration is not being enforced. You can force TLS on by adding this configuration in your server set up:
ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;This forces the use of TLS 1.2 for the .NET SDK.
TokBox Considerations
If you’re using any of the supported versions of following client SDKs, your application will not be affected:
- JS SDK
- iOS SDK
- Android SDK
- Windows SDK
Some server SDKs may have dependencies you should be aware of:
-
.NET SDK
- Servers running with .NET 4.0 need to upgrade to .NET Framework 4.5.2 or a later version.
- When using TLS 1.3 with .NET Framework, we recommend using OpenTok .NET SDK version 3.20.2 or later to avoid a known compatibility issue. For more details, see OpenTok .NET Server SDK. 60 second Delay using .NET Framework 4 and TLS 1.3
-
Java SDK
- Java 8 uses TLS 1.2 by default
- You must use Java 1.7.0_131-b31 or higher for TLS 1.1 support. For more details on TLS, SSL, and HTTPs for Java, please see the following blog from the Java Platform Group.
- Use the latest OpenTok Java SDK as it uses async-http-client 2.x.x, which supports TLS 1.2.
-
PHP SDK
- PHP 5.6 or later supports TLS 1.2. Our PHP SDK only supports PHP 5.6 and later.
If you use Vonage REST APIs, you should be aware of the libraries you are using.
Testing Your Application Server Environment
You can run scripts on your production environment to verify successful connections:
If your server fails to establish a connection with Vonage Video API, you will have to update your server environment as needed.