Cloud media services CIDR IP address range

Coming soon:
  • August 26, 2024 – FedRAMP CIDR block (FedRAMP only): 164.152.64.0/22
  • August 26, 2024 – RTP UDP port expansion (FedRAMP) 16384–32768 to 16384–65535
  • Date TBD – Additional CIDR block (Commercial regions): 136.245.64.0/18
  • Date TBD – RTP UDP port expansion (Commercial) 16384–32768 to 16384–65535
  • Date TBD – Force TURN IP migration (All regions) from static list to Genesys Cloud CIDR

Genesys Cloud’s cloud media services CIDR block provides you with a small range of IP addresses for outbound connections to and from telephony endpoints. Having a smaller range of Genesys-owned IP addresses for all the Genesys Cloud media services means a reduced number of allowed connection targets on your organization’s firewall and, because all the IP addresses are owned by Genesys, ultimately improves security.

The Genesys Cloud CIDR is applicable to the following Genesys Cloud services:

  • WebRTC stations
  • Polycom stations with Genesys Cloud Voice or BYOC Cloud
  • BYOC Cloud
  • ACD screen recording
  • Video chat
  • BYOC Premises Edge Appliances (using WebRTC and Hybrid Media)

Genesys is also moving all Force TURN services from its current static IP address to Genesys owned CIDR addresses. For more information, see Use the TURN Behavior feature.

The implementation of Genesys Cloud CIDR differs between the commercial regions and the FedRAMP region.

IP address information for commercial regions

Core and Satellite commercial regions use the following CIDR address ranges:

  • 52.129.96.0/20
  • 169.150.104.0/21 
  • 167.234.48.0/20
  • 136.245.64.0/18 Coming soon

Notes:
  • It is important to understand that Genesys is asking you to add the CIDR block of IP addresses to your existing firewall allowlist. You do not need to remove access to current addresses.
  • You must allow the full set of CIDR block of IP addresses to provide full Global Media Fabric coverage.
Americas EMEA Asia Pacific

US-West (Oregon)

US-East (N.Virginia)

Canada (Central)

South America (Sao Paulo)

Europe (Frankfurt)

Europe (Dublin)

Europe (London)

Europe (Zurich)

Europe (Paris)

Middle East (UAE)

Africa (Cape Town)

Asia Pacific (Sydney)

Asia Pacific (Tokyo)

Asia Pacific (Seoul)

Asia Pacific (Mumbai)

Asia Pacific (Osaka)

Asia Pacific (Hong Kong)

Asia Pacific (Singapore)

Asia Pacific (Jakarta)

Full support of Genesys Cloud's cloud media services CIDR block in this region.

CIDR block coming soon to this region.

Satellite region

Readiness checks for commercial regions

To help commercial customers prepare to use the CIDR block of IP addresses, Genesys provides with two ways to confirm whether you are ready to use the CIDR block of IP addresses or need to make further adjustments to your firewall settings.

  1. You can access the Genesys Cloud WebRTC Diagnostics app and run the automated tests found on the Network Test tab. For more information, see Troubleshooting in the About WebRTC article.
  2. You can run the set of manual tests described below.

Genesys provides you with a set of cloud platform network connectivity diagnostic endpoints that you can use to test against. To perform the manual tests, you can use commonly available network connectivity tools, such as netcat and nmap.

 To ensure that the entirety of the address range is covered, run these checks against each one of the following destination FQDNs:

