Connect with Cloud Proxy

If your device runs inside a network that restricts direct access to Agora SDRTN® (Software-Defined Real-Time Network), such as one behind a restrictive corporate or industrial firewall, use Agora's cloud proxy service to relay traffic through a set of Agora-owned IP addresses and ports that you add to your firewall allowlist.

Understand the tech

When cloud proxy is enabled, IoT SDK sends and receives data through the following flow:

1. IoT SDK requests proxy information from the Agora cloud proxy service.
2. IoT SDK sends data to the cloud proxy, which relays it to Agora SDRTN®.
3. Agora SDRTN® returns data to the cloud proxy, which relays it back to IoT SDK.

Enable cloud proxy

Call agora_rtc_set_cloud_proxy before you join a channel to set the cloud proxy mode:

int rval = agora_rtc_set_cloud_proxy(CLOUD_PROXY_UDP);
if (rval < 0) {
    printf("Failed to set cloud proxy, reason: %s\n", agora_rtc_err_2_str(rval));
    return -1;
}

type accepts the following values:

Bandwidth through a cloud proxy is limited compared to a direct connection to Agora SDRTN®, so only enable cloud proxy for devices that need it.

Allowlist IP addresses and ports

Before you enable cloud proxy, add the IP addresses and ports for your target regions to your firewall allowlist.

North America

Europe

Asia, excluding Mainland China

Japan

India

Mainland China

Best practices

• If you're uncertain which region your devices connect from, allowlist the IP addresses for all regions.
• Open UDP port 53 for DNS resolution in addition to the ports listed above.

Validate your configuration

Before deploying to production:

1. Enable cloud proxy in your app.
2. Join a channel and confirm the connection succeeds.
3. Monitor network quality metrics from multiple geographic locations, if possible.

Reference

• agora_rtc_set_cloud_proxy