Manage IP whitelisting for ultra low latency streams with the Wowza Streaming Cloud REST API

Learn how to use the Wowza Streaming Cloud™ REST API to limit sources that can connect to an ultra low latency stream. Limiting source connections through IP whitelisting ensures that only trusted sources can connect to an ultra low latency target's ingest origin server, preventing unauthorized sources from connecting to and altering your stream. IP whitelisting is limited to ultra low latency push connections, where a source pushes the stream to Wowza Streaming Cloud.

Create an ultra low latency target


To get started with IP whitelisting, use the Wowza Streaming Cloud REST API to create an ultra low latency stream target with a source_delivery_method of push and an array of trusted IP addresses for ingest_ip_whitelist.

See  the Wowza Streaming Cloud REST API reference documentation for detailed information about available parameters.

Example request and response

Notes:

  • Ultra low latency stream targets are not available in the sandbox environment, so be sure to use https://api.cloud.wowza.com not https://api-sandbox.cloud.wowza.com in your API request.
  • For [key], substitute your API key or your access key as appropriate. For more information, see Locating and using API and access keys.
  • For [version], substitute the version number of the API that you're using. For the current version, use v1.2.

Create an ultra low latency stream target:

curl -H "wsc-api-key: [key]" -H "wsc-access-key: [key]" -H "Content-Type: application/json" -X POST -d '{   
"ull_stream_target": {  
   "name": "My Ultra Low Latency Stream Target with IP whitelisting", 
   "source_delivery_method": "push",  
   "enable_hls": true, 
   "ingest_ip_whitelist": ["192.112.222.*","120.178.110.193","143.68.176.47"]  
    }  
}' "https://api.cloud.wowza.com/api/[version]/stream_targets/ull" 

The request creates an  ultra low  latency stream target with an  id  parameter, ingest connection details, and playback details, including a hash of playback URLs. You will need details from this response to configure  Wowza  Player to test the connection.  The response should look something like this: 

{ 
    "ull_stream_target": { 
        "id": "zsz193rv", 
        "name": "My Ultra Low Latency Stream Target with IP whitelisting", 
        "enabled": true, 
        "state": "stopped", 
        "source_delivery_method": "push", 
        "playback_urls": {...}
        "enable_hls": true, 
        "ingest_ip_whitelist": [
          "192.112.222.*",
          "120.178.110.193",
          "143.68.176.47"
        ],
        "connection_code": "abcxuI",
        ... 
    } 
}

Configure the source


Set up your video source to send an ultra low latency stream to Wowza Streaming Cloud. Ensure that you are using an IP address that is included in the whitelisted IP addresses for your ultra low latency stream target.

See the Connect a Source ultra low latency example articles for more information.

Test the connection


  1. Start the video source.
  2. Use Wowza Player Builder for Ultra Low Latency to preview your stream. See Configure Wowza Player for Wowza Streaming Cloud ultra low latency streams for instructions.

Configure secure playback


To increase security on the playback side, see Manage secure playback for ultra low latency streams with the Wowza Streaming Cloud REST API.