License Key Protection with Live 2.0

Introduction

By default, live streams talk to the Brightcove Live API to stream your event. A new system to manage Playback Rights and Restrictions sits in front of the Live API and provides playback authorization using DRM licenses.

Live streams use runtime restrictions, so you will need a JSON Web Token (JWT) with specific permissions (claims) for your stream request.

The token is used when requesting the video license, once the video has been loaded to the player and the source has been selected.

To use Playback Restrictions with live streams, your account must be enabled for studio-grade DRM.

If you are not familiar with this feature, see the Overview: Brightcove Playback Restrictions document.

Requirements

This feature is a paid add-on for your account. Contact your Customer Success Manager to enable the following:

• Enable your account for DRM.

• Enable your account for Playback Rights (EPA).

Workflow

To use Playback Restrictions with a live event, follow these steps:

1. Define Playback Rights
2. Create a live event with Playback Restrictions
3. Publish the live event

Define Playback Rights

Brightcove's Playback Rights Management Service allows you to manage video playback based on the following:

• Geography
• Domain
• Proxy
• Schedule dates

Here are the steps to define Playback Rights in Studio:

1. Review the validation diagrams for Playback Rights in the Implementing Playback Rights document.
2. In Studio, in the primary navigation click Admin > Playback Rights.
3. To create a new right, click Add Playback Rights.

   

4. Add a Playback Rights Name and click Save.
5. In the left navigation, select each category and edit changes.

   

6. Click Save.
7. To edit a Playback Right, click on the Name of the Playback Right and it will open the Playback Right details page.

Create a live channel with Playback Restrictions

Use the Live module to create a live channel with Playback Restrictions and associate a defined Playback Right directly from the Live UI.

To create a Live Channel, follow these steps:

1. Open the Live module.
2. From the Live Channels page click Create Channel.
3. Enter the channel data as needed. For details, see the Creating and Managing Live Events using the Live Module document.
4. Expand the DRM section.
5. Enable all encryptions, or select a specific encryption mode (Widevine Modular, FairPlay or PlayReady) depending on your needs.
   • Digital Rights Management (DRM) - Secure Premium content stream with Digital Rights Management technologies. For details, see the Live DRM document.
     • HLS + FairPlay
     • HLS (fMP4) + Widevine Modular
6. To use Playback Restrictions, select License Key Protection. and choose the Playback Rights you defined in the Define Playback Rights section.

   

7. Enter any additional channel details.
8. Click Save.
9. Start streaming your live event. For details, see the Start Streaming section on the page.

Publish the live event

Live streams with Playback Restrictions require a JSON Web Token (JWT) with specific permissions (claims) for your stream request.

To publish a live stream with Playback Restrictions, follow these steps:

1. Create a JSON Web Token (JWT) and register the public key with Brightcove.

   For details, see the Creating a JSON Web Token (JWT) document.

2. In Studio, return to the Live module.
3. In the left navigation, select Publish and Embed.
4. In the Live Player Options section, select your player configured in the previous step.

5. Copy the Advanced Embed Code and paste it into your HTML page.

   

6. Create a custom script with the Advanced embed code.

   The JWT token is passed with the playback request. If the token is invalid or expired, access to the content will be restricted. The player must be configured to use the token.

   To configure the Brightcove web player, see the Playback Restrictions with Brightcove Player document.

7. Confirm playback in your web page.
8. Confirm that playback can be blocked by changing the settings for the Playback Right assigned to the channel (live event).