Menu

Lumen help

Secure your streamroot key

Domain Name and Bundle ID Whitelisting is a way to protect your Streamroot Key on web platforms and mobile applications. It allows you to limit the use of our technologies to your website or app and your streams, thus preventing unwanted use of your Streamroot Key on a third-party property.

 

Set up your domain names and bundle IDs in the License & Security in the Settings Section of your dashboard.

Note: We strongly recommend that you whitelist at least one domain and bundle ID.
If you do not whitelist anything, any use of your Streamroot Key from third-party websites or apps will be considered as yours, displayed among your data in your dashboard, and counted towards your billing limits.

 

Changes made to a domain name and bundle ID take up to 10 minutes to be effective.

How it works

We associate your Streamroot Key with the website(s) and bundle ID(s) you indicate.
 

1.     If the Streamroot Key doesn't match your whitelisted websites and bundle IDs, viewers will not be able to connect to the backend services and will not receive or generate any peer traffic.
 

2.     The video will still be downloaded from your server and played as usual.
 

3.     If the Streamroot Key matches the website domain or Bundle ID, viewers will be connected to the backend services and they will be able to benefit from Mesh Delivery.

Special cases

Iframed and embedded players

 

For iframed or embedded players, the website considered will be the source website.

 

Localhost

 

Localhost (127.0.0.1) is always whitelisted. This means that you do not have to configure anything to perform tests locally.

 

WWW subdomain

 

"www" subdomain is transparent to the whitelisting, meaning that "mywebsite.com" is equivalent to "www.mywebsite.com" and vice-versa.

Syntax

The domain should not contain:
 

  • a character that is not a letter, a number, a dot, or a hyphen

  • more than 253 characters

  • scheme (protocol: "http://" nor "https://")

  • subdirectory (path: e.g., "/myservice")
     

The wildcard symbol "*." can be used to define a group of whitelisted domains.