Key Concepts

Some essential terms are introduced to help define concepts that are key to Rights Locker.
Term Definition/Description
Asset In Backlot, your materials (videos and the like) are called “assets” and are identified by an asset identifier or asset_id (also called “embed code”).
Note: You cannot use external identifiers with Rights Locker. The values passed must be real embed codes (asset IDs).
Label In Backlot, you can associate your assets with labels you define to categorize your assets. Labels are identified by label_id.
Provider A provider is the entity that owns the assets to which you assign entitlements. The provider is identified by a provider_id, which is displayed in the Backlot UI's ACCOUNT tab, Developers subtab and is called "Partner Code." You need this provider ID to make calls to the Rights Locker API.
Account An account identifies one of your video consumers to whom you grant entitlement to assets. The account is identified by an account_id, which should be secured in a manner recommended in Your Users, Your Accounts: Security. Rights Locker uses your account IDs only to create the entitlement and for no other reason. Account IDs are unique by provider.
Publishing Rule A publishing rule is a set of restrictions on content, such as geographic or time limitations. In Backlot and Rights Locker, there are two kinds of publishing rules:
  1. Asset publishing rules intrinsic to the asset itself, such as licensing or global restrictions for a piece of content
  2. Entitlement publishing rules, which are per user, per label (content-group) for modeling business restrictions around particular transactions or products sold to the user.

An entitlement is a single combination of provider, account, and single content (asset or label) tied to a publishing rule. It is a reflection of the statement:

User X is allowed to watch content Y under the conditions Z.

For every tuple of label_id, user_id, external_product_id, there can be only one entitlement. Any updates with the same three values will overwrite the previous entitlement. A user can have multiple entitlements to the same label, as long as they are under different external_product_ids.


One or more entitlements together reflect a user's "ownership" (using the term loosely) of a product offered by the provider. These products are grouped by external_product_id.

For example, a user might subscribe to the "silver" package and therefore have access to back catalog sitcoms (which are group by a label) on all devices, sports channels (a label) only on desktops.

A user can "own" different products, and so they can have many different entitlements, grouped under different external_product_ids. For instance, continuing the above example, the user could own both the silver package that grants access to sports channels on desktop and also own the mobile package that grants access to the sports channel on mobile phones.