How to Add Entitlements to Categories - KMC

Entitlement Settings

Entitlement settings may be added to categories integrated into applications to support content entitlement.

From the Integration Settings page you control to which categories in your account, entitlement settings are added and enforced. See Managing Content Entitlement for more information.

The Entitlement Settings option in the Integration Settings page is available with entitlement account configuration only.

Use the "Privacy Context" to add the entitlement to categories.

Privacy Context is a free text label that indicates to which application the entitlement settings apply, for example, “MediaSpace”. The Privacy Context label is used for specific indexing of categories and content associated with it, and should also be configured in the application session (KS) itself.  The Privacy Context configuration for an application guarantees the following:

  • User’s entitlements to content in the application are determined based on the specific categories the application is integrated with. 
  • Categories that are not directly integrated with the application can be used for any content organization and applicative classification purposes. A content item can be shared with such categories with no impact on their visibility to end-users through the application.

In the common case, a single Privacy Context should be set to an entire ‘branch’ within the category-tree, and indicate the application integrated with it. In more complex scenarios, multiple privacy contexts can be set to categories to enable access to content shared between multiple applications within the account, and under the same organizational context.

The Privacy Context is set to categories as part of the MediaSpace installation process. Following this configuration, the MediaSpace categories can be edited to include entitlements settings.

For any other purposes, entitlements and privacy context can be added to categories from the Integration Settings page in the KMC.

Limits on Categories

Every Kaltura account (partner ID) has a limit on how many categories can an entry be in. 

This limit is by default 32 categories per entry, however, the  limit may be raised by using a setting on the admin console. 

  • The category limit may be up to 1000 categories per entry when using the ‘Disable Category Limit’ feature. 

Before raising the limit bar, the following are important implications to consider:

  1. By raising the limit, both entry.categories and entry.categoriesIds API services become fully deprecated.
    They will not correctly reflect the categories to which the entry is assigned. They might have outdated values or become empty.
    Thus - if you have any old integration that relies on these fields - do not raise the limit. (for example, BB PRE-KAF or custom API or VPASS integrations)
  2. By raising the limit, categories can only have 1 Privacy Context label per category.
    Privacy Context is used on KMS categories mainly, but may be used in API or VPAAS integrations.
    If the account has categories with more than one Privacy Context label  - when you raise the limit it may cause issues in applications using those categories.
    Make sure to remove the excess Privacy Context label, and align the application's configurations to use only the remaining Privacy Context.

The best place to check the Privacy Context Labels at is https://kmc.kaltura.com/index.php/kmcng/settings/integrationSettings. If you see a category with more than 1 label, it should be handled prior to changing the category limitations.

To add entitlements to categories

  1. Select the Settings tab and then select Integration Settings.
  2. In the Entitlement Settings sections click Add Entitlements to Categories.
  3. Enter the name of the root category integrated with your application/s.
  4. Enter the privacy context label. Multiple labels can be separated by commas. In MediaSpace, the privacy context label is visible through the MediaSpace configuration panel.
  5. Click Apply.
    Following this action, the categories tree is updated in the Kaltura backend, and the privacy context is gradually propagated into all sub categories. This operation may take a few minutes.

If entitlement enforcement is enabled by default in your account, after you complete this step, all content under the category that was set with entitlements (including all sub-categories) will only be accessible through an application that was updated to work with Kaltura’s entitlement services and that is set with the defined privacy context label as part of its session privileges.

To edit/delete entitlements
  1. In the Entitlement Settings section, click on the 3 dots next to the entitlement you want to edit or delete.
  2. Select Edit to edit the Privacy Context label for the Entitlement.
  3. Select Delete to delete the entitlement assigned to the category. 

Entitlement settings will be removed from all sub-categories in an asynchronous process. This operation may take a few minutes. Any previous privacy settings defined for the selected category (including all sub-categories) will be lost.

Was this article helpful?
Thank you for your feedback!
In This Article
Related Articles
Back to top

Never miss a thing!

Subscribe to our customer newsletter and our release notes updates, so you always get the best out of Kaltura.
Newsletter