Configure granular policies for media items

This guide explains how to build a workflow that provides different levels of access to media items within the same media set.

1. Create a media set

First, create a media set to store the media. There are two ways to do this:

Once created, you will be able to view your media set.

The media set view showing uploaded image files with their metadata.

2. Create a dataset and restricted view with media references

  1. Create a dataset that references the media in the media set, along with any additional data to be stored in the ontology. You can do this through Pipeline Builder, or through code using the media set transforms API.

A dataset containing image references from the media set along with additional metadata columns.

  1. Create a restricted view off of the dataset, and define a granular policy to determine the rows a user can view.

The restricted view creation interface showing granular policy configuration options.

3. Ontologize the media via the restricted view

  1. Create an object type backed by the restricted view.

The Ontology Manager showing object type configuration backed by the restricted view.

  1. Configure the property backed by the media reference column as a media reference property.

The media reference property configuration panel showing the media source selection.

  1. Select which markings to stop inheriting from the backing media set. By default, users must have access to all markings on the backing media set to view any media reference properties on this object. You can stop inheriting specific markings to remove this restriction, but users will still need to satisfy the granular policy on the restricted view data source to see the object. Note that stopping inheritance only affects this object and does not remove the marking from the backing media set itself.

The inherited markings configuration interface showing which markings to stop inheriting from the media set.

4. Interact with the media through the ontology

The newly defined object type is now available in all ontology applications, such as Workshop, Object Explorer, and Vertex. Media reference property access is controlled by the granular policy on the restricted view data source, with inherited markings from the backing media set still applying.

Workshop application displaying media items with granular access controls applied.