Configuring Player Content Restrictions

Product(s)
Video Cloud
Brightcove Player
Role(s)
Studio User
Player Developer
Task(s)
Create & Configure Players
Protect Videos
Topic(s)
Geo Restriction
Player/Video Availability

In this topic you will learn how to configure the content restriction properties using the Players module.

 

The player Content Restriction properties can be used to restrict a player to particular countries, or block a player from particular countries. Domain restrictions can be added to a player to limit the domains where the player can be used.

To view and edit the Content Restriction properties for a player, open the Players module, click on a player name and click Content Restriction in the left navigation menu.

content restriction

Note: Any changes made to a player may take up to 5 minutes to appear in published players.

Configuring domain restrictions

Domain restrictions can be set on players to limit the domains where players can be used. If the player publishing code is copied and used on another site, domain restrictions would prevent the player from loading any videos. Publishers must use the in-page embed code to actually get playback working on those domains that have been whitelisted. Publishers cannot use the iframe embed code on a whitelisted domain (or any other domain) and expect playback to function properly.

To configure a domain restriction for a player, follow these steps:

  1. Enter one or more complete domain URLs (such as http://www.brightcove.com or https://www.brightcove.com) to restrict your player's availability to these particular domains. Be sure to include either http:// or https://. Click +.
  2. Click Save to save the changes.

Note: If using domain restrictions, you configure domain restrictions for all players in your account. If you don't, you're vulnerable to someone taking the policy key from an unprotected player and using it to play any video.

Note: While there is no limit on the number of domains that can be added in Studio, there is a limit on the length of the URL for the API request - included in that URL will be the comma-delimited list of domains. Therefore there is a limit on the number of domains that can be specified, but the number will depend on how long the domain names are.

Configuring geo filtering

Geo filtering can be used to control which countries can, and cannot, use a player.

Notes:
  1. The ability to use player geo filtering is a feature available to Enterprise and Professional accounts for an additional fee. Contact Brightcove if you would like to upgrade your account to include geo filtering.
  2. Geo filtering can also be applied to individual videos. Video Cloud will apply both player and video geo-filtering policies - if a country is excluded by either, the video will not be available there.

To set the geo filtering properties for a player:

  1. Select Allow viewing from the following countries or Prevent viewing from the following countries.
  2. Enter the appropriate country names. As you type, the country list will be filtered.
  3. Click on a country and then press enter to add it to the list.
  4. Click Save.

Legacy Players module UI

To view and edit the availability properties for a player, open the Players module, click on a player name and locate the Availability section.

To edit the Availability properties, click the Edit button or double-click in the section. Player availability can be configured based upon:

Note: Any changes made to a player may take up to 5 minutes to appear in published players.

Configuring geo filtering (legacy Players Module)

Geo filtering can be used to control which countries can, and cannot, playback Video Cloud videos.

Notes:
  1. The ability to use player geo filtering is a feature available to Enterprise and Professional accounts for an additional fee. Contact Brightcove if you would like to upgrade your account to include geo filtering.
  2. Geo filtering can also be applied to individual videos. Video Cloud will apply both player and video geo-filtering policies - if a country is excluded by either, the video will not be available there.
  3. Some publishers have requested the ability to geo filter players to US military bases as well as the US. To support this, there is a US Military option. While there is no 100% reliable way to identify a military base, when an IP that resolves to a .mil domain is encountered, and is not in the US, it will be identified as coming from a US military base rather than its actual country of origin. .mil addresses that are in the US will still be identified as "us".

To set the geo filtering properties for a player:

  1. Select Allow viewing from the following countries or Prevent viewing from the following countries.
  2. Enter the appropriate country names. As you type, the country list will be filtered.
  3. Click Save.

Configuring domain restrictions (legacy Players Module)

Domain restrictions can be set on a player to limit the domains where Video Cloud videos can be played from. If the player publishing code is copied and used on another site, domain restrictions would prevent videos from loading. Publishers must use the in-page embed code to actually get playback working on those domains that have been whitelisted. Publishers cannot use the iframe embed code on a whitelisted domain (or any other domain) and expect playback to function properly.

Note: While domain restrictions can help prevent unauthorized distribution of your content, customers seeking maximum content security should look at DRM solutions instead. See Content Protection and Digital Rights Management for more information.

Internet Explorer Notes:
  1. The domain restriction feature requires IE version 10 or newer. Viewers using Internet Explorer < 10 will not get playback at all.
  2. If the IE policy setting: Access Data Sources Across Domains is enabled for a domain-restricted Brightcove player, the player will not load in Internet Explorer 11. This appears to be a bug in IE, and there is no known workaround. Turn this setting off if you want domain-restricted players to work in IE 11.

To configure a domain restriction for a player, follow these steps:

  1. Enter one or more complete URLs (such as http://www.brightcove.com or https://www.brightcove.com) to restrict your player's availability to these particular domains. Be sure to include either http:// or https://.

    Note: Complete URLs must be provided. Wildcards in URLs are not supported. URLs should not end with a /.

  2. Click Save to save the changes.

Domain restrictions are implemented by the account's policy key. If an account has any non-domain restricted policy keys generated for it, those keys can be used to watch any content in the account. Therefore, all policy keys for an account must be domain restricted.

Note: While there is no limit on the number of domains that can be added in Studio, there is a limit on the length of the URL for the API request - included in that URL will be the comma-delimited list of domains. Therefore there is a limit on the number of domains that can be specified, but the number will depend on how long the domain names are.