Cloud proxy
Large organizations commonly deploy firewalls to meet their stringent security requirements. To ensure uninterrupted access to Agora services for users behind firewalls, Agora offers a firewall allowlist and Cloud proxy services.
To enable SDK use in network-restricted environments, administrators can add specific IP addresses and ports to the firewall allowlist. Developers then configure the Cloud proxy service by calling the appropriate APIs.
Understand the tech
Cloud proxy works as follows:
- On-Premise Recording SDK initiates a request to Cloud proxy.
- Cloud proxy returns the corresponding proxy information.
- The Agora SDK sends data to Cloud proxy, which forwards it to the Agora SD-RTN™.
- The SD-RTN™ sends the response back to Cloud proxy, which then returns it to the SDK.
Cloud proxy workflow
Prerequisites
Before you begin, complete the Quickstart to integrate the On-Premise Recording SDK and set up basic recording functionality.
Implement Cloud proxy
To implement Cloud proxy in your app, follow these steps:
-
Request access to Cloud proxy
Contact Agora support and provide the following information:
- App ID
- Region where you want to use Cloud proxy
- Expected concurrency scale
- Network operator and other relevant details
-
Allow traffic through the firewall
After your request is approved, Agora provides a list of IP addresses and ports. Add these to your firewall allowlist to enable communication through Cloud proxy.
-
Enable the cloud proxy in your code
Set the private parameter
rtc.enable_proxy
totrue
. -
Test your setup
Record audio and video to confirm the proxy configuration is working as expected.
-
Disable cloud proxy
To stop using Cloud proxy, set
rtc.enable_proxy
tofalse
.
Reference
This section contains content that completes the information on this page, or points you to documentation that explains other aspects to this product.