Americas EMEA Asia Pacific
  • netdiag.use1.pure.cloud
  • netdiag.usw2.pure.cloud
  • netdiag.cac1.pure.cloud
  • netdiag.sae1.pure.cloud
  • netdiag.euc1.pure.cloud
  • netdiag.euw1.pure.cloud
  • netdiag.euw2.pure.cloud
  • netdiag.euc2.pure.cloud
  • netdiag.euw3.pure.cloud
  • netdiag.mec1.pure.cloud
  • netdiag.afs1.pure.cloud
  • netdiag.apse2.pure.cloud
  • netdiag.apne1.pure.cloud
  • netdiag.apne2.pure.cloud
  • netdiag.aps1.pure.cloud
  • netdiag.apne3.pure.cloud
  • netdiag.ape1.pure.cloud
  • netdiag.apse1.pure.cloud
  • netdiag.apse3.pure.cloud

    These tests are for guidance purposes only and are intended for network and firewall experts.

    Destination protocol / port Sample test command Successful response Failed response
    tcp/3478

    nc -v netdiag.use1.pure.cloud 3478

    (Run this command from the same network as the Genesys Cloud client application)

    No specific response is displayed, but a successful connection handshake is indicated. The connection times out.
    udp/3478 nmap -sU -p 3478 --script stun-info netdiag.use1.pure.cloud

    (You must be using nmap version 7.9 or later to run this command.)

    The response includes a stun-info section listing an external IP address. This response will include the following:

    nmap done: 1 IP address (1 host up) scanned in #.## seconds

    You receive a "host is down" response.
    udp/16384-65535

    echo "Hello" | nc -uv netdiag.use1.pure.cloud 16384

    (Run this command from the same network as Genesys Cloud client application.)

    The response includes:

    GoodbyeGoodbyeGoodbyeGoodbyeGoodbye

    (This command sends five packets, which result in five "Goodbye" responses; one for each packet.)

    You do not receive a "Goodbye" response.

    tcp/8061

    (Run this test if you are using hardware phones with cloud media.)

    echo "Hello" | nc -v netdiag.use1.pure.cloud 8061

    (Run this command from the same network on which the hardware phones are connected.)

    The response includes:

    Goodbye

    You do not receive a "Goodbye" response.

    tcp/5061

    (Run this test if you are using premises Edge appliances.)

    echo "Hello" | nc -v netdiag.use1.pure.cloud 5061

    (Run this command from the same network on which the Edge devices are connected.)

    The response includes:

    Goodbye

    You do not receive a "Goodbye" response.

    Genesys Cloud services for commercial regions

    Use the information in this table to gain a detailed understanding of the Genesys Cloud services that will be affected by the addition of the CIDR IP address block. This information helps you to identify the Source, Destination address, and the Destination transport protocol/port associated with each of the affected services. 

    Services

    Source

    Destination address

    Destination transport protocol/port

    Description

    STUN WebRTC Client

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    tcp/3478
    udp/3478
    Identifies the public IP address of the WebRTC Client.
    Media WebRTC Client

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    udp/16384-65535 Media sent to Genesys Cloud TURN or media services.

    Services

    Source

    Destination address

    Destination transport protocol/port

    Description

    Signaling Hardware Phone

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    tcp/8061 SIP signaling between the hardware phone and cloud platform SIP services.
    Media Hardware Phone

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    udp/16384-65535 Media sent to Genesys Cloud media services.

    Services

    Source

    Destination address

    Destination transport protocol/port

    Description

    Media Customer’s Carrier or PBX Device

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    udp/16384-65535 Media sent to Genesys Cloud media services.

    Services

    Source

    Destination address

    Destination transport protocol/port

    Description

    STUN Genesys Cloud Client

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    tcp/3478
    udp/3478
    Identifies the public IP address of the Screen Recording and Video Chat Client.
    Media Genesys Cloud Client

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    udp/16384-65535 Media sent to Genesys Cloud TURN or media services.

    Services

    Source

    Destination address

    Destination transport protocol/port

    Description

    WebRTC Signaling BYOC Premises Edge Appliance

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    tcp/5061 Control plane signaling between the Edge device and cloud XMPP Gateway.
    WebRTC TURN BYOC Premises Edge Appliance

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    udp/16384-65535 Media sent to Genesys Cloud TURN services.
    WebRTC STUN BYOC Premises Edge Appliance

    52.129.96.0/20

    169.150.104.0/21

    167.234.48.0/20

    136.245.64.0/18

    tcp/3478
    udp/3478
    Used to identify a public IP address of the Edge device.

    Feature coming soon

    Services

    Source

    Destination address

    Destination transport protocol/port

    Description

    REST APIs Consumers of the Genesys Cloud public REST and notification APIs

    169.150.110.0/24 and 
    169.150.111.0/24

    tcp/443 REST API calls sent to Genesys Cloud.

    Note: Genesys Cloud currently uses IP addresses found in the Amazon AWS IP address JSON file for many services. Only the services listed on this page will be migrating to the dedicated Genesys CIDR block of IP addresses. Keep in mind that during the migration period Genesys will continue to use these AWS IP addresses while incorporating the new CIDR block IP addresses for the listed services. Once the migration is complete, Genesys will provide guidance on modifying firewall configurations to prevent media-related connections to the Amazon AWS IP ranges while still allowing for HTTPS requests needed by other services.

    General AWS Direct Connect information

    AWS advertises the Genesys CIDR block both publicly and within Direct Connect.

    • Direct Connect customers who are not performing route filtering have no additional changes to make. However, Genesys recommends doing a lookup on the route table to ensure you are seeing the Genesys CIDR blocks. For example, if a Genesys CIDR block has a /20 mask, AWS may segment the block into /21’s, /22’s, /23’s, /24’s, and so on.
    • Direct Connect customers who are performing route filtering must permit the Genesys CIDR blocks. For example, if a Genesys CIDR block has a /20 mask, AWS may segment the block into /21’s, /22’s, /23’s, /24’s, and so on.
      • Direct Connect customers who need to filter region specific Genesys Cloud CIDRs should use prefix-lists and community tags. The prefix-list for the /20 mask should allow /20 and any prefix less than /32, and the prefix-list for the /21 mask should allow /21 and anything less than /32. The community tag set by AWS for region specific prefixes is 7224:8100. To verify the correct community tag, see the AWS Routing policies and BGP communities section of the AWS Direct Connect user guide. By using both of these filtering techniques, customers can automatically accept regional Genesys Cloud CIDRs.

    Note: The Genesys Cloud CIDR IP address ranges for Core/Satellite regions can be found at the beginning of this article.

    For more information on AWS Direct Connect routing and filtering, see AWS Routing policies and BGP communities.

    Direct Connect example

    Note: This example’s region CIDR allocation may not match what is actually advertised.

    For this example, suppose that the Direct Connect circuit terminates into us-east-1 and AWS is advertising a Genesys prefix of 169.150.106.0/24 out of the us-east-1 region and 169.150.107.0/24 out of the us-west-2 region. The Direct Connect customer receives both advertisements on their us-east-1 circuit.

    To filter these networks and prefer, or accept, the 169.150.106.0/24 prefix, the customer uses a prefix-list and community tag. The prefix-list should allow 169.150.104.0/21 and include any prefix less than /32. The community tag match would be for 7224:8100.

    In this case, the community tag is a unique identifier for a region's route advertisements from AWS. The community tag set by AWS allows a customer to differentiate routes from region, continent, or global. Therefore, the applied filters would cause the us-east-1 prefix, 169.150.106.0/24, to be matched on the Direct Connect circuit in us-east-1. The us-west-2 prefix, 169.150.107.0/24, would not be matched and could be dropped or set as a least preferred path.

    IP address information for the FedRAMP region

    The FedRAMP Core region (US-East 2 (Ohio)) uses the following CIDR address range:

    • 164.152.64.0/22  Coming soon

    Readiness checks for the FedRAMP region

    To help FedRAMP customers prepare to use the CIDR block of IP addresses, Genesys provides two ways to confirm whether you are ready to use the CIDR block of IP addresses or need to make further adjustments to your firewall settings.

    1. You can access the Genesys Cloud WebRTC Diagnostics app and run the automated tests found on the Network Test tab. For more information, see Troubleshooting in the About WebRTC article.
    2. You can run the set of manual tests described below.

    Genesys provides you with a set of cloud platform network connectivity diagnostic endpoints that you can use to test against. To perform the manual tests, you can use commonly available network connectivity tools, such as netcat and nmap.

    You will run the tests against the FedRAMP destination FQDN:

    • netdiag.use2.us-gov-pure.cloud 

    These tests are for guidance purposes only and are intended for network and firewall experts.

    Destination protocol / port Sample test command Successful response Failed response
    tcp/3478

    nc -v netdiag.use2.us-gov-pure.cloud 3478

    (Run this command from the same network as Genesys Cloud client application)

    No specific response is displayed, but a successful connection handshake is indicated. The connection times out.
    udp/3478 nmap -sU -p 3478 --script stun-info netdiag.use2.us-gov-pure.cloud

    (You must be using nmap version 7.9 or later to run this command.)

    The response includes a stun-info section listing an external IP address. This response will include the following:

    nmap done: 1 IP address (1 host up) scanned in #.## seconds

    You receive a "host is down" response.
    udp/16384-65535

    echo "Hello" | nc -uv netdiag.use2.us-gov-pure.cloud 16384

    (Run this command from the same network as Genesys Cloud client application.)

    The response includes:

    GoodbyeGoodbyeGoodbyeGoodbyeGoodbye

    (This command sends five packets, which result in five "Goodbye" responses; one for each packet.)

    You do not receive a "Goodbye" response.

    tcp/8061

    (Run this test if you are using hardware phones with cloud media.)

    echo "Hello" | nc -v netdiag.use2.us-gov-pure.cloud 8061

    (Run this command from the same network on which the hardware phones are connected.)

    The response includes:

    Goodbye

    You do not receive a "Goodbye" response.

    Genesys Cloud services for the FedRAMP region

    Use the information in this table to gain a detailed understanding of the Genesys Cloud services that will be affected by the addition of the CIDR IP address block. This information helps you to identify the Source, Destination address, and the Destination transport protocol/port associated with each of the affected services. 

    Services

     

    Source

     

    Destination address

     

    Destination transport

    protocol/port

    Description

     

    STUN WebRTC Client

    164.152.64.0/22

    tcp/3478
    udp/3478
    Identifies the public IP address of the WebRTC Client.
    Media WebRTC Client

    164.152.64.0/22

    udp/16384-65535 Media sent to Genesys Cloud TURN or media services.

    Services

     

    Source

     

    Destination address

     

    Destination transport

    protocol/port

    Description

     

    Signaling Hardware Phone

    164.152.64.0/22

    tcp/8061 SIP signaling between the hardware phone and cloud platform SIP services.
    Media Hardware Phone

    164.152.64.0/22

    udp/16384-65535 Media sent to Genesys Cloud media services.

    Services

     

    Source

     

    Destination address

     

    Destination transport

    protocol/port

    Description

     

    Media Customer’s Carrier or PBX Device

    164.152.64.0/22

    udp/16384-65535 Media sent to Genesys Cloud media services.

    Services

     

    Source

     

    Destination address

     

    Destination transport

    protocol/port

    Description

     

    STUN Genesys Cloud Client

    164.152.64.0/22

    tcp/3478
    udp/3478
    Identifies the public IP address of the Screen Recording and Video Chat Client.
    Media Genesys Cloud Client

    164.152.64.0/22

    udp/16384-65535 Media sent to Genesys Cloud TURN or media services.

    Feature coming soon

    Services

     

    Source

     

    Destination address

     

    Destination transport

    protocol/port

    Description

     

    REST APIs Consumers of the Genesys Cloud public REST and notification APIs

    164.152.64.0/224

    tcp/443 REST API calls sent to Genesys Cloud.

    Note: Genesys Cloud currently uses IP addresses found in the Amazon AWS IP address JSON file for many services. Only the services listed on this page will be migrating to the dedicated Genesys CIDR block of IP addresses. Keep in mind that during the migration period Genesys will continue to use these AWS IP addresses while incorporating the new CIDR block IP addresses for the listed services. Once the migration is complete, Genesys will provide guidance on modifying firewall configurations to prevent media-related connections to the Amazon AWS IP ranges while still allowing for HTTPS requests needed by other services.

    General AWS Direct Connect information

    AWS advertises the Genesys CIDR block both publicly and within Direct Connect.

    • Direct Connect customers who are not performing route filtering have no additional changes to make. However, Genesys recommends doing a lookup on the route table to ensure you are seeing the Genesys CIDR blocks. For example, if a Genesys CIDR block has a /20 mask, AWS may segment the block into /21’s, /22’s, /23’s, /24’s, and so on.
    • Direct Connect customers who are performing route filtering must permit the Genesys CIDR blocks. For example, if a Genesys CIDR block has a /20 mask, AWS may segment the block into /21’s, /22’s, /23’s, /24’s, and so on.
      • Direct Connect customers who need to filter region specific Genesys Cloud CIDRs should use prefix-lists and community tags. The prefix-list for the /20 mask should allow /20 and any prefix less than /32, and the prefix-list for the /21 mask should allow /21 and anything less than /32. The community tag set by AWS for region specific prefixes is 7224:8100. To verify the correct community tag, see the AWS Routing policies and BGP communities section of the AWS Direct Connect user guide. By using both of these filtering techniques, customers can automatically accept regional Genesys Cloud CIDRs.

    Note: The Genesys Cloud CIDR IP address ranges for Core/Satellite regions can be found at the beginning of this article.

    For more information on AWS Direct Connect routing and filtering, see AWS Routing policies and BGP communities.

    Direct Connect example

    Note: This example’s region CIDR allocation may not match what is actually advertised.

    For this example, suppose that the Direct Connect circuit terminates into us-east-1 and AWS is advertising a Genesys prefix of 169.150.106.0/24 out of the us-east-1 region and 169.150.107.0/24 out of the us-west-2 region. The Direct Connect customer receives both advertisements on their us-east-1 circuit.

    To filter these networks and prefer, or accept, the 169.150.106.0/24 prefix, the customer uses a prefix-list and community tag. The prefix-list should allow 169.150.104.0/21 and include any prefix less than /32. The community tag match would be for 7224:8100.

    In this case, the community tag is a unique identifier for a region's route advertisements from AWS. The community tag set by AWS allows a customer to differentiate routes from region, continent, or global. Therefore, the applied filters would cause the us-east-1 prefix, 169.150.106.0/24, to be matched on the Direct Connect circuit in us-east-1. The us-west-2 prefix, 169.150.107.0/24, would not be matched and could be dropped or set as a least preferred path.

    Modified date
    (YYYY-MM-DD)
    Revision
    2024-05-27

    Changed the layout of the article to separate Commercial and FedRAMP CIDR information.

    Added the following Coming soon announcements:

    • Additional CIDR block (Commercial regions): 136.245.64.0/18
    • FedRAMP CIDR block (FedRAMP only): 164.152.64.0/22
    • RTP UDP port expansion (All regions) 16384–32768 to 16384–65535
    • Force TURN IP migration (All regions) from static list to Genesys Cloud CIDR

    For more information, see

    2024-02-14

    Updated the content in the AWS Direct Connect and routing specific information section.

    2023-12-06

    Added new Regions: Asia Pacific (Osaka), EU (Zurich), Middle East (UAE), and Asia Pacific (Singapore)

    2023-11-01

    Removed Coming Soon flag for 167.234.48.0/20 CIDR block.

    2023-09-20

    Added the new 167.234.48.0/20 CIDR block to the list with a Coming Soon flag.

    2023-02-15
    • Changed region name prefix from EU to Europe to better line up with AWS documentation.
    • Added new satellite regions to table with Coming soon flags.
    2022-12-14

    Added the Direct Connect example to the AWS Direct Connect and routing specific information section.

    2022-12-07
    • Added Netdiag commands to the Readiness check section for ape1 (Hong Kong) and euw3 (Paris).
    • Added details about prefix-lists and community tags to the AWS Direct Connect and routing specific information section.
    2022-10-19

    Added details, where appropriate, to the entire article about the CIDR IP address expansion. This expansion includes additional CIDR IP address ranges for generally available Core and Satellite regions and the FedRAMP region (US-East 2 (Ohio)).

    2022-07-27

    South America (Sao Paulo) promoted to a core region.

    2022-03-23

    Added US East 2 (Ohio) region

    2021-09-01

    Added legend to AWS regions table

    Added Africa (Cape Town) / af-south-1 satellite region 

    2021-03-31

    Asia Pacific South (Mumbai) / ap-south-1 promoted to a core region.

    2021-03-10

    Added a table to define which AWS regions support the new CIDR block.

    2021-02-24
    • Added information about the new automated tests in the Genesys Cloud WebRTC Diagnostics app to the Readiness check section.
    • Changed the date from March 3 to March 10 in the Feature coming soon section.
    2021-01-27
    • Added a Readiness check section that includes a set of cloud platform network connectivity diagnostic endpoints that you can use to test against. This section includes example netcat and nmap commands that you can use confirm whether you are ready to use the CIDR block of IP addresses or indicate that you need to make other changes.
    • Added a section that provides more specific details concerning the Genesys Cloud services that will be affected by the addition of the CIDR IP address block. This section includes a table identifying the Service, Source, Destination address, and Destination transport protocol and port. 
    • Added a section that describes AWS Direct Connect and routing specific information.
    2020-11-25

    Modified the article to add more detail about the affected Genesys Cloud services.

    2020-11-04

    Added article to the Resource Center.