Policy Keys

Product(s)
Video Cloud
Role(s)
Player Developer
Task(s)
Protect Videos

In this topic, you will learn about creation and use of the policy keys for your account.

Introduction

The policy key is used to retrieve video and playlist content from your Video Cloud library using the Playback API. Since the policy key is set on the player, it allows you to restrict access to your content at the player level. You can also control content availability at the video level by using the Video Cloud Studio Media module.

When you create a Brightcove player, a policy key is automatically generated for each player. This key is associated with your Brightcove account and controls which videos can be viewed and when they can be viewed, with the condition that the videos are stored in Video Cloud. For instance, policy keys are needed to limit access based on:

  • Account
  • Domain restrictions, if used
  • Geo-restrictions, if used

For a more detailed information on policy keys see the Overview: Policy API document.

Getting the policy key

The policy key is automatically generated and managed for you. So, in most cases you will not need to request it or manage it. The easiest way to retrieve your policy key is to do the following:

  1. Create a Brightcove Player in Studio.
  2. Click on the URL link (either Preview or Published will work).
  3. In the browser address bar, change the index.html to config.json, and browse the new URL.
  4. In the displayed player configuration you will see the policy key as follows:
policy key in player configuration

In rare instances you may not have created a Brightcove Player, but still need your policy key (such as developing strictly with the Brightcove Native Player SDKs). In this case you will need to contact customer support to get your policy key.

Using policy keys

The policy key can be used to authenticate requests to the Playback API. The Playback API is for use at runtime in web pages or mobile apps for general media management and integration with other systems. For more details, see the Playback API index page.

Policy keys vs. API credentials

The policy key is used to access the Playback API, whereas API credentials are used to access your content in the other Video Cloud API's.

Policy keys

The policy key is used for client-side retrieval of your Video Cloud library assets. Here are the details:

  • Access your video/playlist data using the Playback API
  • Read-only
  • Your video/playlist data is cached on the server by the Playback API
  • Use the Policy API to do the following:
    • Create policy keys. You need to contact customer support to revoke a policy key.
    • Set domain restrictions and set geographic restrictions at the policy level. Restrictions are enforced by players that use the policy key.

API credentials

API authentication credentials (also called client credentials) allow server-side applications to manage your Video Cloud library assets. Here are the details:

Managing policy keys

You can manage your policy keys as follows:

Obtaining

There is no way to update a policy key. You can either get the policy key from an existing player in your Video Cloud account, or you can create a policy key by using the Policy API.

Revoking

To revoke a policy key, you need to contact customer support.